@remnic/core 9.39.0 → 9.41.0

package/dist/chunk-CPD6C6K6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/operator-doctor-corpus.ts"],"sourcesContent":["/**\n * Corpus-watermark doctor check (issue #2149).\n *\n * Lives beside operator-toolkit.ts (which is at its structural-ratchet ceiling)\n * so the god file only gains the wiring. Reports each namespace's memory-file\n * count, newest write, and a short census-digest prefix, and WARNS when a\n * namespace could not be scanned (unreadable/churning) or enumeration failed —\n * a scan failure omits a namespace, so an unconditional \"ok\" would certify a\n * partial fleet or conflate an unreadable corpus with an empty deployment\n * (issue #2156 round-7). Peer comparison (count/age divergence thresholds) is a\n * follow-up.\n *\n * Namespaces are resolved through the shared resolveCorpusNamespaceRoots helper\n * (issue #2156 finding C) so the doctor and the /health surface enumerate the\n * SAME tenant set and cannot drift. The caller supplies `storageFactory` (a\n * `dir -> CorpusStorage`) so this module never imports the storage god-module\n * directly (issue #1533 ratchet).\n */\n\nimport {\n  type CorpusStorage,\n  type CorpusWatermark,\n  computeCorpusWatermarks,\n  resolveCorpusNamespaceRoots,\n} from \"./corpus-watermark.js\";\nimport { summarizeReplicaDivergence } from \"./operator-doctor-replica.js\";\nimport type { OperatorDoctorCheck } from \"./operator-toolkit.js\";\nimport type { ResolveSecretRefFn } from \"./resolve-auth-token.js\";\nimport type { PluginConfig } from \"./types.js\";\n\nconst DIGEST_PREFIX_LENGTH = 12;\n\nexport async function summarizeCorpusWatermark(\n  config: PluginConfig,\n  storageFactory: (dir: string) => CorpusStorage,\n  now?: Date\n): Promise<OperatorDoctorCheck> {\n  let resolved: string[] = [];\n  let watermarks: CorpusWatermark[] = [];\n  let enumerationFailed = false;\n  try {\n    // The doctor orchestrator has no live namespace catalog, so config-driven\n    // enumeration (deduped by root inside the shared helper) is the whole set.\n    const rootByNamespace = new Map<string, string>();\n    for (const root of await resolveCorpusNamespaceRoots({ config })) {\n      rootByNamespace.set(root.namespace, root.rootDir);\n    }\n    resolved = [...rootByNamespace.keys()];\n    watermarks = await computeCorpusWatermarks(\n      resolved,\n      (namespace) => storageFactory(rootByNamespace.get(namespace) ?? config.memoryDir),\n      now\n    );\n  } catch {\n    // Namespace ENUMERATION itself failed (distinct from a per-namespace scan).\n    enumerationFailed = true;\n  }\n\n  const computed = new Set(watermarks.map((w) => w.namespace));\n  const failed = resolved.filter((namespace) => !computed.has(namespace));\n  const lines = watermarks.map(\n    (w) =>\n      `${w.namespace}: ${w.memoryFileCount} files, newest=${w.newestWriteAt ?? \"never\"}, ` +\n      `digest=${w.digest.slice(0, DIGEST_PREFIX_LENGTH)}`\n  );\n\n  if (enumerationFailed) {\n    return {\n      key: \"corpus_watermark\",\n      status: \"warn\",\n      summary: \"Could not resolve corpus namespaces (enumeration failed).\",\n      remediation: \"Ensure the memory directory and namespace catalog are readable, then rerun `remnic doctor`.\",\n      details: { corpus: watermarks, resolved: resolved.length, failed: failed.length },\n    };\n  }\n  if (failed.length > 0) {\n    return {\n      key: \"corpus_watermark\",\n      status: \"warn\",\n      summary:\n        `Corpus watermark unavailable for ${failed.length} of ${resolved.length} namespace(s) ` +\n        `(unreadable or churning): ${failed.join(\", \")}.` +\n        (lines.length > 0 ? ` Reporting ${lines.length}: ${lines.join(\"; \")}` : \"\"),\n      remediation: \"Inspect the omitted namespace roots for permission/backend errors, then rerun `remnic doctor`.\",\n      details: { corpus: watermarks, resolved: resolved.length, failed },\n    };\n  }\n  return {\n    key: \"corpus_watermark\",\n    status: \"ok\",\n    summary:\n      resolved.length === 0\n        ? \"No corpus namespaces resolved yet.\"\n        : `Corpus watermark across ${watermarks.length} namespace(s): ${lines.join(\"; \")}`,\n    details: { corpus: watermarks },\n  };\n}\n\n/**\n * Extract the watermark array this check stores under `details.corpus` (issue\n * #2149). The replica-divergence doctor check reuses the local watermark set\n * computed here rather than rescanning the corpus, and consumes it through this\n * helper so the `details.corpus` shape stays owned by the module that produces it.\n */\nexport function corpusWatermarksFromCheck(check: OperatorDoctorCheck): CorpusWatermark[] {\n  const details = check.details;\n  if (!details || typeof details !== \"object\" || !(\"corpus\" in details) || !Array.isArray(details.corpus)) {\n    return [];\n  }\n  // This check always stores a CorpusWatermark[] under `corpus` (guarded above).\n  return details.corpus as CorpusWatermark[];\n}\n\n/**\n * Build the corpus-watermark and replica-divergence doctor checks together.\n *\n * They are paired deliberately: the replica comparison consumes the corpus\n * check's watermarks (one scan, not two) AND its completeness — an incomplete\n * local census must not let the replica check certify convergence. The pairing\n * lives HERE, next to the corpus check + `corpusWatermarksFromCheck` it consumes\n * and the `PluginConfig` it needs, so the sibling replica module stays a light\n * tsup DTS entry free of the heavy `PluginConfig` type graph (round 6, coderabbit).\n */\nexport async function summarizeCorpusAndReplica(\n  config: PluginConfig,\n  storageFactory: (dir: string) => CorpusStorage,\n  resolveSecretRef?: ResolveSecretRefFn | null,\n): Promise<OperatorDoctorCheck[]> {\n  const watermarkCheck = await summarizeCorpusWatermark(config, storageFactory);\n  const replicaCheck = await summarizeReplicaDivergence(\n    config.replicaPeers,\n    corpusWatermarksFromCheck(watermarkCheck),\n    { resolveSecretRef, localCensusComplete: watermarkCheck.status === \"ok\" },\n  );\n  return [watermarkCheck, replicaCheck];\n}\n"],"mappings":";;;;;;;;;AA8BA,IAAM,uBAAuB;AAE7B,eAAsB,yBACpB,QACA,gBACA,KAC8B;AAC9B,MAAI,WAAqB,CAAC;AAC1B,MAAI,aAAgC,CAAC;AACrC,MAAI,oBAAoB;AACxB,MAAI;AAGF,UAAM,kBAAkB,oBAAI,IAAoB;AAChD,eAAW,QAAQ,MAAM,4BAA4B,EAAE,OAAO,CAAC,GAAG;AAChE,sBAAgB,IAAI,KAAK,WAAW,KAAK,OAAO;AAAA,IAClD;AACA,eAAW,CAAC,GAAG,gBAAgB,KAAK,CAAC;AACrC,iBAAa,MAAM;AAAA,MACjB;AAAA,MACA,CAAC,cAAc,eAAe,gBAAgB,IAAI,SAAS,KAAK,OAAO,SAAS;AAAA,MAChF;AAAA,IACF;AAAA,EACF,QAAQ;AAEN,wBAAoB;AAAA,EACtB;AAEA,QAAM,WAAW,IAAI,IAAI,WAAW,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;AAC3D,QAAM,SAAS,SAAS,OAAO,CAAC,cAAc,CAAC,SAAS,IAAI,SAAS,CAAC;AACtE,QAAM,QAAQ,WAAW;AAAA,IACvB,CAAC,MACC,GAAG,EAAE,SAAS,KAAK,EAAE,eAAe,kBAAkB,EAAE,iBAAiB,OAAO,YACtE,EAAE,OAAO,MAAM,GAAG,oBAAoB,CAAC;AAAA,EACrD;AAEA,MAAI,mBAAmB;AACrB,WAAO;AAAA,MACL,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,aAAa;AAAA,MACb,SAAS,EAAE,QAAQ,YAAY,UAAU,SAAS,QAAQ,QAAQ,OAAO,OAAO;AAAA,IAClF;AAAA,EACF;AACA,MAAI,OAAO,SAAS,GAAG;AACrB,WAAO;AAAA,MACL,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,SACE,oCAAoC,OAAO,MAAM,OAAO,SAAS,MAAM,2CAC1C,OAAO,KAAK,IAAI,CAAC,OAC7C,MAAM,SAAS,IAAI,cAAc,MAAM,MAAM,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK;AAAA,MAC1E,aAAa;AAAA,MACb,SAAS,EAAE,QAAQ,YAAY,UAAU,SAAS,QAAQ,OAAO;AAAA,IACnE;AAAA,EACF;AACA,SAAO;AAAA,IACL,KAAK;AAAA,IACL,QAAQ;AAAA,IACR,SACE,SAAS,WAAW,IAChB,uCACA,2BAA2B,WAAW,MAAM,kBAAkB,MAAM,KAAK,IAAI,CAAC;AAAA,IACpF,SAAS,EAAE,QAAQ,WAAW;AAAA,EAChC;AACF;AAQO,SAAS,0BAA0B,OAA+C;AACvF,QAAM,UAAU,MAAM;AACtB,MAAI,CAAC,WAAW,OAAO,YAAY,YAAY,EAAE,YAAY,YAAY,CAAC,MAAM,QAAQ,QAAQ,MAAM,GAAG;AACvG,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,QAAQ;AACjB;AAYA,eAAsB,0BACpB,QACA,gBACA,kBACgC;AAChC,QAAM,iBAAiB,MAAM,yBAAyB,QAAQ,cAAc;AAC5E,QAAM,eAAe,MAAM;AAAA,IACzB,OAAO;AAAA,IACP,0BAA0B,cAAc;AAAA,IACxC,EAAE,kBAAkB,qBAAqB,eAAe,WAAW,KAAK;AAAA,EAC1E;AACA,SAAO,CAAC,gBAAgB,YAAY;AACtC;","names":[]}