@membank/cli 0.2.0 → 0.3.0

package/dist/index.mjs

@@ -2,11 +2,12 @@
 import { DatabaseManager, EmbeddingService, MEMORY_TYPE_VALUES, MemoryRepository, QueryEngine, SessionContextBuilder, resolveScope } from "@membank/core";
 import { startServer } from "@membank/mcp";
 import { Command } from "commander";
+import { startDashboard } from "@membank/dashboard";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { homedir, tmpdir } from "node:os";
 import * as readline from "node:readline";
 import { createInterface } from "node:readline";
+import { homedir, tmpdir } from "node:os";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { EventEmitter } from "node:events";
@@ -30,6 +31,11 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 	}
 }
 //#endregion
+//#region src/commands/dashboard.ts
+async function dashboardCommand(opts) {
+	await startDashboard({ port: opts.port !== void 0 ? parseInt(opts.port, 10) : void 0 });
+}
+//#endregion
 //#region src/commands/delete.ts
 async function deleteCommand(id, db, formatter, prompt) {
 	if (db.db.prepare(`SELECT id FROM memories WHERE id = ?`).get(id) === void 0) {
@@ -140,7 +146,66 @@ function formatContext(ctx) {
 	lines.push(MEMORY_GUIDANCE);
 	return lines.join("\n");
 }
-async function injectCommand(opts) {
+function outputAdditionalContext(text, harness, eventName) {
+	if (harness === "claude-code") {
+		process.stdout.write(JSON.stringify({ hookSpecificOutput: {
+			hookEventName: eventName,
+			additionalContext: text
+		} }));
+		return;
+	}
+	if (harness === "copilot-cli") {
+		process.stdout.write(JSON.stringify({ additionalContext: text }));
+		return;
+	}
+	process.stdout.write(`${text}\n`);
+}
+async function readStdin() {
+	if (process.stdin.isTTY) return "";
+	return new Promise((resolve) => {
+		const chunks = [];
+		const timeout = setTimeout(() => resolve(""), 1e3);
+		process.stdin.on("data", (chunk) => chunks.push(chunk));
+		process.stdin.on("end", () => {
+			clearTimeout(timeout);
+			resolve(Buffer.concat(chunks).toString("utf8"));
+		});
+		process.stdin.on("error", () => {
+			clearTimeout(timeout);
+			resolve("");
+		});
+	});
+}
+const FEEDBACK_PATTERNS = [
+	/\bdon'?t\b/i,
+	/\bstop\b/i,
+	/\bnever\b/i,
+	/\balways\b/i,
+	/\bremember\b/i,
+	/\bprefer\b/i,
+	/\bi (like|want|hate|dislike)\b/i,
+	/\bfrom now on\b/i,
+	/\bkeep in mind\b/i,
+	/\bnote that\b/i,
+	/\bstop doing\b/i,
+	/\bstop using\b/i,
+	/\bthat'?s wrong\b/i,
+	/\bno,?\s+(actually|that'?s)\b/i,
+	/\bplease (don'?t|stop|always|never)\b/i
+];
+function looksLikeFeedback(prompt) {
+	return FEEDBACK_PATTERNS.some((p) => p.test(prompt));
+}
+function isToolFailure(data) {
+	if (data.hook_event_name === "PostToolUseFailure") return true;
+	if (typeof data.error_message === "string" && data.error_message.length > 0) return true;
+	const response = data.tool_result ?? data.tool_response;
+	if (typeof response === "object" && response !== null) {
+		if (response.is_error === true) return true;
+	}
+	return false;
+}
+async function handleSessionStart(opts) {
 	const projectScope = opts.scope ?? await resolveScope();
 	const db = DatabaseManager.open();
 	let text;
@@ -151,18 +216,44 @@ async function injectCommand(opts) {
 	}
 	if (!text) process.exit(0);
 	const harness = opts.harness;
-	if (harness === "claude-code") {
-		process.stdout.write(JSON.stringify({ hookSpecificOutput: {
-			hookEventName: "SessionStart",
-			additionalContext: text
-		} }));
+	outputAdditionalContext(text, harness, "SessionStart");
+}
+async function handleUserPrompt(harness) {
+	const raw = await readStdin();
+	if (!raw) process.exit(0);
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		process.exit(0);
+	}
+	if (!looksLikeFeedback(typeof data.prompt === "string" ? data.prompt : "")) process.exit(0);
+	outputAdditionalContext("User prompt may contain a correction, preference, or decision worth saving. After responding, evaluate: should this be saved as a memory? If yes, call save_memory with the appropriate type (correction/preference/decision/learning) and scope (global or project).", harness, "UserPromptSubmit");
+}
+async function handleToolFailure(harness) {
+	const raw = await readStdin();
+	if (!raw) process.exit(0);
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		process.exit(0);
+	}
+	if (!isToolFailure(data)) process.exit(0);
+	outputAdditionalContext(`Tool "${typeof data.tool_name === "string" ? data.tool_name : "unknown"}" failed. If this reveals a non-obvious constraint, environment issue, or repeatable failure pattern, call save_memory with type "learning" to prevent repeating it.`, harness, "PostToolUseFailure");
+}
+async function injectCommand(opts) {
+	const harness = opts.harness;
+	const event = opts.event ?? "session-start";
+	if (event === "user-prompt") {
+		await handleUserPrompt(harness);
 		return;
 	}
-	if (harness === "copilot-cli") {
-		process.stdout.write(JSON.stringify({ additionalContext: text }));
+	if (event === "tool-failure") {
+		await handleToolFailure(harness);
 		return;
 	}
-	process.stdout.write(`${text}\n`);
+	await handleSessionStart(opts);
 }
 //#endregion
 //#region src/commands/list.ts
@@ -225,303 +316,6 @@ async function statsCommand(formatter) {
 	}
 }
 //#endregion
-//#region src/setup/injection-hook-writer.ts
-const defaultPathResolver$1 = { home: () => {
-	const h = process.env.HOME ?? process.env.USERPROFILE;
-	if (!h) throw new Error("Cannot determine home directory");
-	return h;
-} };
-function readJson$1(path) {
-	try {
-		return JSON.parse(readFileSync(path, "utf8"));
-	} catch {
-		return {};
-	}
-}
-function writeJsonAtomic$1(path, data) {
-	mkdirSync(dirname(path), { recursive: true });
-	const tmp = join(mkdtempSync(join(tmpdir(), "membank-hook-")), "cfg.json");
-	writeFileSync(tmp, JSON.stringify(data, null, 2));
-	renameSync(tmp, path);
-}
-function getHooksArray(group) {
-	if (typeof group !== "object" || group === null) return [];
-	const h = group.hooks;
-	return Array.isArray(h) ? h : [];
-}
-function findMembankHookCommand(hooks, pattern) {
-	for (const h of hooks) {
-		if (typeof h !== "object" || h === null) continue;
-		if ("command" in h && typeof h.command === "string" && h.command.includes(pattern)) return h.command;
-		if ("bash" in h && typeof h.bash === "string" && h.bash.includes(pattern)) return h.bash;
-	}
-	return "";
-}
-function containsMembankInject(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli inject") !== "";
-}
-function extractInjectCommand(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli inject");
-}
-const writers$1 = {
-	"claude-code": {
-		replacement: "npx @membank/cli inject --harness claude-code",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".claude", "settings.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingGroups = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
-			const innerHooks = existingGroups.flatMap(getHooksArray);
-			if (!overwrite && containsMembankInject(innerHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(innerHooks),
-				replacement: this.replacement
-			};
-			const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankInject(getHooksArray(g))) : existingGroups;
-			writeJsonAtomic$1(cfgPath, {
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					SessionStart: [...filteredGroups, {
-						matcher: "",
-						hooks: [{
-							type: "command",
-							command: this.replacement
-						}]
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	"copilot-cli": {
-		replacement: "npx @membank/cli inject --harness copilot-cli",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".copilot", "settings.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingHooks = Array.isArray(hooks?.sessionStart) ? hooks.sessionStart : [];
-			if (!overwrite && containsMembankInject(existingHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(existingHooks),
-				replacement: this.replacement
-			};
-			const filteredHooks = overwrite ? existingHooks.filter((h) => !containsMembankInject([h])) : existingHooks;
-			writeJsonAtomic$1(cfgPath, {
-				version: cfg.version ?? 1,
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					sessionStart: [...filteredHooks, {
-						type: "command",
-						bash: this.replacement,
-						timeoutSec: 30
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	codex: {
-		replacement: "npx @membank/cli inject --harness codex",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".codex", "hooks.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingGroups = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
-			const innerHooks = existingGroups.flatMap(getHooksArray);
-			if (!overwrite && containsMembankInject(innerHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(innerHooks),
-				replacement: this.replacement
-			};
-			const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankInject(getHooksArray(g))) : existingGroups;
-			writeJsonAtomic$1(cfgPath, {
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					SessionStart: [...filteredGroups, {
-						matcher: "",
-						hooks: [{
-							type: "command",
-							command: this.replacement,
-							timeout: 30
-						}]
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	opencode: {
-		replacement: "npx @membank/cli inject",
-		write(resolver, overwrite = false) {
-			const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
-			if (!overwrite && existsSync(pluginPath)) {
-				const existing = readFileSync(pluginPath, "utf8");
-				if (existing.includes("@membank/cli inject")) return {
-					status: "already-configured",
-					existing: existing.trim(),
-					replacement: newOpencodePlugin()
-				};
-			}
-			mkdirSync(dirname(pluginPath), { recursive: true });
-			writeFileSync(pluginPath, `${newOpencodePlugin()}\n`, "utf8");
-			return { status: "written" };
-		}
-	}
-};
-function newOpencodePlugin(includeIdle = false) {
-	return [
-		"export default {",
-		"  hooks: {",
-		"    \"session.start\": async ({ $ }) => {",
-		"      return await $`npx @membank/cli inject`.text();",
-		"    },",
-		...includeIdle ? [
-			"    \"session.idle\": async ({ $ }) => {",
-			"      return await $`npx @membank/cli stop-hook --harness opencode`.text();",
-			"    },"
-		] : [],
-		"  },",
-		"};"
-	].join("\n");
-}
-const STOP_HOOK_PROMPT = "Review this session and consider whether any user preferences, corrections, decisions, or learnings are worth saving for future sessions. If so, use the save_memory MCP tool to store them. Be selective — only save what would genuinely help in a future conversation. Skip ephemeral task details.";
-function containsMembankStopHookCmd(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli stop-hook") !== "";
-}
-function extractStopHookCmd(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli stop-hook");
-}
-function containsMembankStopPrompt(stopGroups) {
-	return stopGroups.some((g) => getHooksArray(g).some((h) => typeof h === "object" && h !== null && "type" in h && h.type === "prompt" && "prompt" in h && typeof h.prompt === "string" && h.prompt.includes("save_memory")));
-}
-function extractStopPrompt(stopGroups) {
-	for (const g of stopGroups) for (const h of getHooksArray(g)) if (typeof h === "object" && h !== null && "type" in h && h.type === "prompt" && "prompt" in h && typeof h.prompt === "string" && h.prompt.includes("save_memory")) return h.prompt;
-	return "";
-}
-const stopHookWriters = {
-	"claude-code": { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".claude", "settings.json");
-		const cfg = readJson$1(cfgPath);
-		const hooks = cfg.hooks;
-		const existingStop = Array.isArray(hooks?.Stop) ? hooks.Stop : [];
-		if (!overwrite && containsMembankStopPrompt(existingStop)) return {
-			status: "already-configured",
-			existing: extractStopPrompt(existingStop),
-			replacement: STOP_HOOK_PROMPT
-		};
-		const filteredStop = overwrite ? existingStop.filter((g) => !containsMembankStopPrompt([g])) : existingStop;
-		writeJsonAtomic$1(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				Stop: [...filteredStop, { hooks: [{
-					type: "prompt",
-					prompt: STOP_HOOK_PROMPT
-				}] }]
-			}
-		});
-		return { status: "written" };
-	} },
-	"copilot-cli": { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".copilot", "settings.json");
-		const cfg = readJson$1(cfgPath);
-		const replacement = "npx @membank/cli stop-hook --harness copilot-cli";
-		const hooks = cfg.hooks;
-		const existingStop = Array.isArray(hooks?.stop) ? hooks.stop : [];
-		if (!overwrite && containsMembankStopHookCmd(existingStop)) return {
-			status: "already-configured",
-			existing: extractStopHookCmd(existingStop),
-			replacement
-		};
-		const filteredStop = overwrite ? existingStop.filter((h) => !containsMembankStopHookCmd([h])) : existingStop;
-		writeJsonAtomic$1(cfgPath, {
-			version: cfg.version ?? 1,
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				stop: [...filteredStop, {
-					type: "command",
-					bash: replacement,
-					timeoutSec: 30
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	codex: { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".codex", "hooks.json");
-		const cfg = readJson$1(cfgPath);
-		const replacement = "npx @membank/cli stop-hook --harness codex";
-		const hooks = cfg.hooks;
-		const existingGroups = Array.isArray(hooks?.Stop) ? hooks.Stop : [];
-		const innerHooks = existingGroups.flatMap(getHooksArray);
-		if (!overwrite && containsMembankStopHookCmd(innerHooks)) return {
-			status: "already-configured",
-			existing: extractStopHookCmd(innerHooks),
-			replacement
-		};
-		const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankStopHookCmd(getHooksArray(g))) : existingGroups;
-		writeJsonAtomic$1(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				Stop: [...filteredGroups, {
-					matcher: "",
-					hooks: [{
-						type: "command",
-						command: replacement,
-						timeout: 30
-					}]
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	opencode: { write(resolver, overwrite = false) {
-		const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
-		if (!overwrite && existsSync(pluginPath)) {
-			const existing = readFileSync(pluginPath, "utf8");
-			if (existing.includes("@membank/cli stop-hook")) return {
-				status: "already-configured",
-				existing: existing.trim(),
-				replacement: newOpencodePlugin(true)
-			};
-		}
-		mkdirSync(dirname(pluginPath), { recursive: true });
-		writeFileSync(pluginPath, `${newOpencodePlugin(true)}\n`, "utf8");
-		return { status: "written" };
-	} }
-};
-var InjectionHookWriter = class {
-	#resolver;
-	constructor(resolver = defaultPathResolver$1) {
-		this.#resolver = resolver;
-	}
-	write(harness, overwrite) {
-		const writer = writers$1[harness];
-		if (!writer) return { status: "not-supported" };
-		return writer.write(this.#resolver, overwrite);
-	}
-	writeStopHook(harness, overwrite) {
-		const writer = stopHookWriters[harness];
-		if (!writer) return { status: "not-supported" };
-		return writer.write(this.#resolver, overwrite);
-	}
-};
-//#endregion
-//#region src/commands/stop-hook.ts
-function stopHookCommand(opts) {
-	const { harness } = opts;
-	if (harness === "copilot-cli" || harness === "codex") {
-		process.stdout.write(JSON.stringify({ systemMessage: STOP_HOOK_PROMPT }));
-		return;
-	}
-	process.stdout.write(`${STOP_HOOK_PROMPT}\n`);
-}
-//#endregion
 //#region src/commands/unpin.ts
 function unpinCommand(id, formatter, db) {
 	const ownDb = db === void 0;
@@ -668,7 +462,7 @@ async function execFileNoThrow(cmd, args) {
 }
 //#endregion
 //#region src/setup/harness-config-writer.ts
-const defaultPathResolver = {
+const defaultPathResolver$1 = {
 	home: () => {
 		const h = process.env.HOME ?? process.env.USERPROFILE;
 		if (!h) throw new Error("Cannot determine home directory");
@@ -676,14 +470,14 @@ const defaultPathResolver = {
 	},
 	cwd: () => process.cwd()
 };
-function readJson(path) {
+function readJson$1(path) {
 	try {
 		return JSON.parse(readFileSync(path, "utf8"));
 	} catch {
 		return {};
 	}
 }
-function writeJsonAtomic(path, data) {
+function writeJsonAtomic$1(path, data) {
 	mkdirSync(dirname(path), { recursive: true });
 	const tmp = join(mkdtempSync(join(tmpdir(), "membank-")), "cfg.json");
 	writeFileSync(tmp, JSON.stringify(data, null, 2));
@@ -700,9 +494,9 @@ const MEMBANK_NPX_ARGS = [
 	"@membank/cli@latest",
 	"--mcp"
 ];
-const writers = {
+const writers$1 = {
 	"claude-code": { async write(resolver, run, { overwrite = false } = {}) {
-		const configured = hasKey(readJson(join(resolver.home(), ".claude.json")).mcpServers, "membank");
+		const configured = hasKey(readJson$1(join(resolver.home(), ".claude.json")).mcpServers, "membank");
 		if (configured && !overwrite) return { status: "already-configured" };
 		if (configured) {
 			const remove = await run("claude", [
@@ -730,9 +524,9 @@ const writers = {
 	} },
 	copilot: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".copilot", "mcp-config.json");
-		const cfg = readJson(cfgPath);
+		const cfg = readJson$1(cfgPath);
 		if (hasKey(cfg.mcpServers, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic(cfgPath, {
+		writeJsonAtomic$1(cfgPath, {
 			...cfg,
 			mcpServers: {
 				...cfg.mcpServers,
@@ -771,9 +565,9 @@ const writers = {
 	} },
 	opencode: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".config", "opencode", "opencode.json");
-		const cfg = readJson(cfgPath);
+		const cfg = readJson$1(cfgPath);
 		if (hasKey(cfg.mcp, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic(cfgPath, {
+		writeJsonAtomic$1(cfgPath, {
 			...cfg,
 			mcp: {
 				...cfg.mcp,
@@ -790,21 +584,254 @@ const writers = {
 		return { status: "written" };
 	} }
 };
-const SUPPORTED_HARNESSES = Object.keys(writers);
+const SUPPORTED_HARNESSES = Object.keys(writers$1);
 var HarnessConfigWriter = class {
 	#resolver;
 	#run;
-	constructor(resolver = defaultPathResolver, run = execFileNoThrow) {
+	constructor(resolver = defaultPathResolver$1, run = execFileNoThrow) {
 		this.#resolver = resolver;
 		this.#run = run;
 	}
 	async write(harness, { overwrite = false } = {}) {
-		const writer = writers[harness];
+		const writer = writers$1[harness];
 		if (!writer) throw new Error(`Unknown harness: ${harness}`);
 		return writer.write(this.#resolver, this.#run, { overwrite });
 	}
 };
 //#endregion
+//#region src/setup/injection-hook-writer.ts
+const defaultPathResolver = { home: () => {
+	const h = process.env.HOME ?? process.env.USERPROFILE;
+	if (!h) throw new Error("Cannot determine home directory");
+	return h;
+} };
+function readJson(path) {
+	try {
+		return JSON.parse(readFileSync(path, "utf8"));
+	} catch {
+		return {};
+	}
+}
+function writeJsonAtomic(path, data) {
+	mkdirSync(dirname(path), { recursive: true });
+	const tmp = join(mkdtempSync(join(tmpdir(), "membank-hook-")), "cfg.json");
+	writeFileSync(tmp, JSON.stringify(data, null, 2));
+	renameSync(tmp, path);
+}
+function getHooksArray(group) {
+	if (typeof group !== "object" || group === null) return [];
+	const h = group.hooks;
+	return Array.isArray(h) ? h : [];
+}
+function findMembankHookCommand(hooks, pattern) {
+	for (const h of hooks) {
+		if (typeof h !== "object" || h === null) continue;
+		if ("command" in h && typeof h.command === "string" && h.command.includes(pattern)) return h.command;
+		if ("bash" in h && typeof h.bash === "string" && h.bash.includes(pattern)) return h.bash;
+	}
+	return "";
+}
+function containsMembankInject(hooks) {
+	return findMembankHookCommand(hooks, "@membank/cli inject") !== "";
+}
+function extractInjectCommand(hooks) {
+	return findMembankHookCommand(hooks, "@membank/cli inject");
+}
+function filterOutMembank(groups) {
+	return groups.filter((g) => !containsMembankInject(getHooksArray(g)));
+}
+function filterOutMembankFlat(hooks) {
+	return hooks.filter((h) => !containsMembankInject([h]));
+}
+const writers = {
+	"claude-code": {
+		replacement: "npx @membank/cli inject --harness claude-code",
+		write(resolver, overwrite = false) {
+			const cfgPath = join(resolver.home(), ".claude", "settings.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks;
+			const existingSessionStart = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
+			const innerHooks = existingSessionStart.flatMap(getHooksArray);
+			if (!overwrite && containsMembankInject(innerHooks)) return {
+				status: "already-configured",
+				existing: extractInjectCommand(innerHooks),
+				replacement: this.replacement
+			};
+			const filteredSessionStart = overwrite ? filterOutMembank(existingSessionStart) : existingSessionStart;
+			const existingUserPrompt = Array.isArray(hooks?.UserPromptSubmit) ? hooks.UserPromptSubmit : [];
+			const existingToolFailure = Array.isArray(hooks?.PostToolUseFailure) ? hooks.PostToolUseFailure : [];
+			writeJsonAtomic(cfgPath, {
+				...cfg,
+				hooks: {
+					...hooks ?? {},
+					SessionStart: [...filteredSessionStart, {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --harness claude-code"
+						}]
+					}],
+					UserPromptSubmit: [...filterOutMembank(existingUserPrompt), {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --event user-prompt --harness claude-code"
+						}]
+					}],
+					PostToolUseFailure: [...filterOutMembank(existingToolFailure), {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --event tool-failure --harness claude-code"
+						}]
+					}]
+				}
+			});
+			return { status: "written" };
+		}
+	},
+	"copilot-cli": {
+		replacement: "npx @membank/cli inject --harness copilot-cli",
+		write(resolver, overwrite = false) {
+			const cfgPath = join(resolver.home(), ".copilot", "settings.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks;
+			const existingSessionStart = Array.isArray(hooks?.sessionStart) ? hooks.sessionStart : [];
+			if (!overwrite && containsMembankInject(existingSessionStart)) return {
+				status: "already-configured",
+				existing: extractInjectCommand(existingSessionStart),
+				replacement: this.replacement
+			};
+			const filteredSessionStart = overwrite ? filterOutMembankFlat(existingSessionStart) : existingSessionStart;
+			const existingUserPrompt = Array.isArray(hooks?.userPromptSubmitted) ? hooks.userPromptSubmitted : [];
+			const existingToolFailure = Array.isArray(hooks?.postToolUseFailure) ? hooks.postToolUseFailure : [];
+			writeJsonAtomic(cfgPath, {
+				version: cfg.version ?? 1,
+				...cfg,
+				hooks: {
+					...hooks ?? {},
+					sessionStart: [...filteredSessionStart, {
+						type: "command",
+						bash: "npx @membank/cli inject --harness copilot-cli",
+						timeoutSec: 30
+					}],
+					userPromptSubmitted: [...filterOutMembankFlat(existingUserPrompt), {
+						type: "command",
+						bash: "npx @membank/cli inject --event user-prompt --harness copilot-cli",
+						timeoutSec: 30
+					}],
+					postToolUseFailure: [...filterOutMembankFlat(existingToolFailure), {
+						type: "command",
+						bash: "npx @membank/cli inject --event tool-failure --harness copilot-cli",
+						timeoutSec: 30
+					}]
+				}
+			});
+			return { status: "written" };
+		}
+	},
+	codex: {
+		replacement: "npx @membank/cli inject --harness codex",
+		write(resolver, overwrite = false) {
+			const cfgPath = join(resolver.home(), ".codex", "hooks.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks;
+			const existingSessionStart = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
+			const innerHooks = existingSessionStart.flatMap(getHooksArray);
+			if (!overwrite && containsMembankInject(innerHooks)) return {
+				status: "already-configured",
+				existing: extractInjectCommand(innerHooks),
+				replacement: this.replacement
+			};
+			const filteredSessionStart = overwrite ? filterOutMembank(existingSessionStart) : existingSessionStart;
+			const existingUserPrompt = Array.isArray(hooks?.UserPromptSubmit) ? hooks.UserPromptSubmit : [];
+			const existingToolFailure = Array.isArray(hooks?.PostToolUse) ? hooks.PostToolUse : [];
+			writeJsonAtomic(cfgPath, {
+				...cfg,
+				hooks: {
+					...hooks ?? {},
+					SessionStart: [...filteredSessionStart, {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --harness codex",
+							timeout: 30
+						}]
+					}],
+					UserPromptSubmit: [...filterOutMembank(existingUserPrompt), {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --event user-prompt --harness codex",
+							timeout: 30
+						}]
+					}],
+					PostToolUse: [...filterOutMembank(existingToolFailure), {
+						matcher: "",
+						hooks: [{
+							type: "command",
+							command: "npx @membank/cli inject --event tool-failure --harness codex",
+							timeout: 30
+						}]
+					}]
+				}
+			});
+			return { status: "written" };
+		}
+	},
+	opencode: {
+		replacement: "npx @membank/cli inject",
+		write(resolver, overwrite = false) {
+			const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
+			if (!overwrite && existsSync(pluginPath)) {
+				const existing = readFileSync(pluginPath, "utf8");
+				if (existing.includes("@membank/cli inject")) return {
+					status: "already-configured",
+					existing: existing.trim(),
+					replacement: newOpencodePlugin()
+				};
+			}
+			mkdirSync(dirname(pluginPath), { recursive: true });
+			writeFileSync(pluginPath, `${newOpencodePlugin()}\n`, "utf8");
+			return { status: "written" };
+		}
+	}
+};
+function newOpencodePlugin() {
+	return [
+		"export default {",
+		"  hooks: {",
+		"    \"session.start\": async ({ $ }) => {",
+		"      return await $`npx @membank/cli inject`.text();",
+		"    },",
+		"    \"chat.message\": async ({ $, message }) => {",
+		"      const input = JSON.stringify({ prompt: message?.content ?? \"\" });",
+		"      return await $`npx @membank/cli inject --event user-prompt`.stdin(input).text();",
+		"    },",
+		"    \"tool.execute.after\": async ({ $, result }) => {",
+		"      if (!result?.exitCode && !result?.error) return;",
+		"      const payload = JSON.stringify({",
+		"        tool_name: result.tool ?? \"unknown\",",
+		"        error_message: result.error ?? (\"exit code \" + result.exitCode),",
+		"      });",
+		"      return await $`npx @membank/cli inject --event tool-failure`.stdin(payload).text();",
+		"    },",
+		"  },",
+		"};"
+	].join("\n");
+}
+var InjectionHookWriter = class {
+	#resolver;
+	constructor(resolver = defaultPathResolver) {
+		this.#resolver = resolver;
+	}
+	write(harness, overwrite) {
+		const writer = writers[harness];
+		if (!writer) return { status: "not-supported" };
+		return writer.write(this.#resolver, overwrite);
+	}
+};
+//#endregion
 //#region src/setup/model-downloader.ts
 const MODEL_NAME = "Xenova/bge-small-en-v1.5";
 var ModelDownloadError = class extends Error {
@@ -954,7 +981,6 @@ var SetupOrchestrator = class {
 				detectedHarnesses: [],
 				configuredHarnesses: [],
 				injectionHooksConfigured: [],
-				stopHooksConfigured: [],
 				modelDownloaded: false
 			}));
 			return [];
@@ -968,10 +994,7 @@ var SetupOrchestrator = class {
 			out("Planned changes (dry-run — no files written):");
 			for (const h of detected) {
 				out(`  ⚠ ${h.name}: would write MCP config`);
-				if (this.#hookWriter) {
-					out(`  ⚠ ${h.name}: would write injection hook config`);
-					out(`  ⚠ ${h.name}: would write stop hook config`);
-				}
+				if (this.#hookWriter) out(`  ⚠ ${h.name}: would write injection hook config`);
 			}
 			out("");
 			out("  ⚠ Model download: skipped (dry-run)");
@@ -1038,11 +1061,9 @@ var SetupOrchestrator = class {
 		}
 		out("");
 		const injectionHooksConfigured = [];
-		const stopHooksConfigured = [];
 		if (this.#hookWriter) {
 			const w = this.#hookWriter;
 			injectionHooksConfigured.push(...await this.#runHookLoop(detected, "injection hook", (h, ow) => w.write(h, ow), yes, out));
-			stopHooksConfigured.push(...await this.#runHookLoop(detected, "stop hook", (h, ow) => w.writeStopHook(h, ow), yes, out));
 			out("");
 		}
 		let modelDownloaded = false;
@@ -1056,7 +1077,6 @@ var SetupOrchestrator = class {
 				detectedHarnesses: detected.map((h) => h.name),
 				configuredHarnesses: results.filter((r) => r.status === "written").map((r) => r.harness),
 				injectionHooksConfigured,
-				stopHooksConfigured,
 				modelDownloaded
 			};
 			this.#out(JSON.stringify(output));
@@ -1221,7 +1241,7 @@ program.command("import <file>").description("import memories from a JSON export
 		db.close();
 	}
 });
-program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--scope <scope>", "project scope override (default: auto-detect from git remote)").action(async (cmdOptions) => {
+program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--scope <scope>", "project scope override (default: auto-detect from git remote)").option("--event <event>", "hook event type (session-start|user-prompt|tool-failure)", "session-start").action(async (cmdOptions) => {
 	try {
 		await injectCommand(cmdOptions);
 	} catch (err) {
@@ -1229,9 +1249,6 @@ program.command("inject").description("output session context for harness inject
 		process.exit(2);
 	}
 });
-program.command("stop-hook").description("output session-end prompt for harness stop hooks (called by hooks, not users)").option("--harness <name>", "harness name (copilot-cli, codex, opencode)").action((cmdOptions) => {
-	stopHookCommand(cmdOptions);
-});
 program.command("setup").description("detect installed harnesses and write MCP config for each").option("--yes", "skip all confirmation prompts").option("--dry-run", "print planned changes without writing any file").option("--harness <name>", "target only the named harness (skip detection)").action(async (cmdOptions) => {
 	const globalOpts = program.opts();
 	const autoYes = cmdOptions.yes === true || globalOpts.yes === true;
@@ -1263,6 +1280,14 @@ program.command("setup").description("detect installed harnesses and write MCP c
 		process.exit(2);
 	}
 });
+program.command("dashboard").description("open the memory management dashboard in the browser").option("--port <port>", "port to listen on (default: 3847, fallback to random)").action(async (cmdOptions) => {
+	try {
+		await dashboardCommand(cmdOptions);
+	} catch (err) {
+		process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+		process.exit(2);
+	}
+});
 program.on("command:*", () => {
 	program.outputHelp();
 	process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,8 +17,9 @@
     "@huggingface/transformers": "^4.2.0",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
-    "@membank/core": "0.2.0",
-    "@membank/mcp": "0.2.0"
+    "@membank/dashboard": "0.1.0",
+    "@membank/mcp": "0.3.0",
+    "@membank/core": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",