@remnic/core 1.1.0 → 1.1.2

package/dist/{chunk-3QHL5ABG.js → chunk-6YJHX2DL.js}

@@ -1,7 +1,13 @@
+import {
+  runConsolidationProvenanceCheck
+} from "./chunk-ULYOGL6R.js";
+import {
+  reportBufferSurpriseDistribution
+} from "./chunk-ASAITVLA.js";
 import {
   NamespaceStorageRouter,
   namespaceCollectionName
-} from "./chunk-ZVBB3T7V.js";
+} from "./chunk-NBVAS5MT.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -24,27 +30,27 @@ import {
 } from "./chunk-K6WK37A6.js";
 import {
   parseConfig
-} from "./chunk-MBJHSA7F.js";
+} from "./chunk-BECYBZLX.js";
 import {
   analyzeGraphHealth
 } from "./chunk-C2EFFULQ.js";
-import {
-  readEnvVar,
-  resolveHomeDir
-} from "./chunk-MARWOCVP.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-ITRLGI2T.js";
+} from "./chunk-3OGMS3PE.js";
 import {
   isSafeRouteNamespace
-} from "./chunk-QNJMBKFK.js";
+} from "./chunk-2LGMW3DJ.js";
 import {
   StorageManager
-} from "./chunk-GV6NLQ4X.js";
+} from "./chunk-F5VP6YCB.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
+import {
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-MARWOCVP.js";
 
 // src/operator-toolkit.ts
 import path2 from "path";
@@ -64,6 +70,11 @@ var LEGACY_NAMESPACE_CHILDREN = [
   "state",
   "config",
   "summaries",
+  "procedures",
+  // Issue #564 PR 3: reasoning_trace memories live in their own subtree.
+  // Must be included here so namespace migration moves existing traces
+  // into the target namespace root alongside other memory data.
+  "reasoning-traces",
   "profile.md"
 ];
 async function exists(p) {
@@ -754,6 +765,12 @@ async function runOperatorDoctor(options) {
     warnRatio: config.fileHygiene.lintWarnRatio
   }) : [];
   checks.push(summarizeHygieneWarnings(warnings, config.fileHygiene));
+  checks.push(await summarizeMemoryWorthLegacyCounters(new StorageManager(config.memoryDir)));
+  checks.push(
+    await summarizeBufferSurpriseDistribution(new StorageManager(config.memoryDir), config)
+  );
+  checks.push(await summarizeConsolidationProvenance(new StorageManager(config.memoryDir), config));
+  checks.push(summarizeSecurityMitigations(config));
   const summary = checks.reduce(
     (acc, check) => {
       acc[check.status] += 1;
@@ -770,6 +787,167 @@ async function runOperatorDoctor(options) {
     checks
   };
 }
+var MEMORY_WORTH_ELIGIBLE_CATEGORIES = /* @__PURE__ */ new Set(["fact"]);
+async function summarizeMemoryWorthLegacyCounters(storage) {
+  let legacy = 0;
+  let instrumented = 0;
+  let ineligible = 0;
+  try {
+    const memories = await storage.readAllMemories();
+    for (const memory of memories) {
+      if (!MEMORY_WORTH_ELIGIBLE_CATEGORIES.has(memory.frontmatter.category)) {
+        ineligible += 1;
+        continue;
+      }
+      const { mw_success, mw_fail } = memory.frontmatter;
+      if (mw_success === void 0 && mw_fail === void 0) {
+        legacy += 1;
+      } else {
+        instrumented += 1;
+      }
+    }
+  } catch (err) {
+    return {
+      key: "memory_worth_legacy",
+      status: "warn",
+      summary: "Could not enumerate memories to count Memory Worth instrumentation.",
+      remediation: "Retry `remnic doctor` after ensuring the memory directory is readable.",
+      details: { error: String(err) }
+    };
+  }
+  const total = legacy + instrumented;
+  return {
+    key: "memory_worth_legacy",
+    status: "ok",
+    summary: total === 0 ? "No Memory Worth\u2013eligible memories on disk yet \u2014 counters will populate as facts are extracted." : `${legacy} of ${total} eligible memories have no Memory Worth counters yet (${instrumented} instrumented).`,
+    details: { legacy, instrumented, total, ineligible }
+  };
+}
+async function summarizeBufferSurpriseDistribution(storage, config) {
+  const storageWithLedger = storage;
+  if (typeof storageWithLedger.readBufferSurpriseEvents !== "function") {
+    return {
+      key: "buffer_surprise_distribution",
+      status: "ok",
+      summary: "Buffer-surprise telemetry reader unavailable in this build.",
+      details: { available: false }
+    };
+  }
+  try {
+    const dist = await reportBufferSurpriseDistribution(
+      async (opts) => storageWithLedger.readBufferSurpriseEvents({ limit: opts.limit }),
+      { limit: 200 }
+    );
+    if (dist.count === 0) {
+      return {
+        key: "buffer_surprise_distribution",
+        status: "ok",
+        summary: config.bufferSurpriseTriggerEnabled ? "Surprise trigger is enabled but no telemetry has been recorded yet." : "Surprise trigger is disabled; no telemetry expected.",
+        details: {
+          enabled: config.bufferSurpriseTriggerEnabled,
+          distribution: dist
+        }
+      };
+    }
+    const pct = (value) => (value * 100).toFixed(1);
+    return {
+      key: "buffer_surprise_distribution",
+      status: "ok",
+      summary: `Recent surprise: mean=${dist.mean.toFixed(3)}, median=${dist.median.toFixed(3)}, p90=${dist.p90.toFixed(3)}, triggered=${pct(dist.triggeredRate)}% over ${dist.count} turns (threshold=${dist.currentThreshold ?? config.bufferSurpriseThreshold}).`,
+      details: {
+        enabled: config.bufferSurpriseTriggerEnabled,
+        distribution: dist
+      }
+    };
+  } catch (err) {
+    return {
+      key: "buffer_surprise_distribution",
+      status: "warn",
+      summary: "Could not read buffer-surprise telemetry ledger.",
+      remediation: "Retry `remnic doctor` after ensuring the memory state directory is readable.",
+      details: { error: String(err) }
+    };
+  }
+}
+function summarizeSecurityMitigations(config) {
+  const budgetEnabled = config.recallCrossNamespaceBudgetEnabled === true;
+  const anomalyEnabled = config.recallAuditAnomalyDetectionEnabled === true;
+  if (!budgetEnabled && !anomalyEnabled) {
+    return {
+      key: "security_mitigations",
+      status: "warn",
+      summary: "Memory-extraction mitigations are disabled (cross-namespace budget and anomaly detection off).",
+      remediation: "Enable recallCrossNamespaceBudgetEnabled and/or recallAuditAnomalyDetectionEnabled for production deployments. See docs/security/memory-extraction-threat-model.md.",
+      details: {
+        budgetEnabled: false,
+        anomalyDetectionEnabled: false
+      }
+    };
+  }
+  const details = {
+    budgetEnabled,
+    anomalyDetectionEnabled: anomalyEnabled
+  };
+  if (budgetEnabled) {
+    details.budgetConfig = {
+      windowMs: config.recallCrossNamespaceBudgetWindowMs,
+      softLimit: config.recallCrossNamespaceBudgetSoftLimit,
+      hardLimit: config.recallCrossNamespaceBudgetHardLimit
+    };
+  }
+  if (anomalyEnabled) {
+    details.anomalyConfig = {
+      windowMs: config.recallAuditAnomalyWindowMs,
+      repeatQueryLimit: config.recallAuditAnomalyRepeatQueryLimit,
+      namespaceWalkLimit: config.recallAuditAnomalyNamespaceWalkLimit,
+      highCardinalityLimit: config.recallAuditAnomalyHighCardinalityLimit,
+      rapidFireLimit: config.recallAuditAnomalyRapidFireLimit
+    };
+  }
+  return {
+    key: "security_mitigations",
+    status: "ok",
+    summary: `Memory-extraction mitigation config enabled: ${budgetEnabled ? "budget" : ""}${budgetEnabled && anomalyEnabled ? ", " : ""}${anomalyEnabled ? "anomaly detection" : ""}.`,
+    details: { ...details, configOnly: true }
+  };
+}
+async function summarizeConsolidationProvenance(storage, config) {
+  let report;
+  try {
+    report = await runConsolidationProvenanceCheck({
+      storage,
+      memoryDir: config.memoryDir,
+      // Honor the configured sidecar directory (PR #634 review): when an
+      // operator overrides `versioningSidecarDir`, the default `.versions`
+      // would point at the wrong location and every entry would report as
+      // missing.  Undefined falls back to the helper's default.
+      sidecarDir: config.versioningSidecarDir
+    });
+  } catch (err) {
+    return {
+      key: "consolidation_provenance",
+      status: "warn",
+      summary: "Could not run consolidation-provenance integrity check.",
+      remediation: "Ensure the memory directory is readable and rerun `remnic doctor`.",
+      details: { error: String(err) }
+    };
+  }
+  if (report.issues.length === 0) {
+    return {
+      key: "consolidation_provenance",
+      status: "ok",
+      summary: report.withProvenance === 0 ? "No consolidation-provenance memories on disk yet." : `${report.withProvenance} consolidation-provenance memories verified (no broken references).`,
+      details: report
+    };
+  }
+  return {
+    key: "consolidation_provenance",
+    status: "warn",
+    summary: `${report.issues.length} consolidation-provenance integrity issue(s) detected across ${report.withProvenance} memories with provenance frontmatter.`,
+    remediation: "Broken pointers are informational. Inspect flagged memories, and if they should resolve, re-snapshot via a consolidation pass or accept pruning.",
+    details: report
+  };
+}
 function getMemoryAgeBand(memory, now) {
   const created = Date.parse(memory.frontmatter.created ?? "");
   if (!Number.isFinite(created)) return "unknown";
@@ -1043,8 +1221,11 @@ export {
   runOperatorSetup,
   runOperatorConfigReview,
   runOperatorDoctor,
+  summarizeMemoryWorthLegacyCounters,
+  summarizeBufferSurpriseDistribution,
+  summarizeConsolidationProvenance,
   runOperatorInventory,
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-3QHL5ABG.js.map
+//# sourceMappingURL=chunk-6YJHX2DL.js.map

package/dist/chunk-6YJHX2DL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/operator-toolkit.ts","../src/namespaces/migrate.ts"],"sourcesContent":["import path from \"node:path\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access, mkdir, readFile, readdir, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { lintWorkspaceFiles } from \"./hygiene.js\";\nimport { parseConfig } from \"./config.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\nimport { resolveRemnicPluginEntry } from \"./plugin-id.js\";\nimport {\n  resolveCuratedIncludeFilesStatePath,\n  resolveNativeKnowledgeStatePath,\n  resolveOpenClawWorkspaceStatePath,\n} from \"./native-knowledge.js\";\nimport { StorageManager } from \"./storage.js\";\nimport { listNamespaces } from \"./namespaces/migrate.js\";\nimport {\n  createEvalBaselineSnapshot,\n  getEvalHarnessStatus,\n  runEvalBaselineDeltaReport,\n  runEvalBenchmarkCiGate,\n  validateEvalBenchmarkPack,\n  type EvalBaselineDeltaReport,\n  type EvalCiGateReport,\n  type EvalHarnessStatus,\n} from \"./evals.js\";\nimport { analyzeGraphHealth, type GraphHealthReport } from \"./graph.js\";\nimport {\n  analyzeSessionIntegrity,\n  applySessionRepair,\n  planSessionRepair,\n  type SessionIntegrityReport,\n  type SessionRepairApplyResult,\n  type SessionRepairPlan,\n} from \"./session-integrity.js\";\nimport {\n  listMemoryGovernanceRuns,\n  readMemoryGovernanceRunArtifact,\n} from \"./maintenance/memory-governance.js\";\nimport {\n  runConsolidationProvenanceCheck,\n  type ConsolidationProvenanceReport,\n} from \"./consolidation-provenance-check.js\";\nimport type {\n  BufferSurpriseEvent,\n  FileHygieneConfig,\n  MemoryFile,\n  PluginConfig,\n} from \"./types.js\";\nimport { reportBufferSurpriseDistribution } from \"./buffer-surprise-report.js\";\n\ninterface QmdRuntimeLike {\n  probe(): Promise<boolean>;\n  isAvailable(): boolean;\n  ensureCollection(memoryDir: string): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  debugStatus(): string;\n}\n\ninterface ConversationIndexLike {\n  getConversationIndexHealth(): Promise<{\n    enabled: boolean;\n    backend: \"qmd\" | \"faiss\";\n    status: \"ok\" | \"degraded\" | \"disabled\";\n    chunkDocCount: number;\n    lastUpdateAt: string | null;\n    qmdAvailable?: boolean;\n    faiss?: {\n      ok: boolean;\n      status: \"ok\" | \"degraded\" | \"error\";\n      indexPath: string;\n      message?: string;\n      manifest?: {\n        version: number;\n        modelId: string;\n        normalizedModelId: string;\n        dimension: number;\n        chunkCount: number;\n        updatedAt: string;\n        lastSuccessfulRebuildAt: string;\n      };\n    };\n  }>;\n  rebuildConversationIndex(\n    sessionKey?: string,\n    hours?: number,\n    opts?: { embed?: boolean },\n  ): Promise<{\n    chunks: number;\n    skipped: boolean;\n    reason?: string;\n    embedded?: boolean;\n    rebuilt?: boolean;\n  }>;\n}\n\nexport interface OperatorToolkitOrchestrator extends ConversationIndexLike {\n  config: PluginConfig;\n  qmd: QmdRuntimeLike;\n}\n\nexport interface OperatorConfigLoadResult {\n  found: boolean;\n  path: string;\n  parsed: boolean;\n  memoryDir?: string;\n  workspaceDir?: string;\n  error?: string;\n}\n\nexport interface OperatorSetupReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  config: OperatorConfigLoadResult;\n  memoryDir: string;\n  workspaceDir: string;\n  directories: Array<{ path: string; exists: boolean; writable: boolean }>;\n  qmd: {\n    enabled: boolean;\n    available: boolean;\n    collectionState: \"present\" | \"missing\" | \"unknown\" | \"skipped\";\n    debugStatus: string;\n  };\n  nativeKnowledge: {\n    enabled: boolean;\n    includeFiles: string[];\n    curatedIncludeSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n    openclawWorkspaceAdapterEnabled: boolean;\n    obsidianVaultAdapterEnabled: boolean;\n    obsidianSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      vaultCount: number;\n      activeChunkCount: number;\n      deletedNoteCount: number;\n    };\n    openclawWorkspaceSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n  };\n  explicitCapture: {\n    captureMode: string;\n    enabled: boolean;\n    memoryDocPath: string;\n    memoryDocExists: boolean;\n    memoryDocInstalled: boolean;\n    memoryDocUpdated: boolean;\n    memoryDocRemoved: boolean;\n    preview: string | null;\n  };\n  nextSteps: string[];\n  verificationCommands: string[];\n}\n\nexport interface OperatorDoctorCheck {\n  key: string;\n  status: \"ok\" | \"warn\" | \"error\";\n  summary: string;\n  remediation?: string;\n  details?: unknown;\n}\n\nexport interface OperatorConfigReviewFinding {\n  key: string;\n  status: \"recommend\" | \"problem\";\n  setting: string;\n  currentValue: string;\n  defaultValue: string;\n  recommendedValue: string;\n  summary: string;\n  rationale: string;\n}\n\nexport interface OperatorConfigReviewReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  ok: boolean;\n  config: OperatorConfigLoadResult;\n  profile: {\n    memoryOsPreset?: string;\n    searchBackend: string;\n    qmdEnabled: boolean;\n    qmdDaemonEnabled: boolean;\n    nativeKnowledgeEnabled: boolean;\n    fileHygieneEnabled: boolean;\n    conversationIndexEnabled: boolean;\n  };\n  summary: {\n    recommend: number;\n    problem: number;\n  };\n  findings: OperatorConfigReviewFinding[];\n}\n\nexport interface OperatorDoctorReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  ok: boolean;\n  summary: {\n    ok: number;\n    warn: number;\n    error: number;\n  };\n  config: OperatorConfigLoadResult;\n  checks: OperatorDoctorCheck[];\n}\n\nexport interface OperatorInventoryNamespaceSummary {\n  namespace: string;\n  memoryCount: number;\n  entityCount: number;\n}\n\nexport interface OperatorInventoryReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  memoryDir: string;\n  totals: {\n    memories: number;\n    entities: number;\n    namespaces: number;\n    reviewQueue: number;\n    storageBytes: number;\n  };\n  categories: Record<string, number>;\n  statuses: Record<string, number>;\n  namespaces: OperatorInventoryNamespaceSummary[];\n  ageBands: Record<string, number>;\n  profile: {\n    exists: boolean;\n    chars: number;\n    lines: number;\n  };\n  storageFootprint: {\n    bytes: number;\n    byTopLevel: Record<string, number>;\n  };\n  archivePressure: {\n    archived: number;\n    pendingReview: number;\n    quarantined: number;\n    rejected: number;\n  };\n  conversationIndex: {\n    enabled: boolean;\n    backend: \"qmd\" | \"faiss\";\n    status: \"ok\" | \"degraded\" | \"disabled\";\n    chunkDocCount: number;\n    lastUpdateAt: string | null;\n  };\n  nativeKnowledge: {\n    enabled: boolean;\n    curatedIncludeSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n    obsidianSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      vaultCount: number;\n      activeChunkCount: number;\n      deletedNoteCount: number;\n    };\n    openclawWorkspaceSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n  };\n}\n\nexport interface BenchmarkRecallReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  mode: \"status\" | \"validate\" | \"baseline-report\" | \"ci-gate\" | \"snapshot\";\n  status: EvalHarnessStatus;\n  validate?: Awaited<ReturnType<typeof validateEvalBenchmarkPack>>;\n  baselineReport?: EvalBaselineDeltaReport;\n  ciGate?: EvalCiGateReport;\n  snapshot?: {\n    targetPath: string;\n    snapshotId: string;\n  };\n}\n\nexport interface OperatorRepairReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  dryRun: boolean;\n  sessionCheck: SessionIntegrityReport;\n  sessionRepairPlan: SessionRepairPlan;\n  sessionRepairApply: SessionRepairApplyResult;\n  graphHealth: GraphHealthReport;\n}\n\nexport interface OperatorSetupOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  installCaptureInstructions?: boolean;\n  captureInstructionsMode?: \"preview\" | \"install\" | \"remove\";\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorDoctorOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorConfigReviewOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorInventoryOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  now?: Date;\n}\n\nexport interface BenchmarkRecallOptions {\n  config: Pick<\n    PluginConfig,\n    | \"memoryDir\"\n    | \"evalStoreDir\"\n    | \"evalHarnessEnabled\"\n    | \"evalShadowModeEnabled\"\n    | \"benchmarkBaselineSnapshotsEnabled\"\n    | \"benchmarkDeltaReporterEnabled\"\n    | \"memoryRedTeamBenchEnabled\"\n  >;\n  validatePath?: string;\n  baseEvalStoreDir?: string;\n  candidateEvalStoreDir?: string;\n  snapshotId?: string;\n  createSnapshot?: boolean;\n  snapshotNotes?: string;\n  gitRef?: string;\n  createdAt?: string;\n  now?: Date;\n}\n\nexport interface OperatorRepairOptions {\n  config: Pick<\n    PluginConfig,\n    \"memoryDir\" | \"entityGraphEnabled\" | \"timeGraphEnabled\" | \"causalGraphEnabled\"\n  >;\n  apply?: boolean;\n  dryRun?: boolean;\n  allowSessionFileRepair?: boolean;\n  sessionFilesDir?: string;\n  now?: Date;\n}\n\nfunction resolveConfigPath(explicitPath?: string): string {\n  if (explicitPath && explicitPath.trim().length > 0) return explicitPath.trim();\n  const configured =\n    readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n    readEnvVar(\"OPENCLAW_CONFIG_PATH\");\n  if (configured && configured.trim().length > 0) return configured.trim();\n  return path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n}\n\nasync function loadCliPluginConfig(configPath?: string): Promise<OperatorConfigLoadResult> {\n  const resolvedPath = resolveConfigPath(configPath);\n  try {\n    const raw = JSON.parse(await readFile(resolvedPath, \"utf-8\")) as Record<string, unknown>;\n    // Delegate slot → PLUGIN_ID → LEGACY_PLUGIN_ID resolution to the shared\n    // helper so all config loaders stay in sync (#403).\n    const entry = resolveRemnicPluginEntry(raw);\n    const parsedConfig = parseConfig(\n      entry && typeof entry === \"object\"\n        ? ((entry[\"config\"] as Record<string, unknown> | undefined) ?? {})\n        : {},\n    );\n    return {\n      found: true,\n      path: resolvedPath,\n      parsed: true,\n      memoryDir: parsedConfig.memoryDir,\n      workspaceDir: parsedConfig.workspaceDir,\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      found: !/ENOENT/i.test(message),\n      path: resolvedPath,\n      parsed: false,\n      error: message,\n    };\n  }\n}\n\nasync function isWritable(targetPath: string): Promise<boolean> {\n  try {\n    await access(targetPath, fsConstants.W_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await access(targetPath, fsConstants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction formatConfigValue(value: unknown): string {\n  if (value === undefined || value === null) return \"(unset)\";\n  if (typeof value === \"string\") return value.length > 0 ? value : \"(unset)\";\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  return JSON.stringify(value);\n}\n\nasync function gatherDirectoryStatus(\n  paths: string[],\n): Promise<Array<{ path: string; exists: boolean; writable: boolean }>> {\n  return Promise.all(paths.map(async (targetPath) => {\n    try {\n      await access(targetPath, fsConstants.F_OK);\n      return {\n        path: targetPath,\n        exists: true,\n        writable: await isWritable(targetPath),\n      };\n    } catch {\n      return {\n        path: targetPath,\n        exists: false,\n        writable: false,\n      };\n    }\n  }));\n}\n\nfunction getSetupPaths(config: PluginConfig): string[] {\n  return [\n    config.memoryDir,\n    config.workspaceDir,\n    path.join(config.memoryDir, \"facts\"),\n    path.join(config.memoryDir, \"entities\"),\n    path.join(config.memoryDir, \"state\"),\n    path.join(config.memoryDir, \"questions\"),\n    path.join(config.memoryDir, \"artifacts\"),\n    path.join(config.memoryDir, \"config\"),\n  ];\n}\n\nasync function readJsonIfExists(filePath: string): Promise<unknown | null> {\n  try {\n    return JSON.parse(await readFile(filePath, \"utf-8\")) as unknown;\n  } catch {\n    return null;\n  }\n}\n\nasync function summarizeNativeKnowledgeStatus(config: PluginConfig): Promise<{\n  enabled: boolean;\n  includeFiles: string[];\n  curatedIncludeSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    fileCount: number;\n    activeChunkCount: number;\n    deletedFileCount: number;\n  };\n  openclawWorkspaceAdapterEnabled: boolean;\n  obsidianVaultAdapterEnabled: boolean;\n  obsidianSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    vaultCount: number;\n    activeChunkCount: number;\n    deletedNoteCount: number;\n  };\n  openclawWorkspaceSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    fileCount: number;\n    activeChunkCount: number;\n    deletedFileCount: number;\n  };\n}> {\n  const nativeKnowledge = config.nativeKnowledge;\n  const nativeKnowledgeStateDir = nativeKnowledge?.stateDir ?? \"state/native-knowledge\";\n  const curatedStatePath = nativeKnowledge\n    ? resolveCuratedIncludeFilesStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"curated-include-sync.json\");\n  const obsidianStatePath = nativeKnowledge\n    ? resolveNativeKnowledgeStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"obsidian-sync.json\");\n  const openclawStatePath = nativeKnowledge\n    ? resolveOpenClawWorkspaceStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"openclaw-workspace-sync.json\");\n  const [curatedRaw, obsidianRaw, openclawRaw] = await Promise.all([\n    readJsonIfExists(curatedStatePath),\n    readJsonIfExists(obsidianStatePath),\n    readJsonIfExists(openclawStatePath),\n  ]);\n\n  const curatedFiles = curatedRaw && typeof curatedRaw === \"object\" && curatedRaw !== null\n    && \"files\" in curatedRaw && typeof (curatedRaw as { files?: unknown }).files === \"object\"\n    && (curatedRaw as { files?: unknown }).files !== null\n      ? (curatedRaw as {\n          updatedAt?: unknown;\n          files: Record<string, { deleted?: boolean; chunks?: unknown[] }>;\n        })\n      : null;\n\n  let curatedActiveChunkCount = 0;\n  let curatedDeletedFileCount = 0;\n  for (const file of Object.values(curatedFiles?.files ?? {})) {\n    if (file.deleted) {\n      curatedDeletedFileCount += 1;\n      continue;\n    }\n    curatedActiveChunkCount += Array.isArray(file.chunks) ? file.chunks.length : 0;\n  }\n\n  const obsidianVaults = obsidianRaw && typeof obsidianRaw === \"object\" && obsidianRaw !== null\n    && \"vaults\" in obsidianRaw && typeof (obsidianRaw as { vaults?: unknown }).vaults === \"object\"\n    && (obsidianRaw as { vaults?: unknown }).vaults !== null\n      ? (obsidianRaw as {\n          updatedAt?: unknown;\n          vaults: Record<string, { notes?: Record<string, { deleted?: boolean; chunks?: unknown[] }> }>;\n        })\n      : null;\n\n  let obsidianActiveChunkCount = 0;\n  let obsidianDeletedNoteCount = 0;\n  for (const vault of Object.values(obsidianVaults?.vaults ?? {})) {\n    for (const note of Object.values(vault.notes ?? {})) {\n      if (note.deleted) {\n        obsidianDeletedNoteCount += 1;\n        continue;\n      }\n      obsidianActiveChunkCount += Array.isArray(note.chunks) ? note.chunks.length : 0;\n    }\n  }\n\n  const openclawFiles = openclawRaw && typeof openclawRaw === \"object\" && openclawRaw !== null\n    && \"files\" in openclawRaw && typeof (openclawRaw as { files?: unknown }).files === \"object\"\n    && (openclawRaw as { files?: unknown }).files !== null\n      ? (openclawRaw as {\n          updatedAt?: unknown;\n          files: Record<string, { deleted?: boolean; chunks?: unknown[] }>;\n        })\n      : null;\n\n  let openclawActiveChunkCount = 0;\n  let openclawDeletedFileCount = 0;\n  for (const file of Object.values(openclawFiles?.files ?? {})) {\n    if (file.deleted) {\n      openclawDeletedFileCount += 1;\n      continue;\n    }\n    openclawActiveChunkCount += Array.isArray(file.chunks) ? file.chunks.length : 0;\n  }\n\n  return {\n    enabled: nativeKnowledge?.enabled === true,\n    includeFiles: nativeKnowledge?.includeFiles ?? [],\n    curatedIncludeSync: {\n      statePath: curatedStatePath,\n      exists: curatedFiles !== null,\n      updatedAt: typeof curatedFiles?.updatedAt === \"string\" ? curatedFiles.updatedAt : null,\n      fileCount: Object.keys(curatedFiles?.files ?? {}).length,\n      activeChunkCount: curatedActiveChunkCount,\n      deletedFileCount: curatedDeletedFileCount,\n    },\n    openclawWorkspaceAdapterEnabled: nativeKnowledge?.openclawWorkspace?.enabled === true,\n    obsidianVaultAdapterEnabled: (nativeKnowledge?.obsidianVaults?.length ?? 0) > 0,\n    obsidianSync: {\n      statePath: obsidianStatePath,\n      exists: obsidianVaults !== null,\n      updatedAt: typeof obsidianVaults?.updatedAt === \"string\" ? obsidianVaults.updatedAt : null,\n      vaultCount: Object.keys(obsidianVaults?.vaults ?? {}).length,\n      activeChunkCount: obsidianActiveChunkCount,\n      deletedNoteCount: obsidianDeletedNoteCount,\n    },\n    openclawWorkspaceSync: {\n      statePath: openclawStatePath,\n      exists: openclawFiles !== null,\n      updatedAt: typeof openclawFiles?.updatedAt === \"string\" ? openclawFiles.updatedAt : null,\n      fileCount: Object.keys(openclawFiles?.files ?? {}).length,\n      activeChunkCount: openclawActiveChunkCount,\n      deletedFileCount: openclawDeletedFileCount,\n    },\n  };\n}\n\nconst CAPTURE_INSTRUCTIONS_START = \"<!-- BEGIN ENGRAM EXPLICIT CAPTURE INSTRUCTIONS -->\";\nconst CAPTURE_INSTRUCTIONS_END = \"<!-- END ENGRAM EXPLICIT CAPTURE INSTRUCTIONS -->\";\n\nfunction buildCaptureInstructions(): string {\n  return [\n    CAPTURE_INSTRUCTIONS_START,\n    \"# Memory\",\n    \"\",\n    \"Use this file for explicit memory capture notes when Engram runs in explicit or hybrid mode.\",\n    \"\",\n    \"## Suggested format\",\n    \"\",\n    \"- Write durable facts, decisions, commitments, or corrections.\",\n    \"- Keep entries concise and specific.\",\n    \"- Avoid secrets, tokens, and private credentials.\",\n    \"\",\n    \"## Example\",\n    \"\",\n    \"- Decision: recall benchmark packs live under `state/evals/benchmarks/`.\",\n    \"- Commitment: rerun `openclaw engram doctor --json` after changing retrieval settings.\",\n    \"\",\n    CAPTURE_INSTRUCTIONS_END,\n  ].join(\"\\n\");\n}\n\nfunction upsertManagedCaptureInstructions(existing: string | null, snippet: string): { content: string; updated: boolean; installed: boolean } {\n  if (!existing || existing.trim().length === 0) {\n    return { content: `${snippet}\\n`, updated: false, installed: true };\n  }\n  if (existing.includes(CAPTURE_INSTRUCTIONS_START) && existing.includes(CAPTURE_INSTRUCTIONS_END)) {\n    const next = existing.replace(\n      new RegExp(`${CAPTURE_INSTRUCTIONS_START}[\\\\s\\\\S]*?${CAPTURE_INSTRUCTIONS_END}`),\n      snippet,\n    );\n    return { content: next.endsWith(\"\\n\") ? next : `${next}\\n`, updated: next !== existing, installed: false };\n  }\n  const trimmed = existing.trimEnd();\n  return {\n    content: `${trimmed}\\n\\n${snippet}\\n`,\n    updated: false,\n    installed: true,\n  };\n}\n\nfunction removeManagedCaptureInstructions(existing: string): { content: string; removed: boolean } {\n  if (!existing.includes(CAPTURE_INSTRUCTIONS_START) || !existing.includes(CAPTURE_INSTRUCTIONS_END)) {\n    return { content: existing, removed: false };\n  }\n  const stripped = existing\n    .replace(new RegExp(`\\\\n*${CAPTURE_INSTRUCTIONS_START}[\\\\s\\\\S]*?${CAPTURE_INSTRUCTIONS_END}\\\\n*`), \"\\n\")\n    .replace(/\\n{3,}/g, \"\\n\\n\")\n    .trim();\n  return {\n    content: stripped.length > 0 ? `${stripped}\\n` : \"\",\n    removed: true,\n  };\n}\n\nexport async function runOperatorSetup(options: OperatorSetupOptions): Promise<OperatorSetupReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  const storage = new StorageManager(options.orchestrator.config.memoryDir);\n  await storage.ensureDirectories();\n  await mkdir(options.orchestrator.config.workspaceDir, { recursive: true });\n\n  const qmdAvailable = await options.orchestrator.qmd.probe();\n  const collectionState = options.orchestrator.config.qmdEnabled\n    ? await options.orchestrator.qmd.ensureCollection(options.orchestrator.config.memoryDir)\n    : \"skipped\";\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(options.orchestrator.config);\n\n  const memoryDocPath = path.join(options.orchestrator.config.workspaceDir, \"MEMORY.md\");\n  const captureInstructionsMode =\n    options.captureInstructionsMode\n    ?? (options.installCaptureInstructions ? \"install\" : undefined);\n  let memoryDocExists = false;\n  try {\n    await access(memoryDocPath, fsConstants.F_OK);\n    memoryDocExists = true;\n  } catch {\n    memoryDocExists = false;\n  }\n  let memoryDocInstalled = false;\n  let memoryDocUpdated = false;\n  let memoryDocRemoved = false;\n  const explicitCaptureEnabled = options.orchestrator.config.captureMode === \"explicit\"\n    || options.orchestrator.config.captureMode === \"hybrid\";\n  const captureInstructionsPreview = captureInstructionsMode ? buildCaptureInstructions() : null;\n  if (captureInstructionsMode) {\n    if (captureInstructionsMode === \"preview\") {\n      // no-op, preview only\n    } else if (captureInstructionsMode === \"install\") {\n      const existing = memoryDocExists ? await readFile(memoryDocPath, \"utf-8\") : null;\n      const next = upsertManagedCaptureInstructions(existing, captureInstructionsPreview ?? \"\");\n      if (!existing || next.content !== existing) {\n        await writeFile(memoryDocPath, next.content, \"utf-8\");\n      }\n      memoryDocExists = true;\n      memoryDocInstalled = next.installed;\n      memoryDocUpdated = next.updated;\n    } else if (captureInstructionsMode === \"remove\" && memoryDocExists) {\n      const existing = await readFile(memoryDocPath, \"utf-8\");\n      const next = removeManagedCaptureInstructions(existing);\n      if (next.removed) {\n        if (next.content.length === 0) {\n          await unlink(memoryDocPath);\n          memoryDocExists = false;\n        } else {\n          await writeFile(memoryDocPath, next.content, \"utf-8\");\n          memoryDocExists = true;\n        }\n        memoryDocRemoved = true;\n      }\n    }\n  }\n\n  const directories = await gatherDirectoryStatus(getSetupPaths(options.orchestrator.config));\n  const nextSteps = [\n    `Run \\`openclaw engram doctor${options.installCaptureInstructions ? \"\" : \" --json\"}\\` to verify runtime health.`,\n    \"Run `openclaw engram inventory --json` to capture a baseline footprint.\",\n    \"If QMD is enabled and the collection is missing, add the collection to `~/.config/qmd/index.yml` and run `qmd update && qmd embed`.\",\n  ];\n  if (explicitCaptureEnabled && !memoryDocExists) {\n    nextSteps.push(\"Run `openclaw engram setup --preview-capture-instructions` to review the managed explicit-capture snippet, then `--install-capture-instructions` to write it.\");\n  }\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    config: configStatus,\n    memoryDir: options.orchestrator.config.memoryDir,\n    workspaceDir: options.orchestrator.config.workspaceDir,\n    directories,\n    qmd: {\n      enabled: options.orchestrator.config.qmdEnabled,\n      available: qmdAvailable,\n      collectionState,\n      debugStatus: options.orchestrator.qmd.debugStatus(),\n    },\n    nativeKnowledge: nativeKnowledgeStatus,\n    explicitCapture: {\n      captureMode: options.orchestrator.config.captureMode,\n      enabled: explicitCaptureEnabled,\n      memoryDocPath,\n      memoryDocExists,\n      memoryDocInstalled,\n      memoryDocUpdated,\n      memoryDocRemoved,\n      preview: captureInstructionsMode === \"preview\" ? captureInstructionsPreview : null,\n    },\n    nextSteps,\n    verificationCommands: [\n      \"openclaw engram doctor --json\",\n      \"openclaw engram inventory --json\",\n      \"openclaw engram benchmark recall --json\",\n    ],\n  };\n}\n\nfunction summarizeHygieneWarnings(\n  warnings: Awaited<ReturnType<typeof lintWorkspaceFiles>>,\n  hygiene: FileHygieneConfig | undefined,\n): OperatorDoctorCheck {\n  if (!hygiene?.enabled || hygiene.lintEnabled !== true) {\n    return {\n      key: \"file_hygiene\",\n      status: \"warn\",\n      summary: \"File hygiene linting is disabled; bootstrap file truncation warnings are not active.\",\n      remediation: \"Enable `fileHygiene.enabled` and `fileHygiene.lintEnabled` if large workspace bootstrap files are common.\",\n      details: {\n        enabled: hygiene?.enabled === true,\n        lintEnabled: hygiene?.lintEnabled === true,\n      },\n    };\n  }\n  if (warnings.length > 0) {\n    return {\n      key: \"file_hygiene\",\n      status: \"warn\",\n      summary: `${warnings.length} bootstrap file(s) are near or above the configured budget.`,\n      remediation: \"Archive/split the listed files or adjust `fileHygiene` budgets.\",\n      details: { warnings },\n    };\n  }\n  return {\n    key: \"file_hygiene\",\n    status: \"ok\",\n    summary: \"Bootstrap file hygiene is within budget.\",\n    details: {\n      enabled: true,\n      lintPaths: hygiene.lintPaths,\n      budgetBytes: hygiene.lintBudgetBytes,\n    },\n  };\n}\n\nfunction buildConfigReviewFinding(input: {\n  key: string;\n  status: \"recommend\" | \"problem\";\n  setting: string;\n  currentValue: unknown;\n  defaultValue: unknown;\n  recommendedValue: unknown;\n  summary: string;\n  rationale: string;\n}): OperatorConfigReviewFinding {\n  return {\n    key: input.key,\n    status: input.status,\n    setting: input.setting,\n    currentValue: formatConfigValue(input.currentValue),\n    defaultValue: formatConfigValue(input.defaultValue),\n    recommendedValue: formatConfigValue(input.recommendedValue),\n    summary: input.summary,\n    rationale: input.rationale,\n  };\n}\n\nexport async function runOperatorConfigReview(\n  options: OperatorConfigReviewOptions,\n): Promise<OperatorConfigReviewReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  return buildOperatorConfigReviewReport({\n    now,\n    configStatus,\n    config: options.orchestrator.config,\n  });\n}\n\nasync function buildOperatorConfigReviewReport(input: {\n  now: Date;\n  configStatus: OperatorConfigLoadResult;\n  config: PluginConfig;\n}): Promise<OperatorConfigReviewReport> {\n  const { now, configStatus, config } = input;\n  const findings: OperatorConfigReviewFinding[] = [];\n  const searchBackend = config.searchBackend ?? \"qmd\";\n  const workspaceBootstrapFiles = [\n    path.join(config.workspaceDir, \"IDENTITY.md\"),\n    path.join(config.workspaceDir, \"MEMORY.md\"),\n    path.join(config.workspaceDir, \"USER.md\"),\n  ];\n  const workspaceBootstrapExists = (await Promise.all(workspaceBootstrapFiles.map(pathExists))).some(Boolean);\n\n  if (\n    config.memoryOsPreset !== \"conservative\" &&\n    config.memoryOsPreset !== \"balanced\" &&\n    config.memoryOsPreset !== \"research-max\" &&\n    config.memoryOsPreset !== \"local-llm-heavy\" &&\n    config.queryAwareIndexingEnabled === false &&\n    config.verbatimArtifactsEnabled === false &&\n    config.rerankEnabled === false\n  ) {\n    findings.push(buildConfigReviewFinding({\n      key: \"balanced_preset\",\n      status: \"recommend\",\n      setting: \"memoryOsPreset\",\n      currentValue: config.memoryOsPreset,\n      defaultValue: \"(unset)\",\n      recommendedValue: \"balanced\",\n      summary: \"Adopt the balanced preset as the baseline configuration profile.\",\n      rationale:\n        \"The balanced preset enables the recommended indexing, reranking, and artifact defaults without turning on the higher-churn graph and learning loops.\",\n    }));\n  }\n\n  if (config.qmdEnabled && config.qmdDaemonEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_daemon\",\n      status: \"recommend\",\n      setting: \"qmdDaemonEnabled\",\n      currentValue: config.qmdDaemonEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"Enable the QMD daemon path when QMD powers recall.\",\n      rationale:\n        \"The daemon path reduces recall/search contention by preferring the MCP transport instead of repeated subprocess calls when QMD is available.\",\n    }));\n  }\n\n  if (workspaceBootstrapExists && config.nativeKnowledge?.enabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"native_knowledge_enabled\",\n      status: \"recommend\",\n      setting: \"nativeKnowledge.enabled\",\n      currentValue: config.nativeKnowledge?.enabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Enable native knowledge recall for workspace bootstrap documents.\",\n      rationale:\n        \"When files like IDENTITY.md or MEMORY.md already exist, native knowledge recall can chunk and inject them directly instead of relying only on extracted memories.\",\n    }));\n  }\n\n  if (workspaceBootstrapExists && config.fileHygiene?.enabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"file_hygiene_enabled\",\n      status: \"recommend\",\n      setting: \"fileHygiene.enabled\",\n      currentValue: config.fileHygiene?.enabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Enable file hygiene to avoid silent workspace-file truncation.\",\n      rationale:\n        \"OpenClaw bootstrap files can grow quietly; file hygiene warns before oversized files are truncated during prompt bootstrap.\",\n    }));\n  }\n\n  if (searchBackend === \"qmd\" && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_search_backend_disabled\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"QMD search is selected but QMD is disabled.\",\n      rationale:\n        \"When searchBackend resolves to qmd while qmdEnabled is false, Engram falls back to the noop backend and disables the primary search path.\",\n    }));\n  }\n\n  if (config.qmdColdTierEnabled === true && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_cold_tier_requires_qmd\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"Cold-tier QMD recall is enabled while QMD itself is disabled.\",\n      rationale:\n        \"The cold tier depends on the same QMD runtime as the hot tier, so turning QMD off leaves the extra tiering path unusable.\",\n    }));\n  }\n\n  if (config.qmdTierMigrationEnabled && config.qmdColdTierEnabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_tier_migration_requires_cold_tier\",\n      status: \"problem\",\n      setting: \"qmdColdTierEnabled\",\n      currentValue: config.qmdColdTierEnabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Hot/cold tier migration is enabled without the cold tier itself.\",\n      rationale:\n        \"Tier migration depends on the cold-tier collection and recall path, so enabling migration while the cold tier is off leaves the feature in a contradictory state.\",\n    }));\n  }\n\n  if (config.conversationIndexEnabled && config.conversationIndexBackend === \"qmd\" && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"conversation_index_qmd_requires_qmd\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"The conversation index is configured for QMD while QMD is disabled.\",\n      rationale:\n        \"A QMD-backed conversation index cannot rebuild or serve queries when the underlying QMD runtime is disabled.\",\n    }));\n  }\n\n  const summary = findings.reduce(\n    (acc, finding) => {\n      acc[finding.status] += 1;\n      return acc;\n    },\n    { recommend: 0, problem: 0 },\n  );\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    ok: configStatus.parsed && summary.problem === 0,\n    config: configStatus,\n    profile: {\n      memoryOsPreset: config.memoryOsPreset,\n      searchBackend,\n      qmdEnabled: config.qmdEnabled,\n      qmdDaemonEnabled: config.qmdDaemonEnabled,\n      nativeKnowledgeEnabled: config.nativeKnowledge?.enabled === true,\n      fileHygieneEnabled: config.fileHygiene?.enabled === true,\n      conversationIndexEnabled: config.conversationIndexEnabled,\n    },\n    summary,\n    findings,\n  };\n}\n\nexport async function runOperatorDoctor(options: OperatorDoctorOptions): Promise<OperatorDoctorReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  const checks: OperatorDoctorCheck[] = [];\n  const config = options.orchestrator.config;\n  const configReview = await buildOperatorConfigReviewReport({\n    now,\n    configStatus,\n    config,\n  });\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(config);\n  const setupPaths = await gatherDirectoryStatus(getSetupPaths(config));\n  const missingPaths = setupPaths.filter((entry) => !entry.exists).map((entry) => entry.path);\n\n  checks.push({\n    key: \"config\",\n    status: configStatus.parsed\n      ? \"ok\"\n      : options.configPath\n      ? \"error\"\n      : \"warn\",\n    summary: configStatus.parsed ? \"OpenClaw config loaded and Engram config parsed successfully.\" : \"Config file could not be parsed.\",\n    remediation: configStatus.parsed ? undefined : \"Fix the config file or set OPENCLAW_ENGRAM_CONFIG_PATH/OPENCLAW_CONFIG_PATH.\",\n    details: configStatus,\n  });\n\n  checks.push({\n    key: \"memory_dir\",\n    status: missingPaths.length === 0 ? \"ok\" : \"warn\",\n    summary: missingPaths.length === 0\n      ? \"Expected Engram directories exist.\"\n      : `${missingPaths.length} expected directory path(s) are missing.`,\n    remediation: missingPaths.length === 0 ? undefined : \"Run `openclaw engram setup` to create missing directories.\",\n    details: { directories: setupPaths },\n  });\n\n  checks.push({\n    key: \"config_review\",\n    status: configReview.summary.problem > 0 ? \"error\" : configReview.summary.recommend > 0 ? \"warn\" : \"ok\",\n    summary: configReview.summary.problem > 0\n      ? `${configReview.summary.problem} configuration problem(s) detected.`\n      : configReview.summary.recommend > 0\n      ? `No configuration problems detected; ${configReview.summary.recommend} optional recommendation(s) are available.`\n      : \"No configuration problems detected.\",\n    remediation: configReview.summary.problem > 0 || configReview.summary.recommend > 0\n      ? \"Run `openclaw engram config-review` to inspect and fix the flagged configuration combinations.\"\n      : undefined,\n    details: configReview,\n  });\n\n  const qmdAvailable = await options.orchestrator.qmd.probe();\n  const collectionState = config.qmdEnabled\n    ? await options.orchestrator.qmd.ensureCollection(config.memoryDir)\n    : \"skipped\";\n  checks.push({\n    key: \"qmd\",\n    status: !config.qmdEnabled\n      ? \"warn\"\n      : !qmdAvailable\n      ? \"error\"\n      : collectionState === \"present\"\n      ? \"ok\"\n      : collectionState === \"missing\"\n      ? \"error\"\n      : \"warn\",\n    summary: !config.qmdEnabled\n      ? \"QMD is disabled in config.\"\n      : qmdAvailable\n      ? `QMD is reachable (${collectionState}).`\n      : \"QMD is not currently reachable.\",\n    remediation: !config.qmdEnabled\n      ? \"Enable `qmdEnabled` if you expect hybrid search.\"\n      : !qmdAvailable\n      ? \"Ensure the `qmd` binary is installed and on PATH, or set `qmdPath`.\"\n      : collectionState === \"missing\"\n      ? \"Add the configured collection to `~/.config/qmd/index.yml`.\"\n      : collectionState === \"present\"\n      ? undefined\n      : \"Re-run `openclaw engram setup` after restoring QMD access.\",\n    details: {\n      available: qmdAvailable,\n      collectionState,\n      debugStatus: options.orchestrator.qmd.debugStatus(),\n    },\n  });\n\n  const conversationIndex = await options.orchestrator.getConversationIndexHealth();\n  checks.push({\n    key: \"conversation_index\",\n    status: conversationIndex.status === \"ok\"\n      ? \"ok\"\n      : conversationIndex.enabled\n      ? \"error\"\n      : \"warn\",\n    summary: conversationIndex.enabled\n      ? `Conversation index backend is ${conversationIndex.status}.`\n      : \"Conversation index is disabled.\",\n    remediation: conversationIndex.enabled && conversationIndex.status !== \"ok\"\n      ? \"Run `openclaw engram rebuild-index` to refresh the conversation index artifacts.\"\n      : undefined,\n    details: conversationIndex,\n  });\n\n  const meta = await new StorageManager(config.memoryDir).loadMeta();\n  checks.push({\n    key: \"maintenance\",\n    status: meta.lastExtractionAt || meta.lastConsolidationAt ? \"ok\" : \"warn\",\n    summary: meta.lastExtractionAt || meta.lastConsolidationAt\n      ? \"Extraction/consolidation metadata is present.\"\n      : \"No extraction or consolidation metadata found yet.\",\n    remediation: meta.lastExtractionAt || meta.lastConsolidationAt\n      ? undefined\n      : \"Run a normal agent turn or `openclaw engram consolidate` after seeding memory.\",\n    details: meta,\n  });\n\n  const syncedChunkCount =\n    nativeKnowledgeStatus.curatedIncludeSync.activeChunkCount +\n    nativeKnowledgeStatus.obsidianSync.activeChunkCount +\n    nativeKnowledgeStatus.openclawWorkspaceSync.activeChunkCount;\n  const hasSyncState =\n    nativeKnowledgeStatus.curatedIncludeSync.exists ||\n    nativeKnowledgeStatus.obsidianSync.exists ||\n    nativeKnowledgeStatus.openclawWorkspaceSync.exists;\n  checks.push({\n    key: \"native_knowledge\",\n    status: !nativeKnowledgeStatus.enabled\n      ? \"warn\"\n      : hasSyncState\n        ? \"ok\"\n        : \"warn\",\n    summary: !nativeKnowledgeStatus.enabled\n      ? \"Native knowledge sync is disabled.\"\n      : hasSyncState\n        ? `Native knowledge sync state is present (${syncedChunkCount} active chunks).`\n        : \"Native knowledge sync is enabled but no sync state has been written yet.\",\n    remediation: !nativeKnowledgeStatus.enabled\n      ? \"Enable `nativeKnowledge.enabled` if curated workspace recall should participate in retrieval.\"\n      : hasSyncState\n        ? undefined\n        : \"Run a recall, sync, or setup flow that touches native knowledge sources, then rerun `openclaw engram doctor --json`.\",\n    details: nativeKnowledgeStatus,\n  });\n\n  const agentAccessEnabled = config.agentAccessHttp?.enabled === true;\n  checks.push({\n    key: \"access_http_auth\",\n    status: !agentAccessEnabled\n      ? \"warn\"\n      : config.agentAccessHttp?.authToken\n      ? \"ok\"\n      : \"error\",\n    summary: !agentAccessEnabled\n      ? \"Agent access HTTP bridge is disabled.\"\n      : config.agentAccessHttp?.authToken\n      ? \"Agent access HTTP bridge has an auth token configured.\"\n      : \"Agent access HTTP bridge is enabled without an auth token.\",\n    remediation: !agentAccessEnabled\n      ? \"Ignore unless you plan to enable the HTTP bridge.\"\n      : config.agentAccessHttp?.authToken\n      ? undefined\n      : \"Set `agentAccessHttp.authToken` before exposing the bridge.\",\n  });\n\n  const warnings = config.fileHygiene?.lintEnabled\n    ? await lintWorkspaceFiles({\n        workspaceDir: config.workspaceDir,\n        paths: config.fileHygiene.lintPaths,\n        budgetBytes: config.fileHygiene.lintBudgetBytes,\n        warnRatio: config.fileHygiene.lintWarnRatio,\n      })\n    : [];\n  checks.push(summarizeHygieneWarnings(warnings, config.fileHygiene));\n\n  // Memory Worth legacy counter audit (issue #560 PR 1).\n  // Memories written before #560 have no `mw_success` / `mw_fail` frontmatter\n  // fields. That is fully supported — readers treat the absence as a uniform\n  // Beta(1,1) prior — but surfacing the count helps operators understand how\n  // much history will bootstrap the scoring pipeline landed in later PRs.\n  // This is an informational check, never an error.\n  checks.push(await summarizeMemoryWorthLegacyCounters(new StorageManager(config.memoryDir)));\n\n  // Buffer surprise telemetry distribution (issue #563 PR 3).\n  // Surfaces recent surprise scores so operators can calibrate the\n  // `bufferSurpriseThreshold` from real traffic. Never an error — an empty\n  // ledger is the expected state until the flag is turned on.\n  checks.push(\n    await summarizeBufferSurpriseDistribution(new StorageManager(config.memoryDir), config),\n  );\n\n  // Consolidation provenance integrity (issue #561 PR 4).\n  // Validates that every `derived_from` entry resolves to an on-disk\n  // page-version snapshot and every `derived_via` is a known operator.\n  // Broken provenance emits warnings with the offending file path — the\n  // check is informational (never an error) because a missing snapshot\n  // can legitimately occur after log pruning or versioning being disabled\n  // retroactively; operators need visibility, not a hard fail.  Review\n  // feedback (PR #634): the summarizer threads the configured\n  // `versioningSidecarDir` into the scan so deployments that override\n  // the default `.versions` directory get accurate results instead of\n  // false-missing warnings.\n  checks.push(await summarizeConsolidationProvenance(new StorageManager(config.memoryDir), config));\n\n  // Security mitigation status (issue #565).\n  // Reports whether the cross-namespace budget and anomaly detection\n  // mitigations are enabled and surfaces config values for operator review.\n  checks.push(summarizeSecurityMitigations(config));\n\n  const summary = checks.reduce(\n    (acc, check) => {\n      acc[check.status] += 1;\n      return acc;\n    },\n    { ok: 0, warn: 0, error: 0 },\n  );\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    ok: summary.error === 0,\n    summary,\n    config: configStatus,\n    checks,\n  };\n}\n\n/**\n * Categories whose memories are eligible for Memory Worth instrumentation.\n *\n * Memory Worth is a per-fact utility signal: the counters ride on extracted\n * facts whose retrieval outcome can be judged (success/fail) by the feedback\n * pipeline landing in issue #560 PR 3. Procedures, corrections, and other\n * non-fact memory kinds are out of scope — they are not expected to be\n * instrumented, and counting them as \"legacy\" would permanently inflate the\n * legacy bucket and make rollout progress misleading even when every fact\n * memory is instrumented.\n *\n * If a later PR widens Memory Worth to additional categories, extend this set\n * alongside the scoring/increment logic so the doctor audit stays in sync.\n */\nconst MEMORY_WORTH_ELIGIBLE_CATEGORIES: ReadonlySet<MemoryFile[\"frontmatter\"][\"category\"]> =\n  new Set([\"fact\"]);\n\n/**\n * Count memories that pre-date the Memory Worth counters introduced in issue\n * #560 — i.e., neither `mw_success` nor `mw_fail` is set on the frontmatter.\n *\n * Only memories whose category is eligible for Memory Worth (see\n * `MEMORY_WORTH_ELIGIBLE_CATEGORIES`) are considered. Procedures, corrections,\n * and other kinds that are not instrumented are excluded entirely — they're\n * neither \"legacy\" nor \"instrumented\" for the purposes of this audit. The\n * total in the returned details reflects only eligible memories.\n *\n * Returned as an `ok` check regardless of count, since legacy memories are\n * fully functional (readers treat missing counters as zero observations). The\n * numbers are informational for operators following the #560 rollout.\n *\n * Exported so unit tests can exercise the classification logic without\n * booting a full orchestrator.\n */\nexport async function summarizeMemoryWorthLegacyCounters(\n  storage: StorageManager,\n): Promise<OperatorDoctorCheck> {\n  let legacy = 0;\n  let instrumented = 0;\n  let ineligible = 0;\n  try {\n    const memories = await storage.readAllMemories();\n    for (const memory of memories) {\n      if (!MEMORY_WORTH_ELIGIBLE_CATEGORIES.has(memory.frontmatter.category)) {\n        ineligible += 1;\n        continue;\n      }\n      const { mw_success, mw_fail } = memory.frontmatter;\n      if (mw_success === undefined && mw_fail === undefined) {\n        legacy += 1;\n      } else {\n        instrumented += 1;\n      }\n    }\n  } catch (err) {\n    return {\n      key: \"memory_worth_legacy\",\n      status: \"warn\",\n      summary: \"Could not enumerate memories to count Memory Worth instrumentation.\",\n      remediation: \"Retry `remnic doctor` after ensuring the memory directory is readable.\",\n      details: { error: String(err) },\n    };\n  }\n\n  const total = legacy + instrumented;\n  return {\n    key: \"memory_worth_legacy\",\n    status: \"ok\",\n    summary:\n      total === 0\n        ? \"No Memory Worth–eligible memories on disk yet — counters will populate as facts are extracted.\"\n        : `${legacy} of ${total} eligible memories have no Memory Worth counters yet (${instrumented} instrumented).`,\n    details: { legacy, instrumented, total, ineligible },\n  };\n}\n\n/**\n * Summarize the recent buffer-surprise telemetry distribution for the\n * Doctor report (issue #563 PR 3).\n *\n * Reports mean/median/p90 surprise scores and the triggered-flush rate\n * over the most recent window of ledger rows. An empty ledger is the\n * expected state until `bufferSurpriseTriggerEnabled` is turned on — the\n * check never escalates beyond `ok` / `warn` (ledger unreadable).\n *\n * Exported so tests can exercise the formatting without booting a real\n * orchestrator.\n */\nexport async function summarizeBufferSurpriseDistribution(\n  storage: StorageManager,\n  config: PluginConfig,\n): Promise<OperatorDoctorCheck> {\n  const storageWithLedger = storage as StorageManager & {\n    readBufferSurpriseEvents?: (\n      opts: { limit?: number },\n    ) => Promise<BufferSurpriseEvent[]>;\n  };\n\n  // Defensive: older StorageManager builds (not yet rebuilt) may lack the\n  // reader. Do not fail the entire Doctor run in that case.\n  if (typeof storageWithLedger.readBufferSurpriseEvents !== \"function\") {\n    return {\n      key: \"buffer_surprise_distribution\",\n      status: \"ok\",\n      summary: \"Buffer-surprise telemetry reader unavailable in this build.\",\n      details: { available: false },\n    };\n  }\n\n  try {\n    const dist = await reportBufferSurpriseDistribution(\n      async (opts) =>\n        storageWithLedger.readBufferSurpriseEvents!({ limit: opts.limit }),\n      { limit: 200 },\n    );\n\n    if (dist.count === 0) {\n      return {\n        key: \"buffer_surprise_distribution\",\n        status: \"ok\",\n        summary: config.bufferSurpriseTriggerEnabled\n          ? \"Surprise trigger is enabled but no telemetry has been recorded yet.\"\n          : \"Surprise trigger is disabled; no telemetry expected.\",\n        details: {\n          enabled: config.bufferSurpriseTriggerEnabled,\n          distribution: dist,\n        },\n      };\n    }\n\n    const pct = (value: number) => (value * 100).toFixed(1);\n    return {\n      key: \"buffer_surprise_distribution\",\n      status: \"ok\",\n      summary: `Recent surprise: mean=${dist.mean.toFixed(3)}, median=${dist.median.toFixed(3)}, p90=${dist.p90.toFixed(3)}, triggered=${pct(dist.triggeredRate)}% over ${dist.count} turns (threshold=${dist.currentThreshold ?? config.bufferSurpriseThreshold}).`,\n      details: {\n        enabled: config.bufferSurpriseTriggerEnabled,\n        distribution: dist,\n      },\n    };\n  } catch (err) {\n    return {\n      key: \"buffer_surprise_distribution\",\n      status: \"warn\",\n      summary: \"Could not read buffer-surprise telemetry ledger.\",\n      remediation:\n        \"Retry `remnic doctor` after ensuring the memory state directory is readable.\",\n      details: { error: String(err) },\n    };\n  }\n}\n\n/**\n * Summarize the consolidation-provenance integrity scan for the doctor\n * report (issue #561 PR 4).  Returns an `ok` check when no issues are\n * found, `warn` otherwise.  Never returns `error` — a broken provenance\n * pointer is informational because it can legitimately result from log\n * pruning, versioning being disabled retroactively, or operator-driven\n * archive operations.\n *\n * Exported so unit tests can exercise the summarization without booting a\n * full orchestrator.\n */\n\nfunction summarizeSecurityMitigations(\n  config: Pick<\n    PluginConfig,\n    | \"recallCrossNamespaceBudgetEnabled\"\n    | \"recallCrossNamespaceBudgetWindowMs\"\n    | \"recallCrossNamespaceBudgetSoftLimit\"\n    | \"recallCrossNamespaceBudgetHardLimit\"\n    | \"recallAuditAnomalyDetectionEnabled\"\n    | \"recallAuditAnomalyWindowMs\"\n    | \"recallAuditAnomalyRepeatQueryLimit\"\n    | \"recallAuditAnomalyNamespaceWalkLimit\"\n    | \"recallAuditAnomalyHighCardinalityLimit\"\n    | \"recallAuditAnomalyRapidFireLimit\"\n  >,\n): OperatorDoctorCheck {\n  const budgetEnabled = config.recallCrossNamespaceBudgetEnabled === true;\n  const anomalyEnabled = config.recallAuditAnomalyDetectionEnabled === true;\n\n  if (!budgetEnabled && !anomalyEnabled) {\n    return {\n      key: \"security_mitigations\",\n      status: \"warn\",\n      summary: \"Memory-extraction mitigations are disabled (cross-namespace budget and anomaly detection off).\",\n      remediation: \"Enable recallCrossNamespaceBudgetEnabled and/or recallAuditAnomalyDetectionEnabled for production deployments. See docs/security/memory-extraction-threat-model.md.\",\n      details: {\n        budgetEnabled: false,\n        anomalyDetectionEnabled: false,\n      },\n    };\n  }\n\n  const details: Record<string, unknown> = {\n    budgetEnabled,\n    anomalyDetectionEnabled: anomalyEnabled,\n  };\n\n  if (budgetEnabled) {\n    details.budgetConfig = {\n      windowMs: config.recallCrossNamespaceBudgetWindowMs,\n      softLimit: config.recallCrossNamespaceBudgetSoftLimit,\n      hardLimit: config.recallCrossNamespaceBudgetHardLimit,\n    };\n  }\n\n  if (anomalyEnabled) {\n    details.anomalyConfig = {\n      windowMs: config.recallAuditAnomalyWindowMs,\n      repeatQueryLimit: config.recallAuditAnomalyRepeatQueryLimit,\n      namespaceWalkLimit: config.recallAuditAnomalyNamespaceWalkLimit,\n      highCardinalityLimit: config.recallAuditAnomalyHighCardinalityLimit,\n      rapidFireLimit: config.recallAuditAnomalyRapidFireLimit,\n    };\n  }\n\n  return {\n    key: \"security_mitigations\",\n    status: \"ok\",\n    summary: `Memory-extraction mitigation config enabled: ${budgetEnabled ? \"budget\" : \"\"}${budgetEnabled && anomalyEnabled ? \", \" : \"\"}${anomalyEnabled ? \"anomaly detection\" : \"\"}.`,\n    details: { ...details, configOnly: true },\n  };\n}\n\nexport async function summarizeConsolidationProvenance(\n  storage: StorageManager,\n  config: Pick<PluginConfig, \"memoryDir\"> & { versioningSidecarDir?: string },\n): Promise<OperatorDoctorCheck> {\n  let report: ConsolidationProvenanceReport;\n  try {\n    report = await runConsolidationProvenanceCheck({\n      storage,\n      memoryDir: config.memoryDir,\n      // Honor the configured sidecar directory (PR #634 review): when an\n      // operator overrides `versioningSidecarDir`, the default `.versions`\n      // would point at the wrong location and every entry would report as\n      // missing.  Undefined falls back to the helper's default.\n      sidecarDir: config.versioningSidecarDir,\n    });\n  } catch (err) {\n    return {\n      key: \"consolidation_provenance\",\n      status: \"warn\",\n      summary: \"Could not run consolidation-provenance integrity check.\",\n      remediation: \"Ensure the memory directory is readable and rerun `remnic doctor`.\",\n      details: { error: String(err) },\n    };\n  }\n\n  if (report.issues.length === 0) {\n    return {\n      key: \"consolidation_provenance\",\n      status: \"ok\",\n      summary:\n        report.withProvenance === 0\n          ? \"No consolidation-provenance memories on disk yet.\"\n          : `${report.withProvenance} consolidation-provenance memories verified (no broken references).`,\n      details: report,\n    };\n  }\n\n  return {\n    key: \"consolidation_provenance\",\n    status: \"warn\",\n    summary: `${report.issues.length} consolidation-provenance integrity issue(s) detected across ${report.withProvenance} memories with provenance frontmatter.`,\n    remediation:\n      \"Broken pointers are informational. Inspect flagged memories, and if they should resolve, re-snapshot via a consolidation pass or accept pruning.\",\n    details: report,\n  };\n}\n\nfunction getMemoryAgeBand(memory: MemoryFile, now: Date): string {\n  const created = Date.parse(memory.frontmatter.created ?? \"\");\n  if (!Number.isFinite(created)) return \"unknown\";\n  const ageDays = Math.max(0, Math.floor((now.getTime() - created) / 86_400_000));\n  if (ageDays < 7) return \"0_6d\";\n  if (ageDays < 30) return \"7_29d\";\n  if (ageDays < 90) return \"30_89d\";\n  return \"90d_plus\";\n}\n\nasync function dirSize(targetPath: string): Promise<number> {\n  try {\n    const info = await stat(targetPath);\n    if (info.isFile()) return info.size;\n    if (!info.isDirectory()) return 0;\n  } catch {\n    return 0;\n  }\n\n  let total = 0;\n  let entries;\n  try {\n    entries = await readdir(targetPath, { withFileTypes: true });\n  } catch {\n    return 0;\n  }\n  for (const entry of entries) {\n    total += await dirSize(path.join(targetPath, entry.name));\n  }\n  return total;\n}\n\nasync function summarizeStorageFootprint(memoryDir: string): Promise<{ bytes: number; byTopLevel: Record<string, number> }> {\n  const topLevel = [\n    \"facts\",\n    \"entities\",\n    \"questions\",\n    \"corrections\",\n    \"artifacts\",\n    \"state\",\n    \"identity\",\n    \"namespaces\",\n    \"summaries\",\n    \"profile.md\",\n  ];\n  const byTopLevel: Record<string, number> = {};\n  let bytes = 0;\n  for (const name of topLevel) {\n    const size = await dirSize(path.join(memoryDir, name));\n    if (size > 0) {\n      byTopLevel[name] = size;\n      bytes += size;\n    }\n  }\n  return { bytes, byTopLevel };\n}\n\nexport async function runOperatorInventory(options: OperatorInventoryOptions): Promise<OperatorInventoryReport> {\n  const now = options.now ?? new Date();\n  const config = options.orchestrator.config;\n  const namespaceEntries = await listNamespaces({ config });\n  const uniqueRootEntries = new Map<string, { namespace: string; rootDir: string }>();\n  for (const entry of namespaceEntries) {\n    if (!uniqueRootEntries.has(entry.rootDir)) {\n      uniqueRootEntries.set(entry.rootDir, { namespace: entry.namespace, rootDir: entry.rootDir });\n    }\n  }\n  const categories: Record<string, number> = {};\n  const statuses: Record<string, number> = {};\n  const ageBands: Record<string, number> = {\n    \"0_6d\": 0,\n    \"7_29d\": 0,\n    \"30_89d\": 0,\n    \"90d_plus\": 0,\n    unknown: 0,\n  };\n  const namespaces: OperatorInventoryNamespaceSummary[] = [];\n  let totalMemories = 0;\n  let totalEntities = 0;\n  let archived = 0;\n  let pendingReview = 0;\n  let quarantined = 0;\n  let rejected = 0;\n\n  for (const entry of uniqueRootEntries.values()) {\n    const storage = new StorageManager(entry.rootDir);\n    const memories = await storage.readAllMemories();\n    const entities = await storage.readAllEntityFiles();\n    namespaces.push({\n      namespace: entry.namespace,\n      memoryCount: memories.length,\n      entityCount: entities.length,\n    });\n    totalMemories += memories.length;\n    totalEntities += entities.length;\n    for (const memory of memories) {\n      const category = memory.frontmatter.category;\n      categories[category] = (categories[category] ?? 0) + 1;\n      const status = memory.frontmatter.status ?? \"active\";\n      statuses[status] = (statuses[status] ?? 0) + 1;\n      ageBands[getMemoryAgeBand(memory, now)] += 1;\n      if (status === \"archived\") archived += 1;\n      if (status === \"pending_review\") pendingReview += 1;\n      if (status === \"quarantined\") quarantined += 1;\n      if (status === \"rejected\") rejected += 1;\n    }\n  }\n\n  const defaultStorage = new StorageManager(config.memoryDir);\n  const profile = await defaultStorage.readProfile();\n  const footprint = await summarizeStorageFootprint(config.memoryDir);\n  const reviewRunId = (await listMemoryGovernanceRuns(config.memoryDir))[0];\n  let reviewQueue = 0;\n  if (reviewRunId) {\n    try {\n      reviewQueue = (await readMemoryGovernanceRunArtifact(config.memoryDir, reviewRunId)).reviewQueue.length;\n    } catch {\n      reviewQueue = 0;\n    }\n  }\n  const conversationIndex = await options.orchestrator.getConversationIndexHealth();\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(config);\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    memoryDir: config.memoryDir,\n    totals: {\n      memories: totalMemories,\n      entities: totalEntities,\n      namespaces: namespaceEntries.length,\n      reviewQueue,\n      storageBytes: footprint.bytes,\n    },\n    categories,\n    statuses,\n    namespaces,\n    ageBands,\n    profile: {\n      exists: profile.length > 0,\n      chars: profile.length,\n      lines: profile.length > 0 ? profile.split(\"\\n\").length : 0,\n    },\n    storageFootprint: footprint,\n    archivePressure: {\n      archived,\n      pendingReview,\n      quarantined,\n      rejected,\n    },\n    conversationIndex: {\n      enabled: conversationIndex.enabled,\n      backend: conversationIndex.backend,\n      status: conversationIndex.status,\n      chunkDocCount: conversationIndex.chunkDocCount,\n      lastUpdateAt: conversationIndex.lastUpdateAt,\n    },\n    nativeKnowledge: {\n      enabled: nativeKnowledgeStatus.enabled,\n      curatedIncludeSync: nativeKnowledgeStatus.curatedIncludeSync,\n      obsidianSync: nativeKnowledgeStatus.obsidianSync,\n      openclawWorkspaceSync: nativeKnowledgeStatus.openclawWorkspaceSync,\n    },\n  };\n}\n\nexport async function runBenchmarkRecall(options: BenchmarkRecallOptions): Promise<BenchmarkRecallReport> {\n  const now = options.now ?? new Date();\n  const status = await getEvalHarnessStatus({\n    memoryDir: options.config.memoryDir,\n    evalStoreDir: options.config.evalStoreDir,\n    enabled: options.config.evalHarnessEnabled,\n    shadowModeEnabled: options.config.evalShadowModeEnabled,\n    baselineSnapshotsEnabled: options.config.benchmarkBaselineSnapshotsEnabled,\n    memoryRedTeamBenchEnabled: options.config.memoryRedTeamBenchEnabled,\n  });\n\n  if (options.createSnapshot && options.snapshotId) {\n    const snapshot = await createEvalBaselineSnapshot({\n      memoryDir: options.config.memoryDir,\n      evalStoreDir: options.config.evalStoreDir,\n      baselineSnapshotsEnabled: options.config.benchmarkBaselineSnapshotsEnabled,\n      snapshotId: options.snapshotId,\n      notes: options.snapshotNotes,\n      gitRef: options.gitRef,\n      createdAt: options.createdAt,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"snapshot\",\n      status,\n      snapshot: {\n        targetPath: snapshot.targetPath,\n        snapshotId: snapshot.snapshot.snapshotId,\n      },\n    };\n  }\n\n  if (options.baseEvalStoreDir && options.candidateEvalStoreDir) {\n    const ciGate = await runEvalBenchmarkCiGate({\n      baseEvalStoreDir: options.baseEvalStoreDir,\n      candidateEvalStoreDir: options.candidateEvalStoreDir,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"ci-gate\",\n      status,\n      ciGate,\n    };\n  }\n\n  if (options.snapshotId) {\n    const baselineReport = await runEvalBaselineDeltaReport({\n      memoryDir: options.config.memoryDir,\n      evalStoreDir: options.config.evalStoreDir,\n      benchmarkDeltaReporterEnabled: options.config.benchmarkDeltaReporterEnabled,\n      snapshotId: options.snapshotId,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"baseline-report\",\n      status,\n      baselineReport,\n    };\n  }\n\n  if (options.validatePath) {\n    const validate = await validateEvalBenchmarkPack(options.validatePath, {\n      memoryRedTeamBenchEnabled: options.config.memoryRedTeamBenchEnabled,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"validate\",\n      status,\n      validate,\n    };\n  }\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    mode: \"status\",\n    status,\n  };\n}\n\nexport async function runOperatorRepair(options: OperatorRepairOptions): Promise<OperatorRepairReport> {\n  const now = options.now ?? new Date();\n  const dryRun = options.dryRun === true || options.apply !== true;\n  const sessionCheck = await analyzeSessionIntegrity({ memoryDir: options.config.memoryDir });\n  const sessionRepairPlan = planSessionRepair({\n    report: sessionCheck,\n    dryRun,\n    allowSessionFileRepair: options.allowSessionFileRepair,\n    sessionFilesDir: options.sessionFilesDir,\n  });\n  const sessionRepairApply = await applySessionRepair({\n    plan: sessionRepairPlan,\n  });\n  const graphHealth = await analyzeGraphHealth(options.config.memoryDir, {\n    entityGraphEnabled: options.config.entityGraphEnabled,\n    timeGraphEnabled: options.config.timeGraphEnabled,\n    causalGraphEnabled: options.config.causalGraphEnabled,\n    includeRepairGuidance: true,\n  });\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    dryRun,\n    sessionCheck,\n    sessionRepairPlan,\n    sessionRepairApply,\n    graphHealth,\n  };\n}\n","import path from \"node:path\";\nimport { access, mkdir, readdir, rename } from \"node:fs/promises\";\nimport type { PluginConfig } from \"../types.js\";\nimport { NamespaceStorageRouter } from \"./storage.js\";\nimport { namespaceCollectionName } from \"./search.js\";\nimport { isSafeRouteNamespace } from \"../routing/engine.js\";\n\nconst LEGACY_NAMESPACE_CHILDREN = [\n  \"facts\",\n  \"corrections\",\n  \"entities\",\n  \"questions\",\n  \"artifacts\",\n  \"identity\",\n  \"state\",\n  \"config\",\n  \"summaries\",\n  \"procedures\",\n  // Issue #564 PR 3: reasoning_trace memories live in their own subtree.\n  // Must be included here so namespace migration moves existing traces\n  // into the target namespace root alongside other memory data.\n  \"reasoning-traces\",\n  \"profile.md\",\n] as const;\n\nexport interface NamespaceInventoryEntry {\n  namespace: string;\n  rootDir: string;\n  exists: boolean;\n  usesLegacyRoot: boolean;\n  hasMemoryData: boolean;\n  collection: string;\n}\n\nexport interface NamespaceVerifyReport {\n  ok: boolean;\n  problems: string[];\n  namespaces: NamespaceInventoryEntry[];\n}\n\nexport interface NamespaceMigrationMove {\n  from: string;\n  to: string;\n}\n\nexport interface NamespaceMigrationReport {\n  dryRun: boolean;\n  fromRoot: string;\n  targetRoot: string;\n  moved: NamespaceMigrationMove[];\n  collection: string;\n}\n\nasync function exists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function hasAnyLegacyData(rootDir: string): Promise<boolean> {\n  for (const child of LEGACY_NAMESPACE_CHILDREN) {\n    if (await exists(path.join(rootDir, child))) return true;\n  }\n  return false;\n}\n\nasync function discoverConfiguredNamespaces(\n  config: PluginConfig,\n): Promise<string[]> {\n  const discovered = new Set<string>([\n    config.defaultNamespace,\n    config.sharedNamespace,\n    ...config.namespacePolicies.map((policy) => policy.name),\n  ]);\n\n  const namespacesDir = path.join(config.memoryDir, \"namespaces\");\n  try {\n    const entries = await readdir(namespacesDir, { withFileTypes: true });\n    for (const entry of entries) {\n      if (entry.isDirectory() && isSafeRouteNamespace(entry.name)) {\n        discovered.add(entry.name);\n      }\n    }\n  } catch {\n    // No namespace directory yet.\n  }\n\n  return [...discovered];\n}\n\nexport async function listNamespaces(options: {\n  config: PluginConfig;\n  storageRouter?: NamespaceStorageRouter;\n}): Promise<NamespaceInventoryEntry[]> {\n  const storageRouter = options.storageRouter ?? new NamespaceStorageRouter(options.config);\n  const namespaces = await discoverConfiguredNamespaces(options.config);\n  const items = await Promise.all(\n    namespaces.map(async (namespace) => {\n      const storage = await storageRouter.storageFor(namespace);\n      const usesLegacyRoot =\n        namespace === options.config.defaultNamespace &&\n        storage.dir === options.config.memoryDir;\n      return {\n        namespace,\n        rootDir: storage.dir,\n        exists: await exists(storage.dir),\n        usesLegacyRoot,\n        hasMemoryData: await hasAnyLegacyData(storage.dir),\n        collection: namespaceCollectionName(options.config.qmdCollection, namespace, {\n          defaultNamespace: options.config.defaultNamespace,\n          useLegacyDefaultCollection: usesLegacyRoot,\n        }),\n      } satisfies NamespaceInventoryEntry;\n    }),\n  );\n\n  return items.sort((a, b) => a.namespace.localeCompare(b.namespace));\n}\n\nexport async function verifyNamespaces(options: {\n  config: PluginConfig;\n  storageRouter?: NamespaceStorageRouter;\n}): Promise<NamespaceVerifyReport> {\n  const namespaces = await listNamespaces(options);\n  const problems: string[] = [];\n\n  for (const entry of namespaces) {\n    if (entry.exists && !entry.hasMemoryData) {\n      problems.push(`${entry.namespace}: root exists but contains no Engram data`);\n    }\n  }\n\n  return {\n    ok: problems.length === 0,\n    problems,\n    namespaces,\n  };\n}\n\nexport async function runNamespaceMigration(options: {\n  config: PluginConfig;\n  to: string;\n  dryRun?: boolean;\n}): Promise<NamespaceMigrationReport> {\n  if (!options.config.namespacesEnabled) {\n    throw new Error(\"Namespaces are disabled.\");\n  }\n\n  const targetNamespace = options.to.trim();\n  if (!isSafeRouteNamespace(targetNamespace)) {\n    throw new Error(`Invalid namespace: ${options.to}`);\n  }\n\n  const targetRoot = path.join(options.config.memoryDir, \"namespaces\", targetNamespace);\n  const moved: NamespaceMigrationMove[] = [];\n\n  for (const child of LEGACY_NAMESPACE_CHILDREN) {\n    const from = path.join(options.config.memoryDir, child);\n    if (!(await exists(from))) continue;\n    const to = path.join(targetRoot, child);\n    if (await exists(to)) {\n      throw new Error(`Target already contains ${child}: ${to}`);\n    }\n    moved.push({ from, to });\n  }\n\n  if (!options.dryRun && moved.length > 0) {\n    await mkdir(targetRoot, { recursive: true });\n    for (const move of moved) {\n      await rename(move.from, move.to);\n    }\n  }\n\n  return {\n    dryRun: options.dryRun === true,\n    fromRoot: options.config.memoryDir,\n    targetRoot,\n    moved,\n    collection: namespaceCollectionName(options.config.qmdCollection, targetNamespace, {\n      defaultNamespace: options.config.defaultNamespace,\n      useLegacyDefaultCollection: false,\n    }),\n  };\n}\n"],"mappings":"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","names":["path","access","mkdir","readdir","path","access","mkdir","readdir"]}

package/dist/chunk-AJU4PJGY.js

@@ -0,0 +1,126 @@
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/extraction-judge-telemetry.ts
+import path from "path";
+import { appendFile, mkdir, readFile } from "fs/promises";
+var EXTRACTION_JUDGE_VERDICT_CATEGORY = "EXTRACTION_JUDGE_VERDICT";
+function judgeTelemetryPath(memoryDir) {
+  return path.join(
+    memoryDir,
+    "state",
+    "observation-ledger",
+    "extraction-judge-verdicts.jsonl"
+  );
+}
+async function recordJudgeVerdict(event, options) {
+  if (!options.enabled) return;
+  const filePath = judgeTelemetryPath(options.memoryDir);
+  try {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await appendFile(filePath, `${JSON.stringify(event)}
+`, "utf-8");
+  } catch (err) {
+    log.debug(
+      `extraction-judge-telemetry: append failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function readJudgeVerdictStats(memoryDir, opts = {}) {
+  const filePath = judgeTelemetryPath(memoryDir);
+  let raw;
+  try {
+    raw = await readFile(filePath, "utf-8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT") {
+      return {
+        total: 0,
+        accept: 0,
+        reject: 0,
+        defer: 0,
+        deferCapTriggered: 0,
+        meanElapsedMs: 0,
+        deferRate: 0,
+        malformed: 0
+      };
+    }
+    throw err;
+  }
+  let total = 0;
+  let accept = 0;
+  let reject = 0;
+  let defer = 0;
+  let deferCapTriggered = 0;
+  let elapsedSum = 0;
+  let malformed = 0;
+  let firstTs;
+  let lastTs;
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      malformed += 1;
+      continue;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      malformed += 1;
+      continue;
+    }
+    const p = parsed;
+    if (p.category !== EXTRACTION_JUDGE_VERDICT_CATEGORY) {
+      malformed += 1;
+      continue;
+    }
+    const ts = typeof p.ts === "string" ? p.ts : null;
+    if (ts === null) {
+      malformed += 1;
+      continue;
+    }
+    const tsMs = Date.parse(ts);
+    if (!Number.isFinite(tsMs)) {
+      malformed += 1;
+      continue;
+    }
+    if (typeof opts.sinceMs === "number" && tsMs < opts.sinceMs) continue;
+    if (typeof opts.untilMs === "number" && tsMs >= opts.untilMs) continue;
+    const kind = p.verdictKind;
+    if (kind === "accept") accept += 1;
+    else if (kind === "reject") reject += 1;
+    else if (kind === "defer") defer += 1;
+    else {
+      malformed += 1;
+      continue;
+    }
+    if (p.deferCapTriggered === true) deferCapTriggered += 1;
+    if (typeof p.elapsedMs === "number" && Number.isFinite(p.elapsedMs)) {
+      elapsedSum += p.elapsedMs;
+    }
+    total += 1;
+    if (firstTs === void 0 || ts < firstTs) firstTs = ts;
+    if (lastTs === void 0 || ts > lastTs) lastTs = ts;
+  }
+  return {
+    total,
+    accept,
+    reject,
+    defer,
+    deferCapTriggered,
+    meanElapsedMs: total > 0 ? elapsedSum / total : 0,
+    deferRate: total > 0 ? defer / total : 0,
+    firstTs,
+    lastTs,
+    malformed
+  };
+}
+
+export {
+  EXTRACTION_JUDGE_VERDICT_CATEGORY,
+  judgeTelemetryPath,
+  recordJudgeVerdict,
+  readJudgeVerdictStats
+};
+//# sourceMappingURL=chunk-AJU4PJGY.js.map

package/dist/chunk-AJU4PJGY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-judge-telemetry.ts"],"sourcesContent":["/**\n * Extraction Judge Telemetry (issue #562, PR 3).\n *\n * Appends one structured event per judge verdict to the observation ledger\n * under a dedicated JSONL file. The ledger is the same directory used by\n * the turn-count observation writer\n * (`state/observation-ledger/rebuilt-observations.jsonl`) but judge events\n * live in their own file so aggregation stays cheap and schemas do not\n * collide.\n *\n * Emit path is best-effort and fail-open: a telemetry write must never\n * block an extraction run.\n */\n\nimport path from \"node:path\";\nimport { appendFile, mkdir, readFile } from \"node:fs/promises\";\nimport { log } from \"./logger.js\";\nimport type { JudgeVerdictKind } from \"./extraction-judge.js\";\n\n/**\n * Observation-ledger category for judge verdict events. Callers that\n * aggregate across event kinds can filter on this constant.\n */\nexport const EXTRACTION_JUDGE_VERDICT_CATEGORY = \"EXTRACTION_JUDGE_VERDICT\";\n\n/**\n * Structured event written for every judge verdict (including verdicts\n * served from cache). The `version` field lets future readers upgrade the\n * schema without breaking older rows.\n */\nexport interface JudgeVerdictEvent {\n  version: 1;\n  category: typeof EXTRACTION_JUDGE_VERDICT_CATEGORY;\n  ts: string; // ISO-8601\n  verdictKind: JudgeVerdictKind;\n  /** Short free-text reason from the judge / deterministic fallback. */\n  reason: string;\n  /**\n   * How many times this candidate's content hash had already been deferred\n   * before this verdict. 0 for the first defer, 1 for the second, etc.\n   * Not applicable for non-defer kinds — emitted as 0.\n   */\n  deferrals: number;\n  /**\n   * Milliseconds between batch start and batch return (the whole\n   * `judgeFactDurability` call, shared across all verdicts in a single\n   * batch).\n   */\n  elapsedMs: number;\n  /** Candidate metadata for coarse filtering. */\n  candidateCategory: string;\n  confidence?: number;\n  /** SHA-256 of the (text\\0category) pair, same as the verdict-cache key. */\n  contentHash: string;\n  /** Whether the verdict came from the in-memory verdict cache. */\n  fromCache: boolean;\n  /**\n   * True when the judge forcibly converted a defer to reject because the\n   * defer cap was reached. Only set on cap-triggered rejects.\n   */\n  deferCapTriggered?: boolean;\n}\n\n/**\n * Options to control emit behavior. `enabled` gates all writes; when\n * false, `recordJudgeVerdict` is a no-op so callers can unconditionally\n * invoke it.\n */\nexport interface JudgeTelemetryOptions {\n  enabled: boolean;\n  memoryDir: string;\n}\n\nexport function judgeTelemetryPath(memoryDir: string): string {\n  return path.join(\n    memoryDir,\n    \"state\",\n    \"observation-ledger\",\n    \"extraction-judge-verdicts.jsonl\",\n  );\n}\n\n/**\n * Append a single verdict event as a JSONL row. Fails open — if the write\n * cannot be completed (directory missing, permissions, disk full), the\n * error is logged at debug level and swallowed so extraction never fails\n * because of telemetry.\n */\nexport async function recordJudgeVerdict(\n  event: JudgeVerdictEvent,\n  options: JudgeTelemetryOptions,\n): Promise<void> {\n  if (!options.enabled) return;\n  const filePath = judgeTelemetryPath(options.memoryDir);\n  try {\n    await mkdir(path.dirname(filePath), { recursive: true });\n    await appendFile(filePath, `${JSON.stringify(event)}\\n`, \"utf-8\");\n  } catch (err) {\n    log.debug(\n      `extraction-judge-telemetry: append failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\n/**\n * Aggregate statistics over the verdict ledger, optionally restricted to a\n * time window. Returns zero-count stats when the ledger is missing or\n * empty — callers do not need to special-case a cold install.\n */\nexport interface JudgeVerdictStats {\n  total: number;\n  accept: number;\n  reject: number;\n  defer: number;\n  deferCapTriggered: number;\n  /** Mean elapsed milliseconds across all events in the window. */\n  meanElapsedMs: number;\n  /** Defer rate as `defer / total`, in `[0, 1]`. `0` when total is 0. */\n  deferRate: number;\n  /** First and last event timestamps observed in the window. */\n  firstTs?: string;\n  lastTs?: string;\n  /** Number of rows skipped because they were malformed or wrong shape. */\n  malformed: number;\n}\n\n/**\n * Read and aggregate events from the verdict ledger.\n *\n * `sinceMs` / `untilMs` bound by `ts` parse — events with unparseable\n * timestamps are counted toward `malformed`. The upper bound is exclusive\n * (`ts < untilMs`), per CLAUDE.md gotcha 35.\n */\nexport async function readJudgeVerdictStats(\n  memoryDir: string,\n  opts: { sinceMs?: number; untilMs?: number } = {},\n): Promise<JudgeVerdictStats> {\n  const filePath = judgeTelemetryPath(memoryDir);\n  let raw: string;\n  try {\n    raw = await readFile(filePath, \"utf-8\");\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    if (code === \"ENOENT\") {\n      return {\n        total: 0,\n        accept: 0,\n        reject: 0,\n        defer: 0,\n        deferCapTriggered: 0,\n        meanElapsedMs: 0,\n        deferRate: 0,\n        malformed: 0,\n      };\n    }\n    throw err;\n  }\n\n  let total = 0;\n  let accept = 0;\n  let reject = 0;\n  let defer = 0;\n  let deferCapTriggered = 0;\n  let elapsedSum = 0;\n  let malformed = 0;\n  let firstTs: string | undefined;\n  let lastTs: string | undefined;\n\n  for (const line of raw.split(\"\\n\")) {\n    if (!line.trim()) continue;\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line);\n    } catch {\n      malformed += 1;\n      continue;\n    }\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      Array.isArray(parsed)\n    ) {\n      malformed += 1;\n      continue;\n    }\n    const p = parsed as Record<string, unknown>;\n    if (p.category !== EXTRACTION_JUDGE_VERDICT_CATEGORY) {\n      malformed += 1;\n      continue;\n    }\n    const ts = typeof p.ts === \"string\" ? p.ts : null;\n    if (ts === null) {\n      malformed += 1;\n      continue;\n    }\n    const tsMs = Date.parse(ts);\n    if (!Number.isFinite(tsMs)) {\n      malformed += 1;\n      continue;\n    }\n    if (typeof opts.sinceMs === \"number\" && tsMs < opts.sinceMs) continue;\n    if (typeof opts.untilMs === \"number\" && tsMs >= opts.untilMs) continue;\n\n    const kind = p.verdictKind;\n    if (kind === \"accept\") accept += 1;\n    else if (kind === \"reject\") reject += 1;\n    else if (kind === \"defer\") defer += 1;\n    else {\n      malformed += 1;\n      continue;\n    }\n\n    if (p.deferCapTriggered === true) deferCapTriggered += 1;\n    if (typeof p.elapsedMs === \"number\" && Number.isFinite(p.elapsedMs)) {\n      elapsedSum += p.elapsedMs;\n    }\n    total += 1;\n    if (firstTs === undefined || ts < firstTs) firstTs = ts;\n    if (lastTs === undefined || ts > lastTs) lastTs = ts;\n  }\n\n  return {\n    total,\n    accept,\n    reject,\n    defer,\n    deferCapTriggered,\n    meanElapsedMs: total > 0 ? elapsedSum / total : 0,\n    deferRate: total > 0 ? defer / total : 0,\n    firstTs,\n    lastTs,\n    malformed,\n  };\n}\n"],"mappings":"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","names":[]}