@membank/cli 0.13.1 → 0.14.1

package/README.md

@@ -157,14 +157,30 @@ membank config show
 
 ### `membank synthesize`
 
-View memory synthesis state.
+View and manage memory synthesis.
 
 ```bash
+membank synthesize run               # trigger a synthesis run for a scope
 membank synthesize show              # current synthesis for global scope
 membank synthesize show --scope <s>  # synthesis for a specific project scope
 membank synthesize status            # all scopes and their synthesis state
 ```
 
+Options for `run` and `show`: `--scope <scope>`
+
+### `membank activity`
+
+List activity events for the current project.
+
+```bash
+membank activity
+membank activity --type memory.created
+membank activity --since 2025-01-01
+membank activity --global
+```
+
+Options: `--type <event_type>` (memory.created|updated|deleted|flagged|queried), `--since <date>`, `--memory-id <id>`, `--limit <n>` (default 50), `--global`, `--scope <hash>`
+
 ### `membank inject`
 
 Output session context formatted for a harness. Called automatically by session hooks — you don't normally run this directly.

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, MIGRATIONS, MODEL_NAME, MemoryTypeSchema, MemoryTypeSchema as MemoryTypeSchema$1, ModelDownloader, PIN_BUDGET_THRESHOLD, QueryEngine, SessionContextBuilder, createMemoryRepository, createProjectRepository, createSynthesisRepository, resolveProject, runScopeToProjectsMigration, saveMemory } from "@membank/core";
+import { ACTIVITY_EVENT_TYPE_VALUES, ActivityEventTypeSchema, DatabaseManager, EmbeddingService, GLOBAL_SCOPE_HASH, MIGRATIONS, MODEL_NAME, MemoryTypeSchema, MemoryTypeSchema as MemoryTypeSchema$1, ModelDownloader, PIN_BUDGET_THRESHOLD, QueryEngine, SessionContextBuilder, createActivityLogger, createActivityRepository, createMemoryRepository, createProjectRepository, createSynthesisRepository, deleteMemory, listEvents, resolveProject, runScopeToProjectsMigration, saveMemory } from "@membank/core";
 import { runExtraction, runSynthesis, startServer } from "@membank/mcp";
 import chalk from "chalk";
 import { Command } from "commander";
@@ -13,6 +13,63 @@ import Table from "cli-table3";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { createInterface } from "node:readline";
+//#region src/commands/activity.ts
+const EVENT_COLORS = {
+	"memory.created": chalk.green,
+	"memory.updated": chalk.cyan,
+	"memory.deleted": chalk.red,
+	"memory.flagged": chalk.yellow,
+	"memory.queried": chalk.dim
+};
+function formatEvent(event) {
+	return `  ${(EVENT_COLORS[event.eventType] ?? chalk.white)(event.eventType.padEnd(16))}  ${new Date(event.createdAt).toLocaleTimeString()}${event.memoryId !== null ? chalk.dim(` [${event.memoryId.slice(0, 8)}]`) : ""}`;
+}
+async function activityCommand(options, formatter) {
+	const db = DatabaseManager.open();
+	try {
+		const activityRepo = createActivityRepository(db);
+		let scope;
+		if (options.scope !== void 0) scope = options.scope;
+		else if (options.global === true) scope = GLOBAL_SCOPE_HASH;
+		else scope = (await resolveProject()).hash;
+		let validatedType;
+		if (options.type !== void 0) {
+			const parsed = ActivityEventTypeSchema.safeParse(options.type);
+			if (!parsed.success) {
+				formatter.error(`Invalid event type: "${options.type}". Valid values: ${ACTIVITY_EVENT_TYPE_VALUES.join(", ")}`);
+				process.exit(1);
+			}
+			validatedType = parsed.data;
+		}
+		const events = listEvents({
+			scope,
+			type: validatedType,
+			since: options.since,
+			limit: options.limit !== void 0 ? parseInt(options.limit, 10) : 50
+		}, activityRepo);
+		if (formatter.isJson) {
+			process.stdout.write(`${JSON.stringify(events)}\n`);
+			return;
+		}
+		if (events.length === 0) {
+			process.stdout.write(chalk.dim("  No activity found.\n"));
+			return;
+		}
+		let lastDay = "";
+		for (const event of events) {
+			const day = event.createdAt.slice(0, 10);
+			if (day !== lastDay) {
+				lastDay = day;
+				process.stdout.write(`\n${chalk.bold(day)}\n`);
+			}
+			process.stdout.write(`${formatEvent(event)}\n`);
+		}
+		process.stdout.write("\n");
+	} finally {
+		db.close();
+	}
+}
+//#endregion
 //#region src/schemas.ts
 const SETUP_HARNESS_VALUES = [
 	"claude-code",
@@ -59,6 +116,7 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 	try {
 		const embedder = embeddingService ?? new EmbeddingService();
 		const repo = createMemoryRepository(resolvedDb, createProjectRepository(resolvedDb));
+		const activityLogger = createActivityLogger(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();
@@ -69,7 +127,8 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 			projectScope
 		}, {
 			repo,
-			embedder
+			embedder,
+			activityLogger
 		});
 		spinner?.succeed("Memory saved");
 		formatter.outputMemory(memory);
@@ -160,7 +219,7 @@ async function deleteCommand(id, db, formatter, prompt) {
 		process.exit(1);
 	}
 	if (!await prompt.confirm(`Delete memory ${id}?`)) return;
-	repo.delete(id);
+	await deleteMemory(id, repo, createActivityLogger(db));
 	process.stdout.write(`${chalk.green("✓")} Deleted memory: ${chalk.dim(id)}\n`);
 }
 //#endregion
@@ -370,7 +429,7 @@ async function buildText() {
 	try {
 		const builder = new SessionContextBuilder(createMemoryRepository(db, createProjectRepository(db)));
 		const synthRepo = createSynthesisRepository(db);
-		const globalRow = synthRepo.getSynthesis("global");
+		const globalRow = synthRepo.getSynthesis(GLOBAL_SCOPE_HASH);
 		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));
@@ -532,7 +591,8 @@ function synthesizeShowCommand(opts, formatter) {
 	try {
 		const scope = opts.scope ?? "global";
 		let resolvedScope = scope;
-		if (scope !== "global" && !/^[0-9a-f]{16}$/.test(scope)) {
+		if (scope === "global") resolvedScope = GLOBAL_SCOPE_HASH;
+		else if (!/^[0-9a-f]{16}$/.test(scope)) {
 			const project = createProjectRepository(db).getByName(scope);
 			if (project !== void 0) resolvedScope = project.scopeHash;
 		}
@@ -569,7 +629,7 @@ function synthesizeStatusCommand(formatter) {
 		}
 		process.stdout.write("\n");
 		for (const s of syntheses) {
-			const displayScope = (s.scope !== "global" ? projectRepo.getByHash(s.scope) : void 0)?.name ?? s.scope;
+			const displayScope = (s.scope !== GLOBAL_SCOPE_HASH ? projectRepo.getByHash(s.scope) : void 0)?.name ?? (s.scope === GLOBAL_SCOPE_HASH ? "global" : s.scope);
 			const inFlight = s.inFlightSince !== null ? " [in-flight]" : "";
 			const synthesized = new Date(s.synthesizedAt).toLocaleString();
 			const expires = new Date(s.expiresAt).toLocaleString();
@@ -1876,6 +1936,19 @@ synthesizeCmd.command("status").description("show all scopes with synthesis stat
 		process.exit(2);
 	}
 });
+program.command("activity").description("list activity events for the current project (or --global for global memories)").option("--type <event_type>", "filter by event type (memory.created|updated|deleted|flagged|queried)").option("--since <date>", "return events after this ISO date/time").option("--memory-id <id>", "filter by memory id").option("--limit <n>", "maximum number of results (default 50)").option("--global", "show activity for global (sentinel) project").option("--scope <hash>", "show activity for a specific scope hash (advanced)").action(async (cmdOptions) => {
+	const globalOpts = program.opts();
+	const formatter = Formatter.create(globalOpts.json === true);
+	try {
+		await activityCommand({
+			...cmdOptions,
+			json: globalOpts.json
+		}, 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.13.1",
+  "version": "0.14.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
     "commander": "^14.0.3",
     "ora": "^9.4.0",
     "zod": "^4.4.3",
-    "@membank/mcp": "0.14.1",
-    "@membank/core": "0.11.1"
+    "@membank/core": "0.12.1",
+    "@membank/mcp": "0.14.3"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",