@remnic/core 9.3.703 → 9.3.705

package/dist/{chunk-ZCEI242W.js → chunk-7L54YZUI.js}

@@ -12,13 +12,7 @@ import {
 } from "./chunk-HDDRVXX4.js";
 import {
   importSqlite
-} from "./chunk-AGNBY3VG.js";
-import {
-  exportJsonBundle
-} from "./chunk-UP6MOYCB.js";
-import {
-  exportSqlite
-} from "./chunk-7VFZTJ7K.js";
+} from "./chunk-APJQ6UEA.js";
 import {
   detectImportFormat
 } from "./chunk-OZKVVUJB.js";
@@ -27,38 +21,44 @@ import {
 } from "./chunk-2DL3OFLD.js";
 import {
   backupMemoryDir
-} from "./chunk-BXLOS5AJ.js";
+} from "./chunk-2NLLXCJG.js";
+import {
+  exportJsonBundle
+} from "./chunk-UP6MOYCB.js";
 import {
   exportMarkdownBundle
 } from "./chunk-765K3SAT.js";
+import {
+  exportSqlite
+} from "./chunk-7VFZTJ7K.js";
+import {
+  WebDavServer
+} from "./chunk-PYIFUBRK.js";
 import {
   buildReplayNormalizerRegistry,
   clampBatchSize,
   runReplay
 } from "./chunk-HOJZMQ4J.js";
+import {
+  rebuildObservations
+} from "./chunk-LZZNTPLR.js";
 import {
   TailscaleHelper
 } from "./chunk-EEC4PCG5.js";
 import {
-  WebDavServer
-} from "./chunk-PYIFUBRK.js";
+  archiveObservations
+} from "./chunk-WMWVO45V.js";
 import {
   migrateObservations
 } from "./chunk-D6RIFG4O.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-TGAHHCB6.js";
+} from "./chunk-BMKGG7GC.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-EOOVJK2U.js";
-import {
-  rebuildObservations
-} from "./chunk-LZZNTPLR.js";
-import {
-  archiveObservations
-} from "./chunk-WMWVO45V.js";
+} from "./chunk-2SYPOX45.js";
 import {
   getBulkImportSource,
   listBulkImportSources,
@@ -70,7 +70,7 @@ import {
 } from "./chunk-GQL52GQ5.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-IX72AAMZ.js";
+} from "./chunk-SY6WG6DB.js";
 import {
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
@@ -82,15 +82,6 @@ import {
 import {
   parseXrayCliOptions
 } from "./chunk-SFOAQQDJ.js";
-import {
-  collectPatternMemories,
-  explainPatternMemory,
-  parsePatternsExplainOptions,
-  parsePatternsListOptions,
-  parseStrictCliDate,
-  renderPatternExplain,
-  renderPatternsList
-} from "./chunk-3T74IZB3.js";
 import {
   runBenchmarkRecall,
   runOperatorConfigReview,
@@ -98,12 +89,21 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-NUIJEGVD.js";
+} from "./chunk-M5MWSG4S.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-JTKFZMZ7.js";
+} from "./chunk-BKBSE3BU.js";
+import {
+  collectPatternMemories,
+  explainPatternMemory,
+  parsePatternsExplainOptions,
+  parsePatternsListOptions,
+  parseStrictCliDate,
+  renderPatternExplain,
+  renderPatternsList
+} from "./chunk-3T74IZB3.js";
 import {
   GraphDashboardServer
 } from "./chunk-YNDLCWXS.js";
@@ -116,7 +116,7 @@ import {
 } from "./chunk-WIWPSQYU.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-MXEWQKM7.js";
+} from "./chunk-NFGJBEPT.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -130,7 +130,7 @@ import {
 } from "./chunk-QRDOSYOR.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-EYJD6KIO.js";
+} from "./chunk-Y4PMATX2.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -139,18 +139,18 @@ import {
 import {
   utcDayRange
 } from "./chunk-GY3SKOS4.js";
-import {
-  readRuntimePolicySnapshot,
-  sanitizeRuntimePolicyValues
-} from "./chunk-33JBK2XP.js";
 import {
   formatNamespaceMaintenanceHealthText
-} from "./chunk-EZR35XHX.js";
+} from "./chunk-LY4FJLPT.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
   planSessionRepair
 } from "./chunk-KFY3SGN7.js";
+import {
+  readRuntimePolicySnapshot,
+  sanitizeRuntimePolicyValues
+} from "./chunk-33JBK2XP.js";
 import {
   GITHUB_CONNECTOR_ID,
   GMAIL_CONNECTOR_ID,
@@ -183,15 +183,6 @@ import {
   runEvalStoredBaselineCiGate,
   validateEvalBenchmarkPack
 } from "./chunk-3PY7VHV7.js";
-import {
-  getCueAnchorStoreStatus
-} from "./chunk-FZZ2QTJI.js";
-import {
-  applyCommitmentLedgerLifecycle,
-  getCommitmentLedgerStatus,
-  recordCommitmentLedgerEntry,
-  transitionCommitmentLedgerEntryState
-} from "./chunk-LMDRGRJ2.js";
 import {
   buildConnectorRowsFromDefinitions,
   parseConnectorsListOptions,
@@ -201,6 +192,15 @@ import {
   renderConnectorsRunResult,
   runConnectorPollOnce
 } from "./chunk-OKTXM5H4.js";
+import {
+  getCueAnchorStoreStatus
+} from "./chunk-FZZ2QTJI.js";
+import {
+  applyCommitmentLedgerLifecycle,
+  getCommitmentLedgerStatus,
+  recordCommitmentLedgerEntry,
+  transitionCommitmentLedgerEntryState
+} from "./chunk-LMDRGRJ2.js";
 import {
   resolveNamespaceChildRoot
 } from "./chunk-3UXOZBHV.js";
@@ -215,16 +215,16 @@ import {
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-5VXVXJH6.js";
+} from "./chunk-GT4VBKM4.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-KC6TCAWV.js";
+} from "./chunk-HEHPVBWA.js";
 import {
   EngramAccessService
-} from "./chunk-OXEAMU42.js";
+} from "./chunk-JHAYR2JY.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -237,6 +237,12 @@ import {
   renderRecallExplain,
   renderXray
 } from "./chunk-WN4GHSDH.js";
+import {
+  listMemoryGovernanceRuns,
+  readMemoryGovernanceRunArtifact,
+  restoreMemoryGovernanceRun,
+  runMemoryGovernance
+} from "./chunk-ULVM34NP.js";
 import {
   getTrustZoneStoreStatus,
   promoteTrustZoneRecord,
@@ -246,17 +252,11 @@ import {
   getObjectiveStateStoreStatus
 } from "./chunk-6HMYUWXR.js";
 import {
-  listMemoryGovernanceRuns,
-  readMemoryGovernanceRunArtifact,
-  restoreMemoryGovernanceRun,
-  runMemoryGovernance
-} from "./chunk-MBUM2Y3L.js";
+  getCausalTrajectoryStoreStatus
+} from "./chunk-YI7RZO7Y.js";
 import {
   analyzeGraphHealth
-} from "./chunk-KF74X62T.js";
-import {
-  getCausalTrajectoryStoreStatus
-} from "./chunk-YN4ZT4CW.js";
+} from "./chunk-YGKUAX2B.js";
 import {
   assertPathInsideRoot
 } from "./chunk-5GPPACXK.js";
@@ -709,6 +709,352 @@ function formatRule(rule) {
   return parts.join(" ");
 }
 
+// src/cli/research-status-commands.ts
+function registerResearchStatusCommands(cmd, orchestrator) {
+  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) => {
+    const options = args[0] ?? {};
+    const result = await runTrustZoneDemoSeedCliCommand({
+      memoryDir: orchestrator.config.memoryDir,
+      trustZoneStoreDir: orchestrator.config.trustZoneStoreDir,
+      trustZonesEnabled: orchestrator.config.trustZonesEnabled,
+      scenario: typeof options.scenario === "string" ? options.scenario : void 0,
+      recordedAt: typeof options.recordedAt === "string" ? options.recordedAt : void 0,
+      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) => {
+    const query = typeof args[0] === "string" ? args[0] : "";
+    const options = args[1] ?? {};
+    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 : void 0
+    });
+    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) => {
+    const options = args[0] ?? {};
+    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 ?? ""),
+        target: String(options.target ?? ""),
+        decision: String(options.decision ?? ""),
+        outcome: String(options.outcome ?? ""),
+        utilityScore,
+        summary: String(options.summary ?? ""),
+        memoryIds: Array.isArray(options.memoryId) ? options.memoryId.map(String) : void 0,
+        entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
+        tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0
+      }
+    });
+    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) => {
+    const options = args[0] ?? {};
+    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");
+  });
+}
+
+// src/cli/creation-ledger-commands.ts
+function registerCreationLedgerCommands(cmd, orchestrator) {
+  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) => {
+    const options = args[0] ?? {};
+    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 ?? ""),
+        scope: String(options.scope ?? ""),
+        summary: String(options.summary ?? ""),
+        keyFacts: Array.isArray(options.keyFact) ? options.keyFact.map(String) : void 0,
+        nextActions: Array.isArray(options.nextAction) ? options.nextAction.map(String) : void 0,
+        riskFlags: Array.isArray(options.riskFlag) ? options.riskFlag.map(String) : void 0,
+        objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0,
+        workProductEntryRefs: Array.isArray(options.workProductEntryRef) ? options.workProductEntryRef.map(String) : void 0,
+        commitmentEntryRefs: Array.isArray(options.commitmentEntryRef) ? options.commitmentEntryRef.map(String) : void 0
+      }
+    });
+    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) => {
+    const options = args[0] ?? {};
+    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");
+  });
+  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) => {
+    const options = args[0] ?? {};
+    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 ?? ""),
+        kind: String(options.kind ?? ""),
+        state: String(options.state ?? ""),
+        scope: String(options.scope ?? ""),
+        summary: String(options.summary ?? ""),
+        dueAt: typeof options.dueAt === "string" ? options.dueAt : void 0,
+        tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0,
+        entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
+        workProductEntryRefs: Array.isArray(options.workProductEntryRef) ? options.workProductEntryRef.map(String) : void 0,
+        objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0
+      }
+    });
+    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) => {
+    const options = args[0] ?? {};
+    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 ?? ""),
+      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) => {
+    const options = args[0] ?? {};
+    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 : void 0
+    });
+    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) => {
+    const options = args[0] ?? {};
+    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 ?? ""),
+        kind: String(options.kind ?? ""),
+        action: String(options.entryAction ?? ""),
+        scope: String(options.scope ?? ""),
+        summary: String(options.summary ?? ""),
+        artifactPath: typeof options.artifactPath === "string" ? options.artifactPath : void 0,
+        tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0,
+        entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
+        objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0
+      }
+    });
+    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) => {
+    const query = typeof args[0] === "string" ? args[0] : "";
+    const options = args[1] ?? {};
+    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 : void 0
+    });
+    console.log(JSON.stringify(results, null, 2));
+    console.log("OK");
+  });
+}
+
 // src/training-export/converter.ts
 import { constants } from "fs";
 import { lstat, open, readdir, realpath } from "fs/promises";
@@ -3635,7 +3981,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           }
         }
         if (sourceArchive.endsWith(".enc")) {
-          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-YO5QJ6L3.js");
+          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-7FJQINUR.js");
           const encDetected = await isEncryptedCapsuleFile(sourceArchive).catch(() => true);
           if (encDetected) {
             throw new Error(
@@ -3798,7 +4144,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           const { parseExportBundle } = await import("./transfer/types.js");
           let decryptedBuf;
           try {
-            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-YO5QJ6L3.js");
+            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-7FJQINUR.js");
             decryptedBuf = await decryptCapsuleFileInMemory(archivePath, memoryDir);
           } catch (decErr) {
             const msg = decErr instanceof Error ? decErr.message : String(decErr);
@@ -4699,344 +5045,8 @@ ${doc.content}` : doc.content,
         }
         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) => {
-        const options = args[0] ?? {};
-        const result = await runTrustZoneDemoSeedCliCommand({
-          memoryDir: orchestrator.config.memoryDir,
-          trustZoneStoreDir: orchestrator.config.trustZoneStoreDir,
-          trustZonesEnabled: orchestrator.config.trustZonesEnabled,
-          scenario: typeof options.scenario === "string" ? options.scenario : void 0,
-          recordedAt: typeof options.recordedAt === "string" ? options.recordedAt : void 0,
-          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) => {
-        const query = typeof args[0] === "string" ? args[0] : "";
-        const options = args[1] ?? {};
-        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 : void 0
-        });
-        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) => {
-        const options = args[0] ?? {};
-        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 ?? ""),
-            target: String(options.target ?? ""),
-            decision: String(options.decision ?? ""),
-            outcome: String(options.outcome ?? ""),
-            utilityScore,
-            summary: String(options.summary ?? ""),
-            memoryIds: Array.isArray(options.memoryId) ? options.memoryId.map(String) : void 0,
-            entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
-            tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0
-          }
-        });
-        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) => {
-        const options = args[0] ?? {};
-        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) => {
-        const options = args[0] ?? {};
-        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 ?? ""),
-            scope: String(options.scope ?? ""),
-            summary: String(options.summary ?? ""),
-            keyFacts: Array.isArray(options.keyFact) ? options.keyFact.map(String) : void 0,
-            nextActions: Array.isArray(options.nextAction) ? options.nextAction.map(String) : void 0,
-            riskFlags: Array.isArray(options.riskFlag) ? options.riskFlag.map(String) : void 0,
-            objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0,
-            workProductEntryRefs: Array.isArray(options.workProductEntryRef) ? options.workProductEntryRef.map(String) : void 0,
-            commitmentEntryRefs: Array.isArray(options.commitmentEntryRef) ? options.commitmentEntryRef.map(String) : void 0
-          }
-        });
-        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) => {
-        const options = args[0] ?? {};
-        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");
-      });
-      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) => {
-        const options = args[0] ?? {};
-        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 ?? ""),
-            kind: String(options.kind ?? ""),
-            state: String(options.state ?? ""),
-            scope: String(options.scope ?? ""),
-            summary: String(options.summary ?? ""),
-            dueAt: typeof options.dueAt === "string" ? options.dueAt : void 0,
-            tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0,
-            entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
-            workProductEntryRefs: Array.isArray(options.workProductEntryRef) ? options.workProductEntryRef.map(String) : void 0,
-            objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0
-          }
-        });
-        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) => {
-        const options = args[0] ?? {};
-        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 ?? ""),
-          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) => {
-        const options = args[0] ?? {};
-        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 : void 0
-        });
-        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) => {
-        const options = args[0] ?? {};
-        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 ?? ""),
-            kind: String(options.kind ?? ""),
-            action: String(options.entryAction ?? ""),
-            scope: String(options.scope ?? ""),
-            summary: String(options.summary ?? ""),
-            artifactPath: typeof options.artifactPath === "string" ? options.artifactPath : void 0,
-            tags: Array.isArray(options.tag) ? options.tag.map(String) : void 0,
-            entityRefs: Array.isArray(options.entityRef) ? options.entityRef.map(String) : void 0,
-            objectiveStateSnapshotRefs: Array.isArray(options.objectiveStateSnapshotRef) ? options.objectiveStateSnapshotRef.map(String) : void 0
-          }
-        });
-        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) => {
-        const query = typeof args[0] === "string" ? args[0] : "";
-        const options = args[1] ?? {};
-        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 : void 0
-        });
-        console.log(JSON.stringify(results, null, 2));
-        console.log("OK");
-      });
+      registerResearchStatusCommands(cmd, orchestrator);
+      registerCreationLedgerCommands(cmd, orchestrator);
       cmd.command("trust-zone-promote").description("Dry-run or apply a trust-zone promotion with provenance enforcement").requiredOption("--record-id <recordId>", "Source trust-zone record id").requiredOption("--target-zone <targetZone>", "Promotion target zone (working|trusted)").requiredOption("--reason <reason>", "Human-readable promotion reason").option("--recorded-at <isoTimestamp>", "Promotion timestamp (defaults to now)").option("--summary <summary>", "Optional replacement summary for the promoted record").option("--dry-run", "Show the promotion plan without writing the promoted record").action(async (...args) => {
         const options = args[0] ?? {};
         const result = await runTrustZonePromoteCliCommand({
@@ -7146,7 +7156,7 @@ Legacy identity-anchor files are untouched. Verify the migration result`);
         }
         if (typeof options.trace === "string" && options.trace.length > 0) {
           const { replayTrace, parseSpeedFlag } = await import("./trace-ZFVRH4GO.js");
-          const { expandTildePath: expandTildePath2 } = await import("./path-X2K5XCHL.js");
+          const { expandTildePath: expandTildePath2 } = await import("./utils/path.js");
           const tracePath = expandTildePath2(options.trace);
           let speed;
           try {
@@ -7177,7 +7187,7 @@ Legacy identity-anchor files are untouched. Verify the migration result`);
         let recorder = null;
         if (typeof options.recordTrace === "string" && options.recordTrace.length > 0) {
           const { openTraceRecorder } = await import("./trace-ZFVRH4GO.js");
-          const { expandTildePath: expandTildePath2 } = await import("./path-X2K5XCHL.js");
+          const { expandTildePath: expandTildePath2 } = await import("./utils/path.js");
           recorder = await openTraceRecorder(
             expandTildePath2(options.recordTrace)
           );
@@ -7328,4 +7338,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-ZCEI242W.js.map
+//# sourceMappingURL=chunk-7L54YZUI.js.map