@remnic/core 10.0.13 → 10.0.14

package/dist/extraction.js

@@ -1,21 +1,22 @@
 import {
   ExtractionEngine,
   shouldEnableLocalExtractionThinking
-} from "./chunk-XRBHXUTQ.js";
-import "./chunk-ZUMXY4KA.js";
+} from "./chunk-WSGPFRBH.js";
+import "./chunk-22W2XWGH.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-2CGLBUW3.js";
 import "./chunk-AAQA6ZUP.js";
 import "./chunk-JHU4EYDV.js";
 import "./chunk-E4X2YX2F.js";
-import "./chunk-FZVROZKC.js";
+import "./chunk-XVZA6VXC.js";
+import "./chunk-JE26AUX6.js";
 import "./chunk-A6CXG5WI.js";
 import "./chunk-QJ2AX6DU.js";
-import "./chunk-JE26AUX6.js";
-import "./chunk-YRH3C2OJ.js";
-import "./chunk-375ARKRS.js";
+import "./chunk-CIIHIAJ2.js";
+import "./chunk-D5SSBCYY.js";
+import "./chunk-77R7BQZ2.js";
+import "./chunk-AIYXVWUH.js";
 import "./chunk-BVRZSI7Q.js";
-import "./chunk-LNH76ZJX.js";
 import {
   classifyExtractionThrownError,
   classifyFallbackParseFailure,
@@ -34,11 +35,11 @@ import "./chunk-5TJEOU6Y.js";
 import "./chunk-754XN6LX.js";
 import "./chunk-BLVHDY2U.js";
 import "./chunk-5MA7ZLPD.js";
-import "./chunk-ZIZ2G47N.js";
+import "./chunk-TITG2NBS.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-PIWFNPQT.js";
-import "./chunk-EGDYVYU7.js";
-import "./chunk-PBVNVKYN.js";
+import "./chunk-CLWBFR7Q.js";
+import "./chunk-PIN5OPBA.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
@@ -52,19 +53,19 @@ import "./chunk-ADXCCZL2.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-Y3VDGK2O.js";
+import "./chunk-PAZ35RJ4.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-A2E4WNW4.js";
-import "./chunk-KC46VZR5.js";
+import "./chunk-N4C7QKOG.js";
+import "./chunk-O2IPAX26.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-VOKHZRHW.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -74,37 +75,38 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FF6N7BXC.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YYO447A7.js";
+import "./chunk-FF6N7BXC.js";
+import "./chunk-JNIVZNIB.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
-import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-QZZPUREO.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-3GYSZHMT.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-4NDWE44P.js";
+import "./chunk-NZFFGO5O.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-G7D6GZ5J.js";
+import "./chunk-6EDW54SQ.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-DGRMWDQY.js";
+import "./chunk-66BCOVW2.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SWWHIJUJ.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WVHRNAXL.js";
-import "./chunk-TPSLVZHS.js";
-import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-23G5P7TA.js";
 import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -118,39 +120,40 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-QWWMS4AE.js";
+import "./chunk-3MO4LWYU.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-3I3U6FFT.js";
+import "./chunk-K7BN34IA.js";
 import "./chunk-353C5UNV.js";
-import "./chunk-OFCHT2TN.js";
+import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
+import "./chunk-STBX5X6B.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-WC3V7HHP.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-FQD2KPQH.js";
+import "./chunk-P55FACBG.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-YET735EZ.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-IG747LRN.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-KI6UOSNR.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-ESG6ITGP.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-C5LWPYS3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-PGRZ3FYC.js";
 import "./chunk-3Q3N35W7.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";

package/dist/{first-start-migration-HYAMKJ6V.js → first-start-migration-6A5BJPDW.js}

@@ -2,12 +2,12 @@ import {
   applyUtilityPromotionRuntimePolicy,
   loadUtilityRuntimeValues
 } from "./chunk-SWIKABKI.js";
-import {
-  TierMigrationExecutor
-} from "./chunk-YRFAYOFQ.js";
 import {
   decideTierTransition
 } from "./chunk-GCBIXUPT.js";
+import {
+  TierMigrationExecutor
+} from "./chunk-YRFAYOFQ.js";
 import "./chunk-W3K3HITK.js";
 import "./chunk-EBA5DA77.js";
 import "./chunk-TBBDFYXW.js";
@@ -273,4 +273,4 @@ export {
   LIFECYCLE_INIT_DONE_MARKER,
   runFirstStartMigration
 };
-//# sourceMappingURL=first-start-migration-HYAMKJ6V.js.map
+//# sourceMappingURL=first-start-migration-6A5BJPDW.js.map

package/dist/{forget-OHAJ6PSU.js → forget-GXBWFKRC.js}

@@ -1,13 +1,14 @@
 import {
   buildRetiredFactTombstoneInputs
-} from "./chunk-LZKOVXMX.js";
+} from "./chunk-TRMJ6BYC.js";
 import {
   supersessionKeysForFact
 } from "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-5FVVY2EB.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 
@@ -99,4 +100,4 @@ export {
   ForgetMemoryNotFoundError,
   forgetMemory
 };
-//# sourceMappingURL=forget-OHAJ6PSU.js.map
+//# sourceMappingURL=forget-GXBWFKRC.js.map

package/dist/{forget-OHAJ6PSU.js.map → forget-GXBWFKRC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/forget.ts"],"sourcesContent":["/**\n * Operator-facing memory forgetting (issue #686 PR 4/6).\n *\n * `remnic forget <id>` marks a memory as forgotten — a soft-delete that:\n *\n *   1. Sets `status: \"forgotten\"`, `forgottenAt`, optional\n *      `forgottenReason` in YAML frontmatter via the existing\n *      `storage.writeMemoryFrontmatter` path (which logs the change\n *      to the lifecycle ledger and invalidates caches).\n *   2. Returns a structured result describing what changed so the\n *      CLI and downstream telemetry can render it.\n *\n * Memories with `status === \"forgotten\"` are excluded from recall,\n * browse, and entity attribution by the status filters that serve\n * active user context.  A future maintenance cron will hard-delete\n * forgotten memories after a configurable retention window (default\n * 90 days) — for this PR the file stays on disk and the act is\n * reversible by editing the YAML directly.\n *\n * This module ships the pure helper; the CLI wires it in `cli.ts` as\n * a new `remnic forget` subcommand.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport { buildRetiredFactTombstoneInputs } from \"../lifecycle/tombstones.js\";\nimport { supersessionKeysForFact } from \"../temporal-supersession.js\";\nimport type { MemoryFile } from \"../types.js\";\n\nexport interface ForgetMemoryRequest {\n  /** Memory id (frontmatter `id`) to forget. */\n  id: string;\n  /** Optional human-readable reason. */\n  reason?: string;\n  /** Override the timestamp written to `forgottenAt`. Defaults to `new Date().toISOString()`. */\n  now?: () => Date;\n}\n\nexport interface ForgetMemoryResult {\n  /** Memory id that was forgotten. */\n  id: string;\n  /** Filesystem path of the forgotten memory. */\n  path: string;\n  /** Prior status before the forget call, for audit. */\n  priorStatus: string;\n  /** Timestamp written to `forgottenAt`. */\n  forgottenAt: string;\n  /** Reason captured (or empty string if none). */\n  reason: string;\n}\n\nexport class ForgetMemoryNotFoundError extends Error {\n  readonly code = \"memory_not_found\" as const;\n  constructor(id: string) {\n    super(`memory not found: ${id}`);\n    this.name = \"ForgetMemoryNotFoundError\";\n  }\n}\n\nexport class ForgetMemoryAlreadyForgottenError extends Error {\n  readonly code = \"already_forgotten\" as const;\n  constructor(id: string, forgottenAt: string) {\n    super(`memory ${id} was already forgotten at ${forgottenAt}`);\n    this.name = \"ForgetMemoryAlreadyForgottenError\";\n  }\n}\n\n/**\n * Mark a memory as forgotten.  Pure orchestration over storage —\n * caller supplies the storage instance and the request.  Status\n * filters elsewhere in the codebase exclude `status: \"forgotten\"`\n * from recall/browse surfaces before they serve active user context.\n */\nexport async function forgetMemory(\n  storage: StorageManager,\n  request: ForgetMemoryRequest,\n): Promise<ForgetMemoryResult> {\n  const id = typeof request.id === \"string\" ? request.id.trim() : \"\";\n  if (id.length === 0) {\n    throw new Error(\"forget: memory id is required and must be non-empty\");\n  }\n  const memory = await findMemoryById(storage, id);\n  if (!memory) {\n    throw new ForgetMemoryNotFoundError(id);\n  }\n  if (memory.frontmatter.status === \"forgotten\") {\n    throw new ForgetMemoryAlreadyForgottenError(\n      id,\n      memory.frontmatter.forgottenAt ?? \"(unknown)\",\n    );\n  }\n  const priorStatus =\n    typeof memory.frontmatter.status === \"string\" ? memory.frontmatter.status : \"active\";\n  const now = (request.now ?? (() => new Date()))();\n  const forgottenAt = now.toISOString();\n  const reason = typeof request.reason === \"string\" ? request.reason.trim() : \"\";\n  await storage.writeMemoryFrontmatter(memory, {\n    status: \"forgotten\",\n    forgottenAt,\n    forgottenReason: reason.length > 0 ? reason : undefined,\n    updated: forgottenAt,\n  }, {\n    actor: \"remnic-forget\",\n    reasonCode: \"operator_forget\",\n  });\n  // Issue #1579 thread OchiF: emit a LIVE tombstone at forget time so a\n  // forgotten FACT cannot resurrect via re-extraction/import before an\n  // operator runs `remnic doctor --rebuild-tombstones`. Without this, the\n  // non-resurrection chokepoint in writeMemory has nothing to match — the\n  // forgotten fact's content hash is gone from the active index but no\n  // tombstone exists until a manual rebuild derives one — so the same fact\n  // written again through writeMemory becomes active. Mirrors supersedeMemory\n  // (contradiction) and applyTemporalSupersession via the shared\n  // buildRetiredFactTombstoneInputs helper. Best-effort (rule 34): a tombstone\n  // append failure must not fail the forget, which already succeeded on disk.\n  if (memory.frontmatter.category === \"fact\") {\n    for (const input of buildRetiredFactTombstoneInputs(\n      {\n        id,\n        content: memory.content,\n        ...(memory.frontmatter.contentHash\n          ? { contentHash: memory.frontmatter.contentHash }\n          : {}),\n        ...(memory.frontmatter.entityRef\n          ? { entityRef: memory.frontmatter.entityRef }\n          : {}),\n        ...(memory.frontmatter.structuredAttributes\n          ? { structuredAttributes: memory.frontmatter.structuredAttributes }\n          : {}),\n      },\n      {\n        reason: \"retraction\",\n        createdBy: \"user_correction\",\n        createdAt: forgottenAt,\n        supersessionKeysForFact,\n      },\n    )) {\n      try {\n        await storage.appendTombstone(input);\n      } catch {\n        // Best-effort — the forget already succeeded on disk.\n      }\n    }\n  }\n  return {\n    id,\n    path: memory.path,\n    priorStatus,\n    forgottenAt,\n    reason,\n  };\n}\n\nasync function findMemoryById(\n  storage: StorageManager,\n  id: string,\n): Promise<MemoryFile | null> {\n  const hot = await storage.readAllMemories();\n  const hotMatch = hot.find((m) => m.frontmatter.id === id);\n  if (hotMatch) return hotMatch;\n\n  const archived = await storage.readArchivedMemories();\n  const archivedMatch = archived.find((m) => m.frontmatter.id === id);\n  if (archivedMatch) return archivedMatch;\n\n  const cold = await storage.readAllColdMemories();\n  return cold.find((m) => m.frontmatter.id === id) ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;AAkDO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAC1C,OAAO;AAAA,EAChB,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,EAAE;AAC/B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAClD,OAAO;AAAA,EAChB,YAAY,IAAY,aAAqB;AAC3C,UAAM,UAAU,EAAE,6BAA6B,WAAW,EAAE;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAQA,eAAsB,aACpB,SACA,SAC6B;AAC7B,QAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,GAAG,KAAK,IAAI;AAChE,MAAI,GAAG,WAAW,GAAG;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,QAAM,SAAS,MAAM,eAAe,SAAS,EAAE;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,YAAY,WAAW,aAAa;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,MACA,OAAO,YAAY,eAAe;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cACJ,OAAO,OAAO,YAAY,WAAW,WAAW,OAAO,YAAY,SAAS;AAC9E,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,YAAY;AACpC,QAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,OAAO,KAAK,IAAI;AAC5E,QAAM,QAAQ,uBAAuB,QAAQ;AAAA,IAC3C,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI,SAAS;AAAA,IAC9C,SAAS;AAAA,EACX,GAAG;AAAA,IACD,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AAWD,MAAI,OAAO,YAAY,aAAa,QAAQ;AAC1C,eAAW,SAAS;AAAA,MAClB;AAAA,QACE;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,GAAI,OAAO,YAAY,cACnB,EAAE,aAAa,OAAO,YAAY,YAAY,IAC9C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,YACnB,EAAE,WAAW,OAAO,YAAY,UAAU,IAC1C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,uBACnB,EAAE,sBAAsB,OAAO,YAAY,qBAAqB,IAChE,CAAC;AAAA,MACP;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,WAAW;AAAA,QACX;AAAA,MACF;AAAA,IACF,GAAG;AACD,UAAI;AACF,cAAM,QAAQ,gBAAgB,KAAK;AAAA,MACrC,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,IAC4B;AAC5B,QAAM,MAAM,MAAM,QAAQ,gBAAgB;AAC1C,QAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AACxD,MAAI,SAAU,QAAO;AAErB,QAAM,WAAW,MAAM,QAAQ,qBAAqB;AACpD,QAAM,gBAAgB,SAAS,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AAClE,MAAI,cAAe,QAAO;AAE1B,QAAM,OAAO,MAAM,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,KAAK;AACtD;","names":[]}
+{"version":3,"sources":["../src/maintenance/forget.ts"],"sourcesContent":["/**\n * Operator-facing memory forgetting (issue #686 PR 4/6).\n *\n * `remnic forget <id>` marks a memory as forgotten — a soft-delete that:\n *\n *   1. Sets `status: \"forgotten\"`, `forgottenAt`, optional\n *      `forgottenReason` in YAML frontmatter via the existing\n *      `storage.writeMemoryFrontmatter` path (which logs the change\n *      to the lifecycle ledger and invalidates caches).\n *   2. Returns a structured result describing what changed so the\n *      CLI and downstream telemetry can render it.\n *\n * Memories with `status === \"forgotten\"` are excluded from recall,\n * browse, and entity attribution by the status filters that serve\n * active user context.  A future maintenance cron will hard-delete\n * forgotten memories after a configurable retention window (default\n * 90 days) — for this PR the file stays on disk and the act is\n * reversible by editing the YAML directly.\n *\n * This module ships the pure helper; the CLI wires it in `cli.ts` as\n * a new `remnic forget` subcommand.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport { buildRetiredFactTombstoneInputs } from \"../lifecycle/tombstones.js\";\nimport { supersessionKeysForFact } from \"../temporal-supersession.js\";\nimport type { MemoryFile } from \"../types.js\";\n\nexport interface ForgetMemoryRequest {\n  /** Memory id (frontmatter `id`) to forget. */\n  id: string;\n  /** Optional human-readable reason. */\n  reason?: string;\n  /** Override the timestamp written to `forgottenAt`. Defaults to `new Date().toISOString()`. */\n  now?: () => Date;\n}\n\nexport interface ForgetMemoryResult {\n  /** Memory id that was forgotten. */\n  id: string;\n  /** Filesystem path of the forgotten memory. */\n  path: string;\n  /** Prior status before the forget call, for audit. */\n  priorStatus: string;\n  /** Timestamp written to `forgottenAt`. */\n  forgottenAt: string;\n  /** Reason captured (or empty string if none). */\n  reason: string;\n}\n\nexport class ForgetMemoryNotFoundError extends Error {\n  readonly code = \"memory_not_found\" as const;\n  constructor(id: string) {\n    super(`memory not found: ${id}`);\n    this.name = \"ForgetMemoryNotFoundError\";\n  }\n}\n\nexport class ForgetMemoryAlreadyForgottenError extends Error {\n  readonly code = \"already_forgotten\" as const;\n  constructor(id: string, forgottenAt: string) {\n    super(`memory ${id} was already forgotten at ${forgottenAt}`);\n    this.name = \"ForgetMemoryAlreadyForgottenError\";\n  }\n}\n\n/**\n * Mark a memory as forgotten.  Pure orchestration over storage —\n * caller supplies the storage instance and the request.  Status\n * filters elsewhere in the codebase exclude `status: \"forgotten\"`\n * from recall/browse surfaces before they serve active user context.\n */\nexport async function forgetMemory(\n  storage: StorageManager,\n  request: ForgetMemoryRequest,\n): Promise<ForgetMemoryResult> {\n  const id = typeof request.id === \"string\" ? request.id.trim() : \"\";\n  if (id.length === 0) {\n    throw new Error(\"forget: memory id is required and must be non-empty\");\n  }\n  const memory = await findMemoryById(storage, id);\n  if (!memory) {\n    throw new ForgetMemoryNotFoundError(id);\n  }\n  if (memory.frontmatter.status === \"forgotten\") {\n    throw new ForgetMemoryAlreadyForgottenError(\n      id,\n      memory.frontmatter.forgottenAt ?? \"(unknown)\",\n    );\n  }\n  const priorStatus =\n    typeof memory.frontmatter.status === \"string\" ? memory.frontmatter.status : \"active\";\n  const now = (request.now ?? (() => new Date()))();\n  const forgottenAt = now.toISOString();\n  const reason = typeof request.reason === \"string\" ? request.reason.trim() : \"\";\n  await storage.writeMemoryFrontmatter(memory, {\n    status: \"forgotten\",\n    forgottenAt,\n    forgottenReason: reason.length > 0 ? reason : undefined,\n    updated: forgottenAt,\n  }, {\n    actor: \"remnic-forget\",\n    reasonCode: \"operator_forget\",\n  });\n  // Issue #1579 thread OchiF: emit a LIVE tombstone at forget time so a\n  // forgotten FACT cannot resurrect via re-extraction/import before an\n  // operator runs `remnic doctor --rebuild-tombstones`. Without this, the\n  // non-resurrection chokepoint in writeMemory has nothing to match — the\n  // forgotten fact's content hash is gone from the active index but no\n  // tombstone exists until a manual rebuild derives one — so the same fact\n  // written again through writeMemory becomes active. Mirrors supersedeMemory\n  // (contradiction) and applyTemporalSupersession via the shared\n  // buildRetiredFactTombstoneInputs helper. Best-effort (rule 34): a tombstone\n  // append failure must not fail the forget, which already succeeded on disk.\n  if (memory.frontmatter.category === \"fact\") {\n    for (const input of buildRetiredFactTombstoneInputs(\n      {\n        id,\n        content: memory.content,\n        ...(memory.frontmatter.contentHash\n          ? { contentHash: memory.frontmatter.contentHash }\n          : {}),\n        ...(memory.frontmatter.entityRef\n          ? { entityRef: memory.frontmatter.entityRef }\n          : {}),\n        ...(memory.frontmatter.structuredAttributes\n          ? { structuredAttributes: memory.frontmatter.structuredAttributes }\n          : {}),\n      },\n      {\n        reason: \"retraction\",\n        createdBy: \"user_correction\",\n        createdAt: forgottenAt,\n        supersessionKeysForFact,\n      },\n    )) {\n      try {\n        await storage.appendTombstone(input);\n      } catch {\n        // Best-effort — the forget already succeeded on disk.\n      }\n    }\n  }\n  return {\n    id,\n    path: memory.path,\n    priorStatus,\n    forgottenAt,\n    reason,\n  };\n}\n\nasync function findMemoryById(\n  storage: StorageManager,\n  id: string,\n): Promise<MemoryFile | null> {\n  const hot = await storage.readAllMemories();\n  const hotMatch = hot.find((m) => m.frontmatter.id === id);\n  if (hotMatch) return hotMatch;\n\n  const archived = await storage.readArchivedMemories();\n  const archivedMatch = archived.find((m) => m.frontmatter.id === id);\n  if (archivedMatch) return archivedMatch;\n\n  const cold = await storage.readAllColdMemories();\n  return cold.find((m) => m.frontmatter.id === id) ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkDO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAC1C,OAAO;AAAA,EAChB,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,EAAE;AAC/B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAClD,OAAO;AAAA,EAChB,YAAY,IAAY,aAAqB;AAC3C,UAAM,UAAU,EAAE,6BAA6B,WAAW,EAAE;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAQA,eAAsB,aACpB,SACA,SAC6B;AAC7B,QAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,GAAG,KAAK,IAAI;AAChE,MAAI,GAAG,WAAW,GAAG;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,QAAM,SAAS,MAAM,eAAe,SAAS,EAAE;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,YAAY,WAAW,aAAa;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,MACA,OAAO,YAAY,eAAe;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cACJ,OAAO,OAAO,YAAY,WAAW,WAAW,OAAO,YAAY,SAAS;AAC9E,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,YAAY;AACpC,QAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,OAAO,KAAK,IAAI;AAC5E,QAAM,QAAQ,uBAAuB,QAAQ;AAAA,IAC3C,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI,SAAS;AAAA,IAC9C,SAAS;AAAA,EACX,GAAG;AAAA,IACD,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AAWD,MAAI,OAAO,YAAY,aAAa,QAAQ;AAC1C,eAAW,SAAS;AAAA,MAClB;AAAA,QACE;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,GAAI,OAAO,YAAY,cACnB,EAAE,aAAa,OAAO,YAAY,YAAY,IAC9C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,YACnB,EAAE,WAAW,OAAO,YAAY,UAAU,IAC1C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,uBACnB,EAAE,sBAAsB,OAAO,YAAY,qBAAqB,IAChE,CAAC;AAAA,MACP;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,WAAW;AAAA,QACX;AAAA,MACF;AAAA,IACF,GAAG;AACD,UAAI;AACF,cAAM,QAAQ,gBAAgB,KAAK;AAAA,MACrC,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,IAC4B;AAC5B,QAAM,MAAM,MAAM,QAAQ,gBAAgB;AAC1C,QAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AACxD,MAAI,SAAU,QAAO;AAErB,QAAM,WAAW,MAAM,QAAQ,qBAAqB;AACpD,QAAM,gBAAgB,SAAS,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AAClE,MAAI,cAAe,QAAO;AAE1B,QAAM,OAAO,MAAM,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,KAAK;AACtD;","names":[]}

package/dist/{graph-edge-decay-CZ3SYLM4.js → graph-edge-decay-BYPZVJT4.js}

@@ -5,18 +5,19 @@ import {
   readGraphEdgeDecayStatus,
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
-} from "./chunk-Y6DZ33PA.js";
-import "./chunk-QUNDYIYZ.js";
-import "./chunk-BTJ6CAIA.js";
-import "./chunk-LXY5VVGM.js";
-import "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-5GX5457J.js";
+import "./chunk-YYEOR4XN.js";
+import "./chunk-4IYIGN53.js";
+import "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
@@ -28,4 +29,4 @@ export {
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
 };
-//# sourceMappingURL=graph-edge-decay-CZ3SYLM4.js.map
+//# sourceMappingURL=graph-edge-decay-BYPZVJT4.js.map

package/dist/graph-edge-decay-BYPZVJT4.js.map

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

package/dist/graph-jsonl.js

@@ -3,15 +3,16 @@ import {
   restoreRemovedNodeEdges,
   rollbackNodeEdgeRewrite,
   writeGraphJsonlAtomic
-} from "./chunk-QUNDYIYZ.js";
-import "./chunk-BTJ6CAIA.js";
-import "./chunk-LXY5VVGM.js";
-import "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-YYEOR4XN.js";
+import "./chunk-4IYIGN53.js";
+import "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";

package/dist/graph-snapshot.js

@@ -4,15 +4,16 @@ import {
   buildGraphSnapshot,
   normalizeGraphSnapshotLimit,
   parseGraphSnapshotSince
-} from "./chunk-6VAHJ2F6.js";
-import "./chunk-BTJ6CAIA.js";
-import "./chunk-LXY5VVGM.js";
-import "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-DMDWFQMR.js";
+import "./chunk-4IYIGN53.js";
+import "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/graph-write-lock.js

@@ -3,9 +3,10 @@ import {
   assertGraphLockHeld,
   withGraphWriteLock,
   yieldForLockHeartbeat
-} from "./chunk-ZQ3WU6JO.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+} from "./chunk-RXFCU3CY.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   GraphLockLostError,

package/dist/graph.js

@@ -16,19 +16,20 @@ import {
   readAllEdges,
   readEdges,
   readEdgesStrict
-} from "./chunk-BTJ6CAIA.js";
-import {
-  reconstructActivationPath
-} from "./chunk-LXY5VVGM.js";
+} from "./chunk-4IYIGN53.js";
 import {
   GraphLockLostError,
   withGraphWriteLock
-} from "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import {
+  reconstructActivationPath
+} from "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/harmonic-retrieval.js

@@ -3,23 +3,23 @@ import {
   readCueAnchors,
   readProjectedHarmonicGraph,
   searchHarmonicRetrieval
-} from "./chunk-VYPFEVOM.js";
+} from "./chunk-ZJVMUBYF.js";
 import "./chunk-5VC7J76U.js";
 import "./chunk-AZEZSQ5R.js";
 import "./chunk-BMWN7B3Y.js";
-import "./chunk-Y3VDGK2O.js";
+import "./chunk-PAZ35RJ4.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-A2E4WNW4.js";
-import "./chunk-KC46VZR5.js";
+import "./chunk-N4C7QKOG.js";
+import "./chunk-O2IPAX26.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-VOKHZRHW.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -29,36 +29,37 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FF6N7BXC.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YYO447A7.js";
+import "./chunk-FF6N7BXC.js";
+import "./chunk-JNIVZNIB.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
-import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-QZZPUREO.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-3GYSZHMT.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-4NDWE44P.js";
+import "./chunk-NZFFGO5O.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-DGRMWDQY.js";
+import "./chunk-6EDW54SQ.js";
+import "./chunk-66BCOVW2.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SWWHIJUJ.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WVHRNAXL.js";
-import "./chunk-TPSLVZHS.js";
-import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-23G5P7TA.js";
 import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -71,33 +72,34 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-QWWMS4AE.js";
+import "./chunk-3MO4LWYU.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-OFCHT2TN.js";
+import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
+import "./chunk-STBX5X6B.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-FQD2KPQH.js";
+import "./chunk-P55FACBG.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-YET735EZ.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-KI6UOSNR.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-C5LWPYS3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-PGRZ3FYC.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/http-retry.js

@@ -1,6 +1,7 @@
 import {
   sleep
-} from "./chunk-7LEQREP2.js";
+} from "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/http-retry.ts

package/dist/http-retry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/http-retry.ts"],"sourcesContent":["/**\n * Shared retrying fetch for connector packages (issue #2792).\n *\n * One copy of the retry loop that six connector clients and the X MCP\n * client duplicated: attempt counting, per-attempt timeout signal,\n * 429/5xx retry with Retry-After (seconds or HTTP-date) plus capped\n * exponential backoff, raw rethrow of caller aborts, and socket\n * release on retryable responses. Vendors keep everything\n * request-specific: headers/body, the error classes their callers\n * match on, and what happens to a successful response body.\n *\n * Import via the `@remnic/core/http-retry` subpath (same pattern as\n * `@remnic/core/abort-error`) — the root index stays untouched.\n */\n\nimport { sleep as defaultSleep } from \"./utils/sleep.js\";\n\nexport interface RetryingFetchOptions {\n  /** Request init for every attempt. Ignored when `buildInit` is set. */\n  init?: RequestInit;\n  /**\n   * Init builder invoked ONCE, before the retry loop. Request\n   * construction (e.g. token acquisition) must stay outside the\n   * transport retry boundary: a deterministic provider failure —\n   * missing grant, revoked grant, unpersistable token file — runs once\n   * and propagates unwrapped, never retried or vendor-wrapped.\n   */\n  buildInit?: () => RequestInit | Promise<RequestInit>;\n  fetchImpl?: typeof fetch;\n  sleep?: (ms: number) => Promise<void>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Retries after the first attempt. Default 3 (4 attempts total). */\n  maxRetries?: number;\n  maxRetryDelayMs?: number;\n  /** First backoff step; doubles per attempt. Default 1_000. */\n  backoffBaseMs?: number;\n  /**\n   * Vendor Retry-After parsing (e.g. a body field). A `null`/`undefined`\n   * result falls back to the shared Retry-After header parse, then to\n   * exponential backoff. A number (including 0) is used as-is.\n   */\n  retryAfterMs?: (response: Response) => number | null | undefined | Promise<number | null | undefined>;\n  /** Wraps an exhausted network/timeout failure into the vendor error. */\n  networkError: (err: unknown, attempts: number, context: NetworkErrorContext) => Error;\n  /** Wraps a retryable (429/5xx) response; thrown when retries are exhausted. */\n  retryableError: (response: Response) => Error | Promise<Error>;\n}\n\nexport interface NetworkErrorContext {\n  /** True when the helper's own timeout signal fired (not a caller abort). */\n  timedOut: boolean;\n}\n\n/**\n * Base class for connector API errors: a message plus optional HTTP\n * status and vendor detail. Vendor subclasses set their own `name`.\n */\nexport class ConnectorApiError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = \"ConnectorApiError\";\n  }\n}\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_MAX_RETRY_DELAY_MS = 30_000;\nconst DEFAULT_BACKOFF_BASE_MS = 1_000;\n\n/**\n * Network/timeout failures wrap Node error text that can carry loader\n * paths or stack fragments; sync errors reach MCP clients verbatim, so\n * only the error name + code survive.\n */\nexport function describeNetworkError(err: unknown): string {\n  if (!(err instanceof Error)) return \"unexpected non-Error failure\";\n  const code = (err as NodeJS.ErrnoException).code;\n  return typeof code === \"string\" && code.length > 0 ? `${err.name} (${code})` : err.name;\n}\n\n/** Loop instead of `/\\/+$/` — CodeQL js/polynomial-redos on user-set URLs. */\nexport function stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 0x2f) end--;\n  return value.slice(0, end);\n}\n\n/** Release the socket back to the pool: an unconsumed response body pins the undici connection. */\nexport function discardResponseBody(response: Response): void {\n  void response.body?.cancel().catch(() => {});\n}\n\n/**\n * Parse a `Retry-After` header as delay in ms, capped at `capMs`:\n * delay-seconds first, then HTTP-date. `undefined` when absent or\n * unparseable.\n */\nexport function retryAfterHeaderMs(response: Response, capMs: number): number | undefined {\n  const header = response.headers.get(\"retry-after\");\n  if (header === null || header.length === 0) return undefined;\n  const seconds = Number(header);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(capMs, Math.ceil(seconds * 1_000));\n  }\n  const when = Date.parse(header);\n  if (Number.isFinite(when)) {\n    return Math.min(capMs, Math.max(0, when - Date.now()));\n  }\n  return undefined;\n}\n\n/**\n * Fetch with retries on network failures, 429, and 5xx. Returns the\n * final response (ok or non-retryable status) for the caller to\n * interpret; throws the vendor-wrapped error when retries are exhausted\n * or the transport fails.\n */\nexport async function retryingFetch(\n  url: string,\n  options: RetryingFetchOptions,\n): Promise<Response> {\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const sleep = options.sleep ?? defaultSleep;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n  const maxRetryDelayMs = options.maxRetryDelayMs ?? DEFAULT_MAX_RETRY_DELAY_MS;\n  const backoffBaseMs = options.backoffBaseMs ?? DEFAULT_BACKOFF_BASE_MS;\n  const backoffMs = (attempt: number): number =>\n    Math.min(maxRetryDelayMs, backoffBaseMs * 2 ** attempt);\n  const attempts = maxRetries + 1;\n\n  // Request construction runs once, outside the retry boundary: only\n  // fetch/network/HTTP-retryable failures retry, so initializer/token\n  // provider errors execute once and propagate unchanged (issue #2792).\n  options.signal?.throwIfAborted();\n  const init = options.buildInit ? await options.buildInit() : options.init;\n\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    options.signal?.throwIfAborted();\n    const timeoutSignal = AbortSignal.timeout(timeoutMs);\n    const combined = options.signal\n      ? AbortSignal.any([options.signal, timeoutSignal])\n      : timeoutSignal;\n    let response: Response;\n    try {\n      response = await fetchImpl(url, { ...init, signal: combined });\n    } catch (err) {\n      // The caller's abort always propagates unwrapped and unretried.\n      if (options.signal?.aborted) throw err;\n      if (attempt < maxRetries) {\n        await sleep(backoffMs(attempt));\n        continue;\n      }\n      throw options.networkError(err, attempts, { timedOut: timeoutSignal.aborted });\n    }\n\n    if (response.status === 429 || response.status >= 500) {\n      lastError = await options.retryableError(response);\n      if (attempt < maxRetries) {\n        const override = options.retryAfterMs ? await options.retryAfterMs(response) : undefined;\n        const delay = override ?? retryAfterHeaderMs(response, maxRetryDelayMs) ?? backoffMs(attempt);\n        discardResponseBody(response);\n        await sleep(delay);\n        continue;\n      }\n      discardResponseBody(response);\n      throw lastError;\n    }\n    return response;\n  }\n  // Unreachable: every terminal loop path throws. Kept for exhaustiveness.\n  throw lastError instanceof Error ? lastError : new ConnectorApiError(\"request failed\");\n}\n"],"mappings":"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","names":["sleep"]}
+{"version":3,"sources":["../src/http-retry.ts"],"sourcesContent":["/**\n * Shared retrying fetch for connector packages (issue #2792).\n *\n * One copy of the retry loop that six connector clients and the X MCP\n * client duplicated: attempt counting, per-attempt timeout signal,\n * 429/5xx retry with Retry-After (seconds or HTTP-date) plus capped\n * exponential backoff, raw rethrow of caller aborts, and socket\n * release on retryable responses. Vendors keep everything\n * request-specific: headers/body, the error classes their callers\n * match on, and what happens to a successful response body.\n *\n * Import via the `@remnic/core/http-retry` subpath (same pattern as\n * `@remnic/core/abort-error`) — the root index stays untouched.\n */\n\nimport { sleep as defaultSleep } from \"./utils/sleep.js\";\n\nexport interface RetryingFetchOptions {\n  /** Request init for every attempt. Ignored when `buildInit` is set. */\n  init?: RequestInit;\n  /**\n   * Init builder invoked ONCE, before the retry loop. Request\n   * construction (e.g. token acquisition) must stay outside the\n   * transport retry boundary: a deterministic provider failure —\n   * missing grant, revoked grant, unpersistable token file — runs once\n   * and propagates unwrapped, never retried or vendor-wrapped.\n   */\n  buildInit?: () => RequestInit | Promise<RequestInit>;\n  fetchImpl?: typeof fetch;\n  sleep?: (ms: number) => Promise<void>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Retries after the first attempt. Default 3 (4 attempts total). */\n  maxRetries?: number;\n  maxRetryDelayMs?: number;\n  /** First backoff step; doubles per attempt. Default 1_000. */\n  backoffBaseMs?: number;\n  /**\n   * Vendor Retry-After parsing (e.g. a body field). A `null`/`undefined`\n   * result falls back to the shared Retry-After header parse, then to\n   * exponential backoff. A number (including 0) is used as-is.\n   */\n  retryAfterMs?: (response: Response) => number | null | undefined | Promise<number | null | undefined>;\n  /** Wraps an exhausted network/timeout failure into the vendor error. */\n  networkError: (err: unknown, attempts: number, context: NetworkErrorContext) => Error;\n  /** Wraps a retryable (429/5xx) response; thrown when retries are exhausted. */\n  retryableError: (response: Response) => Error | Promise<Error>;\n}\n\nexport interface NetworkErrorContext {\n  /** True when the helper's own timeout signal fired (not a caller abort). */\n  timedOut: boolean;\n}\n\n/**\n * Base class for connector API errors: a message plus optional HTTP\n * status and vendor detail. Vendor subclasses set their own `name`.\n */\nexport class ConnectorApiError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = \"ConnectorApiError\";\n  }\n}\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_MAX_RETRY_DELAY_MS = 30_000;\nconst DEFAULT_BACKOFF_BASE_MS = 1_000;\n\n/**\n * Network/timeout failures wrap Node error text that can carry loader\n * paths or stack fragments; sync errors reach MCP clients verbatim, so\n * only the error name + code survive.\n */\nexport function describeNetworkError(err: unknown): string {\n  if (!(err instanceof Error)) return \"unexpected non-Error failure\";\n  const code = (err as NodeJS.ErrnoException).code;\n  return typeof code === \"string\" && code.length > 0 ? `${err.name} (${code})` : err.name;\n}\n\n/** Loop instead of `/\\/+$/` — CodeQL js/polynomial-redos on user-set URLs. */\nexport function stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 0x2f) end--;\n  return value.slice(0, end);\n}\n\n/** Release the socket back to the pool: an unconsumed response body pins the undici connection. */\nexport function discardResponseBody(response: Response): void {\n  void response.body?.cancel().catch(() => {});\n}\n\n/**\n * Parse a `Retry-After` header as delay in ms, capped at `capMs`:\n * delay-seconds first, then HTTP-date. `undefined` when absent or\n * unparseable.\n */\nexport function retryAfterHeaderMs(response: Response, capMs: number): number | undefined {\n  const header = response.headers.get(\"retry-after\");\n  if (header === null || header.length === 0) return undefined;\n  const seconds = Number(header);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(capMs, Math.ceil(seconds * 1_000));\n  }\n  const when = Date.parse(header);\n  if (Number.isFinite(when)) {\n    return Math.min(capMs, Math.max(0, when - Date.now()));\n  }\n  return undefined;\n}\n\n/**\n * Fetch with retries on network failures, 429, and 5xx. Returns the\n * final response (ok or non-retryable status) for the caller to\n * interpret; throws the vendor-wrapped error when retries are exhausted\n * or the transport fails.\n */\nexport async function retryingFetch(\n  url: string,\n  options: RetryingFetchOptions,\n): Promise<Response> {\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const sleep = options.sleep ?? defaultSleep;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n  const maxRetryDelayMs = options.maxRetryDelayMs ?? DEFAULT_MAX_RETRY_DELAY_MS;\n  const backoffBaseMs = options.backoffBaseMs ?? DEFAULT_BACKOFF_BASE_MS;\n  const backoffMs = (attempt: number): number =>\n    Math.min(maxRetryDelayMs, backoffBaseMs * 2 ** attempt);\n  const attempts = maxRetries + 1;\n\n  // Request construction runs once, outside the retry boundary: only\n  // fetch/network/HTTP-retryable failures retry, so initializer/token\n  // provider errors execute once and propagate unchanged (issue #2792).\n  options.signal?.throwIfAborted();\n  const init = options.buildInit ? await options.buildInit() : options.init;\n\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    options.signal?.throwIfAborted();\n    const timeoutSignal = AbortSignal.timeout(timeoutMs);\n    const combined = options.signal\n      ? AbortSignal.any([options.signal, timeoutSignal])\n      : timeoutSignal;\n    let response: Response;\n    try {\n      response = await fetchImpl(url, { ...init, signal: combined });\n    } catch (err) {\n      // The caller's abort always propagates unwrapped and unretried.\n      if (options.signal?.aborted) throw err;\n      if (attempt < maxRetries) {\n        await sleep(backoffMs(attempt));\n        continue;\n      }\n      throw options.networkError(err, attempts, { timedOut: timeoutSignal.aborted });\n    }\n\n    if (response.status === 429 || response.status >= 500) {\n      lastError = await options.retryableError(response);\n      if (attempt < maxRetries) {\n        const override = options.retryAfterMs ? await options.retryAfterMs(response) : undefined;\n        const delay = override ?? retryAfterHeaderMs(response, maxRetryDelayMs) ?? backoffMs(attempt);\n        discardResponseBody(response);\n        await sleep(delay);\n        continue;\n      }\n      discardResponseBody(response);\n      throw lastError;\n    }\n    return response;\n  }\n  // Unreachable: every terminal loop path throws. Kept for exhaustiveness.\n  throw lastError instanceof Error ? lastError : new ConnectorApiError(\"request failed\");\n}\n"],"mappings":"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","names":["sleep"]}

package/dist/index.d.ts

@@ -170,7 +170,7 @@ export type { AnomalyDetectorConfig, AnomalyDetectorInput, AnomalyDetectorResult
 export { AccessAuditAdapter } from "./access-audit.js";
 export type { AccessAuditConfig, AccessAuditResult, } from "./access-audit.js";
 export type { PluginConfig, GatewayConfig, EntityFile, EntityStructuredSection, ConsolidationObservation, MemoryFile, MemoryFrontmatter, MemoryObservation, ExtractedFact, MemoryCategory, MemoryScope, MemoryActionType, MemoryActionEligibilityContext, MemoryActionEligibilitySource, ContinuityImprovementLoop, BriefingConfig, BriefingWindow, BriefingFocus, BriefingActiveThread, BriefingRecentEntity, BriefingOpenCommitment, BriefingFollowup, BriefingSections, BriefingResult, CalendarEvent, CalendarSource, RecallDisclosure, } from "./types.js";
-export { CONVERGE_CONFLICT_POLICIES, DEFAULT_CONVERGE_CONFLICT_POLICY, DEFAULT_CONVERGE_PEER_REQUEST_TIMEOUT_MS, MAX_CONVERGE_PEER_REQUEST_TIMEOUT_MS, envConvergePeerRequestTimeoutMs, normalizeConvergePeerRequestTimeoutMs, parseConvergeConfig } from "./converge-config.js";
+export { CONVERGE_CONFLICT_POLICIES, DEFAULT_CONVERGE_CONFLICT_POLICY, DEFAULT_CONVERGE_PEER_REQUEST_TIMEOUT_MS, MAX_CONVERGE_PEER_REQUEST_TIMEOUT_MS, envConvergePeerRequestTimeoutMs, normalizeConvergePeerRequestTimeoutMs, parseConvergeConfig, resolveConvergeCaptureWriteLockBackoff } from "./converge-config.js";
 export { DEFAULT_RECALL_DISCLOSURE, RECALL_DISCLOSURE_LEVELS, isRecallDisclosure, } from "./types.js";
 export type { Peer, PeerKind, PeerProfile, PeerProfileFieldProvenance, PeerInteractionLogEntry, } from "./peers/index.js";
 export { PEER_ID_PATTERN, PEER_ID_MAX_LENGTH, PEERS_DIR_NAME, assertValidPeerId, readPeer, writePeer, listPeers, appendInteractionLog, readInteractionLogRaw, readPeerProfile, writePeerProfile, } from "./peers/index.js";