@jonathangu/openclawbrain 0.3.0 → 0.3.1

package/docs/evidence/2026-03-16/d93f09feea123a08d020fcad8a4523b6c1d26507/validation-report.json

@@ -0,0 +1,387 @@
+{
+  "validationRoot": "/Users/cormorantai/.openclaw-ocbphase1",
+  "validationHome": "/Users/cormorantai",
+  "validationStateDir": "/Users/cormorantai/.openclaw-ocbphase1",
+  "fixtureWorkspace": "/Users/cormorantai/.openclaw/workspace-ocbphase1",
+  "configPath": "/Users/cormorantai/.openclaw-ocbphase1/openclaw.json",
+  "artifactDir": "/Users/cormorantai/openclawbrain/docs/evidence/2026-03-16/d93f09feea123a08d020fcad8a4523b6c1d26507",
+  "gitSha": "d93f09feea123a08d020fcad8a4523b6c1d26507",
+  "diagnostics": {
+    "status": {
+      "command": "openclaw",
+      "args": [
+        "status",
+        "--json",
+        "--timeout",
+        "10000"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 0,
+      "signal": null,
+      "ok": true,
+      "stdout": "[plugins] [openclawbrain] Plugin loaded (enabled=true, db=/Users/cormorantai/.openclaw-ocbphase1/lcm.db, threshold=0.75)\n{\n  \"runtimeVersion\": \"2026.3.13\",\n  \"heartbeat\": {\n    \"defaultAgentId\": \"main\",\n    \"agents\": [\n      {\n        \"agentId\": \"main\",\n        \"enabled\": true,\n        \"every\": \"30m\",\n        \"everyMs\": 1800000\n      }\n    ]\n  },\n  \"channelSummary\": [],\n  \"queuedSystemEvents\": [],\n  \"sessions\": {\n    \"paths\": [\n      \"/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json\"\n    ],\n    \"count\": 1,\n    \"defaults\": {\n      \"model\": \"qwen2.5:7b-instruct\",\n      \"contextTokens\": 262144\n    },\n    \"recent\": [\n      {\n        \"agentId\": \"main\",\n        \"key\": \"agent:main:main\",\n        \"kind\": \"direct\",\n        \"sessionId\": \"475abd74-ed4f-4334-a896-8ffd7d81eec7\",\n        \"updatedAt\": 1773635277472,\n        \"age\": 16057669,\n        \"abortedLastRun\": false,\n        \"inputTokens\": 15733,\n        \"outputTokens\": 280,\n        \"cacheRead\": 0,\n        \"cacheWrite\": 0,\n        \"totalTokens\": 15733,\n        \"totalTokensFresh\": true,\n        \"remainingTokens\": 246411,\n        \"percentUsed\": 6,\n        \"model\": \"qwen2.5:7b-instruct\",\n        \"contextTokens\": 262144,\n        \"flags\": [\n          \"id:475abd74-ed4f-4334-a896-8ffd7d81eec7\"\n        ]\n      }\n    ],\n    \"byAgent\": [\n      {\n        \"agentId\": \"main\",\n        \"path\": \"/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json\",\n        \"count\": 1,\n        \"recent\": [\n          {\n            \"agentId\": \"main\",\n            \"key\": \"agent:main:main\",\n            \"kind\": \"direct\",\n            \"sessionId\": \"475abd74-ed4f-4334-a896-8ffd7d81eec7\",\n            \"updatedAt\": 1773635277472,\n            \"age\": 16057669,\n            \"abortedLastRun\": false,\n            \"inputTokens\": 15733,\n            \"outputTokens\": 280,\n            \"cacheRead\": 0,\n            \"cacheWrite\": 0,\n            \"totalTokens\": 15733,\n            \"totalTokensFresh\": true,\n            \"remainingTokens\": 246411,\n            \"percentUsed\": 6,\n            \"model\": \"qwen2.5:7b-instruct\",\n            \"contextTokens\": 262144,\n            \"flags\": [\n              \"id:475abd74-ed4f-4334-a896-8ffd7d81eec7\"\n            ]\n          }\n        ]\n      }\n    ]\n  },\n  \"os\": {\n    \"platform\": \"darwin\",\n    \"arch\": \"arm64\",\n    \"release\": \"25.3.0\",\n    \"label\": \"macos 26.3 (arm64)\"\n  },\n  \"update\": {\n    \"root\": \"/Users/cormorantai/opencormorant\",\n    \"installKind\": \"git\",\n    \"packageManager\": \"pnpm\",\n    \"git\": {\n      \"root\": \"/Users/cormorantai/opencormorant\",\n      \"sha\": \"66e02b296fa7c18c04dc94fe071d916042a30137\",\n      \"tag\": null,\n      \"branch\": \"main\",\n      \"upstream\": \"origin/main\",\n      \"dirty\": false,\n      \"ahead\": 0,\n      \"behind\": 544,\n      \"fetchOk\": true\n    },\n    \"deps\": {\n      \"manager\": \"pnpm\",\n      \"status\": \"stale\",\n      \"lockfilePath\": \"/Users/cormorantai/opencormorant/pnpm-lock.yaml\",\n      \"markerPath\": \"/Users/cormorantai/opencormorant/node_modules/.modules.yaml\",\n      \"reason\": \"lockfile newer than install marker\"\n    },\n    \"registry\": {\n      \"latestVersion\": \"2026.3.13\"\n    }\n  },\n  \"updateChannel\": \"dev\",\n  \"updateChannelSource\": \"git-branch\",\n  \"memory\": {\n    \"agentId\": \"main\",\n    \"backend\": \"builtin\",\n    \"files\": 0,\n    \"chunks\": 0,\n    \"dirty\": true,\n    \"workspaceDir\": \"/Users/cormorantai/.openclaw/workspace-ocbphase1\",\n    \"dbPath\": \"/Users/cormorantai/.openclaw-ocbphase1/memory/main.sqlite\",\n    \"provider\": \"gemini\",\n    \"model\": \"gemini-embedding-001\",\n    \"requestedProvider\": \"auto\",\n    \"sources\": [\n      \"memory\"\n    ],\n    \"extraPaths\": [],\n    \"sourceCounts\": [\n      {\n        \"source\": \"memory\",\n        \"files\": 0,\n        \"chunks\": 0\n      }\n    ],\n    \"cache\": {\n      \"enabled\": true,\n      \"entries\": 0\n    },\n    \"fts\": {\n      \"enabled\": true,\n      \"available\": true\n    },\n    \"vector\": {\n      \"enabled\": true,\n      \"available\": true,\n      \"extensionPath\": \"/Users/cormorantai/opencormorant/node_modules/.pnpm/sqlite-vec@0.1.7-alpha.2/node_modules/sqlite-vec-darwin-arm64/vec0.dylib\"\n    },\n    \"batch\": {\n      \"enabled\": false,\n      \"failures\": 0,\n      \"limit\": 2,\n      \"wait\": true,\n      \"concurrency\": 2,\n      \"pollIntervalMs\": 2000,\n      \"timeoutMs\": 3600000\n    },\n    \"custom\": {\n      \"searchMode\": \"hybrid\",\n      \"readonlyRecovery\": {\n        \"attempts\": 0,\n        \"successes\": 0,\n        \"failures\": 0\n      }\n    }\n  },\n  \"memoryPlugin\": {\n    \"enabled\": true,\n    \"slot\": \"memory-core\"\n  },\n  \"gateway\": {\n    \"mode\": \"local\",\n    \"url\": \"ws://127.0.0.1:19031\",\n    \"urlSource\": \"local loopback\",\n    \"misconfigured\": false,\n    \"reachable\": false,\n    \"connectLatencyMs\": null,\n    \"self\": null,\n    \"error\": \"connect failed: connect ECONNREFUSED 127.0.0.1:19031\",\n    \"authWarning\": null\n  },\n  \"gatewayService\": {\n    \"label\": \"LaunchAgent\",\n    \"installed\": false,\n    \"managedByOpenClaw\": false,\n    \"externallyManaged\": false,\n    \"loadedText\": \"not loaded\",\n    \"runtimeShort\": \"unknown\"\n  },\n  \"nodeService\": {\n    \"label\": \"LaunchAgent\",\n    \"installed\": false,\n    \"managedByOpenClaw\": false,\n    \"externallyManaged\": false,\n    \"loadedText\": \"not loaded\",\n    \"runtimeShort\": \"unknown\"\n  },\n  \"agents\": {\n    \"defaultId\": \"main\",\n    \"agents\": [\n      {\n        \"id\": \"main\",\n        \"workspaceDir\": \"/Users/cormorantai/.openclaw/workspace-ocbphase1\",\n        \"bootstrapPending\": true,\n        \"sessionsPath\": \"/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json\",\n        \"sessionsCount\": 1,\n        \"lastUpdatedAt\": 1773635277472,\n        \"lastActiveAgeMs\": 16057665\n      }\n    ],\n    \"totalSessions\": 1,\n    \"bootstrapPendingCount\": 1\n  },\n  \"securityAudit\": {\n    \"ts\": 1773651337689,\n    \"summary\": {\n      \"critical\": 3,\n      \"warn\": 1,\n      \"info\": 1\n    },\n    \"findings\": [\n      {\n        \"checkId\": \"summary.attack_surface\",\n        \"severity\": \"info\",\n        \"title\": \"Attack surface summary\",\n        \"detail\": \"groups: open=0, allowlist=0\\ntools.elevated: enabled\\nhooks.webhooks: disabled\\nhooks.internal: disabled\\nbrowser control: enabled\\ntrust model: personal assistant (one trusted operator boundary), not hostile multi-tenant on one shared gateway\"\n      },\n      {\n        \"checkId\": \"gateway.trusted_proxies_missing\",\n        \"severity\": \"warn\",\n        \"title\": \"Reverse proxy headers are not trusted\",\n        \"detail\": \"gateway.bind is loopback and gateway.trustedProxies is empty. If you expose the Control UI through a reverse proxy, configure trusted proxies so local-client checks cannot be spoofed.\",\n        \"remediation\": \"Set gateway.trustedProxies to your proxy IPs or keep the Control UI local-only.\"\n      },\n      {\n        \"checkId\": \"gateway.loopback_no_auth\",\n        \"severity\": \"critical\",\n        \"title\": \"Gateway auth missing on loopback\",\n        \"detail\": \"gateway.bind is loopback but no gateway auth secret is configured. If the Control UI is exposed through a reverse proxy, unauthenticated access is possible.\",\n        \"remediation\": \"Set gateway.auth (token recommended) or keep the Control UI local-only.\"\n      },\n      {\n        \"checkId\": \"browser.control_no_auth\",\n        \"severity\": \"critical\",\n        \"title\": \"Browser control has no auth\",\n        \"detail\": \"Browser control HTTP routes are enabled but no gateway.auth token/password is configured. Any local process (or SSRF to loopback) can call browser control endpoints.\",\n        \"remediation\": \"Set gateway.auth.token (recommended) or gateway.auth.password so browser control HTTP routes require authentication. Restarting the gateway will auto-generate gateway.auth.token when browser control is enabled.\"\n      },\n      {\n        \"checkId\": \"models.small_params\",\n        \"severity\": \"critical\",\n        \"title\": \"Small models require sandboxing and web tools disabled\",\n        \"detail\": \"Small models (<=300B params) detected:\\n- ollama/qwen2.5:7b-instruct (7B) @ agents.defaults.model.primary (unsafe; sandbox=off; web=[web_search, web_fetch, browser])\\nUncontrolled input tools allowed: web_search, web_fetch, browser.\\nSmall models are not recommended for untrusted inputs.\",\n        \"remediation\": \"If you must use small models, enable sandboxing for all sessions (agents.defaults.sandbox.mode=\\\"all\\\") and disable web_search/web_fetch/browser (tools.deny=[\\\"group:web\\\",\\\"browser\\\"]).\"\n      }\n    ]\n  },\n  \"secretDiagnostics\": []\n}\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: openclawbrain (/Users/cormorantai/openclawbrain/index.ts). Set plugins.allow to explicit trusted ids.\n[plugins] [brain] Embedding model is unset; learned retrieval is disabled until init/configuration is complete\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n",
+      "error": null,
+      "parsed": {
+        "runtimeVersion": "2026.3.13",
+        "heartbeat": {
+          "defaultAgentId": "main",
+          "agents": [
+            {
+              "agentId": "main",
+              "enabled": true,
+              "every": "30m",
+              "everyMs": 1800000
+            }
+          ]
+        },
+        "channelSummary": [],
+        "queuedSystemEvents": [],
+        "sessions": {
+          "paths": [
+            "/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json"
+          ],
+          "count": 1,
+          "defaults": {
+            "model": "qwen2.5:7b-instruct",
+            "contextTokens": 262144
+          },
+          "recent": [
+            {
+              "agentId": "main",
+              "key": "agent:main:main",
+              "kind": "direct",
+              "sessionId": "475abd74-ed4f-4334-a896-8ffd7d81eec7",
+              "updatedAt": 1773635277472,
+              "age": 16057669,
+              "abortedLastRun": false,
+              "inputTokens": 15733,
+              "outputTokens": 280,
+              "cacheRead": 0,
+              "cacheWrite": 0,
+              "totalTokens": 15733,
+              "totalTokensFresh": true,
+              "remainingTokens": 246411,
+              "percentUsed": 6,
+              "model": "qwen2.5:7b-instruct",
+              "contextTokens": 262144,
+              "flags": [
+                "id:475abd74-ed4f-4334-a896-8ffd7d81eec7"
+              ]
+            }
+          ],
+          "byAgent": [
+            {
+              "agentId": "main",
+              "path": "/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json",
+              "count": 1,
+              "recent": [
+                {
+                  "agentId": "main",
+                  "key": "agent:main:main",
+                  "kind": "direct",
+                  "sessionId": "475abd74-ed4f-4334-a896-8ffd7d81eec7",
+                  "updatedAt": 1773635277472,
+                  "age": 16057669,
+                  "abortedLastRun": false,
+                  "inputTokens": 15733,
+                  "outputTokens": 280,
+                  "cacheRead": 0,
+                  "cacheWrite": 0,
+                  "totalTokens": 15733,
+                  "totalTokensFresh": true,
+                  "remainingTokens": 246411,
+                  "percentUsed": 6,
+                  "model": "qwen2.5:7b-instruct",
+                  "contextTokens": 262144,
+                  "flags": [
+                    "id:475abd74-ed4f-4334-a896-8ffd7d81eec7"
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        "os": {
+          "platform": "darwin",
+          "arch": "arm64",
+          "release": "25.3.0",
+          "label": "macos 26.3 (arm64)"
+        },
+        "update": {
+          "root": "/Users/cormorantai/opencormorant",
+          "installKind": "git",
+          "packageManager": "pnpm",
+          "git": {
+            "root": "/Users/cormorantai/opencormorant",
+            "sha": "66e02b296fa7c18c04dc94fe071d916042a30137",
+            "tag": null,
+            "branch": "main",
+            "upstream": "origin/main",
+            "dirty": false,
+            "ahead": 0,
+            "behind": 544,
+            "fetchOk": true
+          },
+          "deps": {
+            "manager": "pnpm",
+            "status": "stale",
+            "lockfilePath": "/Users/cormorantai/opencormorant/pnpm-lock.yaml",
+            "markerPath": "/Users/cormorantai/opencormorant/node_modules/.modules.yaml",
+            "reason": "lockfile newer than install marker"
+          },
+          "registry": {
+            "latestVersion": "2026.3.13"
+          }
+        },
+        "updateChannel": "dev",
+        "updateChannelSource": "git-branch",
+        "memory": {
+          "agentId": "main",
+          "backend": "builtin",
+          "files": 0,
+          "chunks": 0,
+          "dirty": true,
+          "workspaceDir": "/Users/cormorantai/.openclaw/workspace-ocbphase1",
+          "dbPath": "/Users/cormorantai/.openclaw-ocbphase1/memory/main.sqlite",
+          "provider": "gemini",
+          "model": "gemini-embedding-001",
+          "requestedProvider": "auto",
+          "sources": [
+            "memory"
+          ],
+          "extraPaths": [],
+          "sourceCounts": [
+            {
+              "source": "memory",
+              "files": 0,
+              "chunks": 0
+            }
+          ],
+          "cache": {
+            "enabled": true,
+            "entries": 0
+          },
+          "fts": {
+            "enabled": true,
+            "available": true
+          },
+          "vector": {
+            "enabled": true,
+            "available": true,
+            "extensionPath": "/Users/cormorantai/opencormorant/node_modules/.pnpm/sqlite-vec@0.1.7-alpha.2/node_modules/sqlite-vec-darwin-arm64/vec0.dylib"
+          },
+          "batch": {
+            "enabled": false,
+            "failures": 0,
+            "limit": 2,
+            "wait": true,
+            "concurrency": 2,
+            "pollIntervalMs": 2000,
+            "timeoutMs": 3600000
+          },
+          "custom": {
+            "searchMode": "hybrid",
+            "readonlyRecovery": {
+              "attempts": 0,
+              "successes": 0,
+              "failures": 0
+            }
+          }
+        },
+        "memoryPlugin": {
+          "enabled": true,
+          "slot": "memory-core"
+        },
+        "gateway": {
+          "mode": "local",
+          "url": "ws://127.0.0.1:19031",
+          "urlSource": "local loopback",
+          "misconfigured": false,
+          "reachable": false,
+          "connectLatencyMs": null,
+          "self": null,
+          "error": "connect failed: connect ECONNREFUSED 127.0.0.1:19031",
+          "authWarning": null
+        },
+        "gatewayService": {
+          "label": "LaunchAgent",
+          "installed": false,
+          "managedByOpenClaw": false,
+          "externallyManaged": false,
+          "loadedText": "not loaded",
+          "runtimeShort": "unknown"
+        },
+        "nodeService": {
+          "label": "LaunchAgent",
+          "installed": false,
+          "managedByOpenClaw": false,
+          "externallyManaged": false,
+          "loadedText": "not loaded",
+          "runtimeShort": "unknown"
+        },
+        "agents": {
+          "defaultId": "main",
+          "agents": [
+            {
+              "id": "main",
+              "workspaceDir": "/Users/cormorantai/.openclaw/workspace-ocbphase1",
+              "bootstrapPending": true,
+              "sessionsPath": "/Users/cormorantai/.openclaw-ocbphase1/agents/main/sessions/sessions.json",
+              "sessionsCount": 1,
+              "lastUpdatedAt": 1773635277472,
+              "lastActiveAgeMs": 16057665
+            }
+          ],
+          "totalSessions": 1,
+          "bootstrapPendingCount": 1
+        },
+        "securityAudit": {
+          "ts": 1773651337689,
+          "summary": {
+            "critical": 3,
+            "warn": 1,
+            "info": 1
+          },
+          "findings": [
+            {
+              "checkId": "summary.attack_surface",
+              "severity": "info",
+              "title": "Attack surface summary",
+              "detail": "groups: open=0, allowlist=0\ntools.elevated: enabled\nhooks.webhooks: disabled\nhooks.internal: disabled\nbrowser control: enabled\ntrust model: personal assistant (one trusted operator boundary), not hostile multi-tenant on one shared gateway"
+            },
+            {
+              "checkId": "gateway.trusted_proxies_missing",
+              "severity": "warn",
+              "title": "Reverse proxy headers are not trusted",
+              "detail": "gateway.bind is loopback and gateway.trustedProxies is empty. If you expose the Control UI through a reverse proxy, configure trusted proxies so local-client checks cannot be spoofed.",
+              "remediation": "Set gateway.trustedProxies to your proxy IPs or keep the Control UI local-only."
+            },
+            {
+              "checkId": "gateway.loopback_no_auth",
+              "severity": "critical",
+              "title": "Gateway auth missing on loopback",
+              "detail": "gateway.bind is loopback but no gateway auth secret is configured. If the Control UI is exposed through a reverse proxy, unauthenticated access is possible.",
+              "remediation": "Set gateway.auth (token recommended) or keep the Control UI local-only."
+            },
+            {
+              "checkId": "browser.control_no_auth",
+              "severity": "critical",
+              "title": "Browser control has no auth",
+              "detail": "Browser control HTTP routes are enabled but no gateway.auth token/password is configured. Any local process (or SSRF to loopback) can call browser control endpoints.",
+              "remediation": "Set gateway.auth.token (recommended) or gateway.auth.password so browser control HTTP routes require authentication. Restarting the gateway will auto-generate gateway.auth.token when browser control is enabled."
+            },
+            {
+              "checkId": "models.small_params",
+              "severity": "critical",
+              "title": "Small models require sandboxing and web tools disabled",
+              "detail": "Small models (<=300B params) detected:\n- ollama/qwen2.5:7b-instruct (7B) @ agents.defaults.model.primary (unsafe; sandbox=off; web=[web_search, web_fetch, browser])\nUncontrolled input tools allowed: web_search, web_fetch, browser.\nSmall models are not recommended for untrusted inputs.",
+              "remediation": "If you must use small models, enable sandboxing for all sessions (agents.defaults.sandbox.mode=\"all\") and disable web_search/web_fetch/browser (tools.deny=[\"group:web\",\"browser\"])."
+            }
+          ]
+        },
+        "secretDiagnostics": []
+      }
+    },
+    "statusAll": {
+      "command": "openclaw",
+      "args": [
+        "status",
+        "--all",
+        "--timeout",
+        "10000"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 0,
+      "signal": null,
+      "ok": true,
+      "stdout": "[plugins] [openclawbrain] Plugin loaded (enabled=true, db=/Users/cormorantai/.openclaw-ocbphase1/lcm.db, threshold=0.75)\nOpenClaw status --all\n\nOverview\n┌─────────────────┬────────────────────────────────────────────────────────────────────────────────────────────────────┐\n│ Item            │ Value                                                                                              │\n├─────────────────┼────────────────────────────────────────────────────────────────────────────────────────────────────┤\n│ Version         │ 2026.3.13                                                                                          │\n│ OS              │ macos 26.3 (arm64)                                                                                 │\n│ Node            │ 22.22.0                                                                                            │\n│ Config          │ ~/.openclaw-ocbphase1/openclaw.json                                                                │\n│ Dashboard       │ http://127.0.0.1:19031/                                                                            │\n│ Tailscale       │ off · Running · cormorantais-mac-mini.tail499c70.ts.net                                            │\n│ Channel         │ dev (main)                                                                                         │\n│ Git             │ main · @ 66e02b29                                                                                  │\n│ Update          │ git main · ↔ origin/main · behind 544 · npm latest 2026.3.13 · deps stale                         │\n│ Gateway         │ local · ws://127.0.0.1:19031 (local loopback) · unreachable (connect failed: connect ECONNREFUSED  │\n│                 │ 127.0.0.1:19031)                                                                                   │\n│ Security        │ Run: openclaw security audit --deep                                                                │\n│ Gateway self    │ unknown                                                                                            │\n│ Gateway service │ LaunchAgent not installed                                                                          │\n│ Node service    │ LaunchAgent not installed                                                                          │\n│ Agents          │ 1 total · 1 bootstrapping · 0 active · 1 sessions                                                  │\n└─────────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────┘\n\nChannels\n┌──────────┬─────────┬────────┬────────────────────────────────────────────────────────────────────────────────────────┐\n│ Channel  │ Enabled │ State  │ Detail                                                                                 │\n├──────────┼─────────┼────────┼────────────────────────────────────────────────────────────────────────────────────────┤\n└──────────┴─────────┴────────┴────────────────────────────────────────────────────────────────────────────────────────┘\n\nAgents\n┌────────────┬────────────────┬──────────┬──────────┬──────────────────────────────────────────────────────────────────┐\n│ Agent      │ Bootstrap file │ Sessions │ Active   │ Store                                                            │\n├────────────┼────────────────┼──────────┼──────────┼──────────────────────────────────────────────────────────────────┤\n│ main       │ PRESENT        │        1 │ 4h ago   │ ~/.openclaw-ocbphase1/agents/main/sessions/sessions.json         │\n└────────────┴────────────────┴──────────┴──────────┴──────────────────────────────────────────────────────────────────┘\n\nDiagnosis (read-only)\n\nGateway connection details:\n  Gateway target: ws://127.0.0.1:19031\n  Source: local loopback\n  Config: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json\n  Bind: loopback\n\n✓ Config: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json\n✓ Restart sentinel: none\n✓ Port 19031\n✓ Tailscale: off · Running · cormorantais-mac-mini.tail499c70.ts.net\n  ips: 100.73.247.26, fd7a:115c:a1e0::e932:f71a\n✓ Skills: 9 eligible · 0 missing · /Users/cormorantai/.openclaw/workspace-ocbphase1\n! Channel issues skipped (gateway unreachable)\n\nGateway health:\n  connect failed: connect ECONNREFUSED 127.0.0.1:19031\n\nPasteable debug report. Auth tokens redacted.\nTroubleshooting: https://docs.openclaw.ai/troubleshooting\n\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: openclawbrain (/Users/cormorantai/openclawbrain/index.ts). Set plugins.allow to explicit trusted ids.\n[plugins] [brain] Embedding model is unset; learned retrieval is disabled until init/configuration is complete\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n",
+      "error": null
+    },
+    "gatewayProbe": {
+      "command": "openclaw",
+      "args": [
+        "gateway",
+        "probe"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 1,
+      "signal": null,
+      "ok": false,
+      "stdout": "│\n◇  Config warnings ────────────────────────────────────────────────────────╮\n│                                                                          │\n│  - plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest   │\n│    uses \"ollama\", entry hints \"ollama-provider\")                         │\n│  - plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest   │\n│    uses \"sglang\", entry hints \"sglang-provider\")                         │\n│  - plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses  │\n│    \"vllm\", entry hints \"vllm-provider\")                                  │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Doctor changes ──────────────────────────────╮\n│                                               │\n│  Telegram configured, enabled automatically.  │\n│                                               │\n├───────────────────────────────────────────────╯\n│\n◇  Doctor ──────────────────────────────────────────────╮\n│                                                       │\n│  Run \"openclaw doctor --fix\" to apply these changes.  │\n│                                                       │\n├───────────────────────────────────────────────────────╯\nGateway Status\nReachable: no\nProbe budget: 3000ms\n\nDiscovery (this machine)\nFound 4 gateway(s) via Bonjour (local.)\n\nTargets\nLocal loopback ws://127.0.0.1:19031\n  Connect: failed - connect failed: connect ECONNREFUSED 127.0.0.1:19031\n\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n",
+      "error": null
+    },
+    "gatewayStatus": {
+      "command": "openclaw",
+      "args": [
+        "gateway",
+        "status"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 0,
+      "signal": null,
+      "ok": true,
+      "stdout": "│\n◇  Config warnings ────────────────────────────────────────────────────────╮\n│                                                                          │\n│  - plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest   │\n│    uses \"ollama\", entry hints \"ollama-provider\")                         │\n│  - plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest   │\n│    uses \"sglang\", entry hints \"sglang-provider\")                         │\n│  - plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses  │\n│    \"vllm\", entry hints \"vllm-provider\")                                  │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Doctor changes ──────────────────────────────╮\n│                                               │\n│  Telegram configured, enabled automatically.  │\n│                                               │\n├───────────────────────────────────────────────╯\n│\n◇  Doctor ──────────────────────────────────────────────╮\n│                                                       │\n│  Run \"openclaw doctor --fix\" to apply these changes.  │\n│                                                       │\n├───────────────────────────────────────────────────────╯\nService: LaunchAgent (not loaded)\nFile logs: /tmp/openclaw/openclaw-2026-03-16.log\n\nConfig (cli): ~/.openclaw-ocbphase1/openclaw.json\nConfig (service): ~/.openclaw-ocbphase1/openclaw.json\n\nGateway: bind=loopback (127.0.0.1), port=19031 (env/config)\nProbe target: ws://127.0.0.1:19031\nDashboard: http://127.0.0.1:19031/\nProbe note: Loopback-only gateway; only local clients can connect.\n\nRuntime: unknown (Bad request.\nCould not find service \"ai.openclaw.gateway\" in domain for user gui: 501)\n\n\n\nTroubles: run openclaw status\nTroubleshooting: https://docs.openclaw.ai/troubleshooting\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nService config looks out of date or non-standard.\nService config issue: Gateway service PATH is not set; the daemon should use a minimal PATH.\nRecommendation: run \"openclaw doctor\" (or \"openclaw doctor --repair\").\nRPC probe: failed\nRPC target: ws://127.0.0.1:19031\n  gateway url override requires explicit credentials\n  Fix: pass --token or --password (or gatewayToken in tools).\n  Config: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json\nService unit not found.\nService not installed. Run: openclaw gateway install\nFile logs: /tmp/openclaw/openclaw-2026-03-16.log\nOther gateway-like services detected (best effort):\n- com.openclawbrain.daemon.activation.0ec88212fa7d (user, plist: /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activation.0ec88212fa7d.plist)\n- com.openclawbrain.daemon.activation.546e84bf06ac (user, plist: /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activation.546e84bf06ac.plist)\n- com.openclawbrain.daemon.activation.b3eeb450ca08 (user, plist: /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activation.b3eeb450ca08.plist)\nCleanup hint: launchctl bootout gui/$UID/ai.openclaw.gateway\nCleanup hint: rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist\nRecommendation: run a single gateway per machine for most setups. One gateway supports multiple agents (see docs: /gateway#multiple-gateways-same-host).\nIf you need multiple gateways (e.g., a rescue bot on the same host), isolate ports + config/state (see docs: /gateway#multiple-gateways-same-host).\n",
+      "error": null
+    },
+    "doctor": {
+      "command": "openclaw",
+      "args": [
+        "doctor",
+        "--non-interactive"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 0,
+      "signal": null,
+      "ok": true,
+      "stdout": "▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄\n██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██\n██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██\n██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██\n▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀\n                  🦞 OPENCLAW 🦞                    \n \n┌  OpenClaw doctor\n│\n◇  Install ─────────────────────────────────────────────────────────╮\n│                                                                   │\n│  - package-lock.json present in a pnpm workspace. If you ran npm  │\n│    install, remove it and reinstall with pnpm.                    │\n│                                                                   │\n├───────────────────────────────────────────────────────────────────╯\n│\n◇  Config warnings ────────────────────────────────────────────────────────╮\n│                                                                          │\n│  - plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest   │\n│    uses \"ollama\", entry hints \"ollama-provider\")                         │\n│  - plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest   │\n│    uses \"sglang\", entry hints \"sglang-provider\")                         │\n│  - plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses  │\n│    \"vllm\", entry hints \"vllm-provider\")                                  │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Doctor changes ──────────────────────────────╮\n│                                               │\n│  Telegram configured, enabled automatically.  │\n│                                               │\n├───────────────────────────────────────────────╯\n│\n◇  Doctor ──────────────────────────────────────────────╮\n│                                                       │\n│  Run \"openclaw doctor --fix\" to apply these changes.  │\n│                                                       │\n├───────────────────────────────────────────────────────╯\n│\n◇  Gateway auth ──────────────────────────────────────────────────╮\n│                                                                 │\n│  Gateway auth is off or missing a token. Token auth is now the  │\n│  recommended default (including loopback).                      │\n│                                                                 │\n├─────────────────────────────────────────────────────────────────╯\n│\n◇  State integrity ────────────────────────────────────────────────────────╮\n│                                                                          │\n│  - OAuth dir not present (~/.openclaw-ocbphase1/credentials). Skipping   │\n│    create because no WhatsApp/pairing channel config is active.          │\n│  - Multiple state directories detected. This can split session history.  │\n│    - ~/.openclaw                                                         │\n│    Active state dir: ~/.openclaw-ocbphase1                               │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Other gateway-like services detected ───────────────────────────────────────╮\n│                                                                              │\n│  - com.openclawbrain.daemon.activation.0ec88212fa7d (user, plist:            │\n│    /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activat  │\n│  ion.0ec88212fa7d.plist)                                                     │\n│  - com.openclawbrain.daemon.activation.546e84bf06ac (user, plist:            │\n│    /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activat  │\n│  ion.546e84bf06ac.plist)                                                     │\n│  - com.openclawbrain.daemon.activation.b3eeb450ca08 (user, plist:            │\n│    /Users/cormorantai/Library/LaunchAgents/com.openclawbrain.daemon.activat  │\n│  ion.b3eeb450ca08.plist)                                                     │\n│                                                                              │\n├──────────────────────────────────────────────────────────────────────────────╯\n│\n◇  Cleanup hints ─────────────────────────────────────────╮\n│                                                         │\n│  - launchctl bootout gui/$UID/ai.openclaw.gateway       │\n│  - rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist  │\n│                                                         │\n├─────────────────────────────────────────────────────────╯\n│\n◇  Gateway recommendation ───────────────────────────────────────────────╮\n│                                                                        │\n│  Recommendation: run a single gateway per machine for most setups.     │\n│  One gateway supports multiple agents.                                 │\n│  If you need multiple gateways (e.g., a rescue bot on the same host),  │\n│  isolate ports + config/state (see docs:                               │\n│  /gateway#multiple-gateways-same-host).                                │\n│                                                                        │\n├────────────────────────────────────────────────────────────────────────╯\n│\n◇  Security ─────────────────────────────────╮\n│                                            │\n│  - No channel security warnings detected.  │\n│  - Run: openclaw security audit --deep     │\n│                                            │\n├────────────────────────────────────────────╯\n│\n◇  Skills status ────────────╮\n│                            │\n│  Eligible: 9               │\n│  Missing requirements: 43  │\n│  Blocked by allowlist: 0   │\n│                            │\n├────────────────────────────╯\n│\n◇  Plugins ──────╮\n│                │\n│  Loaded: 5     │\n│  Disabled: 37  │\n│  Errors: 0     │\n│                │\n├────────────────╯\n│\n◇  Plugin diagnostics ─────────────────────────────────────────────────────╮\n│                                                                          │\n│  - WARN ollama: plugin id mismatch (manifest uses \"ollama\", entry hints  │\n│    \"ollama-provider\")                                                    │\n│    (/Users/cormorantai/opencormorant/extensions/ollama/index.ts)         │\n│  - WARN sglang: plugin id mismatch (manifest uses \"sglang\", entry hints  │\n│    \"sglang-provider\")                                                    │\n│    (/Users/cormorantai/opencormorant/extensions/sglang/index.ts)         │\n│  - WARN vllm: plugin id mismatch (manifest uses \"vllm\", entry hints      │\n│    \"vllm-provider\")                                                      │\n│    (/Users/cormorantai/opencormorant/extensions/vllm/index.ts)           │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Gateway ──────────────╮\n│                        │\n│  Gateway not running.  │\n│                        │\n├────────────────────────╯\n│\n◇  Gateway connection ───────────────────────────────────────────╮\n│                                                                │\n│  Gateway target: ws://127.0.0.1:19031                          │\n│  Source: local loopback                                        │\n│  Config: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json  │\n│  Bind: loopback                                                │\n│                                                                │\n├────────────────────────────────────────────────────────────────╯\n│\n◇  Gateway ────────────────────────╮\n│                                  │\n│  Gateway service not installed.  │\n│                                  │\n├──────────────────────────────────╯\nRun \"openclaw doctor --fix\" to apply changes.\n│\n└  Doctor complete.\n\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n",
+      "error": null
+    },
+    "channelsStatus": {
+      "command": "openclaw",
+      "args": [
+        "channels",
+        "status",
+        "--probe"
+      ],
+      "cwd": "/Users/cormorantai/openclawbrain",
+      "exitCode": 0,
+      "signal": null,
+      "ok": true,
+      "stdout": "│\n◇  Config warnings ────────────────────────────────────────────────────────╮\n│                                                                          │\n│  - plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest   │\n│    uses \"ollama\", entry hints \"ollama-provider\")                         │\n│  - plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest   │\n│    uses \"sglang\", entry hints \"sglang-provider\")                         │\n│  - plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses  │\n│    \"vllm\", entry hints \"vllm-provider\")                                  │\n│                                                                          │\n├──────────────────────────────────────────────────────────────────────────╯\n│\n◇  Doctor changes ──────────────────────────────╮\n│                                               │\n│  Telegram configured, enabled automatically.  │\n│                                               │\n├───────────────────────────────────────────────╯\n│\n◇  Doctor ──────────────────────────────────────────────╮\n│                                                       │\n│  Run \"openclaw doctor --fix\" to apply these changes.  │\n│                                                       │\n├───────────────────────────────────────────────────────╯\n[plugins] [openclawbrain] Plugin loaded (enabled=true, db=/Users/cormorantai/.openclaw-ocbphase1/lcm.db, threshold=0.75)\nChecking channel status (probe)…\nGateway not reachable; showing config-only status.\nConfig: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json\nMode: local\n\n\nTip: https://docs.openclaw.ai/cli#status adds gateway health probes to status output (requires a reachable gateway).\n",
+      "stderr": "Config warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\n[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: openclawbrain (/Users/cormorantai/openclawbrain/index.ts). Set plugins.allow to explicit trusted ids.\n[plugins] [brain] Embedding model is unset; learned retrieval is disabled until init/configuration is complete\nConfig warnings:\\n- plugins.entries.ollama: plugin ollama: plugin id mismatch (manifest uses \"ollama\", entry hints \"ollama-provider\")\n- plugins.entries.sglang: plugin sglang: plugin id mismatch (manifest uses \"sglang\", entry hints \"sglang-provider\")\n- plugins.entries.vllm: plugin vllm: plugin id mismatch (manifest uses \"vllm\", entry hints \"vllm-provider\")\nGateway not reachable: Error: gateway closed (1006 abnormal closure (no close frame)): no close reason\nGateway target: ws://127.0.0.1:19031\nSource: local loopback\nConfig: /Users/cormorantai/.openclaw-ocbphase1/openclaw.json\nBind: loopback\n",
+      "error": null
+    }
+  },
+  "trace": null,
+  "setup": {
+    "linkedPlugin": "/Users/cormorantai/openclawbrain",
+    "lcmDbPath": "/Users/cormorantai/.openclaw-ocbphase1/lcm.db",
+    "brainRoot": "/Users/cormorantai/.openclaw-ocbphase1/openclawbrain",
+    "manualContextEngineSlot": null,
+    "validationMode": "sterile-lane",
+    "validationLaneName": "ocbphase1",
+    "validationGatewayPort": 19031,
+    "validationModel": null,
+    "workerMode": "child",
+    "embeddingProvider": "openai",
+    "embeddingModel": null,
+    "agentTimeoutMs": 120000
+  },
+  "init": null,
+  "doctor": null,
+  "status": null,
+  "runtime": null,
+  "agent": {},
+  "assertions": {},
+  "skipped": [
+    {
+      "phase": "init-and-agent-checks",
+      "reason": "--setup-only was requested."
+    }
+  ]
+}

package/docs/tui.md

@@ -1,12 +1,18 @@
 # TUI Reference
 
-The OpenClawBrain TUI (`lcm-tui`) is an interactive terminal application for inspecting, debugging, and maintaining the inherited LCM substrate. It provides direct visibility into what the model sees (context assembly), how summaries are structured (DAG hierarchy), and tools for surgical repairs when things go wrong.
+The OpenClawBrain TUI (`lcm-tui`) is an interactive terminal application for inspecting, debugging, and maintaining the inherited LCM substrate. It is still a substrate-level tool, which is why some internal naming and the Go module path still reflect the older lossless-claw origin.
+
+What it is for:
+- inspect what the model actually sees in context
+- inspect summary DAG structure and quality
+- repair or rewrite bad summaries surgically
+- debug large-file interception and context assembly
 
 ## Installation
 
-**From GitHub releases:**
+**From releases:**
 
-Download the latest binary for your platform from the OpenClawBrain release surface that ships this repo's TUI assets.
+Download the latest binary for your platform from this repo's release surface when TUI assets are published there.
 
 **Build from source:**
 
@@ -14,7 +20,8 @@ Download the latest binary for your platform from the OpenClawBrain release surf
 cd tui
 go build -o lcm-tui .
 # or: make build
-# or: go install github.com/Martian-Engineering/lossless-claw/tui@latest
+# historical module path, still current in go.mod:
+# go install github.com/Martian-Engineering/lossless-claw/tui@latest
 ```
 
 Requires Go 1.24+.