@membank/cli 0.11.2 → 0.13.0

package/README.md

@@ -35,6 +35,16 @@ Options:
 
 Supported harnesses: `claude-code`, `copilot`, `codex`, `opencode` (see `membank setup` for harness-specific setup instructions)
 
+### `membank setup upgrade`
+
+Migrate existing harness configs from the old `npx @membank/cli --mcp` pattern to the standalone `npx @membank/mcp` binary:
+
+```bash
+membank setup upgrade
+```
+
+Run this once after upgrading to align all configured harnesses with the new standalone MCP package.
+
 ## Commands
 
 ### `membank query <text>`
@@ -167,31 +177,33 @@ membank inject --harness claude-code --event session-stop
 
 Options: `--harness <name>` (claude-code|copilot-cli|codex|opencode), `--event <event>` (session-start|user-prompt-submit|session-stop)
 
-### `membank dashboard`
+### `membank dashboard` (deprecated)
 
-Start the web dashboard for browsing and managing memories.
+The dashboard is now a standalone package. Run it directly:
 
 ```bash
-membank dashboard
+npx @membank/dashboard
 ```
 
-Opens http://localhost:3847 by default. Features: full-text search, filtering by type/scope/pin status, edit memory metadata, view dedup reviews, and storage statistics.
+See [`@membank/dashboard`](../dashboard/README.md) for options.
 
 ## Global flags
 
 ```
 --json     Output machine-readable JSON
 --yes, -y  Skip confirmation prompts
---mcp      Start MCP stdio server (used by harness config)
+--mcp      Start MCP stdio server (deprecated — use npx @membank/mcp)
 ```
 
 ## MCP server mode
 
+The preferred way to run the MCP server is via the standalone package:
+
 ```bash
-membank --mcp
+npx @membank/mcp
 ```
 
-Starts the stdio MCP server. This is what harnesses connect to — `setup` writes this command into harness configs automatically.
+`membank setup` writes this command into harness configs automatically. The legacy `membank --mcp` flag still works but emits a deprecation warning. Run `membank setup upgrade` to migrate existing harness configs.
 
 ## Session hooks
 

package/dist/index.mjs

@@ -1,20 +1,17 @@
 #!/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, PIN_BUDGET_THRESHOLD, ProjectRepository, QueryEngine, SessionContextBuilder, SynthesisRepository, TagsJsonSchema as TagsRowSchema, resolveProject, runScopeToProjectsMigration } from "@membank/core";
-import { runSynthesis, startServer } from "@membank/mcp";
+import { DatabaseManager, EmbeddingService, MIGRATIONS, MODEL_NAME, MemoryTypeSchema, MemoryTypeSchema as MemoryTypeSchema$1, ModelDownloader, PIN_BUDGET_THRESHOLD, QueryEngine, SessionContextBuilder, createMemoryRepository, createProjectRepository, createSynthesisRepository, resolveProject, runScopeToProjectsMigration, saveMemory } from "@membank/core";
+import { runExtraction, runSynthesis, startServer } from "@membank/mcp";
 import chalk from "chalk";
 import { Command } from "commander";
 import ora from "ora";
 import { z } from "zod";
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, 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 { EventEmitter } from "node:events";
-import { pipeline } from "@huggingface/transformers";
 import { createInterface } from "node:readline";
 //#region src/schemas.ts
 const SETUP_HARNESS_VALUES = [
@@ -32,7 +29,7 @@ const InjectionHarnessSchema = z.enum([
 ]);
 const MigrateModeSchema = z.enum(["list", "run"]);
 const LimitSchema = z.coerce.number().int().positive();
-const PortSchema = z.coerce.number().int().min(1).max(65535);
+z.coerce.number().int().min(1).max(65535);
 const OptionalNumberSchema = z.number().optional().catch(void 0);
 const MutableJsonObjectSchema = z.record(z.string(), z.unknown());
 const MaybeJsonObjectSchema = z.record(z.string(), z.unknown()).optional().catch(void 0);
@@ -60,15 +57,19 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 	const ownDb = db === void 0;
 	const resolvedDb = db ?? DatabaseManager.open();
 	try {
-		const repo = new MemoryRepository(resolvedDb, embeddingService ?? new EmbeddingService(), new ProjectRepository(resolvedDb));
+		const embedder = embeddingService ?? new EmbeddingService();
+		const repo = createMemoryRepository(resolvedDb, createProjectRepository(resolvedDb));
 		const tags = options.tags !== void 0 ? options.tags.split(",").map((t) => t.trim()) : [];
 		const projectScope = options.global ? void 0 : await resolveProject();
 		const spinner = formatter.isJson ? null : ora("Saving memory…").start();
-		const memory = await repo.save({
+		const memory = await saveMemory({
 			content,
 			type: MemoryTypeSchema$1.parse(options.type),
 			tags,
 			projectScope
+		}, {
+			repo,
+			embedder
 		});
 		spinner?.succeed("Memory saved");
 		formatter.outputMemory(memory);
@@ -151,35 +152,31 @@ function configShowCommand(formatter) {
 	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 });
-}
-//#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) {
+	const repo = createMemoryRepository(db, createProjectRepository(db));
+	if (repo.findById(id) === void 0) {
 		formatter.error(`Memory not found: ${id}`);
 		process.exit(1);
 	}
 	if (!await prompt.confirm(`Delete memory ${id}?`)) return;
-	await new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).delete(id);
+	repo.delete(id);
 	process.stdout.write(`${chalk.green("✓")} Deleted memory: ${chalk.dim(id)}\n`);
 }
 //#endregion
 //#region src/commands/export.ts
 function exportCommand(db, formatter, opts) {
-	const memories = db.db.prepare(`SELECT m.*, e.embedding FROM memories m LEFT JOIN embeddings e ON e.rowid = m.rowid ORDER BY m.created_at DESC`).all().map((row) => ({
-		id: row.id,
-		content: row.content,
-		type: row.type,
-		tags: TagsRowSchema.parse(JSON.parse(row.tags)),
-		sourceHarness: row.source,
-		accessCount: row.access_count,
-		pinned: row.pinned !== 0,
-		createdAt: row.created_at,
-		updatedAt: row.updated_at,
-		embedding: row.embedding !== null ? Buffer.from(row.embedding).toString("base64") : null
+	const memories = createMemoryRepository(db, createProjectRepository(db)).exportAll().map((rec) => ({
+		id: rec.id,
+		content: rec.content,
+		type: rec.type,
+		tags: rec.tags,
+		sourceHarness: rec.sourceHarness,
+		accessCount: rec.accessCount,
+		pinned: rec.pinned,
+		createdAt: rec.createdAt,
+		updatedAt: rec.updatedAt,
+		embedding: rec.embedding !== null ? Buffer.from(rec.embedding.buffer, rec.embedding.byteOffset, rec.embedding.byteLength).toString("base64") : null
 	}));
 	const data = {
 		version: 1,
@@ -195,6 +192,95 @@ function exportCommand(db, formatter, opts) {
 	else process.stdout.write(`Exported ${memories.length} memories to ${outputPath}\n`);
 }
 //#endregion
+//#region src/commands/extract.ts
+const ExtractionHarnessSchema = z.enum(["claude-code"]);
+const ClaudeCodeStopInputSchema = z.object({
+	session_id: z.string(),
+	transcript_path: z.string(),
+	cwd: z.string().optional(),
+	hook_event_name: z.string().optional(),
+	stop_hook_active: z.boolean().optional()
+});
+function parseHookPayload(harness, raw) {
+	let parsedJson;
+	try {
+		parsedJson = JSON.parse(raw);
+	} catch {
+		return {
+			ok: false,
+			reason: "stdin is not valid JSON"
+		};
+	}
+	if (harness === "claude-code") {
+		const parsed = ClaudeCodeStopInputSchema.safeParse(parsedJson);
+		if (!parsed.success) return {
+			ok: false,
+			reason: `invalid hook payload: ${parsed.error.message}`
+		};
+		return {
+			ok: true,
+			value: {
+				sessionId: parsed.data.session_id,
+				transcriptPath: parsed.data.transcript_path,
+				stopHookActive: parsed.data.stop_hook_active === true
+			}
+		};
+	}
+	return {
+		ok: false,
+		reason: `unsupported harness: ${harness}`
+	};
+}
+async function readStdin() {
+	if (process.stdin.isTTY) return "";
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+	return Buffer.concat(chunks).toString("utf8");
+}
+async function extractCommand(opts) {
+	const harnessResult = ExtractionHarnessSchema.safeParse(opts.harness ?? "claude-code");
+	if (!harnessResult.success) {
+		process.stderr.write(`membank extract: unsupported harness "${opts.harness}". Supported: ${ExtractionHarnessSchema.options.join(", ")}\n`);
+		return;
+	}
+	const harness = harnessResult.data;
+	let sessionId = opts.sessionId;
+	let transcriptPath = opts.transcript;
+	let stopHookActive = false;
+	if (sessionId === void 0 || transcriptPath === void 0) {
+		const raw = await readStdin();
+		if (raw.trim().length > 0) {
+			const parsed = parseHookPayload(harness, raw);
+			if (!parsed.ok) {
+				process.stderr.write(`membank extract: ${parsed.reason}; skipping.\n`);
+				return;
+			}
+			sessionId = sessionId ?? parsed.value.sessionId;
+			transcriptPath = transcriptPath ?? parsed.value.transcriptPath;
+			stopHookActive = parsed.value.stopHookActive;
+		}
+	}
+	if (sessionId === void 0 || transcriptPath === void 0) {
+		process.stderr.write("membank extract: missing session_id or transcript_path (provide via stdin or --session/--transcript).\n");
+		return;
+	}
+	if (stopHookActive) {
+		process.stderr.write("membank extract: stop_hook_active=true; skipping to avoid recursion.\n");
+		return;
+	}
+	try {
+		const result = await runExtraction({
+			sessionId,
+			transcriptPath
+		});
+		if (result.status === "skipped") process.stderr.write(`membank extract: skipped (${result.reason})\n`);
+		else if (result.status === "failed") process.stderr.write(`membank extract: failed: ${result.error}\n`);
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		process.stderr.write(`membank extract: ${msg}\n`);
+	}
+}
+//#endregion
 //#region src/commands/import.ts
 async function importCommand(filePath, db, formatter, prompt) {
 	let raw;
@@ -220,18 +306,23 @@ async function importCommand(filePath, db, formatter, prompt) {
 	if (formatter.isJson) process.stdout.write(`${JSON.stringify({ found: count })}\n`);
 	else process.stdout.write(`Found ${count} memories to import.\n`);
 	if (!await prompt.confirm("Import?")) return;
-	const insertMemory = db.db.prepare(`INSERT OR REPLACE INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-	const insertEmbedding = db.db.prepare(`INSERT OR REPLACE INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`);
-	db.db.transaction(() => {
-		for (const rec of parseResult.data.memories) {
-			insertMemory.run(rec.id, rec.content, rec.type, JSON.stringify(rec.tags ?? []), rec.sourceHarness ?? null, rec.accessCount ?? 0, rec.pinned ? 1 : 0, rec.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(), rec.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString());
-			if (rec.embedding !== null && rec.embedding !== void 0) {
-				const buf = Buffer.from(rec.embedding, "base64");
-				insertEmbedding.run(buf, rec.id);
-			}
-		}
-	})();
+	const records = parseResult.data.memories.map((rec) => ({
+		id: rec.id,
+		content: rec.content,
+		type: rec.type,
+		tags: rec.tags,
+		sourceHarness: rec.sourceHarness ?? null,
+		accessCount: rec.accessCount ?? 0,
+		pinned: rec.pinned ?? false,
+		createdAt: rec.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		updatedAt: rec.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		embedding: (() => {
+			if (rec.embedding == null) return null;
+			const buf = Buffer.from(rec.embedding, "base64");
+			return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+		})()
+	}));
+	createMemoryRepository(db, createProjectRepository(db)).importAll(records);
 	if (formatter.isJson) process.stdout.write(`${JSON.stringify({ imported: count })}\n`);
 	else process.stdout.write(`Imported ${count} memories.\n`);
 }
@@ -277,8 +368,8 @@ async function buildText() {
 	const resolved = await resolveProject();
 	const db = DatabaseManager.open();
 	try {
-		const builder = new SessionContextBuilder(db);
-		const synthRepo = new SynthesisRepository(db);
+		const builder = new SessionContextBuilder(createMemoryRepository(db, createProjectRepository(db)));
+		const synthRepo = createSynthesisRepository(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);
@@ -288,10 +379,6 @@ async function buildText() {
 	}
 }
 async function handleEvent(harness, eventName) {
-	if (harness === "claude-code" && eventName === "Stop") {
-		process.stdout.write("{}");
-		return;
-	}
 	const text = await buildText().catch((err) => {
 		const msg = err instanceof Error ? err.message : String(err);
 		process.stderr.write(`membank inject: ${msg}\n`);
@@ -311,10 +398,6 @@ 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
@@ -322,7 +405,7 @@ async function injectCommand(opts) {
 async function listCommand(options, formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const memories = new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).list({
+		const memories = createMemoryRepository(db, createProjectRepository(db)).list({
 			type: options.type !== void 0 ? MemoryTypeSchema$1.parse(options.type) : void 0,
 			pinned: options.pinned
 		});
@@ -353,7 +436,7 @@ async function migrateCommand(mode, name, formatter) {
 	const db = DatabaseManager.open();
 	try {
 		if (name === "scope-to-projects") {
-			const result = await runScopeToProjectsMigration(new ProjectRepository(db));
+			const result = await runScopeToProjectsMigration(createProjectRepository(db));
 			if (result === null) {
 				formatter.error("No project found for current directory.");
 				return;
@@ -377,7 +460,7 @@ function pinCommand(id, db) {
 	const ownDb = db === void 0;
 	const resolvedDb = db ?? DatabaseManager.open();
 	try {
-		new MemoryRepository(resolvedDb, new EmbeddingService(), new ProjectRepository(resolvedDb)).setPin(id, true);
+		createMemoryRepository(resolvedDb, createProjectRepository(resolvedDb)).setPin(id, true);
 		process.stdout.write(`${chalk.green("✓")} Pinned: ${chalk.dim(id)}\n`);
 	} finally {
 		if (ownDb) resolvedDb.close();
@@ -388,8 +471,7 @@ function pinCommand(id, db) {
 async function queryCommand(queryText, options, formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const embedding = new EmbeddingService();
-		const engine = new QueryEngine(db, embedding, new MemoryRepository(db, embedding, new ProjectRepository(db)));
+		const engine = new QueryEngine(db, new EmbeddingService(), createMemoryRepository(db, createProjectRepository(db)));
 		const limit = options.limit !== void 0 ? LimitSchema.parse(options.limit) : 10;
 		const spinner = formatter.isJson ? null : ora("Searching memories…").start();
 		const results = await engine.query({
@@ -409,7 +491,7 @@ async function queryCommand(queryText, options, formatter) {
 async function reviewCommand(opts, formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const repo = new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db));
+		const repo = createMemoryRepository(db, createProjectRepository(db));
 		if (opts.resolve !== void 0) {
 			repo.resolveReviewEvents(opts.resolve);
 			if (!formatter.isJson) process.stdout.write(`Resolved review events for memory ${opts.resolve}\n`);
@@ -427,7 +509,7 @@ async function reviewCommand(opts, formatter) {
 async function statsCommand(formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const stats = new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).stats();
+		const stats = createMemoryRepository(db, createProjectRepository(db)).stats();
 		formatter.outputStats(stats);
 	} finally {
 		db.close();
@@ -435,9 +517,6 @@ 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;
-}
 async function synthesizeRunCommand(opts, formatter) {
 	const scope = opts.scope ?? "global";
 	if (!formatter.isJson) process.stdout.write(`Running synthesis for scope: ${scope}\n`);
@@ -451,30 +530,25 @@ async function synthesizeRunCommand(opts, formatter) {
 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";
 		let resolvedScope = scope;
 		if (scope !== "global" && !/^[0-9a-f]{16}$/.test(scope)) {
-			const project = new ProjectRepository(db).getByName(scope);
+			const project = createProjectRepository(db).getByName(scope);
 			if (project !== void 0) resolvedScope = project.scopeHash;
 		}
-		const row = db.db.prepare("SELECT * FROM syntheses WHERE scope = ? ORDER BY synthesized_at DESC LIMIT 1").get(resolvedScope);
-		if (row === void 0) {
+		const synthesis = createSynthesisRepository(db).getSynthesis(resolvedScope);
+		if (synthesis === 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`);
+		if (formatter.isJson) process.stdout.write(`${JSON.stringify(synthesis)}\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`);
+			process.stdout.write(`\nScope: ${synthesis.scope}\n`);
+			process.stdout.write(`Synthesized: ${new Date(synthesis.synthesizedAt).toLocaleString()}\n`);
+			process.stdout.write(`Expires: ${new Date(synthesis.expiresAt).toLocaleString()}\n`);
+			if (synthesis.inFlightSince !== null) process.stdout.write(`In-flight since: ${new Date(synthesis.inFlightSince).toLocaleString()}\n`);
+			process.stdout.write(`\n${synthesis.content}\n\n`);
 		}
 	} finally {
 		db.close();
@@ -483,29 +557,22 @@ function synthesizeShowCommand(opts, formatter) {
 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 s.*, p.name AS project_name
-         FROM syntheses s
-         LEFT JOIN projects p ON p.scope_hash = s.scope
-         ORDER BY COALESCE(p.name, s.scope)`).all();
+		const syntheses = createSynthesisRepository(db).listAll();
+		const projectRepo = createProjectRepository(db);
 		if (formatter.isJson) {
-			process.stdout.write(`${JSON.stringify(rows)}\n`);
+			process.stdout.write(`${JSON.stringify(syntheses)}\n`);
 			return;
 		}
-		if (rows.length === 0) {
+		if (syntheses.length === 0) {
 			process.stdout.write("No syntheses found.\n");
 			return;
 		}
 		process.stdout.write("\n");
-		for (const row of rows) {
-			const displayScope = row.project_name ?? row.scope;
-			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)";
+		for (const s of syntheses) {
+			const displayScope = (s.scope !== "global" ? projectRepo.getByHash(s.scope) : void 0)?.name ?? s.scope;
+			const inFlight = s.inFlightSince !== null ? " [in-flight]" : "";
+			const synthesized = new Date(s.synthesizedAt).toLocaleString();
+			const expires = new Date(s.expiresAt).toLocaleString();
 			process.stdout.write(`  ${displayScope}${inFlight}\n`);
 			process.stdout.write(`    synthesized_at: ${synthesized}\n`);
 			process.stdout.write(`    expires_at:     ${expires}\n`);
@@ -521,7 +588,7 @@ function unpinCommand(id, db) {
 	const ownDb = db === void 0;
 	const resolvedDb = db ?? DatabaseManager.open();
 	try {
-		new MemoryRepository(resolvedDb, new EmbeddingService(), new ProjectRepository(resolvedDb)).setPin(id, false);
+		createMemoryRepository(resolvedDb, createProjectRepository(resolvedDb)).setPin(id, false);
 		process.stdout.write(`${chalk.green("✓")} Unpinned: ${chalk.dim(id)}\n`);
 	} finally {
 		if (ownDb) resolvedDb.close();
@@ -777,18 +844,20 @@ function hasKey(container, key) {
 function assertCliFound(result, cli, command) {
 	if (result.exitCode === 127) throw new CommandError(`${cli} CLI not found — install ${cli} first`, command);
 }
+function jsonContainsStalePattern(value) {
+	return JSON.stringify(value).includes("@membank/cli");
+}
 const MEMBANK_NPX_ARGS = [
 	"npx",
 	"-y",
-	"@membank/cli",
-	"--mcp"
+	"@membank/mcp"
 ];
 const writers$1 = {
 	"claude-code": {
 		preview(resolver) {
 			return {
 				configPath: join(resolver.home(), ".claude.json"),
-				cliCommand: "claude mcp add --scope user membank -- npx -y @membank/cli --mcp"
+				cliCommand: "claude mcp add --scope user membank -- npx -y @membank/mcp"
 			};
 		},
 		async write(resolver, run, { overwrite = false } = {}) {
@@ -821,6 +890,10 @@ const writers$1 = {
 			assertCliFound(add, "claude", addCmd);
 			if (add.exitCode !== 0) throw new CommandError(`claude mcp add failed: ${add.stderr || add.stdout}`, addCmd);
 			return { status: "written" };
+		},
+		async isStale(resolver) {
+			const cfg = readJson(join(resolver.home(), ".claude.json"));
+			return hasKey(cfg.mcpServers, "membank") && jsonContainsStalePattern(cfg.mcpServers);
 		}
 	},
 	copilot: {
@@ -840,22 +913,22 @@ const writers$1 = {
 					...MaybeJsonObjectSchema.parse(cfg.mcpServers),
 					membank: {
 						command: "npx",
-						args: [
-							"-y",
-							"@membank/cli",
-							"--mcp"
-						]
+						args: ["-y", "@membank/mcp"]
 					}
 				}
 			});
 			return { status: "written" };
+		},
+		async isStale(resolver) {
+			const cfg = readJson(join(resolver.home(), ".copilot", "mcp-config.json"));
+			return hasKey(cfg.mcpServers, "membank") && jsonContainsStalePattern(cfg.mcpServers);
 		}
 	},
 	codex: {
 		preview(_resolver) {
 			return {
 				configPath: null,
-				cliCommand: "codex mcp add membank -- npx -y @membank/cli --mcp"
+				cliCommand: "codex mcp add membank -- npx -y @membank/mcp"
 			};
 		},
 		async write(_resolver, run, { overwrite = false } = {}) {
@@ -887,6 +960,10 @@ const writers$1 = {
 			assertCliFound(add, "codex", addCmd);
 			if (add.exitCode !== 0) throw new CommandError(`codex mcp add failed: ${add.stderr || add.stdout}`, addCmd);
 			return { status: "written" };
+		},
+		async isStale(_resolver, run) {
+			const list = await run("codex", ["mcp", "list"]);
+			return list.exitCode === 0 && list.stdout.includes("membank") && list.stdout.includes("@membank/cli");
 		}
 	},
 	opencode: {
@@ -909,13 +986,16 @@ const writers$1 = {
 						command: [
 							"npx",
 							"-y",
-							"@membank/cli",
-							"--mcp"
+							"@membank/mcp"
 						]
 					}
 				}
 			});
 			return { status: "written" };
+		},
+		async isStale(resolver) {
+			const cfg = readJson(join(resolver.home(), ".config", "opencode", "opencode.json"));
+			return hasKey(cfg.mcp, "membank") && jsonContainsStalePattern(cfg.mcp);
 		}
 	}
 };
@@ -937,6 +1017,15 @@ var HarnessConfigWriter = class {
 		if (!writer) throw new Error(`Unknown harness: ${harness}`);
 		return writer.write(this.#resolver, this.#run, { overwrite });
 	}
+	async isStale(harness) {
+		const writer = writers$1[harness];
+		if (!writer) return false;
+		try {
+			return await writer.isStale(this.#resolver, this.#run);
+		} catch {
+			return false;
+		}
+	}
 };
 //#endregion
 //#region src/setup/injection-hook-writer.ts
@@ -1009,7 +1098,7 @@ const writers = {
 					},
 					{
 						event: "Stop",
-						command: "npx -y @membank/cli inject --harness claude-code --event session-stop",
+						command: "npx -y @membank/cli extract --harness claude-code",
 						existingCommand: extractInjectCommand(stopInner) || null
 					}
 				]
@@ -1021,6 +1110,7 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const newHooks = { ...hooks };
 			pruneNestedEvent(newHooks, "PostToolUseFailure");
+			pruneNestedEvent(newHooks, "Stop");
 			if (events.includes("SessionStart")) newHooks.SessionStart = [...filterOutMembank(Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []), {
 				matcher: "",
 				hooks: [{
@@ -1039,7 +1129,9 @@ const writers = {
 				matcher: "",
 				hooks: [{
 					type: "command",
-					command: "npx -y @membank/cli inject --harness claude-code --event session-stop"
+					command: "npx -y @membank/cli extract --harness claude-code",
+					async: true,
+					timeout: 600
 				}]
 			}];
 			writeJsonAtomic(cfgPath, {
@@ -1056,27 +1148,18 @@ 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
-					},
-					{
-						event: "sessionEnd",
-						command: "npx -y @membank/cli inject --harness copilot-cli --event session-stop",
-						existingCommand: extractInjectCommand(sessionEnd) || 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
+				}]
 			};
 		},
 		write(resolver, events) {
@@ -1085,6 +1168,7 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const newHooks = { ...hooks };
 			pruneFlatEvent(newHooks, "postToolUseFailure");
+			pruneFlatEvent(newHooks, "sessionEnd");
 			if (events.includes("sessionStart")) newHooks.sessionStart = [...filterOutMembankFlat(Array.isArray(hooks.sessionStart) ? hooks.sessionStart : []), {
 				type: "command",
 				bash: "npx -y @membank/cli inject --harness copilot-cli",
@@ -1095,11 +1179,6 @@ 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,
@@ -1115,27 +1194,18 @@ 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
-					},
-					{
-						event: "Stop",
-						command: "npx -y @membank/cli inject --harness codex --event session-stop",
-						existingCommand: extractInjectCommand(stopInner) || 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
+				}]
 			};
 		},
 		write(resolver, events) {
@@ -1144,6 +1214,7 @@ const writers = {
 			const hooks = MaybeJsonObjectSchema.parse(cfg.hooks) ?? {};
 			const newHooks = { ...hooks };
 			pruneNestedEvent(newHooks, "PostToolUse");
+			pruneNestedEvent(newHooks, "Stop");
 			if (events.includes("SessionStart")) newHooks.SessionStart = [...filterOutMembank(Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []), {
 				matcher: "",
 				hooks: [{
@@ -1160,14 +1231,6 @@ 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
@@ -1229,76 +1292,6 @@ var InjectionHookWriter = class {
 	}
 };
 //#endregion
-//#region src/setup/model-downloader.ts
-const MODEL_NAME = "Xenova/bge-small-en-v1.5";
-var ModelDownloadError = class extends Error {
-	constructor(message, options) {
-		super(message, options);
-		this.name = "ModelDownloadError";
-	}
-};
-function defaultModelPath() {
-	return join(homedir(), ".membank", "models");
-}
-function isCached(modelPath) {
-	if (!existsSync(modelPath)) return false;
-	try {
-		return readdirSync(modelPath).length > 0;
-	} catch {
-		return false;
-	}
-}
-var ModelDownloader = class extends EventEmitter {
-	modelPath;
-	constructor(modelPath) {
-		super();
-		this.modelPath = modelPath ?? defaultModelPath();
-	}
-	isAlreadyCached() {
-		return isCached(this.modelPath);
-	}
-	get cachePath() {
-		return this.modelPath;
-	}
-	async download() {
-		if (isCached(this.modelPath)) return { skipped: true };
-		const startTime = Date.now();
-		let lastDownloadedBytes = 0;
-		let lastTimestamp = startTime;
-		try {
-			await pipeline("feature-extraction", MODEL_NAME, {
-				cache_dir: this.modelPath,
-				progress_callback: (event) => {
-					if (event.status !== "progress" || event.total == null || event.loaded == null) return;
-					const totalBytes = event.total;
-					const downloadedBytes = event.loaded;
-					const percentage = totalBytes > 0 ? downloadedBytes / totalBytes * 100 : 0;
-					const now = Date.now();
-					const elapsedSinceLastMs = now - lastTimestamp;
-					const bytesSinceLast = downloadedBytes - lastDownloadedBytes;
-					let estimatedSecondsRemaining = 0;
-					if (elapsedSinceLastMs > 0 && bytesSinceLast > 0) {
-						const bytesPerMs = bytesSinceLast / elapsedSinceLastMs;
-						estimatedSecondsRemaining = (totalBytes - downloadedBytes) / bytesPerMs / 1e3;
-					}
-					lastDownloadedBytes = downloadedBytes;
-					lastTimestamp = now;
-					const progress = {
-						totalBytes,
-						downloadedBytes,
-						percentage,
-						estimatedSecondsRemaining
-					};
-					this.emit("progress", progress);
-				}
-			});
-		} catch (err) {
-			throw new ModelDownloadError("Failed to download model", { cause: err });
-		}
-		return { skipped: false };
-	}
-};
-//#endregion
 //#region src/setup/harness-detector.ts
 const defaultResolver = { homeDir: homedir };
 function harnessConfigs(resolver) {
@@ -1586,7 +1579,10 @@ var SetupOrchestrator = class {
 };
 //#endregion
 //#region src/index.ts
-if (process.argv.includes("--mcp")) await startServer();
+if (process.argv.includes("--mcp")) {
+	process.stderr.write("[membank] Deprecation: `membank --mcp` is deprecated. Use: npx @membank/mcp\n");
+	await startServer();
+}
 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").option("--include-pinned", "include pinned memories in results (excluded by default)").action(async (queryText, cmdOptions) => {
@@ -1698,7 +1694,47 @@ program.command("inject").description("output session context for harness inject
 		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) => {
+program.command("extract").description("(internal) run session-end memory extraction; reads the harness's Stop hook payload from stdin").option("--harness <name>", "harness whose stop-hook payload is on stdin (only claude-code is supported today)", "claude-code").option("--session <id>", "session id (otherwise read from stdin)").option("--transcript <path>", "transcript JSONL path (otherwise read from stdin)").action(async (cmdOptions) => {
+	try {
+		await extractCommand({
+			harness: cmdOptions.harness,
+			sessionId: cmdOptions.session,
+			transcript: cmdOptions.transcript
+		});
+	} catch (err) {
+		process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+	}
+	process.exit(0);
+});
+const setupCmd = 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)");
+setupCmd.command("upgrade").description("upgrade harness configs from membank --mcp to standalone membank-mcp").action(async () => {
+	const isJson = program.opts().json === true;
+	const writer = new HarnessConfigWriter();
+	const stale = [];
+	for (const harness of SUPPORTED_HARNESSES) if (await writer.isStale(harness)) stale.push(harness);
+	if (stale.length === 0) {
+		if (isJson) process.stdout.write(`${JSON.stringify({ upgraded: [] })}\n`);
+		else process.stdout.write("All harness configs are already up to date.\n");
+		return;
+	}
+	const upgraded = [];
+	const errors = [];
+	for (const harness of stale) try {
+		await writer.write(harness, { overwrite: true });
+		upgraded.push(harness);
+		if (!isJson) process.stdout.write(`  ${chalk.green("✓")} ${harness}\n`);
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		errors.push(`${harness}: ${msg}`);
+		if (!isJson) process.stderr.write(`  ${chalk.red("✗")} ${harness}: ${msg}\n`);
+	}
+	if (isJson) process.stdout.write(`${JSON.stringify({
+		upgraded,
+		errors
+	})}\n`);
+	if (errors.length > 0) process.exit(1);
+});
+setupCmd.action(async (cmdOptions) => {
 	const globalOpts = program.opts();
 	const autoYes = cmdOptions.yes === true || globalOpts.yes === true;
 	const formatter = Formatter.create(globalOpts.json === true);
@@ -1792,13 +1828,9 @@ program.command("migrate <mode> [name]").description("list or run a named data m
 		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.command("dashboard").description("(deprecated) open the memory management dashboard").allowUnknownOption().action(() => {
+	process.stderr.write("The dashboard is now a standalone package.\nRun: npx @membank/dashboard\n");
+	process.exit(1);
 });
 const configCmd = program.command("config").description("manage membank configuration");
 configCmd.command("get <key>").description("print a config value as JSON").action((key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.11.2",
+  "version": "0.13.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -11,19 +11,18 @@
     "membank": "./dist/index.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.map"
   ],
   "dependencies": {
     "@clack/prompts": "^1.3.0",
-    "@huggingface/transformers": "^4.2.0",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
     "zod": "^4.4.3",
-    "@membank/core": "0.9.4",
-    "@membank/dashboard": "0.5.5",
-    "@membank/mcp": "0.12.2"
+    "@membank/core": "0.11.0",
+    "@membank/mcp": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",