@remnic/core 9.69.0 → 9.69.1

package/dist/orchestrator.js

@@ -3,53 +3,53 @@ import {
   blendGraphExpandedRecallScore,
   graphPathRelativeToStorage,
   mergeGraphExpandedResults
-} from "./chunk-BZ26443Y.js";
+} from "./chunk-2FEBD4LN.js";
 import "./chunk-3TSU662L.js";
-import "./chunk-F25CL3IQ.js";
+import "./chunk-KSTLZCR5.js";
 import {
   formatCompressionGuidelinesForRecall
 } from "./chunk-UXREWVW4.js";
-import "./chunk-52GQNSLC.js";
+import "./chunk-WM2N5DRB.js";
 import "./chunk-I74SUMNI.js";
 import "./chunk-ILNPU5W5.js";
 import "./chunk-7HYPN2GC.js";
+import "./chunk-2D7S3FZW.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-VDC6RZI4.js";
-import "./chunk-X2NFFBTO.js";
+import "./chunk-UWK5OXUJ.js";
+import "./chunk-A7GQBJP5.js";
+import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
 import "./chunk-UXPUUL3G.js";
 import "./chunk-DDA47TES.js";
 import "./chunk-KOLJJN5G.js";
-import "./chunk-UWK5OXUJ.js";
-import "./chunk-KAY2C6VX.js";
+import "./chunk-WVP2I6C5.js";
+import "./chunk-TECVW3JP.js";
 import "./chunk-C5JF6EZ7.js";
 import "./chunk-KBL3JJR6.js";
 import "./chunk-FQ7HAWWC.js";
-import "./chunk-WVP2I6C5.js";
-import "./chunk-7N4KAIGN.js";
-import "./chunk-WSYACIKD.js";
+import "./chunk-W6PZQY4L.js";
 import "./chunk-VI637ILW.js";
 import "./chunk-V5OCT34X.js";
-import "./chunk-TECVW3JP.js";
-import "./chunk-ND6NL2YR.js";
+import "./chunk-QBZMUF54.js";
 import "./chunk-47DU4SGJ.js";
 import "./chunk-SEF4IOFE.js";
+import "./chunk-DD5JFCWM.js";
+import "./chunk-ECZU5BJH.js";
 import "./chunk-KVDUKH5E.js";
 import "./chunk-2NKY7OC6.js";
 import "./chunk-4EX5WZ4M.js";
 import "./chunk-YRFAYOFQ.js";
-import "./chunk-DD5JFCWM.js";
-import "./chunk-ECZU5BJH.js";
 import "./chunk-HCM7ZYJD.js";
 import "./chunk-6DNMUYEE.js";
 import "./chunk-T67LUYCR.js";
 import "./chunk-ODZKV2F7.js";
+import "./chunk-5IZL4DCV.js";
 import "./chunk-N4F7ZSSG.js";
 import "./chunk-LUDXM7MD.js";
 import "./chunk-6TCXIRP5.js";
 import "./chunk-QJ622LTI.js";
 import "./chunk-ZOKZIR5K.js";
-import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-KATEWTQJ.js";
 import "./chunk-FYDW33ZB.js";
@@ -96,7 +96,7 @@ import "./chunk-LUPVCGYK.js";
 import "./chunk-BUYVPUEM.js";
 import "./chunk-IAIPNEHD.js";
 import "./chunk-DGFU5MSX.js";
-import "./chunk-5UI7WQA6.js";
+import "./chunk-TX55UTJT.js";
 import "./chunk-GKUA4MGB.js";
 import "./chunk-5AUY5Z5E.js";
 import "./chunk-SVH57F5Z.js";
@@ -107,12 +107,13 @@ import "./chunk-VEWZZM3H.js";
 import "./chunk-VY47VI2T.js";
 import "./chunk-PYIR4SSB.js";
 import "./chunk-DFEODULB.js";
-import "./chunk-25P3LW6U.js";
-import "./chunk-ERKFG4RV.js";
-import "./chunk-MMACM5G2.js";
+import "./chunk-QLT74C2M.js";
+import "./chunk-XRT7ZG5B.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
+import "./chunk-MMACM5G2.js";
 import "./chunk-FXZTL7F7.js";
+import "./chunk-CX6J53S5.js";
 import "./chunk-BV2TIZ4F.js";
 import "./chunk-HDDRVXX4.js";
 import "./chunk-PYHOAXTI.js";
@@ -121,51 +122,50 @@ import "./chunk-OZKVVUJB.js";
 import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2NLLXCJG.js";
-import "./chunk-UP6MOYCB.js";
 import "./chunk-765K3SAT.js";
-import "./chunk-NFITGYMQ.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-FGDKJJZS.js";
 import "./chunk-AJVLDJU6.js";
 import "./chunk-TBUEE7XF.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
+import "./chunk-LFGSIMFS.js";
 import "./chunk-DQTCGVFK.js";
 import "./chunk-YLBE6PLR.js";
 import "./chunk-IIFFC3RL.js";
 import "./chunk-AXFWMRKI.js";
-import "./chunk-BS5BD3DF.js";
-import "./chunk-Z2FXSE5P.js";
-import "./chunk-CDKHKZL5.js";
 import "./chunk-HSSERO3E.js";
 import "./chunk-NOUJNHWG.js";
+import "./chunk-NFZUZL44.js";
+import "./chunk-CDKHKZL5.js";
+import "./chunk-73CA45TG.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-HDQUQBPW.js";
 import "./chunk-6FC3IZ26.js";
-import "./chunk-FOT5GP2U.js";
 import "./chunk-OJP3N7UK.js";
-import "./chunk-2MHMHF76.js";
-import "./chunk-WQCET3N3.js";
+import "./chunk-7GFLU63V.js";
+import "./chunk-VK7YWP5Q.js";
 import "./chunk-52I6AHO6.js";
 import "./chunk-NRLELHAY.js";
 import "./chunk-AM4T6CHX.js";
 import "./chunk-X5PIDJ3L.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-2LA3H54D.js";
-import "./chunk-XW3G4BJI.js";
-import "./chunk-HDQQRRCZ.js";
+import "./chunk-6DPAZEGK.js";
+import "./chunk-5DSPAWXQ.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-CMTINOFS.js";
-import "./chunk-USQAH6PN.js";
+import "./chunk-VPYAQYD5.js";
 import "./chunk-RMMVQQA6.js";
 import "./chunk-UR6PBX2J.js";
 import "./chunk-6GUG4YNM.js";
 import "./chunk-UOBPK2OS.js";
-import "./chunk-ABPCF4MW.js";
+import "./chunk-HB3GEHGF.js";
 import "./chunk-C7SRUWBW.js";
 import "./chunk-OZKOPQCM.js";
 import "./chunk-MCA2X4WH.js";
 import "./chunk-CIO7GCWE.js";
-import "./chunk-A7NMS5II.js";
+import "./chunk-7HAZ6GZE.js";
 import "./chunk-KJTKLXTH.js";
 import "./chunk-2DQ2XREU.js";
 import "./chunk-ACPCA4NO.js";
@@ -177,7 +177,7 @@ import "./chunk-OKTXM5H4.js";
 import "./chunk-DUAJKRR2.js";
 import "./chunk-NOB2T2FC.js";
 import "./chunk-3I4FUAVJ.js";
-import "./chunk-ZVW724ZK.js";
+import "./chunk-Q4OITLPA.js";
 import "./chunk-5JMAGU26.js";
 import "./chunk-YBPYIAA5.js";
 import "./chunk-HK6KYIF6.js";
@@ -216,8 +216,9 @@ import "./chunk-JI7U6AS3.js";
 import "./chunk-KFZY2OFH.js";
 import "./chunk-B32WYRXX.js";
 import "./chunk-QW27DOHG.js";
-import "./chunk-ZDJMCXC7.js";
+import "./chunk-JRLDQ6WS.js";
 import "./chunk-V7IZKJI3.js";
+import "./chunk-TB6CBZ5V.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-RKNJBZ55.js";
 import "./chunk-J64TK33U.js";
@@ -225,23 +226,22 @@ import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
 import "./chunk-7RXCMVFQ.js";
-import "./chunk-TB6CBZ5V.js";
 import "./chunk-3HSRWJTC.js";
-import "./chunk-363VZTVH.js";
-import "./chunk-PIBQIYF2.js";
-import "./chunk-VLSUKXCJ.js";
+import "./chunk-L5QVIATR.js";
+import "./chunk-NX2ECBRG.js";
+import "./chunk-5JUSOMNO.js";
 import "./chunk-4OFKZAJG.js";
 import "./chunk-A5KNZSNA.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-3IRH5MYM.js";
-import "./chunk-4PMPOZK3.js";
-import "./chunk-KRNFJKMH.js";
-import "./chunk-XPDWNWH6.js";
-import "./chunk-KJUH3QIQ.js";
+import "./chunk-6OX6SNRC.js";
+import "./chunk-V5I36Y2F.js";
+import "./chunk-VTEO5T6Z.js";
+import "./chunk-6LIILOP3.js";
+import "./chunk-TITZPONM.js";
 import "./chunk-7T4TOGMS.js";
 import "./chunk-7YQ6ESEA.js";
 import "./chunk-ZQUVBZI4.js";
-import "./chunk-BHH736UQ.js";
+import "./chunk-UJYNT3R2.js";
 import "./chunk-LTBKKSCX.js";
 import "./chunk-EQWEIIKQ.js";
 import "./chunk-JTWZKNUH.js";
@@ -250,8 +250,8 @@ import "./chunk-CTVWELNK.js";
 import "./chunk-CEN6DW6X.js";
 import "./chunk-E4RMZGRS.js";
 import "./chunk-D6Q5EPOV.js";
-import "./chunk-327JMA2N.js";
-import "./chunk-P342D5BP.js";
+import "./chunk-PZY4DLLO.js";
+import "./chunk-626ILV6J.js";
 import "./chunk-AB3A7EFH.js";
 import "./chunk-K4E3Y3ZX.js";
 import "./chunk-SRT6SHVZ.js";
@@ -260,22 +260,22 @@ import "./chunk-GZ3R6XOE.js";
 import "./chunk-CK5KOVHW.js";
 import "./chunk-DJUKBGAD.js";
 import "./chunk-G73MCJKL.js";
-import "./chunk-L7MJJAG2.js";
+import "./chunk-NRDLOFAI.js";
 import {
   filterRecallCandidates,
   hasIdentityRecoveryIntent,
   resolveEffectiveIdentityInjectionMode
-} from "./chunk-NYQHD7H4.js";
+} from "./chunk-YTWEK6CU.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-J2R275FN.js";
 import "./chunk-QJCWK2A7.js";
 import "./chunk-VQ7B2Q6M.js";
-import "./chunk-7KG5V4VV.js";
 import "./chunk-PJSK6OJM.js";
+import "./chunk-BZFHCRO6.js";
+import "./chunk-5QZR2RA3.js";
 import "./chunk-GNVZQ5JN.js";
 import "./chunk-YN2UN7N3.js";
-import "./chunk-5QZR2RA3.js";
 import "./chunk-P5FPO2BR.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-ZVZHG7AI.js";
@@ -283,7 +283,7 @@ import "./chunk-H7XKCNR6.js";
 import "./chunk-H6RSANGQ.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-LK4TOYPU.js";
-import "./chunk-BGD3T743.js";
+import "./chunk-JRYINMLF.js";
 import "./chunk-CVILPI77.js";
 import "./chunk-2HIJHXB3.js";
 import "./chunk-AQEJKOKI.js";
@@ -304,33 +304,33 @@ import "./chunk-LTHVM4XN.js";
 import "./chunk-X5YYSAZX.js";
 import "./chunk-C37ZRXX7.js";
 import "./chunk-7ZNJN5WZ.js";
-import "./chunk-4PEZMGZD.js";
-import "./chunk-BTRY6UH3.js";
-import "./chunk-I6T4SYFW.js";
-import "./chunk-YYAWJRGL.js";
+import "./chunk-CUQI6DR3.js";
+import "./chunk-JMMG5K7H.js";
+import "./chunk-63Z7D2YJ.js";
+import "./chunk-MYMME2VL.js";
 import "./chunk-UFGFMWAD.js";
-import "./chunk-DJ7TZLGU.js";
+import "./chunk-DHXPZZ5U.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-ZXBTTMGZ.js";
 import "./chunk-YMOPYG3K.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-LXY5VVGM.js";
-import "./chunk-YFK64FYK.js";
-import "./chunk-QOE3EM5Z.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-TPIO36PJ.js";
+import "./chunk-PVN6DVWU.js";
 import "./chunk-4ZWCQJNM.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-6FUMA6AA.js";
-import "./chunk-D35XLYQ7.js";
+import "./chunk-JFPUQ3E2.js";
+import "./chunk-UF65P4GF.js";
+import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
 import "./chunk-6KTXE6A3.js";
-import "./chunk-RACZB5HT.js";
-import "./chunk-AG46P24C.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-XZBXINXZ.js";
-import "./chunk-GUMZC2BO.js";
+import "./chunk-N37X5RU7.js";
+import "./chunk-NNBZS3DY.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-GUMZC2BO.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-227UFSEQ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";

package/dist/{public-http-C9-CHc40.d.ts → public-http-Bab7S0ED.d.ts}

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { f as EngramAccessService } from './access-service-DcfM0Vf0.js';
+import { f as EngramAccessService } from './access-service-CRZHXClX.js';
 
 declare const SUPPORT_PASSPORT_PUBLIC_HTTP_ROUTES: readonly [{
     readonly method: "GET";

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

@@ -0,0 +1,44 @@
+import { o as RecallDisclosure } from './types-eM7QIcX2.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';
+
+/**
+ * Disclosure-step planning for recall navigation (issue #1956).
+ *
+ * The ladder itself is NOT redefined here: `types.ts` designates
+ * `RECALL_DISCLOSURE_LEVELS` the single source of truth and forbids
+ * hard-coding disclosure strings elsewhere, so a second copy could drift out
+ * of agreement with recall validation and rendering. This module only adds
+ * the rule that an expansion must go strictly deeper, so a caller cannot
+ * re-pay recall budget for output it already holds. Pure — no I/O.
+ */
+
+type DisclosureStepResult = {
+    ok: true;
+    from: RecallDisclosure;
+    to: RecallDisclosure;
+    steps: number;
+} | {
+    ok: false;
+    error: "unknown_level" | "not_deeper";
+};
+/** Index in the canonical shallow-to-deep ladder. Throws for a non-level. */
+declare function disclosureRank(level: string): number;
+/**
+ * Plan one expansion. A bad level from an agent is a typed refusal rather
+ * than a throw; equal or shallower targets are `not_deeper`.
+ */
+declare function planDisclosureStep(input: {
+    from: string;
+    to: string;
+}): DisclosureStepResult;
+
+export { type DisclosureStepResult, disclosureRank, planDisclosureStep };

package/dist/recall-navigate-disclosure.js

@@ -0,0 +1,30 @@
+import {
+  RECALL_DISCLOSURE_LEVELS,
+  isRecallDisclosure
+} from "./chunk-XXW32OL7.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-disclosure.ts
+function disclosureRank(level) {
+  const index = RECALL_DISCLOSURE_LEVELS.indexOf(level);
+  if (index < 0) {
+    throw new RangeError(
+      `unknown disclosure level ${JSON.stringify(level)}; expected one of ${RECALL_DISCLOSURE_LEVELS.join(", ")}`
+    );
+  }
+  return index;
+}
+function planDisclosureStep(input) {
+  if (!isRecallDisclosure(input.from) || !isRecallDisclosure(input.to)) {
+    return { ok: false, error: "unknown_level" };
+  }
+  const fromRank = disclosureRank(input.from);
+  const toRank = disclosureRank(input.to);
+  if (toRank <= fromRank) return { ok: false, error: "not_deeper" };
+  return { ok: true, from: input.from, to: input.to, steps: toRank - fromRank };
+}
+export {
+  disclosureRank,
+  planDisclosureStep
+};
+//# sourceMappingURL=recall-navigate-disclosure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-disclosure.ts"],"sourcesContent":["/**\n * Disclosure-step planning for recall navigation (issue #1956).\n *\n * The ladder itself is NOT redefined here: `types.ts` designates\n * `RECALL_DISCLOSURE_LEVELS` the single source of truth and forbids\n * hard-coding disclosure strings elsewhere, so a second copy could drift out\n * of agreement with recall validation and rendering. This module only adds\n * the rule that an expansion must go strictly deeper, so a caller cannot\n * re-pay recall budget for output it already holds. Pure — no I/O.\n */\n\nimport {\n  isRecallDisclosure,\n  RECALL_DISCLOSURE_LEVELS,\n  type RecallDisclosure,\n} from \"./types.js\";\n\nexport type DisclosureStepResult =\n  | { ok: true; from: RecallDisclosure; to: RecallDisclosure; steps: number }\n  | { ok: false; error: \"unknown_level\" | \"not_deeper\" };\n\n/** Index in the canonical shallow-to-deep ladder. Throws for a non-level. */\nexport function disclosureRank(level: string): number {\n  const index = (RECALL_DISCLOSURE_LEVELS as readonly string[]).indexOf(level);\n  if (index < 0) {\n    throw new RangeError(\n      `unknown disclosure level ${JSON.stringify(level)}; expected one of ${RECALL_DISCLOSURE_LEVELS.join(\", \")}`,\n    );\n  }\n  return index;\n}\n\n/**\n * Plan one expansion. A bad level from an agent is a typed refusal rather\n * than a throw; equal or shallower targets are `not_deeper`.\n */\nexport function planDisclosureStep(input: { from: string; to: string }): DisclosureStepResult {\n  if (!isRecallDisclosure(input.from) || !isRecallDisclosure(input.to)) {\n    return { ok: false, error: \"unknown_level\" };\n  }\n  const fromRank = disclosureRank(input.from);\n  const toRank = disclosureRank(input.to);\n  if (toRank <= fromRank) return { ok: false, error: \"not_deeper\" };\n  return { ok: true, from: input.from, to: input.to, steps: toRank - fromRank };\n}\n"],"mappings":";;;;;;;AAsBO,SAAS,eAAe,OAAuB;AACpD,QAAM,QAAS,yBAA+C,QAAQ,KAAK;AAC3E,MAAI,QAAQ,GAAG;AACb,UAAM,IAAI;AAAA,MACR,4BAA4B,KAAK,UAAU,KAAK,CAAC,qBAAqB,yBAAyB,KAAK,IAAI,CAAC;AAAA,IAC3G;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,mBAAmB,OAA2D;AAC5F,MAAI,CAAC,mBAAmB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,GAAG;AACpE,WAAO,EAAE,IAAI,OAAO,OAAO,gBAAgB;AAAA,EAC7C;AACA,QAAM,WAAW,eAAe,MAAM,IAAI;AAC1C,QAAM,SAAS,eAAe,MAAM,EAAE;AACtC,MAAI,UAAU,SAAU,QAAO,EAAE,IAAI,OAAO,OAAO,aAAa;AAChE,SAAO,EAAE,IAAI,MAAM,MAAM,MAAM,MAAM,IAAI,MAAM,IAAI,OAAO,SAAS,SAAS;AAC9E;","names":[]}

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

@@ -0,0 +1,30 @@
+import { StateLabel } from './recall-state-view.js';
+
+/**
+ * Recall state-view evidence packets (issue #1952).
+ *
+ * Groups labeled state-view entries into per-head evidence packets so
+ * superseded records stay visible as ordered history instead of being
+ * hidden or interleaved with another packet's entries. Pure. Surfaces wait.
+ */
+
+interface StateViewEntry {
+    memoryId: string;
+    stateLabel: StateLabel;
+    /** Id of the entry that superseded this one, when any. */
+    supersededById?: string;
+}
+interface StateEvidencePacket {
+    /** The current (or transition) entry this packet is about. */
+    headId: string;
+    /** Predecessors, nearest to head first. Never interleaved with other packets. */
+    historyIds: string[];
+}
+interface StateEvidencePackets {
+    packets: StateEvidencePacket[];
+    /** Historical entries whose successor is absent from the input. */
+    orphanHistoryIds: string[];
+}
+declare function buildStateEvidencePackets(entries: readonly StateViewEntry[]): StateEvidencePackets;
+
+export { type StateEvidencePacket, type StateEvidencePackets, StateLabel, type StateViewEntry, buildStateEvidencePackets };

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

@@ -0,0 +1,69 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-state-view-packet.ts
+var STATE_LABELS = ["current", "historical", "transition"];
+function resolveHead(entry, byId) {
+  const visited = /* @__PURE__ */ new Set();
+  let current = entry;
+  let depth = 0;
+  for (; ; ) {
+    const successorId = current.supersededById;
+    if (successorId === void 0 || successorId.trim() === "") return void 0;
+    const successor = byId.get(successorId);
+    if (successor === void 0) return void 0;
+    depth += 1;
+    if (successor.stateLabel !== "historical") return { headId: successorId, depth };
+    if (visited.has(successorId)) return void 0;
+    visited.add(successorId);
+    current = successor;
+  }
+}
+function compareStrings(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function compareAttachments(a, b) {
+  if (a.headId !== b.headId) return compareStrings(a.headId, b.headId);
+  if (a.depth !== b.depth) return a.depth < b.depth ? -1 : 1;
+  return compareStrings(a.historyId, b.historyId);
+}
+function buildStateEvidencePackets(entries) {
+  for (const entry of entries) {
+    if (!STATE_LABELS.includes(entry.stateLabel)) {
+      throw new TypeError(
+        `unknown state label ${JSON.stringify(entry.stateLabel)}; expected one of "current", "historical", "transition"`
+      );
+    }
+  }
+  const byId = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (typeof entry.memoryId !== "string" || entry.memoryId.trim() === "") continue;
+    if (!byId.has(entry.memoryId)) byId.set(entry.memoryId, entry);
+  }
+  const packets = [];
+  const packetByHead = /* @__PURE__ */ new Map();
+  const attachments = [];
+  const orphanHistoryIds = [];
+  for (const [id, entry] of byId) {
+    if (entry.stateLabel !== "historical") {
+      const packet = { headId: id, historyIds: [] };
+      packetByHead.set(id, packet);
+      packets.push(packet);
+      continue;
+    }
+    const head = resolveHead(entry, byId);
+    if (head === void 0) orphanHistoryIds.push(id);
+    else attachments.push({ headId: head.headId, historyId: id, depth: head.depth });
+  }
+  attachments.sort(compareAttachments);
+  for (const attachment of attachments) {
+    const packet = packetByHead.get(attachment.headId);
+    if (packet) packet.historyIds.push(attachment.historyId);
+  }
+  packets.sort((a, b) => compareStrings(a.headId, b.headId));
+  orphanHistoryIds.sort(compareStrings);
+  return { packets, orphanHistoryIds };
+}
+export {
+  buildStateEvidencePackets
+};
+//# sourceMappingURL=recall-state-view-packet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-packet.ts"],"sourcesContent":["/**\n * Recall state-view evidence packets (issue #1952).\n *\n * Groups labeled state-view entries into per-head evidence packets so\n * superseded records stay visible as ordered history instead of being\n * hidden or interleaved with another packet's entries. Pure. Surfaces wait.\n */\nimport type { StateLabel } from \"./recall-state-view.js\";\n\nexport type { StateLabel };\n\nexport interface StateViewEntry {\n  memoryId: string;\n  stateLabel: StateLabel;\n  /** Id of the entry that superseded this one, when any. */\n  supersededById?: string;\n}\n\nexport interface StateEvidencePacket {\n  /** The current (or transition) entry this packet is about. */\n  headId: string;\n  /** Predecessors, nearest to head first. Never interleaved with other packets. */\n  historyIds: string[];\n}\n\nexport interface StateEvidencePackets {\n  packets: StateEvidencePacket[];\n  /** Historical entries whose successor is absent from the input. */\n  orphanHistoryIds: string[];\n}\n\nconst STATE_LABELS: readonly StateLabel[] = [\"current\", \"historical\", \"transition\"];\n\ninterface HeadResolution {\n  headId: string;\n  depth: number;\n}\n\ninterface Attachment {\n  headId: string;\n  historyId: string;\n  depth: number;\n}\n\n/**\n * Walk supersededById forward through intermediate historical entries and\n * stop at the first current/transition successor. Returns undefined when the\n * walk dead-ends (no or blank successor, successor id absent from the input)\n * or revisits an id (cycle), so callers treat the entry as an orphan.\n */\nfunction resolveHead(\n  entry: StateViewEntry,\n  byId: ReadonlyMap<string, StateViewEntry>,\n): HeadResolution | undefined {\n  const visited = new Set<string>();\n  let current = entry;\n  let depth = 0;\n  for (;;) {\n    const successorId = current.supersededById;\n    if (successorId === undefined || successorId.trim() === \"\") return undefined;\n    const successor = byId.get(successorId);\n    if (successor === undefined) return undefined;\n    depth += 1;\n    if (successor.stateLabel !== \"historical\") return { headId: successorId, depth };\n    if (visited.has(successorId)) return undefined;\n    visited.add(successorId);\n    current = successor;\n  }\n}\n\nfunction compareStrings(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n\nfunction compareAttachments(a: Attachment, b: Attachment): number {\n  if (a.headId !== b.headId) return compareStrings(a.headId, b.headId);\n  if (a.depth !== b.depth) return a.depth < b.depth ? -1 : 1;\n  return compareStrings(a.historyId, b.historyId);\n}\n\nexport function buildStateEvidencePackets(\n  entries: readonly StateViewEntry[],\n): StateEvidencePackets {\n  // Validate every label before any skip, dedup, or walk.\n  for (const entry of entries) {\n    if (!(STATE_LABELS as readonly string[]).includes(entry.stateLabel)) {\n      throw new TypeError(\n        `unknown state label ${JSON.stringify(entry.stateLabel)}; expected one of \"current\", \"historical\", \"transition\"`,\n      );\n    }\n  }\n\n  // Blank ids are ignored; on duplicate ids the first entry wins.\n  const byId = new Map<string, StateViewEntry>();\n  for (const entry of entries) {\n    if (typeof entry.memoryId !== \"string\" || entry.memoryId.trim() === \"\") continue;\n    if (!byId.has(entry.memoryId)) byId.set(entry.memoryId, entry);\n  }\n\n  // ponytail: per-entry chain walks are O(n^2) on one long chain; recall-sized\n  // result sets stay tiny, memoize if packet building ever moves offline.\n  const packets: StateEvidencePacket[] = [];\n  const packetByHead = new Map<string, StateEvidencePacket>();\n  const attachments: Attachment[] = [];\n  const orphanHistoryIds: string[] = [];\n\n  for (const [id, entry] of byId) {\n    if (entry.stateLabel !== \"historical\") {\n      const packet: StateEvidencePacket = { headId: id, historyIds: [] };\n      packetByHead.set(id, packet);\n      packets.push(packet);\n      continue;\n    }\n    const head = resolveHead(entry, byId);\n    if (head === undefined) orphanHistoryIds.push(id);\n    else attachments.push({ headId: head.headId, historyId: id, depth: head.depth });\n  }\n\n  attachments.sort(compareAttachments);\n  for (const attachment of attachments) {\n    const packet = packetByHead.get(attachment.headId);\n    if (packet) packet.historyIds.push(attachment.historyId);\n  }\n\n  packets.sort((a, b) => compareStrings(a.headId, b.headId));\n  orphanHistoryIds.sort(compareStrings);\n  return { packets, orphanHistoryIds };\n}\n"],"mappings":";;;AA+BA,IAAM,eAAsC,CAAC,WAAW,cAAc,YAAY;AAmBlF,SAAS,YACP,OACA,MAC4B;AAC5B,QAAM,UAAU,oBAAI,IAAY;AAChC,MAAI,UAAU;AACd,MAAI,QAAQ;AACZ,aAAS;AACP,UAAM,cAAc,QAAQ;AAC5B,QAAI,gBAAgB,UAAa,YAAY,KAAK,MAAM,GAAI,QAAO;AACnE,UAAM,YAAY,KAAK,IAAI,WAAW;AACtC,QAAI,cAAc,OAAW,QAAO;AACpC,aAAS;AACT,QAAI,UAAU,eAAe,aAAc,QAAO,EAAE,QAAQ,aAAa,MAAM;AAC/E,QAAI,QAAQ,IAAI,WAAW,EAAG,QAAO;AACrC,YAAQ,IAAI,WAAW;AACvB,cAAU;AAAA,EACZ;AACF;AAEA,SAAS,eAAe,GAAW,GAAmB;AACpD,SAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;AAClC;AAEA,SAAS,mBAAmB,GAAe,GAAuB;AAChE,MAAI,EAAE,WAAW,EAAE,OAAQ,QAAO,eAAe,EAAE,QAAQ,EAAE,MAAM;AACnE,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK;AACzD,SAAO,eAAe,EAAE,WAAW,EAAE,SAAS;AAChD;AAEO,SAAS,0BACd,SACsB;AAEtB,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAE,aAAmC,SAAS,MAAM,UAAU,GAAG;AACnE,YAAM,IAAI;AAAA,QACR,uBAAuB,KAAK,UAAU,MAAM,UAAU,CAAC;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AAGA,QAAM,OAAO,oBAAI,IAA4B;AAC7C,aAAW,SAAS,SAAS;AAC3B,QAAI,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,MAAM,GAAI;AACxE,QAAI,CAAC,KAAK,IAAI,MAAM,QAAQ,EAAG,MAAK,IAAI,MAAM,UAAU,KAAK;AAAA,EAC/D;AAIA,QAAM,UAAiC,CAAC;AACxC,QAAM,eAAe,oBAAI,IAAiC;AAC1D,QAAM,cAA4B,CAAC;AACnC,QAAM,mBAA6B,CAAC;AAEpC,aAAW,CAAC,IAAI,KAAK,KAAK,MAAM;AAC9B,QAAI,MAAM,eAAe,cAAc;AACrC,YAAM,SAA8B,EAAE,QAAQ,IAAI,YAAY,CAAC,EAAE;AACjE,mBAAa,IAAI,IAAI,MAAM;AAC3B,cAAQ,KAAK,MAAM;AACnB;AAAA,IACF;AACA,UAAM,OAAO,YAAY,OAAO,IAAI;AACpC,QAAI,SAAS,OAAW,kBAAiB,KAAK,EAAE;AAAA,QAC3C,aAAY,KAAK,EAAE,QAAQ,KAAK,QAAQ,WAAW,IAAI,OAAO,KAAK,MAAM,CAAC;AAAA,EACjF;AAEA,cAAY,KAAK,kBAAkB;AACnC,aAAW,cAAc,aAAa;AACpC,UAAM,SAAS,aAAa,IAAI,WAAW,MAAM;AACjD,QAAI,OAAQ,QAAO,WAAW,KAAK,WAAW,SAAS;AAAA,EACzD;AAEA,UAAQ,KAAK,CAAC,GAAG,MAAM,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC;AACzD,mBAAiB,KAAK,cAAc;AACpC,SAAO,EAAE,SAAS,iBAAiB;AACrC;","names":[]}