@remnic/core 1.1.1 → 1.1.3

package/dist/{chunk-B5WXLVDY.js → chunk-7GCMLT7J.js}

@@ -1,13 +1,13 @@
 import {
   runConsolidationProvenanceCheck
-} from "./chunk-ULYOGL6R.js";
+} from "./chunk-5HRY2WRF.js";
 import {
   reportBufferSurpriseDistribution
 } from "./chunk-ASAITVLA.js";
 import {
   NamespaceStorageRouter,
   namespaceCollectionName
-} from "./chunk-7I7FKFZH.js";
+} from "./chunk-R2L7SUX2.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -16,11 +16,6 @@ import {
 import {
   resolveRemnicPluginEntry
 } from "./chunk-U66YHYC7.js";
-import {
-  resolveCuratedIncludeFilesStatePath,
-  resolveNativeKnowledgeStatePath,
-  resolveOpenClawWorkspaceStatePath
-} from "./chunk-7SEAZFFB.js";
 import {
   createEvalBaselineSnapshot,
   getEvalHarnessStatus,
@@ -29,28 +24,36 @@ import {
   validateEvalBenchmarkPack
 } from "./chunk-K6WK37A6.js";
 import {
-  parseConfig
-} from "./chunk-BK2EFTE2.js";
+  readJudgeVerdictStats
+} from "./chunk-AJU4PJGY.js";
 import {
-  analyzeGraphHealth
-} from "./chunk-C2EFFULQ.js";
+  resolveCuratedIncludeFilesStatePath,
+  resolveNativeKnowledgeStatePath,
+  resolveOpenClawWorkspaceStatePath
+} from "./chunk-7SEAZFFB.js";
 import {
-  readEnvVar,
-  resolveHomeDir
-} from "./chunk-MARWOCVP.js";
+  parseConfig
+} from "./chunk-JWSENLQI.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-3OGMS3PE.js";
+} from "./chunk-LZRYQK6L.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-2LGMW3DJ.js";
+import {
+  analyzeGraphHealth
+} from "./chunk-RK2Y4XOM.js";
 import {
   StorageManager
-} from "./chunk-F5VP6YCB.js";
+} from "./chunk-DCE6SQLA.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
+import {
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-MARWOCVP.js";
 
 // src/operator-toolkit.ts
 import path2 from "path";
@@ -183,6 +186,12 @@ async function runNamespaceMigration(options) {
 }
 
 // src/operator-toolkit.ts
+function isMissingPathError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function formatUnknownError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 function resolveConfigPath(explicitPath) {
   if (explicitPath && explicitPath.trim().length > 0) return explicitPath.trim();
   const configured = readEnvVar("OPENCLAW_ENGRAM_CONFIG_PATH") || readEnvVar("OPENCLAW_CONFIG_PATH");
@@ -407,7 +416,7 @@ function removeManagedCaptureInstructions(existing) {
 async function runOperatorSetup(options) {
   const now = options.now ?? /* @__PURE__ */ new Date();
   const configStatus = await loadCliPluginConfig(options.configPath);
-  const storage = new StorageManager(options.orchestrator.config.memoryDir);
+  const storage = options.orchestrator.storage;
   await storage.ensureDirectories();
   await mkdir2(options.orchestrator.config.workspaceDir, { recursive: true });
   const qmdAvailable = await options.orchestrator.qmd.probe();
@@ -684,6 +693,7 @@ async function runOperatorDoctor(options) {
   const configStatus = await loadCliPluginConfig(options.configPath);
   const checks = [];
   const config = options.orchestrator.config;
+  const storage = options.orchestrator.storage;
   const configReview = await buildOperatorConfigReviewReport({
     now,
     configStatus,
@@ -734,7 +744,7 @@ async function runOperatorDoctor(options) {
     remediation: conversationIndex.enabled && conversationIndex.status !== "ok" ? "Run `openclaw engram rebuild-index` to refresh the conversation index artifacts." : void 0,
     details: conversationIndex
   });
-  const meta = await new StorageManager(config.memoryDir).loadMeta();
+  const meta = await storage.loadMeta();
   checks.push({
     key: "maintenance",
     status: meta.lastExtractionAt || meta.lastConsolidationAt ? "ok" : "warn",
@@ -752,11 +762,13 @@ async function runOperatorDoctor(options) {
     details: nativeKnowledgeStatus
   });
   const agentAccessEnabled = config.agentAccessHttp?.enabled === true;
+  const rawAuthToken = config.agentAccessHttp?.authToken;
+  const authTokenConfigured = typeof rawAuthToken === "string" && rawAuthToken.length > 0 || rawAuthToken !== null && typeof rawAuthToken === "object" && typeof rawAuthToken.source === "string";
   checks.push({
     key: "access_http_auth",
-    status: !agentAccessEnabled ? "warn" : config.agentAccessHttp?.authToken ? "ok" : "error",
-    summary: !agentAccessEnabled ? "Agent access HTTP bridge is disabled." : config.agentAccessHttp?.authToken ? "Agent access HTTP bridge has an auth token configured." : "Agent access HTTP bridge is enabled without an auth token.",
-    remediation: !agentAccessEnabled ? "Ignore unless you plan to enable the HTTP bridge." : config.agentAccessHttp?.authToken ? void 0 : "Set `agentAccessHttp.authToken` before exposing the bridge."
+    status: !agentAccessEnabled ? "warn" : authTokenConfigured ? "ok" : "error",
+    summary: !agentAccessEnabled ? "Agent access HTTP bridge is disabled." : authTokenConfigured ? "Agent access HTTP bridge has an auth token configured." : "Agent access HTTP bridge is enabled without an auth token.",
+    remediation: !agentAccessEnabled ? "Ignore unless you plan to enable the HTTP bridge." : authTokenConfigured ? void 0 : "Set `agentAccessHttp.authToken` before exposing the bridge."
   });
   const warnings = config.fileHygiene?.lintEnabled ? await lintWorkspaceFiles({
     workspaceDir: config.workspaceDir,
@@ -765,12 +777,16 @@ 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 summarizeMemoryWorthLegacyCounters(storage));
   checks.push(
-    await summarizeBufferSurpriseDistribution(new StorageManager(config.memoryDir), config)
+    await summarizeBufferSurpriseDistribution(storage, config)
   );
-  checks.push(await summarizeConsolidationProvenance(new StorageManager(config.memoryDir), config));
+  checks.push(await summarizeConsolidationProvenance(storage, config));
+  checks.push(await summarizeGraphEdgeDecayStatus(config));
+  checks.push(await summarizeTierDistribution(options.orchestrator.storage));
+  checks.push(await summarizeDreamsPhases(config, storage));
   checks.push(summarizeSecurityMitigations(config));
+  checks.push(await summarizeObservationThroughput(config.memoryDir));
   const summary = checks.reduce(
     (acc, check) => {
       acc[check.status] += 1;
@@ -869,6 +885,167 @@ async function summarizeBufferSurpriseDistribution(storage, config) {
     };
   }
 }
+async function summarizeGraphEdgeDecayStatus(config) {
+  const { readGraphEdgeDecayStatus } = await import("./graph-edge-decay-PWB63GRE.js");
+  const enabled = config.graphEdgeDecayEnabled === true;
+  if (!enabled) {
+    return {
+      key: "graph_edge_decay",
+      status: "ok",
+      summary: "Graph-edge decay maintenance is disabled (graphEdgeDecayEnabled = false).",
+      remediation: "Set graphEdgeDecayEnabled = true to opt into the periodic decay job (issue #681).",
+      details: { enabled: false }
+    };
+  }
+  const status = await readGraphEdgeDecayStatus(config.memoryDir);
+  if (!status) {
+    return {
+      key: "graph_edge_decay",
+      status: "warn",
+      summary: "Graph-edge decay is enabled but has not run yet (no status file present).",
+      remediation: "Trigger the cron, run `engram.graph_edge_decay_run` via MCP, or wait for the scheduled cadence to fire.",
+      details: { enabled: true, lastRun: null, cadenceMs: config.graphEdgeDecayCadenceMs }
+    };
+  }
+  return {
+    key: "graph_edge_decay",
+    status: "ok",
+    summary: `Graph-edge decay last ran at ${status.ranAt} (${status.edgesDecayed}/${status.edgesTotal} edges decayed, ${status.edgesBelowVisibilityThreshold} below visibility threshold).`,
+    details: {
+      enabled: true,
+      lastRun: status.ranAt,
+      durationMs: status.durationMs,
+      edgesTotal: status.edgesTotal,
+      edgesDecayed: status.edgesDecayed,
+      edgesBelowVisibilityThreshold: status.edgesBelowVisibilityThreshold,
+      topDecayedEntities: status.topDecayedEntities,
+      cadenceMs: config.graphEdgeDecayCadenceMs
+    }
+  };
+}
+async function summarizeTierDistribution(storage) {
+  try {
+    const { summarizeTiers } = await import("./tier-stats-62ZVDFKS.js");
+    const summary = await summarizeTiers(storage);
+    const storageDir = storage.dir ?? "";
+    const journalPath = storageDir.length > 0 ? path2.join(storageDir, "state", "tier-migration-journal.jsonl") : null;
+    let recentMigrations = 0;
+    const demotionReasons = {};
+    const sevenDaysAgoMs = Date.now() - 7 * 864e5;
+    if (journalPath) {
+      try {
+        const { readFile: readFile2 } = await import("fs/promises");
+        const raw = await readFile2(journalPath, "utf-8");
+        for (const line of raw.split("\n")) {
+          const trimmed = line.trim();
+          if (trimmed.length === 0) continue;
+          try {
+            const entry = JSON.parse(trimmed);
+            const tsMs = entry.ts ? Date.parse(entry.ts) : NaN;
+            if (Number.isFinite(tsMs) && tsMs >= sevenDaysAgoMs && entry.changed === true) {
+              recentMigrations += 1;
+              if (entry.fromTier === "hot" && entry.toTier === "cold" && typeof entry.reason === "string") {
+                const reason = entry.reason;
+                demotionReasons[reason] = (demotionReasons[reason] ?? 0) + 1;
+              }
+            }
+          } catch {
+          }
+        }
+      } catch {
+      }
+    }
+    const topDemotionReasons = Object.entries(demotionReasons).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 5).map(([reason, count]) => ({ reason, count }));
+    const statusParts = Object.entries(summary.byStatus).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 6).map(([s, n]) => `${s}: ${n}`).join(", ");
+    return {
+      key: "tier_distribution",
+      status: "ok",
+      summary: `Tier distribution: hot=${summary.byTier.hot}, cold=${summary.byTier.cold}` + (summary.forgottenCount > 0 ? `, forgotten=${summary.forgottenCount}` : "") + `. Total: ${summary.total}.` + (recentMigrations > 0 ? ` Recent migrations (7d): ${recentMigrations}.` : ""),
+      details: {
+        total: summary.total,
+        byTier: summary.byTier,
+        byStatus: summary.byStatus,
+        forgottenCount: summary.forgottenCount,
+        statusSummary: statusParts,
+        recentMigrations,
+        topDemotionReasons
+      }
+    };
+  } catch (err) {
+    return {
+      key: "tier_distribution",
+      status: "ok",
+      summary: "Tier distribution unavailable \u2014 could not enumerate memories.",
+      details: { error: String(err) }
+    };
+  }
+}
+async function summarizeDreamsPhases(config, storage = new StorageManager(config.memoryDir)) {
+  const phases = config.dreamsPhases;
+  const meta = await storage.loadMeta();
+  let deepSleepLastRun = null;
+  let deepSleepLastRunWarning = null;
+  try {
+    const runsDir = path2.join(config.memoryDir, "state", "memory-governance", "runs");
+    const runIds = (await readdir2(runsDir)).sort().reverse();
+    if (runIds.length > 0) {
+      const latestRunId = runIds[0];
+      const manifestPath = path2.join(
+        runsDir,
+        latestRunId,
+        "manifest.json"
+      );
+      const raw = await readFile(manifestPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.createdAt === "string" && parsed.createdAt.length > 0) {
+        deepSleepLastRun = parsed.createdAt;
+      }
+    }
+  } catch (error) {
+    if (!isMissingPathError(error)) {
+      deepSleepLastRunWarning = `Could not read latest governance run manifest: ${formatUnknownError(error)}`;
+    }
+  }
+  const phaseLines = [
+    `lightSleep: enabled=${phases.lightSleep.enabled}, cadenceMs=${phases.lightSleep.cadenceMs}, promoteHeat=${phases.lightSleep.promoteHeatThreshold}, staleDecay=${phases.lightSleep.staleDecayThreshold}, archiveDecay=${phases.lightSleep.archiveDecayThreshold}, filterStale=${phases.lightSleep.filterStaleEnabled}, lastRun=${meta.lastExtractionAt ?? "never"}`,
+    `rem: enabled=${phases.rem.enabled}, cadenceMs=${phases.rem.cadenceMs}, similarity=${phases.rem.similarityThreshold}, minCluster=${phases.rem.minClusterSize}, maxPerRun=${phases.rem.maxPerRun}, minIntervalMs=${phases.rem.minIntervalMs}, lastRun=${meta.lastConsolidationAt ?? "never"}`,
+    `deepSleep: enabled=${phases.deepSleep.enabled}, cadenceMs=${phases.deepSleep.cadenceMs}, versioning=${phases.deepSleep.versioningEnabled}, versioningMaxPerPage=${phases.deepSleep.versioningMaxPerPage}, lastRun=${deepSleepLastRun ?? "never"}`
+  ];
+  return {
+    key: "dreams_phases",
+    status: deepSleepLastRunWarning ? "warn" : "ok",
+    summary: `Dreams pipeline phases: ${phaseLines.join("; ")}${deepSleepLastRunWarning ? `; ${deepSleepLastRunWarning}` : ""}`,
+    remediation: deepSleepLastRunWarning ? "Inspect state/memory-governance/runs and repair or remove unreadable governance run artifacts." : void 0,
+    details: {
+      lightSleep: {
+        enabled: phases.lightSleep.enabled,
+        cadenceMs: phases.lightSleep.cadenceMs,
+        promoteHeatThreshold: phases.lightSleep.promoteHeatThreshold,
+        staleDecayThreshold: phases.lightSleep.staleDecayThreshold,
+        archiveDecayThreshold: phases.lightSleep.archiveDecayThreshold,
+        filterStaleEnabled: phases.lightSleep.filterStaleEnabled,
+        lastRun: meta.lastExtractionAt ?? null
+      },
+      rem: {
+        enabled: phases.rem.enabled,
+        cadenceMs: phases.rem.cadenceMs,
+        similarityThreshold: phases.rem.similarityThreshold,
+        minClusterSize: phases.rem.minClusterSize,
+        maxPerRun: phases.rem.maxPerRun,
+        minIntervalMs: phases.rem.minIntervalMs,
+        lastRun: meta.lastConsolidationAt ?? null
+      },
+      deepSleep: {
+        enabled: phases.deepSleep.enabled,
+        cadenceMs: phases.deepSleep.cadenceMs,
+        versioningEnabled: phases.deepSleep.versioningEnabled,
+        versioningMaxPerPage: phases.deepSleep.versioningMaxPerPage,
+        lastRun: deepSleepLastRun,
+        warning: deepSleepLastRunWarning
+      }
+    }
+  };
+}
 function summarizeSecurityMitigations(config) {
   const budgetEnabled = config.recallCrossNamespaceBudgetEnabled === true;
   const anomalyEnabled = config.recallAuditAnomalyDetectionEnabled === true;
@@ -911,6 +1088,46 @@ function summarizeSecurityMitigations(config) {
     details: { ...details, configOnly: true }
   };
 }
+async function summarizeObservationThroughput(memoryDir) {
+  try {
+    const stats = await readJudgeVerdictStats(memoryDir);
+    if (stats.total === 0) {
+      return {
+        key: "observations",
+        status: "ok",
+        summary: "No observations recorded yet (extraction-judge telemetry ledger is empty or missing).",
+        details: { total: 0, accept: 0, reject: 0, defer: 0, lastObservedAt: null }
+      };
+    }
+    const acceptPct = (stats.accept / stats.total * 100).toFixed(1);
+    const rejectPct = (stats.reject / stats.total * 100).toFixed(1);
+    const deferPct = (stats.defer / stats.total * 100).toFixed(1);
+    return {
+      key: "observations",
+      status: "ok",
+      summary: `${stats.total} observations recorded: accept=${acceptPct}%, reject=${rejectPct}%, defer=${deferPct}%. Last observed: ${stats.lastTs ?? "unknown"}.`,
+      details: {
+        total: stats.total,
+        accept: stats.accept,
+        reject: stats.reject,
+        defer: stats.defer,
+        deferCapTriggered: stats.deferCapTriggered,
+        deferRate: stats.deferRate,
+        meanElapsedMs: stats.meanElapsedMs,
+        firstObservedAt: stats.firstTs ?? null,
+        lastObservedAt: stats.lastTs ?? null
+      }
+    };
+  } catch (err) {
+    return {
+      key: "observations",
+      status: "warn",
+      summary: "Could not read observation telemetry ledger.",
+      remediation: "Retry `remnic doctor` after ensuring the memory state directory is readable.",
+      details: { error: String(err) }
+    };
+  }
+}
 async function summarizeConsolidationProvenance(storage, config) {
   let report;
   try {
@@ -1223,9 +1440,12 @@ export {
   runOperatorDoctor,
   summarizeMemoryWorthLegacyCounters,
   summarizeBufferSurpriseDistribution,
+  summarizeTierDistribution,
+  summarizeDreamsPhases,
+  summarizeObservationThroughput,
   summarizeConsolidationProvenance,
   runOperatorInventory,
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-B5WXLVDY.js.map
+//# sourceMappingURL=chunk-7GCMLT7J.js.map