@sdotwinter/openclaw-deterministic 0.17.8 → 0.17.10

package/README.md

@@ -14,19 +14,39 @@ It is a governance layer.
 
 Install globally:
 
+```bash
 npm install -g @sdotwinter/openclaw-deterministic
+```
+
+Add to your PATH (optional but recommended):
+
+```bash
+export PATH="$PATH:$(npm root -g)/@sdotwinter/openclaw-deterministic/bin"
+```
+
+Or create a symlink:
+
+```bash
+sudo ln -s $(npm root -g)/@sdotwinter/openclaw-deterministic/bin/oc-deterministic /usr/local/bin/
+```
 
 Apply deterministic governance to an existing OpenClaw workspace:
 
+```bash
 oc-deterministic install
+```
 
 Verify installation:
 
+```bash
 oc-deterministic doctor
+```
 
 Concise health summary (CI-friendly):
 
+```bash
 oc-deterministic status
+```
 
 ---
 
@@ -156,12 +176,17 @@ Configuration file:
 
 Example:
 
+```json
 {
   "semantic": {
     "HARD_LIMIT": 1200,
     "RISK_THRESHOLD_PERCENT": 85
+  },
+  "governance": {
+    "violation_logging": true
   }
 }
+```
 
 This prevents uncontrolled memory expansion.
 

package/bin/revert.js

@@ -46,10 +46,20 @@ function restoreDirectoryRecursive(srcDir, destDir) {
 }
 
 function restoreBackup(timestamp) {
+  // Validate timestamp format (ISO-like: YYYY-MM-DDTHH-MM-SS.mmmZ)
+  const timestampRegex = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}\.\d{3}Z$/;
+  if (!timestampRegex.test(timestamp)) {
+    console.error(`Invalid timestamp format: ${timestamp}`);
+    console.error("Expected format: 2026-02-21T04-43-51.094Z");
+    console.error("Use 'oc-deterministic revert --list' to see available backups.");
+    process.exit(1);
+  }
+
   const backupDir = path.join(BACKUP_ROOT, timestamp);
 
   if (!fs.existsSync(backupDir)) {
-    console.log("Backup not found.");
+    console.error(`Backup not found: ${timestamp}`);
+    console.error("Use 'oc-deterministic revert --list' to see available backups.");
     process.exit(1);
   }
 

package/index.js

@@ -0,0 +1,13 @@
+// OpenClaw Deterministic - Entry point
+// Re-exports CLI for programmatic use
+
+module.exports = {
+  doctor: require("./bin/doctor"),
+  status: require("./bin/status"),
+  install: require("./bin/install"),
+  init: require("./bin/init"),
+  enable: require("./bin/enable"),
+  revert: require("./bin/revert"),
+  audit: require("./bin/audit"),
+  upgrade: require("./bin/upgrade"),
+};

package/package.json

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

package/templates/config/.deterministic.json

@@ -4,7 +4,6 @@
     "RISK_THRESHOLD_PERCENT": 85
   },
   "governance": {
-    "strict_mode": false,
     "violation_logging": true
   }
 }