codemem 0.24.0 → 0.25.1

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEFAULT_COORDINATOR_DB_PATH, MemoryStore, ObserverClient, RawEventSweeper, SyncRetentionRunner, VERSION, applyBootstrapSnapshot, backfillTagsText, backfillVectors, buildAuthHeaders, buildBaseUrl, buildRawEventEnvelopeFromHook, compareMemoryRoleReports, connect, coordinatorCreateGroupAction, coordinatorCreateInviteAction, coordinatorDisableDeviceAction, coordinatorEnrollDeviceAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorListDevicesAction, coordinatorListGroupsAction, coordinatorListJoinRequestsAction, coordinatorRemoveDeviceAction, coordinatorRenameDeviceAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, createBetterSqliteCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, ensureDeviceIdentity, exportMemories, fetchAllSnapshotPages, fingerprintPublicKey, getExtractionBenchmarkProfile, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSessionExtractionEval, getSessionExtractionEvalScenario, getWorkspaceCodememConfigPath, hasUnsyncedSharedMemoryChanges, importMemories, initDatabase, isEmbeddingDisabled, loadObserverConfig, loadPublicKey, loadSqliteVec, planReplicationOpsAgePrune, pruneReplicationOpsUntilCaughtUp, rawEventsGate, readCodememConfigFile, readCodememConfigFileAtPath, readCoordinatorSyncConfig, readImportPayload, replayBatchExtraction, replayBatchExtractionWithTierRouting, requestJson, resolveCodememConfigPath, resolveDbPath, resolveHookProject, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, schema, setPeerProjectFilter, stripJsonComments, stripPrivateObj, stripTrailingCommas, syncPassPreflight, updatePeerAddresses, vacuumDatabase, writeCodememConfigFile } from "@codemem/core";
+import { DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, MemoryStore, ObserverClient, RawEventSweeper, SyncRetentionRunner, VERSION, VectorModelMigrationRunner, aiBackfillStructuredContent, applyBootstrapSnapshot, backfillMemoryDedupKeys, backfillNarrativeFromBody, backfillTagsText, backfillVectors, buildAuthHeaders, buildBaseUrl, buildRawEventEnvelopeFromHook, compareMemoryRoleReports, connect, coordinatorCreateGroupAction, coordinatorCreateInviteAction, coordinatorDisableDeviceAction, coordinatorEnrollDeviceAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorListDevicesAction, coordinatorListGroupsAction, coordinatorListJoinRequestsAction, coordinatorRemoveDeviceAction, coordinatorRenameDeviceAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, createBetterSqliteCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, dedupNearDuplicateMemories, ensureDeviceIdentity, exportMemories, fetchAllSnapshotPages, fingerprintPublicKey, getExtractionBenchmarkProfile, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSessionExtractionEval, getSessionExtractionEvalScenario, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasUnsyncedSharedMemoryChanges, importMemories, initDatabase, isEmbeddingDisabled, loadObserverConfig, loadPublicKey, loadSqliteVec, planReplicationOpsAgePrune, pruneReplicationOpsUntilCaughtUp, rawEventsGate, readCodememConfigFile, readCodememConfigFileAtPath, readCoordinatorSyncConfig, readImportPayload, replayBatchExtraction, replayBatchExtractionWithTierRouting, requestJson, resolveCodememConfigPath, resolveDbPath, resolveHookProject, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, schema, setPeerProjectFilter, stripJsonComments, stripPrivateObj, stripTrailingCommas, syncPassPreflight, updatePeerAddresses, vacuumDatabase, writeCodememConfigFile } from "@codemem/core";
 import { Command, Option } from "commander";
 import omelette from "omelette";
 import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
@@ -242,7 +242,7 @@ function envNotDisabled(value) {
 	const normalized = String(value ?? "").trim().toLowerCase();
 	return normalized !== "0" && normalized !== "false" && normalized !== "off";
 }
-function parsePositiveInt(value, fallback) {
+function parsePositiveInt$1(value, fallback) {
 	const parsed = Number.parseInt(String(value ?? ""), 10);
 	if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
 	return parsed;
@@ -269,8 +269,8 @@ function resolveInjectProject(payload) {
 async function buildLocalPack(context, project, dbPath) {
 	const store = new MemoryStore(dbPath);
 	try {
-		const limit = parsePositiveInt(process.env.CODEMEM_INJECT_LIMIT, 8);
-		const budget = parsePositiveInt(process.env.CODEMEM_INJECT_TOKEN_BUDGET, 800);
+		const limit = parsePositiveInt$1(process.env.CODEMEM_INJECT_LIMIT, 8);
+		const budget = parsePositiveInt$1(process.env.CODEMEM_INJECT_TOKEN_BUDGET, 800);
 		const filters = {};
 		if (project) filters.project = project;
 		const pack = await store.buildMemoryPackAsync(context, limit, budget, filters);
@@ -281,11 +281,11 @@ async function buildLocalPack(context, project, dbPath) {
 }
 async function tryHttpPack(context, project, maxTimeMs = DEFAULT_HTTP_MAX_TIME_S * 1e3) {
 	const host = process.env.CODEMEM_VIEWER_HOST || DEFAULT_VIEWER_HOST;
-	const port = parsePositiveInt(process.env.CODEMEM_VIEWER_PORT, DEFAULT_VIEWER_PORT);
+	const port = parsePositiveInt$1(process.env.CODEMEM_VIEWER_PORT, DEFAULT_VIEWER_PORT);
 	const url = new URL(`http://${host}:${port}/api/pack`);
 	url.searchParams.set("context", context);
-	url.searchParams.set("limit", String(parsePositiveInt(process.env.CODEMEM_INJECT_LIMIT, 8)));
-	url.searchParams.set("token_budget", String(parsePositiveInt(process.env.CODEMEM_INJECT_TOKEN_BUDGET, 800)));
+	url.searchParams.set("limit", String(parsePositiveInt$1(process.env.CODEMEM_INJECT_LIMIT, 8)));
+	url.searchParams.set("token_budget", String(parsePositiveInt$1(process.env.CODEMEM_INJECT_TOKEN_BUDGET, 800)));
 	if (project) url.searchParams.set("project", project);
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), maxTimeMs);
@@ -308,8 +308,8 @@ async function buildClaudeHookInjection(payload, opts, deps = {}) {
 	const httpPack = deps.httpPack ?? tryHttpPack;
 	const resolveDb = deps.resolveDb ?? resolveDbPath;
 	const project = resolveInjectProject(payload);
-	const maxChars = parsePositiveInt(process.env.CODEMEM_INJECT_MAX_CHARS, DEFAULT_MAX_CHARS);
-	const httpMaxTimeMs = parsePositiveInt(process.env.CODEMEM_INJECT_HTTP_MAX_TIME_S, DEFAULT_HTTP_MAX_TIME_S) * 1e3;
+	const maxChars = parsePositiveInt$1(process.env.CODEMEM_INJECT_MAX_CHARS, DEFAULT_MAX_CHARS);
+	const httpMaxTimeMs = parsePositiveInt$1(process.env.CODEMEM_INJECT_HTTP_MAX_TIME_S, DEFAULT_HTTP_MAX_TIME_S) * 1e3;
 	let additionalContext = "";
 	try {
 		additionalContext = await buildPack(context, project, resolveDb(resolveDbOpt(opts)));
@@ -1361,6 +1361,119 @@ pruneMemCmd.action((opts) => {
 	}
 });
 dbCommand.addCommand(pruneMemCmd);
+var dedupCmd = new Command("dedup-memories").configureHelp(helpStyle).description("Deactivate near-duplicate memories (cross-session, same normalized title within time window)").option("--window <ms>", "max time gap in milliseconds between duplicates (default: 3600000)").option("--limit <n>", "max pairs to check").option("--dry-run", "preview deactivations without writing");
+addDbOption(dedupCmd);
+addJsonOption(dedupCmd);
+dedupCmd.action((opts) => {
+	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+	try {
+		const windowMs = parseOptionalPositiveInt$1(opts.window);
+		const limit = parseOptionalPositiveInt$1(opts.limit);
+		const result = dedupNearDuplicateMemories(store.db, {
+			windowMs,
+			limit,
+			dryRun: opts.dryRun === true
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(result, null, 2));
+			return;
+		}
+		const action = opts.dryRun ? "Would deactivate" : "Deactivated";
+		p.intro("codemem db dedup-memories");
+		if (result.pairs.length > 0 && result.pairs.length <= 20) for (const pair of result.pairs) p.log.info(`${action} [${pair.deactivated_id}] (kept [${pair.kept_id}]): ${pair.title.slice(0, 80)}`);
+		p.outro(`${action} ${result.deactivated} duplicates from ${result.checked} pairs`);
+	} catch (error) {
+		p.log.error(error instanceof Error ? error.message : String(error));
+		process.exitCode = 1;
+	} finally {
+		store.close();
+	}
+});
+dbCommand.addCommand(dedupCmd);
+var backfillDedupKeysCmd = new Command("backfill-dedup-keys").configureHelp(helpStyle).description("Populate missing memory_items.dedup_key values for legacy rows").option("--limit <n>", "max memories to check").option("--dry-run", "preview updates without writing");
+addDbOption(backfillDedupKeysCmd);
+addJsonOption(backfillDedupKeysCmd);
+backfillDedupKeysCmd.action((opts) => {
+	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+	try {
+		const limit = parseOptionalPositiveInt$1(opts.limit);
+		const result = backfillMemoryDedupKeys(store.db, {
+			limit,
+			dryRun: opts.dryRun === true
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(result, null, 2));
+			return;
+		}
+		const action = opts.dryRun ? "Would update" : "Updated";
+		p.intro("codemem db backfill-dedup-keys");
+		p.log.success(`${action} ${result.updated} memories (skipped ${result.skipped})`);
+		p.outro(`Checked ${result.checked} memories`);
+	} catch (error) {
+		p.log.error(error instanceof Error ? error.message : String(error));
+		process.exitCode = 1;
+	} finally {
+		store.close();
+	}
+});
+dbCommand.addCommand(backfillDedupKeysCmd);
+var backfillNarrativeCmd = new Command("backfill-narrative").configureHelp(helpStyle).description("Extract narrative from session_summary body_text (## Completed / ## Learned sections)").option("--limit <n>", "max memories to check").option("--dry-run", "preview updates without writing");
+addDbOption(backfillNarrativeCmd);
+addJsonOption(backfillNarrativeCmd);
+backfillNarrativeCmd.action((opts) => {
+	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+	try {
+		const limit = parseOptionalPositiveInt$1(opts.limit);
+		const result = backfillNarrativeFromBody(store.db, {
+			limit,
+			dryRun: opts.dryRun === true
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(result, null, 2));
+			return;
+		}
+		const action = opts.dryRun ? "Would update" : "Updated";
+		p.intro("codemem db backfill-narrative");
+		p.log.success(`${action} ${result.updated} memories (skipped ${result.skipped})`);
+		p.outro(`Checked ${result.checked} memories`);
+	} catch (error) {
+		p.log.error(error instanceof Error ? error.message : String(error));
+		process.exitCode = 1;
+	} finally {
+		store.close();
+	}
+});
+dbCommand.addCommand(backfillNarrativeCmd);
+var aiBackfillStructuredCmd = new Command("ai-backfill-structured").configureHelp(helpStyle).description("Use GPT-5.4 to populate missing narrative/facts/concepts for older non-session-summary memories").option("--limit <n>", "max memories to check").option("--kinds <csv>", "comma-separated kinds to target").option("--overwrite", "overwrite existing structured fields instead of only filling missing ones").option("--dry-run", "preview updates without writing");
+addDbOption(aiBackfillStructuredCmd);
+addJsonOption(aiBackfillStructuredCmd);
+aiBackfillStructuredCmd.action(async (opts) => {
+	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+	try {
+		const limit = parseOptionalPositiveInt$1(opts.limit);
+		const kinds = parseKindsCsv(opts.kinds);
+		const result = await aiBackfillStructuredContent(store.db, {
+			limit,
+			kinds,
+			overwrite: opts.overwrite === true,
+			dryRun: opts.dryRun === true
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(result, null, 2));
+			return;
+		}
+		const action = opts.dryRun ? "Would update" : "Updated";
+		p.intro("codemem db ai-backfill-structured");
+		p.log.success(`${action} ${result.updated} memories (skipped ${result.skipped}, failed ${result.failed})`);
+		p.outro(`Checked ${result.checked} memories`);
+	} catch (error) {
+		p.log.error(error instanceof Error ? error.message : String(error));
+		process.exitCode = 1;
+	} finally {
+		store.close();
+	}
+});
+dbCommand.addCommand(aiBackfillStructuredCmd);
 //#endregion
 //#region src/commands/embed.ts
 function parseOptionalPositiveInt(value) {
@@ -1601,13 +1714,22 @@ var mcpCommand = mcpCmd.action(async (opts) => {
 });
 //#endregion
 //#region src/commands/pack-shared.ts
+var PackUsageError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PackUsageError";
+	}
+};
 function collectWorkingSetFile(value, previous) {
 	return [...previous, value];
 }
+function addPackRequestOptions(command) {
+	return command.option("-n, --limit <n>", "max items", "10").option("--budget <tokens>", "token budget").option("--token-budget <tokens>", "token budget").option("--working-set-file <path>", "recently modified file path used as ranking hint", collectWorkingSetFile, []).option("--project <project>", "project identifier (defaults to git repo root)").option("--all-projects", "search across all projects").option("--compact", "render a scannable index with full detail only for top N items").option("--compact-detail <n>", "items to show in full detail in compact mode (default 3)");
+}
 function buildPackRequestOptions(opts, ctx = {}) {
-	const limit = Number.parseInt(opts.limit ?? "10", 10) || 10;
+	const limit = parsePositiveInt(opts.limit ?? "10", "limit");
 	const budgetRaw = opts.tokenBudget ?? opts.budget;
-	const budget = budgetRaw ? Number.parseInt(budgetRaw, 10) : void 0;
+	const budget = budgetRaw ? parseNonNegativeInt(budgetRaw, "token budget") : void 0;
 	const filters = {};
 	if (!opts.allProjects) {
 		const defaultProject = ctx.envProject?.trim() || null;
@@ -1617,12 +1739,30 @@ function buildPackRequestOptions(opts, ctx = {}) {
 		if (project) filters.project = project;
 	}
 	if ((opts.workingSetFile?.length ?? 0) > 0) filters.working_set_paths = opts.workingSetFile;
+	let renderOptions;
+	if (opts.compact || opts.compactDetail != null) {
+		renderOptions = { compact: true };
+		if (opts.compactDetail != null) renderOptions.compactDetailCount = parseNonNegativeInt(opts.compactDetail, "compact detail count");
+	}
 	return {
 		limit,
 		budget,
-		filters
+		filters,
+		renderOptions
 	};
 }
+function parsePositiveInt(value, label) {
+	if (!/^\d+$/.test(value.trim())) throw new PackUsageError(`${label} must be a positive integer`);
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isFinite(parsed) || parsed < 1) throw new PackUsageError(`${label} must be a positive integer`);
+	return parsed;
+}
+function parseNonNegativeInt(value, label) {
+	if (!/^\d+$/.test(value.trim())) throw new PackUsageError(`${label} must be a non-negative integer`);
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isFinite(parsed) || parsed < 0) throw new PackUsageError(`${label} must be a non-negative integer`);
+	return parsed;
+}
 //#endregion
 //#region src/commands/memory.ts
 /**
@@ -2235,14 +2375,79 @@ memoryCommand.addCommand(createMemoryRelinkReportCommand());
 memoryCommand.addCommand(createMemoryRelinkPlanCommand());
 //#endregion
 //#region src/commands/pack.ts
-var packCmd = new Command("pack").configureHelp(helpStyle).description("Build a context-aware memory pack").argument("<context>", "context string to search for").option("-n, --limit <n>", "max items", "10").option("--budget <tokens>", "token budget").option("--token-budget <tokens>", "token budget").option("--working-set-file <path>", "recently modified file path used as ranking hint", collectWorkingSetFile, []).option("--project <project>", "project identifier (defaults to git repo root)").option("--all-projects", "search across all projects");
-addDbOption(packCmd);
-addJsonOption(packCmd);
-var packCommand = packCmd.action(async (context, opts) => {
-	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+function describeCandidate(candidate) {
+	const scoreParts = [
+		candidate.scores.combined_score != null ? `combined=${candidate.scores.combined_score.toFixed(2)}` : null,
+		candidate.scores.base_score != null ? `base=${candidate.scores.base_score.toFixed(2)}` : null,
+		candidate.scores.text_overlap > 0 ? `text=${candidate.scores.text_overlap}` : null,
+		candidate.scores.tag_overlap > 0 ? `tag=${candidate.scores.tag_overlap}` : null,
+		candidate.scores.working_set_overlap > 0 ? `working_set=${candidate.scores.working_set_overlap.toFixed(2)}` : null
+	].filter(Boolean).join(" ");
+	const lines = [`${candidate.rank}. [${candidate.id}] (${candidate.kind}) ${candidate.title}`];
+	if (candidate.section) lines.push(`   - section: ${candidate.section}`);
+	if (candidate.reasons.length > 0) lines.push(`   - reasons: ${candidate.reasons.join(", ")}`);
+	if (scoreParts) lines.push(`   - scores: ${scoreParts}`);
+	if (candidate.preview) lines.push(`   - preview: ${candidate.preview}`);
+	return lines;
+}
+function renderPackTrace(trace) {
+	const workingSet = trace.inputs.working_set_files.length > 0 ? trace.inputs.working_set_files.join(", ") : "(none)";
+	const lines = [
+		"Pack trace",
+		`- Query: ${trace.inputs.query}`,
+		`- Project: ${trace.inputs.project ?? "(default)"}`,
+		`- Working set: ${workingSet}`,
+		`- Mode: ${trace.mode.selected}`,
+		`- Mode reasons: ${trace.mode.reasons.join(", ") || "(none)"}`,
+		`- Token budget: ${trace.inputs.token_budget ?? "(none)"}`,
+		""
+	];
+	for (const disposition of [
+		"selected",
+		"dropped",
+		"deduped",
+		"trimmed"
+	]) {
+		const group = trace.retrieval.candidates.filter((candidate) => candidate.disposition === disposition);
+		if (group.length === 0) continue;
+		lines.push(disposition.charAt(0).toUpperCase() + disposition.slice(1));
+		for (const candidate of group) lines.push(...describeCandidate(candidate));
+		lines.push("");
+	}
+	lines.push("Assembly");
+	lines.push(`- deduped ids: ${trace.assembly.deduped_ids.join(", ") || "(none)"}`);
+	lines.push(`- trimmed ids: ${trace.assembly.trimmed_ids.join(", ") || "(none)"}`);
+	lines.push(`- trim reasons: ${trace.assembly.trim_reasons.join(", ") || "(none)"}`);
+	lines.push(`- section counts: summary=${trace.output.section_counts.summary} timeline=${trace.output.section_counts.timeline} observations=${trace.output.section_counts.observations}`);
+	lines.push(`- estimated tokens: ${trace.output.estimated_tokens}`);
+	lines.push(`- truncated: ${trace.output.truncated ? "yes" : "no"}`);
+	lines.push("");
+	lines.push("Final pack");
+	lines.push(trace.output.pack_text);
+	return lines.join("\n");
+}
+async function withStore(opts, errorCode, run) {
+	let store = null;
 	try {
-		const { limit, budget, filters } = buildPackRequestOptions(opts, { envProject: process.env.CODEMEM_PROJECT });
-		const result = await store.buildMemoryPackAsync(context, limit, budget, filters);
+		store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+		await run(store);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		const usageError = error instanceof PackUsageError;
+		if (opts.json) {
+			emitJsonError(usageError ? "usage_error" : errorCode, message, usageError ? 2 : 1);
+			return;
+		}
+		p.log.error(message);
+		process.exitCode = usageError ? 2 : 1;
+	} finally {
+		store?.close();
+	}
+}
+async function packAction(context, opts) {
+	await withStore(opts, "pack_failed", async (store) => {
+		const { limit, budget, filters, renderOptions } = buildPackRequestOptions(opts, { envProject: process.env.CODEMEM_PROJECT });
+		const result = await store.buildMemoryPackAsync(context, limit, budget, filters, renderOptions);
 		if (opts.json) {
 			console.log(JSON.stringify(result, null, 2));
 			return;
@@ -2253,15 +2458,34 @@ var packCommand = packCmd.action(async (context, opts) => {
 			p.outro("done");
 			return;
 		}
-		const m = result.metrics;
-		p.log.info(`${m.total_items} items, ~${m.pack_tokens} tokens` + (m.fallback_used ? " (fallback)" : "") + `  [fts:${m.sources.fts} sem:${m.sources.semantic} fuzzy:${m.sources.fuzzy}]`);
+		const metrics = result.metrics;
+		p.log.info(`${metrics.total_items} items, ~${metrics.pack_tokens} tokens` + (metrics.fallback_used ? " (fallback)" : "") + `  [fts:${metrics.sources.fts} sem:${metrics.sources.semantic} fuzzy:${metrics.sources.fuzzy}]`);
 		for (const item of result.items) p.log.step(`#${item.id}  ${item.kind}  ${item.title}`);
 		p.note(result.pack_text, "pack_text");
 		p.outro("done");
-	} finally {
-		store.close();
-	}
-});
+	});
+}
+async function traceAction(context, opts) {
+	await withStore(opts, "pack_trace_failed", async (store) => {
+		const { limit, budget, filters, renderOptions } = buildPackRequestOptions(opts, { envProject: process.env.CODEMEM_PROJECT });
+		const trace = await store.buildMemoryPackTraceAsync(context, limit, budget, filters, renderOptions);
+		if (opts.json) {
+			console.log(JSON.stringify(trace, null, 2));
+			return;
+		}
+		console.log(renderPackTrace(trace));
+	});
+}
+var packCmd = addPackRequestOptions(new Command("pack").enablePositionalOptions().configureHelp(helpStyle).description("Build a context-aware memory pack").argument("<context>", "context string to search for"));
+addDbOption(packCmd);
+addJsonOption(packCmd);
+packCmd.action(packAction);
+var traceCmd = addPackRequestOptions(new Command("trace").configureHelp(helpStyle).description("Trace retrieval and assembly for a memory pack").argument("<context>", "context string to trace"));
+addDbOption(traceCmd);
+addJsonOption(traceCmd);
+traceCmd.action(traceAction);
+packCmd.addCommand(traceCmd);
+var packCommand = packCmd;
 //#endregion
 //#region src/commands/recent.ts
 var cmd = new Command("recent").configureHelp(helpStyle).description("Show recent memories").option("--limit <n>", "max results", "5").option("--project <project>", "project identifier (defaults to git repo root)").option("--all-projects", "search across all projects").option("--kind <kind>", "filter by memory kind");
@@ -2683,6 +2907,8 @@ async function startForegroundViewer(invocation) {
 		dbPath: resolveDbPath(invocation.dbPath ?? void 0),
 		signal: retentionAbort.signal
 	});
+	const vectorMigrationRunner = new VectorModelMigrationRunner({ dbPath: resolveDbPath(invocation.dbPath ?? void 0) });
+	const dedupKeyBackfillRunner = new DedupKeyBackfillRunner({ dbPath: resolveDbPath(invocation.dbPath ?? void 0) });
 	const syncRuntimeStatus = {
 		phase: syncEnabled ? "starting" : "disabled",
 		detail: syncEnabled ? "Waiting for viewer startup to finish" : "Sync is disabled"
@@ -2725,6 +2951,14 @@ async function startForegroundViewer(invocation) {
 		p.log.success(`Listening on http://${info.address}:${info.port}`);
 		p.log.info(`Database: ${preparedDb}`);
 		p.log.step("Raw event sweeper started");
+		if (!isEmbeddingDisabled()) {
+			vectorMigrationRunner.start();
+			p.log.step("Vector maintenance runner started");
+		}
+		if (hasPendingDedupKeyBackfill(store.db)) {
+			dedupKeyBackfillRunner.start();
+			p.log.step("Dedup-key maintenance runner started");
+		}
 		if (syncConfig.syncRetentionEnabled) {
 			retentionRunner.start();
 			p.log.step("Retention maintenance runner started");
@@ -2783,6 +3017,8 @@ async function startForegroundViewer(invocation) {
 		syncAbort.abort();
 		retentionAbort.abort();
 		await sweeper.stop();
+		await dedupKeyBackfillRunner.stop();
+		await vectorMigrationRunner.stop();
 		await retentionRunner.stop();
 		await new Promise((resolve) => {
 			let remaining = syncServer ? 2 : 1;
@@ -4106,7 +4342,7 @@ function getShellCompletionScript() {
 	return completion.generateCompletionCode();
 }
 var program = new Command();
-program.name("codemem").description("codemem — persistent memory for AI coding agents").option("--install-completion", "install shell completion").option("--show-completion", "show shell completion install guidance").version(VERSION).configureHelp(helpStyle);
+program.name("codemem").description("codemem — persistent memory for AI coding agents").enablePositionalOptions().option("--install-completion", "install shell completion").option("--show-completion", "show shell completion install guidance").version(VERSION).configureHelp(helpStyle);
 if (hasRootFlag("--setup-completion") || hasRootFlag("--install-completion")) {
 	completion.setupShellInitFile();
 	process.exit(0);