@sdotwinter/openclaw-deterministic 0.9.0 → 0.11.0

package/bin/doctor.js

@@ -12,6 +12,17 @@ const HOME = process.env.HOME;
 const openclawRoot = path.join(HOME, ".openclaw");
 const workspace = path.join(openclawRoot, "workspace");
 
+const DEFAULT_HARD_LIMIT = 1200;
+const DEFAULT_RISK_THRESHOLD = 1020;
+
+const episodicLogPath = path.join(
+  openclawRoot,
+  "workspace",
+  "memory",
+  "episodic",
+  "governance-log.md"
+);
+
 const files = {
   operating: path.join(workspace, "OPERATING_RULES.md"),
   detSoul: path.join(workspace, "SOUL.deterministic.md"),
@@ -32,6 +43,18 @@ function read(p) {
   return fs.readFileSync(p, "utf8");
 }
 
+function appendGovernanceEvent(event) {
+  try {
+    const timestamp = new Date().toISOString();
+    const entry = `\n---\nTime: ${timestamp}\nType: ${event.type}\nDetails: ${event.details}\n---\n`;
+
+    fs.mkdirSync(path.dirname(episodicLogPath), { recursive: true });
+    fs.appendFileSync(episodicLogPath, entry);
+  } catch {
+    // Logging must never crash doctor
+  }
+}
+
 function versionFromFile(content) {
   const match = content.match(/Installed by openclaw-deterministic v([0-9.]+)/);
   return match ? match[1] : null;
@@ -77,6 +100,20 @@ function evaluateVersion(filePath) {
   return { status: "mismatch", version };
 }
 
+function parseHardLimit() {
+  if (!exists(files.compactor)) return null;
+  const content = read(files.compactor);
+  const match = content.match(/HARD_LIMIT[^0-9]*([0-9]+)/);
+  return match ? parseInt(match[1], 10) : null;
+}
+
+function parseRiskThreshold() {
+  if (!exists(files.compactor)) return null;
+  const content = read(files.compactor);
+  const match = content.match(/RISK_THRESHOLD[^0-9]*([0-9]+)/);
+  return match ? parseInt(match[1], 10) : null;
+}
+
 function evaluate() {
   const result = {
     cliVersion: pkg.version,
@@ -86,6 +123,13 @@ function evaluate() {
     overlayEnabled: false,
     semanticTokens: 0,
     semanticStatus: "safe",
+    limits: {
+      hardLimitConfigured: null,
+      riskThresholdConfigured: null,
+      hardLimitDefault: DEFAULT_HARD_LIMIT,
+      riskThresholdDefault: DEFAULT_RISK_THRESHOLD,
+      coherent: true,
+    },
   };
 
   if (!result.openclawDetected || !result.workspaceDetected) {
@@ -101,9 +145,26 @@ function evaluate() {
   const tokens = estimateSemanticTokens();
   result.semanticTokens = tokens;
 
-  if (tokens > 1200) {
+  const hardLimit = parseHardLimit();
+  const riskThreshold = parseRiskThreshold();
+
+  result.limits.hardLimitConfigured = hardLimit;
+  result.limits.riskThresholdConfigured = riskThreshold;
+
+  if (hardLimit && hardLimit !== DEFAULT_HARD_LIMIT) {
+    result.limits.coherent = false;
+  }
+
+  if (riskThreshold && riskThreshold !== DEFAULT_RISK_THRESHOLD) {
+    result.limits.coherent = false;
+  }
+
+  const effectiveHardLimit = hardLimit || DEFAULT_HARD_LIMIT;
+  const effectiveRiskThreshold = riskThreshold || DEFAULT_RISK_THRESHOLD;
+
+  if (tokens > effectiveHardLimit) {
     result.semanticStatus = "hard-limit-exceeded";
-  } else if (tokens > 1020) {
+  } else if (tokens > effectiveRiskThreshold) {
     result.semanticStatus = "risk-threshold";
   } else {
     result.semanticStatus = "safe";
@@ -135,12 +196,18 @@ function printHuman(result) {
 
     if (info.status === "missing") {
       console.log(`❌ ${label} missing.`);
+      appendGovernanceEvent({ type: "file-missing", details: label });
     } else if (info.status === "no-stamp") {
       console.log(`⚠ ${label} version stamp missing.`);
+      appendGovernanceEvent({ type: "no-version-stamp", details: label });
     } else if (info.status === "mismatch") {
       console.log(
         `⚠ ${label} version mismatch (installed ${info.version}, CLI ${pkg.version})`
       );
+      appendGovernanceEvent({
+        type: "version-mismatch",
+        details: `${label} installed ${info.version}, CLI ${pkg.version}`,
+      });
     } else {
       console.log(`✅ ${label} version matches CLI (${info.version})`);
     }
@@ -153,12 +220,24 @@ function printHuman(result) {
       : "⚠ Deterministic overlay NOT enabled in SOUL.md."
   );
 
+  if (!result.limits.coherent) {
+    console.log("⚠ Threshold configuration drift detected in SKILL.md.");
+    appendGovernanceEvent({
+      type: "threshold-drift",
+      details: `HARD_LIMIT=${result.limits.hardLimitConfigured}, RISK_THRESHOLD=${result.limits.riskThresholdConfigured}`,
+    });
+  }
+
   console.log(`\nSemantic memory tokens (est): ${result.semanticTokens}`);
 
   if (result.semanticStatus === "hard-limit-exceeded") {
-    console.log("❌ Semantic memory exceeds HARD_LIMIT (1200).");
+    console.log("❌ Semantic memory exceeds HARD_LIMIT.");
+    appendGovernanceEvent({
+      type: "semantic-hard-limit-exceeded",
+      details: `Tokens=${result.semanticTokens}`,
+    });
   } else if (result.semanticStatus === "risk-threshold") {
-    console.log("⚠ Semantic memory above risk threshold (1020).");
+    console.log("⚠ Semantic memory above risk threshold.");
   } else {
     console.log("✅ Semantic memory within safe bounds.");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdotwinter/openclaw-deterministic",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Deterministic governance and memory compaction layer for OpenClaw",
   "keywords": [
     "openclaw",