@membank/cli 0.1.1 → 0.2.0

package/README.md

@@ -0,0 +1,154 @@
+# @membank/cli
+
+CLI and npx entrypoint for membank. Manages memories from the terminal and starts the MCP server for LLM harnesses.
+
+## Install
+
+```bash
+npm install -g @membank/cli
+```
+
+Or use without installing:
+
+```bash
+npx @membank/cli <command>
+```
+
+## Setup
+
+Run once to configure your LLM harness:
+
+```bash
+membank setup
+```
+
+This auto-detects installed harnesses (Claude Code, GitHub Copilot CLI, Codex, OpenCode), writes MCP server config, installs session hooks, and downloads the embedding model (~33 MB).
+
+Options:
+
+```
+--harness <name>   Target a specific harness instead of auto-detecting
+--yes              Skip confirmation prompts
+--dry-run          Preview changes without writing files
+--json             Machine-readable output
+```
+
+Supported harnesses: `claude-code`, `copilot`, `codex`, `opencode`
+
+## Commands
+
+### `membank query <text>`
+
+Semantic search over stored memories.
+
+```bash
+membank query "how to run pnpm in one package"
+membank query "auth decisions" --type decision --limit 5
+```
+
+Options: `--type <type>`, `--limit <n>` (default 10)
+
+### `membank add <content>`
+
+Save a new memory.
+
+```bash
+membank add "Use --filter flag for scoped pnpm commands" --type preference --tags "pnpm,monorepo"
+```
+
+Required: `--type <type>`  
+Options: `--tags <a,b,c>`, `--scope <scope>`
+
+### `membank list`
+
+List stored memories.
+
+```bash
+membank list
+membank list --type correction
+membank list --pinned
+```
+
+Options: `--type <type>`, `--pinned`
+
+### `membank stats`
+
+Show memory counts by type.
+
+```bash
+membank stats
+```
+
+### `membank pin <id>` / `membank unpin <id>`
+
+Pin a memory so it's always injected at session start.
+
+```bash
+membank pin abc123
+membank unpin abc123
+```
+
+### `membank delete <id>`
+
+Delete a memory. Prompts for confirmation unless `--yes` is passed.
+
+```bash
+membank delete abc123
+membank delete abc123 --yes
+```
+
+### `membank export`
+
+Export all memories to a JSON file.
+
+```bash
+membank export
+membank export --output my-backup.json
+```
+
+Default filename: `membank-export-<timestamp>.json`
+
+### `membank import <file>`
+
+Import memories from an export file.
+
+```bash
+membank import membank-export-2025-01-01.json
+membank import membank-export-2025-01-01.json --yes
+```
+
+### `membank inject`
+
+Output session context formatted for a harness. Called automatically by session hooks — you don't normally run this directly.
+
+```bash
+membank inject --harness claude-code --scope <project-scope>
+```
+
+## Global flags
+
+```
+--json     Output machine-readable JSON
+--yes, -y  Skip confirmation prompts
+--mcp      Start MCP stdio server (used by harness config)
+```
+
+## MCP server mode
+
+```bash
+membank --mcp
+```
+
+Starts the stdio MCP server. This is what harnesses connect to — `setup` writes this command into harness configs automatically.
+
+## Session hooks
+
+`setup` installs two hooks:
+
+**Session start** — calls `membank inject` to prepend pinned memories into the LLM context at the beginning of every session.
+
+**Session stop (Claude Code only)** — prompts the LLM to review the session and call `save_memory` for any notable corrections, preferences, or decisions.
+
+## Requirements
+
+- Node.js >=24

package/dist/index.mjs

@@ -4,9 +4,9 @@ import { startServer } from "@membank/mcp";
 import { Command } from "commander";
 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";
@@ -225,6 +225,303 @@ 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;
@@ -371,7 +668,7 @@ async function execFileNoThrow(cmd, args) {
 }
 //#endregion
 //#region src/setup/harness-config-writer.ts
-const defaultPathResolver$1 = {
+const defaultPathResolver = {
 	home: () => {
 		const h = process.env.HOME ?? process.env.USERPROFILE;
 		if (!h) throw new Error("Cannot determine home directory");
@@ -379,14 +676,14 @@ const defaultPathResolver$1 = {
 	},
 	cwd: () => process.cwd()
 };
-function readJson$1(path) {
+function readJson(path) {
 	try {
 		return JSON.parse(readFileSync(path, "utf8"));
 	} catch {
 		return {};
 	}
 }
-function writeJsonAtomic$1(path, data) {
+function writeJsonAtomic(path, data) {
 	mkdirSync(dirname(path), { recursive: true });
 	const tmp = join(mkdtempSync(join(tmpdir(), "membank-")), "cfg.json");
 	writeFileSync(tmp, JSON.stringify(data, null, 2));
@@ -403,9 +700,9 @@ const MEMBANK_NPX_ARGS = [
 	"@membank/cli@latest",
 	"--mcp"
 ];
-const writers$1 = {
+const writers = {
 	"claude-code": { async write(resolver, run, { overwrite = false } = {}) {
-		const configured = hasKey(readJson$1(join(resolver.home(), ".claude.json")).mcpServers, "membank");
+		const configured = hasKey(readJson(join(resolver.home(), ".claude.json")).mcpServers, "membank");
 		if (configured && !overwrite) return { status: "already-configured" };
 		if (configured) {
 			const remove = await run("claude", [
@@ -433,9 +730,9 @@ const writers$1 = {
 	} },
 	copilot: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".copilot", "mcp-config.json");
-		const cfg = readJson$1(cfgPath);
+		const cfg = readJson(cfgPath);
 		if (hasKey(cfg.mcpServers, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic$1(cfgPath, {
+		writeJsonAtomic(cfgPath, {
 			...cfg,
 			mcpServers: {
 				...cfg.mcpServers,
@@ -474,9 +771,9 @@ const writers$1 = {
 	} },
 	opencode: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".config", "opencode", "opencode.json");
-		const cfg = readJson$1(cfgPath);
+		const cfg = readJson(cfgPath);
 		if (hasKey(cfg.mcp, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic$1(cfgPath, {
+		writeJsonAtomic(cfgPath, {
 			...cfg,
 			mcp: {
 				...cfg.mcp,
@@ -493,142 +790,21 @@ const writers$1 = {
 		return { status: "written" };
 	} }
 };
-const SUPPORTED_HARNESSES = Object.keys(writers$1);
+const SUPPORTED_HARNESSES = Object.keys(writers);
 var HarnessConfigWriter = class {
 	#resolver;
 	#run;
-	constructor(resolver = defaultPathResolver$1, run = execFileNoThrow) {
+	constructor(resolver = defaultPathResolver, run = execFileNoThrow) {
 		this.#resolver = resolver;
 		this.#run = run;
 	}
 	async write(harness, { overwrite = false } = {}) {
-		const writer = writers$1[harness];
+		const writer = writers[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 containsMembankInject(hooks) {
-	if (!Array.isArray(hooks)) return false;
-	return hooks.some((h) => typeof h === "object" && h !== null && ("command" in h && typeof h.command === "string" && h.command.includes("@membank/cli inject") || "bash" in h && typeof h.bash === "string" && h.bash.includes("@membank/cli inject")));
-}
-const writers = {
-	"claude-code": { write(resolver) {
-		const cfgPath = join(resolver.home(), ".claude", "settings.json");
-		const cfg = readJson(cfgPath);
-		const hooks = cfg.hooks;
-		const sessionStart = hooks?.SessionStart;
-		if (Array.isArray(sessionStart) && containsMembankInject(sessionStart.flatMap((g) => Array.isArray(g.hooks) ? g.hooks : []))) return { status: "already-configured" };
-		const existingSessionStart = Array.isArray(sessionStart) ? sessionStart : [];
-		writeJsonAtomic(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				SessionStart: [...existingSessionStart, {
-					matcher: "",
-					hooks: [{
-						type: "command",
-						command: "npx @membank/cli inject --harness claude-code"
-					}]
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	"copilot-cli": { write(resolver) {
-		const cfgPath = join(resolver.home(), ".copilot", "settings.json");
-		const cfg = readJson(cfgPath);
-		const hooks = cfg.hooks;
-		const sessionStart = hooks?.sessionStart;
-		if (Array.isArray(sessionStart) && containsMembankInject(sessionStart)) return { status: "already-configured" };
-		const existingSessionStart = Array.isArray(sessionStart) ? sessionStart : [];
-		writeJsonAtomic(cfgPath, {
-			version: cfg.version ?? 1,
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				sessionStart: [...existingSessionStart, {
-					type: "command",
-					bash: "npx @membank/cli inject --harness copilot-cli",
-					timeoutSec: 30
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	codex: { write(resolver) {
-		const cfgPath = join(resolver.home(), ".codex", "hooks.json");
-		const cfg = readJson(cfgPath);
-		const hooks = cfg.hooks;
-		const sessionStart = hooks?.SessionStart;
-		if (Array.isArray(sessionStart) && containsMembankInject(sessionStart.flatMap((g) => Array.isArray(g.hooks) ? g.hooks : []))) return { status: "already-configured" };
-		const existingSessionStart = Array.isArray(sessionStart) ? sessionStart : [];
-		writeJsonAtomic(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				SessionStart: [...existingSessionStart, {
-					matcher: "",
-					hooks: [{
-						type: "command",
-						command: "npx @membank/cli inject --harness codex",
-						timeout: 30
-					}]
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	opencode: { write(resolver) {
-		const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
-		if (existsSync(pluginPath)) {
-			if (readFileSync(pluginPath, "utf8").includes("@membank/cli inject")) return { status: "already-configured" };
-		}
-		mkdirSync(dirname(pluginPath), { recursive: true });
-		writeFileSync(pluginPath, [
-			"export default {",
-			"  hooks: {",
-			"    \"session.start\": async ({ $ }) => {",
-			"      return await $`npx @membank/cli inject`.text();",
-			"    },",
-			"  },",
-			"};",
-			""
-		].join("\n"), "utf8");
-		return { status: "written" };
-	} }
-};
-var InjectionHookWriter = class {
-	#resolver;
-	constructor(resolver = defaultPathResolver) {
-		this.#resolver = resolver;
-	}
-	write(harness) {
-		const writer = writers[harness];
-		if (!writer) return { status: "not-supported" };
-		return writer.write(this.#resolver);
-	}
-};
-//#endregion
 //#region src/setup/model-downloader.ts
 const MODEL_NAME = "Xenova/bge-small-en-v1.5";
 var ModelDownloadError = class extends Error {
@@ -778,6 +954,7 @@ var SetupOrchestrator = class {
 				detectedHarnesses: [],
 				configuredHarnesses: [],
 				injectionHooksConfigured: [],
+				stopHooksConfigured: [],
 				modelDownloaded: false
 			}));
 			return [];
@@ -791,7 +968,10 @@ 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`);
+				if (this.#hookWriter) {
+					out(`  ⚠ ${h.name}: would write injection hook config`);
+					out(`  ⚠ ${h.name}: would write stop hook config`);
+				}
 			}
 			out("");
 			out("  ⚠ Model download: skipped (dry-run)");
@@ -858,18 +1038,11 @@ var SetupOrchestrator = class {
 		}
 		out("");
 		const injectionHooksConfigured = [];
+		const stopHooksConfigured = [];
 		if (this.#hookWriter) {
-			for (const h of detected) try {
-				const hookResult = this.#hookWriter.write(h.name);
-				if (hookResult.status === "not-supported") continue;
-				if (hookResult.status === "written") {
-					out(`  ✓ ${h.name}: injection hook written`);
-					injectionHooksConfigured.push(h.name);
-				} else out(`  ⚠ ${h.name}: injection hook already configured`);
-			} catch (err) {
-				const msg = err instanceof Error ? err.message : String(err);
-				out(`  ✗ ${h.name} injection hook: ${msg}`);
-			}
+			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;
@@ -883,6 +1056,7 @@ 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));
@@ -892,6 +1066,31 @@ var SetupOrchestrator = class {
 		}
 		return results;
 	}
+	async #runHookLoop(detected, label, write, yes, out) {
+		const configured = [];
+		for (const h of detected) try {
+			const result = write(h.name);
+			if (result.status === "not-supported") continue;
+			if (result.status === "written") {
+				out(`  ✓ ${h.name}: ${label} written`);
+				configured.push(h.name);
+			} else {
+				out(`  ⚠ ${h.name}: ${label} already configured`);
+				out(`    Current: ${result.existing}`);
+				out(`    New:     ${result.replacement}`);
+				if (yes || await this.#prompter(`  Replace ${label} for ${h.name}?`)) {
+					if (write(h.name, true).status === "written") {
+						out(`  ✓ ${h.name}: ${label} replaced`);
+						configured.push(h.name);
+					}
+				}
+			}
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			out(`  ✗ ${h.name} ${label}: ${msg}`);
+		}
+		return configured;
+	}
 	async #runModelDownload(downloader, out) {
 		out("Downloading embedding model (bge-small-en-v1.5, ~33 MB)...");
 		downloader.on?.("progress", (p) => {
@@ -1030,6 +1229,9 @@ 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;

package/package.json

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