@remnic/core 9.7.15 → 9.8.0

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,37 +313,37 @@ 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>;
-        directAnswerEnabled: boolean;
-    };
     parent: {
         version: string;
         capsuleId: string;
         forkRoot: string;
     } | null;
+    retrievalPolicy: {
+        tierWeights: Record<string, number>;
+        directAnswerEnabled: boolean;
+    };
 }, {
-    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,37 +464,37 @@ 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>;
-            directAnswerEnabled: boolean;
-        };
         parent: {
             version: string;
             capsuleId: string;
             forkRoot: string;
         } | null;
+        retrievalPolicy: {
+            tierWeights: Record<string, number>;
+            directAnswerEnabled: boolean;
+        };
     }, {
-        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,60 +507,58 @@ 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>;
-            directAnswerEnabled: boolean;
-        };
         parent: {
             version: string;
             capsuleId: string;
             forkRoot: string;
         } | null;
+        retrievalPolicy: {
+            tierWeights: Record<string, number>;
+            directAnswerEnabled: boolean;
+        };
     };
-}, {
     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,37 +683,37 @@ 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>;
-                directAnswerEnabled: boolean;
-            };
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
+            retrievalPolicy: {
+                tierWeights: Record<string, number>;
+                directAnswerEnabled: boolean;
+            };
         }, {
-            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,60 +726,58 @@ 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>;
-                directAnswerEnabled: boolean;
-            };
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
+            retrievalPolicy: {
+                tierWeights: Record<string, number>;
+                directAnswerEnabled: boolean;
+            };
         };
-    }, {
         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,38 +804,38 @@ 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>;
-                directAnswerEnabled: boolean;
-            };
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
+            retrievalPolicy: {
+                tierWeights: Record<string, number>;
+                directAnswerEnabled: boolean;
+            };
         };
+        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/dist/trust-score-stage.d.ts

@@ -1,32 +1,13 @@
+import { F as FaithfulnessFrontmatter, U as ProvenanceSource, V as TrustWeights, Q as QmdSearchResult } from './types-D_fG2ix8.js';
 import { TrustScoreResult, TrustSignals, TrustBand, TrustScoreComponent } from './trust-score.js';
-import { F as FaithfulnessFrontmatter, N as ProvenanceSource, O as TrustWeights } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './types-continuity.js';
 
-/**
- * trust-score-stage.ts — signal adapters + recall pipeline stage (issue #1577 PR 2).
- *
- * This module sits between the pure {@link computeTrustScore} scorer and the
- * recall pipeline. It owns TWO jobs:
- *
- *   1. **Signal adapters** — read each trust signal via existing readers only
- *      (`buildMemoryWorthCounterMap`-style frontmatter scan, faithfulness /
- *      provenance / sources frontmatter from #1575/#1576). No new disk format,
- *      no new write path. Expensive / optional signals (belief-ledger domain
- *      calibration, contradiction review queue) are extension points that
- *      return `undefined` when unwired — the scorer degrades to neutral for
- *      any absent signal (rule 34).
- *
- *   2. **The recall stage** — apply `trustMultiplier(trust.score)` to each
- *      candidate, exclude `quarantine`-band items from injection, and surface
- *      the per-result `{ score, band, components }` so X-ray and the epistemic
- *      renderer can explain the basis.
- *
- * Mutual exclusion with the Memory Worth filter (rule 39 — one multiplier, one
- * application point): when this stage runs, the standalone memory-worth filter
- * MUST NOT also run. The orchestrator enforces that at the wiring site
- * (`if (caps.recallTrustScore) … else if (caps.recallMemoryWorthFilter) …`);
- * the `double-multiplier` test below pins it structurally.
- */
+/** Stable key for a recall result whose path may repeat across namespaces. */
+declare function trustResultKey(result: Pick<QmdSearchResult, "path" | "namespace">): string;
+/** Read trust metadata while accepting pre-namespace path-only maps. */
+declare function trustResultFor(trustByPath: ReadonlyMap<string, TrustStageResultItem>, result: Pick<QmdSearchResult, "path" | "namespace">): TrustStageResultItem | undefined;
 
 /**
  * Frontmatter projection the adapter reads. Kept narrow + structural so it can
@@ -58,10 +39,14 @@ declare function buildTrustSignalMap(memories: ReadonlyArray<{
 interface TrustStageCandidate {
     path: string;
     score: number;
+    /** Namespace-aware result key used to preserve result identity through rerank. */
+    key?: string;
 }
 /** One candidate after the TrustScore stage. */
 interface TrustStageResultItem {
     path: string;
+    /** Namespace-aware result key used to preserve result identity through rerank. */
+    key?: string;
     /** Final score after the trust multiplier is applied. */
     score: number;
     /** The untouched input score — for telemetry / X-ray. */
@@ -148,30 +133,82 @@ interface TrustScoreRerankDeps {
         path: string;
         frontmatter: TrustFrontmatterProjection;
     }>>;
-    /** Read one memory's frontmatter by path (cold-tier direct fallback). */
-    readMemoryFrontmatter(path: string): Promise<TrustFrontmatterProjection | null>;
+    /** Read one memory's frontmatter by path (cold-tier direct fallback). The
+     * owning namespace is passed so a relative path resolves against the correct
+     * namespace store instead of the first fallback (#2020). */
+    readMemoryFrontmatter(path: string, preferredNamespace?: string): Promise<TrustFrontmatterProjection | null>;
+    /**
+     * Current cross-process corpus version for a namespace (issue #1905). Used
+     * to key the per-namespace corpus-fallback cache so it invalidates on the
+     * next memory mutation instead of on a wall-clock timer that is shorter than
+     * recall latency (which produced a permanent steady-state miss).
+     */
+    getNamespaceVersion(namespace: string): Promise<number>;
 }
-/** Per-namespace signal cache the host owns and the builder mutates. */
+/**
+ * Per-namespace signal cache the host owns and the builder mutates. Keyed on
+ * the shared corpus version (issue #1905): an entry is valid iff its `version`
+ * still equals the namespace's current corpus version AND it is younger than
+ * TRUST_SIGNAL_CACHE_MAX_AGE_MS. The age bound is required because trust
+ * signals bake wall-clock time into their values (ageDays,
+ * computeMemoryWorth(..., now) with recency half-life) — pure version
+ * invalidation would serve stale decay on a read-only corpus (#1905, Codex).
+ */
 interface TrustScoreSignalCache {
     cache: Map<string, {
-        at: number;
+        version: number;
+        cachedAt: number;
         signals: ReadonlyMap<string, TrustSignals>;
     }>;
-    ttlMs: number;
 }
+/** See TrustScoreSignalCache — bounds time-based staleness of cached signals. */
+declare const TRUST_SIGNAL_CACHE_MAX_AGE_MS = 300000;
+/** Bound on distinct namespaces retained; overflow evicts the oldest. */
+declare const TRUST_SIGNAL_CACHE_MAX_NAMESPACES = 64;
 /**
- * Build the `path → TrustSignals` map for recall candidates using a
- * per-namespace cache plus a direct-path fallback for cold-tier candidates
- * absent from the hot scan. Extracted from the orchestrator (issue #1577) so
- * the god file carries only thin wiring — the scoring itself is
- * {@link applyTrustScoreStage}.
+ * Build the `path → TrustSignals` map for recall candidates.
+ *
+ * O(candidates) inversion (issue #1905): when the host passes
+ * `preloadedFrontmatter` (frontmatter already loaded on the hot recall path),
+ * candidate signals are seeded directly from it — no corpus scan. Only
+ * candidates still missing fall back to the corpus-level per-namespace map
+ * (config-gated, version-keyed so it actually hits in steady state) and then
+ * to a bounded-parallel direct per-path read.
  *
  * Fail-open: a single unreadable namespace or memory is logged and skipped so
  * a storage hiccup never breaks recall (mirrors `memory-worth-filter.ts`).
  */
-declare function buildTrustSignalsForRerank(candidatePaths: readonly string[], namespaces: readonly string[], deps: TrustScoreRerankDeps, signalCache: TrustScoreSignalCache, now: Date, options?: {
+declare function buildTrustSignalsForRerank(candidates: readonly (string | {
+    path: string;
+    signalKey?: string;
+    lookupKey?: string;
+    namespace?: string;
+})[], namespaces: readonly string[], deps: TrustScoreRerankDeps, signalCache: TrustScoreSignalCache, now: Date, options?: {
     recencyHalfLifeDays?: number;
     logDebug?: (message: string, context: Record<string, unknown>) => void;
+    /**
+     * Candidate frontmatter already loaded on the hot recall path (issue
+     * #1905). When present, candidate signals are seeded from it before any
+     * corpus scan, so the common warm-candidate recall does zero
+     * `readNamespaceMemories` calls. Structural — a `MemoryFile` map satisfies
+     * `{ frontmatter: TrustFrontmatterProjection }` without importing it.
+     */
+    preloadedFrontmatter?: ReadonlyMap<string, {
+        frontmatter: TrustFrontmatterProjection;
+    }>;
+    /**
+     * When false, skip the corpus-level `readNamespaceMemories` fallback
+     * entirely (candidates-first + direct-read only). Defaults to true so the
+     * corpus path stays reachable. See `recallTrustStageCorpusFallbackEnabled`.
+     */
+    corpusFallbackEnabled?: boolean;
+    /**
+     * Cooperative cancellation (issue #1905, Codex): when the recall's shared
+     * enrichment-assembly deadline wins the race, the host aborts this signal
+     * so an orphaned corpus scan / direct-read loop stops at the next loop
+     * boundary instead of continuing to burn I/O after recall already returned.
+     */
+    abortSignal?: AbortSignal;
 }): Promise<Map<string, TrustSignals>>;
 
-export { type TrustFrontmatterProjection, type TrustScoreRerankDeps, type TrustScoreSignalCache, type TrustStageCandidate, type TrustStageOptions, type TrustStageOutput, type TrustStageResultItem, type TrustXrayProjection, applyTrustScoreStage, buildTrustSignalMap, buildTrustSignalsForRerank, explainQuarantine, projectTrustForXray };
+export { TRUST_SIGNAL_CACHE_MAX_AGE_MS, TRUST_SIGNAL_CACHE_MAX_NAMESPACES, type TrustFrontmatterProjection, type TrustScoreRerankDeps, type TrustScoreSignalCache, type TrustStageCandidate, type TrustStageOptions, type TrustStageOutput, type TrustStageResultItem, type TrustXrayProjection, applyTrustScoreStage, buildTrustSignalMap, buildTrustSignalsForRerank, explainQuarantine, projectTrustForXray, trustResultFor, trustResultKey };

package/dist/trust-score-stage.js

@@ -1,18 +1,26 @@
 import {
+  TRUST_SIGNAL_CACHE_MAX_AGE_MS,
+  TRUST_SIGNAL_CACHE_MAX_NAMESPACES,
   applyTrustScoreStage,
   buildTrustSignalMap,
   buildTrustSignalsForRerank,
   explainQuarantine,
-  projectTrustForXray
-} from "./chunk-BCDKBDSY.js";
+  projectTrustForXray,
+  trustResultFor,
+  trustResultKey
+} from "./chunk-GNVZQ5JN.js";
 import "./chunk-YN2UN7N3.js";
 import "./chunk-IISBCCWR.js";
 import "./chunk-PZ5AY32C.js";
 export {
+  TRUST_SIGNAL_CACHE_MAX_AGE_MS,
+  TRUST_SIGNAL_CACHE_MAX_NAMESPACES,
   applyTrustScoreStage,
   buildTrustSignalMap,
   buildTrustSignalsForRerank,
   explainQuarantine,
-  projectTrustForXray
+  projectTrustForXray,
+  trustResultFor,
+  trustResultKey
 };
 //# sourceMappingURL=trust-score-stage.js.map

package/dist/trust-score.d.ts

@@ -1,5 +1,7 @@
-import { O as TrustWeights } from './types-Cg8q7W7_.js';
+import { V as TrustWeights } from './types-D_fG2ix8.js';
 import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './types-continuity.js';
 
 /**
  * trust-score.ts — unified TrustScore pure module (issue #1577 PR 1).