@remnic/core 9.3.702 → 9.3.704

package/src/cli.ts

@@ -7,6 +7,8 @@ import type { Orchestrator } from "./orchestrator.js";
 import { ThreadingManager } from "./threading.js";
 import { utcDayRange } from "./transcript.js";
 import { runWearablesCliCommand } from "./wearables/cli.js";
+import { registerResearchStatusCommands } from "./cli/research-status-commands.js";
+import { registerCreationLedgerCommands } from "./cli/creation-ledger-commands.js";
 import type {
   BehaviorSignalEvent,
   ContinuityIncidentRecord,
@@ -265,7 +267,7 @@ import {
   type LiveConnector,
 } from "./connectors/live/index.js";
 
-interface CliApi {
+export interface CliApi {
   registerCli(
     handler: (opts: { program: CliProgram }) => void,
     options: { commands: string[] },
@@ -281,11 +283,11 @@ type RegisterCliOptions = {
     | undefined;
 };
 
-interface CliProgram {
+export interface CliProgram {
   command(name: string): CliCommand;
 }
 
-interface CliCommand {
+export interface CliCommand {
   description(desc: string): CliCommand;
   option(
     flags: string,
@@ -6203,520 +6205,9 @@ export function registerCli(
           console.log("OK");
         });
 
-      cmd
-        .command("objective-state-status")
-        .description("Show objective-state store status, snapshot counts, and latest stored snapshot")
-        .action(async () => {
-          const status = await runObjectiveStateStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            objectiveStateStoreDir: orchestrator.config.objectiveStateStoreDir,
-            objectiveStateMemoryEnabled: orchestrator.config.objectiveStateMemoryEnabled,
-            objectiveStateSnapshotWritesEnabled: orchestrator.config.objectiveStateSnapshotWritesEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("causal-trajectory-status")
-        .description("Show causal-trajectory store status, record counts, and latest stored chain")
-        .action(async () => {
-          const status = await runCausalTrajectoryStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            causalTrajectoryStoreDir: orchestrator.config.causalTrajectoryStoreDir,
-            causalTrajectoryMemoryEnabled: orchestrator.config.causalTrajectoryMemoryEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("trust-zone-status")
-        .description("Show trust-zone store status, zoned record counts, and latest stored record")
-        .action(async () => {
-          const status = await runTrustZoneStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            trustZoneStoreDir: orchestrator.config.trustZoneStoreDir,
-            trustZonesEnabled: orchestrator.config.trustZonesEnabled,
-            quarantinePromotionEnabled: orchestrator.config.quarantinePromotionEnabled,
-            memoryPoisoningDefenseEnabled: orchestrator.config.memoryPoisoningDefenseEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("trust-zone-demo-seed")
-        .description("Explicitly seed an opt-in trust-zone demo dataset for buyer-facing walkthroughs")
-        .option("--scenario <scenario>", "Demo scenario id (default: enterprise-buyer-v1)")
-        .option("--recorded-at <isoTimestamp>", "Base ISO timestamp used to anchor demo records")
-        .option("--dry-run", "Preview the demo dataset without writing any trust-zone records")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const result = await runTrustZoneDemoSeedCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            trustZoneStoreDir: orchestrator.config.trustZoneStoreDir,
-            trustZonesEnabled: orchestrator.config.trustZonesEnabled,
-            scenario: typeof options.scenario === "string" ? options.scenario : undefined,
-            recordedAt: typeof options.recordedAt === "string" ? options.recordedAt : undefined,
-            dryRun: options.dryRun === true,
-          });
-          console.log(JSON.stringify(result, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("abstraction-node-status")
-        .description("Show abstraction-node store status, abstraction counts, and latest stored node")
-        .action(async () => {
-          const status = await runAbstractionNodeStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            abstractionNodeStoreDir: orchestrator.config.abstractionNodeStoreDir,
-            harmonicRetrievalEnabled: orchestrator.config.harmonicRetrievalEnabled,
-            abstractionAnchorsEnabled: orchestrator.config.abstractionAnchorsEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("cue-anchor-status")
-        .description("Show cue-anchor index status, anchor counts, and the latest stored cue anchor")
-        .action(async () => {
-          const status = await runCueAnchorStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            abstractionNodeStoreDir: orchestrator.config.abstractionNodeStoreDir,
-            harmonicRetrievalEnabled: orchestrator.config.harmonicRetrievalEnabled,
-            abstractionAnchorsEnabled: orchestrator.config.abstractionAnchorsEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("harmonic-search")
-        .description("Preview harmonic retrieval blending over abstraction nodes and cue anchors")
-        .argument("<query>", "Prompt-like query to evaluate against harmonic retrieval storage")
-        .option("--max-results <count>", "Maximum number of blended results to return", "3")
-        .option("--session-key <sessionKey>", "Optional session key for same-session tie-breaking")
-        .action(async (...args: unknown[]) => {
-          const query = typeof args[0] === "string" ? args[0] : "";
-          const options = (args[1] ?? {}) as Record<string, unknown>;
-          const maxResults = typeof options.maxResults === "string"
-            ? Number.parseInt(options.maxResults, 10)
-            : 3;
-          const results = await runHarmonicSearchCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            abstractionNodeStoreDir: orchestrator.config.abstractionNodeStoreDir,
-            harmonicRetrievalEnabled: orchestrator.config.harmonicRetrievalEnabled,
-            abstractionAnchorsEnabled: orchestrator.config.abstractionAnchorsEnabled,
-            query,
-            maxResults: Number.isFinite(maxResults) ? maxResults : 3,
-            sessionKey: typeof options.sessionKey === "string" ? options.sessionKey : undefined,
-          });
-          console.log(JSON.stringify(results, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("utility-status")
-        .description("Show utility-learning telemetry status, event counts, and the latest utility event")
-        .action(async () => {
-          const status = await runUtilityTelemetryStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            memoryUtilityLearningEnabled: orchestrator.config.memoryUtilityLearningEnabled,
-            promotionByOutcomeEnabled: orchestrator.config.promotionByOutcomeEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("utility-record")
-        .description("Record a utility-learning telemetry event when utility learning is enabled")
-        .requiredOption("--event-id <eventId>", "Utility telemetry event id")
-        .requiredOption("--recorded-at <recordedAt>", "ISO timestamp for the event")
-        .requiredOption("--session-key <sessionKey>", "Session key associated with the event")
-        .requiredOption("--source <source>", "Event source (cli|system|benchmark|tool_result)")
-        .requiredOption("--target <target>", "Telemetry target (promotion|ranking)")
-        .requiredOption("--decision <decision>", "Decision taken (promote|demote|hold|boost|suppress)")
-        .requiredOption("--outcome <outcome>", "Observed outcome (helpful|neutral|harmful)")
-        .requiredOption("--utility-score <utilityScore>", "Bounded utility score between -1 and 1")
-        .requiredOption("--summary <summary>", "Human-readable summary of the measured utility event")
-        .option("--memory-id <memoryId...>", "Memory ids linked to the utility event")
-        .option("--entity-ref <entityRef...>", "Entity refs linked to the utility event")
-        .option("--tag <tag...>", "Tags to attach to the utility event")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const utilityScore = typeof options.utilityScore === "string"
-            ? Number.parseFloat(options.utilityScore)
-            : Number.NaN;
-          const filePath = await runUtilityTelemetryRecordCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            memoryUtilityLearningEnabled: orchestrator.config.memoryUtilityLearningEnabled,
-            event: {
-              schemaVersion: 1,
-              eventId: String(options.eventId ?? ""),
-              recordedAt: String(options.recordedAt ?? ""),
-              sessionKey: String(options.sessionKey ?? ""),
-              source: String(options.source ?? "") as UtilityTelemetryEvent["source"],
-              target: String(options.target ?? "") as UtilityTelemetryEvent["target"],
-              decision: String(options.decision ?? "") as UtilityTelemetryEvent["decision"],
-              outcome: String(options.outcome ?? "") as UtilityTelemetryEvent["outcome"],
-              utilityScore,
-              summary: String(options.summary ?? ""),
-              memoryIds: Array.isArray(options.memoryId) ? options.memoryId.map(String) : undefined,
-              entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : undefined,
-              tags: Array.isArray(options.tag) ? options.tag.map(String) : undefined,
-            },
-          });
-          console.log(JSON.stringify({ wrote: filePath !== null, filePath }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("utility-learning-status")
-        .description("Show offline utility-learning snapshot status and learned weight counts")
-        .action(async () => {
-          const status = await runUtilityLearningStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            memoryUtilityLearningEnabled: orchestrator.config.memoryUtilityLearningEnabled,
-            promotionByOutcomeEnabled: orchestrator.config.promotionByOutcomeEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("utility-learn")
-        .description("Learn bounded offline promotion/ranking weights from recorded utility telemetry")
-        .option("--window-days <days>", "Telemetry lookback window in days", "14")
-        .option("--min-event-count <count>", "Minimum event count required per target/decision group", "3")
-        .option("--max-weight-magnitude <value>", "Maximum absolute learned weight magnitude", "0.35")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const learningWindowDays = typeof options.windowDays === "string"
-            ? Number.parseInt(options.windowDays, 10)
-            : 14;
-          const minEventCount = typeof options.minEventCount === "string"
-            ? Number.parseInt(options.minEventCount, 10)
-            : 3;
-          const maxWeightMagnitude = typeof options.maxWeightMagnitude === "string"
-            ? Number.parseFloat(options.maxWeightMagnitude)
-            : 0.35;
-          const result = await runUtilityLearningCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            memoryUtilityLearningEnabled: orchestrator.config.memoryUtilityLearningEnabled,
-            learningWindowDays,
-            minEventCount,
-            maxWeightMagnitude,
-          });
-          console.log(JSON.stringify(result, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("resume-bundle-status")
-        .description("Show resume bundle status, bundle counts, and the latest recorded handoff bundle")
-        .action(async () => {
-          const status = await runResumeBundleStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            resumeBundleDir: orchestrator.config.resumeBundleDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            resumeBundlesEnabled: orchestrator.config.resumeBundlesEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("resume-bundle-record")
-        .description("Record an explicit resume bundle when creation-memory handoff bundles are enabled")
-        .requiredOption("--bundle-id <bundleId>", "Resume bundle id")
-        .requiredOption("--recorded-at <recordedAt>", "ISO timestamp for the bundle")
-        .requiredOption("--session-key <sessionKey>", "Session key that owns the bundle")
-        .requiredOption("--source <source>", "Bundle source (tool_result|cli|system|manual)")
-        .requiredOption("--scope <scope>", "Primary scope or recovery domain for the bundle")
-        .requiredOption("--summary <summary>", "Human-readable summary of what this bundle preserves")
-        .option("--key-fact <keyFact...>", "Short facts that a resumed agent should retain")
-        .option("--next-action <nextAction...>", "Explicit next actions for the resumed agent")
-        .option("--risk-flag <riskFlag...>", "Open risks or cautions attached to the bundle")
-        .option(
-          "--objective-state-snapshot-ref <objectiveStateSnapshotRef...>",
-          "Objective-state snapshot refs attached to the bundle",
-        )
-        .option(
-          "--work-product-entry-ref <workProductEntryRef...>",
-          "Work-product ledger refs attached to the bundle",
-        )
-        .option(
-          "--commitment-entry-ref <commitmentEntryRef...>",
-          "Commitment ledger refs attached to the bundle",
-        )
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const filePath = await runResumeBundleRecordCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            resumeBundleDir: orchestrator.config.resumeBundleDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            resumeBundlesEnabled: orchestrator.config.resumeBundlesEnabled,
-            bundle: {
-              schemaVersion: 1,
-              bundleId: String(options.bundleId ?? ""),
-              recordedAt: String(options.recordedAt ?? ""),
-              sessionKey: String(options.sessionKey ?? ""),
-              source: String(options.source ?? "") as ResumeBundle["source"],
-              scope: String(options.scope ?? ""),
-              summary: String(options.summary ?? ""),
-              keyFacts: Array.isArray(options.keyFact) ? options.keyFact.map(String) : undefined,
-              nextActions: Array.isArray(options.nextAction) ? options.nextAction.map(String) : undefined,
-              riskFlags: Array.isArray(options.riskFlag) ? options.riskFlag.map(String) : undefined,
-              objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef)
-                ? options.objectiveStateSnapshotRef.map(String)
-                : undefined,
-              workProductEntryRefs: Array.isArray(options.workProductEntryRef)
-                ? options.workProductEntryRef.map(String)
-                : undefined,
-              commitmentEntryRefs: Array.isArray(options.commitmentEntryRef)
-                ? options.commitmentEntryRef.map(String)
-                : undefined,
-            },
-          });
-          console.log(JSON.stringify({ wrote: filePath !== null, filePath }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("resume-bundle-build")
-        .description("Build and persist a resume bundle from transcript recovery, objective state, work products, and open commitments")
-        .requiredOption("--bundle-id <bundleId>", "Resume bundle id")
-        .requiredOption("--recorded-at <recordedAt>", "ISO timestamp for the bundle")
-        .requiredOption("--session-key <sessionKey>", "Session key that owns the bundle")
-        .requiredOption("--scope <scope>", "Primary scope or recovery domain for the bundle")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const built = await runResumeBundleBuildCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            resumeBundleDir: orchestrator.config.resumeBundleDir,
-            objectiveStateStoreDir: orchestrator.config.objectiveStateStoreDir,
-            workProductLedgerDir: orchestrator.config.workProductLedgerDir,
-            commitmentLedgerDir: orchestrator.config.commitmentLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            resumeBundlesEnabled: orchestrator.config.resumeBundlesEnabled,
-            transcriptEnabled: orchestrator.config.transcriptEnabled,
-            objectiveStateMemoryEnabled: orchestrator.config.objectiveStateMemoryEnabled,
-            commitmentLedgerEnabled: orchestrator.config.commitmentLedgerEnabled,
-            bundleId: String(options.bundleId ?? ""),
-            recordedAt: String(options.recordedAt ?? ""),
-            sessionKey: String(options.sessionKey ?? ""),
-            scope: String(options.scope ?? ""),
-          });
-          console.log(JSON.stringify({
-            wrote: built !== null,
-            filePath: built?.filePath ?? null,
-            bundle: built?.bundle ?? null,
-          }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("commitment-status")
-        .description("Show commitment ledger status, entry counts, and the latest recorded commitment")
-        .action(async () => {
-          const status = await runCommitmentStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            commitmentLedgerDir: orchestrator.config.commitmentLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            commitmentLedgerEnabled: orchestrator.config.commitmentLedgerEnabled,
-            commitmentLifecycleEnabled: orchestrator.config.commitmentLifecycleEnabled,
-            commitmentStaleDays: orchestrator.config.commitmentStaleDays,
-            commitmentDecayDays: orchestrator.config.commitmentDecayDays,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
+      registerResearchStatusCommands(cmd, orchestrator);
 
-      cmd
-        .command("commitment-record")
-        .description("Record a commitment ledger entry when commitment memory is enabled")
-        .requiredOption("--entry-id <entryId>", "Commitment entry id")
-        .requiredOption("--recorded-at <recordedAt>", "ISO timestamp for the entry")
-        .requiredOption("--session-key <sessionKey>", "Session key that owns the commitment")
-        .requiredOption("--source <source>", "Entry source (tool_result|cli|system|manual)")
-        .requiredOption("--kind <kind>", "Entry kind (promise|follow_up|deadline|deliverable)")
-        .requiredOption("--state <state>", "Entry state (open|fulfilled|cancelled|expired)")
-        .requiredOption("--scope <scope>", "Primary scope or identifier for the commitment")
-        .requiredOption("--summary <summary>", "Human-readable summary of the commitment")
-        .option("--due-at <dueAt>", "Optional due timestamp for the commitment")
-        .option("--tag <tag...>", "Tags to attach to the commitment entry")
-        .option("--entity-ref <entityRef...>", "Entity refs to attach to the commitment entry")
-        .option(
-          "--work-product-entry-ref <workProductEntryRef...>",
-          "Work-product ledger refs that this commitment depends on",
-        )
-        .option(
-          "--objective-state-snapshot-ref <objectiveStateSnapshotRef...>",
-          "Objective-state snapshot refs to link to this commitment",
-        )
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const filePath = await runCommitmentRecordCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            commitmentLedgerDir: orchestrator.config.commitmentLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            commitmentLedgerEnabled: orchestrator.config.commitmentLedgerEnabled,
-            entry: {
-              schemaVersion: 1,
-              entryId: String(options.entryId ?? ""),
-              recordedAt: String(options.recordedAt ?? ""),
-              sessionKey: String(options.sessionKey ?? ""),
-              source: String(options.source ?? "") as CommitmentLedgerEntry["source"],
-              kind: String(options.kind ?? "") as CommitmentLedgerEntry["kind"],
-              state: String(options.state ?? "") as CommitmentLedgerEntry["state"],
-              scope: String(options.scope ?? ""),
-              summary: String(options.summary ?? ""),
-              dueAt: typeof options.dueAt === "string" ? options.dueAt : undefined,
-              tags: Array.isArray(options.tag) ? options.tag.map(String) : undefined,
-              entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : undefined,
-              workProductEntryRefs: Array.isArray(options.workProductEntryRef)
-                ? options.workProductEntryRef.map(String)
-                : undefined,
-              objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef)
-                ? options.objectiveStateSnapshotRef.map(String)
-                : undefined,
-            },
-          });
-          console.log(JSON.stringify({ wrote: filePath !== null, filePath }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("commitment-set-state")
-        .description("Transition an existing commitment ledger entry when commitment lifecycle is enabled")
-        .requiredOption("--entry-id <entryId>", "Commitment entry id")
-        .requiredOption("--state <state>", "Next state (open|fulfilled|cancelled|expired)")
-        .requiredOption("--changed-at <changedAt>", "ISO timestamp for the lifecycle transition")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const entry = await runCommitmentSetStateCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            commitmentLedgerDir: orchestrator.config.commitmentLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            commitmentLedgerEnabled: orchestrator.config.commitmentLedgerEnabled,
-            commitmentLifecycleEnabled: orchestrator.config.commitmentLifecycleEnabled,
-            entryId: String(options.entryId ?? ""),
-            nextState: String(options.state ?? "") as CommitmentLedgerEntry["state"],
-            changedAt: String(options.changedAt ?? ""),
-          });
-          console.log(JSON.stringify({ updated: entry !== null, entry }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("commitment-lifecycle-run")
-        .description("Apply overdue-expiry and resolved-entry cleanup to the commitment ledger")
-        .option("--now <now>", "Override the lifecycle timestamp for testing or backfills")
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const result = await runCommitmentLifecycleCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            commitmentLedgerDir: orchestrator.config.commitmentLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            commitmentLedgerEnabled: orchestrator.config.commitmentLedgerEnabled,
-            commitmentLifecycleEnabled: orchestrator.config.commitmentLifecycleEnabled,
-            commitmentDecayDays: orchestrator.config.commitmentDecayDays,
-            now: typeof options.now === "string" ? options.now : undefined,
-          });
-          console.log(JSON.stringify({ applied: result !== null, result }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("work-product-status")
-        .description("Show work-product ledger status, entry counts, and the latest recorded work product")
-        .action(async () => {
-          const status = await runWorkProductStatusCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            workProductLedgerDir: orchestrator.config.workProductLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-          });
-          console.log(JSON.stringify(status, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("work-product-record")
-        .description("Record a work-product ledger entry when creation-memory is enabled")
-        .requiredOption("--entry-id <entryId>", "Ledger entry id")
-        .requiredOption("--recorded-at <recordedAt>", "ISO timestamp for the entry")
-        .requiredOption("--session-key <sessionKey>", "Session key that created the work product")
-        .requiredOption("--source <source>", "Entry source (tool_result|cli|system|manual)")
-        .requiredOption("--kind <kind>", "Entry kind (artifact|file|record|report|workspace)")
-        .requiredOption(
-          "--entry-action <entryAction>",
-          "Entry action (created|updated|deleted|referenced|published)",
-        )
-        .requiredOption("--scope <scope>", "Primary scope or identifier for the created work product")
-        .requiredOption("--summary <summary>", "Human-readable summary of the work product")
-        .option("--artifact-path <artifactPath>", "Optional path to the created artifact")
-        .option("--tag <tag...>", "Tags to attach to the work-product entry")
-        .option("--entity-ref <entityRef...>", "Entity refs to attach to the work-product entry")
-        .option(
-          "--objective-state-snapshot-ref <objectiveStateSnapshotRef...>",
-          "Objective-state snapshot refs to link to this work product",
-        )
-        .action(async (...args: unknown[]) => {
-          const options = (args[0] ?? {}) as Record<string, unknown>;
-          const filePath = await runWorkProductRecordCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            workProductLedgerDir: orchestrator.config.workProductLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            entry: {
-              schemaVersion: 1,
-              entryId: String(options.entryId ?? ""),
-              recordedAt: String(options.recordedAt ?? ""),
-              sessionKey: String(options.sessionKey ?? ""),
-              source: String(options.source ?? "") as WorkProductLedgerEntry["source"],
-              kind: String(options.kind ?? "") as WorkProductLedgerEntry["kind"],
-              action: String(options.entryAction ?? "") as WorkProductLedgerEntry["action"],
-              scope: String(options.scope ?? ""),
-              summary: String(options.summary ?? ""),
-              artifactPath: typeof options.artifactPath === "string" ? options.artifactPath : undefined,
-              tags: Array.isArray(options.tag) ? options.tag.map(String) : undefined,
-              entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : undefined,
-              objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef)
-                ? options.objectiveStateSnapshotRef.map(String)
-                : undefined,
-            },
-          });
-          console.log(JSON.stringify({ wrote: filePath !== null, filePath }, null, 2));
-          console.log("OK");
-        });
-
-      cmd
-        .command("work-product-recall-search")
-        .description("Preview work-product recovery candidates when creation-memory recall is enabled")
-        .argument("<query>", "Prompt-like query to evaluate against the work-product ledger")
-        .option("--max-results <count>", "Maximum number of work-product results to return", "3")
-        .option("--session-key <sessionKey>", "Optional session key to boost same-session work products")
-        .action(async (...args: unknown[]) => {
-          const query = typeof args[0] === "string" ? args[0] : "";
-          const options = (args[1] ?? {}) as Record<string, unknown>;
-          const maxResults = typeof options.maxResults === "string"
-            ? Number.parseInt(options.maxResults, 10)
-            : 3;
-          const results = await runWorkProductRecallSearchCliCommand({
-            memoryDir: orchestrator.config.memoryDir,
-            workProductLedgerDir: orchestrator.config.workProductLedgerDir,
-            creationMemoryEnabled: orchestrator.config.creationMemoryEnabled,
-            workProductRecallEnabled: orchestrator.config.workProductRecallEnabled,
-            query,
-            maxResults: Number.isFinite(maxResults) ? maxResults : 3,
-            sessionKey: typeof options.sessionKey === "string" ? options.sessionKey : undefined,
-          });
-          console.log(JSON.stringify(results, null, 2));
-          console.log("OK");
-        });
+      registerCreationLedgerCommands(cmd, orchestrator);
 
       cmd
         .command("trust-zone-promote")