@membank/cli 0.5.1 → 0.7.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { cancel, confirm, intro, isCancel, multiselect, note, outro } from "@clack/prompts";
-import { DatabaseManager, EmbeddingService, MEMORY_TYPE_VALUES, MemoryRepository, QueryEngine, SessionContextBuilder, resolveScope } from "@membank/core";
+import { DatabaseManager, EmbeddingService, MEMORY_TYPE_VALUES, MIGRATIONS, MemoryRepository, ProjectRepository, QueryEngine, SessionContextBuilder, resolveProject, runScopeToProjectsMigration } from "@membank/core";
 import { startServer } from "@membank/mcp";
 import chalk from "chalk";
 import { Command } from "commander";
@@ -20,14 +20,15 @@ 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());
+		const repo = new MemoryRepository(resolvedDb, embeddingService ?? new EmbeddingService(), new ProjectRepository(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({
 			content,
 			type: options.type,
 			tags,
-			scope: options.scope
+			projectScope
 		});
 		spinner?.succeed("Memory saved");
 		formatter.outputMemory(memory);
@@ -48,7 +49,7 @@ async function deleteCommand(id, db, formatter, prompt) {
 		process.exit(1);
 	}
 	if (!await prompt.confirm(`Delete memory ${id}?`)) return;
-	await new MemoryRepository(db, new EmbeddingService()).delete(id);
+	await new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).delete(id);
 	process.stdout.write(`${chalk.green("✓")} Deleted memory: ${chalk.dim(id)}\n`);
 }
 //#endregion
@@ -59,7 +60,6 @@ function exportCommand(db, formatter, opts) {
 		content: row.content,
 		type: row.type,
 		tags: JSON.parse(row.tags),
-		scope: row.scope,
 		sourceHarness: row.source,
 		accessCount: row.access_count,
 		pinned: row.pinned !== 0,
@@ -87,7 +87,7 @@ const MEMORY_TYPES = new Set(MEMORY_TYPE_VALUES);
 function isValidRecord(r) {
 	if (typeof r !== "object" || r === null) return false;
 	const rec = r;
-	return typeof rec.id === "string" && rec.id.length > 0 && typeof rec.content === "string" && typeof rec.type === "string" && MEMORY_TYPES.has(rec.type) && typeof rec.scope === "string" && rec.scope.length > 0;
+	return typeof rec.id === "string" && rec.id.length > 0 && typeof rec.content === "string" && typeof rec.type === "string" && MEMORY_TYPES.has(rec.type);
 }
 function isExportFile(parsed) {
 	if (typeof parsed !== "object" || parsed === null) return false;
@@ -115,19 +115,19 @@ async function importCommand(filePath, db, formatter, prompt) {
 	}
 	const invalidIndex = parsed.memories.findIndex((r) => !isValidRecord(r));
 	if (invalidIndex !== -1) {
-		formatter.error(`Invalid memory record at index ${invalidIndex}: must have id, content, type, and scope`);
+		formatter.error(`Invalid memory record at index ${invalidIndex}: must have id, content, and type`);
 		process.exit(1);
 	}
 	const count = parsed.memories.length;
 	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, scope, source, access_count, pinned, needs_review, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+	const insertMemory = db.db.prepare(`INSERT OR REPLACE INTO memories (id, content, type, tags, source, access_count, pinned, needs_review, 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 parsed.memories) {
-			insertMemory.run(rec.id, rec.content, rec.type, JSON.stringify(rec.tags ?? []), rec.scope, rec.sourceHarness ?? null, rec.accessCount ?? 0, rec.pinned ? 1 : 0, rec.needsReview ? 1 : 0, rec.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(), rec.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString());
+			insertMemory.run(rec.id, rec.content, rec.type, JSON.stringify(rec.tags ?? []), rec.sourceHarness ?? null, rec.accessCount ?? 0, rec.pinned ? 1 : 0, rec.needsReview ? 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);
@@ -166,7 +166,7 @@ function outputAdditionalContext(text, harness, eventName) {
 	process.stdout.write(`${text}\n`);
 }
 async function handleSessionStart(opts) {
-	const projectScope = opts.scope ?? await resolveScope();
+	const projectScope = (await resolveProject()).hash;
 	const db = DatabaseManager.open();
 	let text;
 	try {
@@ -187,7 +187,7 @@ async function injectCommand(opts) {
 async function listCommand(options, formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const memories = new MemoryRepository(db, new EmbeddingService()).list({
+		const memories = new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).list({
 			type: options.type,
 			pinned: options.pinned
 		});
@@ -197,18 +197,53 @@ async function listCommand(options, formatter) {
 	}
 }
 //#endregion
+//#region src/commands/migrate.ts
+async function migrateCommand(mode, name, formatter) {
+	if (mode === "list") {
+		if (formatter.isJson) process.stdout.write(`${JSON.stringify(MIGRATIONS.map((m) => ({
+			name: m.name,
+			description: m.description
+		})))}\n`);
+		else for (const m of MIGRATIONS) process.stdout.write(`${m.name}\n  ${m.description}\n`);
+		return;
+	}
+	if (name === void 0) {
+		formatter.error("Migration name is required for run mode.");
+		process.exit(1);
+	}
+	if (!MIGRATIONS.some((m) => m.name === name)) {
+		formatter.error(`Unknown migration: "${name}". Available: ${MIGRATIONS.map((m) => m.name).join(", ")}`);
+		process.exit(1);
+	}
+	const db = DatabaseManager.open();
+	try {
+		if (name === "scope-to-projects") {
+			const result = await runScopeToProjectsMigration(new ProjectRepository(db));
+			if (result === null) {
+				formatter.error("No project found for current directory.");
+				return;
+			}
+			if (formatter.isJson) process.stdout.write(`${JSON.stringify(result)}\n`);
+			else {
+				const { oldName, newName, memoryCount } = result;
+				process.stdout.write(`Found project: ${oldName} (${memoryCount} ${memoryCount === 1 ? "memory" : "memories"})\n`);
+				process.stdout.write(`Resolved name: ${newName}\n`);
+				process.stdout.write(`Renamed → ${newName}\n`);
+				process.stdout.write("Done.\n");
+			}
+		}
+	} finally {
+		db.close();
+	}
+}
+//#endregion
 //#region src/commands/pin.ts
-function pinCommand(id, formatter, db) {
+function pinCommand(id, db) {
 	const ownDb = db === void 0;
 	const resolvedDb = db ?? DatabaseManager.open();
 	try {
-		if (resolvedDb.db.prepare("SELECT id FROM memories WHERE id = ?").get(id) === void 0) {
-			formatter.error(`Memory not found: ${id}`);
-			process.exit(2);
-		} else {
-			resolvedDb.db.prepare("UPDATE memories SET pinned = 1 WHERE id = ?").run(id);
-			process.stdout.write(`${chalk.green("✓")} Pinned: ${chalk.dim(id)}\n`);
-		}
+		new MemoryRepository(resolvedDb, new EmbeddingService(), new ProjectRepository(resolvedDb)).setPin(id, true);
+		process.stdout.write(`${chalk.green("✓")} Pinned: ${chalk.dim(id)}\n`);
 	} finally {
 		if (ownDb) resolvedDb.close();
 	}
@@ -219,7 +254,7 @@ 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));
+		const engine = new QueryEngine(db, embedding, new MemoryRepository(db, embedding, new ProjectRepository(db)));
 		const limit = options.limit !== void 0 ? Number.parseInt(options.limit, 10) : 10;
 		const spinner = formatter.isJson ? null : ora("Searching memories…").start();
 		const results = await engine.query({
@@ -238,7 +273,7 @@ async function queryCommand(queryText, options, formatter) {
 async function statsCommand(formatter) {
 	const db = DatabaseManager.open();
 	try {
-		const stats = new MemoryRepository(db, new EmbeddingService()).stats();
+		const stats = new MemoryRepository(db, new EmbeddingService(), new ProjectRepository(db)).stats();
 		formatter.outputStats(stats);
 	} finally {
 		db.close();
@@ -246,17 +281,12 @@ async function statsCommand(formatter) {
 }
 //#endregion
 //#region src/commands/unpin.ts
-function unpinCommand(id, formatter, db) {
+function unpinCommand(id, db) {
 	const ownDb = db === void 0;
 	const resolvedDb = db ?? DatabaseManager.open();
 	try {
-		if (resolvedDb.db.prepare("SELECT id FROM memories WHERE id = ?").get(id) === void 0) {
-			formatter.error(`Memory not found: ${id}`);
-			process.exit(2);
-		} else {
-			resolvedDb.db.prepare("UPDATE memories SET pinned = 0 WHERE id = ?").run(id);
-			process.stdout.write(`${chalk.green("✓")} Unpinned: ${chalk.dim(id)}\n`);
-		}
+		new MemoryRepository(resolvedDb, new EmbeddingService(), new ProjectRepository(resolvedDb)).setPin(id, false);
+		process.stdout.write(`${chalk.green("✓")} Unpinned: ${chalk.dim(id)}\n`);
 	} finally {
 		if (ownDb) resolvedDb.close();
 	}
@@ -296,7 +326,8 @@ var Formatter = class Formatter {
 		process.stdout.write("\n");
 		process.stdout.write(`  ${colorType(memory.type)}  ${chalk.dim(memory.id)}\n`);
 		process.stdout.write(`  ${memory.content}\n`);
-		process.stdout.write(`  ${chalk.dim("Tags:")} ${tags}  ${chalk.dim("Scope:")} ${memory.scope}\n`);
+		const scope = memory.projects.length > 0 ? memory.projects.map((p) => p.name).join(", ") : "global";
+		process.stdout.write(`  ${chalk.dim("Tags:")} ${tags}  ${chalk.dim("Project:")} ${scope}\n`);
 		process.stdout.write(`\n  ${chalk.dim(`Hint: pin with  membank pin ${memory.id}`)}\n\n`);
 	}
 	outputMemories(memories) {
@@ -322,7 +353,8 @@ var Formatter = class Formatter {
 		});
 		for (const m of memories) {
 			const tags = m.tags.length > 0 ? m.tags.join(", ") : "(none)";
-			const meta = `${truncate(m.content, 45)}\n${chalk.dim(`${tags} · ${m.scope}`)}`;
+			const mScope = m.projects.length > 0 ? m.projects.map((p) => p.name).join(", ") : "global";
+			const meta = `${truncate(m.content, 45)}\n${chalk.dim(`${tags} · ${mScope}`)}`;
 			table.push([
 				colorType(m.type),
 				chalk.dim(m.id),
@@ -376,7 +408,8 @@ var Formatter = class Formatter {
 			const scoreStr = r.score.toFixed(4);
 			const score = r.score >= .85 ? chalk.bold(scoreStr) : r.score < .75 ? chalk.dim(scoreStr) : scoreStr;
 			const tags = r.tags.length > 0 ? r.tags.join(", ") : "(none)";
-			const meta = `${truncate(r.content, 45)}\n${chalk.dim(`${tags} · ${r.scope}`)}`;
+			const rScope = r.projects.length > 0 ? r.projects.map((p) => p.name).join(", ") : "global";
+			const meta = `${truncate(r.content, 45)}\n${chalk.dim(`${tags} · ${rScope}`)}`;
 			table.push([
 				colorType(r.type),
 				chalk.dim(r.id),
@@ -1252,7 +1285,7 @@ program.command("delete <id>").description("delete a memory by ID").action(async
 		db.close();
 	}
 });
-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) => {
+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("--global", "save as a global memory, not tied to any project").action(async (content, cmdOptions) => {
 	const globalOpts = program.opts();
 	const formatter = Formatter.create(globalOpts.json === true);
 	try {
@@ -1266,7 +1299,7 @@ program.command("pin <id>").description("pin a memory by ID").action((id) => {
 	const globalOpts = program.opts();
 	const formatter = Formatter.create(globalOpts.json === true);
 	try {
-		pinCommand(id, formatter);
+		pinCommand(id);
 	} catch (err) {
 		formatter.error(err instanceof Error ? err.message : String(err));
 		process.exit(2);
@@ -1276,7 +1309,7 @@ program.command("unpin <id>").description("unpin a memory by ID").action((id) =>
 	const globalOpts = program.opts();
 	const formatter = Formatter.create(globalOpts.json === true);
 	try {
-		unpinCommand(id, formatter);
+		unpinCommand(id);
 	} catch (err) {
 		formatter.error(err instanceof Error ? err.message : String(err));
 		process.exit(2);
@@ -1309,7 +1342,7 @@ program.command("import <file>").description("import memories from a JSON export
 		db.close();
 	}
 });
-program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--scope <scope>", "project scope override (default: auto-detect from git remote)").option("--event <event>", "hook event type (only session-start is supported; other values no-op for legacy hook compatibility)", "session-start").action(async (cmdOptions) => {
+program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--event <event>", "hook event type (only session-start is supported; other values no-op for legacy hook compatibility)", "session-start").action(async (cmdOptions) => {
 	try {
 		await injectCommand(cmdOptions);
 	} catch (err) {
@@ -1385,6 +1418,20 @@ program.command("setup").description("detect installed harnesses and write MCP c
 		process.exit(2);
 	}
 });
+program.command("migrate <mode> [name]").description("list or run a named data migration (modes: list, run)").action(async (mode, name) => {
+	if (mode !== "list" && mode !== "run") {
+		process.stderr.write(`Error: mode must be "list" or "run"\n`);
+		process.exit(1);
+	}
+	const globalOpts = program.opts();
+	const formatter = Formatter.create(globalOpts.json === true);
+	try {
+		await migrateCommand(mode, name, formatter);
+	} catch (err) {
+		formatter.error(err instanceof Error ? err.message : String(err));
+		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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -20,9 +20,9 @@
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
-    "@membank/core": "0.5.1",
-    "@membank/dashboard": "0.2.3",
-    "@membank/mcp": "0.6.0"
+    "@membank/core": "0.6.1",
+    "@membank/dashboard": "0.3.1",
+    "@membank/mcp": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",