@remnic/core 9.3.703 → 9.3.704

package/dist/{types-MWKPZnM0.d.ts → types-CJrvHJjx.d.ts}

@@ -1,5 +1,5 @@
-import { c as ImportTurnProvenance } from './types-ByK7T3L6.js';
-import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-DJ9QWMw-.js';
+import { c as ImportTurnProvenance } from './types-gb_SNtjR.js';
+import { LcmMessagePartInput, MessagePartSourceFormat } from './message-parts/index.js';
 
 /**
  * Wearable transcript subsystem — shared types (issue: wearable connectors).

package/dist/{types-ByK7T3L6.d.ts → types-gb_SNtjR.d.ts}

@@ -1,4 +1,4 @@
-import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-DJ9QWMw-.js';
+import { LcmMessagePartInput, MessagePartSourceFormat } from './message-parts/index.js';
 
 interface BulkImportSource {
     turns: ImportTurn[];

package/dist/types.d.ts

@@ -1,3 +1,3 @@
-import './types-ByK7T3L6.js';
-import './index-DJ9QWMw-.js';
-export { au as AccessTrackingEntry, A as ActiveRecallChatType, d as ActiveRecallModelFallbackPolicy, b as ActiveRecallPromptStyle, a as ActiveRecallQueryMode, c as ActiveRecallThinking, J as AgentAccessAuthToken, b8 as AgentAccessHttpConfig, b9 as AgentDefaultsConfig, ba as AgentPersona, f as AgentPersonaModelConfig, bb as BehaviorLoopAdjustment, e as BehaviorLoopPolicyState, bc as BehaviorSignalDirection, B as BehaviorSignalEvent, bd as BehaviorSignalType, aH as BootstrapOptions, aI as BootstrapResult, r as BriefingActiveThread, be as BriefingCalendarSourceError, aU as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aV as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aW as BriefingWindow, bf as BufferEntryState, ap as BufferState, z as BufferSurpriseEvent, u as BufferTurn, q as CalendarEvent, C as CalendarSource, bg as CaptureMode, v as Checkpoint, bh as CodexCliReasoningEffort, bi as CodexCompactionFlushMode, aX as CodexCompatConfig, bj as CodexConnectorConfig, aG as CodingContext, bk as CodingKnowledgeConfig, aR as CodingModeConfig, bl as CompressionGuidelineActivationState, N as CompressionGuidelineOptimizerActionSummary, K as CompressionGuidelineOptimizerEventCounts, O as CompressionGuidelineOptimizerRuleUpdate, bm as CompressionGuidelineOptimizerSourceWindow, X as CompressionGuidelineOptimizerState, bn as ConfidenceTier, bo as ConsolidationAction, bp as ConsolidationItem, aJ as ConsolidationObservation, a1 as ConsolidationResult, a6 as ContinuityImprovementLoop, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, bq as ContinuityIncidentState, br as ContinuityLoopCadence, a7 as ContinuityLoopReviewInput, bs as ContinuityLoopStatus, a8 as ContinuityLoopUpsertInput, bt as ContradictionScanConfig, am as ConversationThread, bu as CronConversationRecallMode, bv as CronRecallMode, aY as DEFAULT_RECALL_DISCLOSURE, a2 as DaySummaryResult, bw as DreamingConfig, bx as DreamingNarrativePromptStyle, by as DreamsDeepSleepConfig, bz as DreamsLightSleepConfig, aP as DreamsPhase, bA as DreamsPhaseStatus, bB as DreamsPhasesConfig, bC as DreamsRemConfig, aQ as DreamsRunResult, aO as DreamsStatusResult, bD as EngramTraceEvent, at as EntityActivityEntry, E as EntityFile, Y as EntityMention, as as EntityRelationship, Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection, aK as EntityTimelineEntry, aZ as ExtractedFact, bE as ExtractedProcedureStep, bF as ExtractedQuestion, bG as ExtractedReasoningTrace, bH as ExtractedReasoningTraceStep, bI as ExtractedRelationship, bJ as ExtractionPassSource, a0 as ExtractionResult, F as FaithfulnessFrontmatter, ar as FileHygieneConfig, G as GatewayConfig, bK as GitHubLiveConnectorConfig, bL as GmailLiveConnectorConfig, bM as GoogleDriveLiveConnectorConfig, bN as HeartbeatConfig, bO as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, y as ImportanceLevel, a9 as ImportanceScore, w as LifecycleState, L as LiveConnectorsConfig, bP as LlmTraceCallback, bQ as LlmTraceEvent, ac as MemoryActionEligibilityContext, a_ as MemoryActionEligibilitySource, W as MemoryActionEvent, bR as MemoryActionOutcome, bS as MemoryActionPolicyDecision, ad as MemoryActionPolicyResult, bT as MemoryActionStatus, U as MemoryActionType, M as MemoryCategory, g as MemoryFile, k as MemoryFrontmatter, aa as MemoryIntent, m as MemoryLifecycleEvent, ae as MemoryLifecycleEventType, af as MemoryLifecycleStateSummary, ao as MemoryLink, bU as MemoryLinkType, a$ as MemoryObservation, bV as MemoryOsPresetName, l as MemoryProjectionCurrentState, b0 as MemoryScope, h as MemoryStatus, av as MemorySummary, aq as MetaState, bW as ModelApi, bX as ModelDefinitionConfig, bY as ModelProviderAuthMode, ag as ModelProviderConfig, bZ as NamespacePolicy, ah as NativeKnowledgeConfig, b_ as NativeKnowledgeFolderRuleConfig, b$ as NativeKnowledgeObsidianVaultConfig, c0 as NativeKnowledgeOpenClawWorkspaceConfig, c1 as NotionLiveConnectorConfig, P as PluginConfig, x as PolicyClass, c2 as PrincipalFromSessionKeyMode, c3 as PrincipalRule, c4 as ProceduralConfig, aj as ProvenanceConfig, ai as ProvenanceSource, ab as QmdSearchExplain, Q as QmdSearchResult, c5 as QuestionEntry, b1 as RECALL_DISCLOSURE_LEVELS, c6 as ReasoningEffort, j as RecallDisclosure, c7 as RecallPipelineConfig, i as RecallPlanMode, c8 as RecallSectionConfig, R as RecallTierExplain, c9 as RecallTraceEvent, ca as RelevanceFeedback, ak as RetrievalTier, cb as SPECULATIVE_TTL_DAYS, cc as ScopeProfileAutoPromoteConfig, aN as ScopeProfileConfig, aL as ScopeProfileLayerId, aM as ScopeProfilePromotionTarget, cd as ScopeProfileTeamProjectConfig, ce as ScopeTeamConfig, cf as ScoredEntity, D as SecretRef, cg as SemanticChunkingConfigShape, S as SessionObserverBandConfig, ch as SignalLevel, al as SignalScanResult, ci as SlotBehaviorConfig, cj as SlotMismatchMode, an as TopicScore, T as TranscriptEntry, ck as TriggerMode, V as VerificationState, cl as confidenceTier, b7 as isRecallDisclosure } from './types-MWKPZnM0.js';
+import './types-gb_SNtjR.js';
+import './message-parts/index.js';
+export { au as AccessTrackingEntry, A as ActiveRecallChatType, d as ActiveRecallModelFallbackPolicy, b as ActiveRecallPromptStyle, a as ActiveRecallQueryMode, c as ActiveRecallThinking, J as AgentAccessAuthToken, b8 as AgentAccessHttpConfig, b9 as AgentDefaultsConfig, ba as AgentPersona, f as AgentPersonaModelConfig, bb as BehaviorLoopAdjustment, e as BehaviorLoopPolicyState, bc as BehaviorSignalDirection, B as BehaviorSignalEvent, bd as BehaviorSignalType, aH as BootstrapOptions, aI as BootstrapResult, r as BriefingActiveThread, be as BriefingCalendarSourceError, aU as BriefingConfig, p as BriefingFocus, o as BriefingFollowup, aV as BriefingOpenCommitment, t as BriefingRecentEntity, s as BriefingResult, n as BriefingSections, aW as BriefingWindow, bf as BufferEntryState, ap as BufferState, z as BufferSurpriseEvent, u as BufferTurn, q as CalendarEvent, C as CalendarSource, bg as CaptureMode, v as Checkpoint, bh as CodexCliReasoningEffort, bi as CodexCompactionFlushMode, aX as CodexCompatConfig, bj as CodexConnectorConfig, aG as CodingContext, bk as CodingKnowledgeConfig, aR as CodingModeConfig, bl as CompressionGuidelineActivationState, N as CompressionGuidelineOptimizerActionSummary, K as CompressionGuidelineOptimizerEventCounts, O as CompressionGuidelineOptimizerRuleUpdate, bm as CompressionGuidelineOptimizerSourceWindow, X as CompressionGuidelineOptimizerState, bn as ConfidenceTier, bo as ConsolidationAction, bp as ConsolidationItem, aJ as ConsolidationObservation, a1 as ConsolidationResult, a6 as ContinuityImprovementLoop, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, bq as ContinuityIncidentState, br as ContinuityLoopCadence, a7 as ContinuityLoopReviewInput, bs as ContinuityLoopStatus, a8 as ContinuityLoopUpsertInput, bt as ContradictionScanConfig, am as ConversationThread, bu as CronConversationRecallMode, bv as CronRecallMode, aY as DEFAULT_RECALL_DISCLOSURE, a2 as DaySummaryResult, bw as DreamingConfig, bx as DreamingNarrativePromptStyle, by as DreamsDeepSleepConfig, bz as DreamsLightSleepConfig, aP as DreamsPhase, bA as DreamsPhaseStatus, bB as DreamsPhasesConfig, bC as DreamsRemConfig, aQ as DreamsRunResult, aO as DreamsStatusResult, bD as EngramTraceEvent, at as EntityActivityEntry, E as EntityFile, Y as EntityMention, as as EntityRelationship, Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection, aK as EntityTimelineEntry, aZ as ExtractedFact, bE as ExtractedProcedureStep, bF as ExtractedQuestion, bG as ExtractedReasoningTrace, bH as ExtractedReasoningTraceStep, bI as ExtractedRelationship, bJ as ExtractionPassSource, a0 as ExtractionResult, F as FaithfulnessFrontmatter, ar as FileHygieneConfig, G as GatewayConfig, bK as GitHubLiveConnectorConfig, bL as GmailLiveConnectorConfig, bM as GoogleDriveLiveConnectorConfig, bN as HeartbeatConfig, bO as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, y as ImportanceLevel, a9 as ImportanceScore, w as LifecycleState, L as LiveConnectorsConfig, bP as LlmTraceCallback, bQ as LlmTraceEvent, ac as MemoryActionEligibilityContext, a_ as MemoryActionEligibilitySource, W as MemoryActionEvent, bR as MemoryActionOutcome, bS as MemoryActionPolicyDecision, ad as MemoryActionPolicyResult, bT as MemoryActionStatus, U as MemoryActionType, M as MemoryCategory, g as MemoryFile, k as MemoryFrontmatter, aa as MemoryIntent, m as MemoryLifecycleEvent, ae as MemoryLifecycleEventType, af as MemoryLifecycleStateSummary, ao as MemoryLink, bU as MemoryLinkType, a$ as MemoryObservation, bV as MemoryOsPresetName, l as MemoryProjectionCurrentState, b0 as MemoryScope, h as MemoryStatus, av as MemorySummary, aq as MetaState, bW as ModelApi, bX as ModelDefinitionConfig, bY as ModelProviderAuthMode, ag as ModelProviderConfig, bZ as NamespacePolicy, ah as NativeKnowledgeConfig, b_ as NativeKnowledgeFolderRuleConfig, b$ as NativeKnowledgeObsidianVaultConfig, c0 as NativeKnowledgeOpenClawWorkspaceConfig, c1 as NotionLiveConnectorConfig, P as PluginConfig, x as PolicyClass, c2 as PrincipalFromSessionKeyMode, c3 as PrincipalRule, c4 as ProceduralConfig, aj as ProvenanceConfig, ai as ProvenanceSource, ab as QmdSearchExplain, Q as QmdSearchResult, c5 as QuestionEntry, b1 as RECALL_DISCLOSURE_LEVELS, c6 as ReasoningEffort, j as RecallDisclosure, c7 as RecallPipelineConfig, i as RecallPlanMode, c8 as RecallSectionConfig, R as RecallTierExplain, c9 as RecallTraceEvent, ca as RelevanceFeedback, ak as RetrievalTier, cb as SPECULATIVE_TTL_DAYS, cc as ScopeProfileAutoPromoteConfig, aN as ScopeProfileConfig, aL as ScopeProfileLayerId, aM as ScopeProfilePromotionTarget, cd as ScopeProfileTeamProjectConfig, ce as ScopeTeamConfig, cf as ScoredEntity, D as SecretRef, cg as SemanticChunkingConfigShape, S as SessionObserverBandConfig, ch as SignalLevel, al as SignalScanResult, ci as SlotBehaviorConfig, cj as SlotMismatchMode, an as TopicScore, T as TranscriptEntry, ck as TriggerMode, V as VerificationState, cl as confidenceTier, b7 as isRecallDisclosure } from './types-CJrvHJjx.js';

package/dist/utility-runtime.d.ts

@@ -1,7 +1,7 @@
 import { TierRoutingPolicy } from './tier-routing.js';
-import './types-MWKPZnM0.js';
-import './types-ByK7T3L6.js';
-import './index-DJ9QWMw-.js';
+import './types-CJrvHJjx.js';
+import './types-gb_SNtjR.js';
+import './message-parts/index.js';
 import './lifecycle.js';
 
 interface UtilityRuntimeValues {

package/dist/utils/path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared path helpers. CLAUDE.md #17 requires consistent `~` expansion across
+ * every user-facing path input, but Node's `fs` does not expand `~`, so every
+ * call site must go through this helper.
+ */
+/**
+ * Expand a leading `~` or `~/…` to the resolved home directory.
+ *
+ * Leaves paths without a leading `~` unchanged — including absolute paths,
+ * relative paths, and paths that contain `~` in the middle.
+ *
+ * Accepts both `~/` (POSIX) and `~\` (Windows) as separators so call sites
+ * don't have to branch on platform.
+ */
+declare function expandTildePath(p: string): string;
+
+export { expandTildePath };

package/dist/utils/path.js

@@ -0,0 +1,9 @@
+import {
+  expandTildePath
+} from "../chunk-EYIEWJNI.js";
+import "../chunk-JUC24CTX.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  expandTildePath
+};
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/verified-recall.js

@@ -1,11 +1,11 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-MXEWQKM7.js";
+} from "./chunk-ORXVO6TH.js";
 import "./chunk-7FL4CNPV.js";
-import "./chunk-GFIARMA7.js";
-import "./chunk-3JJWNZTT.js";
+import "./chunk-NMW3T6T6.js";
 import "./chunk-M7XQSUBB.js";
+import "./chunk-3JJWNZTT.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-OMNTQPZO.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.703",
+  "version": "9.3.704",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -1476,6 +1476,21 @@
       "remnic-source": "./src/memory-worth.ts",
       "import": "./dist/memory-worth.js"
     },
+    "./message-parts": {
+      "types": "./dist/message-parts/index.d.ts",
+      "remnic-source": "./src/message-parts/index.ts",
+      "import": "./dist/message-parts/index.js"
+    },
+    "./message-parts/index": {
+      "types": "./dist/message-parts/index.d.ts",
+      "remnic-source": "./src/message-parts/index.ts",
+      "import": "./dist/message-parts/index.js"
+    },
+    "./message-parts/index.js": {
+      "types": "./dist/message-parts/index.d.ts",
+      "remnic-source": "./src/message-parts/index.ts",
+      "import": "./dist/message-parts/index.js"
+    },
     "./migrate/from-engram": {
       "types": "./dist/migrate/from-engram.d.ts",
       "remnic-source": "./src/migrate/from-engram.ts",
@@ -2806,6 +2821,16 @@
       "remnic-source": "./src/utils/serialize-mutations.ts",
       "import": "./dist/utils/serialize-mutations.js"
     },
+    "./utils/path": {
+      "types": "./dist/utils/path.d.ts",
+      "remnic-source": "./src/utils/path.ts",
+      "import": "./dist/utils/path.js"
+    },
+    "./utils/path.js": {
+      "types": "./dist/utils/path.d.ts",
+      "remnic-source": "./src/utils/path.ts",
+      "import": "./dist/utils/path.js"
+    },
     "./verified-recall": {
       "types": "./dist/verified-recall.d.ts",
       "remnic-source": "./src/verified-recall.ts",
@@ -2941,7 +2966,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.3.703"
+    "@remnic/coding-graph": "^9.3.704"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/cli/creation-ledger-commands.ts

@@ -0,0 +1,346 @@
+/**
+ * Creation-memory ledger command group — extracted from cli.ts (#1532 Phase B).
+ *
+ * Ten creation-memory ledger commands — thin wrappers over exported
+ * runXxxCliCommand helpers across three ledgers:
+ *   - resume-bundle (status / record / build)
+ *   - commitment    (status / record / set-state / lifecycle)
+ *   - work-product  (status / record / recall-search)
+ *
+ * Behaviour is identical to the inline registration it replaces — the
+ * cli-command-surface contract tests guard against silent drift.
+ *
+ * Circular import note: same safe pattern as research-status-commands.ts —
+ * the runXxx helpers are referenced only inside action callbacks invoked at
+ * runtime, never at module-eval time.
+ */
+
+import type { Orchestrator } from "../orchestrator.js";
+import type { CliCommand } from "../cli.js";
+import type { CommitmentLedgerEntry } from "../commitment-ledger.js";
+import type { WorkProductLedgerEntry } from "../work-product-ledger.js";
+import type { ResumeBundle } from "../resume-bundles.js";
+import {
+  runResumeBundleStatusCliCommand,
+  runResumeBundleRecordCliCommand,
+  runResumeBundleBuildCliCommand,
+  runCommitmentStatusCliCommand,
+  runCommitmentRecordCliCommand,
+  runCommitmentSetStateCliCommand,
+  runCommitmentLifecycleCliCommand,
+  runWorkProductStatusCliCommand,
+  runWorkProductRecordCliCommand,
+  runWorkProductRecallSearchCliCommand,
+} from "../cli.js";
+
+/**
+ * Register the creation-memory ledger command group on the parent `engram`
+ * command. Extracted verbatim from registerCli; behaviour-preserving.
+ */
+export function registerCreationLedgerCommands(
+  cmd: CliCommand,
+  orchestrator: Orchestrator,
+): void {
+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");
+  });
+
+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");
+  });
+}