@remnic/core 9.65.8 → 9.66.1

package/dist/qmd.d.ts

@@ -1,10 +1,9 @@
-export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as runCommandWithTimeoutForTest, D as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-DWMAGA5l.js';
+export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as runCommandWithTimeoutForTest, D as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-BZgbJm0g.js';
 export { QmdStatusReport, parseQmdStatusOutput } from './qmd-status.js';
 import './search/port.js';
-import './types-djxQlxJ7.js';
+import './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-concurrency-config.d.ts

@@ -1,7 +1,6 @@
-import { P as PluginConfig } from './types-djxQlxJ7.js';
+import { P as PluginConfig } from './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-deep.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Budgeted REFINE/EXPAND/STOP loop (issue #2332 first slice).
+ *
+ * Pure state stepper. Policy is injected. No LLM, no orchestrator recall,
+ * no IO. Surfaces and parseConfig wait for a later PR — config.ts is at
+ * its fileSizeGrandfather ceiling.
+ *
+ * Budget 0 stops without calling the policy. Unknown actions throw.
+ */
+declare const DEEP_RECALL_ACTIONS: readonly ["refine", "expand", "stop"];
+type DeepRecallAction = (typeof DEEP_RECALL_ACTIONS)[number];
+interface DeepRecallState {
+    query: string;
+    workingSet: readonly string[];
+    frontier: readonly string[];
+    budget: number;
+}
+interface DeepRecallTraceStep {
+    action: DeepRecallAction;
+    budget: number;
+    workingSet: readonly string[];
+    frontier: readonly string[];
+}
+interface DeepRecallStepResult {
+    state: DeepRecallState;
+    step: DeepRecallTraceStep;
+}
+interface DeepRecallResult {
+    state: DeepRecallState;
+    trace: readonly DeepRecallTraceStep[];
+}
+type DeepRecallPolicy = (state: DeepRecallState) => string;
+declare function isDeepRecallAction(value: unknown): value is DeepRecallAction;
+declare function runDeepRecallStep(state: DeepRecallState, action: string): DeepRecallStepResult;
+declare function runDeepRecall(state: DeepRecallState, policy: DeepRecallPolicy): DeepRecallResult;
+
+export { DEEP_RECALL_ACTIONS, type DeepRecallAction, type DeepRecallPolicy, type DeepRecallResult, type DeepRecallState, type DeepRecallStepResult, type DeepRecallTraceStep, isDeepRecallAction, runDeepRecall, runDeepRecallStep };

package/dist/recall-deep.js

@@ -0,0 +1,81 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep.ts
+var DEEP_RECALL_ACTIONS = ["refine", "expand", "stop"];
+function isDeepRecallAction(value) {
+  return typeof value === "string" && DEEP_RECALL_ACTIONS.includes(value);
+}
+function snapshot(state) {
+  return {
+    query: state.query,
+    workingSet: [...state.workingSet],
+    frontier: [...state.frontier],
+    budget: state.budget
+  };
+}
+function runDeepRecallStep(state, action) {
+  if (!isDeepRecallAction(action)) {
+    throw new Error(
+      `unknown deep recall action: ${JSON.stringify(action)}. Valid: ${DEEP_RECALL_ACTIONS.join(", ")}`
+    );
+  }
+  if (!Number.isFinite(state.budget) || state.budget <= 0 || action === "stop") {
+    const stopped = snapshot(state);
+    return {
+      state: stopped,
+      step: {
+        action: "stop",
+        budget: stopped.budget,
+        workingSet: stopped.workingSet,
+        frontier: stopped.frontier
+      }
+    };
+  }
+  const next = snapshot(state);
+  next.budget = state.budget - 1;
+  if (action === "expand") {
+    const [head, ...rest] = next.frontier;
+    if (head !== void 0 && !next.workingSet.includes(head)) {
+      next.workingSet = [...next.workingSet, head];
+    }
+    next.frontier = rest;
+  }
+  return {
+    state: next,
+    step: {
+      action,
+      budget: next.budget,
+      workingSet: next.workingSet,
+      frontier: next.frontier
+    }
+  };
+}
+function runDeepRecall(state, policy) {
+  const trace = [];
+  let current = snapshot(state);
+  while (true) {
+    if (!Number.isFinite(current.budget) || current.budget <= 0) {
+      const stopped = snapshot(current);
+      trace.push({
+        action: "stop",
+        budget: stopped.budget,
+        workingSet: stopped.workingSet,
+        frontier: stopped.frontier
+      });
+      return { state: stopped, trace };
+    }
+    const stepped = runDeepRecallStep(current, policy(current));
+    trace.push(stepped.step);
+    current = stepped.state;
+    if (stepped.step.action === "stop") {
+      return { state: current, trace };
+    }
+  }
+}
+export {
+  DEEP_RECALL_ACTIONS,
+  isDeepRecallAction,
+  runDeepRecall,
+  runDeepRecallStep
+};
+//# sourceMappingURL=recall-deep.js.map

package/dist/recall-deep.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep.ts"],"sourcesContent":["/**\n * Budgeted REFINE/EXPAND/STOP loop (issue #2332 first slice).\n *\n * Pure state stepper. Policy is injected. No LLM, no orchestrator recall,\n * no IO. Surfaces and parseConfig wait for a later PR — config.ts is at\n * its fileSizeGrandfather ceiling.\n *\n * Budget 0 stops without calling the policy. Unknown actions throw.\n */\nexport const DEEP_RECALL_ACTIONS = [\"refine\", \"expand\", \"stop\"] as const;\n\nexport type DeepRecallAction = (typeof DEEP_RECALL_ACTIONS)[number];\n\nexport interface DeepRecallState {\n  query: string;\n  workingSet: readonly string[];\n  frontier: readonly string[];\n  budget: number;\n}\n\nexport interface DeepRecallTraceStep {\n  action: DeepRecallAction;\n  budget: number;\n  workingSet: readonly string[];\n  frontier: readonly string[];\n}\n\nexport interface DeepRecallStepResult {\n  state: DeepRecallState;\n  step: DeepRecallTraceStep;\n}\n\nexport interface DeepRecallResult {\n  state: DeepRecallState;\n  trace: readonly DeepRecallTraceStep[];\n}\n\nexport type DeepRecallPolicy = (state: DeepRecallState) => string;\n\nexport function isDeepRecallAction(value: unknown): value is DeepRecallAction {\n  return typeof value === \"string\" && (DEEP_RECALL_ACTIONS as readonly string[]).includes(value);\n}\n\nfunction snapshot(state: DeepRecallState): DeepRecallState {\n  return {\n    query: state.query,\n    workingSet: [...state.workingSet],\n    frontier: [...state.frontier],\n    budget: state.budget,\n  };\n}\n\nexport function runDeepRecallStep(state: DeepRecallState, action: string): DeepRecallStepResult {\n  if (!isDeepRecallAction(action)) {\n    throw new Error(\n      `unknown deep recall action: ${JSON.stringify(action)}. Valid: ${DEEP_RECALL_ACTIONS.join(\", \")}`,\n    );\n  }\n  if (!Number.isFinite(state.budget) || state.budget <= 0 || action === \"stop\") {\n    const stopped = snapshot(state);\n    return {\n      state: stopped,\n      step: {\n        action: \"stop\",\n        budget: stopped.budget,\n        workingSet: stopped.workingSet,\n        frontier: stopped.frontier,\n      },\n    };\n  }\n\n  const next = snapshot(state);\n  next.budget = state.budget - 1;\n  if (action === \"expand\") {\n    const [head, ...rest] = next.frontier;\n    if (head !== undefined && !next.workingSet.includes(head)) {\n      next.workingSet = [...next.workingSet, head];\n    }\n    next.frontier = rest;\n  }\n  return {\n    state: next,\n    step: {\n      action,\n      budget: next.budget,\n      workingSet: next.workingSet,\n      frontier: next.frontier,\n    },\n  };\n}\n\nexport function runDeepRecall(state: DeepRecallState, policy: DeepRecallPolicy): DeepRecallResult {\n  const trace: DeepRecallTraceStep[] = [];\n  let current = snapshot(state);\n  while (true) {\n    if (!Number.isFinite(current.budget) || current.budget <= 0) {\n      const stopped = snapshot(current);\n      trace.push({\n        action: \"stop\",\n        budget: stopped.budget,\n        workingSet: stopped.workingSet,\n        frontier: stopped.frontier,\n      });\n      return { state: stopped, trace };\n    }\n    const stepped = runDeepRecallStep(current, policy(current));\n    trace.push(stepped.step);\n    current = stepped.state;\n    if (stepped.step.action === \"stop\") {\n      return { state: current, trace };\n    }\n  }\n}\n"],"mappings":";;;AASO,IAAM,sBAAsB,CAAC,UAAU,UAAU,MAAM;AA8BvD,SAAS,mBAAmB,OAA2C;AAC5E,SAAO,OAAO,UAAU,YAAa,oBAA0C,SAAS,KAAK;AAC/F;AAEA,SAAS,SAAS,OAAyC;AACzD,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,UAAU,CAAC,GAAG,MAAM,QAAQ;AAAA,IAC5B,QAAQ,MAAM;AAAA,EAChB;AACF;AAEO,SAAS,kBAAkB,OAAwB,QAAsC;AAC9F,MAAI,CAAC,mBAAmB,MAAM,GAAG;AAC/B,UAAM,IAAI;AAAA,MACR,+BAA+B,KAAK,UAAU,MAAM,CAAC,YAAY,oBAAoB,KAAK,IAAI,CAAC;AAAA,IACjG;AAAA,EACF;AACA,MAAI,CAAC,OAAO,SAAS,MAAM,MAAM,KAAK,MAAM,UAAU,KAAK,WAAW,QAAQ;AAC5E,UAAM,UAAU,SAAS,KAAK;AAC9B,WAAO;AAAA,MACL,OAAO;AAAA,MACP,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,OAAO,SAAS,KAAK;AAC3B,OAAK,SAAS,MAAM,SAAS;AAC7B,MAAI,WAAW,UAAU;AACvB,UAAM,CAAC,MAAM,GAAG,IAAI,IAAI,KAAK;AAC7B,QAAI,SAAS,UAAa,CAAC,KAAK,WAAW,SAAS,IAAI,GAAG;AACzD,WAAK,aAAa,CAAC,GAAG,KAAK,YAAY,IAAI;AAAA,IAC7C;AACA,SAAK,WAAW;AAAA,EAClB;AACA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,MACJ;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,YAAY,KAAK;AAAA,MACjB,UAAU,KAAK;AAAA,IACjB;AAAA,EACF;AACF;AAEO,SAAS,cAAc,OAAwB,QAA4C;AAChG,QAAM,QAA+B,CAAC;AACtC,MAAI,UAAU,SAAS,KAAK;AAC5B,SAAO,MAAM;AACX,QAAI,CAAC,OAAO,SAAS,QAAQ,MAAM,KAAK,QAAQ,UAAU,GAAG;AAC3D,YAAM,UAAU,SAAS,OAAO;AAChC,YAAM,KAAK;AAAA,QACT,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,MACpB,CAAC;AACD,aAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IACjC;AACA,UAAM,UAAU,kBAAkB,SAAS,OAAO,OAAO,CAAC;AAC1D,UAAM,KAAK,QAAQ,IAAI;AACvB,cAAU,QAAQ;AAClB,QAAI,QAAQ,KAAK,WAAW,QAAQ;AAClC,aAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IACjC;AAAA,EACF;AACF;","names":[]}

package/dist/recall-disclosure-escalation.d.ts

@@ -1,7 +1,6 @@
-import { o as RecallDisclosure } from './types-djxQlxJ7.js';
+import { o as RecallDisclosure } from './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

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

@@ -1,11 +1,10 @@
 import { LastRecallSnapshot } from './recall-state.js';
-import { b as RecallTierExplain } from './types-djxQlxJ7.js';
+import { b as RecallTierExplain } from './types-CIpfYz1I.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-explain-renderer.js

@@ -5,10 +5,10 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-CFVTRUR3.js";
+} from "./chunk-H6RSANGQ.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-NPIBN2VL.js";
-import "./chunk-MINHJ55X.js";
+import "./chunk-LK4TOYPU.js";
+import "./chunk-XXW32OL7.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

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

@@ -1,7 +1,6 @@
-import { Q as QmdSearchResult, M as MemoryFile } from './types-djxQlxJ7.js';
+import { Q as QmdSearchResult, M as MemoryFile } from './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-navigate.d.ts

@@ -0,0 +1,70 @@
+import { o as RecallDisclosure } from './types-CIpfYz1I.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 './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+
+/**
+ * Recall navigation helpers (issue #1956 first slice).
+ *
+ * Pure expand/traverse over disclosure levels and typed links. No LLM, no IO.
+ * Surfaces (MCP/HTTP/CLI) and parseConfig wiring wait for a later PR —
+ * config.ts is at its fileSizeGrandfather ceiling.
+ *
+ * Budget 0 is off (unavailable). Empty means the step ran and found nothing.
+ */
+
+declare const RECALL_NAV_LINK_TYPES: readonly ["supports", "contradicts", "elaborates", "supersedes", "causes"];
+type RecallNavLinkType = (typeof RECALL_NAV_LINK_TYPES)[number];
+interface RecallNavBudget {
+    budget: number;
+}
+interface RecallNavEdge {
+    targetId: string;
+    linkType: string;
+    preview?: string;
+}
+interface RecallNavNode {
+    id: string;
+    disclosure: RecallDisclosure;
+    payloads?: Partial<Record<RecallDisclosure, string>>;
+    links?: readonly RecallNavEdge[];
+}
+interface RecallNavNeighbor {
+    id: string;
+    linkType: RecallNavLinkType;
+    preview?: string;
+}
+type RecallNavExpandResult = {
+    status: "ok";
+    node: {
+        id: string;
+        disclosure: RecallDisclosure;
+        text: string;
+    };
+} | {
+    status: "empty";
+} | {
+    status: "unavailable";
+    reason: "budget_off";
+};
+type RecallNavTraverseResult = {
+    status: "ok";
+    neighbors: readonly RecallNavNeighbor[];
+} | {
+    status: "empty";
+} | {
+    status: "unavailable";
+    reason: "budget_off";
+};
+declare function isRecallNavLinkType(value: unknown): value is RecallNavLinkType;
+declare function expandRecallNode(node: RecallNavNode, options: RecallNavBudget): RecallNavExpandResult;
+declare function traverseRecallLink(from: RecallNavNode, linkType: string, options: RecallNavBudget): RecallNavTraverseResult;
+
+export { RECALL_NAV_LINK_TYPES, type RecallNavBudget, type RecallNavEdge, type RecallNavExpandResult, type RecallNavLinkType, type RecallNavNeighbor, type RecallNavNode, type RecallNavTraverseResult, expandRecallNode, isRecallNavLinkType, traverseRecallLink };

package/dist/recall-navigate.js

@@ -0,0 +1,51 @@
+import {
+  RECALL_DISCLOSURE_LEVELS
+} from "./chunk-XXW32OL7.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate.ts
+var RECALL_NAV_LINK_TYPES = [
+  "supports",
+  "contradicts",
+  "elaborates",
+  "supersedes",
+  "causes"
+];
+function isRecallNavLinkType(value) {
+  return typeof value === "string" && RECALL_NAV_LINK_TYPES.includes(value);
+}
+function expandRecallNode(node, options) {
+  if (!Number.isFinite(options.budget) || options.budget <= 0) {
+    return { status: "unavailable", reason: "budget_off" };
+  }
+  const current = RECALL_DISCLOSURE_LEVELS.indexOf(node.disclosure);
+  const next = current >= 0 ? RECALL_DISCLOSURE_LEVELS[current + 1] : void 0;
+  if (next === void 0) return { status: "empty" };
+  const text = node.payloads?.[next];
+  if (typeof text !== "string") return { status: "empty" };
+  return { status: "ok", node: { id: node.id, disclosure: next, text } };
+}
+function traverseRecallLink(from, linkType, options) {
+  if (!isRecallNavLinkType(linkType)) {
+    throw new Error(
+      `unknown recall nav linkType: ${JSON.stringify(linkType)}. Valid: ${RECALL_NAV_LINK_TYPES.join(", ")}`
+    );
+  }
+  if (!Number.isFinite(options.budget) || options.budget <= 0) {
+    return { status: "unavailable", reason: "budget_off" };
+  }
+  const neighbors = (from.links ?? []).filter((link) => link.linkType === linkType).map((link) => {
+    const neighbor = { id: link.targetId, linkType };
+    if (link.preview !== void 0) neighbor.preview = link.preview;
+    return neighbor;
+  }).sort((a, b) => a.id.localeCompare(b.id, "en"));
+  if (neighbors.length === 0) return { status: "empty" };
+  return { status: "ok", neighbors };
+}
+export {
+  RECALL_NAV_LINK_TYPES,
+  expandRecallNode,
+  isRecallNavLinkType,
+  traverseRecallLink
+};
+//# sourceMappingURL=recall-navigate.js.map

package/dist/recall-navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate.ts"],"sourcesContent":["/**\n * Recall navigation helpers (issue #1956 first slice).\n *\n * Pure expand/traverse over disclosure levels and typed links. No LLM, no IO.\n * Surfaces (MCP/HTTP/CLI) and parseConfig wiring wait for a later PR —\n * config.ts is at its fileSizeGrandfather ceiling.\n *\n * Budget 0 is off (unavailable). Empty means the step ran and found nothing.\n */\nimport {\n  RECALL_DISCLOSURE_LEVELS,\n  type RecallDisclosure,\n} from \"./types.js\";\n\nexport const RECALL_NAV_LINK_TYPES = [\n  \"supports\",\n  \"contradicts\",\n  \"elaborates\",\n  \"supersedes\",\n  \"causes\",\n] as const;\n\nexport type RecallNavLinkType = (typeof RECALL_NAV_LINK_TYPES)[number];\n\nexport interface RecallNavBudget {\n  budget: number;\n}\n\nexport interface RecallNavEdge {\n  targetId: string;\n  linkType: string;\n  preview?: string;\n}\n\nexport interface RecallNavNode {\n  id: string;\n  disclosure: RecallDisclosure;\n  payloads?: Partial<Record<RecallDisclosure, string>>;\n  links?: readonly RecallNavEdge[];\n}\n\nexport interface RecallNavNeighbor {\n  id: string;\n  linkType: RecallNavLinkType;\n  preview?: string;\n}\n\nexport type RecallNavExpandResult =\n  | { status: \"ok\"; node: { id: string; disclosure: RecallDisclosure; text: string } }\n  | { status: \"empty\" }\n  | { status: \"unavailable\"; reason: \"budget_off\" };\n\nexport type RecallNavTraverseResult =\n  | { status: \"ok\"; neighbors: readonly RecallNavNeighbor[] }\n  | { status: \"empty\" }\n  | { status: \"unavailable\"; reason: \"budget_off\" };\n\nexport function isRecallNavLinkType(value: unknown): value is RecallNavLinkType {\n  return typeof value === \"string\" && (RECALL_NAV_LINK_TYPES as readonly string[]).includes(value);\n}\n\nexport function expandRecallNode(\n  node: RecallNavNode,\n  options: RecallNavBudget,\n): RecallNavExpandResult {\n  if (!Number.isFinite(options.budget) || options.budget <= 0) {\n    return { status: \"unavailable\", reason: \"budget_off\" };\n  }\n  const current = RECALL_DISCLOSURE_LEVELS.indexOf(node.disclosure);\n  const next = current >= 0 ? RECALL_DISCLOSURE_LEVELS[current + 1] : undefined;\n  if (next === undefined) return { status: \"empty\" };\n  const text = node.payloads?.[next];\n  if (typeof text !== \"string\") return { status: \"empty\" };\n  return { status: \"ok\", node: { id: node.id, disclosure: next, text } };\n}\n\nexport function traverseRecallLink(\n  from: RecallNavNode,\n  linkType: string,\n  options: RecallNavBudget,\n): RecallNavTraverseResult {\n  if (!isRecallNavLinkType(linkType)) {\n    throw new Error(\n      `unknown recall nav linkType: ${JSON.stringify(linkType)}. Valid: ${RECALL_NAV_LINK_TYPES.join(\", \")}`,\n    );\n  }\n  if (!Number.isFinite(options.budget) || options.budget <= 0) {\n    return { status: \"unavailable\", reason: \"budget_off\" };\n  }\n  const neighbors = (from.links ?? [])\n    .filter((link) => link.linkType === linkType)\n    .map((link) => {\n      const neighbor: RecallNavNeighbor = { id: link.targetId, linkType };\n      if (link.preview !== undefined) neighbor.preview = link.preview;\n      return neighbor;\n    })\n    .sort((a, b) => a.id.localeCompare(b.id, \"en\"));\n  if (neighbors.length === 0) return { status: \"empty\" };\n  return { status: \"ok\", neighbors };\n}\n"],"mappings":";;;;;;AAcO,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAqCO,SAAS,oBAAoB,OAA4C;AAC9E,SAAO,OAAO,UAAU,YAAa,sBAA4C,SAAS,KAAK;AACjG;AAEO,SAAS,iBACd,MACA,SACuB;AACvB,MAAI,CAAC,OAAO,SAAS,QAAQ,MAAM,KAAK,QAAQ,UAAU,GAAG;AAC3D,WAAO,EAAE,QAAQ,eAAe,QAAQ,aAAa;AAAA,EACvD;AACA,QAAM,UAAU,yBAAyB,QAAQ,KAAK,UAAU;AAChE,QAAM,OAAO,WAAW,IAAI,yBAAyB,UAAU,CAAC,IAAI;AACpE,MAAI,SAAS,OAAW,QAAO,EAAE,QAAQ,QAAQ;AACjD,QAAM,OAAO,KAAK,WAAW,IAAI;AACjC,MAAI,OAAO,SAAS,SAAU,QAAO,EAAE,QAAQ,QAAQ;AACvD,SAAO,EAAE,QAAQ,MAAM,MAAM,EAAE,IAAI,KAAK,IAAI,YAAY,MAAM,KAAK,EAAE;AACvE;AAEO,SAAS,mBACd,MACA,UACA,SACyB;AACzB,MAAI,CAAC,oBAAoB,QAAQ,GAAG;AAClC,UAAM,IAAI;AAAA,MACR,gCAAgC,KAAK,UAAU,QAAQ,CAAC,YAAY,sBAAsB,KAAK,IAAI,CAAC;AAAA,IACtG;AAAA,EACF;AACA,MAAI,CAAC,OAAO,SAAS,QAAQ,MAAM,KAAK,QAAQ,UAAU,GAAG;AAC3D,WAAO,EAAE,QAAQ,eAAe,QAAQ,aAAa;AAAA,EACvD;AACA,QAAM,aAAa,KAAK,SAAS,CAAC,GAC/B,OAAO,CAAC,SAAS,KAAK,aAAa,QAAQ,EAC3C,IAAI,CAAC,SAAS;AACb,UAAM,WAA8B,EAAE,IAAI,KAAK,UAAU,SAAS;AAClE,QAAI,KAAK,YAAY,OAAW,UAAS,UAAU,KAAK;AACxD,WAAO;AAAA,EACT,CAAC,EACA,KAAK,CAAC,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,IAAI,IAAI,CAAC;AAChD,MAAI,UAAU,WAAW,EAAG,QAAO,EAAE,QAAQ,QAAQ;AACrD,SAAO,EAAE,QAAQ,MAAM,UAAU;AACnC;","names":[]}

package/dist/recall-planner-llm.d.ts

@@ -1,9 +1,8 @@
-import { R as RecallPlanMode, P as PluginConfig } from './types-djxQlxJ7.js';
+import { R as RecallPlanMode, P as PluginConfig } from './types-CIpfYz1I.js';
 import { CapabilitySet } from './capabilities.js';
 import { FallbackLlmClient, FallbackLlmOptions } from './fallback-llm.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-planner-llm.js

@@ -6,7 +6,7 @@ import {
   FallbackLlmClient,
   fallbackLlmRuntimeContextFromConfig,
   gatewayTaskChainOptions
-} from "./chunk-UW5NPZJ2.js";
+} from "./chunk-JALOAKSZ.js";
 import "./chunk-QIEUU4UK.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";

package/dist/recall-state-view-wire.d.ts

@@ -0,0 +1,14 @@
+import { StateViewResult } from './recall-state-view.js';
+
+/**
+ * Recall inject seam for state views (issue #1952).
+ *
+ * parseConfig cannot grow (fileSizeGrandfather). Operators set
+ * `recallStateViews` on the live PluginConfig extra field. Default false
+ * is identity. Use parseRecallStateViews — do not read a scattered
+ * config flag property here.
+ */
+
+declare function applyRecallStateViews<T extends StateViewResult>(results: T[], query: string, config: unknown): T[];
+
+export { applyRecallStateViews };

package/dist/recall-state-view-wire.js

@@ -0,0 +1,11 @@
+import {
+  applyRecallStateViews
+} from "./chunk-WFCWP4XU.js";
+import "./chunk-HVAEXYPL.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  applyRecallStateViews
+};
+//# sourceMappingURL=recall-state-view-wire.js.map

package/dist/recall-state-view.d.ts

@@ -0,0 +1,25 @@
+type StateLabel = "current" | "historical" | "transition";
+interface StateViewChain {
+    predecessorId: string;
+    successorId: string;
+    supersededAt?: string;
+}
+interface StateViewResult {
+    id?: string;
+    docid?: string;
+    status?: string;
+    supersededBy?: string;
+    supersededAt?: string;
+    stateLabel?: StateLabel;
+}
+declare const DEFAULT_RECALL_STATE_VIEWS = false;
+declare function parseRecallStateViews(raw: unknown): boolean;
+declare function isChangeOrientedQuery(query: string): boolean;
+declare function shouldWidenSuperseded(successorId: string | undefined, candidateIds: ReadonlySet<string>): boolean;
+declare function formatSupersededPrefix(date: string, successorId: string): string;
+declare function resultStateViewId(result: StateViewResult): string;
+declare function annotateStateView<T extends StateViewResult>(results: T[], query: string, chains: readonly StateViewChain[], options?: {
+    enabled?: boolean;
+}): T[];
+
+export { DEFAULT_RECALL_STATE_VIEWS, type StateLabel, type StateViewChain, type StateViewResult, annotateStateView, formatSupersededPrefix, isChangeOrientedQuery, parseRecallStateViews, resultStateViewId, shouldWidenSuperseded };

package/dist/recall-state-view.js

@@ -0,0 +1,22 @@
+import {
+  DEFAULT_RECALL_STATE_VIEWS,
+  annotateStateView,
+  formatSupersededPrefix,
+  isChangeOrientedQuery,
+  parseRecallStateViews,
+  resultStateViewId,
+  shouldWidenSuperseded
+} from "./chunk-HVAEXYPL.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DEFAULT_RECALL_STATE_VIEWS,
+  annotateStateView,
+  formatSupersededPrefix,
+  isChangeOrientedQuery,
+  parseRecallStateViews,
+  resultStateViewId,
+  shouldWidenSuperseded
+};
+//# sourceMappingURL=recall-state-view.js.map

package/dist/recall-state-view.js.map

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

package/dist/recall-state.d.ts

@@ -1,11 +1,10 @@
 import { HeldFileLockOptions } from './utils/serialize-mutations.js';
 import { SearchDegradation } from './search/port.js';
-import { R as RecallPlanMode, I as IdentityInjectionMode, b as RecallTierExplain } from './types-djxQlxJ7.js';
+import { R as RecallPlanMode, I as IdentityInjectionMode, b as RecallTierExplain } from './types-CIpfYz1I.js';
 import { IncludedMemory } from './included-memories.js';
 export { coerceIncludedMemories } from './included-memories.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-tag-filter.d.ts

@@ -1,9 +1,8 @@
 import { RecallFilterTrace } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-djxQlxJ7.js';
+import './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-timings.d.ts

@@ -1,7 +1,6 @@
-import { P as PluginConfig } from './types-djxQlxJ7.js';
+import { P as PluginConfig } from './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

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

@@ -1,11 +1,10 @@
 import { RecallXrayFormat } from './recall-xray-renderer.js';
-import { o as RecallDisclosure } from './types-djxQlxJ7.js';
+import { o as RecallDisclosure } from './types-CIpfYz1I.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-xray-cli.js

@@ -2,11 +2,11 @@ import {
   parseXrayBudgetFlag,
   parseXrayCliOptions,
   parseXrayDisclosureFlag
-} from "./chunk-UNUMFURP.js";
-import "./chunk-CFVTRUR3.js";
+} from "./chunk-X5PIDJ3L.js";
+import "./chunk-H6RSANGQ.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-NPIBN2VL.js";
-import "./chunk-MINHJ55X.js";
+import "./chunk-LK4TOYPU.js";
+import "./chunk-XXW32OL7.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

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

@@ -1,9 +1,8 @@
 import { RecallXraySnapshot } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-djxQlxJ7.js';
+import './types-CIpfYz1I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-xray-renderer.js

@@ -5,10 +5,10 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-CFVTRUR3.js";
+} from "./chunk-H6RSANGQ.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-NPIBN2VL.js";
-import "./chunk-MINHJ55X.js";
+import "./chunk-LK4TOYPU.js";
+import "./chunk-XXW32OL7.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/recall-xray.d.ts

@@ -1,9 +1,8 @@
 import { RetrievedMemoryProvenance } from './memory-provenance.js';
-import { b as RecallTierExplain, o as RecallDisclosure } from './types-djxQlxJ7.js';
+import { b as RecallTierExplain, o as RecallDisclosure } from './types-CIpfYz1I.js';
 import './user-model.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
-import './types-CM86alG1.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';

package/dist/recall-xray.js

@@ -5,8 +5,8 @@ import {
   estimateRecallTokens,
   isRecallXrayServedBy,
   summarizeDisclosureTokens
-} from "./chunk-NPIBN2VL.js";
-import "./chunk-MINHJ55X.js";
+} from "./chunk-LK4TOYPU.js";
+import "./chunk-XXW32OL7.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/reconcile/cursor.d.ts

@@ -1,10 +1,9 @@
 import { ReconcileSemanticAgreement, ReconcilePlanEntry } from './plan.js';
 import '../offline-sync.js';
 import '../offline-sync-file-io.js';
-import '../types-djxQlxJ7.js';
+import '../types-CIpfYz1I.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
-import '../types-CM86alG1.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
 import '../contradiction-config.js';

package/dist/reconcile/manifest.d.ts

@@ -1,8 +1,7 @@
-import { w as MemoryStatus, m as MemoryFrontmatter } from '../types-djxQlxJ7.js';
+import { w as MemoryStatus, m as MemoryFrontmatter } from '../types-CIpfYz1I.js';
 import { ReconcileFileState, ReconcilePlan, ReconcileSemanticAgreement } from './plan.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
-import '../types-CM86alG1.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
 import '../contradiction-config.js';

package/dist/reconcile/manifest.js

@@ -4,12 +4,12 @@ import {
   buildReconcileManifest,
   buildReconcileManifestFile,
   collapseActiveFactDuplicates
-} from "../chunk-XBGHAAKR.js";
+} from "../chunk-DDX6KIXF.js";
 import "../chunk-ZRUEP4IK.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-7RJUVTVF.js";
 import "../chunk-HBVPYRDW.js";
-import "../chunk-BEC4YBNA.js";
+import "../chunk-TVW4C7PV.js";
 import "../chunk-FFAZ2XFU.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-JDSVLVCG.js";
@@ -18,10 +18,10 @@ import "../chunk-JAKIDQB2.js";
 import "../chunk-GCGJW34D.js";
 import "../chunk-LQWOFU6L.js";
 import "../chunk-VUFL7X3H.js";
-import "../chunk-XQ3HXAQH.js";
+import "../chunk-ET2CNMLD.js";
 import "../chunk-A6XUJE5D.js";
-import "../chunk-5UZXUTVO.js";
 import "../chunk-VS2IYZRU.js";
+import "../chunk-5UZXUTVO.js";
 import "../chunk-3WCASNQZ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/reconcile/plan.d.ts

@@ -1,9 +1,8 @@
 import { OfflineSyncFileState } from '../offline-sync.js';
-import { a2 as ConvergeConflictPolicy } from '../types-djxQlxJ7.js';
+import { a2 as ConvergeConflictPolicy } from '../types-CIpfYz1I.js';
 import '../offline-sync-file-io.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
-import '../types-CM86alG1.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
 import '../contradiction-config.js';

package/dist/replay/normalizers/chatgpt.d.ts

@@ -1,8 +1,7 @@
 import { ReplayNormalizer } from '../types.js';
 import '../../message-parts/index.js';
-import '../../types-djxQlxJ7.js';
+import '../../types-CIpfYz1I.js';
 import '../../bounded-jsonl-state.js';
-import '../../types-CM86alG1.js';
 import '../../operator-doctor-types.js';
 import '../../external-wiki-config.js';
 import '../../contradiction-config.js';