@remnic/core 9.3.723 → 9.3.724

package/dist/{graph-edge-decay-QPRJQ7DL.js.map → chunk-ZQNCHPTZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/graph-edge-decay.ts"],"sourcesContent":["/**\n * Graph-edge decay maintenance job (issue #681 PR 2/3).\n *\n * For each edge in the on-disk JSONL graph stores\n * (`<memoryDir>/state/graphs/{entity,time,causal}.jsonl`) call\n * {@link decayEdgeConfidence} from PR 1/3 and write the decayed edge\n * back to disk via the temp+rename atomic-replace pattern (CLAUDE.md\n * gotcha #54: never delete-before-write).\n *\n * Emits a structured telemetry record per run that the doctor surface\n * (`remnic doctor`) and a tail of the maintenance ledger can consume.\n *\n * Pure-helper-style API (the function takes a `memoryDir` + opts and\n * returns a record); callers wire the cron / MCP tool / CLI surfaces.\n */\n\nimport {\n  mkdir,\n  readdir,\n  readFile,\n  rename,\n  writeFile,\n} from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  decayEdgeConfidence,\n  DEFAULT_DECAY_FLOOR,\n  DEFAULT_DECAY_PER_WINDOW,\n  DEFAULT_DECAY_WINDOW_MS,\n  readEdgeConfidence,\n  type DecayOptions,\n} from \"../graph-edge-reinforcement.js\";\nimport {\n  graphFilePath,\n  graphsDir,\n  readEdgesStrict,\n  withGraphWriteLock,\n  type GraphEdge,\n  type GraphType,\n} from \"../graph.js\";\nimport { isSafeRouteNamespace } from \"../routing/engine.js\";\n\n/** Default visibility threshold for the \"below visibility\" telemetry counter. */\nexport const DEFAULT_VISIBILITY_THRESHOLD = 0.2;\n\nconst GRAPH_TYPES: readonly GraphType[] = [\"entity\", \"time\", \"causal\"] as const;\n\n/** Per-edge-type breakdown emitted by {@link runGraphEdgeDecayMaintenance}. */\nexport interface GraphEdgeDecayPerTypeStats {\n  type: GraphType;\n  edgesTotal: number;\n  edgesDecayed: number;\n  edgesBelowVisibilityThreshold: number;\n}\n\n/** Top-decayed-entity entry (label + total confidence drop summed across edges). */\nexport interface GraphEdgeDecayTopEntity {\n  label: string;\n  totalDrop: number;\n  edgeCount: number;\n}\n\n/**\n * Telemetry record emitted by every run of the decay job. Persisted to\n * `<memoryDir>/state/graph-edge-decay-status.json` for doctor consumption\n * and (optionally) appended to the maintenance ledger by callers.\n */\nexport interface GraphEdgeDecayTelemetry {\n  ranAt: string;\n  durationMs: number;\n  edgesTotal: number;\n  edgesDecayed: number;\n  edgesBelowVisibilityThreshold: number;\n  topDecayedEntities: GraphEdgeDecayTopEntity[];\n  perType: GraphEdgeDecayPerTypeStats[];\n  windowMs: number;\n  perWindow: number;\n  floor: number;\n  visibilityThreshold: number;\n}\n\nexport interface GraphEdgeDecayOptions extends DecayOptions {\n  /** Confidence threshold below which an edge counts as \"low visibility\". */\n  visibilityThreshold?: number;\n  /** Override \"now\" for deterministic testing. Defaults to `new Date().toISOString()`. */\n  now?: string;\n  /** When `true`, do not write decayed edges back — just compute telemetry. */\n  dryRun?: boolean;\n}\n\n/** Path of the latest-run status file. */\nexport function graphEdgeDecayStatusPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"graph-edge-decay-status.json\");\n}\n\n/** Write a JSONL file atomically using temp+rename (CLAUDE.md gotcha #54). */\nasync function writeJsonlAtomic(filePath: string, edges: GraphEdge[]): Promise<void> {\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const body = edges.length === 0 ? \"\" : edges.map((e) => JSON.stringify(e)).join(\"\\n\") + \"\\n\";\n  // Codex P2 / gotcha #54: write to temp then rename. Never rmSync(target)\n  // before the rename succeeds; rename is atomic on the same filesystem.\n  // Include pid + monotonic-ish suffix so concurrent runs cannot collide.\n  const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;\n  await writeFile(tempPath, body, \"utf-8\");\n  await rename(tempPath, filePath);\n}\n\n/**\n * Run a single decay pass over every edge type.\n *\n * Idempotency: PR 1/3's `decayEdgeConfidence` advances `lastReinforcedAt`\n * by exactly the windows it just charged for, so a second run with the\n * same `now` (or any `now` inside the new grace window) is a no-op.\n *\n * Returns the telemetry record. The record is also persisted to\n * {@link graphEdgeDecayStatusPath} so doctor / CLI can read the last run\n * without re-scanning the graphs.\n */\nexport async function runGraphEdgeDecayMaintenance(\n  memoryDir: string,\n  options: GraphEdgeDecayOptions = {},\n): Promise<GraphEdgeDecayTelemetry> {\n  const startedAt = Date.now();\n  const ranAt = options.now ?? new Date().toISOString();\n  const windowMs = options.windowMs ?? DEFAULT_DECAY_WINDOW_MS;\n  const perWindow = options.perWindow ?? DEFAULT_DECAY_PER_WINDOW;\n  const floor = options.floor ?? DEFAULT_DECAY_FLOOR;\n  const visibilityThreshold =\n    typeof options.visibilityThreshold === \"number\" && Number.isFinite(options.visibilityThreshold)\n      ? Math.max(0, Math.min(1, options.visibilityThreshold))\n      : DEFAULT_VISIBILITY_THRESHOLD;\n  const dryRun = options.dryRun === true;\n\n  await mkdir(graphsDir(memoryDir), { recursive: true });\n\n  const perType: GraphEdgeDecayPerTypeStats[] = [];\n  // Aggregate per-label decay drops across ALL graph types so the\n  // \"top decayed entities\" list reflects whichever label dominated\n  // each edge (entity name, threadId, or causal phrase). Sorting by\n  // total confidence drop highlights the edges decay actually moved\n  // most in this pass.\n  const dropByLabel = new Map<string, { totalDrop: number; edgeCount: number }>();\n\n  let edgesTotal = 0;\n  let edgesDecayed = 0;\n  let edgesBelowVisibilityThreshold = 0;\n\n  for (const type of GRAPH_TYPES) {\n    const filePath = graphFilePath(memoryDir, type);\n\n    // Hold the per-graph-file write lock across BOTH the read-snapshot\n    // and the atomic rewrite so concurrent `appendEdge()` calls cannot\n    // sneak in between (issue #729 / Codex P1, line 224). Without this\n    // lock the snapshot rewrite would silently drop any edge appended\n    // by extraction during the same window. Read failures other than\n    // ENOENT are surfaced via `readEdgesStrict` so I/O outages cannot\n    // be reported as \"no edges to decay\" (Codex P1, line 120).\n    const {\n      typeDecayed,\n      typeBelow,\n      typeTotal,\n    } = await withGraphWriteLock(filePath, async () => {\n      const edges = await readEdgesStrict(memoryDir, type);\n      const updated: GraphEdge[] = new Array(edges.length);\n\n      let localDecayed = 0;\n      let localBelow = 0;\n      let localChangedAny = false;\n\n      for (let i = 0; i < edges.length; i += 1) {\n        const edge = edges[i];\n        const before = readEdgeConfidence(edge);\n        const decayed = decayEdgeConfidence(edge, ranAt, { windowMs, perWindow, floor });\n        const after = readEdgeConfidence(decayed);\n\n        // Only count as \"decayed\" when the confidence actually dropped.\n        // `decayEdgeConfidence` may return an unchanged copy (still inside\n        // the grace window, or already at/below the floor) — those are\n        // visited but not decayed.\n        if (after < before) {\n          localDecayed += 1;\n          const drop = before - after;\n          const label = typeof edge.label === \"string\" ? edge.label : \"\";\n          // Skip empty labels in the top list — surfacing them produces\n          // a meaningless \"\" entry that crowds the report.\n          if (label.length > 0) {\n            const prev = dropByLabel.get(label);\n            if (prev) {\n              prev.totalDrop += drop;\n              prev.edgeCount += 1;\n            } else {\n              dropByLabel.set(label, { totalDrop: drop, edgeCount: 1 });\n            }\n          }\n        }\n        if (after < visibilityThreshold) {\n          localBelow += 1;\n        }\n        updated[i] = decayed;\n        // Detect any structural change (confidence OR lastReinforcedAt anchor advance)\n        // so we only rewrite the JSONL when there's something to persist.\n        if (\n          decayed.confidence !== edge.confidence ||\n          decayed.lastReinforcedAt !== edge.lastReinforcedAt\n        ) {\n          localChangedAny = true;\n        }\n      }\n\n      if (!dryRun && localChangedAny && edges.length > 0) {\n        await writeJsonlAtomic(filePath, updated);\n      }\n\n      return {\n        typeDecayed: localDecayed,\n        typeBelow: localBelow,\n        typeTotal: edges.length,\n      };\n    });\n\n    edgesDecayed += typeDecayed;\n    edgesBelowVisibilityThreshold += typeBelow;\n    edgesTotal += typeTotal;\n    perType.push({\n      type,\n      edgesTotal: typeTotal,\n      edgesDecayed: typeDecayed,\n      edgesBelowVisibilityThreshold: typeBelow,\n    });\n  }\n\n  // Stable secondary key on label keeps ordering deterministic when two\n  // labels happen to have exactly the same totalDrop (gotcha #19).\n  const topDecayedEntities: GraphEdgeDecayTopEntity[] = [...dropByLabel.entries()]\n    .map(([label, agg]) => ({ label, totalDrop: agg.totalDrop, edgeCount: agg.edgeCount }))\n    .sort((a, b) => {\n      if (b.totalDrop !== a.totalDrop) return b.totalDrop - a.totalDrop;\n      return a.label.localeCompare(b.label);\n    })\n    .slice(0, 5);\n\n  const telemetry: GraphEdgeDecayTelemetry = {\n    ranAt,\n    durationMs: Date.now() - startedAt,\n    edgesTotal,\n    edgesDecayed,\n    edgesBelowVisibilityThreshold,\n    topDecayedEntities,\n    perType,\n    windowMs,\n    perWindow,\n    floor,\n    visibilityThreshold,\n  };\n\n  if (!dryRun) {\n    await persistTelemetry(memoryDir, telemetry);\n  }\n\n  return telemetry;\n}\n\nasync function persistTelemetry(\n  memoryDir: string,\n  telemetry: GraphEdgeDecayTelemetry,\n): Promise<void> {\n  const statusPath = graphEdgeDecayStatusPath(memoryDir);\n  await mkdir(path.dirname(statusPath), { recursive: true });\n  const tempPath = `${statusPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;\n  // Wrap I/O in try/catch (gotcha #13) — failing to persist telemetry must\n  // not blow up the maintenance run; the in-memory record is still returned.\n  try {\n    await writeFile(tempPath, JSON.stringify(telemetry, null, 2) + \"\\n\", \"utf-8\");\n    await rename(tempPath, statusPath);\n  } catch {\n    // Best-effort: callers still receive the in-memory telemetry record.\n  }\n}\n\n/** Read the last persisted decay-run telemetry, if any. */\nexport async function readGraphEdgeDecayStatus(\n  memoryDir: string,\n): Promise<GraphEdgeDecayTelemetry | null> {\n  try {\n    const raw = await readFile(graphEdgeDecayStatusPath(memoryDir), \"utf-8\");\n    const parsed = JSON.parse(raw);\n    // Validate the parsed payload is a plain object (gotcha #18: JSON.parse('null') is valid).\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      return null;\n    }\n    return parsed as GraphEdgeDecayTelemetry;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Per-namespace telemetry record returned by\n * {@link runGraphEdgeDecayMaintenanceAcrossNamespaces}. Each entry\n * pairs the namespace name with its decay telemetry (or an error\n * string if that namespace's run failed). Allows operators to spot\n * I/O outages on a single namespace without masking the rest.\n */\nexport interface GraphEdgeDecayNamespaceResult {\n  namespace: string;\n  storageRoot: string;\n  telemetry?: GraphEdgeDecayTelemetry;\n  error?: string;\n}\n\n/**\n * Discover every namespace storage root that may contain graph files.\n *\n * Returns a list of `{ namespace, storageRoot }` entries:\n *   - The default namespace at `memoryDir` (always present).\n *   - Each subdirectory under `memoryDir/namespaces/` that passes\n *     `isSafeRouteNamespace`.\n *\n * Per gotcha #42: read paths must enumerate the same namespace layer\n * as write paths so non-default namespaces don't get skipped during\n * maintenance. Issue #729 / Codex P2.\n */\nexport async function discoverGraphNamespaceRoots(\n  memoryDir: string,\n  options: { namespacesEnabled: boolean; defaultNamespace: string },\n): Promise<{ namespace: string; storageRoot: string }[]> {\n  const seen = new Map<string, string>();\n  // Default namespace always lives at memoryDir (NamespaceStorageRouter\n  // falls back to memoryDir when memoryDir/namespaces/<default> does\n  // not exist).\n  seen.set(options.defaultNamespace, memoryDir);\n\n  if (!options.namespacesEnabled) {\n    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n  }\n\n  const namespacesDir = path.join(memoryDir, \"namespaces\");\n  let entries: import(\"node:fs\").Dirent[];\n  try {\n    entries = await readdir(namespacesDir, { withFileTypes: true });\n  } catch {\n    // No namespaces dir yet — only the default namespace exists.\n    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n  }\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    if (!isSafeRouteNamespace(entry.name)) continue;\n    const root = path.join(namespacesDir, entry.name);\n    seen.set(entry.name, root);\n  }\n\n  return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n}\n\n/**\n * Run the decay maintenance pass against every namespace storage root.\n *\n * In namespaces-enabled deployments, non-default namespaces store\n * their graph JSONLs under `memoryDir/namespaces/<ns>/state/graphs/`,\n * so a single-root run only updates the default namespace and silently\n * skips the rest (issue #729 / Codex P2).\n *\n * Failures in one namespace do not block other namespaces; per-root\n * errors are surfaced in the `error` field of each result.\n */\nexport async function runGraphEdgeDecayMaintenanceAcrossNamespaces(\n  memoryDir: string,\n  options: GraphEdgeDecayOptions & {\n    namespacesEnabled: boolean;\n    defaultNamespace: string;\n  },\n): Promise<GraphEdgeDecayNamespaceResult[]> {\n  const { namespacesEnabled, defaultNamespace, ...decayOptions } = options;\n  const roots = await discoverGraphNamespaceRoots(memoryDir, {\n    namespacesEnabled,\n    defaultNamespace,\n  });\n\n  const results: GraphEdgeDecayNamespaceResult[] = [];\n  for (const { namespace, storageRoot } of roots) {\n    try {\n      const telemetry = await runGraphEdgeDecayMaintenance(storageRoot, decayOptions);\n      results.push({ namespace, storageRoot, telemetry });\n    } catch (err) {\n      results.push({\n        namespace,\n        storageRoot,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAgBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,OAAO,UAAU;AAqBV,IAAM,+BAA+B;AAE5C,IAAM,cAAoC,CAAC,UAAU,QAAQ,QAAQ;AA8C9D,SAAS,yBAAyB,WAA2B;AAClE,SAAO,KAAK,KAAK,WAAW,SAAS,8BAA8B;AACrE;AAGA,eAAe,iBAAiB,UAAkB,OAAmC;AACnF,QAAM,MAAM,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACvD,QAAM,OAAO,MAAM,WAAW,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;AAIxF,QAAM,WAAW,GAAG,QAAQ,IAAI,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAChG,QAAM,UAAU,UAAU,MAAM,OAAO;AACvC,QAAM,OAAO,UAAU,QAAQ;AACjC;AAaA,eAAsB,6BACpB,WACA,UAAiC,CAAC,GACA;AAClC,QAAM,YAAY,KAAK,IAAI;AAC3B,QAAM,QAAQ,QAAQ,QAAO,oBAAI,KAAK,GAAE,YAAY;AACpD,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,sBACJ,OAAO,QAAQ,wBAAwB,YAAY,OAAO,SAAS,QAAQ,mBAAmB,IAC1F,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,QAAQ,mBAAmB,CAAC,IACpD;AACN,QAAM,SAAS,QAAQ,WAAW;AAElC,QAAM,MAAM,UAAU,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAErD,QAAM,UAAwC,CAAC;AAM/C,QAAM,cAAc,oBAAI,IAAsD;AAE9E,MAAI,aAAa;AACjB,MAAI,eAAe;AACnB,MAAI,gCAAgC;AAEpC,aAAW,QAAQ,aAAa;AAC9B,UAAM,WAAW,cAAc,WAAW,IAAI;AAS9C,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI,MAAM,mBAAmB,UAAU,YAAY;AACjD,YAAM,QAAQ,MAAM,gBAAgB,WAAW,IAAI;AACnD,YAAM,UAAuB,IAAI,MAAM,MAAM,MAAM;AAEnD,UAAI,eAAe;AACnB,UAAI,aAAa;AACjB,UAAI,kBAAkB;AAEtB,eAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;AACxC,cAAM,OAAO,MAAM,CAAC;AACpB,cAAM,SAAS,mBAAmB,IAAI;AACtC,cAAM,UAAU,oBAAoB,MAAM,OAAO,EAAE,UAAU,WAAW,MAAM,CAAC;AAC/E,cAAM,QAAQ,mBAAmB,OAAO;AAMxC,YAAI,QAAQ,QAAQ;AAClB,0BAAgB;AAChB,gBAAM,OAAO,SAAS;AACtB,gBAAM,QAAQ,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAG5D,cAAI,MAAM,SAAS,GAAG;AACpB,kBAAM,OAAO,YAAY,IAAI,KAAK;AAClC,gBAAI,MAAM;AACR,mBAAK,aAAa;AAClB,mBAAK,aAAa;AAAA,YACpB,OAAO;AACL,0BAAY,IAAI,OAAO,EAAE,WAAW,MAAM,WAAW,EAAE,CAAC;AAAA,YAC1D;AAAA,UACF;AAAA,QACF;AACA,YAAI,QAAQ,qBAAqB;AAC/B,wBAAc;AAAA,QAChB;AACA,gBAAQ,CAAC,IAAI;AAGb,YACE,QAAQ,eAAe,KAAK,cAC5B,QAAQ,qBAAqB,KAAK,kBAClC;AACA,4BAAkB;AAAA,QACpB;AAAA,MACF;AAEA,UAAI,CAAC,UAAU,mBAAmB,MAAM,SAAS,GAAG;AAClD,cAAM,iBAAiB,UAAU,OAAO;AAAA,MAC1C;AAEA,aAAO;AAAA,QACL,aAAa;AAAA,QACb,WAAW;AAAA,QACX,WAAW,MAAM;AAAA,MACnB;AAAA,IACF,CAAC;AAED,oBAAgB;AAChB,qCAAiC;AACjC,kBAAc;AACd,YAAQ,KAAK;AAAA,MACX;AAAA,MACA,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,+BAA+B;AAAA,IACjC,CAAC;AAAA,EACH;AAIA,QAAM,qBAAgD,CAAC,GAAG,YAAY,QAAQ,CAAC,EAC5E,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,WAAW,IAAI,WAAW,WAAW,IAAI,UAAU,EAAE,EACrF,KAAK,CAAC,GAAG,MAAM;AACd,QAAI,EAAE,cAAc,EAAE,UAAW,QAAO,EAAE,YAAY,EAAE;AACxD,WAAO,EAAE,MAAM,cAAc,EAAE,KAAK;AAAA,EACtC,CAAC,EACA,MAAM,GAAG,CAAC;AAEb,QAAM,YAAqC;AAAA,IACzC;AAAA,IACA,YAAY,KAAK,IAAI,IAAI;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ;AACX,UAAM,iBAAiB,WAAW,SAAS;AAAA,EAC7C;AAEA,SAAO;AACT;AAEA,eAAe,iBACb,WACA,WACe;AACf,QAAM,aAAa,yBAAyB,SAAS;AACrD,QAAM,MAAM,KAAK,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACzD,QAAM,WAAW,GAAG,UAAU,IAAI,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAGlG,MAAI;AACF,UAAM,UAAU,UAAU,KAAK,UAAU,WAAW,MAAM,CAAC,IAAI,MAAM,OAAO;AAC5E,UAAM,OAAO,UAAU,UAAU;AAAA,EACnC,QAAQ;AAAA,EAER;AACF;AAGA,eAAsB,yBACpB,WACyC;AACzC,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,yBAAyB,SAAS,GAAG,OAAO;AACvE,UAAM,SAAS,KAAK,MAAM,GAAG;AAE7B,QAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GAAG;AAC1E,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA4BA,eAAsB,4BACpB,WACA,SACuD;AACvD,QAAM,OAAO,oBAAI,IAAoB;AAIrC,OAAK,IAAI,QAAQ,kBAAkB,SAAS;AAE5C,MAAI,CAAC,QAAQ,mBAAmB;AAC9B,WAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,WAAW,WAAW,OAAO,EAAE,WAAW,YAAY,EAAE;AAAA,EAC3F;AAEA,QAAM,gBAAgB,KAAK,KAAK,WAAW,YAAY;AACvD,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,QAAQ,eAAe,EAAE,eAAe,KAAK,CAAC;AAAA,EAChE,QAAQ;AAEN,WAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,WAAW,WAAW,OAAO,EAAE,WAAW,YAAY,EAAE;AAAA,EAC3F;AACA,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAC,MAAM,YAAY,EAAG;AAC1B,QAAI,CAAC,qBAAqB,MAAM,IAAI,EAAG;AACvC,UAAM,OAAO,KAAK,KAAK,eAAe,MAAM,IAAI;AAChD,SAAK,IAAI,MAAM,MAAM,IAAI;AAAA,EAC3B;AAEA,SAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,WAAW,WAAW,OAAO,EAAE,WAAW,YAAY,EAAE;AAC3F;AAaA,eAAsB,6CACpB,WACA,SAI0C;AAC1C,QAAM,EAAE,mBAAmB,kBAAkB,GAAG,aAAa,IAAI;AACjE,QAAM,QAAQ,MAAM,4BAA4B,WAAW;AAAA,IACzD;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,UAA2C,CAAC;AAClD,aAAW,EAAE,WAAW,YAAY,KAAK,OAAO;AAC9C,QAAI;AACF,YAAM,YAAY,MAAM,6BAA6B,aAAa,YAAY;AAC9E,cAAQ,KAAK,EAAE,WAAW,aAAa,UAAU,CAAC;AAAA,IACpD,SAAS,KAAK;AACZ,cAAQ,KAAK;AAAA,QACX;AAAA,QACA;AAAA,QACA,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,MACxD,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/maintenance/graph-edge-decay.ts"],"sourcesContent":["/**\n * Graph-edge decay maintenance job (issue #681 PR 2/3).\n *\n * For each edge in the on-disk JSONL graph stores\n * (`<memoryDir>/state/graphs/{entity,time,causal}.jsonl`) call\n * {@link decayEdgeConfidence} from PR 1/3 and write the decayed edge\n * back to disk via the temp+rename atomic-replace pattern (CLAUDE.md\n * gotcha #54: never delete-before-write).\n *\n * Emits a structured telemetry record per run that the doctor surface\n * (`remnic doctor`) and a tail of the maintenance ledger can consume.\n *\n * Pure-helper-style API (the function takes a `memoryDir` + opts and\n * returns a record); callers wire the cron / MCP tool / CLI surfaces.\n */\n\nimport {\n  mkdir,\n  readdir,\n  readFile,\n  rename,\n  writeFile,\n} from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  decayEdgeConfidence,\n  DEFAULT_DECAY_FLOOR,\n  DEFAULT_DECAY_PER_WINDOW,\n  DEFAULT_DECAY_WINDOW_MS,\n  readEdgeConfidence,\n  type DecayOptions,\n} from \"../graph-edge-reinforcement.js\";\nimport {\n  graphFilePath,\n  graphsDir,\n  readEdgesStrict,\n  withGraphWriteLock,\n  type GraphEdge,\n  type GraphType,\n} from \"../graph.js\";\nimport { isSafeRouteNamespace } from \"../routing/engine.js\";\n\n/** Default visibility threshold for the \"below visibility\" telemetry counter. */\nexport const DEFAULT_VISIBILITY_THRESHOLD = 0.2;\n\nconst GRAPH_TYPES: readonly GraphType[] = [\"entity\", \"time\", \"causal\"] as const;\n\n/** Per-edge-type breakdown emitted by {@link runGraphEdgeDecayMaintenance}. */\nexport interface GraphEdgeDecayPerTypeStats {\n  type: GraphType;\n  edgesTotal: number;\n  edgesDecayed: number;\n  edgesBelowVisibilityThreshold: number;\n}\n\n/** Top-decayed-entity entry (label + total confidence drop summed across edges). */\nexport interface GraphEdgeDecayTopEntity {\n  label: string;\n  totalDrop: number;\n  edgeCount: number;\n}\n\n/**\n * Telemetry record emitted by every run of the decay job. Persisted to\n * `<memoryDir>/state/graph-edge-decay-status.json` for doctor consumption\n * and (optionally) appended to the maintenance ledger by callers.\n */\nexport interface GraphEdgeDecayTelemetry {\n  ranAt: string;\n  durationMs: number;\n  edgesTotal: number;\n  edgesDecayed: number;\n  edgesBelowVisibilityThreshold: number;\n  topDecayedEntities: GraphEdgeDecayTopEntity[];\n  perType: GraphEdgeDecayPerTypeStats[];\n  windowMs: number;\n  perWindow: number;\n  floor: number;\n  visibilityThreshold: number;\n}\n\nexport interface GraphEdgeDecayOptions extends DecayOptions {\n  /** Confidence threshold below which an edge counts as \"low visibility\". */\n  visibilityThreshold?: number;\n  /** Override \"now\" for deterministic testing. Defaults to `new Date().toISOString()`. */\n  now?: string;\n  /** When `true`, do not write decayed edges back — just compute telemetry. */\n  dryRun?: boolean;\n}\n\n/** Path of the latest-run status file. */\nexport function graphEdgeDecayStatusPath(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"graph-edge-decay-status.json\");\n}\n\n/** Write a JSONL file atomically using temp+rename (CLAUDE.md gotcha #54). */\nasync function writeJsonlAtomic(filePath: string, edges: GraphEdge[]): Promise<void> {\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const body = edges.length === 0 ? \"\" : edges.map((e) => JSON.stringify(e)).join(\"\\n\") + \"\\n\";\n  // Codex P2 / gotcha #54: write to temp then rename. Never rmSync(target)\n  // before the rename succeeds; rename is atomic on the same filesystem.\n  // Include pid + monotonic-ish suffix so concurrent runs cannot collide.\n  const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;\n  await writeFile(tempPath, body, \"utf-8\");\n  await rename(tempPath, filePath);\n}\n\n/**\n * Run a single decay pass over every edge type.\n *\n * Idempotency: PR 1/3's `decayEdgeConfidence` advances `lastReinforcedAt`\n * by exactly the windows it just charged for, so a second run with the\n * same `now` (or any `now` inside the new grace window) is a no-op.\n *\n * Returns the telemetry record. The record is also persisted to\n * {@link graphEdgeDecayStatusPath} so doctor / CLI can read the last run\n * without re-scanning the graphs.\n */\nexport async function runGraphEdgeDecayMaintenance(\n  memoryDir: string,\n  options: GraphEdgeDecayOptions = {},\n): Promise<GraphEdgeDecayTelemetry> {\n  const startedAt = Date.now();\n  const ranAt = options.now ?? new Date().toISOString();\n  const windowMs = options.windowMs ?? DEFAULT_DECAY_WINDOW_MS;\n  const perWindow = options.perWindow ?? DEFAULT_DECAY_PER_WINDOW;\n  const floor = options.floor ?? DEFAULT_DECAY_FLOOR;\n  const visibilityThreshold =\n    typeof options.visibilityThreshold === \"number\" && Number.isFinite(options.visibilityThreshold)\n      ? Math.max(0, Math.min(1, options.visibilityThreshold))\n      : DEFAULT_VISIBILITY_THRESHOLD;\n  const dryRun = options.dryRun === true;\n\n  await mkdir(graphsDir(memoryDir), { recursive: true });\n\n  const perType: GraphEdgeDecayPerTypeStats[] = [];\n  // Aggregate per-label decay drops across ALL graph types so the\n  // \"top decayed entities\" list reflects whichever label dominated\n  // each edge (entity name, threadId, or causal phrase). Sorting by\n  // total confidence drop highlights the edges decay actually moved\n  // most in this pass.\n  const dropByLabel = new Map<string, { totalDrop: number; edgeCount: number }>();\n\n  let edgesTotal = 0;\n  let edgesDecayed = 0;\n  let edgesBelowVisibilityThreshold = 0;\n\n  for (const type of GRAPH_TYPES) {\n    const filePath = graphFilePath(memoryDir, type);\n\n    // Hold the per-graph-file write lock across BOTH the read-snapshot\n    // and the atomic rewrite so concurrent `appendEdge()` calls cannot\n    // sneak in between (issue #729 / Codex P1, line 224). Without this\n    // lock the snapshot rewrite would silently drop any edge appended\n    // by extraction during the same window. Read failures other than\n    // ENOENT are surfaced via `readEdgesStrict` so I/O outages cannot\n    // be reported as \"no edges to decay\" (Codex P1, line 120).\n    const {\n      typeDecayed,\n      typeBelow,\n      typeTotal,\n    } = await withGraphWriteLock(filePath, async () => {\n      const edges = await readEdgesStrict(memoryDir, type);\n      const updated: GraphEdge[] = new Array(edges.length);\n\n      let localDecayed = 0;\n      let localBelow = 0;\n      let localChangedAny = false;\n\n      for (let i = 0; i < edges.length; i += 1) {\n        const edge = edges[i];\n        const before = readEdgeConfidence(edge);\n        const decayed = decayEdgeConfidence(edge, ranAt, { windowMs, perWindow, floor });\n        const after = readEdgeConfidence(decayed);\n\n        // Only count as \"decayed\" when the confidence actually dropped.\n        // `decayEdgeConfidence` may return an unchanged copy (still inside\n        // the grace window, or already at/below the floor) — those are\n        // visited but not decayed.\n        if (after < before) {\n          localDecayed += 1;\n          const drop = before - after;\n          const label = typeof edge.label === \"string\" ? edge.label : \"\";\n          // Skip empty labels in the top list — surfacing them produces\n          // a meaningless \"\" entry that crowds the report.\n          if (label.length > 0) {\n            const prev = dropByLabel.get(label);\n            if (prev) {\n              prev.totalDrop += drop;\n              prev.edgeCount += 1;\n            } else {\n              dropByLabel.set(label, { totalDrop: drop, edgeCount: 1 });\n            }\n          }\n        }\n        if (after < visibilityThreshold) {\n          localBelow += 1;\n        }\n        updated[i] = decayed;\n        // Detect any structural change (confidence OR lastReinforcedAt anchor advance)\n        // so we only rewrite the JSONL when there's something to persist.\n        if (\n          decayed.confidence !== edge.confidence ||\n          decayed.lastReinforcedAt !== edge.lastReinforcedAt\n        ) {\n          localChangedAny = true;\n        }\n      }\n\n      if (!dryRun && localChangedAny && edges.length > 0) {\n        await writeJsonlAtomic(filePath, updated);\n      }\n\n      return {\n        typeDecayed: localDecayed,\n        typeBelow: localBelow,\n        typeTotal: edges.length,\n      };\n    });\n\n    edgesDecayed += typeDecayed;\n    edgesBelowVisibilityThreshold += typeBelow;\n    edgesTotal += typeTotal;\n    perType.push({\n      type,\n      edgesTotal: typeTotal,\n      edgesDecayed: typeDecayed,\n      edgesBelowVisibilityThreshold: typeBelow,\n    });\n  }\n\n  // Stable secondary key on label keeps ordering deterministic when two\n  // labels happen to have exactly the same totalDrop (gotcha #19).\n  const topDecayedEntities: GraphEdgeDecayTopEntity[] = [...dropByLabel.entries()]\n    .map(([label, agg]) => ({ label, totalDrop: agg.totalDrop, edgeCount: agg.edgeCount }))\n    .sort((a, b) => {\n      if (b.totalDrop !== a.totalDrop) return b.totalDrop - a.totalDrop;\n      return a.label.localeCompare(b.label);\n    })\n    .slice(0, 5);\n\n  const telemetry: GraphEdgeDecayTelemetry = {\n    ranAt,\n    durationMs: Date.now() - startedAt,\n    edgesTotal,\n    edgesDecayed,\n    edgesBelowVisibilityThreshold,\n    topDecayedEntities,\n    perType,\n    windowMs,\n    perWindow,\n    floor,\n    visibilityThreshold,\n  };\n\n  if (!dryRun) {\n    await persistTelemetry(memoryDir, telemetry);\n  }\n\n  return telemetry;\n}\n\nasync function persistTelemetry(\n  memoryDir: string,\n  telemetry: GraphEdgeDecayTelemetry,\n): Promise<void> {\n  const statusPath = graphEdgeDecayStatusPath(memoryDir);\n  await mkdir(path.dirname(statusPath), { recursive: true });\n  const tempPath = `${statusPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;\n  // Wrap I/O in try/catch (gotcha #13) — failing to persist telemetry must\n  // not blow up the maintenance run; the in-memory record is still returned.\n  try {\n    await writeFile(tempPath, JSON.stringify(telemetry, null, 2) + \"\\n\", \"utf-8\");\n    await rename(tempPath, statusPath);\n  } catch {\n    // Best-effort: callers still receive the in-memory telemetry record.\n  }\n}\n\n/** Read the last persisted decay-run telemetry, if any. */\nexport async function readGraphEdgeDecayStatus(\n  memoryDir: string,\n): Promise<GraphEdgeDecayTelemetry | null> {\n  try {\n    const raw = await readFile(graphEdgeDecayStatusPath(memoryDir), \"utf-8\");\n    const parsed = JSON.parse(raw);\n    // Validate the parsed payload is a plain object (gotcha #18: JSON.parse('null') is valid).\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      return null;\n    }\n    return parsed as GraphEdgeDecayTelemetry;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Per-namespace telemetry record returned by\n * {@link runGraphEdgeDecayMaintenanceAcrossNamespaces}. Each entry\n * pairs the namespace name with its decay telemetry (or an error\n * string if that namespace's run failed). Allows operators to spot\n * I/O outages on a single namespace without masking the rest.\n */\nexport interface GraphEdgeDecayNamespaceResult {\n  namespace: string;\n  storageRoot: string;\n  telemetry?: GraphEdgeDecayTelemetry;\n  error?: string;\n}\n\n/**\n * Discover every namespace storage root that may contain graph files.\n *\n * Returns a list of `{ namespace, storageRoot }` entries:\n *   - The default namespace at `memoryDir` (always present).\n *   - Each subdirectory under `memoryDir/namespaces/` that passes\n *     `isSafeRouteNamespace`.\n *\n * Per gotcha #42: read paths must enumerate the same namespace layer\n * as write paths so non-default namespaces don't get skipped during\n * maintenance. Issue #729 / Codex P2.\n */\nexport async function discoverGraphNamespaceRoots(\n  memoryDir: string,\n  options: { namespacesEnabled: boolean; defaultNamespace: string },\n): Promise<{ namespace: string; storageRoot: string }[]> {\n  const seen = new Map<string, string>();\n  // Default namespace always lives at memoryDir (NamespaceStorageRouter\n  // falls back to memoryDir when memoryDir/namespaces/<default> does\n  // not exist).\n  seen.set(options.defaultNamespace, memoryDir);\n\n  if (!options.namespacesEnabled) {\n    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n  }\n\n  const namespacesDir = path.join(memoryDir, \"namespaces\");\n  let entries: import(\"node:fs\").Dirent[];\n  try {\n    entries = await readdir(namespacesDir, { withFileTypes: true });\n  } catch {\n    // No namespaces dir yet — only the default namespace exists.\n    return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n  }\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    if (!isSafeRouteNamespace(entry.name)) continue;\n    const root = path.join(namespacesDir, entry.name);\n    seen.set(entry.name, root);\n  }\n\n  return [...seen.entries()].map(([namespace, storageRoot]) => ({ namespace, storageRoot }));\n}\n\n/**\n * Run the decay maintenance pass against every namespace storage root.\n *\n * In namespaces-enabled deployments, non-default namespaces store\n * their graph JSONLs under `memoryDir/namespaces/<ns>/state/graphs/`,\n * so a single-root run only updates the default namespace and silently\n * skips the rest (issue #729 / Codex P2).\n *\n * Failures in one namespace do not block other namespaces; per-root\n * errors are surfaced in the `error` field of each result.\n */\nexport async function runGraphEdgeDecayMaintenanceAcrossNamespaces(\n  memoryDir: string,\n  options: GraphEdgeDecayOptions & {\n    namespacesEnabled: boolean;\n    defaultNamespace: string;\n  },\n): Promise<GraphEdgeDecayNamespaceResult[]> {\n  const { namespacesEnabled, defaultNamespace, ...decayOptions } = options;\n  const roots = await discoverGraphNamespaceRoots(memoryDir, {\n    namespacesEnabled,\n    defaultNamespace,\n  });\n\n  const results: GraphEdgeDecayNamespaceResult[] = [];\n  for (const { namespace, storageRoot } of roots) {\n    try {\n      const telemetry = await runGraphEdgeDecayMaintenance(storageRoot, decayOptions);\n      results.push({ namespace, storageRoot, telemetry });\n    } catch (err) {\n      results.push({\n        namespace,\n        storageRoot,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n  return results;\n}\n"],"mappings":"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","names":[]}

package/dist/{cli-P_GaYcCY.d.ts → cli-IOlDHSBT.d.ts}

@@ -1,13 +1,13 @@
 import { CompoundingPromotionReport } from './compounding/engine.js';
 import { MigrateObservationsResult } from './maintenance/migrate-observations.js';
 import { MemoryGovernanceRunResult, MemoryGovernanceSummary, MemoryGovernanceMetrics, MemoryGovernanceQualityScore, MemoryGovernanceReviewQueueEntry, MemoryGovernanceAppliedAction, MemoryGovernanceTransitionReport, MemoryGovernanceManifest, MemoryGovernanceRestoreManifest, RestoreMemoryGovernanceRunResult } from './maintenance/memory-governance.js';
-import { f as MemoryStatus, g as MemoryFile, B as BehaviorSignalEvent, Q as QmdSearchResult, W as MemoryActionEvent, m as MemoryLifecycleEvent } from './types-DwO1Ot4n.js';
+import { f as MemoryStatus, g as MemoryFile, B as BehaviorSignalEvent, Q as QmdSearchResult, W as MemoryActionEvent, m as MemoryLifecycleEvent } from './types-DmTaqob2.js';
 import { RebuildMemoryProjectionResult, RepairMemoryProjectionResult, VerifyMemoryProjectionResult } from './maintenance/rebuild-memory-projection.js';
 import { RebuildMemoryLifecycleLedgerResult } from './maintenance/rebuild-memory-lifecycle-ledger.js';
 import { RebuildObservationsResult } from './maintenance/rebuild-observations.js';
 import { ArchiveObservationsResult } from './maintenance/archive-observations.js';
 import { Writable, Readable } from 'node:stream';
-import { O as Orchestrator } from './orchestrator-f5xv19kp.js';
+import { O as Orchestrator } from './orchestrator-C_OMSIMZ.js';
 import { ReplayRunSummary } from './replay/runner.js';
 import { ReplaySource, ReplayTurn } from './replay/types.js';
 import { b as BulkImportResult } from './types-gb_SNtjR.js';
@@ -16,7 +16,7 @@ import { WorkProjectStatus, WorkTaskStatus, WorkTaskPriority } from './work/type
 import { RoutePatternType } from './routing/engine.js';
 import { TailscaleSyncOptions } from './network/tailscale.js';
 import { DashboardStatus } from './dashboard-runtime.js';
-import { g as EngramAccessService } from './access-service-Dj3I-VBS.js';
+import { g as EngramAccessService } from './access-service-B2PlPtxh.js';
 import { ResolveSecretRefFn } from './resolve-auth-token.js';
 import { CompatRunner, CompatReport } from './compat/types.js';
 import { EvalBaselineDeltaReport, EvalBaselineSnapshot, EvalCiGateReport, EvalBenchmarkPackSummary, EvalHarnessStatus, EvalStoredBaselineCiGateReport } from './evals.js';

package/dist/cli.d.ts

@@ -1,13 +1,13 @@
 import './compounding/engine.js';
 import './maintenance/migrate-observations.js';
 import './maintenance/memory-governance.js';
-import './types-DwO1Ot4n.js';
+import './types-DmTaqob2.js';
 import './maintenance/rebuild-memory-projection.js';
 import './maintenance/rebuild-memory-lifecycle-ledger.js';
 import './maintenance/rebuild-observations.js';
 import './maintenance/archive-observations.js';
 import 'node:stream';
-import './orchestrator-f5xv19kp.js';
+import './orchestrator-C_OMSIMZ.js';
 import './replay/runner.js';
 import './replay/types.js';
 import './types-gb_SNtjR.js';
@@ -16,7 +16,7 @@ import './work/types.js';
 import './routing/engine.js';
 import './network/tailscale.js';
 import './dashboard-runtime.js';
-import './access-service-Dj3I-VBS.js';
+import './access-service-B2PlPtxh.js';
 import './resolve-auth-token.js';
 import './compat/types.js';
 import './evals.js';
@@ -38,7 +38,7 @@ import './trust-zones.js';
 import './session-integrity.js';
 import './recall-state.js';
 import './policy-runtime.js';
-export { A as AccessHttpServeCliCommandOptions, a as ArchiveObservationsCliCommandOptions, B as BulkImportCliCommandOptions, C as CliApi, b as CliCommand, c as CliProgram, d as CompatCliCommandOptions, e as ConnectorsRunCliOutputOptions, f as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, g as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, h as MemoryActionAuditCliNamespaceSummary, i as MemoryActionAuditCliReport, j as MemoryGovernanceCliCommandOptions, k as MemoryGovernanceReportCliCommandOptions, l as MemoryGovernanceRestoreCliCommandOptions, m as MemoryReviewDispositionCliCommandOptions, n as MemoryTimelineCliCommandOptions, o as MigrateCliOrchestrator, q as MigrateCliReport, s as MigrateObservationsCliCommandOptions, P as PolicyDiffCliReport, t as PolicyDiffEntry, u as PolicyRollbackCliReport, v as PolicyStatusCliReport, w as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, x as RebuildMemoryProjectionCliCommandOptions, y as RebuildObservationsCliCommandOptions, z as RepairMemoryProjectionCliCommandOptions, F as ReplayCliCommandOptions, H as ReplayCliOrchestrator, I as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, J as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, K as TailscaleSyncCliCommandOptions, L as TierMigrationCliOrchestrator, N as TrainingExportCliCommandOptions, V as VerifyMemoryProjectionCliCommandOptions, W as WebDavServeCliCommandOptions, O as WorkProjectCliCommandOptions, Q as WorkTaskCliCommandOptions, U as emitConnectorsRunCliResult, X as filterNormalMemorySearchResults, Y as hasDestructivePurgeFailures, Z as isNormalRetrievalVisibleMemory, _ as listMemoryMarkdownFilePaths, $ as parseDurationToMs, a0 as parseStrictCliDate, a1 as planAggressiveDuplicateDeletions, a2 as planExactDuplicateDeletions, a3 as registerCli, a4 as resolveAccessPrincipalOverride, a5 as resolveMemoryDirForNamespace, a6 as runAbstractionNodeStatusCliCommand, a7 as runAccessHttpServeCliCommand, a8 as runAccessHttpStatusCliCommand, a9 as runAccessHttpStopCliCommand, aa as runAccessMcpServeCliCommand, ab as runArchiveObservationsCliCommand, ac as runBenchmarkBaselineReportCliCommand, ad as runBenchmarkBaselineSnapshotCliCommand, ae as runBenchmarkCiGateCliCommand, af as runBenchmarkImportCliCommand, ag as runBenchmarkStatusCliCommand, ah as runBenchmarkStoredBaselineCiGateCliCommand, ai as runBenchmarkValidateCliCommand, r as runBulkImportCliCommand, aj as runCausalTrajectoryStatusCliCommand, ak as runCommitmentLifecycleCliCommand, al as runCommitmentRecordCliCommand, am as runCommitmentSetStateCliCommand, an as runCommitmentStatusCliCommand, ao as runCompatCliCommand, ap as runCompoundingPromoteCliCommand, aq as runConversationIndexHealthCliCommand, ar as runConversationIndexInspectCliCommand, as as runConversationIndexRebuildCliCommand, at as runCueAnchorStatusCliCommand, au as runDashboardStartCliCommand, av as runDashboardStatusCliCommand, aw as runDashboardStopCliCommand, ax as runGraphHealthCliCommand, ay as runHarmonicSearchCliCommand, az as runMemoryActionAuditCliCommand, aA as runMemoryGovernanceCliCommand, aB as runMemoryGovernanceReportCliCommand, aC as runMemoryGovernanceRestoreCliCommand, aD as runMemoryReviewDispositionCliCommand, aE as runMemoryTimelineCliCommand, aF as runMigrateNormalizeFrontmatterCliCommand, aG as runMigrateObservationsCliCommand, aH as runMigrateRechunkCliCommand, aI as runMigrateReextractCliCommand, aJ as runMigrateRescoreImportanceCliCommand, aK as runObjectiveStateStatusCliCommand, aL as runPolicyDiffCliCommand, aM as runPolicyRollbackCliCommand, aN as runPolicyStatusCliCommand, aO as runRebuildMemoryLifecycleLedgerCliCommand, aP as runRebuildMemoryProjectionCliCommand, aQ as runRebuildObservationsCliCommand, aR as runRepairMemoryProjectionCliCommand, aS as runReplayCliCommand, aT as runResumeBundleBuildCliCommand, aU as runResumeBundleRecordCliCommand, aV as runResumeBundleStatusCliCommand, aW as runRouteCliCommand, aX as runSemanticRulePromoteCliCommand, aY as runSemanticRuleVerifyCliCommand, aZ as runSessionCheckCliCommand, a_ as runSessionRepairCliCommand, a$ as runTailscaleStatusCliCommand, b0 as runTailscaleSyncCliCommand, b1 as runTierMigrateCliCommand, b2 as runTierStatusCliCommand, b3 as runTrainingExportCliCommand, b4 as runTrustZoneDemoSeedCliCommand, b5 as runTrustZonePromoteCliCommand, b6 as runTrustZoneStatusCliCommand, b7 as runUtilityLearningCliCommand, b8 as runUtilityLearningStatusCliCommand, b9 as runUtilityTelemetryRecordCliCommand, ba as runUtilityTelemetryStatusCliCommand, bb as runVerifiedRecallSearchCliCommand, bc as runVerifyMemoryProjectionCliCommand, bd as runWebDavServeCliCommand, be as runWebDavStopCliCommand, bf as runWorkProductRecallSearchCliCommand, bg as runWorkProductRecordCliCommand, bh as runWorkProductStatusCliCommand, bi as runWorkProjectCliCommand, bj as runWorkTaskCliCommand } from './cli-P_GaYcCY.js';
+export { A as AccessHttpServeCliCommandOptions, a as ArchiveObservationsCliCommandOptions, B as BulkImportCliCommandOptions, C as CliApi, b as CliCommand, c as CliProgram, d as CompatCliCommandOptions, e as ConnectorsRunCliOutputOptions, f as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, g as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, h as MemoryActionAuditCliNamespaceSummary, i as MemoryActionAuditCliReport, j as MemoryGovernanceCliCommandOptions, k as MemoryGovernanceReportCliCommandOptions, l as MemoryGovernanceRestoreCliCommandOptions, m as MemoryReviewDispositionCliCommandOptions, n as MemoryTimelineCliCommandOptions, o as MigrateCliOrchestrator, q as MigrateCliReport, s as MigrateObservationsCliCommandOptions, P as PolicyDiffCliReport, t as PolicyDiffEntry, u as PolicyRollbackCliReport, v as PolicyStatusCliReport, w as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, x as RebuildMemoryProjectionCliCommandOptions, y as RebuildObservationsCliCommandOptions, z as RepairMemoryProjectionCliCommandOptions, F as ReplayCliCommandOptions, H as ReplayCliOrchestrator, I as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, J as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, K as TailscaleSyncCliCommandOptions, L as TierMigrationCliOrchestrator, N as TrainingExportCliCommandOptions, V as VerifyMemoryProjectionCliCommandOptions, W as WebDavServeCliCommandOptions, O as WorkProjectCliCommandOptions, Q as WorkTaskCliCommandOptions, U as emitConnectorsRunCliResult, X as filterNormalMemorySearchResults, Y as hasDestructivePurgeFailures, Z as isNormalRetrievalVisibleMemory, _ as listMemoryMarkdownFilePaths, $ as parseDurationToMs, a0 as parseStrictCliDate, a1 as planAggressiveDuplicateDeletions, a2 as planExactDuplicateDeletions, a3 as registerCli, a4 as resolveAccessPrincipalOverride, a5 as resolveMemoryDirForNamespace, a6 as runAbstractionNodeStatusCliCommand, a7 as runAccessHttpServeCliCommand, a8 as runAccessHttpStatusCliCommand, a9 as runAccessHttpStopCliCommand, aa as runAccessMcpServeCliCommand, ab as runArchiveObservationsCliCommand, ac as runBenchmarkBaselineReportCliCommand, ad as runBenchmarkBaselineSnapshotCliCommand, ae as runBenchmarkCiGateCliCommand, af as runBenchmarkImportCliCommand, ag as runBenchmarkStatusCliCommand, ah as runBenchmarkStoredBaselineCiGateCliCommand, ai as runBenchmarkValidateCliCommand, r as runBulkImportCliCommand, aj as runCausalTrajectoryStatusCliCommand, ak as runCommitmentLifecycleCliCommand, al as runCommitmentRecordCliCommand, am as runCommitmentSetStateCliCommand, an as runCommitmentStatusCliCommand, ao as runCompatCliCommand, ap as runCompoundingPromoteCliCommand, aq as runConversationIndexHealthCliCommand, ar as runConversationIndexInspectCliCommand, as as runConversationIndexRebuildCliCommand, at as runCueAnchorStatusCliCommand, au as runDashboardStartCliCommand, av as runDashboardStatusCliCommand, aw as runDashboardStopCliCommand, ax as runGraphHealthCliCommand, ay as runHarmonicSearchCliCommand, az as runMemoryActionAuditCliCommand, aA as runMemoryGovernanceCliCommand, aB as runMemoryGovernanceReportCliCommand, aC as runMemoryGovernanceRestoreCliCommand, aD as runMemoryReviewDispositionCliCommand, aE as runMemoryTimelineCliCommand, aF as runMigrateNormalizeFrontmatterCliCommand, aG as runMigrateObservationsCliCommand, aH as runMigrateRechunkCliCommand, aI as runMigrateReextractCliCommand, aJ as runMigrateRescoreImportanceCliCommand, aK as runObjectiveStateStatusCliCommand, aL as runPolicyDiffCliCommand, aM as runPolicyRollbackCliCommand, aN as runPolicyStatusCliCommand, aO as runRebuildMemoryLifecycleLedgerCliCommand, aP as runRebuildMemoryProjectionCliCommand, aQ as runRebuildObservationsCliCommand, aR as runRepairMemoryProjectionCliCommand, aS as runReplayCliCommand, aT as runResumeBundleBuildCliCommand, aU as runResumeBundleRecordCliCommand, aV as runResumeBundleStatusCliCommand, aW as runRouteCliCommand, aX as runSemanticRulePromoteCliCommand, aY as runSemanticRuleVerifyCliCommand, aZ as runSessionCheckCliCommand, a_ as runSessionRepairCliCommand, a$ as runTailscaleStatusCliCommand, b0 as runTailscaleSyncCliCommand, b1 as runTierMigrateCliCommand, b2 as runTierStatusCliCommand, b3 as runTrainingExportCliCommand, b4 as runTrustZoneDemoSeedCliCommand, b5 as runTrustZonePromoteCliCommand, b6 as runTrustZoneStatusCliCommand, b7 as runUtilityLearningCliCommand, b8 as runUtilityLearningStatusCliCommand, b9 as runUtilityTelemetryRecordCliCommand, ba as runUtilityTelemetryStatusCliCommand, bb as runVerifiedRecallSearchCliCommand, bc as runVerifyMemoryProjectionCliCommand, bd as runWebDavServeCliCommand, be as runWebDavStopCliCommand, bf as runWorkProductRecallSearchCliCommand, bg as runWorkProductRecordCliCommand, bh as runWorkProductStatusCliCommand, bi as runWorkProjectCliCommand, bj as runWorkTaskCliCommand } from './cli-IOlDHSBT.js';
 import './connectors-cli-2iaQ5tX2.js';
 import './storage.js';
 import './page-versioning.js';
@@ -62,7 +62,7 @@ import './transcript.js';
 import './summarizer.js';
 import './orchestration/maintenance.js';
 import './namespaces/search.js';
-import './catalog-F-OEVbRQ.js';
+import './catalog-CzUb-GyD.js';
 import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
@@ -83,7 +83,7 @@ import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
 import './lcm/queue.js';
-import './semantic-consolidation-BQm1e1Pn.js';
+import './semantic-consolidation-B8LiYtvx.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './conversation-index/backend.js';

package/dist/cli.js

@@ -90,7 +90,7 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-QD6QP5P6.js";
+} from "./chunk-I2HL5M6T.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -109,8 +109,8 @@ import "./chunk-HOJZMQ4J.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-D6RIFG4O.js";
-import "./chunk-6FAMMBQ3.js";
-import "./chunk-TXQCG6SE.js";
+import "./chunk-UBHVAGO7.js";
+import "./chunk-H7HUQIY7.js";
 import "./chunk-LZZNTPLR.js";
 import "./chunk-JCK7V6SN.js";
 import "./chunk-WMWVO45V.js";
@@ -118,12 +118,12 @@ import "./chunk-KJTKLXTH.js";
 import "./chunk-CKITWVWJ.js";
 import "./chunk-OUELRE5E.js";
 import "./chunk-GQL52GQ5.js";
-import "./chunk-J3JPB7ZI.js";
+import "./chunk-FACTVMXQ.js";
 import "./chunk-TGQ2NTWH.js";
 import "./chunk-D7EBTQ24.js";
-import "./chunk-BXEOHV7K.js";
-import "./chunk-A5XNBK2D.js";
-import "./chunk-EEJMD2L2.js";
+import "./chunk-ZOHMPFOB.js";
+import "./chunk-DF3I6JGP.js";
+import "./chunk-6CWGS2LY.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-7XH7VJN4.js";
@@ -136,16 +136,16 @@ import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
-import "./chunk-EBDA5TYA.js";
+import "./chunk-FXCIOLRB.js";
 import "./chunk-QRDOSYOR.js";
-import "./chunk-YEE5KJQQ.js";
+import "./chunk-T55EGZSJ.js";
 import "./chunk-ZRWB5D4H.js";
 import "./chunk-GY3SKOS4.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-33JBK2XP.js";
-import "./chunk-PD42EYQN.js";
-import "./chunk-EXUCUPV2.js";
-import "./chunk-OHTOPFRF.js";
+import "./chunk-5OPYYPJN.js";
+import "./chunk-WM7DNKBD.js";
+import "./chunk-SC2YAWRF.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-CMTINOFS.js";
 import "./chunk-TQNRI55H.js";
@@ -169,7 +169,7 @@ import "./chunk-C4X4QGIO.js";
 import "./chunk-OO42R444.js";
 import "./chunk-K6MV3TRQ.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-UIXXE6NI.js";
+import "./chunk-C6BWLYW5.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-RKNJBZ55.js";
 import "./chunk-J64TK33U.js";
@@ -178,14 +178,19 @@ import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
 import "./chunk-7RXCMVFQ.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-B7WISIAJ.js";
-import "./chunk-T4WDJPEZ.js";
+import "./chunk-FN6QP7JQ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-N77ELJ2D.js";
-import "./chunk-EM2LDXJ2.js";
+import "./chunk-TT5U3UDO.js";
+import "./chunk-VI5SGGXB.js";
+import "./chunk-ZQNCHPTZ.js";
+import "./chunk-YF6FMLBT.js";
+import "./chunk-R6OVFAX6.js";
+import "./chunk-PLBIPT6I.js";
+import "./chunk-35NN3ZFA.js";
+import "./chunk-T4WDJPEZ.js";
 import "./chunk-FVZ2ISIX.js";
-import "./chunk-LLUGAZ3B.js";
-import "./chunk-GDUOCHCD.js";
+import "./chunk-NT36GU6X.js";
+import "./chunk-KGZF2VO3.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ARV3AUOM.js";
@@ -194,15 +199,15 @@ import "./chunk-ERA5RSMZ.js";
 import "./chunk-IQ7WCZRW.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-7CTNUVHZ.js";
+import "./chunk-6SQQOJ4U.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-EDOQM4E4.js";
-import "./chunk-VCLGUIFM.js";
+import "./chunk-WAFDHKES.js";
+import "./chunk-Z3FGC3QE.js";
 import "./chunk-RS25QOKZ.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-GJSL4WG2.js";
+import "./chunk-F3XZN24Z.js";
 import "./chunk-QR67FU5G.js";
 import "./chunk-HCVWF657.js";
 import "./chunk-SANZHXY2.js";
@@ -241,8 +246,8 @@ import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZBJMUXZH.js";
-import "./chunk-UO5ZHIIH.js";
-import "./chunk-EVPNWN7Z.js";
+import "./chunk-4WZ3J7M6.js";
+import "./chunk-4R3CGCI5.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
@@ -252,7 +257,7 @@ import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-ILFSEIRT.js";
+import "./chunk-7AG54AF3.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";

package/dist/compounding/engine.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from '../storage.js';
-import { P as PluginConfig } from '../types-DwO1Ot4n.js';
+import { P as PluginConfig } from '../types-DmTaqob2.js';
 import { SharedFeedbackEntry } from '../shared-context/manager.js';
 import '../page-versioning.js';
 import '../consolidation-operator.js';

package/dist/compounding/engine.js

@@ -1,9 +1,9 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "../chunk-WQYSDPMA.js";
+} from "../chunk-YQMPUYHE.js";
 import "../chunk-UFS7OXGL.js";
-import "../chunk-EVPNWN7Z.js";
+import "../chunk-4R3CGCI5.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
@@ -13,7 +13,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-SVOZFLIQ.js";
 import "../chunk-LTJAMRGI.js";
-import "../chunk-ILFSEIRT.js";
+import "../chunk-7AG54AF3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/compounding/preference-consolidator.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, g as MemoryFile } from '../types-DwO1Ot4n.js';
+import { M as MemoryCategory, g as MemoryFile } from '../types-DmTaqob2.js';
 import { LcmEngine } from '../lcm/engine.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';

package/dist/compression-optimizer.d.ts

@@ -1,4 +1,4 @@
-import { K as CompressionGuidelineOptimizerEventCounts, N as CompressionGuidelineOptimizerActionSummary, O as CompressionGuidelineOptimizerRuleUpdate, U as MemoryActionType, W as MemoryActionEvent, X as CompressionGuidelineOptimizerState } from './types-DwO1Ot4n.js';
+import { K as CompressionGuidelineOptimizerEventCounts, N as CompressionGuidelineOptimizerActionSummary, O as CompressionGuidelineOptimizerRuleUpdate, U as MemoryActionType, W as MemoryActionEvent, X as CompressionGuidelineOptimizerState } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-DwO1Ot4n.js';
+import { P as PluginConfig } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/connectors/codex-materialize-runner.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as MemoryFile } from '../types-DwO1Ot4n.js';
+import { P as PluginConfig, g as MemoryFile } from '../types-DmTaqob2.js';
 import { RolloutSummaryInput, MaterializeResult } from './codex-materialize.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';

package/dist/connectors/codex-materialize-runner.js

@@ -1,10 +1,10 @@
 import {
   runCodexMaterialize,
   runPostConsolidationMaterialize
-} from "../chunk-A7TJZLPK.js";
+} from "../chunk-ZK2L72VN.js";
 import "../chunk-UUH4YQOF.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-EVPNWN7Z.js";
+import "../chunk-4R3CGCI5.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
@@ -14,7 +14,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-SVOZFLIQ.js";
 import "../chunk-LTJAMRGI.js";
-import "../chunk-ILFSEIRT.js";
+import "../chunk-7AG54AF3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/connectors/codex-materialize.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from '../types-DwO1Ot4n.js';
+import { g as MemoryFile } from '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/connectors/index.d.ts

@@ -1,6 +1,6 @@
 export { MATERIALIZE_VERSION, MaterializeOptions, MaterializeResult, MemoryMdValidation, RolloutSummaryInput, SENTINEL_FILE, TMP_DIR, approximateTokenCount, describeMemoriesDir, ensureSentinel, materializeForNamespace, renderMemoryMd, renderMemorySummary, renderRawMemories, renderRolloutSummary, truncateToTokenBudget, validateMemoryMd } from './codex-materialize.js';
 export { RunMaterializeOptions, runCodexMaterialize } from './codex-materialize-runner.js';
-import { P as PluginConfig } from '../types-DwO1Ot4n.js';
+import { P as PluginConfig } from '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/connectors/index.js

@@ -26,7 +26,7 @@ import {
 import "../chunk-UG274TNV.js";
 import {
   runCodexMaterialize
-} from "../chunk-A7TJZLPK.js";
+} from "../chunk-ZK2L72VN.js";
 import {
   MATERIALIZE_VERSION,
   SENTINEL_FILE,
@@ -48,7 +48,7 @@ import {
   getRegistryPath
 } from "../chunk-K6MV3TRQ.js";
 import "../chunk-O75CRYGF.js";
-import "../chunk-EVPNWN7Z.js";
+import "../chunk-4R3CGCI5.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
@@ -58,7 +58,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-SVOZFLIQ.js";
 import "../chunk-LTJAMRGI.js";
-import "../chunk-ILFSEIRT.js";
+import "../chunk-7AG54AF3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/consolidation-provenance-check.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from './storage.js';
-import './types-DwO1Ot4n.js';
+import './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 import './page-versioning.js';

package/dist/consolidation-undo.d.ts

@@ -1,6 +1,6 @@
 import { StorageManager } from './storage.js';
 import { VersioningConfig } from './page-versioning.js';
-import './types-DwO1Ot4n.js';
+import './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 import './consolidation-operator.js';

package/dist/contradiction/index.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from '../storage.js';
-import { f as MemoryStatus, P as PluginConfig, M as MemoryCategory } from '../types-DwO1Ot4n.js';
+import { f as MemoryStatus, P as PluginConfig, M as MemoryCategory } from '../types-DmTaqob2.js';
 import { a as SemanticDedupLookup } from '../semantic-SLAa_prH.js';
 import { LocalLlmClient } from '../local-llm.js';
 import { FallbackLlmClient } from '../fallback-llm.js';

package/dist/conversation-index/backend.d.ts

@@ -1,7 +1,7 @@
 import { SearchBackend, SearchExecutionOptions } from '../search/port.js';
 import { ConversationChunk } from './chunker.js';
 import { C as ConversationSearchResult, F as FaissConversationIndexAdapter } from '../faiss-adapter-BHecI1fF.js';
-import '../types-DwO1Ot4n.js';
+import '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../runtime/child-process.js';

package/dist/conversation-index/chunker.d.ts

@@ -1,4 +1,4 @@
-import { T as TranscriptEntry } from '../types-DwO1Ot4n.js';
+import { T as TranscriptEntry } from '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/conversation-index/faiss-adapter.d.ts

@@ -1,7 +1,7 @@
 import './chunker.js';
 export { b as FaissAdapterConfig, c as FaissAdapterError, F as FaissConversationIndexAdapter, d as FaissHealthResult, e as FaissInspectResult, f as failOpenFaissHealth, r as resolveDefaultFaissScriptPath } from '../faiss-adapter-BHecI1fF.js';
 import '../runtime/child-process.js';
-import '../types-DwO1Ot4n.js';
+import '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../search/port.js';

package/dist/conversation-index/indexer.d.ts

@@ -1,7 +1,7 @@
 import { F as FaissConversationIndexAdapter } from '../faiss-adapter-BHecI1fF.js';
 import { ConversationChunk } from './chunker.js';
 import '../search/port.js';
-import '../types-DwO1Ot4n.js';
+import '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../runtime/child-process.js';

package/dist/conversation-index/search.d.ts

@@ -1,6 +1,6 @@
 import '../search/port.js';
 export { C as ConversationSearchResult, s as searchConversationIndex, a as searchConversationIndexFaissFailOpen } from '../faiss-adapter-BHecI1fF.js';
-import '../types-DwO1Ot4n.js';
+import '../types-DmTaqob2.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import './chunker.js';

package/dist/day-summary.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as MemoryFile } from './types-DwO1Ot4n.js';
+import { P as PluginConfig, g as MemoryFile } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/delinearize.d.ts

@@ -1,4 +1,4 @@
-import { Y as EntityMention } from './types-DwO1Ot4n.js';
+import { Y as EntityMention } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/direct-answer-wiring.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile, P as PluginConfig } from './types-DwO1Ot4n.js';
+import { g as MemoryFile, P as PluginConfig } from './types-DmTaqob2.js';
 import { TrustZoneName } from './trust-zones.js';
 import { T as Taxonomy } from './types-DJhqDJUV.js';
 import { DirectAnswerResult } from './direct-answer.js';

package/dist/direct-answer.d.ts

@@ -1,5 +1,5 @@
 import { TrustZoneName } from './trust-zones.js';
-import { g as MemoryFile } from './types-DwO1Ot4n.js';
+import { g as MemoryFile } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/dreams-ledger-6UODQOX6.js

@@ -0,0 +1,22 @@
+import {
+  appendDreamsLedgerEntry,
+  dreamsLedgerPath,
+  getDreamsStatus,
+  normalizeDreamsStatusWindowHours,
+  readDreamsLedgerEntries,
+  recordDreamsPhaseRun,
+  runDreamsPhase,
+  summarizeGovernanceResultForDreams
+} from "./chunk-YF6FMLBT.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  appendDreamsLedgerEntry,
+  dreamsLedgerPath,
+  getDreamsStatus,
+  normalizeDreamsStatusWindowHours,
+  readDreamsLedgerEntries,
+  recordDreamsPhaseRun,
+  runDreamsPhase,
+  summarizeGovernanceResultForDreams
+};
+//# sourceMappingURL=dreams-ledger-6UODQOX6.js.map

package/dist/dreams-ledger-6UODQOX6.js.map

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

package/dist/embedding-fallback.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-DwO1Ot4n.js';
+import { P as PluginConfig } from './types-DmTaqob2.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/enrichment/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, y as ImportanceLevel } from '../types-DwO1Ot4n.js';
+import { M as MemoryCategory, y as ImportanceLevel } from '../types-DmTaqob2.js';
 import { LoggerBackend } from '../logger.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';

package/dist/entity-retrieval.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from './storage.js';
-import { P as PluginConfig, T as TranscriptEntry } from './types-DwO1Ot4n.js';
+import { P as PluginConfig, T as TranscriptEntry } from './types-DmTaqob2.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';