@agentmemory/agentmemory 0.9.1 → 0.9.3

package/README.md

@@ -25,10 +25,10 @@
 <p align="center">
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-recall.svg"><img src="assets/tags/stat-recall.svg" alt="95.2% retrieval R@5" height="38" /></picture>
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tokens.svg"><img src="assets/tags/stat-tokens.svg" alt="92% fewer tokens" height="38" /></picture>
-  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="44 MCP tools" height="38" /></picture>
+  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="51 MCP tools" height="38" /></picture>
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-hooks.svg"><img src="assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture>
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-deps.svg"><img src="assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>
-  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="654 tests passing" height="38" /></picture>
+  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="827 tests passing" height="38" /></picture>
 </p>
 
 <p align="center">
@@ -334,14 +334,14 @@ Implementation details live in `src/cli.ts` (see `runUpgrade` around the `src/cl
 ### Claude Code (one block, paste it)
 
 ```
-Install agentmemory: run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server. Then run `/plugin marketplace add rohitg00/agentmemory` and `/plugin install agentmemory` — the plugin registers all 12 hooks, 4 skills, AND auto-wires the `@agentmemory/mcp` stdio server via its `.mcp.json`, so you get 44 MCP tools (memory_smart_search, memory_save, memory_sessions, memory_governance_delete, etc.) without any extra config step. Verify with `curl http://localhost:3111/agentmemory/health`. The real-time viewer is at http://localhost:3113.
+Install agentmemory: run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server. Then run `/plugin marketplace add rohitg00/agentmemory` and `/plugin install agentmemory` — the plugin registers all 12 hooks, 4 skills, AND auto-wires the `@agentmemory/mcp` stdio server via its `.mcp.json`, so you get 51 MCP tools (memory_smart_search, memory_save, memory_sessions, memory_governance_delete, etc.) without any extra config step. Verify with `curl http://localhost:3111/agentmemory/health`. The real-time viewer is at http://localhost:3113.
 ```
 
 <details>
 <summary><b>OpenClaw (paste this prompt)</b></summary>
 
 ```
-Install agentmemory for OpenClaw. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to my OpenClaw MCP config so agentmemory is available with all 43 memory tools:
+Install agentmemory for OpenClaw. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to my OpenClaw MCP config so agentmemory is available with all 50 memory tools:
 
 {
   "mcpServers": {
@@ -363,7 +363,7 @@ Full guide: [`integrations/openclaw/`](integrations/openclaw/)
 <summary><b>Hermes Agent (paste this prompt)</b></summary>
 
 ```
-Install agentmemory for Hermes. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to ~/.hermes/config.yaml so Hermes can use agentmemory as an MCP server with all 43 memory tools:
+Install agentmemory for Hermes. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111. Then add this to ~/.hermes/config.yaml so Hermes can use agentmemory as an MCP server with all 50 memory tools:
 
 mcp_servers:
   agentmemory:
@@ -593,9 +593,9 @@ npm install @xenova/transformers
 
 <h2 id="mcp-server"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-mcp.svg"><img src="assets/tags/section-mcp.svg" alt="MCP Server" height="32" /></picture></h2>
 
-44 tools, 6 resources, 3 prompts, and 4 skills — the most comprehensive MCP memory toolkit for any agent.
+51 tools, 6 resources, 3 prompts, and 4 skills — the most comprehensive MCP memory toolkit for any agent.
 
-### 44 Tools
+### 50 Tools
 
 <details>
 <summary>Core tools (always available)</summary>
@@ -617,7 +617,7 @@ npm install @xenova/transformers
 </details>
 
 <details>
-<summary>Extended tools (44 total — set AGENTMEMORY_TOOLS=all)</summary>
+<summary>Extended tools (50 total — set AGENTMEMORY_TOOLS=all)</summary>
 
 | Tool | Description |
 |------|-------------|
@@ -779,25 +779,35 @@ agentmemory auto-detects from your environment. No API key needed if you have a
 
 | Provider | Config | Notes |
 |----------|--------|-------|
-| **Claude subscription** (default) | No config needed | Uses `@anthropic-ai/claude-agent-sdk` |
+| **No-op (default)** | No config needed | LLM-backed compress/summarize is DISABLED. Synthetic BM25 compression + recall still work. See `AGENTMEMORY_ALLOW_AGENT_SDK` below if you used to rely on the Claude-subscription fallback. |
 | Anthropic API | `ANTHROPIC_API_KEY` | Per-token billing |
 | MiniMax | `MINIMAX_API_KEY` | Anthropic-compatible |
 | Gemini | `GEMINI_API_KEY` | Also enables embeddings |
 | OpenRouter | `OPENROUTER_API_KEY` | Any model |
+| Claude subscription fallback | `AGENTMEMORY_ALLOW_AGENT_SDK=true` | Opt-in only. Spawns `@anthropic-ai/claude-agent-sdk` sessions — used to cause unbounded Stop-hook recursion (#149 follow-up) so it is no longer the default. |
 
 ### Environment Variables
 
 Create `~/.agentmemory/.env`:
 
 ```env
-# LLM provider (pick one, or leave empty for Claude subscription)
+# LLM provider (pick one — default is the no-op provider: no LLM calls)
 # ANTHROPIC_API_KEY=sk-ant-...
+# ANTHROPIC_BASE_URL=...              # Optional: Anthropic-compatible proxy / Azure
 # GEMINI_API_KEY=...
 # OPENROUTER_API_KEY=...
+# MINIMAX_API_KEY=...
+# Opt-in Claude-subscription fallback (spawns @anthropic-ai/claude-agent-sdk);
+# leave OFF unless you understand the Stop-hook recursion risk (#149 follow-up):
+# AGENTMEMORY_ALLOW_AGENT_SDK=true
 
 # Embedding provider (auto-detected, or override)
 # EMBEDDING_PROVIDER=local
 # VOYAGE_API_KEY=...
+# OPENAI_API_KEY=sk-...
+# OPENAI_BASE_URL=https://api.openai.com   # Override for Azure / vLLM / LM Studio / proxies
+# OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+# OPENAI_EMBEDDING_DIMENSIONS=1536        # Required when the model is not in the known-models table
 
 # Search tuning
 # BM25_WEIGHT=0.4
@@ -816,6 +826,23 @@ Create `~/.agentmemory/.env`:
                                    # LLM provider to compress the
                                    # observation — expect significant
                                    # token spend on active sessions.
+# AGENTMEMORY_SLOTS=false          # OFF by default. Editable pinned
+                                   # memory slots — persona,
+                                   # user_preferences, tool_guidelines,
+                                   # project_context, guidance,
+                                   # pending_items, session_patterns,
+                                   # self_notes. Size-limited; agent
+                                   # edits via memory_slot_* tools.
+                                   # Pinned slots addressable for
+                                   # SessionStart injection.
+# AGENTMEMORY_REFLECT=false        # OFF by default. Requires SLOTS=on.
+                                   # Stop hook fires mem::slot-reflect:
+                                   # scans recent observations, auto-
+                                   # appends TODOs to pending_items,
+                                   # counts patterns in
+                                   # session_patterns, records touched
+                                   # files in project_context. Fire-
+                                   # and-forget; does not block.
 # AGENTMEMORY_INJECT_CONTEXT=false # OFF by default (#143). When on:
                                    # - SessionStart may inject ~1-2K
                                    #   chars of project context into
@@ -843,7 +870,7 @@ Create `~/.agentmemory/.env`:
 # USER_ID=
 # TEAM_MODE=private
 
-# Tool visibility: "core" (8 tools) or "all" (44 tools)
+# Tool visibility: "core" (8 tools) or "all" (51 tools)
 # AGENTMEMORY_TOOLS=core
 ```
 
@@ -884,7 +911,7 @@ Full endpoint list: [`src/triggers/api.ts`](src/triggers/api.ts)
 
 Built on [iii-engine](https://iii.dev)'s three primitives — no Express, no Postgres, no Redis.
 
-**118 source files · ~21,800 LOC · 646 tests · 123 functions · 34 KV scopes**
+**118 source files · ~21,800 LOC · 800 tests · 123 functions · 34 KV scopes**
 
 <details>
 <summary>What iii-engine replaces</summary>
@@ -904,7 +931,7 @@ Built on [iii-engine](https://iii.dev)'s three primitives — no Express, no Pos
 ```bash
 npm run dev               # Hot reload
 npm run build             # Production build
-npm test                  # 646 tests (~1.7s)
+npm test                  # 800 tests (~1.7s)
 npm run test:integration  # API tests (requires running services)
 ```
 

package/dist/cli.mjs

@@ -47,7 +47,12 @@ const KV = {
 	enrichedChunks: (sessionId) => `mem:enriched:${sessionId}`,
 	latentEmbeddings: (obsId) => `mem:latent:${obsId}`,
 	retentionScores: "mem:retention",
-	accessLog: "mem:access"
+	accessLog: "mem:access",
+	imageRefs: "mem:image-refs",
+	imageEmbeddings: "mem:image-embeddings",
+	slots: "mem:slots",
+	globalSlots: "mem:slots:global",
+	state: "mem:state"
 };
 const STREAM = {
 	name: "mem-live",
@@ -87,7 +92,8 @@ Usage: agentmemory [command] [options]
 
 Commands:
   (default)          Start agentmemory worker
-  status             Show connection status, memory count, and health
+  status             Show connection status, memory count, flags, and health
+  doctor             Run diagnostic checks (server, flags, graph, providers)
   demo               Seed sample sessions and show recall in action
   upgrade            Upgrade local deps + iii runtime (best effort)
   mcp                Start standalone MCP server (no engine required)
@@ -100,10 +106,15 @@ Options:
   --no-engine        Skip auto-starting iii-engine
   --port <N>         Override REST port (default: 3111)
 
+Environment:
+  AGENTMEMORY_URL    Full REST base URL (e.g. http://localhost:3111).
+                     Honored by status, doctor, and MCP shim commands.
+
 Quick start:
   npx @agentmemory/agentmemory          # start with local iii-engine or Docker
-  npx @agentmemory/agentmemory status   # check health
-  npx @agentmemory/agentmemory demo     # try it in 30 seconds (needs server running)
+  npx @agentmemory/agentmemory demo     # see semantic recall in 30 seconds
+  npx @agentmemory/agentmemory doctor   # diagnose config + feature flags
+  npx @agentmemory/agentmemory status   # health + memory count + flags
   npx @agentmemory/agentmemory upgrade  # upgrade agentmemory + iii runtime
   npx @agentmemory/agentmemory mcp      # standalone MCP server (no engine)
   npx @agentmemory/mcp                  # same as above (shim package)
@@ -116,16 +127,44 @@ const portIdx = args.indexOf("--port");
 if (portIdx !== -1 && args[portIdx + 1]) process.env["III_REST_PORT"] = args[portIdx + 1];
 const skipEngine = args.includes("--no-engine");
 function getRestPort() {
+	const url = process.env["AGENTMEMORY_URL"];
+	if (url) try {
+		const parsed = new URL(url).port;
+		if (parsed) return parseInt(parsed, 10);
+	} catch {}
 	return parseInt(process.env["III_REST_PORT"] || "3111", 10) || 3111;
 }
+function getBaseUrl() {
+	const url = process.env["AGENTMEMORY_URL"];
+	if (url) return url.replace(/\/+$/, "");
+	return `http://localhost:${getRestPort()}`;
+}
+function getViewerUrl() {
+	const envUrl = process.env["AGENTMEMORY_VIEWER_URL"];
+	if (envUrl) return envUrl.replace(/\/+$/, "");
+	try {
+		const u = new URL(getBaseUrl());
+		const vPort = (parseInt(u.port || "3111", 10) || 3111) + 2;
+		return `${u.protocol}//${u.hostname}:${vPort}`;
+	} catch {
+		return `http://localhost:${getRestPort() + 2}`;
+	}
+}
 async function isEngineRunning() {
 	try {
-		await fetch(`http://localhost:${getRestPort()}/`, { signal: AbortSignal.timeout(2e3) });
+		await fetch(`${getBaseUrl()}/`, { signal: AbortSignal.timeout(2e3) });
 		return true;
 	} catch {
 		return false;
 	}
 }
+async function isAgentmemoryReady() {
+	try {
+		return (await fetch(`${getBaseUrl()}/agentmemory/livez`, { signal: AbortSignal.timeout(2e3) })).ok;
+	} catch {
+		return false;
+	}
+}
 function findIiiConfig() {
 	const candidates = [
 		join(__dirname, "iii-config.yaml"),
@@ -287,12 +326,12 @@ async function main() {
 	p.intro("agentmemory");
 	if (skipEngine) {
 		p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-Dw_gJcCy.mjs");
+		await import("./src-3Snd7D3T.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-Dw_gJcCy.mjs");
+		await import("./src-3Snd7D3T.mjs");
 		return;
 	}
 	if (!await startEngine()) {
@@ -336,30 +375,38 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-Dw_gJcCy.mjs");
+	await import("./src-3Snd7D3T.mjs");
+}
+async function apiFetch(base, path, timeoutMs = 5e3) {
+	try {
+		return await (await fetch(`${base}/agentmemory/${path}`, { signal: AbortSignal.timeout(timeoutMs) })).json();
+	} catch {
+		return null;
+	}
 }
 async function runStatus() {
-	const port = getRestPort();
-	const base = `http://localhost:${port}`;
+	getRestPort();
+	const base = getBaseUrl();
 	p.intro("agentmemory status");
 	if (!await isEngineRunning()) {
-		p.log.error(`Not running — no response on port ${port}`);
+		p.log.error(`Not running — no response at ${base}`);
 		p.log.info("Start with: npx @agentmemory/agentmemory");
 		process.exit(1);
 	}
 	try {
-		const [healthRes, sessionsRes, graphRes, memoriesRes] = await Promise.all([
-			fetch(`${base}/agentmemory/health`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
-			fetch(`${base}/agentmemory/sessions`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
-			fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
-			fetch(`${base}/agentmemory/export`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null)
+		const [healthRes, sessionsRes, graphRes, memoriesRes, flagsRes] = await Promise.all([
+			apiFetch(base, "health"),
+			apiFetch(base, "sessions"),
+			apiFetch(base, "graph/stats"),
+			apiFetch(base, "export"),
+			apiFetch(base, "config/flags")
 		]);
 		const h = healthRes?.health;
 		const status = healthRes?.status || "unknown";
 		const version = healthRes?.version || "?";
 		const sessions = Array.isArray(sessionsRes?.sessions) ? sessionsRes.sessions.length : 0;
-		const nodes = graphRes?.nodes || 0;
-		const edges = graphRes?.edges || 0;
+		const nodes = Number(graphRes?.totalNodes ?? graphRes?.nodes ?? graphRes?.nodeCount ?? 0);
+		const edges = Number(graphRes?.totalEdges ?? graphRes?.edges ?? graphRes?.edgeCount ?? 0);
 		const cb = healthRes?.circuitBreaker?.state || "closed";
 		const heapMB = h?.memory ? Math.round(h.memory.heapUsed / 1048576) : 0;
 		const uptime = h?.uptimeSeconds ? Math.round(h.uptimeSeconds) : 0;
@@ -369,7 +416,7 @@ async function runStatus() {
 		const estInjectedTokens = Math.min(obsCount, 50) * 38;
 		const tokensSaved = estFullTokens - estInjectedTokens;
 		const pctSaved = estFullTokens > 0 ? Math.round(tokensSaved / estFullTokens * 100) : 0;
-		p.log.success(`Connected — v${version} on port ${port}`);
+		p.log.success(`Connected — v${version} at ${base}`);
 		const lines = [
 			`Health:       ${status === "healthy" ? "✓ healthy" : status}`,
 			`Sessions:     ${sessions}`,
@@ -379,7 +426,7 @@ async function runStatus() {
 			`Circuit:      ${cb}`,
 			`Heap:         ${heapMB} MB`,
 			`Uptime:       ${uptime}s`,
-			`Viewer:       http://localhost:${port + 2}`
+			`Viewer:       ${getViewerUrl()}`
 		];
 		if (obsCount > 0) {
 			lines.push("");
@@ -387,12 +434,85 @@ async function runStatus() {
 			lines.push(`  Full context: ~${estFullTokens.toLocaleString()} tokens`);
 			lines.push(`  Injected:     ~${estInjectedTokens.toLocaleString()} tokens`);
 		}
+		if (flagsRes) {
+			const provider = flagsRes.provider === "llm" ? "✓ llm" : "✗ noop (no key)";
+			const embed = flagsRes.embeddingProvider === "embeddings" ? "✓ embeddings" : "bm25-only";
+			const flagRows = (flagsRes.flags || []).map((f) => `  ${f.enabled ? "✓" : "✗"} ${f.key.padEnd(32)} ${f.label}`);
+			lines.push("");
+			lines.push(`Provider:     ${provider}`);
+			lines.push(`Embeddings:   ${embed}`);
+			lines.push(`Flags:`);
+			flagRows.forEach((r) => lines.push(r));
+		}
 		p.note(lines.join("\n"), "agentmemory");
 	} catch (err) {
 		p.log.error(err instanceof Error ? err.message : String(err));
 		process.exit(1);
 	}
 }
+function formatChecks(checks) {
+	return checks.map((c) => `${c.ok ? "✓" : "✗"} ${c.name}${c.hint ? `\n   ${c.hint}` : ""}`).join("\n");
+}
+async function runDoctor() {
+	p.intro("agentmemory doctor");
+	const base = getBaseUrl();
+	const viewerUrl = getViewerUrl();
+	const checks = [];
+	const serverUp = await isEngineRunning();
+	checks.push({
+		name: "Server reachable",
+		ok: serverUp,
+		hint: serverUp ? void 0 : `Start with: npx @agentmemory/agentmemory (tried ${base})`
+	});
+	if (!serverUp) {
+		p.note(formatChecks(checks), "server unreachable");
+		process.exit(1);
+	}
+	const [health, flags, graph] = await Promise.all([
+		apiFetch(base, "health", 3e3),
+		apiFetch(base, "config/flags", 3e3),
+		apiFetch(base, "graph/stats", 3e3)
+	]);
+	const viewerUp = await fetch(viewerUrl, { signal: AbortSignal.timeout(2e3) }).then((r) => r.ok).catch(() => false);
+	const hasLlm = flags?.provider === "llm";
+	const hasEmbed = flags?.embeddingProvider === "embeddings";
+	const graphHas = Number(graph?.totalNodes ?? graph?.nodes ?? graph?.nodeCount ?? 0) > 0;
+	checks.push({
+		name: "Health status",
+		ok: health?.status === "healthy",
+		hint: health?.status === "healthy" ? void 0 : `Status: ${health?.status || "unknown"}`
+	}, {
+		name: "Viewer reachable",
+		ok: viewerUp,
+		hint: viewerUp ? void 0 : `${viewerUrl} not responding`
+	}, {
+		name: "LLM provider",
+		ok: hasLlm,
+		hint: hasLlm ? void 0 : "export ANTHROPIC_API_KEY=sk-ant-... (or GEMINI/OPENROUTER/MINIMAX) then restart"
+	}, {
+		name: "Embedding provider",
+		ok: hasEmbed,
+		hint: hasEmbed ? void 0 : "Running BM25-only. Add OPENAI_API_KEY / VOYAGE_API_KEY / COHERE_API_KEY / OLLAMA_HOST for semantic recall"
+	});
+	for (const f of flags?.flags || []) checks.push({
+		name: f.label,
+		ok: f.enabled,
+		hint: f.enabled ? void 0 : f.enableHow
+	});
+	checks.push({
+		name: "Knowledge graph populated",
+		ok: graphHas,
+		hint: graphHas ? void 0 : "Graph is empty. Run a session with GRAPH_EXTRACTION_ENABLED=true, or POST /agentmemory/graph/extract"
+	});
+	const passed = checks.filter((c) => c.ok).length;
+	const total = checks.length;
+	p.note(formatChecks(checks), `${passed}/${total} checks passing`);
+	if (passed === total) p.outro("✓ All checks passed. agentmemory is healthy.");
+	else {
+		p.outro(`${total - passed} issue(s) — follow hints above to fix.`);
+		process.exit(1);
+	}
+}
 function buildDemoSessions() {
 	return [
 		{
@@ -521,9 +641,9 @@ async function runDemo() {
 	const port = getRestPort();
 	const base = `http://localhost:${port}`;
 	p.intro("agentmemory demo");
-	if (!await isEngineRunning()) {
-		p.log.error(`Not running — no response on port ${port}`);
-		p.log.info("Start the server first: npx @agentmemory/agentmemory");
+	if (!await isAgentmemoryReady()) {
+		p.log.error(`agentmemory worker not reachable on port ${port} (livez probe failed). Something may be on the port but it isn't serving /agentmemory/*.`);
+		p.log.info("Start it with: npx @agentmemory/agentmemory");
 		process.exit(1);
 	}
 	const demoProject = "/tmp/agentmemory-demo";
@@ -553,7 +673,7 @@ async function runDemo() {
 		`Notice: searching "database performance optimization"`,
 		`found the N+1 query fix — keyword matching can't do that.`,
 		"",
-		`Viewer:        http://localhost:${port + 2}`,
+		`Viewer:        ${getViewerUrl()}`,
 		`Clean up with: curl -X DELETE "${base}/agentmemory/sessions?project=${demoProject}"`
 	];
 	p.note(lines.join("\n"), "demo complete");
@@ -645,7 +765,7 @@ async function runUpgrade() {
 	].join("\n"), "agentmemory upgrade");
 }
 async function runMcp() {
-	await import("./standalone-BEWvWM5P.mjs");
+	await import("./standalone-BG9uPsDK.mjs");
 }
 async function runImportJsonl() {
 	const pathArg = args.slice(1).filter((a) => !a.startsWith("-"))[0];
@@ -701,7 +821,7 @@ async function runImportJsonl() {
 			process.exit(1);
 		}
 		spinner.stop(`imported ${json.imported ?? 0} file(s), ${json.observations ?? 0} observation(s) across ${json.sessionIds?.length || 0} session(s)`);
-		if (json.sessionIds && json.sessionIds.length > 0) p.log.info(`View at http://localhost:${port + 2} → Replay tab`);
+		if (json.sessionIds && json.sessionIds.length > 0) p.log.info(`View at ${getViewerUrl()} → Replay tab`);
 	} catch (err) {
 		spinner.stop("failed");
 		if (err instanceof Error && err.name === "TimeoutError") p.log.error("import timed out after 2 minutes");
@@ -711,6 +831,7 @@ async function runImportJsonl() {
 }
 ({
 	status: runStatus,
+	doctor: runDoctor,
 	demo: runDemo,
 	upgrade: runUpgrade,
 	mcp: runMcp,