codemem 0.45.0-rc.2 → 0.46.0-alpha.1

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ContextOnlyReplayError, DEDUP_KEY_BACKFILL_JOB, DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, DeviceIdentityError, EXTRACTION_BENCHMARK_QUALITY_WEIGHTS, MUTATING_TOOL_NAMES, MemoryStore, ObserverClient, ObserverOutputError, ObserverOutputTransportError, PROMPT_TRANSPORT_PROTOCOL_RANGE, REF_BACKFILL_JOB, RawEventIngestValidationError, RawEventSweeper, RefBackfillRunner, SCOPE_BACKFILL_JOB, SESSION_CONTEXT_BACKFILL_JOB, SUMMARY_DEDUP_BACKFILL_JOB, ScopeBackfillRunner, SessionContextBackfillRunner, SummaryDedupBackfillRunner, SyncRetentionRunner, TRUSTED_HOOK_MAPPER_OPTIONS, VERSION, VectorModelMigrationRunner, aiBackfillStructuredContent, applyBootstrapSnapshot, applyDistillRule, arePromptTransportProtocolRangesCompatible, backfillMemoryDedupKeys, backfillNarrativeFromBody, backfillTagsText, backfillVectors, buildBaseUrl, buildDirectPeerAuthHeaders, buildDistillReport, buildRawEventEnvelopeFromCodexHook, buildRawEventEnvelopeFromHook, buildViewerIdentityTarget, classifyPromptTransportFailure, clonePromptPackAttempt, collectOperationalStatus, compareMemoryRoleReports, connect, connectReadOnly, coordinatorCreateGroupAction, coordinatorCreateInviteAction, coordinatorCreateScopeAction, coordinatorDisableDeviceAction, coordinatorEnrollDeviceAction, coordinatorGrantScopeMembershipAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorListDevicesAction, coordinatorListGroupsAction, coordinatorListJoinRequestsAction, coordinatorListScopeMembershipsAction, coordinatorListScopesAction, coordinatorRemoveDeviceAction, coordinatorRenameDeviceAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, coordinatorRevokeScopeMembershipAction, coordinatorUpdateScopeAction, createBetterSqliteCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, dedupNearDuplicateMemories, detectInstallKind, draftDistillRule, ensureDeviceIdentity, ensureSchemaBootstrapped, estimateExtractionModelCost, exportMemories, extractApplyPatchPaths, extractionReplayObserverIdentity, fetchAllSnapshotPages, fingerprintPublicKey, flushRawEvents, formatHostPort, getAttributionDiagnostics, getExtractionBenchmarkProfile, getExtractionModelPricing, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMaintenanceJob, getMemoryArtifactReport, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSemanticIndexDiagnostics, getSessionExtractionEval, getSessionExtractionEvalScenario, getUpdateStatus, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasPendingRefBackfill, hasPendingScopeBackfill, hasPendingSessionContextBackfill, hasPendingSummaryDedupBackfill, hasUnsyncedSharedMemoryChanges, importMemories, ingestRawEvents, initDatabase, isAutomaticRecallMeasurement, isEmbeddingDisabled, isExplicitUpdateInstallEligible, isReleaseVersionForChannel, judgeDistillReport, listMaintenanceJobs, listPerPeerScopeSyncState, listRetentionScopeIds, loadObserverConfig, loadPublicKey, loadSqliteVec, mdnsEnabled, normalizePromptTransportProtocolRange, planReplicationOpsAgePrune, probeCodememViewerLiveness, probeCodememViewerLiveness as probeCodememViewerLiveness$1, probeRequiredNativeRuntime, projectMatchesFilter, promptPackArtifactFingerprint, pruneReplicationOpsUntilCaughtUp, rawEventsGate, readCodememConfigFile, readCodememConfigFileAtPath, readCoordinatorSyncConfig, readImportPayload, recordAutomaticRecall, recordPromptPackArtifacts, recordPromptPackTerminal, recordRetrievalSurface, renderUnifiedDiff, replayBatchExtraction, replayBatchExtractionWithTierRouting, requestJson, resolveCodememConfigPath, resolveComparablePath, resolveDbPath, resolveHookProject, resolveProject, resolveProjectRoot, resolveRetrievalSession, retryRawEventFailures, runSyncDaemon, runSyncPass, scanSecretsRetroactive, schema, scoreExtractionBenchmarkOutput, setPeerProjectFilter, stripJsonComments, stripTrailingCommas, syncPassPreflight, tryUpdateRetrievalDelivery, updatePeerAddresses, vacuumDatabase, viewerUrl, writeCodememConfigFile } from "@codemem/core";
+import { ContextOnlyReplayError, DEDUP_KEY_BACKFILL_JOB, DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, DeviceIdentityError, EXTRACTION_BENCHMARK_QUALITY_WEIGHTS, MUTATING_TOOL_NAMES, MemoryStore, ObserverClient, ObserverOutputError, ObserverOutputTransportError, PROMPT_TRANSPORT_PROTOCOL_RANGE, REF_BACKFILL_JOB, RawEventIngestValidationError, RawEventSweeper, RefBackfillRunner, SCOPE_BACKFILL_JOB, SESSION_CONTEXT_BACKFILL_JOB, SUMMARY_DEDUP_BACKFILL_JOB, ScopeBackfillRunner, SessionContextBackfillRunner, SummaryDedupBackfillRunner, SyncRetentionRunner, TRUSTED_HOOK_MAPPER_OPTIONS, VERSION, VectorModelMigrationRunner, aiBackfillStructuredContent, applyBootstrapSnapshot, applyDistillRule, arePromptTransportProtocolRangesCompatible, backfillMemoryDedupKeys, backfillNarrativeFromBody, backfillTagsText, backfillVectors, buildBaseUrl, buildDirectPeerAuthHeaders, buildDistillReport, buildRawEventEnvelopeFromCodexHook, buildRawEventEnvelopeFromHook, buildViewerIdentityTarget, classifyPromptTransportFailure, clonePromptPackAttempt, collectOperationalStatus, compareMemoryRoleReports, connect, connectReadOnly, coordinatorCreateGroupAction, coordinatorCreateInviteAction, coordinatorCreateScopeAction, coordinatorDisableDeviceAction, coordinatorEnrollDeviceAction, coordinatorGrantScopeMembershipAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorListDevicesAction, coordinatorListGroupsAction, coordinatorListJoinRequestsAction, coordinatorListScopeMembershipsAction, coordinatorListScopesAction, coordinatorRemoveDeviceAction, coordinatorRenameDeviceAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, coordinatorRevokeScopeMembershipAction, coordinatorUpdateScopeAction, createBetterSqliteCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, dedupNearDuplicateMemories, detectInstallKind, draftDistillRule, ensureDeviceIdentity, ensureSchemaBootstrapped, estimateExtractionModelCost, exportMemories, extractApplyPatchPaths, extractionReplayObserverIdentity, fetchAllSnapshotPages, fingerprintPublicKey, flushRawEvents, formatHostPort, getAttributionDiagnostics, getCodememConfigPath, getExtractionBenchmarkProfile, getExtractionModelPricing, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMaintenanceJob, getMemoryArtifactReport, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSemanticIndexDiagnostics, getSessionExtractionEval, getSessionExtractionEvalScenario, getUpdateStatus, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasPendingRefBackfill, hasPendingScopeBackfill, hasPendingSessionContextBackfill, hasPendingSummaryDedupBackfill, hasUnsyncedSharedMemoryChanges, importMemories, ingestRawEvents, initDatabase, isAutomaticRecallMeasurement, isEmbeddingDisabled, isExplicitUpdateInstallEligible, isReleaseVersionForChannel, judgeDistillReport, listMaintenanceJobs, listPerPeerScopeSyncState, listRetentionScopeIds, loadObserverConfig, loadPublicKey, loadSqliteVec, mdnsEnabled, mutateCodememConfigFile, normalizePromptTransportProtocolRange, observerBaseUrlForProviderOverride, planReplicationOpsAgePrune, probeCodememViewerLiveness, probeCodememViewerLiveness as probeCodememViewerLiveness$1, probeRequiredNativeRuntime, projectMatchesFilter, promptPackArtifactFingerprint, pruneReplicationOpsUntilCaughtUp, rawEventsGate, readCodememConfigFile, readCodememConfigFileAtPath, readCoordinatorSyncConfig, readImportPayload, recordAutomaticRecall, recordPromptPackArtifacts, recordPromptPackTerminal, recordRetrievalSurface, renderUnifiedDiff, replayBatchExtraction, replayBatchExtractionWithTierRouting, requestJson, resolveCodememConfigPath, resolveComparablePath, resolveDbPath, resolveHookProject, resolveProject, resolveProjectRoot, resolveRetrievalSession, retryRawEventFailures, runSyncDaemon, runSyncPass, scanSecretsRetroactive, schema, scoreExtractionBenchmarkOutput, setPeerProjectFilter, stripJsonComments, stripTrailingCommas, syncPassPreflight, tryUpdateRetrievalDelivery, updatePeerAddresses, vacuumDatabase, viewerUrl } from "@codemem/core";
 import { Command, Option } from "commander";
 import omelette from "omelette";
 import { randomInt, randomUUID } from "node:crypto";
@@ -2343,7 +2343,6 @@ function runWorkspaceConfigCommand(opts) {
 	const workspaceId = opts.workspaceId;
 	if (!workspaceId) throw new Error("workspace-id is required");
 	const configPath = getWorkspaceCodememConfigPath(workspaceId);
-	const existingConfig = existsSync(configPath) ? readCodememConfigFileAtPath(configPath) : readCodememConfigFile();
 	const patch = buildWorkspaceConfigPatch({
 		workspaceId,
 		syncEnabled: opts.enableSync ? true : opts.disableSync ? false : void 0,
@@ -2355,10 +2354,11 @@ function runWorkspaceConfigCommand(opts) {
 		json: opts.json
 	});
 	if (Object.keys(patch).length === 0) throw new Error("Provide at least one config field to update");
-	const nextConfig = mergeWorkspaceConfig(existingConfig, patch);
+	const result = mutateCodememConfigFile((existingConfig) => mergeWorkspaceConfig(existingConfig, patch), configPath, { fallbackReadPath: getCodememConfigPath() });
+	const nextConfig = result.data;
 	return {
 		workspace_id: workspaceId,
-		config_path: writeCodememConfigFile(nextConfig, configPath),
+		config_path: result.path,
 		updated_keys: Object.keys(patch).sort(),
 		config: nextConfig
 	};
@@ -4187,6 +4187,21 @@ var enqueueCmd = new Command("enqueue-raw-event").configureHelp(helpStyle).descr
 addDbOption(enqueueCmd);
 var enqueueRawEventCommand = enqueueCmd.action((opts) => runEnqueueRawEvent(opts));
 //#endregion
+//#region src/top-level-alias.ts
+/**
+* True when the CLI process was invoked through the named top-level
+* compatibility alias (first non-flag token of the real argv). Forwarding
+* wrappers such as `memory export` re-parse the alias command with synthetic
+* argv, so this stays false for canonical invocations.
+*/
+function invokedAsTopLevelAlias(name, argv = process.argv.slice(2)) {
+	for (const token of argv) {
+		if (token === "--") return false;
+		if (!token.startsWith("-")) return token === name;
+	}
+	return false;
+}
+//#endregion
 //#region src/commands/export-memories.ts
 function expandUserPath(value) {
 	return value.startsWith("~/") ? join(homedir(), value.slice(2)) : value;
@@ -5395,6 +5410,13 @@ function summarizeExtractionBenchmarkAttempts(attempts, batches) {
 		})
 	};
 }
+function cliObserverProviderOverride(cfg, providerFlag) {
+	const observerProvider = providerFlag?.trim() || cfg.observerProvider;
+	return {
+		observerProvider,
+		observerBaseUrl: observerBaseUrlForProviderOverride(cfg, observerProvider || "")
+	};
+}
 function createMemoryExtractionBenchmarkCommand() {
 	const cmd = new Command("extraction-benchmark").configureHelp(helpStyle).description("Run the formal extraction replay benchmark set and print a cost/quality scoreboard").requiredOption("--benchmark <id>", "benchmark profile id").option("--observer-provider <provider>", "override observer provider for this benchmark run").option("--observer-model <model>", "override observer model for this benchmark run").option("--observer-tier-routing", "use replay-only benchmark-backed observer tier routing").option("--openai-responses", "use OpenAI Responses API for this benchmark run").option("--reasoning-effort <level>", "set OpenAI reasoning.effort for this benchmark run (responses path)").option("--reasoning-summary <mode>", "set OpenAI reasoning.summary for this benchmark run (responses path)").option("--max-output-tokens <n>", "override OpenAI max_output_tokens for this benchmark run (responses path)").option("--observer-temperature <value>", "override observer temperature for this benchmark run").option("--transcript-budget <chars>", "override replay transcript budget in characters for this benchmark run").option("--repetitions <n>", "run every benchmark batch 1-10 times to measure model stability", "1");
 	addDbOption(cmd);
@@ -5423,7 +5445,7 @@ function createMemoryExtractionBenchmarkCommand() {
 			const observerConfig = loadObserverConfig();
 			const observerConfigWithOverrides = {
 				...observerConfig,
-				observerProvider: opts.observerProvider?.trim() || observerConfig.observerProvider,
+				...cliObserverProviderOverride(observerConfig, opts.observerProvider),
 				observerModel: opts.observerModel?.trim() || observerConfig.observerModel,
 				observerTemperature: observerTemperature ?? observerConfig.observerTemperature,
 				observerOpenAIUseResponses: resolveOpenAIResponsesOverride(opts.openaiResponses, observerConfig.observerOpenAIUseResponses),
@@ -6792,6 +6814,19 @@ async function nativeRuntimeAllowsServeStart(invocation) {
 	process.exitCode = 1;
 	return false;
 }
+function createServeCoordinatorMaintenanceDependencies(server) {
+	return {
+		advancePendingProjectShares: (store, options) => server.advancePendingProjectSharesOperation(store, {
+			...options,
+			advanceOperation: server.advanceProjectShareOperation
+		}),
+		reconcileConfiguredCoordinatorEnrollment: server.reconcileConfiguredCoordinatorEnrollment,
+		reconcileRecipientPolicyProjects: (store, options) => server.reconcileRecipientPolicyProjectsOperation(store, {
+			...options,
+			effects: server.createRecipientPolicyReconcilerEffects(store)
+		})
+	};
+}
 async function runServeCoordinatorMaintenance(store, dependencies) {
 	const projectShares = await dependencies.advancePendingProjectShares(store, { limit: 3 });
 	const coordinatorEnrollment = await dependencies.reconcileConfiguredCoordinatorEnrollment(store);
@@ -6844,8 +6879,77 @@ async function startBackgroundViewer(invocation) {
 	p.intro("codemem viewer");
 	p.outro(`Viewer started in background (pid ${child.pid}) at http://${invocation.host}:${invocation.port}`);
 }
+function startRawEventProcessing(dbPath, store, observer, createInbox) {
+	const sweeper = new RawEventSweeper(store, { observer });
+	sweeper.start();
+	const queue = createInbox({
+		dbPath,
+		sweeper,
+		onDrainError: () => {
+			p.log.warn("Raw-event database ingestion is delayed; accepted events remain queued");
+		},
+		onDrainRecovered: () => {
+			p.log.info("Raw-event database ingestion recovered");
+		},
+		onCorruptEntries: (count) => {
+			p.log.error(`Raw-event queue contains ${count} corrupt retained entries`);
+		},
+		onBacklog: (pending, oldestAgeMs) => {
+			p.log.warn(`Raw-event queue backlog is sustained (${pending} pending, oldest ${Math.ceil(oldestAgeMs / 1e3)}s)`);
+		},
+		onBacklogRecovered: () => {
+			p.log.info("Raw-event queue backlog recovered");
+		}
+	});
+	queue.inbox.start();
+	const rawEventTarget = createRawEventTargetState(store);
+	return {
+		appOptions: {
+			rawEventInbox: queue.inbox,
+			rawEventTarget,
+			sweeper,
+			observer
+		},
+		stop: async () => {
+			rawEventTarget.stop();
+			await queue.stop();
+			await sweeper.stop();
+		}
+	};
+}
+function createRawEventTargetState(store) {
+	let hasCurrentIdentity = false;
+	let actorId = store.actorId;
+	let deviceId = store.deviceId;
+	const refreshCurrentIdentity = () => {
+		try {
+			hasCurrentIdentity = store.hasCurrentIdentity();
+		} catch {
+			hasCurrentIdentity = false;
+		}
+		actorId = store.actorId;
+		deviceId = store.deviceId;
+	};
+	refreshCurrentIdentity();
+	const stop = store.onIdentityChanged(refreshCurrentIdentity);
+	return {
+		dbPath: store.dbPath,
+		hasCurrentIdentity: () => {
+			if (!hasCurrentIdentity || actorId !== store.actorId || deviceId !== store.deviceId) return false;
+			try {
+				return store.hasCurrentConfiguredIdentity();
+			} catch {
+				return false;
+			}
+		},
+		stop
+	};
+}
 async function startForegroundViewer(invocation) {
-	const { advancePendingProjectShares, createApp, createSyncApp, closeStore, getStore, reconcileConfiguredCoordinatorEnrollment, reconcileRecipientPolicyProjects } = await import("@codemem/server");
+	const serverModule = await import("@codemem/server");
+	const { createApp, createSyncApp, closeStore, createViewerRawEventInbox, getStore } = serverModule;
+	const createRawEventInbox = createViewerRawEventInbox;
+	const coordinatorMaintenanceDependencies = createServeCoordinatorMaintenanceDependencies(serverModule);
 	const { serve } = await import("@hono/node-server");
 	if (invocation.dbPath) process.env.CODEMEM_DB = invocation.dbPath;
 	if (invocation.configPath) process.env.CODEMEM_CONFIG = invocation.configPath;
@@ -6869,8 +6973,7 @@ async function startForegroundViewer(invocation) {
 		store = getStore();
 		p.log.warn("Embeddings disabled for this viewer process; raw-event ingestion remains active.");
 	}
-	const sweeper = new RawEventSweeper(store, { observer });
-	sweeper.start();
+	const rawEventProcessing = startRawEventProcessing(dbPath, store, observer, createRawEventInbox);
 	const syncAbort = new AbortController();
 	const config = invocation.configPath ? readCodememConfigFileAtPath(invocation.configPath) : readCodememConfigFile();
 	const syncConfig = readCoordinatorSyncConfig(config);
@@ -6881,8 +6984,7 @@ async function startForegroundViewer(invocation) {
 	};
 	const appOpts = {
 		storeFactory: () => store,
-		sweeper,
-		observer,
+		...rawEventProcessing.appOptions,
 		getSyncRuntimeStatus: () => syncRuntimeStatus
 	};
 	const app = createApp(appOpts);
@@ -6933,11 +7035,7 @@ async function startForegroundViewer(invocation) {
 					signal: syncAbort.signal,
 					scanner: store.scanner,
 					onAfterCoordinatorRefresh: async () => {
-						await runServeCoordinatorMaintenance(store, {
-							advancePendingProjectShares,
-							reconcileConfiguredCoordinatorEnrollment,
-							reconcileRecipientPolicyProjects
-						});
+						await runServeCoordinatorMaintenance(store, coordinatorMaintenanceDependencies);
 					},
 					onPhaseChange: (phase) => {
 						if (phase === "running") {
@@ -6979,7 +7077,7 @@ async function startForegroundViewer(invocation) {
 			syncServer?.close(done);
 			server.close(done);
 		}).catch(() => {});
-		await sweeper.stop();
+		await rawEventProcessing.stop();
 		try {
 			rmSync(pidPath);
 		} catch {}
@@ -7735,6 +7833,17 @@ function fmtTokens(n) {
 	if (n >= 1e3) return `~${(n / 1e3).toFixed(0)}K`;
 	return `${n}`;
 }
+function formatUsageEvent(event, provenance) {
+	const parts = [`${event.event}: ${event.count.toLocaleString()}`];
+	if (event.tokens_read > 0) parts.push(`read ${fmtTokens(event.tokens_read)} tokens`);
+	if (event.tokens_saved > 0) parts.push(`est. saved ${fmtTokens(event.tokens_saved)} tokens`);
+	if (provenance?.measured_count) parts.push(`${provenance.measured_count} provider-measured`);
+	if (provenance?.estimated_count) parts.push(`${provenance.estimated_count} estimated`);
+	if (provenance?.unavailable_count) parts.push(`${provenance.unavailable_count} unavailable`);
+	if (provenance?.legacy_text_length_count) parts.push(`${provenance.legacy_text_length_count} legacy length excluded`);
+	if (provenance?.legacy_unclassified_count) parts.push(`${provenance.legacy_unclassified_count} legacy unclassified`);
+	return `  ${parts.join(", ")}`;
+}
 var statsCmd = new Command("stats").configureHelp(helpStyle).description("Show database statistics");
 addDbOption(statsCmd);
 addJsonOption(statsCmd);
@@ -7788,12 +7897,8 @@ var statsCommand = statsCmd.action((opts) => {
 			`Raw events:  ${db.raw_events.toLocaleString()}`
 		].join("\n"));
 		if (result.usage.events.length > 0) {
-			const lines = result.usage.events.map((e) => {
-				const parts = [`${e.event}: ${e.count.toLocaleString()}`];
-				if (e.tokens_read > 0) parts.push(`read ${fmtTokens(e.tokens_read)} tokens`);
-				if (e.tokens_saved > 0) parts.push(`est. saved ${fmtTokens(e.tokens_saved)} tokens`);
-				return `  ${parts.join(", ")}`;
-			});
+			const provenanceByEvent = new Map(result.usage.provenance.events.map((event) => [event.event, event]));
+			const lines = result.usage.events.map((event) => formatUsageEvent(event, provenanceByEvent.get(event.event)));
 			const t = result.usage.totals;
 			lines.push("");
 			lines.push(`  Total: ${t.events.toLocaleString()} events, read ${fmtTokens(t.tokens_read)} tokens, est. saved ${fmtTokens(t.tokens_saved)} tokens`);
@@ -8194,8 +8299,8 @@ function collectAdvertiseAddresses(explicitAddress, configuredHost, port, interf
 function readCliConfig(configPath) {
 	return configPath ? readCodememConfigFileAtPath(configPath) : readCodememConfigFile();
 }
-function writeCliConfig(config, configPath) {
-	return writeCodememConfigFile(config, configPath || void 0);
+function mutateCliConfig(mutator, configPath) {
+	return mutateCodememConfigFile(mutator, configPath || void 0).data;
 }
 function parseAttemptsLimit(value) {
 	if (!/^\d+$/.test(value.trim())) throw new Error(`Invalid --limit: ${value}`);
@@ -8819,14 +8924,15 @@ enableCmd.action((opts) => {
 	try {
 		const keysDir = process.env.CODEMEM_KEYS_DIR?.trim() || void 0;
 		const [deviceId, fingerprint] = ensureDeviceIdentity(store.db, { keysDir });
-		const config = readCliConfig(opts.config);
-		config.sync_enabled = true;
-		if (effectiveHost) config.sync_host = effectiveHost;
 		const syncPort = parsePositiveIntegerOption(effectivePort, "--sync-port");
 		const syncInterval = parsePositiveIntegerOption(opts.interval, "--interval");
-		if (syncPort != null) config.sync_port = syncPort;
-		if (syncInterval != null) config.sync_interval_s = syncInterval;
-		writeCliConfig(config, opts.config);
+		const config = mutateCliConfig((current) => {
+			current.sync_enabled = true;
+			if (effectiveHost) current.sync_host = effectiveHost;
+			if (syncPort != null) current.sync_port = syncPort;
+			if (syncInterval != null) current.sync_interval_s = syncInterval;
+			return current;
+		}, opts.config);
 		if (opts.json) {
 			console.log(JSON.stringify({
 				ok: true,
@@ -8863,9 +8969,17 @@ syncCommand.addCommand(enableCmd);
 var disableCmd = new Command("disable").configureHelp(helpStyle).description("Disable sync without deleting keys or peers");
 addConfigOption(disableCmd);
 disableCmd.action((opts) => {
-	const config = readCliConfig(opts.config);
-	config.sync_enabled = false;
-	writeCliConfig(config, opts.config);
+	try {
+		mutateCliConfig((config) => ({
+			...config,
+			sync_enabled: false
+		}), opts.config);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Failed to disable sync";
+		p.log.error(message);
+		process.exitCode = 1;
+		return;
+	}
 	p.intro("codemem sync disable");
 	p.outro("Sync disabled — restart `codemem serve` to take effect");
 });
@@ -9117,10 +9231,18 @@ syncCommand.addCommand(bootstrapCmd);
 var connectCmd = new Command("connect").configureHelp(helpStyle).description("Configure coordinator URL for cloud sync").argument("<url>", "coordinator URL (e.g. https://coordinator.example.com)").option("--group <group>", "sync group ID");
 addConfigOption(connectCmd);
 connectCmd.action((url, opts) => {
-	const config = readCliConfig(opts.config);
-	config.sync_coordinator_url = url.trim();
-	if (opts.group) config.sync_coordinator_group = opts.group.trim();
-	writeCliConfig(config, opts.config);
+	try {
+		mutateCliConfig((config) => {
+			config.sync_coordinator_url = url.trim();
+			if (opts.group) config.sync_coordinator_group = opts.group.trim();
+			return config;
+		}, opts.config);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Failed to configure coordinator sync";
+		p.log.error(message);
+		process.exitCode = 1;
+		return;
+	}
 	p.intro("codemem sync connect");
 	p.log.success(`Coordinator: ${url.trim()}`);
 	if (opts.group) p.log.info(`Group: ${opts.group.trim()}`);
@@ -9966,19 +10088,6 @@ var ROOT_COMPLETION_COMMANDS = [
 	"--help",
 	"--version"
 ];
-/**
-* True when the CLI process was invoked through the named top-level
-* compatibility alias (first non-flag token of the real argv). Forwarding
-* wrappers such as `memory export` re-parse the alias command with synthetic
-* argv, so this stays false for canonical invocations.
-*/
-function invokedAsTopLevelAlias(name, argv = process.argv.slice(2)) {
-	for (const token of argv) {
-		if (token === "--") return false;
-		if (!token.startsWith("-")) return token === name;
-	}
-	return false;
-}
 function registerMemoryGroupWrappers() {
 	if (memoryCommand.commands.some((command) => command.name() === "export")) return;
 	const forwardedTail = (subcommand) => {