codemem 0.35.0 → 0.35.1

package/dist/index.js

@@ -2,14 +2,14 @@
 import { DEDUP_KEY_BACKFILL_JOB, DEFAULT_COORDINATOR_DB_PATH, DedupKeyBackfillRunner, MUTATING_TOOL_NAMES, MemoryStore, ObserverClient, REF_BACKFILL_JOB, RawEventSweeper, RefBackfillRunner, SCOPE_BACKFILL_JOB, SESSION_CONTEXT_BACKFILL_JOB, SUMMARY_DEDUP_BACKFILL_JOB, ScopeBackfillRunner, SessionContextBackfillRunner, SummaryDedupBackfillRunner, SyncRetentionRunner, VERSION, VectorModelMigrationRunner, aiBackfillStructuredContent, applyBootstrapSnapshot, backfillMemoryDedupKeys, backfillNarrativeFromBody, backfillTagsText, backfillVectors, buildAuthHeaders, buildBaseUrl, buildRawEventEnvelopeFromCodexHook, buildRawEventEnvelopeFromHook, compareMemoryRoleReports, connect, coordinatorCreateGroupAction, coordinatorCreateInviteAction, coordinatorCreateScopeAction, coordinatorDisableDeviceAction, coordinatorEnrollDeviceAction, coordinatorGrantScopeMembershipAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorListDevicesAction, coordinatorListGroupsAction, coordinatorListJoinRequestsAction, coordinatorListScopeMembershipsAction, coordinatorListScopesAction, coordinatorRemoveDeviceAction, coordinatorRenameDeviceAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, coordinatorRevokeScopeMembershipAction, coordinatorUpdateScopeAction, createBetterSqliteCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, dedupNearDuplicateMemories, ensureDeviceIdentity, ensureSchemaBootstrapped, exportMemories, extractApplyPatchPaths, fetchAllSnapshotPages, fingerprintPublicKey, flushRawEvents, formatHostPort, getExtractionBenchmarkProfile, getInjectionEvalScenarioPack, getInjectionEvalScenarioPrompts, getMaintenanceJob, getMemoryRoleReport, getRawEventRelinkPlan, getRawEventRelinkReport, getRawEventStatus, getSemanticIndexDiagnostics, getSessionExtractionEval, getSessionExtractionEvalScenario, getWorkspaceCodememConfigPath, hasPendingDedupKeyBackfill, hasPendingRefBackfill, hasPendingScopeBackfill, hasPendingSessionContextBackfill, hasPendingSummaryDedupBackfill, hasUnsyncedSharedMemoryChanges, importMemories, initDatabase, isEmbeddingDisabled, listMaintenanceJobs, listPerPeerScopeSyncState, loadObserverConfig, loadPublicKey, loadSqliteVec, mdnsEnabled, planReplicationOpsAgePrune, pruneReplicationOpsUntilCaughtUp, rawEventsGate, readCodememConfigFile, readCodememConfigFileAtPath, readCoordinatorSyncConfig, readImportPayload, replayBatchExtraction, replayBatchExtractionWithTierRouting, requestJson, resolveCodememConfigPath, resolveDbPath, resolveHookProject, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, scanSecretsRetroactive, 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";
+import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, networkInterfaces } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { styleText } from "node:util";
 import { randomInt, randomUUID } from "node:crypto";
 import * as p from "@clack/prompts";
 import { serve } from "@hono/node-server";
-import { spawn, spawnSync } from "node:child_process";
+import { execFileSync, spawn, spawnSync } from "node:child_process";
 import net from "node:net";
 import { desc, eq } from "drizzle-orm";
 import { drizzle } from "drizzle-orm/better-sqlite3";
@@ -5807,6 +5807,10 @@ function opencodeConfigDir() {
 function claudeConfigDir() {
 	return join(homedir(), ".claude");
 }
+/** Resolve the Codex home directory, honoring CODEX_HOME. */
+function codexConfigDir() {
+	return process.env.CODEX_HOME?.trim() || join(homedir(), ".codex");
+}
 /** The npm package name used in the OpenCode plugin array. */
 var OPENCODE_PLUGIN_SPEC = "@codemem/opencode-plugin";
 var LEGACY_OPENCODE_PLUGIN_SPECS = ["codemem", "@kunickiaj/codemem"];
@@ -5986,20 +5990,208 @@ function installClaudeMcp(force) {
 	} else p.log.info("Claude Code hooks plugin appears to be installed");
 	return true;
 }
-var setupCommand = new Command("setup").configureHelp(helpStyle).description("Install codemem plugin + MCP config for OpenCode and Claude Code").option("--force", "overwrite existing installations").option("--opencode-only", "only install for OpenCode").option("--claude-only", "only install for Claude Code").action((opts) => {
+/** The MCP server table appended to Codex config.toml. */
+var CODEX_MCP_BLOCK = [
+	"[mcp_servers.codemem]",
+	"command = \"npx\"",
+	"args = [\"-y\", \"codemem\", \"mcp\"]",
+	"startup_timeout_sec = 30",
+	"tool_timeout_sec = 60"
+].join("\n");
+var CODEX_MCP_TABLE_RE = /^[ \t]*\[[ \t]*mcp_servers[ \t]*\.[ \t]*("?)codemem\1[ \t]*\]/m;
+/** Marker substring identifying codemem-owned hook commands. */
+var CODEMEM_HOOK_MARKER = "codemem codex-hook-";
+/**
+* Resolve how Codex hooks should invoke codemem. Prefer a direct `codemem` call
+* when it's on PATH (fast — no per-hook resolution); fall back to `npx -y codemem`
+* only when codemem isn't installed (e.g. setup was run via `npx codemem setup`),
+* so capture/recall still work without a global install. Mirrors the plugin
+* wrapper's `codemem`-first / `npx` fallback model.
+*/
+function codememCodexHookBase() {
+	return codememOnPath() ? "codemem" : "npx -y codemem";
+}
+/**
+* Build the codemem-owned hook groups keyed by Codex event name, given the
+* resolved command base (`codemem` or `npx -y codemem`). Timeouts are ceilings,
+* not expected runtimes; npx gets more headroom to absorb a cold resolve.
+*/
+function buildCodememCodexHookGroups(base) {
+	const isNpx = base !== "codemem";
+	const ingestTimeout = isNpx ? 30 : 10;
+	const injectTimeout = isNpx ? 20 : 10;
+	const ingest = {
+		type: "command",
+		command: `${base} codex-hook-ingest`,
+		timeout: ingestTimeout,
+		statusMessage: "codemem"
+	};
+	return {
+		SessionStart: [{ hooks: [{ ...ingest }] }],
+		UserPromptSubmit: [{ hooks: [{
+			type: "command",
+			command: `${base} codex-hook-ingest`,
+			timeout: ingestTimeout,
+			statusMessage: "codemem capture"
+		}, {
+			type: "command",
+			command: `${base} codex-hook-inject`,
+			timeout: injectTimeout,
+			statusMessage: "codemem recall"
+		}] }],
+		PostToolUse: [{ hooks: [{ ...ingest }] }],
+		Stop: [{ hooks: [{ ...ingest }] }]
+	};
+}
+/** True if a matcher group contains a codemem-owned hook command. */
+function isCodememHookGroup(group) {
+	if (group == null || typeof group !== "object") return false;
+	const hooks = group.hooks;
+	if (!Array.isArray(hooks)) return false;
+	return hooks.some((h) => h != null && typeof h === "object" && typeof h.command === "string" && h.command.includes(CODEMEM_HOOK_MARKER));
+}
+/**
+* True if a resolved bin path is a transient npx/dlx cache bin. When setup runs
+* via `npx -y codemem setup --codex`, npx exposes this package's bin on PATH for
+* the duration of the run, then removes it — so Codex would later fail to find a
+* bare `codemem`. Such paths must NOT count as "on PATH" for hook command baking.
+*/
+function isTransientNpxBinPath(resolved) {
+	return /[/\\]_npx[/\\]/.test(resolved) || /[/\\]\.pnpm[/\\]dlx[/\\]/.test(resolved);
+}
+/**
+* Detect whether a durable `codemem` resolves on PATH (excluding a transient
+* npx/dlx bin that vanishes after this process exits).
+*/
+function codememOnPath() {
+	try {
+		const resolved = execFileSync(process.platform === "win32" ? "where" : "which", ["codemem"], { encoding: "utf-8" }).split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+		if (!resolved) return false;
+		return !isTransientNpxBinPath(resolved);
+	} catch {
+		return false;
+	}
+}
+/**
+* Append the codemem MCP server table to Codex config.toml without rewriting
+* unrelated content. Returns true on success.
+*/
+function installCodexMcp(codexHome, force) {
+	const configPath = join(codexHome, "config.toml");
+	const existing = existsSync(configPath) ? readFileSync(configPath, "utf-8") : "";
+	if (CODEX_MCP_TABLE_RE.test(existing)) {
+		if (force) p.log.info(`Codex MCP entry already exists in ${configPath} — left as-is (TOML is not rewritten in place)`);
+		else p.log.info(`Codex MCP entry already exists in ${configPath}`);
+		return true;
+	}
+	if (existsSync(configPath)) try {
+		copyFileSync(configPath, `${configPath}.codemem.bak`);
+	} catch {}
+	let next = existing;
+	if (next.length > 0 && !next.endsWith("\n\n")) next += next.endsWith("\n") ? "\n" : "\n\n";
+	next += `${CODEX_MCP_BLOCK}\n`;
+	try {
+		writeFileSync(configPath, next, "utf-8");
+		p.log.success(`Codex MCP entry installed: ${configPath}`);
+	} catch (err) {
+		p.log.error(`Failed to write ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+		return false;
+	}
+	return true;
+}
+/**
+* Write/merge codemem hook registrations into Codex hooks.json, preserving any
+* unrelated user hooks. Returns true on success.
+*/
+function installCodexHooks(codexHome, force) {
+	const hooksPath = join(codexHome, "hooks.json");
+	let config = {};
+	if (existsSync(hooksPath)) try {
+		config = JSON.parse(readFileSync(hooksPath, "utf-8"));
+	} catch (err) {
+		p.log.error(`Failed to parse ${hooksPath}: ${err instanceof Error ? err.message : String(err)}`);
+		p.log.info(`Leaving ${hooksPath} untouched. Fix or remove the file, then re-run \`codemem setup --codex-only\`.`);
+		return false;
+	}
+	let hooks = config.hooks;
+	if (hooks == null || typeof hooks !== "object" || Array.isArray(hooks)) hooks = {};
+	const ours = buildCodememCodexHookGroups(codememCodexHookBase());
+	let changed = false;
+	for (const [event, ourGroups] of Object.entries(ours)) {
+		const current = hooks[event];
+		const existingGroups = Array.isArray(current) ? [...current] : [];
+		if (existingGroups.some(isCodememHookGroup) && !force) continue;
+		const preserved = existingGroups.filter((g) => !isCodememHookGroup(g));
+		hooks[event] = [...preserved, ...ourGroups];
+		changed = true;
+	}
+	if (!changed && !force) {
+		p.log.info(`Codex hooks already configured in ${hooksPath}`);
+		config.hooks = hooks;
+		return true;
+	}
+	config.hooks = hooks;
+	if (existsSync(hooksPath)) try {
+		copyFileSync(hooksPath, `${hooksPath}.codemem.bak`);
+	} catch {}
+	try {
+		mkdirSync(codexHome, { recursive: true });
+		writeFileSync(hooksPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+		p.log.success(`Codex hooks installed: ${hooksPath}`);
+	} catch (err) {
+		p.log.error(`Failed to write ${hooksPath}: ${err instanceof Error ? err.message : String(err)}`);
+		return false;
+	}
+	return true;
+}
+/**
+* Configure Codex via direct config files (MCP in config.toml + hooks in
+* hooks.json) without relying on the Codex plugin marketplace. Idempotent;
+* honors CODEX_HOME. Returns true on success.
+*/
+function installCodex(force) {
+	const codexHome = codexConfigDir();
+	try {
+		mkdirSync(codexHome, { recursive: true });
+	} catch (err) {
+		p.log.error(`Failed to create Codex home ${codexHome}: ${err instanceof Error ? err.message : String(err)}`);
+		return false;
+	}
+	if (codememOnPath()) p.log.info("Codex hooks will call `codemem` directly (found on PATH).");
+	else p.log.info("`codemem` is not on PATH, so Codex hooks will run via `npx -y codemem` (works without a global install). For lower hook latency: npm i -g codemem");
+	let ok = true;
+	ok = installCodexMcp(codexHome, force) && ok;
+	ok = installCodexHooks(codexHome, force) && ok;
+	return ok;
+}
+var setupCommand = new Command("setup").configureHelp(helpStyle).description("Install codemem plugin + MCP config for OpenCode and Claude Code").option("--force", "overwrite existing installations").option("--opencode-only", "only install for OpenCode").option("--claude-only", "only install for Claude Code").option("--codex-only", "only install for Codex").option("--codex", "configure Codex only (alias for --codex-only)").action((opts) => {
 	p.intro(`codemem setup v${VERSION}`);
 	const force = opts.force ?? false;
 	let ok = true;
-	if (!opts.claudeOnly) {
+	const codexOnly = Boolean(opts.codexOnly || opts.codex);
+	const onlyFlag = Boolean(opts.opencodeOnly || opts.claudeOnly || codexOnly);
+	const doOpencode = opts.opencodeOnly || !onlyFlag;
+	const doClaude = opts.claudeOnly || !onlyFlag;
+	const doCodex = codexOnly || !onlyFlag && existsSync(codexConfigDir());
+	if (doOpencode) {
 		p.log.step("Installing OpenCode plugin...");
 		ok = installPlugin(force) && ok;
 		p.log.step("Installing OpenCode MCP config...");
 		ok = installMcp(force) && ok;
 	}
-	if (!opts.opencodeOnly) {
+	if (doClaude) {
 		p.log.step("Installing Claude Code MCP config...");
 		ok = installClaudeMcp(force) && ok;
 	}
+	if (doCodex) {
+		p.log.step("Configuring Codex (MCP + hooks)...");
+		ok = installCodex(force) && ok;
+		p.log.info("Codex next steps:");
+		p.log.info("  - Restart Codex to load the new configuration");
+		p.log.info("  - On first run, approve the one-time prompt to trust the codemem hooks");
+		p.log.info("  - MCP recall works immediately (no trust prompt required)");
+		p.log.info("  - Disable prompt-time injection with CODEMEM_INJECT_CONTEXT=0");
+	}
 	if (ok) p.outro("Setup complete — restart your editor to load the plugin");
 	else {
 		p.outro("Setup completed with warnings");