@remnic/core 9.6.5 → 9.6.6

package/dist/transfer/types.d.ts

@@ -20,26 +20,26 @@ declare const ExportManifestV1Schema: z.ZodObject<{
         bytes: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }>;
 type ExportManifestV1 = z.infer<typeof ExportManifestV1Schema>;
@@ -75,26 +75,26 @@ declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
@@ -109,15 +109,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -126,15 +126,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -313,16 +313,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -334,16 +334,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         forkRoot: string;
     } | null;
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -464,16 +464,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -485,16 +485,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null;
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -507,27 +507,25 @@ declare const ExportManifestV2Schema: z.ZodObject<{
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 2;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -539,28 +537,28 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null;
     };
-}, {
     schemaVersion: 2;
+    includesTranscripts: boolean;
+}, {
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -572,6 +570,8 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null | undefined;
     };
+    schemaVersion: 2;
+    includesTranscripts: boolean;
 }>;
 type ExportManifestV2 = z.infer<typeof ExportManifestV2Schema>;
 declare const ExportBundleV2Schema: z.ZodObject<{
@@ -683,16 +683,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -704,16 +704,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -726,27 +726,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             } | null | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -758,28 +756,28 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         };
-    }, {
         schemaVersion: 2;
+        includesTranscripts: boolean;
+    }, {
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -791,6 +789,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -804,27 +804,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -836,6 +834,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;
@@ -843,27 +843,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -875,6 +873,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.6.5",
+  "version": "9.6.6",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3000,7 +3000,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.6.5"
+    "@remnic/coding-graph": "^9.6.6"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/cli.ts

@@ -217,6 +217,8 @@ import {
   planSessionTranscriptMigration,
 } from "./session-transcript-migration.js";
 import type { TierMigrationCycleSummary, TierMigrationStatusSnapshot } from "./recall-state.js";
+import type { TierMigrationCoordinator } from "./orchestration/tier-migration-coordinator.js";
+import type { StorageManager } from "./index.js";
 import {
   readRuntimePolicySnapshot as readPolicyRuntimeSnapshot,
   sanitizeRuntimePolicyValues,
@@ -689,11 +691,6 @@ export interface SessionRepairCliCommandOptions {
   sessionFilesDir?: string;
 }
 
-export interface TierMigrationCliOrchestrator {
-  getTierMigrationStatus(): Promise<TierMigrationStatusSnapshot>;
-  runTierMigrationNow(options?: { dryRun?: boolean; limit?: number }): Promise<TierMigrationCycleSummary>;
-}
-
 export interface MemoryActionAuditCliCommandOptions {
   namespace?: string;
   limit?: number;
@@ -1870,17 +1867,76 @@ export async function runSessionRepairCliCommand(
   return { report, plan, applyResult };
 }
 
+// ---------------------------------------------------------------------------
+// Tier migration CLI adapters
+//
+// The public exports below accept two adapter shapes and normalize at this
+// boundary; registerCli always passes the coordinator shape internally.
+//   1. Coordinator shape — the orchestrator exposes the extracted
+//      TierMigrationCoordinator directly (current wiring).
+//   2. Legacy shape — the orchestrator formerly forwarded via
+//      getTierMigrationStatus / runTierMigrationNow delegates. External
+//      callers (tests, integrations) that still pass the old shape keep
+//      working.
+// ---------------------------------------------------------------------------
+
+/** Coordinator-shaped adapter for tier-status reads. */
+export interface TierStatusCoordinatorCliAdapter {
+  readonly tierMigrationCoordinator: Pick<TierMigrationCoordinator, "getStatus">;
+}
+
+/** Legacy adapter shape for tier-status reads (former orchestrator delegate). */
+export interface TierStatusLegacyCliAdapter {
+  getTierMigrationStatus():
+    | Promise<TierMigrationStatusSnapshot>
+    | TierMigrationStatusSnapshot;
+}
+
+/** Accepted input for {@link runTierStatusCliCommand}. */
+export type TierStatusCliAdapter =
+  | TierStatusCoordinatorCliAdapter
+  | TierStatusLegacyCliAdapter;
+
+/** Coordinator-shaped adapter for tier-migrate runs. */
+export interface TierMigrateCoordinatorCliAdapter {
+  readonly tierMigrationCoordinator: Pick<TierMigrationCoordinator, "runCycle">;
+  readonly storage: StorageManager;
+}
+
+/** Legacy adapter shape for tier-migrate runs (former orchestrator delegate). */
+export interface TierMigrateLegacyCliAdapter {
+  runTierMigrationNow(options?: {
+    dryRun?: boolean;
+    limit?: number;
+  }): Promise<TierMigrationCycleSummary>;
+}
+
+/** Accepted input for {@link runTierMigrateCliCommand}. */
+export type TierMigrateCliAdapter =
+  | TierMigrateCoordinatorCliAdapter
+  | TierMigrateLegacyCliAdapter;
+
 export async function runTierStatusCliCommand(
-  orchestrator: TierMigrationCliOrchestrator,
+  adapter: TierStatusCliAdapter,
 ): Promise<TierMigrationStatusSnapshot> {
-  return orchestrator.getTierMigrationStatus();
+  if ("tierMigrationCoordinator" in adapter && typeof adapter.tierMigrationCoordinator.getStatus === "function") {
+    return adapter.tierMigrationCoordinator.getStatus();
+  }
+  return (adapter as TierStatusLegacyCliAdapter).getTierMigrationStatus();
 }
 
 export async function runTierMigrateCliCommand(
-  orchestrator: TierMigrationCliOrchestrator,
+  adapter: TierMigrateCliAdapter,
   options: { dryRun?: boolean; limit?: number } = {},
 ): Promise<TierMigrationCycleSummary> {
-  return orchestrator.runTierMigrationNow({
+  if ("tierMigrationCoordinator" in adapter && typeof adapter.tierMigrationCoordinator.runCycle === "function") {
+    return adapter.tierMigrationCoordinator.runCycle(
+      adapter.storage,
+      "manual",
+      { dryRun: options.dryRun === true, limitOverride: options.limit, force: false },
+    );
+  }
+  return (adapter as TierMigrateLegacyCliAdapter).runTierMigrationNow({
     dryRun: options.dryRun === true,
     limit: options.limit,
   });

package/src/orchestration/tier-migration-coordinator.ts

@@ -8,15 +8,13 @@
  *   - promotion/demotion execution via TierMigrationExecutor
  *   - status recording through TierMigrationStatusStore
  *
- * The orchestrator constructs one instance and delegates the three public
- * entrypoints (`runTierMigrationCycle`, `runTierMigrationNow`,
- * `getTierMigrationStatus`) to it. Storage is passed per-call so extraction
- * (which writes to a namespace-scoped storage) and maintenance/manual (which
- * use the default storage) share one coordinator.
- *
- * Behavior-preserving move from orchestrator.ts. No logic changes — the
- * orchestrator keeps thin delegating methods so existing call sites and
- * tests that exercise the public API continue to work.
+ * The orchestrator constructs one instance and exposes it as the public
+ * `tierMigrationCoordinator` field. CLI commands and maintenance paths call
+ * `getStatus`/`runCycle` directly; the orchestrator keeps a private
+ * `runTierMigrationCycle` wrapper for the extraction-run dependency.
+ * Storage is passed per-call so extraction (which writes to a namespace-
+ * scoped storage) and maintenance/manual (which use the default storage)
+ * share one coordinator.
  */
 
 import path from "node:path";

package/src/orchestrator.ts

@@ -236,7 +236,6 @@ import {
   type GraphRecallExpandedEntry,
   type LastRecallSnapshot,
   type TierMigrationCycleSummary,
-  type TierMigrationStatusSnapshot,
 } from "./recall-state.js";
 import {
   buildHandleIndexForResults,
@@ -3033,21 +3032,6 @@ export class Orchestrator {
     return this.tierMigrationCoordinator.runCycle(storage, trigger, options);
   }
 
-  async getTierMigrationStatus(): Promise<TierMigrationStatusSnapshot> {
-    return this.tierMigrationStatus.get();
-  }
-
-  async runTierMigrationNow(options?: {
-    dryRun?: boolean;
-    limit?: number;
-  }): Promise<TierMigrationCycleSummary> {
-    return this.runTierMigrationCycle(this.storage, "manual", {
-      dryRun: options?.dryRun === true,
-      limitOverride: options?.limit,
-      force: false,
-    });
-  }
-
   private maybeScheduleConsolidation(nonZeroExtraction: boolean): void {
     this.maintenanceScheduler.maybeScheduleConsolidation(
       nonZeroExtraction,