@ouro.bot/cli 0.1.0-alpha.977 → 0.1.0-alpha.978

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.978",
+      "changes": [
+        "Psyche edits now take effect on the next turn for every agent. Each prompt build compares the content of the psyche and house files with the cached copy and rereads on any change, so an edit by the agent, its owner or a sync pull no longer waits for a restart. Content is compared rather than mtimes, which FUSE shares such as Unraid's do not always update."
+      ]
+    },
     {
       "version": "0.1.0-alpha.977",
       "changes": [

package/deploy/unraid/sanctuary.ouro/bundle-meta.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.977",
+  "runtimeVersion": "0.1.0-alpha.978",
   "bundleSchemaVersion": 3,
   "lastUpdated": "2026-09-03T00:00:00.000Z"
 }

package/deploy/unraid/sanctuary.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <Container version="2">
   <Name>ouro-butler</Name>
-  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.977</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.978</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/mind/prompt.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.flattenSystemPrompt = flattenSystemPrompt;
+exports.loadPsycheAt = loadPsycheAt;
 exports.resetPsycheCache = resetPsycheCache;
 exports.buildSessionSummary = buildSessionSummary;
 exports.bodyMapSection = bodyMapSection;
@@ -62,6 +63,7 @@ exports.rhythmStatusSection = rhythmStatusSection;
 exports.buildSystem = buildSystem;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
 const core_1 = require("../heart/core");
 const ouro_version_manager_1 = require("../heart/versioning/ouro-version-manager");
 const tools_1 = require("../repertoire/tools");
@@ -94,9 +96,40 @@ function flattenSystemPrompt(sp) {
     const parts = [sp.stable, sp.volatile].filter(Boolean);
     return parts.join("\n\n");
 }
-// Lazy-loaded psyche text cache, scoped by agent root. The daemon can host
-// multiple agents, so identity text must never be cached process-wide.
-let _psycheCache = null;
+// Psyche text cache, one entry per agent root (the daemon can host several agents). An entry is good only while
+// the files it was read from are unchanged: every load hashes their content, so an edit by the agent, its owner or
+// a sync pull takes effect on the very next prompt build. Content, not mtime or inode, because those are unreliable
+// on FUSE shares such as Unraid's /mnt/user; the files are small, so hashing them is cheap.
+const _psycheCache = new Map();
+const PSYCHE_SOURCE_FILES = {
+    soul: ["psyche", "SOUL.md"],
+    identity: ["psyche", "IDENTITY.md"],
+    lore: ["psyche", "LORE.md"],
+    tacitKnowledge: ["psyche", "TACIT.md"],
+    aspirations: ["psyche", "ASPIRATIONS.md"],
+    house: ["house", "HOUSE.md"],
+    houseNames: ["house", "house.json"],
+};
+/** Every file the psyche is built from, read once; null when a file is absent or unreadable. */
+function readPsycheSources(agentRoot) {
+    const sources = {};
+    for (const [key, parts] of Object.entries(PSYCHE_SOURCE_FILES)) {
+        try {
+            sources[key] = String(fs.readFileSync(path.join(agentRoot, ...parts), "utf-8"));
+        }
+        catch {
+            sources[key] = null;
+        }
+    }
+    return sources;
+}
+/** A content hash of the sources; an absent file hashes differently from an empty one. */
+function psycheFingerprint(sources) {
+    const hash = (0, crypto_1.createHash)("sha256");
+    for (const text of Object.values(sources))
+        hash.update(text === null ? "-" : `+${text.length}:${text}`);
+    return hash.digest("hex");
+}
 // A household install names its owner, its Butler and its home in house/house.json,
 // a file the package never overwrites. The packaged psyche writes {{owner}}, {{butler}}
 // and {{household}} where those names go, so one psyche serves every household.
@@ -105,59 +138,48 @@ const HOUSE_NAME_DEFAULTS = {
     butler: "the Butler",
     household: "the household",
 };
-function loadHouseNames(agentRoot) {
+function parseHouseNames(text) {
+    const names = { ...HOUSE_NAME_DEFAULTS };
     try {
-        const parsed = JSON.parse(fs.readFileSync(path.join(agentRoot, "house", "house.json"), "utf-8"));
-        const names = { ...HOUSE_NAME_DEFAULTS };
+        const parsed = JSON.parse(text ?? "");
         for (const [key, field] of [["owner", "ownerName"], ["butler", "butlerName"], ["household", "householdName"]]) {
             const value = parsed[field];
             if (typeof value === "string" && value.trim())
                 names[key] = value.trim();
         }
-        return names;
     }
     catch {
-        return { ...HOUSE_NAME_DEFAULTS };
+        // no house.json, or not JSON: the defaults stand
     }
+    return names;
 }
 function fillHouseNames(text, names) {
-    return text.replace(/\{\{(owner|butler|household)\}\}/gu, (_match, key) => names[key]);
-}
-function loadPsycheFile(agentRoot, name, names) {
-    try {
-        const psycheDir = path.join(agentRoot, "psyche");
-        return fillHouseNames(fs.readFileSync(path.join(psycheDir, name), "utf-8").trim(), names);
-    }
-    catch {
-        return "";
-    }
-}
-function loadHouseFile(agentRoot, names) {
-    try {
-        return fillHouseNames(fs.readFileSync(path.join(agentRoot, "house", "HOUSE.md"), "utf-8").trim(), names);
-    }
-    catch {
-        return "";
-    }
-}
-function loadPsyche() {
-    const agentRoot = (0, identity_1.getAgentRoot)();
-    if (_psycheCache?.agentRoot === agentRoot)
-        return _psycheCache.psyche;
-    const names = loadHouseNames(agentRoot);
+    return (text ?? "").trim().replace(/\{\{(owner|butler|household)\}\}/gu, (_match, key) => names[key]);
+}
+/** The psyche for one agent root. Each call reads its files once and rebuilds only when their content changed. */
+function loadPsycheAt(agentRoot) {
+    const sources = readPsycheSources(agentRoot);
+    const fingerprint = psycheFingerprint(sources);
+    const cached = _psycheCache.get(agentRoot);
+    if (cached?.fingerprint === fingerprint)
+        return cached.psyche;
+    const names = parseHouseNames(sources.houseNames);
     const psyche = {
-        soul: loadPsycheFile(agentRoot, "SOUL.md", names),
-        identity: loadPsycheFile(agentRoot, "IDENTITY.md", names),
-        lore: loadPsycheFile(agentRoot, "LORE.md", names),
-        tacitKnowledge: loadPsycheFile(agentRoot, "TACIT.md", names),
-        aspirations: loadPsycheFile(agentRoot, "ASPIRATIONS.md", names),
-        house: loadHouseFile(agentRoot, names),
+        soul: fillHouseNames(sources.soul, names),
+        identity: fillHouseNames(sources.identity, names),
+        lore: fillHouseNames(sources.lore, names),
+        tacitKnowledge: fillHouseNames(sources.tacitKnowledge, names),
+        aspirations: fillHouseNames(sources.aspirations, names),
+        house: fillHouseNames(sources.house, names),
     };
-    _psycheCache = { agentRoot, psyche };
+    _psycheCache.set(agentRoot, { fingerprint, psyche });
     return psyche;
 }
+function loadPsyche() {
+    return loadPsycheAt((0, identity_1.getAgentRoot)());
+}
 function resetPsycheCache() {
-    _psycheCache = null;
+    _psycheCache.clear();
 }
 const DEFAULT_ACTIVE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
 function buildSessionSummary(options) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.977",
+  "version": "0.1.0-alpha.978",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.977",
+      "version": "0.1.0-alpha.978",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.78.0",
         "@azure/identity": "^4.13.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.977",
+  "version": "0.1.0-alpha.978",
   "engines": {
     "node": ">=22"
   },