common-memory-core 0.2.0

package/dist/cli/main.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { loadConfig } from "../config/config.js";
+import { runFlush } from "./flush-command.js";
+import { listProjects, registerProject, removeProject, retryJob, runtimeStatus, showMemory } from './operations.js';
+import { printStatus, runSetupWizard, runNetworkWizard, runTui, UserCancelled } from "./tui.js";
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    if ((command === '--version' || command === '-v') && !args.length) {
+        console.log(JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version);
+        return;
+    }
+    if (command === "--help" || command === "-h") {
+        console.log("Common Memory V2\n\ncommon-memory                         Interactive workbench (TTY only)\n  Overview / Memory / Projects & permissions / Integrations / Maintenance / Settings\n\nScriptable commands and direct wizard shortcuts:\ncommon-memory [config|status|flush|session-drain]\ncommon-memory config --network\ncommon-memory network-test\ncommon-memory show [--workspace <absolute-path>]\ncommon-memory import <file.md> [--workspace <absolute-path>] [--author user|agent|third_party|mixed|unknown] [--label <text>] [--no-wait]\ncommon-memory project register <root> <name>\ncommon-memory project list\ncommon-memory project remove <id>\ncommon-memory retry <job-id>\ncommon-memory mcp --client-id <id> [--capability relay|init|read]... [--workspace <absolute-path>]... [--global] [--accept-client-reported-user-turns]\ncommon-memory codex-hook --home <absolute-path>\ncommon-memory codex-config [--mode posix|windows-wsl --output <new-directory>] [--workspace <absolute-path>]...\ncommon-memory work-hook --home <absolute-path>\ncommon-memory work-config --mode posix|windows-wsl --output <absolute-directory> [--distro <name>] [--user <name>] [--bridge-path <Windows-path>]\ncommon-memory session-refresh --home <absolute-path> [--client codex|chatgpt-work]\ncommon-memory mcp-config [--wsl] [--distro <name>] [--user <name>] [--workspace <absolute-path>]...");
+        return;
+    }
+    if (command === 'work-config') {
+        (await import('./work-config.js')).runWorkConfig(args);
+        return;
+    }
+    if (command === 'work-hook') {
+        await (await import('./codex-hook.js')).runCodexHook(args, 'chatgpt-work');
+        return;
+    }
+    if (command === 'session-refresh') {
+        (await import('./codex-hook.js')).runSessionRefresh(args);
+        return;
+    }
+    if (command === "session-drain") {
+        await (await import("./session-drain.js")).runSessionDrain(args);
+        return;
+    }
+    if (command === "codex-hook") {
+        await (await import('./codex-hook.js')).runCodexHook(args);
+        return;
+    }
+    if (command === "codex-config") {
+        if (args.length) {
+            (await import('./work-config.js')).runWorkConfig(args, 'codex');
+            return;
+        }
+        if (!loadConfig())
+            throw new Error("Run common-memory config first");
+        process.stdout.write((await import('./codex-config.js')).renderCodexConfig());
+        return;
+    }
+    if (command === "mcp") {
+        await (await import('../mcp/stdio.js')).runMcp(args);
+        return;
+    }
+    if (command === "import") {
+        const config = loadConfig();
+        if (!config)
+            throw new Error("Run common-memory config first");
+        const { runImport } = await import('./import-command.js');
+        const { exitCode } = await runImport(config, args);
+        process.exitCode = exitCode;
+        return;
+    }
+    if (command === "mcp-config") {
+        const config = loadConfig();
+        if (!config)
+            throw new Error("Run common-memory config first");
+        const { parseMcpConfigArgs, renderMcpConfig } = await import('./mcp-config.js');
+        process.stdout.write(renderMcpConfig(config, parseMcpConfigArgs(args)));
+        return;
+    }
+    if (command === "show") {
+        // Same read path and authorization as MCP memory_read and the Pi extension: what consumers see.
+        const config = loadConfig();
+        if (!config)
+            throw new Error("Run common-memory config first");
+        if (args.length && !(args.length === 2 && args[0] === "--workspace"))
+            throw new TypeError("Unknown command or unexpected arguments; use --help");
+        showMemory(config, args[1]);
+        return;
+    }
+    if (command === "network-test" && !args.length) {
+        const config = loadConfig();
+        if (!config)
+            throw new Error("Run common-memory config first");
+        process.exitCode = await (await import("./network-test.js")).runNetworkTest(config);
+        return;
+    }
+    if (command === "config" && args.length === 1 && args[0] === "--network") {
+        await runNetworkWizard();
+        return;
+    }
+    if (command === undefined) {
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            console.log('Common Memory\n\nRun common-memory in an interactive terminal to open the workbench.\nUse common-memory --help for scriptable commands; no prompts were opened.');
+            return;
+        }
+        await runTui();
+        return;
+    }
+    if (command === "config" && !args.length) {
+        await runSetupWizard();
+        return;
+    }
+    if (command === "status" && !args.length) {
+        printStatus();
+        const config = loadConfig();
+        if (config) {
+            const status = runtimeStatus(config);
+            if (status)
+                console.log(JSON.stringify(status, null, 2));
+        }
+        return;
+    }
+    const config = loadConfig();
+    if (!config)
+        throw new Error("Run common-memory config first");
+    if (command === "flush" && !args.length) {
+        process.exitCode = await runFlush(config);
+        return;
+    }
+    if (command === "retry" && args.length === 1) {
+        retryJob(config, args[0]);
+        return;
+    }
+    if (command === "project") {
+        const [action, ...rest] = args;
+        if (action === "list" && !rest.length) {
+            console.log(JSON.stringify(listProjects(config), null, 2));
+            return;
+        }
+        if (action === "register" && rest.length === 2) {
+            console.log(JSON.stringify(registerProject(config, rest[0], rest[1]), null, 2));
+            console.log("Registration does not grant remote disclosure or write permission; configure project:<id> in each allowed scope list.");
+            return;
+        }
+        if (action === "remove" && rest.length === 1) {
+            console.log(removeProject(config, rest[0]) ? "Registration removed; Markdown retained" : "Project not registered");
+            return;
+        }
+    }
+    throw new TypeError("Unknown command or unexpected arguments; use --help");
+}
+try {
+    await main();
+}
+catch (error) {
+    if (error instanceof UserCancelled)
+        process.exitCode = 0;
+    else {
+        console.error(error instanceof Error ? error.message : "Common Memory failed");
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp-config.d.ts

@@ -0,0 +1,16 @@
+import { type CommonMemoryConfig } from "../config/config.js";
+export interface McpConfigOptions {
+    wsl: boolean;
+    distro?: string | undefined;
+    user?: string | undefined;
+    workspaces: string[];
+}
+export declare function parseMcpConfigArgs(args: string[]): McpConfigOptions;
+/**
+ * Print `config.toml` blocks for the Codex host (ChatGPT desktop init-only; Codex CLI read-only) that
+ * pin the exact runtime this process is using: node binary, built CLI entry, configuration directory
+ * and dataRoot. With `--wsl` the blocks are for a Windows host bridging into this WSL distribution
+ * and user through `wsl.exe`, so every host reads the one store this configuration owns.
+ */
+export declare function renderMcpConfig(config: CommonMemoryConfig, options: McpConfigOptions, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/cli/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,MAAM,WAAW,gBAAgB;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AAEhI,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAanE;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAoDnI"}

package/dist/cli/mcp-config.js

@@ -0,0 +1,108 @@
+import { runtimeLaunch } from './host-launch.js';
+import { realpathSync } from "node:fs";
+import { userInfo } from "node:os";
+import { isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { configDirectory } from "../config/config.js";
+import { ProjectRegistry } from "../v2/registry.js";
+export function parseMcpConfigArgs(args) {
+    const options = { wsl: false, workspaces: [] };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--wsl")
+            options.wsl = true;
+        else if (arg === "--distro" || arg === "--user" || arg === "--workspace") {
+            const value = args[++i];
+            if (value === undefined || value.startsWith("--"))
+                throw new TypeError(`${arg} requires a value`);
+            if (arg === "--distro")
+                options.distro = value;
+            else if (arg === "--user")
+                options.user = value;
+            else {
+                if (!isAbsolute(value))
+                    throw new TypeError("--workspace must be an absolute path");
+                options.workspaces.push(value);
+            }
+        }
+        else
+            throw new TypeError(`Unknown mcp-config option ${arg}`);
+    }
+    return options;
+}
+const toml = (value) => JSON.stringify(value);
+const list = (values) => `[${values.map(toml).join(", ")}]`;
+/**
+ * Print `config.toml` blocks for the Codex host (ChatGPT desktop init-only; Codex CLI read-only) that
+ * pin the exact runtime this process is using: node binary, built CLI entry, configuration directory
+ * and dataRoot. With `--wsl` the blocks are for a Windows host bridging into this WSL distribution
+ * and user through `wsl.exe`, so every host reads the one store this configuration owns.
+ */
+export function renderMcpConfig(config, options, env = process.env) {
+    const node = realpathSync(process.execPath);
+    // The entry the user actually ran (normally dist/cli/main.js), not a guessed install location.
+    const cli = realpathSync(process.argv[1] ?? fileURLToPath(new URL("./main.js", import.meta.url)));
+    const home = configDirectory(env);
+    const registry = new ProjectRegistry(config.dataRoot);
+    const workspaces = options.workspaces.map(workspace => {
+        let project;
+        try {
+            project = registry.resolve(workspace);
+        }
+        catch {
+            project = undefined;
+        }
+        if (!project)
+            throw new Error(`UNREGISTERED_WORKSPACE: ${workspace}`);
+        return { workspace: resolve(workspace), contextId: `project:${project.id}`, allowed: config.disclosure.allowedScopes.includes(`project:${project.id}`) };
+    });
+    const distro = options.distro ?? env.WSL_DISTRO_NAME;
+    const user = options.user ?? userInfo().username;
+    // The bridge embeds the Linux paths of this runtime; generated from Windows they would point at nothing.
+    if (options.wsl && process.platform !== "linux")
+        throw new Error("--wsl must run inside the WSL distribution that hosts Common Memory (Linux paths are embedded)");
+    if (options.wsl && !distro)
+        throw new Error("--wsl needs a distribution: run inside WSL or pass --distro <name>");
+    const launch = (clientId, capability, extra) => {
+        const inner = [cli, "mcp", "--client-id", clientId, "--capability", capability, "--global", ...extra];
+        const command = runtimeLaunch(options, env).command(inner.slice(1));
+        return `command = ${toml(command.command)}\nargs = ${list(command.args)}${command.env ? `\nenv = { COMMON_MEMORY_HOME = ${toml(home)} }` : ''}`;
+    };
+    const lines = [
+        `# Common Memory MCP configuration for the Codex host (ChatGPT desktop app, Codex CLI, IDE extension).`,
+        `# Generated ${new Date().toISOString()} by the runtime that owns this store; do not mix with another install.`,
+        `#   ${options.wsl ? `WSL distribution: ${distro}; Linux user: ${user}` : `Host: ${process.platform}`}`,
+        `#   Configuration directory (COMMON_MEMORY_HOME): ${home}`,
+        `#   dataRoot (canonical Markdown under <dataRoot>/memory): ${config.dataRoot}`,
+        `#   node: ${node}`,
+        `#   CLI entry: ${cli}`,
+        `# Every process below shares this one configuration authority and data; none of them is a resident service.`,
+        ...(options.wsl ? [`# Pi is supported when it runs inside the same WSL distribution; Windows-native Pi is not covered by this configuration.`] : []),
+        ``,
+        `# Desktop session with local Codex-host MCP access (including the observed Work-local session): Init only.`,
+        `# The host approval setting below covers non-read-only tools; approval does not verify imported claims.`,
+        `# Record materials actually visible to the agent; a product/mode name does not establish memory source or coverage.`,
+        `# This connection does not export all ChatGPT memory. Review the destination with common-memory show.`,
+        `[mcp_servers.common_memory_init]`,
+        launch("chatgpt-desktop", "init", []),
+        `default_tools_approval_mode = "approve"`,
+        ``,
+        `# Codex CLI: read only. The process registers only memory_read/memory_status; enabled_tools repeats that host-side.`,
+        `[mcp_servers.common_memory]`,
+        launch("codex-cli", "read", workspaces.flatMap(w => ["--workspace", w.workspace])),
+        `enabled_tools = ["memory_read", "memory_status"]`,
+        `default_tools_approval_mode = "auto"`,
+    ];
+    for (const w of workspaces)
+        if (!w.allowed)
+            lines.push(`# NOTE: ${w.contextId} (${w.workspace}) is registered but not in disclosure.allowedScopes; it will not be readable until authorized.`);
+    if (!config.disclosure.allowedScopes.includes("global"))
+        lines.push(`# NOTE: "global" is not in disclosure.allowedScopes; both processes above have no readable/importable global context until authorized.`);
+    if (!config.disclosure.allowedProvenance.includes("agent_observation"))
+        lines.push(`# NOTE: disclosure.allowedProvenance lacks "agent_observation"; memory_init will answer INIT_DISABLED until common-memory config allows "Agent-reported understanding".`);
+    if (options.wsl)
+        lines.push(``, `# Workspace paths above are WSL paths. A Windows path (C:\\...) is not a registered project; register the WSL path instead.`);
+    lines.push(``, `# Keep Codex CLI from seeing the init server: ~/.codex/memory-reader.config.toml with`, `#   [mcp_servers.common_memory_init]`, `#   enabled = false`, `# and run: codex --profile memory-reader`);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/cli/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../src/cli/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/cli/network-test.d.ts

@@ -0,0 +1,4 @@
+import type { CommonMemoryConfig } from '../config/config.js';
+/** Explicit small synthetic API probe. It opens neither the durable queue nor canonical storage. */
+export declare function runNetworkTest(config: CommonMemoryConfig, log?: (line: string) => void): Promise<number>;
+//# sourceMappingURL=network-test.d.ts.map

package/dist/cli/network-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-test.d.ts","sourceRoot":"","sources":["../../src/cli/network-test.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,oGAAoG;AACpG,wBAAsB,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3H"}

package/dist/cli/network-test.js

@@ -0,0 +1,28 @@
+import { createConfiguredMemoryModel, describeConfiguredNetwork } from '../config/runtime.js';
+import { MemoryModelError } from '../memory-manager/contracts/errors.js';
+/** Explicit small synthetic API probe. It opens neither the durable queue nor canonical storage. */
+export async function runNetworkTest(config, log = console.log) {
+    let model;
+    const controller = new AbortController();
+    const cancel = () => controller.abort();
+    process.on('SIGINT', cancel);
+    process.on('SIGTERM', cancel);
+    try {
+        log(JSON.stringify({ network: describeConfiguredNetwork(config), test: 'synthetic API request; no memory writes' }));
+        model = createConfiguredMemoryModel(config, process.env, { retry: { maxRetries: 0 } });
+        const result = await model.analyze({ prompt: 'Return exactly the JSON object {"ok":true}.', projection: { probe: 'Common Memory connection test; synthetic data only' }, schema: { type: 'object', properties: { ok: { type: 'boolean', enum: [true] } }, required: ['ok'], additionalProperties: false } }, { requestId: 'network-test', deadlineMs: 60000, signal: controller.signal });
+        const passed = result.kind === 'output' && result.body && typeof result.body === 'object' && 'ok' in result.body && result.body.ok === true;
+        log(JSON.stringify({ passed: Boolean(passed), providerResponded: true, validOutput: Boolean(passed), writerCommitTested: false }));
+        return passed ? 0 : 1;
+    }
+    catch (error) {
+        log(JSON.stringify({ passed: false, providerResponded: error instanceof MemoryModelError && error.diagnostic?.httpStatus !== undefined, ...(error instanceof MemoryModelError ? { code: error.code, diagnostic: error.diagnostic } : { code: 'CONFIGURATION' }) }));
+        return 1;
+    }
+    finally {
+        process.off('SIGINT', cancel);
+        process.off('SIGTERM', cancel);
+        await model?.close();
+    }
+}
+//# sourceMappingURL=network-test.js.map

package/dist/cli/network-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-test.js","sourceRoot":"","sources":["../../src/cli/network-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAE9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA0B,EAAE,MAA8B,OAAO,CAAC,GAAG;IACxG,IAAI,KAAiE,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAC,OAAO,EAAC,yBAAyB,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,yCAAyC,EAAC,CAAC,CAAC,CAAC;QAChH,KAAK,GAAG,2BAA2B,CAAC,MAAM,EAAC,OAAO,CAAC,GAAG,EAAC,EAAC,KAAK,EAAC,EAAC,UAAU,EAAC,CAAC,EAAC,EAAC,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAC,MAAM,EAAC,6CAA6C,EAAC,UAAU,EAAC,EAAC,KAAK,EAAC,oDAAoD,EAAC,EAAC,MAAM,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,UAAU,EAAC,EAAC,EAAE,EAAC,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,CAAC,IAAI,CAAC,EAAC,EAAC,EAAC,QAAQ,EAAC,CAAC,IAAI,CAAC,EAAC,oBAAoB,EAAC,KAAK,EAAC,EAAC,EAAE,EAAC,SAAS,EAAC,cAAc,EAAC,UAAU,EAAC,KAAK,EAAC,MAAM,EAAC,UAAU,CAAC,MAAM,EAAC,CAAC,CAAC;QACxV,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC;QAC5I,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,CAAC,EAAC,iBAAiB,EAAC,IAAI,EAAC,WAAW,EAAC,OAAO,CAAC,MAAM,CAAC,EAAC,kBAAkB,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC;QAC1H,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAC,MAAM,EAAC,KAAK,EAAC,iBAAiB,EAAC,KAAK,YAAY,gBAAgB,IAAI,KAAK,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,EAAC,GAAG,CAAC,KAAK,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,KAAK,CAAC,IAAI,EAAC,UAAU,EAAC,KAAK,CAAC,UAAU,EAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,eAAe,EAAC,CAAC,EAAC,CAAC,CAAC,CAAC;QACtP,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;IAAC,CAAC;AACpG,CAAC"}

package/dist/cli/operations.d.ts

@@ -0,0 +1,26 @@
+import type { CommonMemoryConfig } from '../config/config.js';
+/** CLI and TUI use identical scope selection. Reading never opens the queue. */
+export declare function memoryView(config: CommonMemoryConfig, workspace?: string): import("../v2/reader.js").MemoryView;
+export declare function showMemory(config: CommonMemoryConfig, workspace?: string, log?: (line: string) => void): void;
+/** Like the existing status command, opens existing RuntimeStore only; never initializes absent storage. */
+export declare function runtimeStatus(config: CommonMemoryConfig): {
+    sessions: {
+        closing: boolean;
+        complete: boolean;
+        pending: number;
+        failed: number;
+        batches: number;
+        id: string;
+    }[];
+    observations: {
+        [x: string]: string | number | null;
+    }[];
+    jobs: import("../v2/runtime.js").JobStatus[];
+    unbound: number;
+    quarantinedDeliveries: number;
+} | null;
+export declare function retryJob(config: CommonMemoryConfig, id: string): void;
+export declare function listProjects(config: CommonMemoryConfig): import("../v2/registry.js").ProjectRegistration[];
+export declare function registerProject(config: CommonMemoryConfig, root: string, name: string): import("../v2/registry.js").ProjectRegistration;
+export declare function removeProject(config: CommonMemoryConfig, id: string): boolean;
+//# sourceMappingURL=operations.d.ts.map

package/dist/cli/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/cli/operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO9D,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,wCAQxE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAG1H;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB;;;;;;;;;;;;;;;SASvD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAGrE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,qDAAyD;AAChH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mDAErF;AACD,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/dist/cli/operations.js

@@ -0,0 +1,55 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { ProjectRegistry } from '../v2/registry.js';
+import { withRepositoryLock } from '../v2/lock.js';
+import { RuntimeStore } from '../v2/runtime.js';
+import { SessionIngress } from '../v2/session.js';
+import { readAuthorizedMemory, renderMemoryView } from '../v2/reader.js';
+/** CLI and TUI use identical scope selection. Reading never opens the queue. */
+export function memoryView(config, workspace) {
+    const contexts = ['global'];
+    if (workspace !== undefined) {
+        const project = new ProjectRegistry(config.dataRoot).resolve(workspace);
+        if (!project)
+            throw new Error('Workspace is not registered');
+        contexts.push(`project:${project.id}`);
+    }
+    return readAuthorizedMemory({ dataRoot: config.dataRoot, contexts: contexts.filter(scope => config.disclosure.allowedScopes.includes(scope)) });
+}
+export function showMemory(config, workspace, log = console.log) {
+    log(`Memory files: ${join(config.dataRoot, 'memory')}`);
+    log(renderMemoryView(memoryView(config, workspace)));
+}
+/** Like the existing status command, opens existing RuntimeStore only; never initializes absent storage. */
+export function runtimeStatus(config) {
+    if (!existsSync(join(config.dataRoot, 'runtime.sqlite')))
+        return null;
+    const store = new RuntimeStore(config.dataRoot);
+    try {
+        const ingress = new SessionIngress(store, config.sessionCache);
+        const sessions = store.db.prepare('SELECT id FROM sessions ORDER BY rowid DESC').all()
+            .map(row => ({ id: String(row.id), ...ingress.status(String(row.id)) }));
+        return { ...store.status(), sessions };
+    }
+    finally {
+        store.close();
+    }
+}
+export function retryJob(config, id) {
+    const store = new RuntimeStore(config.dataRoot);
+    try {
+        store.retry(id);
+        store.requestFlush();
+    }
+    finally {
+        store.close();
+    }
+}
+export function listProjects(config) { return new ProjectRegistry(config.dataRoot).list(); }
+export function registerProject(config, root, name) {
+    return withRepositoryLock(config.dataRoot, () => new ProjectRegistry(config.dataRoot).register(root, name));
+}
+export function removeProject(config, id) {
+    return withRepositoryLock(config.dataRoot, () => new ProjectRegistry(config.dataRoot).remove(id));
+}
+//# sourceMappingURL=operations.js.map

package/dist/cli/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/cli/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,MAA0B,EAAE,SAAkB;IACvE,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,oBAAoB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AAClJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA0B,EAAE,SAAkB,EAAE,MAA8B,OAAO,CAAC,GAAG;IAClH,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxD,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,EAAE;aACnF,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;YAAS,CAAC;QAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAA0B,EAAE,EAAU;IAC7D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC;QAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,YAAY,EAAE,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B,IAAI,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChH,MAAM,UAAU,eAAe,CAAC,MAA0B,EAAE,IAAY,EAAE,IAAY;IACpF,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9G,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,EAAU;IAClE,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC"}

package/dist/cli/session-drain.d.ts

@@ -0,0 +1,3 @@
+export declare function launchSessionDrain(home?: string): number | undefined;
+export declare function runSessionDrain(args: string[]): Promise<void>;
+//# sourceMappingURL=session-drain.d.ts.map

package/dist/cli/session-drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-drain.d.ts","sourceRoot":"","sources":["../../src/cli/session-drain.ts"],"names":[],"mappings":"AAOA,wBAAgB,kBAAkB,CAAC,IAAI,SAAkB,GAAE,MAAM,GAAC,SAAS,CAK1E;AACD,wBAAsB,eAAe,CAAC,IAAI,EAAC,MAAM,EAAE,GAAE,OAAO,CAAC,IAAI,CAAC,CASjE"}

package/dist/cli/session-drain.js

@@ -0,0 +1,34 @@
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { join, isAbsolute } from 'node:path';
+import { loadConfig, configDirectory } from '../config/config.js';
+import { createConfiguredWriter } from '../config/runtime.js';
+import { drainSessions } from '../v2/session-drain.js';
+import { consumeCodexInbox } from './codex-session.js';
+export function launchSessionDrain(home = configDirectory()) {
+    const child = spawn(process.execPath, [fileURLToPath(new URL('./main.js', import.meta.url)), 'session-drain', '--home', home], { detached: true, stdio: 'ignore', env: { ...process.env, COMMON_MEMORY_HOME: home } });
+    child.on('error', () => process.stderr.write('[common-memory] consumer launch failed; run common-memory session-drain.\n'));
+    child.unref();
+    return child.pid;
+}
+export async function runSessionDrain(args) {
+    const home = args.length === 0 ? configDirectory() : args.length === 2 && args[0] === '--home' && isAbsolute(args[1]) ? args[1] : null;
+    if (!home)
+        throw new Error('session-drain requires --home <absolute-path>');
+    process.env.COMMON_MEMORY_HOME = home;
+    const config = loadConfig(join(home, 'config.json'));
+    if (!config)
+        throw new Error('UNCONFIGURED');
+    // Run sealed work between inbox admissions so completion watches do not delay maintenance.
+    const writer = createConfiguredWriter(config);
+    try {
+        await consumeCodexInbox(config, async () => { while ((await writer.run()).outcome !== 'idle' && writer.store.hasWork()) { /* next sealed batch */ } });
+        const complete = await drainSessions(writer);
+        if (!complete)
+            process.exitCode = 1;
+    }
+    finally {
+        await writer.close();
+    }
+}
+//# sourceMappingURL=session-drain.js.map

package/dist/cli/session-drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-drain.js","sourceRoot":"","sources":["../../src/cli/session-drain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAC,eAAe,EAAE;IACvD,MAAM,KAAK,GAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAC,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,eAAe,EAAC,QAAQ,EAAC,IAAI,CAAC,EAAC,EAAC,QAAQ,EAAC,IAAI,EAAC,KAAK,EAAC,QAAQ,EAAC,GAAG,EAAC,EAAC,GAAG,OAAO,CAAC,GAAG,EAAC,kBAAkB,EAAC,IAAI,EAAC,EAAC,CAAC,CAAC;IACpM,KAAK,CAAC,EAAE,CAAC,OAAO,EAAC,GAAE,EAAE,CAAA,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC,CAAC;IACzH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAa;IACjD,MAAM,IAAI,GAAC,IAAI,CAAC,MAAM,KAAG,CAAC,CAAA,CAAC,CAAA,eAAe,EAAE,CAAA,CAAC,CAAA,IAAI,CAAC,MAAM,KAAG,CAAC,IAAE,IAAI,CAAC,CAAC,CAAC,KAAG,QAAQ,IAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAA,CAAC,CAAA,IAAI,CAAC,CAAC,CAAE,CAAA,CAAC,CAAA,IAAI,CAAC;IACrH,IAAG,CAAC,IAAI;QAAC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAC,IAAI,CAAC;IACpC,MAAM,MAAM,GAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAC,aAAa,CAAC,CAAC,CAAC;IAAA,IAAG,CAAC,MAAM;QAAC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7F,2FAA2F;IAC3F,MAAM,MAAM,GAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC;QAAC,MAAM,iBAAiB,CAAC,MAAM,EAAC,KAAK,IAAE,EAAE,GAAC,OAAM,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,KAAG,MAAM,IAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QAAC,MAAM,QAAQ,GAAC,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAAC,IAAG,CAAC,QAAQ;YAAC,OAAO,CAAC,QAAQ,GAAC,CAAC,CAAC;IAAC,CAAC;YACxN,CAAC;QAAA,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAA,CAAC;AACjC,CAAC"}

package/dist/cli/storage-paths.d.ts

@@ -0,0 +1,4 @@
+import { type CommonMemoryConfig } from '../config/config.js';
+/** Read-only path diagnosis: neither realpath failure nor absent storage creates directories. */
+export declare function storagePathLines(config: CommonMemoryConfig): string[];
+//# sourceMappingURL=storage-paths.d.ts.map

package/dist/cli/storage-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-paths.d.ts","sourceRoot":"","sources":["../../src/cli/storage-paths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAGrE"}

package/dist/cli/storage-paths.js

@@ -0,0 +1,15 @@
+import { realpathSync } from 'node:fs';
+import { join } from 'node:path';
+import { configFilePath } from '../config/config.js';
+function actual(path) { try {
+    return realpathSync(path);
+}
+catch {
+    return `${path} (unresolved or not created)`;
+} }
+/** Read-only path diagnosis: neither realpath failure nor absent storage creates directories. */
+export function storagePathLines(config) {
+    const path = configFilePath(), memory = join(config.dataRoot, 'memory'), runtime = join(config.dataRoot, 'runtime.sqlite');
+    return [`Config: ${path}`, `Actual config: ${actual(path)}`, `Data: ${config.dataRoot}`, `Actual data: ${actual(config.dataRoot)}`, `Memory: ${actual(memory)}`, `Runtime: ${actual(runtime)}`];
+}
+//# sourceMappingURL=storage-paths.js.map

package/dist/cli/storage-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-paths.js","sourceRoot":"","sources":["../../src/cli/storage-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAC9E,SAAS,MAAM,CAAC,IAAY,IAAY,IAAI,CAAC;IAAC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,GAAG,IAAI,8BAA8B,CAAC;AAAC,CAAC,CAAC,CAAC;AACpI,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,MAAM,IAAI,GAAG,cAAc,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC3H,OAAO,CAAC,WAAW,IAAI,EAAE,EAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAC,SAAS,MAAM,CAAC,QAAQ,EAAE,EAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAC,WAAW,MAAM,CAAC,MAAM,CAAC,EAAE,EAAC,YAAY,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7L,CAAC"}

package/dist/cli/tui-integrations.d.ts

@@ -0,0 +1,4 @@
+import { type CommonMemoryConfig } from '../config/config.js';
+export declare function integrationReadiness(config: CommonMemoryConfig): string;
+export declare function integrationsScreen(): Promise<void>;
+//# sourceMappingURL=tui-integrations.d.ts.map

package/dist/cli/tui-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-integrations.d.ts","sourceRoot":"","sources":["../../src/cli/tui-integrations.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAW3F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAYvE;AAmFD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBxD"}