@remnic/core 9.69.22 → 9.69.24

package/dist/extraction.js

@@ -1,8 +1,8 @@
 import {
   ExtractionEngine,
   shouldEnableLocalExtractionThinking
-} from "./chunk-7RRUHJPG.js";
-import "./chunk-RE3H6Y2X.js";
+} from "./chunk-KB2G2I6Q.js";
+import "./chunk-ZIW5JVRM.js";
 import "./chunk-AJTG3CP7.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-2CGLBUW3.js";
@@ -31,58 +31,58 @@ import "./chunk-WLZYGLJ4.js";
 import "./chunk-IVKIODHO.js";
 import "./chunk-WKDFJXW5.js";
 import "./chunk-JUXOTY6J.js";
-import "./chunk-X33MJFD2.js";
+import "./chunk-KAXCYM66.js";
 import "./chunk-3UXOZBHV.js";
-import "./chunk-ZXBTTMGZ.js";
-import "./chunk-OGTKQ5MJ.js";
+import "./chunk-KEF46KL2.js";
+import "./chunk-XSGUMQQQ.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-4ZWCQJNM.js";
-import "./chunk-WVGXCBOC.js";
-import "./chunk-6FUMA6AA.js";
-import "./chunk-D35XLYQ7.js";
+import "./chunk-46WM6JX2.js";
+import "./chunk-D5F7TKMH.js";
+import "./chunk-2Z4GS5E6.js";
+import "./chunk-6CVNSDCZ.js";
+import "./chunk-BD7JTBYP.js";
+import "./chunk-OB3XMWX5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-TNSCIPBQ.js";
 import "./chunk-YQNNHLCG.js";
+import "./chunk-4O6WRBGE.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-W7IGLX4G.js";
 import "./chunk-227UFSEQ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-XOQGUGJL.js";
-import "./chunk-S2HLHAZ4.js";
+import "./chunk-SO7SV523.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-2GF27PGH.js";
+import "./chunk-MRPOZBJC.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-XSTNGNJP.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-LUDBXTBJ.js";
+import "./chunk-H272ZPQ3.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-U62OK7BB.js";
+import "./chunk-JPKK466T.js";
 import "./chunk-XCB6QDL6.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-NNZFPYYX.js";
+import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-XQYTSZW3.js";
-import "./chunk-7GSSHAXC.js";
+import "./chunk-L7Z57SID.js";
+import "./chunk-NLYVH66G.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
-import "./chunk-C24UZSFW.js";
+import "./chunk-CEH2AFXG.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WKAXBXVA.js";
+import "./chunk-ZLQ37WJX.js";
+import "./chunk-3QQTXYZ6.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -92,11 +92,6 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
-import "./chunk-W5BIQOAJ.js";
-import "./chunk-Z7L72ZHL.js";
-import "./chunk-4O4TKIXQ.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-TOTT6S2V.js";
 import "./chunk-K6MV3TRQ.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
@@ -104,31 +99,36 @@ import "./chunk-QDW3E4RD.js";
 import "./chunk-NXH34IPL.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-P6FHFTZ7.js";
-import "./chunk-ME35HVDJ.js";
+import "./chunk-VYCOJKSX.js";
 import "./chunk-6Q3ZTEF6.js";
+import "./chunk-W5BIQOAJ.js";
+import "./chunk-Z7L72ZHL.js";
+import "./chunk-4O4TKIXQ.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-YCVB7X56.js";
+import "./chunk-TOTT6S2V.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
-import "./chunk-BJMBJZ2Y.js";
-import "./chunk-UKJAGEXH.js";
-import "./chunk-FP2373TW.js";
-import "./chunk-J6A3CX5N.js";
-import "./chunk-JRRQ747T.js";
+import "./chunk-TG3FAM2S.js";
+import "./chunk-TBXAY2SS.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-ESNFSSO4.js";
 import "./chunk-AW4QUFQF.js";
-import "./chunk-GCASGYIO.js";
+import "./chunk-C7HJ3NEI.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-NB3LRY4T.js";
+import "./chunk-5FVVY2EB.js";
+import "./chunk-FFAZ2XFU.js";
 import "./chunk-MZWSOLMT.js";
 import "./chunk-EEOUMG3J.js";
-import "./chunk-TVW4C7PV.js";
-import "./chunk-FFAZ2XFU.js";
-import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-MRV7VSQK.js";
 import "./chunk-PCXDUHQH.js";
@@ -141,10 +141,10 @@ import "./chunk-JUC24CTX.js";
 import "./chunk-2Z24E5W2.js";
 import "./chunk-BTTPKDIL.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-ET2CNMLD.js";
+import "./chunk-JN72EPOE.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-VS2IYZRU.js";
-import "./chunk-5UZXUTVO.js";
+import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/fallback-llm.d.ts

@@ -1,4 +1,4 @@
-import { G as GatewayConfig, A as AgentPersonaModelConfig, P as PluginConfig } from './types-BRg3tMyp.js';
+import { G as GatewayConfig, A as AgentPersonaModelConfig, P as PluginConfig } from './types-YY-eKKU7.js';
 import { GetRuntimeAuthForModelFn, ResolveApiKeyFn } from './resolve-provider-secret.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -10,6 +10,7 @@ import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
+import './semantic-merge-config.js';
 import './types-continuity.js';
 
 interface FallbackLlmOptions {

package/dist/{first-start-migration-KHIMCBIC.js → first-start-migration-RC345GPL.js}

@@ -1,15 +1,15 @@
 import {
   applyUtilityPromotionRuntimePolicy,
   loadUtilityRuntimeValues
-} from "./chunk-SEF4IOFE.js";
+} from "./chunk-SWIKABKI.js";
 import {
   TierMigrationExecutor
 } from "./chunk-YRFAYOFQ.js";
 import {
   decideTierTransition
 } from "./chunk-DD5JFCWM.js";
-import "./chunk-HDQUQBPW.js";
-import "./chunk-6FC3IZ26.js";
+import "./chunk-W3K3HITK.js";
+import "./chunk-EBA5DA77.js";
 import "./chunk-TBBDFYXW.js";
 import {
   excludeSupportPassportPrivateMemories
@@ -25,7 +25,8 @@ import {
   resolveUtilityLearningCapabilities
 } from "./chunk-JUOZ62Y7.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-P77QX3ID.js";
+import "./chunk-B6O2YLUR.js";
+import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/maintenance/first-start-migration.ts
@@ -272,4 +273,4 @@ export {
   LIFECYCLE_INIT_DONE_MARKER,
   runFirstStartMigration
 };
-//# sourceMappingURL=first-start-migration-KHIMCBIC.js.map
+//# sourceMappingURL=first-start-migration-RC345GPL.js.map

package/dist/{first-start-migration-KHIMCBIC.js.map → first-start-migration-RC345GPL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/first-start-migration.ts"],"sourcesContent":["/**\n * First-start lifecycle migration (issue #686 retention-completion).\n *\n * When `lifecyclePolicyEnabled` is true but the memoryDir has never been\n * touched by the lifecycle policy (i.e. the state marker\n * `.lifecycle-init-done` does not exist), run a one-time, rate-limited\n * demotion sweep so the hot tier isn't flooded on the first real cron pass.\n *\n * Design constraints:\n *   - Capped at `FIRST_START_DEMOTION_CAP` (default 50) demotions per run\n *     so a large pre-existing corpus doesn't stall startup.\n *   - Resumable: subsequent invocations see the marker and skip.\n *   - The marker is written AFTER all mutations succeed so a crash during\n *     migration doesn't leave a false \"done\" marker (CLAUDE.md rule #12).\n *   - Dry-run mode reports candidates without mutating anything or writing\n *     the marker (safe to call from tests).\n */\n\nimport path from \"node:path\";\nimport { access, mkdir, readFile, unlink, writeFile } from \"node:fs/promises\";\nimport {\n  resolveMemoryLifecycleCapabilities,\n  resolveQmdCapabilities,\n  resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport type { StorageManager } from \"../storage.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport {\n  decideTierTransition,\n  type TierRoutingPolicy,\n} from \"../tier-routing.js\";\nimport { TierMigrationExecutor } from \"../tier-migration.js\";\nimport type { SearchBackend } from \"../search/port.js\";\nimport {\n  applyUtilityPromotionRuntimePolicy,\n  loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\nimport { excludeSupportPassportPrivateMemories } from \"../support-passport/card-projection.js\";\n\nexport const FIRST_START_DEMOTION_CAP = 50;\nexport const LIFECYCLE_INIT_DONE_MARKER = \".lifecycle-init-done\";\nconst LIFECYCLE_QMD_REFRESH_PENDING_MARKER = \".lifecycle-qmd-refresh-pending\";\n\ntype QmdRefreshPendingMarker = {\n  createdAt: string;\n  collection: string;\n};\n\nexport interface FirstStartMigrationOptions {\n  storage: StorageManager;\n  config: PluginConfig;\n  /** Override the per-run demotion cap (default: FIRST_START_DEMOTION_CAP). */\n  demotionCap?: number;\n  /** When true, report candidates but do not mutate or write the marker. */\n  dryRun?: boolean;\n  /** Optional QMD backend used to journal demotions and refresh tier collections. */\n  qmd?: SearchBackend;\n  /** Hot-tier QMD collection name. Defaults to config.qmdCollection. */\n  hotCollection?: string;\n  /** Cold-tier QMD collection name. Defaults to config.qmdColdCollection. */\n  coldCollection?: string;\n  /** Optional shutdown signal. When aborted, the migration stops without writing the done marker. */\n  signal?: AbortSignal;\n  /** Override clock for tests. */\n  now?: () => Date;\n}\n\nexport interface FirstStartMigrationResult {\n  skipped: boolean;\n  skipReason?: string;\n  dryRun: boolean;\n  candidateCount: number;\n  demotedCount: number;\n  /** Number of individual demotion failures. When > 0, the init-done marker is\n   *  NOT written so the next start can retry the failed demotions. */\n  failureCount: number;\n  cappedAt: number;\n}\n\nfunction markerPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_INIT_DONE_MARKER);\n}\n\nfunction qmdRefreshPendingPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_QMD_REFRESH_PENDING_MARKER);\n}\n\nasync function markerExists(memoryDir: string): Promise<boolean> {\n  try {\n    await access(markerPath(memoryDir));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeMarker(memoryDir: string, now: Date): Promise<void> {\n  const p = markerPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString() }), \"utf-8\");\n}\n\nasync function readQmdRefreshPending(memoryDir: string): Promise<QmdRefreshPendingMarker | null> {\n  try {\n    const raw = await readFile(qmdRefreshPendingPath(memoryDir), \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (\n      parsed &&\n      typeof parsed === \"object\" &&\n      typeof (parsed as { createdAt?: unknown }).createdAt === \"string\" &&\n      typeof (parsed as { collection?: unknown }).collection === \"string\" &&\n      (parsed as { collection: string }).collection.length > 0\n    ) {\n      return parsed as QmdRefreshPendingMarker;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeQmdRefreshPending(memoryDir: string, now: Date, collection: string): Promise<void> {\n  const p = qmdRefreshPendingPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString(), collection }), \"utf-8\");\n}\n\nasync function clearQmdRefreshPending(memoryDir: string): Promise<void> {\n  await unlink(qmdRefreshPendingPath(memoryDir)).catch(() => {});\n}\n\nasync function buildTierRoutingPolicy(config: PluginConfig): Promise<TierRoutingPolicy> {\n  const basePolicy: TierRoutingPolicy = {\n    enabled: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n  });\n  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nasync function refreshQmdCollection(\n  qmd: SearchBackend,\n  collection: string,\n  signal?: AbortSignal,\n): Promise<void> {\n  if (typeof qmd.updateCollectionStrict === \"function\") {\n    await qmd.updateCollectionStrict(collection, { signal });\n    return;\n  }\n  await qmd.updateCollection(collection, { signal });\n}\n\n/**\n * Run the first-start migration sweep.  No-ops when:\n *   - `lifecyclePolicyEnabled` is false, or\n *   - `qmdTierMigrationEnabled` is false (no tier migration configured), or\n *   - the state marker already exists (already ran).\n *\n * Returns a structured result describing what happened.\n */\nexport async function runFirstStartMigration(\n  options: FirstStartMigrationOptions,\n): Promise<FirstStartMigrationResult> {\n  const {\n    storage,\n    config,\n    demotionCap = FIRST_START_DEMOTION_CAP,\n    dryRun = false,\n    qmd,\n    signal,\n  } = options;\n  const now = (options.now ?? (() => new Date()))();\n  const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\n  const abortedResult = (candidateCount = 0, demotedCount = 0, failureCount = 0): FirstStartMigrationResult => ({\n    skipped: candidateCount === 0 && demotedCount === 0 && failureCount === 0,\n    skipReason: candidateCount === 0 && demotedCount === 0 && failureCount === 0 ? \"aborted\" : undefined,\n    dryRun,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  });\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  if (!lifecycleCaps.lifecyclePolicy) {\n    return {\n      skipped: true,\n      skipReason: \"lifecyclePolicyEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (!resolveQmdCapabilities(config).qmdTierMigration) {\n    return {\n      skipped: true,\n      skipReason: \"qmdTierMigrationEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (await markerExists(config.memoryDir)) {\n    return {\n      skipped: true,\n      skipReason: \"lifecycle-init-done marker already present\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const policy = await buildTierRoutingPolicy(config);\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const hotMemories = excludeSupportPassportPrivateMemories(await storage.readAllMemories());\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  // Find hot memories that should be demoted to cold\n  const demotionCandidates = hotMemories.filter((m) => {\n    const decision = decideTierTransition(m, \"hot\", policy, now);\n    return decision.changed && decision.nextTier === \"cold\";\n  });\n\n  const candidateCount = demotionCandidates.length;\n  // Apply cap\n  const batch = demotionCandidates.slice(0, demotionCap);\n\n  if (dryRun) {\n    return {\n      skipped: false,\n      dryRun: true,\n      candidateCount,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  let demotedCount = 0;\n  let failureCount = 0;\n  let qmdRefreshPendingForRun = false;\n  const executor = qmd\n    ? new TierMigrationExecutor({\n        storage,\n        qmd,\n        hotCollection: options.hotCollection ?? config.qmdCollection ?? \"openclaw-engram\",\n        coldCollection: options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\",\n      })\n    : null;\n  const coldCollection = options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\";\n\n  for (const memory of batch) {\n    if (signal?.aborted) {\n      return abortedResult(candidateCount, demotedCount, failureCount);\n    }\n    try {\n      const result = executor\n        ? await executor.migrateMemory({\n            memory,\n            fromTier: \"hot\",\n            toTier: \"cold\",\n            reason: \"first-start-lifecycle-migration\",\n          })\n        : await storage.migrateMemoryToTier(memory, \"cold\");\n      if (result.changed) {\n        demotedCount += 1;\n      }\n    } catch {\n      const targetPath = storage.buildTierMemoryPath(memory, \"cold\");\n      const [targetExists, sourceExists] = await Promise.all([\n        pathExists(targetPath),\n        pathExists(memory.path),\n      ]);\n      const movedToCold = targetExists && !sourceExists;\n      if (movedToCold) {\n        if (!qmd) {\n          demotedCount += 1;\n          continue;\n        }\n        try {\n          await refreshQmdCollection(qmd, coldCollection, signal);\n          demotedCount += 1;\n          continue;\n        } catch {\n          qmdRefreshPendingForRun = true;\n          try {\n            await writeQmdRefreshPending(config.memoryDir, now, coldCollection);\n          } catch {\n            // The end-of-run retry below still gets a chance to repair the QMD\n            // state before we decide whether the init marker is safe to write.\n          }\n          demotedCount += 1;\n          continue;\n        }\n      }\n      // Non-fatal — individual migration failures are counted but do not abort\n      // the sweep. We track them so the marker is only written when ALL\n      // attempted demotions succeeded (CLAUDE.md rule #12: don't write a\n      // success marker after a partial failure).\n      failureCount += 1;\n    }\n  }\n\n  // Write marker AFTER all mutations succeed (CLAUDE.md rule #12).\n  // If any demotion failed, skip the marker so the next start retries.\n  if (signal?.aborted) {\n    return abortedResult(candidateCount, demotedCount, failureCount);\n  }\n  const persistedQmdRefreshPending = qmd ? await readQmdRefreshPending(config.memoryDir) : null;\n  const hasPersistedQmdRefreshPending = persistedQmdRefreshPending?.collection === coldCollection;\n  if (qmd && persistedQmdRefreshPending && persistedQmdRefreshPending.collection !== coldCollection) {\n    failureCount += 1;\n  }\n  if (qmd && (qmdRefreshPendingForRun || hasPersistedQmdRefreshPending)) {\n    try {\n      await refreshQmdCollection(qmd, coldCollection, signal);\n      await clearQmdRefreshPending(config.memoryDir);\n    } catch {\n      failureCount += 1;\n    }\n  }\n  if (failureCount === 0) {\n    await writeMarker(config.memoryDir, now);\n  }\n\n  return {\n    skipped: false,\n    dryRun: false,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  };\n}\n"],"mappings":"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","names":["candidateCount","demotedCount","failureCount"]}
+{"version":3,"sources":["../src/maintenance/first-start-migration.ts"],"sourcesContent":["/**\n * First-start lifecycle migration (issue #686 retention-completion).\n *\n * When `lifecyclePolicyEnabled` is true but the memoryDir has never been\n * touched by the lifecycle policy (i.e. the state marker\n * `.lifecycle-init-done` does not exist), run a one-time, rate-limited\n * demotion sweep so the hot tier isn't flooded on the first real cron pass.\n *\n * Design constraints:\n *   - Capped at `FIRST_START_DEMOTION_CAP` (default 50) demotions per run\n *     so a large pre-existing corpus doesn't stall startup.\n *   - Resumable: subsequent invocations see the marker and skip.\n *   - The marker is written AFTER all mutations succeed so a crash during\n *     migration doesn't leave a false \"done\" marker (CLAUDE.md rule #12).\n *   - Dry-run mode reports candidates without mutating anything or writing\n *     the marker (safe to call from tests).\n */\n\nimport path from \"node:path\";\nimport { access, mkdir, readFile, unlink, writeFile } from \"node:fs/promises\";\nimport {\n  resolveMemoryLifecycleCapabilities,\n  resolveQmdCapabilities,\n  resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport type { StorageManager } from \"../storage.js\";\nimport type { PluginConfig } from \"../types.js\";\nimport {\n  decideTierTransition,\n  type TierRoutingPolicy,\n} from \"../tier-routing.js\";\nimport { TierMigrationExecutor } from \"../tier-migration.js\";\nimport type { SearchBackend } from \"../search/port.js\";\nimport {\n  applyUtilityPromotionRuntimePolicy,\n  loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\nimport { excludeSupportPassportPrivateMemories } from \"../support-passport/card-projection.js\";\n\nexport const FIRST_START_DEMOTION_CAP = 50;\nexport const LIFECYCLE_INIT_DONE_MARKER = \".lifecycle-init-done\";\nconst LIFECYCLE_QMD_REFRESH_PENDING_MARKER = \".lifecycle-qmd-refresh-pending\";\n\ntype QmdRefreshPendingMarker = {\n  createdAt: string;\n  collection: string;\n};\n\nexport interface FirstStartMigrationOptions {\n  storage: StorageManager;\n  config: PluginConfig;\n  /** Override the per-run demotion cap (default: FIRST_START_DEMOTION_CAP). */\n  demotionCap?: number;\n  /** When true, report candidates but do not mutate or write the marker. */\n  dryRun?: boolean;\n  /** Optional QMD backend used to journal demotions and refresh tier collections. */\n  qmd?: SearchBackend;\n  /** Hot-tier QMD collection name. Defaults to config.qmdCollection. */\n  hotCollection?: string;\n  /** Cold-tier QMD collection name. Defaults to config.qmdColdCollection. */\n  coldCollection?: string;\n  /** Optional shutdown signal. When aborted, the migration stops without writing the done marker. */\n  signal?: AbortSignal;\n  /** Override clock for tests. */\n  now?: () => Date;\n}\n\nexport interface FirstStartMigrationResult {\n  skipped: boolean;\n  skipReason?: string;\n  dryRun: boolean;\n  candidateCount: number;\n  demotedCount: number;\n  /** Number of individual demotion failures. When > 0, the init-done marker is\n   *  NOT written so the next start can retry the failed demotions. */\n  failureCount: number;\n  cappedAt: number;\n}\n\nfunction markerPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_INIT_DONE_MARKER);\n}\n\nfunction qmdRefreshPendingPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", LIFECYCLE_QMD_REFRESH_PENDING_MARKER);\n}\n\nasync function markerExists(memoryDir: string): Promise<boolean> {\n  try {\n    await access(markerPath(memoryDir));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeMarker(memoryDir: string, now: Date): Promise<void> {\n  const p = markerPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString() }), \"utf-8\");\n}\n\nasync function readQmdRefreshPending(memoryDir: string): Promise<QmdRefreshPendingMarker | null> {\n  try {\n    const raw = await readFile(qmdRefreshPendingPath(memoryDir), \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (\n      parsed &&\n      typeof parsed === \"object\" &&\n      typeof (parsed as { createdAt?: unknown }).createdAt === \"string\" &&\n      typeof (parsed as { collection?: unknown }).collection === \"string\" &&\n      (parsed as { collection: string }).collection.length > 0\n    ) {\n      return parsed as QmdRefreshPendingMarker;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function writeQmdRefreshPending(memoryDir: string, now: Date, collection: string): Promise<void> {\n  const p = qmdRefreshPendingPath(memoryDir);\n  await mkdir(path.dirname(p), { recursive: true });\n  await writeFile(p, JSON.stringify({ createdAt: now.toISOString(), collection }), \"utf-8\");\n}\n\nasync function clearQmdRefreshPending(memoryDir: string): Promise<void> {\n  await unlink(qmdRefreshPendingPath(memoryDir)).catch(() => {});\n}\n\nasync function buildTierRoutingPolicy(config: PluginConfig): Promise<TierRoutingPolicy> {\n  const basePolicy: TierRoutingPolicy = {\n    enabled: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n  });\n  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nasync function refreshQmdCollection(\n  qmd: SearchBackend,\n  collection: string,\n  signal?: AbortSignal,\n): Promise<void> {\n  if (typeof qmd.updateCollectionStrict === \"function\") {\n    await qmd.updateCollectionStrict(collection, { signal });\n    return;\n  }\n  await qmd.updateCollection(collection, { signal });\n}\n\n/**\n * Run the first-start migration sweep.  No-ops when:\n *   - `lifecyclePolicyEnabled` is false, or\n *   - `qmdTierMigrationEnabled` is false (no tier migration configured), or\n *   - the state marker already exists (already ran).\n *\n * Returns a structured result describing what happened.\n */\nexport async function runFirstStartMigration(\n  options: FirstStartMigrationOptions,\n): Promise<FirstStartMigrationResult> {\n  const {\n    storage,\n    config,\n    demotionCap = FIRST_START_DEMOTION_CAP,\n    dryRun = false,\n    qmd,\n    signal,\n  } = options;\n  const now = (options.now ?? (() => new Date()))();\n  const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);\n  const abortedResult = (candidateCount = 0, demotedCount = 0, failureCount = 0): FirstStartMigrationResult => ({\n    skipped: candidateCount === 0 && demotedCount === 0 && failureCount === 0,\n    skipReason: candidateCount === 0 && demotedCount === 0 && failureCount === 0 ? \"aborted\" : undefined,\n    dryRun,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  });\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  if (!lifecycleCaps.lifecyclePolicy) {\n    return {\n      skipped: true,\n      skipReason: \"lifecyclePolicyEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (!resolveQmdCapabilities(config).qmdTierMigration) {\n    return {\n      skipped: true,\n      skipReason: \"qmdTierMigrationEnabled is false\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (await markerExists(config.memoryDir)) {\n    return {\n      skipped: true,\n      skipReason: \"lifecycle-init-done marker already present\",\n      dryRun,\n      candidateCount: 0,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const policy = await buildTierRoutingPolicy(config);\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  const hotMemories = excludeSupportPassportPrivateMemories(await storage.readAllMemories());\n  if (signal?.aborted) {\n    return abortedResult();\n  }\n\n  // Find hot memories that should be demoted to cold\n  const demotionCandidates = hotMemories.filter((m) => {\n    const decision = decideTierTransition(m, \"hot\", policy, now);\n    return decision.changed && decision.nextTier === \"cold\";\n  });\n\n  const candidateCount = demotionCandidates.length;\n  // Apply cap\n  const batch = demotionCandidates.slice(0, demotionCap);\n\n  if (dryRun) {\n    return {\n      skipped: false,\n      dryRun: true,\n      candidateCount,\n      demotedCount: 0,\n      failureCount: 0,\n      cappedAt: demotionCap,\n    };\n  }\n\n  let demotedCount = 0;\n  let failureCount = 0;\n  let qmdRefreshPendingForRun = false;\n  const executor = qmd\n    ? new TierMigrationExecutor({\n        storage,\n        qmd,\n        hotCollection: options.hotCollection ?? config.qmdCollection ?? \"openclaw-engram\",\n        coldCollection: options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\",\n      })\n    : null;\n  const coldCollection = options.coldCollection ?? config.qmdColdCollection ?? \"openclaw-engram-cold\";\n\n  for (const memory of batch) {\n    if (signal?.aborted) {\n      return abortedResult(candidateCount, demotedCount, failureCount);\n    }\n    try {\n      const result = executor\n        ? await executor.migrateMemory({\n            memory,\n            fromTier: \"hot\",\n            toTier: \"cold\",\n            reason: \"first-start-lifecycle-migration\",\n          })\n        : await storage.migrateMemoryToTier(memory, \"cold\");\n      if (result.changed) {\n        demotedCount += 1;\n      }\n    } catch {\n      const targetPath = storage.buildTierMemoryPath(memory, \"cold\");\n      const [targetExists, sourceExists] = await Promise.all([\n        pathExists(targetPath),\n        pathExists(memory.path),\n      ]);\n      const movedToCold = targetExists && !sourceExists;\n      if (movedToCold) {\n        if (!qmd) {\n          demotedCount += 1;\n          continue;\n        }\n        try {\n          await refreshQmdCollection(qmd, coldCollection, signal);\n          demotedCount += 1;\n          continue;\n        } catch {\n          qmdRefreshPendingForRun = true;\n          try {\n            await writeQmdRefreshPending(config.memoryDir, now, coldCollection);\n          } catch {\n            // The end-of-run retry below still gets a chance to repair the QMD\n            // state before we decide whether the init marker is safe to write.\n          }\n          demotedCount += 1;\n          continue;\n        }\n      }\n      // Non-fatal — individual migration failures are counted but do not abort\n      // the sweep. We track them so the marker is only written when ALL\n      // attempted demotions succeeded (CLAUDE.md rule #12: don't write a\n      // success marker after a partial failure).\n      failureCount += 1;\n    }\n  }\n\n  // Write marker AFTER all mutations succeed (CLAUDE.md rule #12).\n  // If any demotion failed, skip the marker so the next start retries.\n  if (signal?.aborted) {\n    return abortedResult(candidateCount, demotedCount, failureCount);\n  }\n  const persistedQmdRefreshPending = qmd ? await readQmdRefreshPending(config.memoryDir) : null;\n  const hasPersistedQmdRefreshPending = persistedQmdRefreshPending?.collection === coldCollection;\n  if (qmd && persistedQmdRefreshPending && persistedQmdRefreshPending.collection !== coldCollection) {\n    failureCount += 1;\n  }\n  if (qmd && (qmdRefreshPendingForRun || hasPersistedQmdRefreshPending)) {\n    try {\n      await refreshQmdCollection(qmd, coldCollection, signal);\n      await clearQmdRefreshPending(config.memoryDir);\n    } catch {\n      failureCount += 1;\n    }\n  }\n  if (failureCount === 0) {\n    await writeMarker(config.memoryDir, now);\n  }\n\n  return {\n    skipped: false,\n    dryRun: false,\n    candidateCount,\n    demotedCount,\n    failureCount,\n    cappedAt: demotionCap,\n  };\n}\n"],"mappings":"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","names":["candidateCount","demotedCount","failureCount"]}

package/dist/{forget-2AE4MDK3.js → forget-SZ2BXDGF.js}

@@ -1,12 +1,12 @@
 import {
   buildRetiredFactTombstoneInputs
-} from "./chunk-4ZWCQJNM.js";
+} from "./chunk-46WM6JX2.js";
 import {
   supersessionKeysForFact
 } from "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-FFAZ2XFU.js";
 import "./chunk-5FVVY2EB.js";
+import "./chunk-FFAZ2XFU.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 
@@ -98,4 +98,4 @@ export {
   ForgetMemoryNotFoundError,
   forgetMemory
 };
-//# sourceMappingURL=forget-2AE4MDK3.js.map
+//# sourceMappingURL=forget-SZ2BXDGF.js.map

package/dist/{graph-444E-DrF.d.ts → graph-DRkl22KE.d.ts}

@@ -1,4 +1,5 @@
 import { GraphConstructionCapabilitySet } from './capabilities.js';
+import './graph-write-lock.js';
 
 interface ActivationPredecessor {
     prev: string;
@@ -97,16 +98,7 @@ declare const CAUSAL_PHRASES: string[];
 declare function graphsDir(memoryDir: string): string;
 declare function graphFilePath(memoryDir: string, type: GraphType): string;
 declare function ensureGraphsDir(memoryDir: string): Promise<void>;
-/**
- * Run `fn` while holding the write lock for the given graph JSONL file.
- *
- * The lock is keyed by absolute file path so concurrent writes to
- * different graph types proceed independently. The chain recovers from
- * rejection (gotcha #40) so a single I/O failure does not poison all
- * future writers, but the original error is still surfaced to the
- * caller of `withGraphWriteLock`.
- */
-declare function withGraphWriteLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+
 declare function appendEdge(memoryDir: string, edge: GraphEdge): Promise<void>;
 /**
  * Read all edges of a given type from the JSONL file.
@@ -195,6 +187,12 @@ declare class GraphIndex {
     /**
      * Called after a memory is written to disk.
      *
+     * Throws when an edge append fails (after logging): the merged-target rewrite
+     * path depends on the rejection to restore the edges `removeNodeEdgesForRewrite`
+     * dropped — swallowing here left that restore dead and the prior edge set
+     * permanently lost (#2330). Fail-open is the CALLER's decision; the create
+     * paths already catch (see persistence-index.buildGraphEdge).
+     *
      * @param memoryPath - relative path from memoryDir (e.g. "facts/2026-02-22/abc.md")
      * @param entityRef  - entityRef frontmatter field (if any)
      * @param content    - full memory text (for causal detection)
@@ -223,7 +221,7 @@ declare class GraphIndex {
             causalGraph: boolean;
             multiGraphMemory: boolean;
         };
-    }): Promise<void>;
+    }): Promise<GraphEdge[]>;
     /**
      * Cross-process coherence check for the incremental edge cache (issue #1904).
      *
@@ -346,4 +344,4 @@ declare function applyLateralInhibition(scores: Map<string, number>, opts: {
     topM: number;
 }): Map<string, number>;
 
-export { type ActivationPath as A, CAUSAL_PHRASES as C, DEFAULT_GRAPH_TRAVERSAL_CONFIDENCE_FLOOR as D, type GraphType as G, type GraphEdge as a, type GraphHealthReport as b, GraphIndex as c, type ActivationPathCandidate as d, ActivationPathTracker as e, type ActivationPredecessor as f, compareActivationPathCandidates as g, DEFAULT_GRAPH_TRAVERSAL_PAGERANK_ITERATIONS as h, type GraphConfig as i, type GraphHealthFileStats as j, analyzeGraphHealth as k, appendEdge as l, applyLateralInhibition as m, applyPageRankRefinement as n, clampConfidenceFloor as o, clampPageRankIterations as p, detectCausalPhrase as q, reconstructActivationPath as r, ensureGraphsDir as s, graphFilePath as t, graphsDir as u, readAllEdges as v, readEdges as w, readEdgesStrict as x, withGraphWriteLock as y };
+export { type ActivationPath as A, CAUSAL_PHRASES as C, DEFAULT_GRAPH_TRAVERSAL_CONFIDENCE_FLOOR as D, type GraphType as G, type GraphEdge as a, type GraphHealthReport as b, GraphIndex as c, type ActivationPathCandidate as d, ActivationPathTracker as e, type ActivationPredecessor as f, compareActivationPathCandidates as g, DEFAULT_GRAPH_TRAVERSAL_PAGERANK_ITERATIONS as h, type GraphConfig as i, type GraphHealthFileStats as j, analyzeGraphHealth as k, appendEdge as l, applyLateralInhibition as m, applyPageRankRefinement as n, clampConfidenceFloor as o, clampPageRankIterations as p, detectCausalPhrase as q, reconstructActivationPath as r, ensureGraphsDir as s, graphFilePath as t, graphsDir as u, readAllEdges as v, readEdges as w, readEdgesStrict as x };

package/dist/graph-append-error.d.ts

@@ -0,0 +1,40 @@
+import { a as GraphEdge } from './graph-DRkl22KE.js';
+import './capabilities.js';
+import './types-YY-eKKU7.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 './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+import './graph-write-lock.js';
+import './utils/serialize-mutations.js';
+
+/**
+ * Sibling of {@link "./graph.js"} holding the append-failure error type so
+ * graph.ts stays within its file-size ratchet cap (issue #1995). Type-only
+ * dependency on GraphEdge — no runtime cycle with graph.ts.
+ */
+
+/**
+ * Issue #2330 round N+16 (A): thrown by `GraphIndex.onMemoryWritten` when an
+ * append fails, carrying the rows this call had ALREADY appended — tracked
+ * incrementally as each row is written, before any return value exists. A
+ * rollback that only sees the raw failure used to fall back to a node-wide
+ * sweep, which also deleted rows a NEWER writer had rebuilt inside the
+ * failing writer's window; with the partial set on the error, the rollback
+ * stays surgical even on the throwing path. The original failure is
+ * preserved as `cause` (create-path callers only log it).
+ */
+declare class GraphEdgeAppendError extends Error {
+    readonly appendedEdges: readonly GraphEdge[];
+    constructor(cause: unknown, appendedEdges: readonly GraphEdge[]);
+}
+
+export { GraphEdgeAppendError };

package/dist/graph-append-error.js

@@ -0,0 +1,8 @@
+import {
+  GraphEdgeAppendError
+} from "./chunk-GKCXTSFF.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  GraphEdgeAppendError
+};
+//# sourceMappingURL=graph-append-error.js.map

package/dist/graph-dashboard-diff.d.ts

@@ -1,7 +1,7 @@
-import { a as GraphEdge } from './graph-444E-DrF.js';
+import { a as GraphEdge } from './graph-DRkl22KE.js';
 import { GraphSnapshot } from './graph-dashboard-parser.js';
 import './capabilities.js';
-import './types-BRg3tMyp.js';
+import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -12,7 +12,10 @@ import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
+import './semantic-merge-config.js';
 import './types-continuity.js';
+import './graph-write-lock.js';
+import './utils/serialize-mutations.js';
 
 interface GraphPatch {
     addedNodes: string[];

package/dist/graph-dashboard-key.d.ts

@@ -1,6 +1,6 @@
-import { a as GraphEdge } from './graph-444E-DrF.js';
+import { a as GraphEdge } from './graph-DRkl22KE.js';
 import './capabilities.js';
-import './types-BRg3tMyp.js';
+import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -11,7 +11,10 @@ import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
+import './semantic-merge-config.js';
 import './types-continuity.js';
+import './graph-write-lock.js';
+import './utils/serialize-mutations.js';
 
 declare function graphEdgeKey(edge: GraphEdge): string;
 

package/dist/graph-dashboard-parser.d.ts

@@ -1,6 +1,6 @@
-import { a as GraphEdge, G as GraphType } from './graph-444E-DrF.js';
+import { a as GraphEdge, G as GraphType } from './graph-DRkl22KE.js';
 import './capabilities.js';
-import './types-BRg3tMyp.js';
+import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -11,7 +11,10 @@ import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
+import './semantic-merge-config.js';
 import './types-continuity.js';
+import './graph-write-lock.js';
+import './utils/serialize-mutations.js';
 
 interface GraphSnapshotNode {
     id: string;

package/dist/{graph-edge-decay-DGTBFALQ.js → graph-edge-decay-MKIRZ762.js}

@@ -5,13 +5,19 @@ import {
   readGraphEdgeDecayStatus,
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
-} from "./chunk-C2JCVZWX.js";
-import "./chunk-OLT3YTDH.js";
+} from "./chunk-SCXURCVT.js";
+import "./chunk-DGS34QSY.js";
+import "./chunk-5FAGCOZD.js";
+import "./chunk-EUT2WCWS.js";
+import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-LXY5VVGM.js";
-import "./chunk-2LSZVONP.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-FFAZ2XFU.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
+import "./chunk-KNA3BXXL.js";
+import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_VISIBILITY_THRESHOLD,
@@ -21,4 +27,4 @@ export {
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
 };
-//# sourceMappingURL=graph-edge-decay-DGTBFALQ.js.map
+//# sourceMappingURL=graph-edge-decay-MKIRZ762.js.map

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

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

package/dist/graph-edge-reinforcement.d.ts

@@ -1,6 +1,6 @@
-import { a as GraphEdge } from './graph-444E-DrF.js';
+import { a as GraphEdge } from './graph-DRkl22KE.js';
 import './capabilities.js';
-import './types-BRg3tMyp.js';
+import './types-YY-eKKU7.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -11,7 +11,10 @@ import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
+import './semantic-merge-config.js';
 import './types-continuity.js';
+import './graph-write-lock.js';
+import './utils/serialize-mutations.js';
 
 /**
  * Graph edge confidence + reinforcement primitives (issue #681, PR 1/3).

package/dist/graph-jsonl.d.ts

@@ -0,0 +1,82 @@
+import { G as GraphType, a as GraphEdge } from './graph-DRkl22KE.js';
+import { GraphWriteLockSection } from './graph-write-lock.js';
+import './capabilities.js';
+import './types-YY-eKKU7.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 './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+import './utils/serialize-mutations.js';
+
+/**
+ * Graph JSONL rewrite primitives (sibling of graph.ts, kept out so graph.ts
+ * stays under the 1200-LOC new-work cap of issue #1995).
+ *
+ * `appendEdge` in graph.ts is append-only by design. These helpers are the
+ * REPLACE path: callers that re-write an existing node's edges (the
+ * judge-merged target of issue #2330) must first drop the node's prior
+ * generated edges or every re-write duplicates them.
+ */
+
+declare function writeGraphJsonlAtomic(filePath: string, edges: GraphEdge[], lock: GraphWriteLockSection): Promise<void>;
+/** The edges one removal dropped from one graph file, kept for restoration. */
+interface RemovedNodeEdges {
+    type: GraphType;
+    filePath: string;
+    removed: GraphEdge[];
+}
+/**
+ * Remove an existing node's prior generated edges across the given graph
+ * types so a RE-write of the same node (a judge-merged memory, issue #2330)
+ * REPLACES them instead of re-appending them into the append-only JSONL —
+ * duplicates `spreadingActivation` sums into candidate scores and that grow
+ * without bound. One shared routine covers every enabled type; there is no
+ * per-type copy. Read and rewrite run under the same per-file write lock as
+ * `appendEdge` so a concurrent append cannot be dropped (issue #729). The
+ * removed edges are RETURNED so the caller can restore them when the
+ * replacement build fails (round N+7 E).
+ */
+declare function removeNodeEdgesForRewrite(memoryDir: string, memoryPath: string, types: readonly GraphType[]): Promise<RemovedNodeEdges[]>;
+/**
+ * Restore edges a {@link removeNodeEdgesForRewrite} pass dropped, after the
+ * replacement build FAILED (round N+7 E): failure must leave either the old
+ * or the new complete set, never none. Appends the removed edges back under
+ * the same per-file lock, deduped on the exact JSON row so a retry that
+ * partially succeeded cannot double them.
+ */
+declare function restoreRemovedNodeEdges(memoryDir: string, removed: RemovedNodeEdges): Promise<number>;
+/**
+ * Round N+10 (C) + N+14 companion to {@link removeNodeEdgesForRewrite}: the
+ * replacement build FAILED or was superseded, possibly after appending SOME
+ * of the node's new edges. Two duties, both scoped to what THIS writer did:
+ *
+ * 1. Remove the rows the failed build actually appended. When `appended` is
+ *    provided the removal is surgical — by exact JSON row identity, per
+ *    file, under the same per-file lock — so rows a NEWER writer appended
+ *    after this writer's removal (never in this writer's snapshot) survive.
+ *    Rows a newer writer already swept are simply absent and the removal is
+ *    a no-op. Since round N+16 (A) a THROWING build carries its partial row
+ *    set on `GraphEdgeAppendError`, so the surgical path holds on the throw
+ *    too; only a build that neither returns rows nor wraps its failure
+ *    falls back to the node-wide sweep of
+ *    {@link removeNodeEdgesForRewrite}: identical outcome when no newer
+ *    writer interleaved.
+ * 2. Restore the snapshot the original removal dropped — but only for graph
+ *    types whose file holds NO unexplained node rows after step 1. A type
+ *    that still has node rows this writer cannot account for is owned by the
+ *    newer writer's completed rebuild; restoring the older snapshot over it
+ *    left the memory holding B's body while graph recall reflected the
+ *    pre-A state (the N+14 finding). Types swept clean restore verbatim
+ *    (N+7 E: failure leaves the old or the new complete set, never none).
+ */
+declare function rollbackNodeEdgeRewrite(memoryDir: string, memoryPath: string, types: readonly GraphType[], removed: RemovedNodeEdges[], nodeId: string, appended?: readonly GraphEdge[]): Promise<void>;
+
+export { type RemovedNodeEdges, removeNodeEdgesForRewrite, restoreRemovedNodeEdges, rollbackNodeEdgeRewrite, writeGraphJsonlAtomic };

package/dist/graph-jsonl.js

@@ -0,0 +1,23 @@
+import {
+  removeNodeEdgesForRewrite,
+  restoreRemovedNodeEdges,
+  rollbackNodeEdgeRewrite,
+  writeGraphJsonlAtomic
+} from "./chunk-DGS34QSY.js";
+import "./chunk-5FAGCOZD.js";
+import "./chunk-EUT2WCWS.js";
+import "./chunk-2LSZVONP.js";
+import "./chunk-DEUNUKTD.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-FFAZ2XFU.js";
+import "./chunk-KNA3BXXL.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  removeNodeEdgesForRewrite,
+  restoreRemovedNodeEdges,
+  rollbackNodeEdgeRewrite,
+  writeGraphJsonlAtomic
+};
+//# sourceMappingURL=graph-jsonl.js.map