@membank/cli 0.0.3 → 0.1.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DatabaseManager, EmbeddingService, MemoryRepository, QueryEngine } from "@membank/core";
+import { DatabaseManager, EmbeddingService, MEMORY_TYPE_VALUES, MemoryRepository, QueryEngine, SessionContextBuilder, resolveScope } from "@membank/core";
 import { startServer } from "@membank/mcp";
 import { Command } from "commander";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
@@ -72,13 +72,7 @@ function exportCommand(db, formatter, opts) {
 }
 //#endregion
 //#region src/commands/import.ts
-const MEMORY_TYPES = new Set([
-	"correction",
-	"preference",
-	"decision",
-	"learning",
-	"fact"
-]);
+const MEMORY_TYPES = new Set(MEMORY_TYPE_VALUES);
 function isValidRecord(r) {
 	if (typeof r !== "object" || r === null) return false;
 	const rec = r;
@@ -133,6 +127,44 @@ async function importCommand(filePath, db, formatter, prompt) {
 	else process.stdout.write(`Imported ${count} memories.\n`);
 }
 //#endregion
+//#region src/commands/inject.ts
+const MEMORY_GUIDANCE = "[Memory Guidance]: query_memory before answering on topics where past preferences, corrections, or decisions may apply; save_memory when user corrects you, states a preference, makes a decision, or shares something worth retaining across sessions; update_memory to refine an existing memory (query first to find it) or to set pinned=true/false; delete_memory when a memory is wrong or no longer relevant; pin high-value memories that should always appear at session start";
+function formatContext(ctx) {
+	const lines = [];
+	const statParts = Object.entries(ctx.stats).filter(([, count]) => count > 0).map(([type, count]) => `${count} ${type}${count !== 1 ? "s" : ""}`);
+	if (statParts.length > 0) lines.push(`[Memory Stats]: ${statParts.join(", ")}`);
+	else lines.push("[Memory Stats]: no memories saved yet");
+	const formatMemory = (m) => `"${m.content}" (${m.type})`;
+	for (const m of ctx.pinnedGlobal) lines.push(`[Pinned Global]: ${formatMemory(m)}`);
+	for (const m of ctx.pinnedProject) lines.push(`[Pinned Project]: ${formatMemory(m)}`);
+	lines.push(MEMORY_GUIDANCE);
+	return lines.join("\n");
+}
+async function injectCommand(opts) {
+	const projectScope = opts.scope ?? await resolveScope();
+	const db = DatabaseManager.open();
+	let text;
+	try {
+		text = formatContext(new SessionContextBuilder(db).getSessionContext(projectScope));
+	} finally {
+		db.close();
+	}
+	if (!text) process.exit(0);
+	const harness = opts.harness;
+	if (harness === "claude-code") {
+		process.stdout.write(JSON.stringify({ hookSpecificOutput: {
+			hookEventName: "SessionStart",
+			additionalContext: text
+		} }));
+		return;
+	}
+	if (harness === "copilot-cli") {
+		process.stdout.write(JSON.stringify({ additionalContext: text }));
+		return;
+	}
+	process.stdout.write(`${text}\n`);
+}
+//#endregion
 //#region src/commands/list.ts
 async function listCommand(options, formatter) {
 	const db = DatabaseManager.open();
@@ -216,11 +248,8 @@ var Formatter = class Formatter {
 	constructor(isJson) {
 		this.#isJson = isJson;
 	}
-	static create() {
-		return new Formatter(!process.stdout.isTTY);
-	}
-	withJson(isJson) {
-		return new Formatter(isJson);
+	static create(forceJson = false) {
+		return new Formatter(forceJson || !process.stdout.isTTY);
 	}
 	get isJson() {
 		return this.#isJson;
@@ -230,13 +259,7 @@ var Formatter = class Formatter {
 			process.stdout.write(`${JSON.stringify(memory)}\n`);
 			return;
 		}
-		const tags = memory.tags.length > 0 ? memory.tags.join(", ") : "(none)";
-		process.stdout.write(`\n[${memory.type}] ${memory.id}\n`);
-		process.stdout.write(`  Content : ${memory.content}\n`);
-		process.stdout.write(`  Tags    : ${tags}\n`);
-		process.stdout.write(`  Scope   : ${memory.scope}\n`);
-		process.stdout.write(`  Pinned  : ${memory.pinned}\n`);
-		process.stdout.write("\n");
+		this.#writeMemoryBlock(memory, `  Pinned  : ${memory.pinned}\n`);
 	}
 	outputMemories(memories) {
 		if (this.#isJson) {
@@ -247,13 +270,7 @@ var Formatter = class Formatter {
 			process.stdout.write("No memories found.\n");
 			return;
 		}
-		for (const memory of memories) {
-			const tags = memory.tags.length > 0 ? memory.tags.join(", ") : "(none)";
-			process.stdout.write(`\n[${memory.type}] ${memory.id}\n`);
-			process.stdout.write(`  Content : ${memory.content}\n`);
-			process.stdout.write(`  Tags    : ${tags}\n`);
-			process.stdout.write(`  Scope   : ${memory.scope}\n`);
-		}
+		for (const memory of memories) this.#writeMemoryBlock(memory);
 		process.stdout.write("\n");
 	}
 	outputStats(stats) {
@@ -280,20 +297,22 @@ var Formatter = class Formatter {
 			process.stdout.write("No memories found.\n");
 			return;
 		}
-		for (const result of results) {
-			const tags = result.tags.length > 0 ? result.tags.join(", ") : "(none)";
-			process.stdout.write(`\n[${result.type}] ${result.id}\n`);
-			process.stdout.write(`  Content : ${result.content}\n`);
-			process.stdout.write(`  Tags    : ${tags}\n`);
-			process.stdout.write(`  Scope   : ${result.scope}\n`);
-			process.stdout.write(`  Score   : ${result.score.toFixed(4)}\n`);
-		}
+		for (const result of results) this.#writeMemoryBlock(result, `  Score   : ${result.score.toFixed(4)}\n`);
 		process.stdout.write("\n");
 	}
 	error(msg) {
 		if (this.#isJson) process.stderr.write(`${JSON.stringify({ error: msg })}\n`);
 		else process.stderr.write(`Error: ${msg}\n`);
 	}
+	#writeMemoryBlock(memory, extra) {
+		const tags = memory.tags.length > 0 ? memory.tags.join(", ") : "(none)";
+		process.stdout.write(`\n[${memory.type}] ${memory.id}\n`);
+		process.stdout.write(`  Content : ${memory.content}\n`);
+		process.stdout.write(`  Tags    : ${tags}\n`);
+		process.stdout.write(`  Scope   : ${memory.scope}\n`);
+		if (extra !== void 0) process.stdout.write(extra);
+		process.stdout.write("\n");
+	}
 };
 //#endregion
 //#region src/prompt-helper.ts
@@ -352,7 +371,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");
@@ -360,14 +379,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));
@@ -384,9 +403,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", [
@@ -412,37 +431,20 @@ const writers = {
 		if (add.exitCode !== 0) throw new Error(`claude mcp add failed: ${add.stderr || add.stdout}`);
 		return { status: "written" };
 	} },
-	vscode: { async write(resolver, run, { overwrite = false } = {}) {
-		const cfgPath = join(resolver.cwd(), ".vscode", "mcp.json");
-		const cfg = readJson(cfgPath);
-		const configured = hasKey(cfg.servers, "membank");
-		if (configured && !overwrite) return { status: "already-configured" };
-		if (configured) {
-			writeJsonAtomic(cfgPath, {
-				...cfg,
-				servers: {
-					...cfg.servers,
-					membank: {
-						command: "npx",
-						args: ["@membank/cli@latest", "--mcp"]
-					}
+	copilot: { async write(resolver, _run, { overwrite = false } = {}) {
+		const cfgPath = join(resolver.home(), ".copilot", "mcp-config.json");
+		const cfg = readJson$1(cfgPath);
+		if (hasKey(cfg.mcpServers, "membank") && !overwrite) return { status: "already-configured" };
+		writeJsonAtomic$1(cfgPath, {
+			...cfg,
+			mcpServers: {
+				...cfg.mcpServers,
+				membank: {
+					command: "npx",
+					args: ["@membank/cli@latest", "--mcp"]
 				}
-			});
-			return { status: "written" };
-		}
-		const payload = JSON.stringify({
-			name: "membank",
-			command: "npx",
-			args: ["@membank/cli@latest", "--mcp"]
+			}
 		});
-		const result = await run("code", [
-			"--folder-uri",
-			resolver.cwd(),
-			"--add-mcp",
-			payload
-		]);
-		assertCliFound(result, "code");
-		if (result.exitCode !== 0) throw new Error(`code --add-mcp failed: ${result.stderr || result.stdout}`);
 		return { status: "written" };
 	} },
 	codex: { async write(_resolver, run, { overwrite = false } = {}) {
@@ -472,9 +474,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,
@@ -491,21 +493,142 @@ 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 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 {
@@ -571,13 +694,9 @@ var ModelDownloader = class extends EventEmitter {
 };
 //#endregion
 //#region src/setup/harness-detector.ts
-const defaultResolver = {
-	homeDir: homedir,
-	cwd: () => process.cwd()
-};
+const defaultResolver = { homeDir: homedir };
 function harnessConfigs(resolver) {
 	const home = resolver.homeDir();
-	const cwd = resolver.cwd();
 	return [
 		{
 			name: "claude-code",
@@ -585,8 +704,8 @@ function harnessConfigs(resolver) {
 			fallbackPaths: [join(home, ".claude", "settings.json")]
 		},
 		{
-			name: "vscode",
-			configPath: join(cwd, ".vscode", "mcp.json")
+			name: "copilot",
+			configPath: join(home, ".copilot", "mcp-config.json")
 		},
 		{
 			name: "codex",
@@ -628,6 +747,7 @@ function defaultPrompter(question) {
 var SetupOrchestrator = class {
 	#detector;
 	#writer;
+	#hookWriter;
 	#prompter;
 	#modelDownloader;
 	#out;
@@ -635,6 +755,7 @@ var SetupOrchestrator = class {
 	constructor(deps) {
 		this.#detector = deps.detector ?? (() => detectHarnesses());
 		this.#writer = deps.writer;
+		this.#hookWriter = deps.hookWriter;
 		this.#prompter = deps.prompter ?? defaultPrompter;
 		this.#modelDownloader = deps.modelDownloader;
 		this.#out = deps.out ?? ((msg) => process.stdout.write(`${msg}\n`));
@@ -656,6 +777,7 @@ var SetupOrchestrator = class {
 			if (json) this.#out(JSON.stringify({
 				detectedHarnesses: [],
 				configuredHarnesses: [],
+				injectionHooksConfigured: [],
 				modelDownloaded: false
 			}));
 			return [];
@@ -667,7 +789,10 @@ var SetupOrchestrator = class {
 		}
 		if (dryRun) {
 			out("Planned changes (dry-run — no files written):");
-			for (const h of detected) out(`  ⚠ ${h.name}: would write MCP config`);
+			for (const h of detected) {
+				out(`  ⚠ ${h.name}: would write MCP config`);
+				if (this.#hookWriter) out(`  ⚠ ${h.name}: would write injection hook config`);
+			}
 			out("");
 			out("  ⚠ Model download: skipped (dry-run)");
 			return detected.map((h) => ({
@@ -732,6 +857,21 @@ var SetupOrchestrator = class {
 			});
 		}
 		out("");
+		const injectionHooksConfigured = [];
+		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}`);
+			}
+			out("");
+		}
 		let modelDownloaded = false;
 		if (this.#modelDownloader) modelDownloaded = !(await this.#runModelDownload(this.#modelDownloader, out)).skipped;
 		else out("Model download step: see DRA-52");
@@ -742,6 +882,7 @@ var SetupOrchestrator = class {
 			const output = {
 				detectedHarnesses: detected.map((h) => h.name),
 				configuredHarnesses: results.filter((r) => r.status === "written").map((r) => r.harness),
+				injectionHooksConfigured,
 				modelDownloaded
 			};
 			this.#out(JSON.stringify(output));
@@ -782,7 +923,7 @@ const program = new Command();
 program.name("membank").description("LLM memory management system").option("--json", "emit machine-readable JSON only").option("-y, --yes", "skip all confirmation prompts").option("--mcp", "start the MCP stdio server (for harness integration)");
 program.command("query <queryText>").description("search memories by semantic similarity").option("--type <type>", "filter by memory type (correction|preference|decision|learning|fact)").option("--limit <n>", "maximum number of results", "10").action(async (queryText, cmdOptions) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		await queryCommand(queryText, cmdOptions, formatter);
 	} catch (err) {
@@ -792,7 +933,7 @@ program.command("query <queryText>").description("search memories by semantic si
 });
 program.command("list").description("list memories with optional filters").option("--type <type>", "filter by memory type (correction|preference|decision|learning|fact)").option("--pinned", "return only pinned memories").action(async (cmdOptions) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		await listCommand(cmdOptions, formatter);
 	} catch (err) {
@@ -802,7 +943,7 @@ program.command("list").description("list memories with optional filters").optio
 });
 program.command("stats").description("show memory counts by type, total, and needs_review").action(async () => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		await statsCommand(formatter);
 	} catch (err) {
@@ -812,7 +953,7 @@ program.command("stats").description("show memory counts by type, total, and nee
 });
 program.command("delete <id>").description("delete a memory by ID").action(async (id) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	const prompt = new PromptHelper(globalOpts.yes === true || !process.stdout.isTTY);
 	const db = DatabaseManager.open();
 	try {
@@ -826,7 +967,7 @@ program.command("delete <id>").description("delete a memory by ID").action(async
 });
 program.command("add <content>").description("save a new memory").requiredOption("--type <type>", "memory type (correction|preference|decision|learning|fact)").option("--tags <tags>", "comma-separated tags").option("--scope <scope>", "scope (global or project identifier)").action(async (content, cmdOptions) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		await addCommand(content, cmdOptions, formatter);
 	} catch (err) {
@@ -836,7 +977,7 @@ program.command("add <content>").description("save a new memory").requiredOption
 });
 program.command("pin <id>").description("pin a memory by ID").action((id) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		pinCommand(id, formatter);
 	} catch (err) {
@@ -846,7 +987,7 @@ program.command("pin <id>").description("pin a memory by ID").action((id) => {
 });
 program.command("unpin <id>").description("unpin a memory by ID").action((id) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	try {
 		unpinCommand(id, formatter);
 	} catch (err) {
@@ -856,7 +997,7 @@ program.command("unpin <id>").description("unpin a memory by ID").action((id) =>
 });
 program.command("export").description("export all memories to a JSON file").option("--output <path>", "output file path (default: membank-export-<timestamp>.json in cwd)").action((cmdOptions) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	const db = DatabaseManager.open();
 	try {
 		exportCommand(db, formatter, cmdOptions);
@@ -869,7 +1010,7 @@ program.command("export").description("export all memories to a JSON file").opti
 });
 program.command("import <file>").description("import memories from a JSON export file").action(async (file) => {
 	const globalOpts = program.opts();
-	const formatter = Formatter.create().withJson(globalOpts.json === true || !process.stdout.isTTY);
+	const formatter = Formatter.create(globalOpts.json === true);
 	const prompt = new PromptHelper(globalOpts.yes === true || !process.stdout.isTTY);
 	const db = DatabaseManager.open();
 	try {
@@ -881,21 +1022,30 @@ 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) => {
+	try {
+		await injectCommand(cmdOptions);
+	} catch (err) {
+		process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+		process.exit(2);
+	}
+});
 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;
-	const useJson = globalOpts.json === true || !process.stdout.isTTY;
-	const formatter = Formatter.create().withJson(useJson);
+	const formatter = Formatter.create(globalOpts.json === true);
 	if (cmdOptions.harness !== void 0) {
-		if (!SUPPORTED_HARNESSES.includes(cmdOptions.harness)) {
+		if (!SUPPORTED_HARNESSES.some((h) => h === cmdOptions.harness)) {
 			formatter.error(`Unknown harness: "${cmdOptions.harness}". Supported: ${SUPPORTED_HARNESSES.join(", ")}`);
 			process.exit(1);
 		}
 	}
 	const writer = new HarnessConfigWriter();
+	const hookWriter = new InjectionHookWriter();
 	const promptHelper = new PromptHelper(autoYes);
 	const orchestrator = new SetupOrchestrator({
 		writer,
+		hookWriter,
 		prompter: (question) => promptHelper.confirm(question),
 		modelDownloader: new ModelDownloader()
 	});
@@ -904,7 +1054,7 @@ program.command("setup").description("detect installed harnesses and write MCP c
 			yes: autoYes,
 			dryRun: cmdOptions.dryRun,
 			harness: cmdOptions.harness,
-			json: useJson
+			json: formatter.isJson
 		})).some((r) => r.status === "error")) process.exit(1);
 	} catch (err) {
 		formatter.error(err instanceof Error ? err.message : String(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.0.3",
+  "version": "0.1.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.0.3",
-    "@membank/mcp": "0.0.3"
+    "@membank/core": "0.1.0",
+    "@membank/mcp": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",