wotann 0.5.0 → 0.5.39

package/dist/cli/orphan-wires/integrations-cmd.js

@@ -0,0 +1,345 @@
+/**
+ * `wotann ow integrations <verb>` — integration manifest CLI surface.
+ *
+ * Wires the integration-manifest.ts library to a discoverable user
+ * surface so manifests can be loaded, listed, validated, derived to
+ * MCP tools / CLI commands, and invoked end-to-end.
+ *
+ * Verbs:
+ *   wotann ow integrations validate <manifest-file.json>
+ *     Parse + validate a manifest. Exit 0 if valid, 1 otherwise.
+ *
+ *   wotann ow integrations list [--registry <file>]
+ *     List all manifests in the named registry file (or built-in
+ *     example if --registry omitted).
+ *
+ *   wotann ow integrations actions <integration-name> [--registry <file>]
+ *     List actions for one integration. Includes input schema +
+ *     HTTP method + path template.
+ *
+ *   wotann ow integrations derive-mcp <integration-name> [--registry <file>]
+ *     Emit the MCP tool descriptors derived from the manifest. JSON.
+ *
+ *   wotann ow integrations derive-cli <integration-name> [--registry <file>]
+ *     Emit the CLI command bindings derived from the manifest. Text.
+ *
+ *   wotann ow integrations example
+ *     Print the bundled GitHub example manifest as JSON.
+ *
+ *   wotann ow integrations invoke <integration> <action> [--input <json>]
+ *                              [--registry <file>] [--credential <id>]
+ *                              [--broker-token-env <ENV>]
+ *     Invoke an action through the credential-broker. The broker
+ *     mints a bearer credential from the named env var (default
+ *     based on manifest auth.envVar) and signs the request.
+ */
+import { promises as fs } from "node:fs";
+import { EXAMPLE_GITHUB_MANIFEST, createIntegrationRegistry, deriveCliCommands, deriveMcpTools, renderPath, validateActionInput, validateManifest as validateIntegrationManifest, } from "../../integrations/integration-manifest.js";
+import { createCredentialBroker, mintFromEnv, } from "../../security/credential-broker.js";
+// ── Helpers ──────────────────────────────────────────────────────────
+async function loadRegistry(registryPath) {
+    const reg = createIntegrationRegistry();
+    if (!registryPath) {
+        reg.register(EXAMPLE_GITHUB_MANIFEST);
+        return { ok: true, registry: reg };
+    }
+    let raw;
+    try {
+        raw = await fs.readFile(registryPath, "utf8");
+    }
+    catch (err) {
+        return { ok: false, error: `cannot read ${registryPath}: ${err.message}` };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        return { ok: false, error: `parse: ${err.message}` };
+    }
+    if (!Array.isArray(parsed)) {
+        return { ok: false, error: "registry file must be a JSON array of manifests" };
+    }
+    for (const m of parsed) {
+        const r = reg.register(m);
+        if (!r.ok) {
+            return {
+                ok: false,
+                error: `manifest ${m.name ?? "?"} invalid: ${r.errors.join("; ")}`,
+            };
+        }
+    }
+    return { ok: true, registry: reg };
+}
+function exitWith(code) {
+    process.exit(code);
+}
+// ── Verb handlers ────────────────────────────────────────────────────
+async function runValidate(file) {
+    let raw;
+    try {
+        raw = await fs.readFile(file, "utf8");
+    }
+    catch (err) {
+        process.stderr.write(`Cannot read ${file}: ${err.message}\n`);
+        exitWith(2);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`JSON parse error: ${err.message}\n`);
+        exitWith(1);
+    }
+    const v = validateIntegrationManifest(manifest);
+    if (!v.ok) {
+        process.stderr.write(`INVALID:\n  - ${v.errors.join("\n  - ")}\n`);
+        exitWith(1);
+    }
+    process.stdout.write(`VALID: ${manifest.name}\n`);
+    exitWith(0);
+}
+async function runList(opts) {
+    const r = await loadRegistry(opts.registry);
+    if (!r.ok) {
+        process.stderr.write(`${r.error}\n`);
+        exitWith(2);
+    }
+    const list = r.registry.list();
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify(list, null, 2)}\n`);
+        exitWith(0);
+    }
+    process.stdout.write(`Integrations (${list.length}):\n`);
+    for (const m of list) {
+        process.stdout.write(`  ${m.name.padEnd(20)} ${m.displayName} — ${m.actions.length} actions\n`);
+    }
+    exitWith(0);
+}
+async function runActions(name, opts) {
+    const r = await loadRegistry(opts.registry);
+    if (!r.ok) {
+        process.stderr.write(`${r.error}\n`);
+        exitWith(2);
+    }
+    const m = r.registry.get(name);
+    if (!m) {
+        process.stderr.write(`integration "${name}" not found\n`);
+        exitWith(1);
+    }
+    process.stdout.write(`Actions for ${m.name} (${m.actions.length}):\n`);
+    for (const a of m.actions) {
+        process.stdout.write(`  ${a.id.padEnd(24)} ${a.method ?? "—"} ${a.pathTemplate ?? ""}\n`);
+        process.stdout.write(`     ${a.description}\n`);
+        for (const [pname, spec] of Object.entries(a.inputSchema)) {
+            process.stdout.write(`     - ${pname}: ${spec.type}${spec.required ? " *" : ""}\n`);
+        }
+    }
+    exitWith(0);
+}
+async function runDeriveMcp(name, opts) {
+    const r = await loadRegistry(opts.registry);
+    if (!r.ok) {
+        process.stderr.write(`${r.error}\n`);
+        exitWith(2);
+    }
+    const m = r.registry.get(name);
+    if (!m) {
+        process.stderr.write(`integration "${name}" not found\n`);
+        exitWith(1);
+    }
+    const tools = deriveMcpTools(m);
+    process.stdout.write(`${JSON.stringify(tools, null, 2)}\n`);
+    exitWith(0);
+}
+async function runDeriveCli(name, opts) {
+    const r = await loadRegistry(opts.registry);
+    if (!r.ok) {
+        process.stderr.write(`${r.error}\n`);
+        exitWith(2);
+    }
+    const m = r.registry.get(name);
+    if (!m) {
+        process.stderr.write(`integration "${name}" not found\n`);
+        exitWith(1);
+    }
+    const cmds = deriveCliCommands(m);
+    for (const c of cmds) {
+        process.stdout.write(`${c.verb}\n  ${c.description}\n`);
+        for (const o of c.options) {
+            process.stdout.write(`    ${o.flag}${o.required ? " (required)" : ""}\n`);
+        }
+    }
+    exitWith(0);
+}
+function runExample() {
+    process.stdout.write(`${JSON.stringify(EXAMPLE_GITHUB_MANIFEST, null, 2)}\n`);
+    exitWith(0);
+}
+async function runInvoke(integration, action, opts) {
+    const r = await loadRegistry(opts.registry);
+    if (!r.ok) {
+        process.stderr.write(`${r.error}\n`);
+        exitWith(2);
+    }
+    const m = r.registry.get(integration);
+    if (!m) {
+        process.stderr.write(`integration "${integration}" not found\n`);
+        exitWith(1);
+    }
+    if (m.transport.kind !== "http") {
+        process.stderr.write(`invoke is HTTP-only; manifest uses transport.kind=${m.transport.kind}\n`);
+        exitWith(1);
+    }
+    const actionSpec = m.actions.find((a) => a.id === action);
+    if (!actionSpec) {
+        process.stderr.write(`action "${action}" not found on integration "${integration}"\n`);
+        exitWith(1);
+    }
+    let input = {};
+    if (opts.input) {
+        try {
+            input = JSON.parse(opts.input);
+        }
+        catch (err) {
+            process.stderr.write(`--input JSON parse error: ${err.message}\n`);
+            exitWith(2);
+        }
+    }
+    const validation = validateActionInput(actionSpec, input);
+    if (!validation.ok) {
+        process.stderr.write(`input invalid:\n  - ${validation.errors.join("\n  - ")}\n`);
+        exitWith(1);
+    }
+    if (!actionSpec.pathTemplate) {
+        process.stderr.write(`action has no pathTemplate\n`);
+        exitWith(1);
+    }
+    const path = renderPath(actionSpec.pathTemplate, input);
+    if (!path.ok) {
+        process.stderr.write(`path render: ${path.error}\n`);
+        exitWith(1);
+    }
+    const broker = createCredentialBroker();
+    const credentialId = opts.credential ?? `${integration}-default`;
+    const envVar = opts.brokerTokenEnv ?? m.auth.envVar ?? "WOTANN_TOKEN";
+    const kind = m.auth.kind === "api-key" ? "api-key" : "bearer";
+    const minted = mintFromEnv({
+        broker,
+        id: credentialId,
+        envVar,
+        kind,
+        ...(m.auth.headerName ? { headerName: m.auth.headerName } : {}),
+    });
+    if (!minted.ok) {
+        process.stderr.write(`credential mint failed: ${minted.error}\n`);
+        exitWith(1);
+    }
+    const url = `${m.transport.baseUrl}${path.path}`;
+    const queryParams = actionSpec.queryParams ?? [];
+    const qs = [];
+    for (const q of queryParams) {
+        const v = input[q];
+        if (v !== undefined && v !== null) {
+            qs.push(`${encodeURIComponent(q)}=${encodeURIComponent(String(v))}`);
+        }
+    }
+    const fullUrl = qs.length > 0 ? `${url}?${qs.join("&")}` : url;
+    const bodyParams = {};
+    if (actionSpec.method && actionSpec.method !== "GET") {
+        for (const [name] of Object.entries(actionSpec.inputSchema)) {
+            if (queryParams.includes(name))
+                continue;
+            if (actionSpec.pathTemplate && actionSpec.pathTemplate.includes(`{${name}}`)) {
+                continue;
+            }
+            if (input[name] !== undefined)
+                bodyParams[name] = input[name];
+        }
+    }
+    const result = await broker.request({
+        url: fullUrl,
+        method: actionSpec.method ?? "GET",
+        credentialId,
+        ...(Object.keys(bodyParams).length > 0
+            ? {
+                body: JSON.stringify(bodyParams),
+                headers: { "content-type": "application/json" },
+            }
+            : {}),
+    });
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    }
+    else if (result.ok) {
+        process.stdout.write(`${result.status}\n${result.body}\n`);
+    }
+    else {
+        process.stderr.write(`${result.code}: ${result.error}\n`);
+    }
+    exitWith(result.ok ? 0 : 1);
+}
+// ── Registration ─────────────────────────────────────────────────────
+export function registerIntegrationsWire(parent) {
+    const cmd = parent
+        .command("integrations")
+        .description("Composio-style integration manifest registry");
+    cmd
+        .command("validate <file>")
+        .description("Validate a manifest JSON file")
+        .action(async (file) => {
+        await runValidate(file);
+    });
+    cmd
+        .command("list")
+        .description("List integrations in the registry")
+        .option("--registry <file>", "Registry JSON file (default: bundled GitHub example)")
+        .option("--json", "Emit as JSON", false)
+        .action(async (opts) => {
+        await runList(opts);
+    });
+    cmd
+        .command("actions <name>")
+        .description("List actions for one integration")
+        .option("--registry <file>")
+        .action(async (name, opts) => {
+        await runActions(name, opts);
+    });
+    cmd
+        .command("derive-mcp <name>")
+        .description("Derive MCP tool descriptors from a manifest")
+        .option("--registry <file>")
+        .action(async (name, opts) => {
+        await runDeriveMcp(name, opts);
+    });
+    cmd
+        .command("derive-cli <name>")
+        .description("Derive CLI verbs + options from a manifest")
+        .option("--registry <file>")
+        .action(async (name, opts) => {
+        await runDeriveCli(name, opts);
+    });
+    cmd
+        .command("example")
+        .description("Print the bundled GitHub example manifest")
+        .action(() => runExample());
+    cmd
+        .command("invoke <integration> <action>")
+        .description("Invoke an action via the credential broker")
+        .option("--input <json>", "Input JSON")
+        .option("--registry <file>")
+        .option("--credential <id>")
+        .option("--broker-token-env <ENV>", "Env var holding the bearer token")
+        .option("--json")
+        .action(async (integration, action, opts) => {
+        try {
+            await runInvoke(integration, action, opts);
+        }
+        catch (err) {
+            process.stderr.write(`invoke failed: ${err.message}\n`);
+            exitWith(1);
+        }
+    });
+}
+//# sourceMappingURL=integrations-cmd.js.map

package/dist/cli/orphan-wires/integrations-cmd.js.map

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

package/dist/cli/orphan-wires/mcp-scaffold-cmd.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `wotann ow mcp-scaffold <verb>` — Cline `add-a-tool` scaffolder CLI.
+ *
+ * Wires src/mcp/mcp-scaffolder.ts to a discoverable user surface —
+ * closes the partial-museum gap flagged by the deep audit.
+ *
+ * Verbs:
+ *   wotann ow mcp-scaffold from-json <file> [--out <dir>] [--dry-run]
+ *     Reads a ToolScaffoldRequest JSON file and generates the MCP
+ *     server scaffold (5 files: src/server.ts, package.json,
+ *     tsconfig.json, README.md, test/server.test.ts).
+ *
+ *   wotann ow mcp-scaffold example
+ *     Prints a sample ToolScaffoldRequest JSON to stdout.
+ */
+import type { Command } from "commander";
+export declare function registerMcpScaffoldWire(parent: Command): void;
+//# sourceMappingURL=mcp-scaffold-cmd.d.ts.map

package/dist/cli/orphan-wires/mcp-scaffold-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-scaffold-cmd.d.ts","sourceRoot":"","sources":["../../../src/cli/orphan-wires/mcp-scaffold-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqGzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAuB7D"}

package/dist/cli/orphan-wires/mcp-scaffold-cmd.js

@@ -0,0 +1,127 @@
+/**
+ * `wotann ow mcp-scaffold <verb>` — Cline `add-a-tool` scaffolder CLI.
+ *
+ * Wires src/mcp/mcp-scaffolder.ts to a discoverable user surface —
+ * closes the partial-museum gap flagged by the deep audit.
+ *
+ * Verbs:
+ *   wotann ow mcp-scaffold from-json <file> [--out <dir>] [--dry-run]
+ *     Reads a ToolScaffoldRequest JSON file and generates the MCP
+ *     server scaffold (5 files: src/server.ts, package.json,
+ *     tsconfig.json, README.md, test/server.test.ts).
+ *
+ *   wotann ow mcp-scaffold example
+ *     Prints a sample ToolScaffoldRequest JSON to stdout.
+ */
+import { promises as fs } from "node:fs";
+import { resolve } from "node:path";
+import { createNodeScaffoldFs, scaffoldMcpServer, validateScaffoldRequest, writeScaffold, } from "../../mcp/mcp-scaffolder.js";
+const EXAMPLE_REQUEST = {
+    name: "weather-mcp",
+    description: "MCP server for weather lookups",
+    transport: "stdio",
+    tools: [
+        {
+            name: "get_current_weather",
+            description: "Get the current weather for a city",
+            inputSchema: {
+                city: {
+                    type: "string",
+                    required: true,
+                    description: "City name",
+                },
+                units: {
+                    type: "string",
+                    required: false,
+                    description: "metric | imperial",
+                },
+            },
+            handlerStub: "// TODO: call weather API and return current conditions",
+        },
+        {
+            name: "get_forecast",
+            description: "5-day weather forecast for a city",
+            inputSchema: {
+                city: {
+                    type: "string",
+                    required: true,
+                },
+            },
+            handlerStub: "// TODO: call forecast API and return next 5 days",
+        },
+    ],
+};
+async function runFromJson(file, opts) {
+    let raw;
+    try {
+        raw = await fs.readFile(file, "utf8");
+    }
+    catch (err) {
+        process.stderr.write(`Cannot read ${file}: ${err.message}\n`);
+        process.exit(2);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`JSON parse error: ${err.message}\n`);
+        process.exit(2);
+    }
+    const validation = validateScaffoldRequest(parsed);
+    if (!validation.ok) {
+        process.stderr.write(`INVALID:\n  - ${validation.errors.join("\n  - ")}\n`);
+        process.exit(1);
+    }
+    const request = parsed;
+    const result = scaffoldMcpServer(request);
+    if (!result.ok) {
+        process.stderr.write(`scaffold error:\n  - ${result.errors.join("\n  - ")}\n`);
+        process.exit(1);
+    }
+    if (opts.dryRun) {
+        for (const file of result.files) {
+            process.stdout.write(`# ${file.path} (${file.content.length} bytes)\n`);
+        }
+        process.exit(0);
+    }
+    const outDir = resolve(opts.out ?? `./${request.name}`);
+    const nodeFs = await createNodeScaffoldFs();
+    const writeResult = await writeScaffold(result, outDir, nodeFs);
+    if (!writeResult.ok) {
+        process.stderr.write(`write failed: ${writeResult.error}\n`);
+        process.exit(1);
+    }
+    process.stdout.write(`Wrote ${writeResult.paths.length} files to ${outDir}\n`);
+    for (const path of writeResult.paths)
+        process.stdout.write(`  ${path}\n`);
+    process.exit(0);
+}
+function runExample() {
+    process.stdout.write(`${JSON.stringify(EXAMPLE_REQUEST, null, 2)}\n`);
+    process.exit(0);
+}
+export function registerMcpScaffoldWire(parent) {
+    const cmd = parent
+        .command("mcp-scaffold")
+        .description("Generate a complete MCP server scaffold from a typed request");
+    cmd
+        .command("from-json <file>")
+        .description("Read a ToolScaffoldRequest JSON file and generate the MCP server")
+        .option("--out <dir>", "Output directory (default: ./<name>)")
+        .option("--dry-run", "Print file list without writing", false)
+        .action(async (file, opts) => {
+        try {
+            await runFromJson(file, opts);
+        }
+        catch (err) {
+            process.stderr.write(`scaffold failed: ${err.message}\n`);
+            process.exit(1);
+        }
+    });
+    cmd
+        .command("example")
+        .description("Print a sample ToolScaffoldRequest JSON")
+        .action(() => runExample());
+}
+//# sourceMappingURL=mcp-scaffold-cmd.js.map

package/dist/cli/orphan-wires/mcp-scaffold-cmd.js.map

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

package/dist/cli/orphan-wires/memory-consolidate-cmd.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `wotann ow memory-consolidate <verb>` — Codex 2-phase memory pipeline CLI.
+ *
+ * Wires src/memory/two-phase-consolidator.ts to the user surface.
+ *
+ * Verbs:
+ *   wotann ow memory-consolidate extract <rollout.json>
+ *     Phase 1: read a rollout (array of RolloutTurn) from JSON, run
+ *     the heuristic extractor, print extracted facts as JSON.
+ *
+ *   wotann ow memory-consolidate consolidate <facts.json> [--prior <file>]
+ *     Phase 2: read facts (array) and optional prior memories, run
+ *     the dedup consolidator, print added/updated/dropped + final
+ *     merged set as JSON.
+ *
+ *   wotann ow memory-consolidate roundtrip <rollout.json> [--prior <file>]
+ *     Run both phases end-to-end through an in-memory store.
+ */
+import type { Command } from "commander";
+export declare function registerMemoryConsolidateWire(parent: Command): void;
+//# sourceMappingURL=memory-consolidate-cmd.d.ts.map

package/dist/cli/orphan-wires/memory-consolidate-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidate-cmd.d.ts","sourceRoot":"","sources":["../../../src/cli/orphan-wires/memory-consolidate-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEzC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAqBnE"}

package/dist/cli/orphan-wires/memory-consolidate-cmd.js

@@ -0,0 +1,86 @@
+/**
+ * `wotann ow memory-consolidate <verb>` — Codex 2-phase memory pipeline CLI.
+ *
+ * Wires src/memory/two-phase-consolidator.ts to the user surface.
+ *
+ * Verbs:
+ *   wotann ow memory-consolidate extract <rollout.json>
+ *     Phase 1: read a rollout (array of RolloutTurn) from JSON, run
+ *     the heuristic extractor, print extracted facts as JSON.
+ *
+ *   wotann ow memory-consolidate consolidate <facts.json> [--prior <file>]
+ *     Phase 2: read facts (array) and optional prior memories, run
+ *     the dedup consolidator, print added/updated/dropped + final
+ *     merged set as JSON.
+ *
+ *   wotann ow memory-consolidate roundtrip <rollout.json> [--prior <file>]
+ *     Run both phases end-to-end through an in-memory store.
+ */
+import { promises as fs } from "node:fs";
+import { createInMemoryStore, dedupConsolidator, heuristicExtractor, runPhaseOne, runPhaseTwo, } from "../../memory/two-phase-consolidator.js";
+async function readJson(path) {
+    try {
+        const raw = await fs.readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`Cannot read ${path}: ${err.message}\n`);
+        process.exit(2);
+    }
+}
+async function runExtract(file) {
+    const rollout = await readJson(file);
+    const facts = await heuristicExtractor(rollout);
+    process.stdout.write(`${JSON.stringify(facts, null, 2)}\n`);
+    process.exit(0);
+}
+async function runConsolidate(factsFile, opts) {
+    const facts = await readJson(factsFile);
+    const prior = opts.prior ? await readJson(opts.prior) : [];
+    const consolidator = dedupConsolidator();
+    const result = await consolidator(facts, prior);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    process.exit(0);
+}
+async function runRoundtrip(rolloutFile, opts) {
+    const rollout = await readJson(rolloutFile);
+    const store = createInMemoryStore();
+    if (opts.prior) {
+        const prior = await readJson(opts.prior);
+        await store.save(prior);
+    }
+    const phase1 = await runPhaseOne({ rollout, store });
+    const phase2 = await runPhaseTwo({ store });
+    process.stdout.write(`${JSON.stringify({
+        phase1: { extracted: phase1.extracted.length, durationMs: phase1.durationMs },
+        phase2: {
+            added: phase2.added.length,
+            updated: phase2.updated.length,
+            dropped: phase2.dropped.length,
+            totalAfter: phase2.totalAfter,
+            durationMs: phase2.durationMs,
+        },
+        memory: await store.loadAll(),
+    }, null, 2)}\n`);
+    process.exit(0);
+}
+export function registerMemoryConsolidateWire(parent) {
+    const cmd = parent
+        .command("memory-consolidate")
+        .description("Codex 2-phase memory consolidation (extract + consolidate)");
+    cmd
+        .command("extract <rollout>")
+        .description("Phase 1: extract facts from a rollout JSON")
+        .action(async (file) => runExtract(file));
+    cmd
+        .command("consolidate <facts>")
+        .description("Phase 2: consolidate facts (with optional prior)")
+        .option("--prior <file>", "Prior memory entries JSON")
+        .action(async (file, opts) => runConsolidate(file, opts));
+    cmd
+        .command("roundtrip <rollout>")
+        .description("Run both phases end-to-end through an in-memory store")
+        .option("--prior <file>", "Prior memory entries JSON")
+        .action(async (file, opts) => runRoundtrip(file, opts));
+}
+//# sourceMappingURL=memory-consolidate-cmd.js.map

package/dist/cli/orphan-wires/memory-consolidate-cmd.js.map

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