@remnic/core 9.66.1 → 9.66.3

package/dist/recall-navigate-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-budget.ts"],"sourcesContent":["/**\n * Recall navigation budget take (issue #1956 leftover).\n *\n * Pure. Surfaces wait. Budget 0 or cost above budget is exhausted.\n * Negative budget or cost throws.\n */\n\nexport type NavigateBudgetResult =\n  | { ok: true; remaining: number }\n  | { ok: false; error: \"budget_exhausted\" };\n\nexport function takeNavigateBudget(budget: number, cost: number): NavigateBudgetResult {\n  if (budget < 0 || cost < 0) {\n    throw new Error(\n      `navigate budget and cost must be non-negative; got budget=${JSON.stringify(budget)} cost=${JSON.stringify(cost)}`,\n    );\n  }\n  if (budget === 0 || cost > budget) {\n    return { ok: false, error: \"budget_exhausted\" };\n  }\n  return { ok: true, remaining: budget - cost };\n}\n"],"mappings":";;;AAWO,SAAS,mBAAmB,QAAgB,MAAoC;AACrF,MAAI,SAAS,KAAK,OAAO,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR,6DAA6D,KAAK,UAAU,MAAM,CAAC,SAAS,KAAK,UAAU,IAAI,CAAC;AAAA,IAClH;AAAA,EACF;AACA,MAAI,WAAW,KAAK,OAAO,QAAQ;AACjC,WAAO,EAAE,IAAI,OAAO,OAAO,mBAAmB;AAAA,EAChD;AACA,SAAO,EAAE,IAAI,MAAM,WAAW,SAAS,KAAK;AAC9C;","names":[]}

package/dist/recall-navigate-cost.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recall navigation cost parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.
+ */
+declare function parseNavigateCost(value: unknown): number;
+
+export { parseNavigateCost };

package/dist/recall-navigate-cost.js

@@ -0,0 +1,15 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-cost.ts
+function parseNavigateCost(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `navigate cost must be a non-negative integer; got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+export {
+  parseNavigateCost
+};
+//# sourceMappingURL=recall-navigate-cost.js.map

package/dist/recall-navigate-cost.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-cost.ts"],"sourcesContent":["/**\n * Recall navigation cost parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.\n */\nexport function parseNavigateCost(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `navigate cost must be a non-negative integer; got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"mappings":";;;AAKO,SAAS,kBAAkB,OAAwB;AACxD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACjG,UAAM,IAAI;AAAA,MACR,qDAAqD,KAAK,UAAU,KAAK,CAAC;AAAA,IAC5E;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/recall-navigate-depth.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recall navigation depth parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.
+ */
+declare function parseNavigateDepth(value: unknown): number;
+
+export { parseNavigateDepth };

package/dist/recall-navigate-depth.js

@@ -0,0 +1,15 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-depth.ts
+function parseNavigateDepth(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `navigate depth must be a non-negative integer; got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+export {
+  parseNavigateDepth
+};
+//# sourceMappingURL=recall-navigate-depth.js.map

package/dist/recall-navigate-depth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-depth.ts"],"sourcesContent":["/**\n * Recall navigation depth parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.\n */\nexport function parseNavigateDepth(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `navigate depth must be a non-negative integer; got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"mappings":";;;AAKO,SAAS,mBAAmB,OAAwB;AACzD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACjG,UAAM,IAAI;AAAA,MACR,sDAAsD,KAAK,UAAU,KAAK,CAAC;AAAA,IAC7E;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/recall-navigate-link.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Recall navigation link-type parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. Unknown or empty is unknown_link.
+ */
+declare const NAVIGATE_LINK_TYPES: readonly ["supports", "contradicts", "elaborates", "causes", "caused_by"];
+type NavigateLinkType = (typeof NAVIGATE_LINK_TYPES)[number];
+type ParseNavigateLinkTypeResult = {
+    ok: true;
+    type: NavigateLinkType;
+} | {
+    ok: false;
+    error: "unknown_link";
+};
+declare function parseNavigateLinkType(value: string): ParseNavigateLinkTypeResult;
+
+export { type NavigateLinkType, type ParseNavigateLinkTypeResult, parseNavigateLinkType };

package/dist/recall-navigate-link.js

@@ -0,0 +1,20 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-link.ts
+var NAVIGATE_LINK_TYPES = [
+  "supports",
+  "contradicts",
+  "elaborates",
+  "causes",
+  "caused_by"
+];
+function parseNavigateLinkType(value) {
+  if (NAVIGATE_LINK_TYPES.includes(value)) {
+    return { ok: true, type: value };
+  }
+  return { ok: false, error: "unknown_link" };
+}
+export {
+  parseNavigateLinkType
+};
+//# sourceMappingURL=recall-navigate-link.js.map

package/dist/recall-navigate-link.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-link.ts"],"sourcesContent":["/**\n * Recall navigation link-type parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. Unknown or empty is unknown_link.\n */\n\nconst NAVIGATE_LINK_TYPES = [\n  \"supports\",\n  \"contradicts\",\n  \"elaborates\",\n  \"causes\",\n  \"caused_by\",\n] as const;\n\nexport type NavigateLinkType = (typeof NAVIGATE_LINK_TYPES)[number];\n\nexport type ParseNavigateLinkTypeResult =\n  | { ok: true; type: NavigateLinkType }\n  | { ok: false; error: \"unknown_link\" };\n\nexport function parseNavigateLinkType(value: string): ParseNavigateLinkTypeResult {\n  if ((NAVIGATE_LINK_TYPES as readonly string[]).includes(value)) {\n    return { ok: true, type: value as NavigateLinkType };\n  }\n  return { ok: false, error: \"unknown_link\" };\n}\n"],"mappings":";;;AAMA,IAAM,sBAAsB;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,SAAS,sBAAsB,OAA4C;AAChF,MAAK,oBAA0C,SAAS,KAAK,GAAG;AAC9D,WAAO,EAAE,IAAI,MAAM,MAAM,MAA0B;AAAA,EACrD;AACA,SAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AAC5C;","names":[]}

package/dist/recall-navigate-max-children.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recall navigation max-children parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.
+ */
+declare function parseMaxChildren(value: unknown): number;
+
+export { parseMaxChildren };

package/dist/recall-navigate-max-children.js

@@ -0,0 +1,15 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-max-children.ts
+function parseMaxChildren(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `max children must be a non-negative integer; got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+export {
+  parseMaxChildren
+};
+//# sourceMappingURL=recall-navigate-max-children.js.map

package/dist/recall-navigate-max-children.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-max-children.ts"],"sourcesContent":["/**\n * Recall navigation max-children parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.\n */\nexport function parseMaxChildren(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `max children must be a non-negative integer; got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"mappings":";;;AAKO,SAAS,iBAAiB,OAAwB;AACvD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACjG,UAAM,IAAI;AAAA,MACR,oDAAoD,KAAK,UAAU,KAAK,CAAC;AAAA,IAC3E;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/recall-navigate-node.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Recall navigation node-id parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. Empty is missing_node. Newline is invalid_node.
+ */
+type ParseNavigateNodeIdResult = {
+    ok: true;
+    nodeId: string;
+} | {
+    ok: false;
+    error: "missing_node" | "invalid_node";
+};
+declare function parseNavigateNodeId(value: string): ParseNavigateNodeIdResult;
+
+export { type ParseNavigateNodeIdResult, parseNavigateNodeId };

package/dist/recall-navigate-node.js

@@ -0,0 +1,13 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-node.ts
+function parseNavigateNodeId(value) {
+  const nodeId = value.trim();
+  if (nodeId.length === 0) return { ok: false, error: "missing_node" };
+  if (nodeId.includes("\n")) return { ok: false, error: "invalid_node" };
+  return { ok: true, nodeId };
+}
+export {
+  parseNavigateNodeId
+};
+//# sourceMappingURL=recall-navigate-node.js.map

package/dist/recall-navigate-node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-node.ts"],"sourcesContent":["/**\n * Recall navigation node-id parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. Empty is missing_node. Newline is invalid_node.\n */\n\nexport type ParseNavigateNodeIdResult =\n  | { ok: true; nodeId: string }\n  | { ok: false; error: \"missing_node\" | \"invalid_node\" };\n\nexport function parseNavigateNodeId(value: string): ParseNavigateNodeIdResult {\n  const nodeId = value.trim();\n  if (nodeId.length === 0) return { ok: false, error: \"missing_node\" };\n  if (nodeId.includes(\"\\n\")) return { ok: false, error: \"invalid_node\" };\n  return { ok: true, nodeId };\n}\n"],"mappings":";;;AAUO,SAAS,oBAAoB,OAA0C;AAC5E,QAAM,SAAS,MAAM,KAAK;AAC1B,MAAI,OAAO,WAAW,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AACnE,MAAI,OAAO,SAAS,IAAI,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AACrE,SAAO,EAAE,IAAI,MAAM,OAAO;AAC5B;","names":[]}

package/dist/recall-navigate-path.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Empty-set guard for a recall-navigate path (issue #1956 leftover).
+ *
+ * null, undefined, and [] are empty. A non-array throws. Any other array is not empty.
+ */
+/** True when the navigate path is absent or has no nodes. */
+declare function isEmptyNavigatePath(nodes: unknown): boolean;
+
+export { isEmptyNavigatePath };

package/dist/recall-navigate-path.js

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-path.ts
+function isEmptyNavigatePath(nodes) {
+  if (nodes == null) return true;
+  if (!Array.isArray(nodes)) {
+    throw new TypeError("nodes must be an array");
+  }
+  return nodes.length === 0;
+}
+export {
+  isEmptyNavigatePath
+};
+//# sourceMappingURL=recall-navigate-path.js.map

package/dist/recall-navigate-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-path.ts"],"sourcesContent":["/**\n * Empty-set guard for a recall-navigate path (issue #1956 leftover).\n *\n * null, undefined, and [] are empty. A non-array throws. Any other array is not empty.\n */\n\n/** True when the navigate path is absent or has no nodes. */\nexport function isEmptyNavigatePath(nodes: unknown): boolean {\n  if (nodes == null) return true;\n  if (!Array.isArray(nodes)) {\n    throw new TypeError(\"nodes must be an array\");\n  }\n  return nodes.length === 0;\n}\n"],"mappings":";;;AAOO,SAAS,oBAAoB,OAAyB;AAC3D,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,UAAM,IAAI,UAAU,wBAAwB;AAAA,EAC9C;AACA,SAAO,MAAM,WAAW;AAC1B;","names":[]}

package/dist/recall-navigate-render.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Markdown renderer for a recall navigate step (issue #1956 leftover).
+ *
+ * Deterministic. Surfaces wait. Empty children prints (empty).
+ */
+type NavigateResult = {
+    action: string;
+    nodeId: string;
+    children?: readonly string[];
+    path?: readonly string[];
+    stopReason: string;
+};
+declare function renderNavigateResult(result: NavigateResult): string;
+
+export { type NavigateResult, renderNavigateResult };

package/dist/recall-navigate-render.js

@@ -0,0 +1,23 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-render.ts
+function formatList(items) {
+  if (items === void 0 || items.length === 0) return "(empty)";
+  return items.join(", ");
+}
+function renderNavigateResult(result) {
+  const usePath = result.action === "traverse" || result.path !== void 0;
+  return [
+    "# Navigate",
+    "",
+    `- action: ${result.action}`,
+    `- nodeId: ${result.nodeId}`,
+    usePath ? `- path: ${formatList(result.path)}` : `- children: ${formatList(result.children)}`,
+    `- stop: ${result.stopReason}`,
+    ""
+  ].join("\n");
+}
+export {
+  renderNavigateResult
+};
+//# sourceMappingURL=recall-navigate-render.js.map

package/dist/recall-navigate-render.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-render.ts"],"sourcesContent":["/**\n * Markdown renderer for a recall navigate step (issue #1956 leftover).\n *\n * Deterministic. Surfaces wait. Empty children prints (empty).\n */\n\nexport type NavigateResult = {\n  action: string;\n  nodeId: string;\n  children?: readonly string[];\n  path?: readonly string[];\n  stopReason: string;\n};\n\nfunction formatList(items: readonly string[] | undefined): string {\n  if (items === undefined || items.length === 0) return \"(empty)\";\n  return items.join(\", \");\n}\n\nexport function renderNavigateResult(result: NavigateResult): string {\n  const usePath = result.action === \"traverse\" || result.path !== undefined;\n  return [\n    \"# Navigate\",\n    \"\",\n    `- action: ${result.action}`,\n    `- nodeId: ${result.nodeId}`,\n    usePath ? `- path: ${formatList(result.path)}` : `- children: ${formatList(result.children)}`,\n    `- stop: ${result.stopReason}`,\n    \"\",\n  ].join(\"\\n\");\n}\n"],"mappings":";;;AAcA,SAAS,WAAW,OAA8C;AAChE,MAAI,UAAU,UAAa,MAAM,WAAW,EAAG,QAAO;AACtD,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,qBAAqB,QAAgC;AACnE,QAAM,UAAU,OAAO,WAAW,cAAc,OAAO,SAAS;AAChE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,OAAO,MAAM;AAAA,IAC1B,aAAa,OAAO,MAAM;AAAA,IAC1B,UAAU,WAAW,WAAW,OAAO,IAAI,CAAC,KAAK,eAAe,WAAW,OAAO,QAAQ,CAAC;AAAA,IAC3F,WAAW,OAAO,UAAU;AAAA,IAC5B;AAAA,EACF,EAAE,KAAK,IAAI;AACb;","names":[]}

package/dist/recall-navigate.js

@@ -1,47 +1,11 @@
 import {
-  RECALL_DISCLOSURE_LEVELS
-} from "./chunk-XXW32OL7.js";
+  RECALL_NAV_LINK_TYPES,
+  expandRecallNode,
+  isRecallNavLinkType,
+  traverseRecallLink
+} from "./chunk-MAG6M3B6.js";
+import "./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,

package/dist/recall-navigate.js.map

@@ -1 +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":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,18 @@
+/**
+ * Recall state-view current-has-no-successor guard (issue #1952 leftover).
+ *
+ * Pure. Surfaces wait. Current plus a successor is current_has_successor.
+ */
+type AssertCurrentHasNoSuccessorInput = {
+    kind: string;
+    successorId?: string;
+};
+type AssertCurrentHasNoSuccessorResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: "current_has_successor";
+};
+declare function assertCurrentHasNoSuccessor(input: AssertCurrentHasNoSuccessorInput): AssertCurrentHasNoSuccessorResult;
+
+export { type AssertCurrentHasNoSuccessorInput, type AssertCurrentHasNoSuccessorResult, assertCurrentHasNoSuccessor };

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

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-current.ts
+function assertCurrentHasNoSuccessor(input) {
+  const successorId = input.successorId?.trim() ?? "";
+  if (input.kind === "current" && successorId.length > 0) {
+    return { ok: false, error: "current_has_successor" };
+  }
+  return { ok: true };
+}
+export {
+  assertCurrentHasNoSuccessor
+};
+//# sourceMappingURL=recall-state-view-current.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-current.ts"],"sourcesContent":["/**\n * Recall state-view current-has-no-successor guard (issue #1952 leftover).\n *\n * Pure. Surfaces wait. Current plus a successor is current_has_successor.\n */\n\nexport type AssertCurrentHasNoSuccessorInput = {\n  kind: string;\n  successorId?: string;\n};\n\nexport type AssertCurrentHasNoSuccessorResult =\n  | { ok: true }\n  | { ok: false; error: \"current_has_successor\" };\n\nexport function assertCurrentHasNoSuccessor(\n  input: AssertCurrentHasNoSuccessorInput,\n): AssertCurrentHasNoSuccessorResult {\n  const successorId = input.successorId?.trim() ?? \"\";\n  if (input.kind === \"current\" && successorId.length > 0) {\n    return { ok: false, error: \"current_has_successor\" };\n  }\n  return { ok: true };\n}\n"],"mappings":";;;AAeO,SAAS,4BACd,OACmC;AACnC,QAAM,cAAc,MAAM,aAAa,KAAK,KAAK;AACjD,MAAI,MAAM,SAAS,aAAa,YAAY,SAAS,GAAG;AACtD,WAAO,EAAE,IAAI,OAAO,OAAO,wBAAwB;AAAA,EACrD;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;","names":[]}

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

@@ -0,0 +1,15 @@
+import { StateViewLineResult } from './recall-state-view-render.js';
+import './recall-state-view.js';
+
+/**
+ * Recall inject-line mapper for state views (issue #1952).
+ *
+ * Maps each result through renderStateViewLine. A disabled flag keeps
+ * original text per item. An empty list stays empty.
+ */
+
+declare function injectStateViewLines(results: readonly StateViewLineResult[], options?: {
+    enabled?: boolean;
+}): string[];
+
+export { injectStateViewLines };

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

@@ -0,0 +1,16 @@
+import {
+  renderStateViewLine
+} from "./chunk-MKD3OMPS.js";
+import "./chunk-HVAEXYPL.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-inject.ts
+function injectStateViewLines(results, options = {}) {
+  return results.map((result) => renderStateViewLine(result, options));
+}
+export {
+  injectStateViewLines
+};
+//# sourceMappingURL=recall-state-view-inject.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-inject.ts"],"sourcesContent":["/**\n * Recall inject-line mapper for state views (issue #1952).\n *\n * Maps each result through renderStateViewLine. A disabled flag keeps\n * original text per item. An empty list stays empty.\n */\nimport { renderStateViewLine, type StateViewLineResult } from \"./recall-state-view-render.js\";\n\nexport function injectStateViewLines(\n  results: readonly StateViewLineResult[],\n  options: { enabled?: boolean } = {},\n): string[] {\n  return results.map((result) => renderStateViewLine(result, options));\n}\n"],"mappings":";;;;;;;;;AAQO,SAAS,qBACd,SACA,UAAiC,CAAC,GACxB;AACV,SAAO,QAAQ,IAAI,CAAC,WAAW,oBAAoB,QAAQ,OAAO,CAAC;AACrE;","names":[]}

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

@@ -0,0 +1,17 @@
+/**
+ * Recall state-view kind parse (issue #1952 leftover).
+ *
+ * Pure. Surfaces wait. Unknown or empty is unknown_kind.
+ */
+declare const STATE_VIEW_KINDS: readonly ["current", "historical", "transition"];
+type StateViewKind = (typeof STATE_VIEW_KINDS)[number];
+type ParseStateViewKindResult = {
+    ok: true;
+    kind: StateViewKind;
+} | {
+    ok: false;
+    error: "unknown_kind";
+};
+declare function parseStateViewKind(value: string): ParseStateViewKindResult;
+
+export { type ParseStateViewKindResult, type StateViewKind, parseStateViewKind };

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

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-kind.ts
+var STATE_VIEW_KINDS = ["current", "historical", "transition"];
+function parseStateViewKind(value) {
+  if (STATE_VIEW_KINDS.includes(value)) {
+    return { ok: true, kind: value };
+  }
+  return { ok: false, error: "unknown_kind" };
+}
+export {
+  parseStateViewKind
+};
+//# sourceMappingURL=recall-state-view-kind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-kind.ts"],"sourcesContent":["/**\n * Recall state-view kind parse (issue #1952 leftover).\n *\n * Pure. Surfaces wait. Unknown or empty is unknown_kind.\n */\n\nconst STATE_VIEW_KINDS = [\"current\", \"historical\", \"transition\"] as const;\n\nexport type StateViewKind = (typeof STATE_VIEW_KINDS)[number];\n\nexport type ParseStateViewKindResult =\n  | { ok: true; kind: StateViewKind }\n  | { ok: false; error: \"unknown_kind\" };\n\nexport function parseStateViewKind(value: string): ParseStateViewKindResult {\n  if ((STATE_VIEW_KINDS as readonly string[]).includes(value)) {\n    return { ok: true, kind: value as StateViewKind };\n  }\n  return { ok: false, error: \"unknown_kind\" };\n}\n"],"mappings":";;;AAMA,IAAM,mBAAmB,CAAC,WAAW,cAAc,YAAY;AAQxD,SAAS,mBAAmB,OAAyC;AAC1E,MAAK,iBAAuC,SAAS,KAAK,GAAG;AAC3D,WAAO,EAAE,IAAI,MAAM,MAAM,MAAuB;AAAA,EAClD;AACA,SAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AAC5C;","names":[]}

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

@@ -0,0 +1,17 @@
+import { StateLabel } from './recall-state-view.js';
+
+/**
+ * Pure state-view labeler (issue #1952 leftover).
+ *
+ * Surfaces wait. `current` stays current. `historical` and `transition`
+ * keep their kind only when both supersededAt and successorId are set.
+ * Missing either field is current. Unknown kind throws.
+ */
+
+declare function labelStateView(input: {
+    kind: string;
+    supersededAt?: string;
+    successorId?: string;
+}): StateLabel;
+
+export { labelStateView };

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

@@ -0,0 +1,16 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-label.ts
+function labelStateView(input) {
+  const { kind, supersededAt, successorId } = input;
+  if (kind === "current") return "current";
+  if (kind === "historical" || kind === "transition") {
+    if (!supersededAt || !successorId) return "current";
+    return kind;
+  }
+  throw new Error(`unknown state view kind: ${JSON.stringify(kind)}`);
+}
+export {
+  labelStateView
+};
+//# sourceMappingURL=recall-state-view-label.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-label.ts"],"sourcesContent":["/**\n * Pure state-view labeler (issue #1952 leftover).\n *\n * Surfaces wait. `current` stays current. `historical` and `transition`\n * keep their kind only when both supersededAt and successorId are set.\n * Missing either field is current. Unknown kind throws.\n */\nimport type { StateLabel } from \"./recall-state-view.js\";\n\nexport function labelStateView(input: {\n  kind: string;\n  supersededAt?: string;\n  successorId?: string;\n}): StateLabel {\n  const { kind, supersededAt, successorId } = input;\n  if (kind === \"current\") return \"current\";\n  if (kind === \"historical\" || kind === \"transition\") {\n    if (!supersededAt || !successorId) return \"current\";\n    return kind;\n  }\n  throw new Error(`unknown state view kind: ${JSON.stringify(kind)}`);\n}\n"],"mappings":";;;AASO,SAAS,eAAe,OAIhB;AACb,QAAM,EAAE,MAAM,cAAc,YAAY,IAAI;AAC5C,MAAI,SAAS,UAAW,QAAO;AAC/B,MAAI,SAAS,gBAAgB,SAAS,cAAc;AAClD,QAAI,CAAC,gBAAgB,CAAC,YAAa,QAAO;AAC1C,WAAO;AAAA,EACT;AACA,QAAM,IAAI,MAAM,4BAA4B,KAAK,UAAU,IAAI,CAAC,EAAE;AACpE;","names":[]}

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

@@ -0,0 +1,18 @@
+import { StateViewResult } from './recall-state-view.js';
+
+/**
+ * Recall inject-line renderer for state views (issue #1952).
+ *
+ * Historical and transition rows get `[superseded <date> by <id>]` when both
+ * supersededAt and supersededBy are present. Current rows and a disabled
+ * flag are identity.
+ */
+
+type StateViewLineResult = StateViewResult & {
+    text?: string;
+};
+declare function renderStateViewLine(result: StateViewLineResult, options?: {
+    enabled?: boolean;
+}): string;
+
+export { type StateViewLineResult, renderStateViewLine };

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

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

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Recall state-view successor-id parse (issue #1952 leftover).
+ *
+ * Pure. Surfaces wait. Empty is missing_successor. Newline is invalid_successor.
+ */
+type ParseSuccessorIdResult = {
+    ok: true;
+    successorId: string;
+} | {
+    ok: false;
+    error: "missing_successor" | "invalid_successor";
+};
+declare function parseSuccessorId(value: string): ParseSuccessorIdResult;
+
+export { type ParseSuccessorIdResult, parseSuccessorId };

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

@@ -0,0 +1,13 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-successor.ts
+function parseSuccessorId(value) {
+  const successorId = value.trim();
+  if (successorId.length === 0) return { ok: false, error: "missing_successor" };
+  if (successorId.includes("\n")) return { ok: false, error: "invalid_successor" };
+  return { ok: true, successorId };
+}
+export {
+  parseSuccessorId
+};
+//# sourceMappingURL=recall-state-view-successor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-successor.ts"],"sourcesContent":["/**\n * Recall state-view successor-id parse (issue #1952 leftover).\n *\n * Pure. Surfaces wait. Empty is missing_successor. Newline is invalid_successor.\n */\n\nexport type ParseSuccessorIdResult =\n  | { ok: true; successorId: string }\n  | { ok: false; error: \"missing_successor\" | \"invalid_successor\" };\n\nexport function parseSuccessorId(value: string): ParseSuccessorIdResult {\n  const successorId = value.trim();\n  if (successorId.length === 0) return { ok: false, error: \"missing_successor\" };\n  if (successorId.includes(\"\\n\")) return { ok: false, error: \"invalid_successor\" };\n  return { ok: true, successorId };\n}\n"],"mappings":";;;AAUO,SAAS,iBAAiB,OAAuC;AACtE,QAAM,cAAc,MAAM,KAAK;AAC/B,MAAI,YAAY,WAAW,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,oBAAoB;AAC7E,MAAI,YAAY,SAAS,IAAI,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,oBAAoB;AAC/E,SAAO,EAAE,IAAI,MAAM,YAAY;AACjC;","names":[]}

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

@@ -0,0 +1,15 @@
+/**
+ * Recall state-view superseded-at parse (issue #1952 leftover).
+ *
+ * Pure. Surfaces wait. Empty is missing_date. Unparseable is invalid_date.
+ */
+type ParseSupersededAtResult = {
+    ok: true;
+    supersededAt: string;
+} | {
+    ok: false;
+    error: "missing_date" | "invalid_date";
+};
+declare function parseSupersededAt(value: string): ParseSupersededAtResult;
+
+export { type ParseSupersededAtResult, parseSupersededAt };

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

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-superseded.ts
+function parseSupersededAt(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return { ok: false, error: "missing_date" };
+  const parsed = Date.parse(trimmed);
+  if (!Number.isFinite(parsed)) return { ok: false, error: "invalid_date" };
+  return { ok: true, supersededAt: new Date(parsed).toISOString() };
+}
+export {
+  parseSupersededAt
+};
+//# sourceMappingURL=recall-state-view-superseded.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-superseded.ts"],"sourcesContent":["/**\n * Recall state-view superseded-at parse (issue #1952 leftover).\n *\n * Pure. Surfaces wait. Empty is missing_date. Unparseable is invalid_date.\n */\n\nexport type ParseSupersededAtResult =\n  | { ok: true; supersededAt: string }\n  | { ok: false; error: \"missing_date\" | \"invalid_date\" };\n\nexport function parseSupersededAt(value: string): ParseSupersededAtResult {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return { ok: false, error: \"missing_date\" };\n  const parsed = Date.parse(trimmed);\n  if (!Number.isFinite(parsed)) return { ok: false, error: \"invalid_date\" };\n  return { ok: true, supersededAt: new Date(parsed).toISOString() };\n}\n"],"mappings":";;;AAUO,SAAS,kBAAkB,OAAwC;AACxE,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,QAAQ,WAAW,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AACpE,QAAM,SAAS,KAAK,MAAM,OAAO;AACjC,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,eAAe;AACxE,SAAO,EAAE,IAAI,MAAM,cAAc,IAAI,KAAK,MAAM,EAAE,YAAY,EAAE;AAClE;","names":[]}

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

@@ -0,0 +1,18 @@
+/**
+ * Recall state-view transition-has-successor guard (issue #1952 leftover).
+ *
+ * Pure. Surfaces wait. Transition without a successor is transition_missing_successor.
+ */
+type AssertTransitionHasSuccessorInput = {
+    kind: string;
+    successorId?: string;
+};
+type AssertTransitionHasSuccessorResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: "transition_missing_successor";
+};
+declare function assertTransitionHasSuccessor(input: AssertTransitionHasSuccessorInput): AssertTransitionHasSuccessorResult;
+
+export { type AssertTransitionHasSuccessorInput, type AssertTransitionHasSuccessorResult, assertTransitionHasSuccessor };

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

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-transition.ts
+function assertTransitionHasSuccessor(input) {
+  const successorId = input.successorId?.trim() ?? "";
+  if (input.kind === "transition" && successorId.length === 0) {
+    return { ok: false, error: "transition_missing_successor" };
+  }
+  return { ok: true };
+}
+export {
+  assertTransitionHasSuccessor
+};
+//# sourceMappingURL=recall-state-view-transition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-transition.ts"],"sourcesContent":["/**\n * Recall state-view transition-has-successor guard (issue #1952 leftover).\n *\n * Pure. Surfaces wait. Transition without a successor is transition_missing_successor.\n */\n\nexport type AssertTransitionHasSuccessorInput = {\n  kind: string;\n  successorId?: string;\n};\n\nexport type AssertTransitionHasSuccessorResult =\n  | { ok: true }\n  | { ok: false; error: \"transition_missing_successor\" };\n\nexport function assertTransitionHasSuccessor(\n  input: AssertTransitionHasSuccessorInput,\n): AssertTransitionHasSuccessorResult {\n  const successorId = input.successorId?.trim() ?? \"\";\n  if (input.kind === \"transition\" && successorId.length === 0) {\n    return { ok: false, error: \"transition_missing_successor\" };\n  }\n  return { ok: true };\n}\n"],"mappings":";;;AAeO,SAAS,6BACd,OACoC;AACpC,QAAM,cAAc,MAAM,aAAa,KAAK,KAAK;AACjD,MAAI,MAAM,SAAS,gBAAgB,YAAY,WAAW,GAAG;AAC3D,WAAO,EAAE,IAAI,OAAO,OAAO,+BAA+B;AAAA,EAC5D;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;","names":[]}