@membank/cli 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import { cancel, confirm, intro, isCancel, multiselect, note, outro } from "@clack/prompts";
-import { DatabaseManager, EmbeddingService, MIGRATIONS, MemoryRepository, MemoryTypeSchema, MemoryTypeSchema as MemoryTypeSchema$1, ProjectRepository, QueryEngine, SessionContextBuilder, TagsJsonSchema as TagsRowSchema, resolveProject, runScopeToProjectsMigration } from "@membank/core";
+import { DatabaseManager, EmbeddingService, MIGRATIONS, MemoryRepository, MemoryTypeSchema, MemoryTypeSchema as MemoryTypeSchema$1, PIN_BUDGET_THRESHOLD, ProjectRepository, QueryEngine, SessionContextBuilder, SynthesisRepository, TagsJsonSchema as TagsRowSchema, resolveProject, runScopeToProjectsMigration } from "@membank/core";
 import { startServer } from "@membank/mcp";
 import chalk from "chalk";
 import { Command } from "commander";
 import ora from "ora";
 import { z } from "zod";
-import { startDashboard } from "@membank/dashboard";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
 import { dirname, join } from "node:path";
+import { startDashboard } from "@membank/dashboard";
 import Table from "cli-table3";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { homedir, tmpdir } from "node:os";
 import { EventEmitter } from "node:events";
 import { pipeline } from "@huggingface/transformers";
 import { createInterface } from "node:readline";
@@ -77,6 +77,80 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 	}
 }
 //#endregion
+//#region src/config/manager.ts
+function defaultConfigPath() {
+	return join(homedir(), ".membank", "config.json");
+}
+function readConfigFile(path) {
+	if (!existsSync(path)) return {};
+	try {
+		const raw = readFileSync(path, "utf-8");
+		return JSON.parse(raw);
+	} catch {
+		return {};
+	}
+}
+const ConfigManager = {
+	getConfigPath() {
+		return defaultConfigPath();
+	},
+	load() {
+		return readConfigFile(ConfigManager.getConfigPath());
+	},
+	get(key) {
+		const config = ConfigManager.load();
+		return key.split(".").reduce((obj, part) => {
+			if (obj !== null && typeof obj === "object" && part in obj) return obj[part];
+		}, config);
+	},
+	set(key, value) {
+		const config = ConfigManager.load();
+		const parts = key.split(".");
+		let cursor = config;
+		for (let i = 0; i < parts.length - 1; i++) {
+			const part = parts[i];
+			if (!(part in cursor) || typeof cursor[part] !== "object" || cursor[part] === null) cursor[part] = {};
+			cursor = cursor[part];
+		}
+		const lastPart = parts[parts.length - 1];
+		cursor[lastPart] = value;
+		ConfigManager.write(config);
+	},
+	write(config) {
+		writeFileSync(ConfigManager.getConfigPath(), JSON.stringify(config, null, 2), "utf-8");
+	}
+};
+//#endregion
+//#region src/commands/config.ts
+function parseValue(raw) {
+	if (raw === "true") return true;
+	if (raw === "false") return false;
+	const n = Number(raw);
+	if (!Number.isNaN(n) && raw.trim() !== "") return n;
+	return raw;
+}
+function configGetCommand(key, formatter) {
+	const value = ConfigManager.get(key);
+	if (formatter.isJson) process.stdout.write(`${JSON.stringify({
+		key,
+		value
+	})}\n`);
+	else process.stdout.write(`${JSON.stringify(value)}\n`);
+}
+function configSetCommand(key, rawValue, formatter) {
+	const value = parseValue(rawValue);
+	ConfigManager.set(key, value);
+	if (formatter.isJson) process.stdout.write(`${JSON.stringify({
+		key,
+		value
+	})}\n`);
+	else process.stdout.write(`Set ${key} = ${JSON.stringify(value)}\n`);
+}
+function configShowCommand(formatter) {
+	const config = ConfigManager.load();
+	process.stdout.write(`${JSON.stringify(config, null, formatter.isJson ? 0 : 2)}\n`);
+}
+//#endregion
 //#region src/commands/dashboard.ts
 async function dashboardCommand(opts) {
 	await startDashboard({ port: opts.port !== void 0 ? PortSchema.parse(opts.port) : void 0 });
@@ -171,10 +245,13 @@ function formatContext(ctx) {
 	const parts = [];
 	const statParts = Object.entries(ctx.stats).filter(([, count]) => count > 0).map(([type, count]) => `${count} ${type}${count !== 1 ? "s" : ""}`);
 	if (statParts.length > 0) parts.push(`<memory-stats>\n${statParts.join(", ")}\n</memory-stats>`);
-	const allPinned = [...ctx.pinnedGlobal, ...ctx.pinnedProject];
-	if (allPinned.length > 0) {
-		const memLines = allPinned.map((m) => `  <memory type="${m.type}">${xmlEscape(m.content)}</memory>`);
-		parts.push(`<pinned-memories>\n${memLines.join("\n")}\n</pinned-memories>`);
+	if (ctx.synthesis !== void 0 && ctx.synthesis.length > 0) parts.push(`<synthesis>\n${ctx.synthesis}\n</synthesis>`);
+	else {
+		const allPinned = [...ctx.pinnedGlobal, ...ctx.pinnedProject];
+		if (allPinned.length > 0) {
+			const memLines = allPinned.map((m) => `  <memory type="${m.type}">${xmlEscape(m.content)}</memory>`);
+			parts.push(`<pinned-memories>\n${memLines.join("\n")}\n</pinned-memories>`);
+		}
 	}
 	parts.push(`<memory-guidance>\n${MEMORY_GUIDANCE}\n</memory-guidance>`);
 	return parts.join("\n");
@@ -193,11 +270,19 @@ function outputAdditionalContext(text, harness, eventName) {
 	}
 	process.stdout.write(`${text}\n`);
 }
+function pickBestSynthesis(globalSynthesis, projectSynthesis) {
+	return projectSynthesis ?? globalSynthesis;
+}
 async function buildText() {
 	const resolved = await resolveProject();
 	const db = DatabaseManager.open();
 	try {
-		return formatContext(new SessionContextBuilder(db).getSessionContext(resolved.hash));
+		const builder = new SessionContextBuilder(db);
+		const synthRepo = new SynthesisRepository(db);
+		const globalRow = synthRepo.getSynthesis("global");
+		const projectRow = synthRepo.getSynthesis(resolved.hash);
+		const synthesis = pickBestSynthesis(globalRow?.inFlightSince === null ? globalRow.content : void 0, projectRow?.inFlightSince === null ? projectRow.content : void 0);
+		return formatContext(builder.getSessionContext(resolved.hash, synthesis));
 	} finally {
 		db.close();
 	}
@@ -222,6 +307,10 @@ async function injectCommand(opts) {
 		await handleEvent(harness, "UserPromptSubmit");
 		return;
 	}
+	if (opts.event === "session-stop" || opts.event === "stop") {
+		await handleEvent(harness, "Stop");
+		return;
+	}
 	process.exit(0);
 }
 //#endregion
@@ -341,6 +430,69 @@ async function statsCommand(formatter) {
 	}
 }
 //#endregion
+//#region src/commands/synthesize.ts
+function hasSynthesesTable(db) {
+	return db.db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='syntheses'").get() !== void 0;
+}
+function synthesizeShowCommand(opts, formatter) {
+	const db = DatabaseManager.open();
+	try {
+		if (!hasSynthesesTable(db)) {
+			if (formatter.isJson) process.stdout.write(`${JSON.stringify(null)}\n`);
+			else process.stdout.write("No synthesis data available.\n");
+			return;
+		}
+		const scope = opts.scope ?? "global";
+		const row = db.db.prepare("SELECT * FROM syntheses WHERE scope = ? ORDER BY synthesized_at DESC LIMIT 1").get(scope);
+		if (row === void 0) {
+			if (formatter.isJson) process.stdout.write(`${JSON.stringify(null)}\n`);
+			else process.stdout.write(`No synthesis found for scope: ${scope}\n`);
+			return;
+		}
+		if (formatter.isJson) process.stdout.write(`${JSON.stringify(row)}\n`);
+		else {
+			process.stdout.write(`\nScope: ${row.scope}\n`);
+			if (row.synthesized_at !== null) process.stdout.write(`Synthesized: ${new Date(row.synthesized_at).toLocaleString()}\n`);
+			if (row.expires_at !== null) process.stdout.write(`Expires: ${new Date(row.expires_at).toLocaleString()}\n`);
+			if (row.in_flight_since !== null) process.stdout.write(`In-flight since: ${new Date(row.in_flight_since).toLocaleString()}\n`);
+			process.stdout.write(`\n${row.content}\n\n`);
+		}
+	} finally {
+		db.close();
+	}
+}
+function synthesizeStatusCommand(formatter) {
+	const db = DatabaseManager.open();
+	try {
+		if (!hasSynthesesTable(db)) {
+			if (formatter.isJson) process.stdout.write(`${JSON.stringify([])}\n`);
+			else process.stdout.write("No synthesis data available.\n");
+			return;
+		}
+		const rows = db.db.prepare("SELECT * FROM syntheses ORDER BY scope").all();
+		if (formatter.isJson) {
+			process.stdout.write(`${JSON.stringify(rows)}\n`);
+			return;
+		}
+		if (rows.length === 0) {
+			process.stdout.write("No syntheses found.\n");
+			return;
+		}
+		process.stdout.write("\n");
+		for (const row of rows) {
+			const inFlight = row.in_flight_since !== null ? " [in-flight]" : "";
+			const synthesized = row.synthesized_at !== null ? new Date(row.synthesized_at).toLocaleString() : "(never)";
+			const expires = row.expires_at !== null ? new Date(row.expires_at).toLocaleString() : "(none)";
+			process.stdout.write(`  ${row.scope}${inFlight}\n`);
+			process.stdout.write(`    synthesized_at: ${synthesized}\n`);
+			process.stdout.write(`    expires_at:     ${expires}\n`);
+		}
+		process.stdout.write("\n");
+	} finally {
+		db.close();
+	}
+}
+//#endregion
 //#region src/commands/unpin.ts
 function unpinCommand(id, db) {
 	const ownDb = db === void 0;
@@ -364,6 +516,10 @@ const TYPE_COLORS = {
 function colorType(type) {
 	return TYPE_COLORS[type](type);
 }
+function statsRow(label, value, warn) {
+	if (warn) process.stdout.write(`  ${chalk.yellow("⚠")} ${label.padEnd(12)}  ${value}\n`);
+	else process.stdout.write(`  ${"  ".concat(label).padEnd(14)}  ${value}\n`);
+}
 function truncate(str, max) {
 	return str.length > max ? `${str.slice(0, max - 1)}…` : str;
 }
@@ -441,8 +597,9 @@ var Formatter = class Formatter {
 		for (const type of types) process.stdout.write(`  ${TYPE_COLORS[type](type.padEnd(14))}  ${stats.byType[type]}\n`);
 		process.stdout.write(`\n  ${chalk.dim("─".repeat(24))}\n`);
 		process.stdout.write(`  ${"total".padEnd(14)}  ${stats.total}\n`);
-		if (stats.needsReview > 0) process.stdout.write(`  ${chalk.yellow("⚠")} ${"needs_review".padEnd(12)}  ${stats.needsReview}\n\n`);
-		else process.stdout.write(`  ${"  needs_review".padEnd(14)}  ${stats.needsReview}\n\n`);
+		statsRow("needs_review", String(stats.needsReview), stats.needsReview > 0);
+		statsRow("pin_budget", `${stats.pinBudgetChars} / ${PIN_BUDGET_THRESHOLD} chars`, stats.pinBudgetChars > PIN_BUDGET_THRESHOLD);
+		process.stdout.write("\n");
 	}
 	outputQueryResults(results) {
 		if (this.#isJson) {
@@ -512,6 +669,7 @@ var Formatter = class Formatter {
 //#endregion
 //#region src/prompt-helper.ts
 var PromptHelper = class {
+	autoConfirm;
 	constructor(autoConfirm) {
 		this.autoConfirm = autoConfirm;
 	}
@@ -811,18 +969,27 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const sessionStartInner = (Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).flatMap(getHooksArray);
 			const userPromptSubmitInner = (Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []).flatMap(getHooksArray);
+			const stopInner = (Array.isArray(hooks.Stop) ? hooks.Stop : []).flatMap(getHooksArray);
 			return {
 				status: "ready",
 				configPath: cfgPath,
-				hooks: [{
-					event: "SessionStart",
-					command: "npx -y @membank/cli inject --harness claude-code",
-					existingCommand: extractInjectCommand(sessionStartInner) || null
-				}, {
-					event: "UserPromptSubmit",
-					command: "npx -y @membank/cli inject --harness claude-code --event user-prompt-submit",
-					existingCommand: extractInjectCommand(userPromptSubmitInner) || null
-				}]
+				hooks: [
+					{
+						event: "SessionStart",
+						command: "npx -y @membank/cli inject --harness claude-code",
+						existingCommand: extractInjectCommand(sessionStartInner) || null
+					},
+					{
+						event: "UserPromptSubmit",
+						command: "npx -y @membank/cli inject --harness claude-code --event user-prompt-submit",
+						existingCommand: extractInjectCommand(userPromptSubmitInner) || null
+					},
+					{
+						event: "Stop",
+						command: "npx -y @membank/cli inject --harness claude-code --event session-stop",
+						existingCommand: extractInjectCommand(stopInner) || null
+					}
+				]
 			};
 		},
 		write(resolver, events) {
@@ -845,6 +1012,13 @@ const writers = {
 					command: "npx -y @membank/cli inject --harness claude-code --event user-prompt-submit"
 				}]
 			}];
+			if (events.includes("Stop")) newHooks.Stop = [...filterOutMembank(Array.isArray(hooks.Stop) ? hooks.Stop : []), {
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command: "npx -y @membank/cli inject --harness claude-code --event session-stop"
+				}]
+			}];
 			writeJsonAtomic(cfgPath, {
 				...cfg,
 				hooks: newHooks
@@ -859,18 +1033,27 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const sessionStart = Array.isArray(hooks.sessionStart) ? hooks.sessionStart : [];
 			const userPromptSubmitted = Array.isArray(hooks.userPromptSubmitted) ? hooks.userPromptSubmitted : [];
+			const sessionEnd = Array.isArray(hooks.sessionEnd) ? hooks.sessionEnd : [];
 			return {
 				status: "ready",
 				configPath: cfgPath,
-				hooks: [{
-					event: "sessionStart",
-					command: "npx -y @membank/cli inject --harness copilot-cli",
-					existingCommand: extractInjectCommand(sessionStart) || null
-				}, {
-					event: "userPromptSubmitted",
-					command: "npx -y @membank/cli inject --harness copilot-cli --event user-prompt-submit",
-					existingCommand: extractInjectCommand(userPromptSubmitted) || null
-				}]
+				hooks: [
+					{
+						event: "sessionStart",
+						command: "npx -y @membank/cli inject --harness copilot-cli",
+						existingCommand: extractInjectCommand(sessionStart) || null
+					},
+					{
+						event: "userPromptSubmitted",
+						command: "npx -y @membank/cli inject --harness copilot-cli --event user-prompt-submit",
+						existingCommand: extractInjectCommand(userPromptSubmitted) || null
+					},
+					{
+						event: "sessionEnd",
+						command: "npx -y @membank/cli inject --harness copilot-cli --event session-stop",
+						existingCommand: extractInjectCommand(sessionEnd) || null
+					}
+				]
 			};
 		},
 		write(resolver, events) {
@@ -889,6 +1072,11 @@ const writers = {
 				bash: "npx -y @membank/cli inject --harness copilot-cli --event user-prompt-submit",
 				timeoutSec: 30
 			}];
+			if (events.includes("sessionEnd")) newHooks.sessionEnd = [...filterOutMembankFlat(Array.isArray(hooks.sessionEnd) ? hooks.sessionEnd : []), {
+				type: "command",
+				bash: "npx -y @membank/cli inject --harness copilot-cli --event session-stop",
+				timeoutSec: 30
+			}];
 			writeJsonAtomic(cfgPath, {
 				version: OptionalNumberSchema.parse(cfg.version) ?? 1,
 				...cfg,
@@ -904,18 +1092,27 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const sessionStartInner = (Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).flatMap(getHooksArray);
 			const userPromptSubmitInner = (Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []).flatMap(getHooksArray);
+			const stopInner = (Array.isArray(hooks.Stop) ? hooks.Stop : []).flatMap(getHooksArray);
 			return {
 				status: "ready",
 				configPath: cfgPath,
-				hooks: [{
-					event: "SessionStart",
-					command: "npx -y @membank/cli inject --harness codex",
-					existingCommand: extractInjectCommand(sessionStartInner) || null
-				}, {
-					event: "UserPromptSubmit",
-					command: "npx -y @membank/cli inject --harness codex --event user-prompt-submit",
-					existingCommand: extractInjectCommand(userPromptSubmitInner) || null
-				}]
+				hooks: [
+					{
+						event: "SessionStart",
+						command: "npx -y @membank/cli inject --harness codex",
+						existingCommand: extractInjectCommand(sessionStartInner) || null
+					},
+					{
+						event: "UserPromptSubmit",
+						command: "npx -y @membank/cli inject --harness codex --event user-prompt-submit",
+						existingCommand: extractInjectCommand(userPromptSubmitInner) || null
+					},
+					{
+						event: "Stop",
+						command: "npx -y @membank/cli inject --harness codex --event session-stop",
+						existingCommand: extractInjectCommand(stopInner) || null
+					}
+				]
 			};
 		},
 		write(resolver, events) {
@@ -940,6 +1137,14 @@ const writers = {
 					timeout: 30
 				}]
 			}];
+			if (events.includes("Stop")) newHooks.Stop = [...filterOutMembank(Array.isArray(hooks.Stop) ? hooks.Stop : []), {
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command: "npx -y @membank/cli inject --harness codex --event session-stop",
+					timeout: 30
+				}]
+			}];
 			writeJsonAtomic(cfgPath, {
 				...cfg,
 				hooks: newHooks
@@ -1131,6 +1336,7 @@ var SetupOrchestrator = class {
 	#modelDownloader;
 	#out;
 	#progressWrite;
+	#synthesisOptIn;
 	constructor(deps) {
 		this.#detector = deps.detector ?? (() => detectHarnesses());
 		this.#writer = deps.writer;
@@ -1139,6 +1345,7 @@ var SetupOrchestrator = class {
 		this.#harnessSelector = deps.harnessSelector;
 		this.#modelDownloader = deps.modelDownloader;
 		this.#out = deps.out ?? ((msg) => process.stdout.write(`${msg}\n`));
+		this.#synthesisOptIn = deps.synthesisOptIn ?? false;
 		this.#progressWrite = deps.progressWrite ?? ((text) => process.stdout.write(text));
 	}
 	async run(opts = {}) {
@@ -1275,6 +1482,12 @@ var SetupOrchestrator = class {
 			out(`Step ${this.#hookWriter !== void 0 ? 3 : 2}/${totalSteps}  Embedding model`);
 			modelDownloaded = !(await this.#runModelDownload(this.#modelDownloader, out)).skipped;
 		} else out("Model download step: see DRA-52");
+		if (this.#synthesisOptIn && !yes && !json) {
+			if (await this.#prompter("Enable memory synthesis? (experimental — summarizes memories at session start using Claude Haiku, requires ANTHROPIC_API_KEY)")) {
+				ConfigManager.set("synthesis.enabled", true);
+				out("  ✓ Memory synthesis enabled.");
+			}
+		}
 		const written = results.filter((r) => r.status === "written").length;
 		const skipped = results.filter((r) => r.status === "already-configured").length;
 		const errors = results.filter((r) => r.status === "error").length;
@@ -1511,7 +1724,8 @@ program.command("setup").description("detect installed harnesses and write MCP c
 		prompter: (question) => promptHelper.confirm(question),
 		harnessSelector,
 		modelDownloader: new ModelDownloader(),
-		out: formatter.isJson ? void 0 : decoratedOut
+		out: formatter.isJson ? void 0 : decoratedOut,
+		synthesisOptIn: true
 	});
 	try {
 		const results = await orchestrator.run({
@@ -1563,6 +1777,40 @@ program.command("dashboard").description("open the memory management dashboard i
 		process.exit(2);
 	}
 });
+const configCmd = program.command("config").description("manage membank configuration");
+configCmd.command("get <key>").description("print a config value as JSON").action((key) => {
+	const globalOpts = program.opts();
+	configGetCommand(key, Formatter.create(globalOpts.json === true));
+});
+configCmd.command("set <key> <value>").description("set a config value and persist").action((key, value) => {
+	const globalOpts = program.opts();
+	configSetCommand(key, value, Formatter.create(globalOpts.json === true));
+});
+configCmd.command("show").description("print the entire config as formatted JSON").action(() => {
+	const globalOpts = program.opts();
+	configShowCommand(Formatter.create(globalOpts.json === true));
+});
+const synthesizeCmd = program.command("synthesize").description("view synthesis state");
+synthesizeCmd.command("show").description("display current synthesis for a scope").option("--scope <scope>", "scope to show (default: global)").action((cmdOptions) => {
+	const globalOpts = program.opts();
+	const formatter = Formatter.create(globalOpts.json === true);
+	try {
+		synthesizeShowCommand(cmdOptions, formatter);
+	} catch (err) {
+		formatter.error(err instanceof Error ? err.message : String(err));
+		process.exit(2);
+	}
+});
+synthesizeCmd.command("status").description("show all scopes with synthesis status").action(() => {
+	const globalOpts = program.opts();
+	const formatter = Formatter.create(globalOpts.json === true);
+	try {
+		synthesizeStatusCommand(formatter);
+	} catch (err) {
+		formatter.error(err instanceof Error ? err.message : String(err));
+		process.exit(2);
+	}
+});
 program.on("command:*", () => {
 	program.outputHelp();
 	process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,9 +21,9 @@
     "commander": "^14.0.3",
     "ora": "^9.4.0",
     "zod": "^4.4.3",
-    "@membank/dashboard": "0.5.0",
-    "@membank/core": "0.8.0",
-    "@membank/mcp": "0.10.0"
+    "@membank/core": "0.9.0",
+    "@membank/dashboard": "0.5.1",
+    "@membank/mcp": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",