@remnic/core 9.69.55 → 9.69.57

package/dist/recall-why.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Recall-miss diagnosis (issue #3033).
+ *
+ * `remnic xray` explains the attribution of results that WERE returned.
+ * Nothing explained an absence, so an operator who expected a memory back
+ * could not tell their own configuration from a product defect. This module
+ * answers the other question: given a query, which pipeline stage dropped
+ * the memory I expected?
+ *
+ * Host-agnostic and strictly READ-ONLY: it persists nothing, indexes
+ * nothing, and never mutates recall behaviour. It is deliberately NOT gated
+ * by `recallDirectAnswerEnabled` (which gates the xray tier-explain block) —
+ * a diagnostic that only works once the feature you are diagnosing is
+ * already enabled is useless.
+ *
+ * Reuse, never fork (AGENTS.md rule 22 / issue decision 3). The pipeline is
+ * not re-implemented here. Every stage decision comes from one of exactly
+ * two places:
+ *
+ *   1. The `RecallXraySnapshot` the REAL recall published — its
+ *      `results` / `headroomResults` / `appliedResults` / `filters` /
+ *      `appliedResultLimit` fields already record what each stage saw and
+ *      admitted. That snapshot IS the existing stage recorder.
+ *   2. The same shared predicates the pipeline itself calls, injected
+ *      through {@link RecallWhyDeps} so a caller cannot accidentally supply
+ *      a divergent copy: `planRecallMode`, `isGenericRecallExcludedPath`,
+ *      `ACTIVE_STATUSES`, and the shared namespace resolver.
+ *
+ * Stage order follows the recall contract in AGENTS.md
+ * ("Retrieval/Intent/Cache Guardrails" #1): candidate retrieval headroom ->
+ * policy filters -> rerank/boost -> cap -> format. A memory is reported
+ * against the EARLIEST stage that dropped it.
+ *
+ * Empty is not failed (Review Prevention Checklist #22): a search-backend
+ * outage returns `{ ok: false, failure: { reason: "backend_unavailable" } }`
+ * and never "0 candidates".
+ */
+import type { RecallXraySnapshot } from "./recall-xray.js";
+import type { MemoryStatus, RecallPlanMode } from "./types.js";
+/**
+ * Pipeline stages, in contract order. Frozen `as const` WITHOUT a
+ * `readonly RecallWhyStage[]` annotation so the derived union below stays
+ * narrow (Review Prevention Checklist #47).
+ */
+export declare const RECALL_WHY_STAGES: readonly ["retrieval", "policy-filter", "rerank", "cap", "format"];
+export type RecallWhyStage = (typeof RECALL_WHY_STAGES)[number];
+/** Why a candidate was dropped. */
+export declare const RECALL_WHY_DROP_REASONS: readonly ["backend-unavailable", "planner-mode", "namespace-scope", "path-excluded", "status-filter", "not-a-candidate", "score-floor", "cap-eviction"];
+export type RecallWhyDropReason = (typeof RECALL_WHY_DROP_REASONS)[number];
+/** A single dropped candidate, attributed to the stage that dropped it. */
+export interface RecallWhyDrop {
+    memoryId: string;
+    path: string;
+    reason: RecallWhyDropReason;
+    /** Human-readable specifics, e.g. `status=superseded`. */
+    detail: string;
+}
+/** What one pipeline stage saw and admitted. */
+export interface RecallWhyStageRecord {
+    stage: RecallWhyStage;
+    /** Candidates entering the stage. Non-negative integer. */
+    considered: number;
+    /** Candidates leaving the stage. Non-negative integer. */
+    admitted: number;
+    /** Filter-ladder detail carried verbatim from the snapshot, when present. */
+    reason?: string;
+    drops: RecallWhyDrop[];
+}
+/** Verdict for the `--expect <memory-id|substring>` trace. */
+export interface RecallWhyExpectation {
+    /** The id or substring the caller asked about, exactly as supplied. */
+    expect: string;
+    /** True when a stored memory matched `expect`. */
+    matched: boolean;
+    memoryId?: string;
+    path?: string;
+    /** True when the memory survived to the injected set. */
+    recalled: boolean;
+    /** Stage that dropped it. Absent when `recalled` is true. */
+    stage?: RecallWhyStage;
+    reason?: RecallWhyDropReason;
+    detail?: string;
+    /** One-line operator remediation. Absent when `recalled` is true. */
+    remediation?: string;
+}
+/** The diagnosis. Rendered identically by CLI, HTTP, and MCP. */
+export interface RecallWhyReport {
+    /** Stable v1 tag so downstream parsers can version-gate. */
+    schemaVersion: "1";
+    query: string;
+    namespace?: string;
+    plannerMode: RecallPlanMode;
+    /**
+     * False ONLY when the diagnosis itself could not run because the search
+     * backend was unavailable. An honest empty pipeline is `ok: true`.
+     */
+    ok: boolean;
+    failure?: {
+        reason: "backend_unavailable";
+        detail: string;
+    };
+    recallNamespaces: string[];
+    /** Final user-facing cap the recall applied. Non-negative integer. */
+    appliedResultLimit: number;
+    stages: RecallWhyStageRecord[];
+    /** Memory ids that survived every stage. */
+    recalledMemoryIds: string[];
+    expectation?: RecallWhyExpectation;
+}
+/**
+ * Outcome of replaying the real recall. `ok: false` is reserved for a
+ * search backend that could not answer — never for an honest empty
+ * result (Review Prevention Checklist #22).
+ */
+export type RecallWhyRecallOutcome = {
+    ok: true;
+    snapshot: RecallXraySnapshot | null;
+} | {
+    ok: false;
+    reason: "backend_unavailable";
+    detail: string;
+};
+/** The stored memory a caller's `--expect` resolved to. */
+export interface RecallWhyMemoryRef {
+    memoryId: string;
+    path: string;
+    status: MemoryStatus;
+    namespace: string;
+}
+/**
+ * Injected pipeline access. Every member is either the real recall or a
+ * predicate the real pipeline itself calls — never a reimplementation.
+ */
+export interface RecallWhyDeps {
+    /** Runs the REAL recall with X-ray capture and reports backend faults. */
+    runRecall(query: string, options: {
+        sessionKey?: string;
+        namespace?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<RecallWhyRecallOutcome>;
+    /** `planRecallMode` from `intent.ts` — the planner the pipeline uses. */
+    plannerMode(query: string): RecallPlanMode;
+    /**
+     * Namespaces this caller reads, resolved through the SAME shared
+     * resolver the recall path uses (rule 30). Used when the recall did
+     * not record its own scope.
+     */
+    scopedNamespaces: readonly string[];
+    namespacesEnabled: boolean;
+    /** `isGenericRecallExcludedPath` bound to the live config. */
+    isExcludedPath(path: string): boolean;
+    /** Read-only lookup by exact memory id, else by id/path substring. */
+    findExpected(expect: string): Promise<RecallWhyMemoryRef | null>;
+}
+export interface RecallWhyOptions {
+    deps: RecallWhyDeps;
+    /** Memory id or substring to trace through every stage. */
+    expect?: string;
+    sessionKey?: string;
+    namespace?: string;
+    abortSignal?: AbortSignal;
+}
+/** Thrown for caller-input faults so surfaces can map them to a 400. */
+export declare class RecallWhyInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * Diagnose why a query did not surface an expected memory.
+ *
+ * Runs the real recall once, then attributes the outcome to stages. When
+ * `expect` is supplied, traces that one memory and names the exact stage
+ * that dropped it plus a remediation hint.
+ */
+export declare function explainRecallMiss(query: string, opts: RecallWhyOptions): Promise<RecallWhyReport>;
+//# sourceMappingURL=recall-why.d.ts.map

package/dist/recall-why.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-why.d.ts","sourceRoot":"","sources":["../src/recall-why.ts"],"names":[],"mappings":"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"}

package/dist/recall-why.js

@@ -0,0 +1,25 @@
+import {
+  RECALL_WHY_DROP_REASONS,
+  RECALL_WHY_STAGES,
+  RecallWhyInputError,
+  explainRecallMiss
+} from "./chunk-DXODYQ7J.js";
+import "./chunk-42DJ235G.js";
+import "./chunk-CTVWELNK.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-PWPIERBM.js";
+import "./chunk-JDSVLVCG.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-JAKIDQB2.js";
+import "./chunk-P7FMDTKL.js";
+import "./chunk-VUFL7X3H.js";
+import "./chunk-JUOZ62Y7.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  RECALL_WHY_DROP_REASONS,
+  RECALL_WHY_STAGES,
+  RecallWhyInputError,
+  explainRecallMiss
+};
+//# sourceMappingURL=recall-why.js.map

package/dist/recall-why.js.map

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

package/dist/recall-xray-cli.d.ts

@@ -1,27 +1,3 @@
-import { RecallXrayFormat } from './recall-xray-renderer.js';
-import { o as RecallDisclosure } from './types-Du6VdoAg.js';
-import './recall-xray.js';
-import './memory-provenance.js';
-import './user-model.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './recall-state-view.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-import './recall-context-composition.js';
-
 /**
  * Input-validation helpers for the `remnic xray` CLI command (issue
  * #570, PR 3).
@@ -33,8 +9,9 @@ import './recall-context-composition.js';
  * unknown / non-positive arguments with a listed-options error, rather
  * than silently defaulting.
  */
-
-interface ParsedXrayCliOptions {
+import { type RecallXrayFormat } from "./recall-xray-renderer.js";
+import { type RecallDisclosure } from "./types.js";
+export interface ParsedXrayCliOptions {
     format: RecallXrayFormat;
     /** Positive integer override, or undefined when not specified. */
     budget?: number;
@@ -49,19 +26,18 @@ interface ParsedXrayCliOptions {
  * Validate and coerce `--disclosure <level>`.  Must be one of the
  * canonical levels; throws a listed-options error otherwise.
  */
-declare function parseXrayDisclosureFlag(value: unknown): RecallDisclosure | undefined;
+export declare function parseXrayDisclosureFlag(value: unknown): RecallDisclosure | undefined;
 /**
  * Validate and coerce `--budget <chars>`.  Must be a positive integer;
  * throws a listed-options error otherwise.
  */
-declare function parseXrayBudgetFlag(value: unknown): number | undefined;
+export declare function parseXrayBudgetFlag(value: unknown): number | undefined;
 /**
  * Parse and validate the full option bag for `remnic xray`.  Extracted
  * so the CLI handler in `cli.ts` can stay thin and the validation can
  * be unit-tested without booting an orchestrator.
  */
-declare function parseXrayCliOptions(rawQuery: unknown, options: Record<string, unknown>): {
+export declare function parseXrayCliOptions(rawQuery: unknown, options: Record<string, unknown>): {
     query: string;
 } & ParsedXrayCliOptions;
-
-export { type ParsedXrayCliOptions, parseXrayBudgetFlag, parseXrayCliOptions, parseXrayDisclosureFlag };
+//# sourceMappingURL=recall-xray-cli.d.ts.map

package/dist/recall-xray-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-xray-cli.d.ts","sourceRoot":"","sources":["../src/recall-xray-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAQpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAatE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAwB1C"}

package/dist/recall-xray-cli.js

@@ -2,14 +2,14 @@ import {
   parseXrayBudgetFlag,
   parseXrayCliOptions,
   parseXrayDisclosureFlag
-} from "./chunk-SLGD36MM.js";
-import "./chunk-MWVYHNSU.js";
+} from "./chunk-BJI2D4SU.js";
+import "./chunk-36S7UHAW.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-WH7RINGG.js";
+import "./chunk-C5CPYMLX.js";
 import "./chunk-TOTT6S2V.js";
-import "./chunk-4UVJ6EIT.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
+import "./chunk-FNQEXI3D.js";
 import "./chunk-PZ5AY32C.js";
 export {
   parseXrayBudgetFlag,

package/dist/recall-xray-renderer.d.ts

@@ -1,26 +1,3 @@
-import { RecallXraySnapshot } from './recall-xray.js';
-import './memory-provenance.js';
-import './types-Du6VdoAg.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './recall-state-view.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-import './user-model.js';
-import './recall-context-composition.js';
-
 /**
  * Unified Recall X-ray renderer (issue #570, PR 2).
  *
@@ -38,27 +15,26 @@ import './recall-context-composition.js';
  *     formats with a listed-options error (CLAUDE.md rule 51).
  *   - Golden-file-style tests in `recall-xray-renderer.test.ts`.
  */
-
-type RecallXrayFormat = "json" | "text" | "markdown";
-declare const RECALL_XRAY_FORMATS: readonly RecallXrayFormat[];
+import type { RecallXraySnapshot } from "./recall-xray.js";
+export type RecallXrayFormat = "json" | "text" | "markdown";
+export declare const RECALL_XRAY_FORMATS: readonly RecallXrayFormat[];
 /**
  * Validate and coerce a user-provided `--format` / `format` argument to
  * `RecallXrayFormat`.  Unknown values throw an error listing valid
  * options (CLAUDE.md rule 51).  `undefined`/`null` defaults to `"text"`.
  */
-declare function parseXrayFormat(value: unknown): RecallXrayFormat;
+export declare function parseXrayFormat(value: unknown): RecallXrayFormat;
 /**
  * Top-level dispatcher.  CLI / HTTP / MCP callers should always route
  * through this function so the three formats stay in lock-step.
  */
-declare function renderXray(snapshot: RecallXraySnapshot | null, format: RecallXrayFormat): string;
+export declare function renderXray(snapshot: RecallXraySnapshot | null, format: RecallXrayFormat): string;
 /**
  * Deterministic JSON encoding of an X-ray snapshot.  Returns a stable
  * v1 envelope when the snapshot is absent so consumers can pattern-match
  * on `snapshotFound` rather than distinguishing `null` vs `{}`.
  */
-declare function renderXrayJson(snapshot: RecallXraySnapshot | null): string;
-declare function renderXrayText(snapshot: RecallXraySnapshot | null): string;
-declare function renderXrayMarkdown(snapshot: RecallXraySnapshot | null): string;
-
-export { RECALL_XRAY_FORMATS, type RecallXrayFormat, parseXrayFormat, renderXray, renderXrayJson, renderXrayMarkdown, renderXrayText };
+export declare function renderXrayJson(snapshot: RecallXraySnapshot | null): string;
+export declare function renderXrayText(snapshot: RecallXraySnapshot | null): string;
+export declare function renderXrayMarkdown(snapshot: RecallXraySnapshot | null): string;
+//# sourceMappingURL=recall-xray-renderer.d.ts.map

package/dist/recall-xray-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-xray-renderer.d.ts","sourceRoot":"","sources":["../src/recall-xray-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAGV,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAK1B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5D,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAIjD,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAYhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAIR;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAe1E;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAmD1E;AAgFD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAClC,MAAM,CA+HR"}

package/dist/recall-xray-renderer.js

@@ -5,13 +5,13 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-MWVYHNSU.js";
+} from "./chunk-36S7UHAW.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-WH7RINGG.js";
+import "./chunk-C5CPYMLX.js";
 import "./chunk-TOTT6S2V.js";
-import "./chunk-4UVJ6EIT.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
+import "./chunk-FNQEXI3D.js";
 import "./chunk-PZ5AY32C.js";
 export {
   RECALL_XRAY_FORMATS,

package/dist/recall-xray.d.ts

@@ -1,25 +1,3 @@
-import { RetrievedMemoryProvenance } from './memory-provenance.js';
-import { b as RecallTierExplain, o as RecallDisclosure } from './types-Du6VdoAg.js';
-import { StateLabel } from './recall-state-view.js';
-import { RecallContextDegradation } from './recall-context-composition.js';
-import './user-model.js';
-import './message-parts/index.js';
-import './bounded-jsonl-state.js';
-import './operator-doctor-types.js';
-import './external-wiki-config.js';
-import './contradiction-config.js';
-import './graph-path-scoring-config.js';
-import './background-generation-config.js';
-import './deep-recall-config.js';
-import './recall-navigation-config.js';
-import './recall-recognition-tier.js';
-import './causal-trajectory.js';
-import './objective-state.js';
-import './active-context-config.js';
-import './local-llm-config.js';
-import './semantic-merge-config.js';
-import './types-continuity.js';
-
 /**
  * Recall X-ray snapshot schema (issue #570, PR 1).
  *
@@ -38,16 +16,19 @@ import './types-continuity.js';
  * The shared renderer lands in PR 2 at `recall-xray-renderer.ts`.  Do not
  * fork formatting logic into other surfaces; extend the renderer.
  */
-
+import { type RetrievedMemoryProvenance } from "./memory-provenance.js";
+import type { RecallDisclosure, RecallTierExplain } from "./types.js";
+import type { StateLabel } from "./recall-state-view.js";
+import type { RecallContextDegradation } from "./recall-context-composition.js";
 /**
  * Estimate token cost of a payload for X-ray disclosure accounting.
  */
-declare function estimateRecallTokens(text: string | null | undefined): number;
+export declare function estimateRecallTokens(text: string | null | undefined): number;
 /**
  * Aggregated per-disclosure token spend summary, computed by the
  * renderer from a snapshot's results.  Non-negative integers.
  */
-interface RecallXrayDisclosureSummary {
+export interface RecallXrayDisclosureSummary {
     chunk: {
         count: number;
         estimatedTokens: number;
@@ -76,9 +57,9 @@ interface RecallXrayDisclosureSummary {
  *   - `RetrievalTier`     — direct-answer eligibility ladder.
  *   - `RecallXrayServedBy` — which source materialized each result.
  */
-type RecallXrayServedBy = "direct-answer" | "hybrid" | "graph" | "recent-scan" | "procedural" | "review-context" | "lcm-file-parts" | "lcm-tool-parts";
-declare const RECALL_XRAY_SERVED_BY_VALUES: readonly RecallXrayServedBy[];
-declare function isRecallXrayServedBy(value: unknown): value is RecallXrayServedBy;
+export type RecallXrayServedBy = "direct-answer" | "hybrid" | "graph" | "recent-scan" | "procedural" | "review-context" | "lcm-file-parts" | "lcm-tool-parts";
+export declare const RECALL_XRAY_SERVED_BY_VALUES: readonly RecallXrayServedBy[];
+export declare function isRecallXrayServedBy(value: unknown): value is RecallXrayServedBy;
 /**
  * Score decomposition for a single X-ray result.
  *
@@ -87,7 +68,7 @@ declare function isRecallXrayServedBy(value: unknown): value is RecallXrayServed
  * reports importance + tier prior, etc.  The only guaranteed field is
  * `final`, which is the post-combination score used for ordering.
  */
-interface RecallXrayScoreDecomposition {
+export interface RecallXrayScoreDecomposition {
     vector?: number;
     bm25?: number;
     importance?: number;
@@ -100,7 +81,7 @@ interface RecallXrayScoreDecomposition {
 /**
  * Per-result breakdown inside an X-ray snapshot.
  */
-interface RecallXrayResult {
+export interface RecallXrayResult {
     memoryId: string;
     path: string;
     servedBy: RecallXrayServedBy;
@@ -207,7 +188,7 @@ interface RecallXrayResult {
  * many it let through.  Used by X-ray consumers to render the filter
  * ladder above the per-result breakdown.
  */
-interface RecallFilterTrace {
+export interface RecallFilterTrace {
     name: string;
     considered: number;
     admitted: number;
@@ -226,7 +207,7 @@ interface RecallFilterTrace {
  * `null` means no peer profile was injected (peer not registered, feature
  * disabled, or peer has no profile fields).
  */
-interface RecallXrayPeerProfileInjection {
+export interface RecallXrayPeerProfileInjection {
     /** The peer id whose profile was injected. */
     peerId: string;
     /**
@@ -239,7 +220,7 @@ interface RecallXrayPeerProfileInjection {
  * The unified X-ray snapshot.  CLI, HTTP, and MCP surfaces all render
  * this same shape through the shared renderer (CLAUDE.md rule 22).
  */
-interface RecallXraySnapshot {
+export interface RecallXraySnapshot {
     /** Stable v1 tag so downstream consumers can version-gate their parsers. */
     schemaVersion: "1";
     query: string;
@@ -285,7 +266,7 @@ interface RecallXraySnapshot {
      */
     degradation?: RecallContextDegradation;
 }
-interface BuildXraySnapshotInput {
+export interface BuildXraySnapshotInput {
     query: string;
     tierExplain?: RecallTierExplain | null;
     results?: RecallXrayResult[];
@@ -315,14 +296,14 @@ interface BuildXraySnapshotInput {
  * shallow-copied so caller mutation after build cannot tear the
  * returned snapshot.
  */
-declare function buildXraySnapshot(input: BuildXraySnapshotInput): RecallXraySnapshot;
+export declare function buildXraySnapshot(input: BuildXraySnapshotInput): RecallXraySnapshot;
 /**
  * Mutable builder used by the orchestrator to accumulate X-ray fields
  * as recall progresses.  Call `build()` to get the finalized
  * immutable-ish snapshot.  All inputs are validated at insert time so
  * a malformed entry cannot poison the snapshot later.
  */
-declare class RecallXrayBuilder {
+export declare class RecallXrayBuilder {
     private readonly query;
     private readonly sessionKey;
     private namespace;
@@ -364,6 +345,5 @@ declare class RecallXrayBuilder {
  * results.  Pure helper — used by the markdown renderer to print a
  * "per-disclosure token spend" line and exposed for tests / surfaces.
  */
-declare function summarizeDisclosureTokens(results: ReadonlyArray<Pick<RecallXrayResult, "disclosure" | "estimatedTokens">>): RecallXrayDisclosureSummary;
-
-export { type BuildXraySnapshotInput, RECALL_XRAY_SERVED_BY_VALUES, type RecallFilterTrace, RecallXrayBuilder, type RecallXrayDisclosureSummary, type RecallXrayPeerProfileInjection, type RecallXrayResult, type RecallXrayScoreDecomposition, type RecallXrayServedBy, type RecallXraySnapshot, buildXraySnapshot, estimateRecallTokens, isRecallXrayServedBy, summarizeDisclosureTokens };
+export declare function summarizeDisclosureTokens(results: ReadonlyArray<Pick<RecallXrayResult, "disclosure" | "estimatedTokens">>): RecallXrayDisclosureSummary;
+//# sourceMappingURL=recall-xray.d.ts.map

package/dist/recall-xray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-xray.d.ts","sourceRoot":"","sources":["../src/recall-xray.ts"],"names":[],"mappings":"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"}

package/dist/recall-xray.js

@@ -5,11 +5,11 @@ import {
   estimateRecallTokens,
   isRecallXrayServedBy,
   summarizeDisclosureTokens
-} from "./chunk-WH7RINGG.js";
+} from "./chunk-C5CPYMLX.js";
 import "./chunk-TOTT6S2V.js";
-import "./chunk-4UVJ6EIT.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
+import "./chunk-FNQEXI3D.js";
 import "./chunk-PZ5AY32C.js";
 export {
   RECALL_XRAY_SERVED_BY_VALUES,

package/dist/reconcile/cursor.d.ts

@@ -1,33 +1,12 @@
-import { ReconcileSemanticAgreement, ReconcilePlanEntry } from './plan.js';
-import '../offline-sync.js';
-import '../offline-sync-file-io.js';
-import '../types-Du6VdoAg.js';
-import '../message-parts/index.js';
-import '../bounded-jsonl-state.js';
-import '../operator-doctor-types.js';
-import '../external-wiki-config.js';
-import '../recall-state-view.js';
-import '../contradiction-config.js';
-import '../graph-path-scoring-config.js';
-import '../background-generation-config.js';
-import '../deep-recall-config.js';
-import '../recall-navigation-config.js';
-import '../recall-recognition-tier.js';
-import '../causal-trajectory.js';
-import '../objective-state.js';
-import '../active-context-config.js';
-import '../local-llm-config.js';
-import '../semantic-merge-config.js';
-import '../types-continuity.js';
-
-type ConvergeRefreshTarget = "local" | "receiver";
-interface ConvergeCursorFileState {
+import { type ReconcilePlanEntry, type ReconcileSemanticAgreement } from "./plan.js";
+export type ConvergeRefreshTarget = "local" | "receiver";
+export interface ConvergeCursorFileState {
     path: string;
     sha256: string;
     mtimeMs?: number;
     bytes?: number;
 }
-interface ConvergeCursorState {
+export interface ConvergeCursorState {
     version: 1;
     peerUrl: string;
     namespace: string;
@@ -37,9 +16,9 @@ interface ConvergeCursorState {
     completedPaths?: string[];
     pendingRefreshes?: ConvergeRefreshTarget[];
 }
-declare function normalizeConvergePeerUrl(peerUrl: string): string;
-declare function hashPeerNamespace(peerUrl: string, namespace: string): string;
-declare function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, namespace: string): string;
+export declare function normalizeConvergePeerUrl(peerUrl: string): string;
+export declare function hashPeerNamespace(peerUrl: string, namespace: string): string;
+export declare function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, namespace: string): string;
 /**
  * Persistent identity cache location for a (peerUrl, namespace) pair, next
  * to the cursor that governs the same pair. The cache stores the parsed
@@ -47,16 +26,15 @@ declare function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, n
  * skips the per-file read + frontmatter parse + content-hash identity work
  * entirely (the dominant boot-scale plan cost on both sides).
  */
-declare function convergeIdentityCachePath(memoryDir: string, peerUrl: string, namespace: string): string;
-declare function deriveConvergeCursorBase(entries: readonly ReconcilePlanEntry[], namespace: string, priorSemanticAgreements?: readonly ReconcileSemanticAgreement[]): Pick<ConvergeCursorState, "baseFiles" | "semanticAgreements">;
-declare function normalizeConvergeCursor(input: unknown): ConvergeCursorState;
-declare function readConvergeCursor(cursorPath: string): Promise<ConvergeCursorState | null>;
-declare function writeConvergeCursor(cursorPath: string, cursor: ConvergeCursorState): Promise<void>;
-declare function markConvergeRefreshPending(cursorPath: string, options: {
+export declare function convergeIdentityCachePath(memoryDir: string, peerUrl: string, namespace: string): string;
+export declare function deriveConvergeCursorBase(entries: readonly ReconcilePlanEntry[], namespace: string, priorSemanticAgreements?: readonly ReconcileSemanticAgreement[]): Pick<ConvergeCursorState, "baseFiles" | "semanticAgreements">;
+export declare function normalizeConvergeCursor(input: unknown): ConvergeCursorState;
+export declare function readConvergeCursor(cursorPath: string): Promise<ConvergeCursorState | null>;
+export declare function writeConvergeCursor(cursorPath: string, cursor: ConvergeCursorState): Promise<void>;
+export declare function markConvergeRefreshPending(cursorPath: string, options: {
     peerUrl: string;
     namespace: string;
     target: ConvergeRefreshTarget;
 }): Promise<void>;
-declare function clearConvergeRefreshPending(cursorPath: string, target: ConvergeRefreshTarget): Promise<void>;
-
-export { type ConvergeCursorFileState, type ConvergeCursorState, type ConvergeRefreshTarget, clearConvergeRefreshPending, convergeIdentityCachePath, defaultConvergeCursorPath, deriveConvergeCursorBase, hashPeerNamespace, markConvergeRefreshPending, normalizeConvergeCursor, normalizeConvergePeerUrl, readConvergeCursor, writeConvergeCursor };
+export declare function clearConvergeRefreshPending(cursorPath: string, target: ConvergeRefreshTarget): Promise<void>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/reconcile/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/reconcile/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,0BAA0B,EAAwB,MAAM,WAAW,CAAC;AAE3G,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,kBAAkB,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAC5C;AAaD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAahE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvG;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvG;AAsBD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,SAAS,EAAE,MAAM,EACjB,uBAAuB,GAAE,SAAS,0BAA0B,EAAO,GAClE,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,oBAAoB,CAAC,CAoB/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA+D3E;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAShG;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxG;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;CAC/B,GACA,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlH"}