codemem 0.28.1 → 0.29.1

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEDUP_KEY_BACKFILL_JOB, DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, MUTATING_TOOL_NAMES, MemoryStore, ObserverClient, REF_BACKFILL_JOB, RawEventSweeper, RefBackfillRunner, SESSION_CONTEXT_BACKFILL_JOB, SUMMARY_DEDUP_BACKFILL_JOB, SessionContextBackfillRunner, SummaryDedupBackfillRunner, 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, ensureSchemaBootstrapped, exportMemories, extractApplyPatchPaths, fetchAllSnapshotPages, fingerprintPublicKey, flushRawEvents, getExtractionBenchmarkProfile, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMaintenanceJob, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSemanticIndexDiagnostics, getSessionExtractionEval, getSessionExtractionEvalScenario, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasPendingRefBackfill, hasPendingSessionContextBackfill, hasPendingSummaryDedupBackfill, 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 { DEDUP_KEY_BACKFILL_JOB, DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, MUTATING_TOOL_NAMES, MemoryStore, ObserverClient, REF_BACKFILL_JOB, RawEventSweeper, RefBackfillRunner, SESSION_CONTEXT_BACKFILL_JOB, SUMMARY_DEDUP_BACKFILL_JOB, SessionContextBackfillRunner, SummaryDedupBackfillRunner, 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, ensureSchemaBootstrapped, exportMemories, extractApplyPatchPaths, fetchAllSnapshotPages, fingerprintPublicKey, flushRawEvents, getExtractionBenchmarkProfile, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMaintenanceJob, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSemanticIndexDiagnostics, getSessionExtractionEval, getSessionExtractionEvalScenario, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasPendingRefBackfill, hasPendingSessionContextBackfill, hasPendingSummaryDedupBackfill, hasUnsyncedSharedMemoryChanges, importMemories, initDatabase, isEmbeddingDisabled, listMaintenanceJobs, loadObserverConfig, loadPublicKey, loadSqliteVec, mdnsEnabled, 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 { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
@@ -102,8 +102,9 @@ var BOOLEAN_TOGGLE_VALUES = new Set([
 	"no"
 ]);
 function expandHome$2(value) {
-	if (value === "~") return homedir();
-	if (value.startsWith("~/")) return join(homedir(), value.slice(2));
+	const home = process.env.HOME?.trim() || homedir();
+	if (value === "~") return home;
+	if (value.startsWith("~/")) return join(home, value.slice(2));
 	return value;
 }
 function pluginLogPath() {
@@ -2575,6 +2576,78 @@ cmd$1.action((inputFile, opts) => {
 });
 var importMemoriesCommand = cmd$1;
 //#endregion
+//#region src/commands/maintenance.ts
+var maintenanceCmd = new Command("maintenance").configureHelp(helpStyle).description("Inspect background maintenance / backfill jobs");
+var statusCmd$1 = new Command("status").configureHelp(helpStyle).description("Print current status of all maintenance jobs");
+addDbOption(statusCmd$1);
+addJsonOption(statusCmd$1);
+statusCmd$1.action((opts) => {
+	const store = new MemoryStore(resolveDbPath(resolveDbOpt(opts)));
+	try {
+		const jobs = listMaintenanceJobs(store.db);
+		if (opts.json) {
+			console.log(JSON.stringify({ jobs }, null, 2));
+			return;
+		}
+		printJobsTable(jobs);
+	} finally {
+		store.close();
+	}
+});
+maintenanceCmd.addCommand(statusCmd$1);
+var maintenanceCommand = maintenanceCmd;
+function printJobsTable(jobs) {
+	p.intro("codemem maintenance");
+	if (jobs.length === 0) {
+		p.log.info("No maintenance jobs recorded in this database.");
+		p.outro("done");
+		return;
+	}
+	const statusRank = {
+		running: 0,
+		pending: 1,
+		failed: 2,
+		cancelled: 3,
+		completed: 4
+	};
+	const sorted = [...jobs].sort((a, b) => {
+		const rankDiff = (statusRank[a.status] ?? 9) - (statusRank[b.status] ?? 9);
+		if (rankDiff !== 0) return rankDiff;
+		return b.updated_at.localeCompare(a.updated_at);
+	});
+	for (const job of sorted) {
+		const progress = formatProgress(job);
+		const when = job.finished_at ? `finished ${shortAge(job.finished_at)} ago` : job.started_at ? `started ${shortAge(job.started_at)} ago` : `updated ${shortAge(job.updated_at)} ago`;
+		const header = `${job.kind} · ${job.status}${progress ? ` · ${progress}` : ""} · ${when}`;
+		const body = [
+			job.title,
+			job.message,
+			job.error ? `error: ${job.error}` : null
+		].filter(Boolean).join("\n");
+		(job.status === "failed" ? p.log.error : job.status === "completed" ? p.log.success : p.log.step)(`${header}\n${body}`);
+	}
+	p.outro("done");
+}
+function formatProgress(job) {
+	const { current, total, unit } = job.progress;
+	if (!current && !total) return null;
+	const unitLabel = unit || "items";
+	if (total == null || total <= 0) return `${current.toLocaleString()} ${unitLabel}`;
+	const pct = Math.round(100 * current / total);
+	return `${current.toLocaleString()}/${total.toLocaleString()} ${unitLabel} (${pct}%)`;
+}
+function shortAge(iso) {
+	const parsed = Date.parse(iso);
+	if (!Number.isFinite(parsed)) return iso;
+	const seconds = Math.max(0, Math.round((Date.now() - parsed) / 1e3));
+	if (seconds < 60) return `${seconds}s`;
+	const minutes = Math.round(seconds / 60);
+	if (minutes < 60) return `${minutes}m`;
+	const hours = Math.round(minutes / 60);
+	if (hours < 48) return `${hours}h`;
+	return `${Math.round(hours / 24)}d`;
+}
+//#endregion
 //#region src/commands/mcp.ts
 var mcpCmd = new Command("mcp").configureHelp(helpStyle).description("Start the MCP stdio server");
 addDbOption(mcpCmd);
@@ -3881,7 +3954,10 @@ async function startForegroundViewer(invocation) {
 		dbPath,
 		signal: retentionAbort.signal
 	});
-	const vectorMigrationRunner = new VectorModelMigrationRunner({ dbPath });
+	const vectorMigrationRunner = new VectorModelMigrationRunner({
+		dbPath,
+		signal: backfillAbort.signal
+	});
 	const backfillCoordinator = createSequentialBackfillCoordinator(store, [
 		{
 			name: "Dedup-key",
@@ -4123,10 +4199,12 @@ serveCmd.addOption(new Option("--stop", "stop background viewer").hideHelp());
 serveCmd.addOption(new Option("--restart", "restart background viewer").hideHelp());
 var serveCommand = serveCmd.action(async (action, opts) => {
 	try {
-		if (opts.stop) emitDeprecationWarning("--stop", "codemem serve stop");
-		if (opts.restart) emitDeprecationWarning("--restart", "codemem serve restart");
-		if (opts.background) emitDeprecationWarning("--background", "codemem serve start");
-		if (opts.foreground) emitDeprecationWarning("--foreground", "codemem serve start --foreground");
+		if (action === void 0) {
+			if (opts.stop) emitDeprecationWarning("--stop", "codemem serve stop");
+			if (opts.restart) emitDeprecationWarning("--restart", "codemem serve restart");
+			if (opts.background) emitDeprecationWarning("--background", "codemem serve start");
+			if (opts.foreground) emitDeprecationWarning("--foreground", "codemem serve start --foreground");
+		}
 		const normalizedAction = action === void 0 ? void 0 : action === "start" || action === "stop" || action === "restart" ? action : null;
 		if (normalizedAction === null) {
 			p.log.error(`Unknown serve action: ${action}`);
@@ -4907,11 +4985,15 @@ doctorCmd.action(async (opts) => {
 			if (reach !== "ok") issues.push(`peer ${peer.peer_device_id} unreachable`);
 			if (!pinned || !hasKey) issues.push(`peer ${peer.peer_device_id} not pinned`);
 		}
+		const mdnsActive = mdnsEnabled();
+		const mdnsSource = process.env.CODEMEM_SYNC_MDNS ? "env" : config.sync_mdns ? "config" : null;
+		const mdnsLabel = mdnsActive ? mdnsSource === "env" ? "enabled (env)" : "enabled (config)" : "disabled";
 		if (opts.json) {
 			console.log(JSON.stringify({
 				enabled: config.sync_enabled === true,
 				listen: `${syncHost}:${syncPort}`,
-				mdns: process.env.CODEMEM_SYNC_MDNS ? "env-configured" : "default/off",
+				mdns: mdnsLabel,
+				mdns_source: mdnsSource,
 				daemon: reachable ? "running" : "not running",
 				identity: device?.device_id ?? null,
 				daemon_error: daemonState?.last_error ?? null,
@@ -4924,7 +5006,7 @@ doctorCmd.action(async (opts) => {
 		console.log("Sync doctor");
 		console.log(`- Enabled: ${config.sync_enabled === true}`);
 		console.log(`- Listen: ${syncHost}:${syncPort}`);
-		console.log(`- mDNS: ${process.env.CODEMEM_SYNC_MDNS ? "env-configured" : "default/off"}`);
+		console.log(`- mDNS: ${mdnsLabel}`);
 		console.log(`- Daemon: ${reachable ? "running" : "not running"}`);
 		if (!device) console.log("- Identity: missing (run `codemem sync enable`)");
 		else console.log(`- Identity: ${device.device_id}`);
@@ -5417,6 +5499,7 @@ program.addCommand(dbCommand);
 program.addCommand(exportMemoriesCommand);
 program.addCommand(importMemoriesCommand);
 program.addCommand(statsCommand);
+program.addCommand(maintenanceCommand);
 program.addCommand(embedCommand);
 program.addCommand(recentCommand);
 program.addCommand(searchCommand);