@sdotwinter/openclaw-deterministic 0.18.1 → 0.19.0

package/bin/install.js

@@ -26,6 +26,15 @@ const OVERLAY_BLOCK = `
 This system loads and adheres to SOUL.deterministic.md as a governing philosophical constraint.
 `.trim();
 
+
+const MEMORY_RULES_BLOCK = `
+## Memory Write Triggers
+
+When to write to each tier:
+- **memory/working/** - During active incident investigation, before root cause confirmed
+- **memory/episodic/** - After fix confirmed, root cause known
+- **memory/semantic/** - Never (handled by memory-compactor skill)
+`.trim();
 // -----------------------------
 // Paths
 // -----------------------------
@@ -171,6 +180,28 @@ function installConfigIfMissing() {
   console.log(`Installed: ${target.config}`);
 }
 
+function appendMemoryRulesToSoul() {
+  if (!exists(target.soul)) {
+    console.log("No SOUL.md found — skipping memory rules.");
+    return;
+  }
+
+  const content = read(target.soul);
+  if (content.includes("Memory Write Triggers")) {
+    console.log("Memory rules already present in SOUL.md — skipping.");
+    return;
+  }
+
+  console.log("Appending memory write rules to SOUL.md...");
+  if (DRY_RUN) {
+    console.log("[DRY-RUN] Would append memory rules to SOUL.md.");
+    return;
+  }
+
+  fs.appendFileSync(target.soul, "\n" + MEMORY_RULES_BLOCK + "\n");
+  console.log("Updated: SOUL.md with memory write rules");
+}
+
 function bootstrapSoulIfMissing() {
   if (exists(target.soul)) {
     console.log("User SOUL.md exists — NOT modified.");
@@ -224,6 +255,7 @@ if (!DRY_RUN) {
 installTemplates();
 installConfigIfMissing();
 bootstrapSoulIfMissing();
+appendMemoryRulesToSoul();
 
 if (DRY_RUN) {
   console.log("\nDry-run complete. No changes were written.\n");

package/bin/upgrade.js

@@ -8,6 +8,15 @@ const args = process.argv.slice(2);
 const DRY_RUN = args.includes("--dry-run");
 const FORCE = args.includes("--force");
 
+
+const MEMORY_RULES_BLOCK = `
+## Memory Write Triggers
+
+When to write to each tier:
+- **memory/working/** - During active incident investigation, before root cause confirmed
+- **memory/episodic/** - After fix confirmed, root cause known
+- **memory/semantic/** - Never (handled by memory-compactor skill)
+`.trim();
 const pkg = require(path.join(__dirname, "..", "package.json"));
 const CLI_VERSION = pkg.version;
 
@@ -21,7 +30,7 @@ const HASH_REGEX = /Canonical-Hash:\s*SHA256:([a-f0-9]+)/;
 const files = [
   "OPERATING_RULES.md",
   "SOUL.deterministic.md",
-  "skills/memory-compactor/SKILL.md",
+  "memory-compactor.SKILL.md",
 ];
 
 function exists(p) {
@@ -134,6 +143,30 @@ if (!exists(workspace)) {
   process.exit(1);
 }
 
+
+function appendMemoryRulesToSoul() {
+  const soulPath = path.join(workspace, "SOUL.md");
+  if (!exists(soulPath)) {
+    console.log("No SOUL.md found — skipping memory rules.");
+    return;
+  }
+
+  const content = fs.readFileSync(soulPath, "utf8");
+  if (content.includes("Memory Write Triggers")) {
+    console.log("Memory rules already present — skipping.");
+    return;
+  }
+
+  console.log("Appending memory write rules to SOUL.md...");
+  if (DRY_RUN) {
+    console.log("[DRY-RUN] Would append memory rules.");
+    return;
+  }
+
+  fs.appendFileSync(soulPath, "\n" + MEMORY_RULES_BLOCK + "\n");
+  console.log("Updated: SOUL.md with memory write rules");
+}
+
 console.log(`\nRunning deterministic upgrade → v${CLI_VERSION}\n`);
 
 for (const rel of files) {
@@ -143,6 +176,7 @@ for (const rel of files) {
 if (DRY_RUN) {
   console.log("\nDry-run complete. No changes written.\n");
 } else {
+  appendMemoryRulesToSoul();
   console.log("\nUpgrade complete.\n");
 }
 

package/package.json

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

package/templates/SOUL.deterministic.md

@@ -56,3 +56,10 @@ Rules:
 - Routine status checks must NOT generate memory.
 - Memory entries must follow structured schema.
 - Determinism applies to memory generation.
+
+## Memory Write Triggers
+
+When to write to each tier:
+- **memory/working/** - During active incident investigation, before root cause confirmed
+- **memory/episodic/** - After fix confirmed, root cause known
+- **memory/semantic/** - Never (handled by memory-compactor skill)