From 99205e8276d20b262d6964a11a9ff2fdc0c4988f Mon Sep 17 00:00:00 2001
From: Jason Woltje <jason@diversecanvas.com>
Date: Fri, 6 Mar 2026 14:13:07 +0000
Subject: [PATCH] docs: remove hardcoded instance URLs from PRD (#2)

Co-authored-by: Jason Woltje <jason@diversecanvas.com>
Co-committed-by: Jason Woltje <jason@diversecanvas.com>
---
 docs/PRD.md | 26 +++++++++++++++++++-------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/docs/PRD.md b/docs/PRD.md
index 8e415c2..a05d18f 100644
--- a/docs/PRD.md
+++ b/docs/PRD.md
@@ -7,7 +7,7 @@
 
 ## Problem Statement
 
-OpenClaw compacts context when sessions grow long, causing information loss. The new `ContextEngine` plugin interface (merged in PR #22201) allows replacing the default compaction strategy with a persistent, lossless alternative. OpenBrain (brain.woltje.com) is a live pgvector + REST API service that can store and semantically retrieve conversation context indefinitely.
+OpenClaw compacts context when sessions grow long, causing information loss. The new `ContextEngine` plugin interface (merged in PR #22201) allows replacing the default compaction strategy with a persistent, lossless alternative. OpenBrain is a self-hosted pgvector + REST API service that can store and semantically retrieve conversation context indefinitely.
 
 ## Solution
 
@@ -20,8 +20,8 @@ lossless-claw (https://github.com/Martian-Engineering/lossless-claw) is the prim
 ## OpenBrain API
 
 ```
-Base: https://brain.woltje.com
-Auth: Bearer <OPENBRAIN_API_KEY>
+Base: <user-configured — OPENBRAIN_URL env var or plugin config.baseUrl — NO DEFAULT>
+Auth: Bearer <OPENBRAIN_API_KEY env var or plugin config.apiKey — NO DEFAULT>
 
 POST   /v1/thoughts         { content, source, metadata }
 POST   /v1/search           { query, limit }
@@ -85,8 +85,8 @@ export function register(api: OpenClawPluginApi) {
       "openclaw-openbrain-context": {
         "enabled": true,
         "config": {
-          "baseUrl": "https://brain.woltje.com",
-          "apiKey": "${OPENBRAIN_API_KEY}",
+          "baseUrl": "https://your-openbrain-instance.example.com",
+          "apiKey": "your-api-key",
           "recentMessages": 20,
           "semanticSearchLimit": 10,
           "source": "openclaw"
@@ -103,15 +103,27 @@ export function register(api: OpenClawPluginApi) {
 - openclaw/plugin-sdk for ContextEngine interface
 - pnpm, vitest, ESLint
 
+## ⚠️ Hard Rule: No Hardcoded Instance Values
+
+This plugin will be used by anyone running their own OpenBrain instance. The following are STRICTLY FORBIDDEN in source code, defaults, or fallback logic:
+- Any hardcoded URL (no `brain.woltje.com` or any other specific domain)
+- Any hardcoded API key
+- Any `process.env.OPENBRAIN_URL || 'https://brain.woltje.com'` fallback patterns
+
+Required behavior:
+- `baseUrl` and `apiKey` MUST be provided via plugin config or env vars
+- If either is missing, throw `OpenBrainConfigError` at `bootstrap()` time with a clear message: "openclaw-openbrain-context: baseUrl and apiKey are required. Set them in your openclaw.json plugin config."
+- No silent degradation, no defaults to any specific host
+
 ## Acceptance Criteria (v0.0.1)
 1. Plugin registers as a ContextEngine with id `openbrain`
 2. `ingest()` stores messages to OpenBrain with correct metadata
 3. `assemble()` retrieves recent + semantically relevant context within token budget
 4. `compact()` archives turn summary, returns minimal prompt-injection
-5. `bootstrap()` loads prior session context on restart
+5. `bootstrap()` loads prior session context on restart; throws `OpenBrainConfigError` if config missing
 6. Tests pass, TypeScript strict, ESLint clean
 7. openclaw.plugin.json with correct manifest
-8. README: install + config + usage
+8. README documents: self-host OpenBrain setup, all config options with types/defaults, env var pattern, example config
 
 ## ASSUMPTION: ContextEngine interface shape
 Based on lossless-claw source and PR #22201. Plugin SDK import path: `openclaw/plugin-sdk`.