@ouro.bot/cli 0.1.0-alpha.428 → 0.1.0-alpha.429

package/changelog.json

@@ -1,6 +1,15 @@
 {
   "_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.429",
+      "changes": [
+        "Habit `lastRun` now lives in bundle runtime state under `state/habits/<habit>.json` instead of being rewritten into tracked `habits/*.md` files after every habit turn.",
+        "The habit worker, scheduler, inner-dialog habit turns, outlook habit readers, and `ouro habit list` now resolve `lastRun` through one shared helper, with legacy habit frontmatter kept as read-only fallback until runtime state exists.",
+        "New habit definitions created by hatch flow or `ouro habit create` stop emitting `lastRun` in tracked frontmatter, and task-system habit migration now preserves historical `lastRun`/`last_run` values by importing them into runtime state instead.",
+        "Habit runtime-state coverage now explicitly protects the defensive strip/fallback paths, and the agent-facing prompt text now tells the truth that runtime timestamps live in `state/habits/` so tracked habit files stay declarative."
+      ]
+    },
     {
       "version": "0.1.0-alpha.428",
       "changes": [

package/dist/heart/daemon/cli-exec.js

@@ -4007,6 +4007,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
     // ── habit subcommands (local, no daemon socket needed) ──
     if (command.kind === "habit.list" || command.kind === "habit.create") {
         const { parseHabitFile, renderHabitFile } = await Promise.resolve().then(() => __importStar(require("../habits/habit-parser")));
+        const { applyHabitRuntimeState } = await Promise.resolve().then(() => __importStar(require("../habits/habit-runtime-state")));
         /* v8 ignore start -- production default: uses real bundle root @preserve */
         const bundleRoot = deps.agentBundleRoot ?? path.join(deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)(), `${command.agent}.ouro`);
         /* v8 ignore stop */
@@ -4029,7 +4030,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             const lines = [];
             for (const file of files) {
                 const fileContent = fs.readFileSync(path.join(habitsDir, file), "utf-8");
-                const habit = parseHabitFile(fileContent, path.join(habitsDir, file));
+                const habit = applyHabitRuntimeState(bundleRoot, parseHabitFile(fileContent, path.join(habitsDir, file)));
                 const lastRunStr = habit.lastRun ?? "never";
                 lines.push(`${habit.name}  cadence=${habit.cadence ?? "none"}  status=${habit.status}  lastRun=${lastRunStr}`);
             }
@@ -4050,7 +4051,6 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             title: command.name,
             cadence: command.cadence ?? "null",
             status: "active",
-            lastRun: now,
             created: now,
         }, `Habit: ${command.name}`);
         fs.writeFileSync(filePath, habitContent, "utf-8");

package/dist/heart/habits/habit-migration.js

@@ -38,6 +38,7 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 const habit_parser_1 = require("./habit-parser");
+const habit_runtime_state_1 = require("./habit-runtime-state");
 const parser_1 = require("../../repertoire/tasks/parser");
 /** Fields that belong to the task system and should be stripped from migrated habits. */
 const TASK_ONLY_FIELDS = new Set([
@@ -138,6 +139,11 @@ function migrateHabitsFromTaskSystem(bundleRoot) {
             });
             continue;
         }
+        const legacyLastRun = typeof frontmatter.lastRun === "string" && frontmatter.lastRun !== "null"
+            ? frontmatter.lastRun
+            : typeof frontmatter.last_run === "string" && frontmatter.last_run !== "null"
+                ? frontmatter.last_run
+                : null;
         // Build new frontmatter, stripping task-only fields
         const newFrontmatter = {};
         if (typeof frontmatter.title === "string")
@@ -145,14 +151,13 @@ function migrateHabitsFromTaskSystem(bundleRoot) {
         if (typeof frontmatter.cadence === "string")
             newFrontmatter.cadence = frontmatter.cadence;
         newFrontmatter.status = habitStatus;
-        newFrontmatter.lastRun = typeof frontmatter.lastRun === "string" && frontmatter.lastRun !== "null"
-            ? frontmatter.lastRun
-            : "null";
         newFrontmatter.created = typeof frontmatter.created === "string" ? frontmatter.created : "null";
         // Add any other non-task fields from original
         for (const [key, value] of Object.entries(frontmatter)) {
             if (TASK_ONLY_FIELDS.has(key))
                 continue;
+            if (key === "lastRun" || key === "last_run")
+                continue;
             if (key in newFrontmatter)
                 continue;
             /* v8 ignore next -- dead code: status is caught by `key in newFrontmatter` above since newFrontmatter.status is always set @preserve */
@@ -162,6 +167,9 @@ function migrateHabitsFromTaskSystem(bundleRoot) {
         }
         const rendered = (0, habit_parser_1.renderHabitFile)(newFrontmatter, body);
         fs.writeFileSync(targetPath, rendered, "utf-8");
+        if (legacyLastRun) {
+            (0, habit_runtime_state_1.writeHabitLastRun)(bundleRoot, path.basename(slugName, ".md"), legacyLastRun);
+        }
         migratedCount++;
         (0, runtime_1.emitNervesEvent)({
             component: "daemon",

package/dist/heart/habits/habit-parser.js

@@ -98,7 +98,7 @@ function parseHabitFile(content, filePath) {
     const cadence = typeof rawCadence === "string" && rawCadence.length > 0 ? rawCadence : null;
     const rawStatus = frontmatter.status;
     const status = typeof rawStatus === "string" && isHabitStatus(rawStatus) ? rawStatus : "active";
-    const rawLastRun = frontmatter.lastRun;
+    const rawLastRun = frontmatter.lastRun ?? frontmatter.last_run;
     const lastRun = typeof rawLastRun === "string" && rawLastRun.length > 0 ? rawLastRun : null;
     const rawCreated = frontmatter.created;
     const created = typeof rawCreated === "string" && rawCreated.length > 0 ? rawCreated : null;

package/dist/heart/habits/habit-runtime-state.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readHabitLastRun = readHabitLastRun;
+exports.applyHabitRuntimeState = applyHabitRuntimeState;
+exports.writeHabitLastRun = writeHabitLastRun;
+exports.recordHabitRun = recordHabitRun;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const json_store_1 = require("../../arc/json-store");
+const runtime_1 = require("../../nerves/runtime");
+function habitRuntimeStateDir(agentRoot) {
+    return path.join(agentRoot, "state", "habits");
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function stripLegacyLastRunFromDefinition(definitionPath) {
+    const content = fs.readFileSync(definitionPath, "utf-8");
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---")
+        return;
+    const closing = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (closing === -1)
+        return;
+    const frontmatterLines = lines.slice(1, closing);
+    const filtered = frontmatterLines.filter((line) => !/^\s*lastRun\s*:/.test(line) && !/^\s*last_run\s*:/.test(line));
+    if (filtered.length === frontmatterLines.length)
+        return;
+    const nextContent = ["---", ...filtered, "---", ...lines.slice(closing + 1)].join("\n");
+    fs.writeFileSync(definitionPath, nextContent, "utf-8");
+}
+function readHabitLastRun(agentRoot, habitName) {
+    const record = (0, json_store_1.readJsonFile)(habitRuntimeStateDir(agentRoot), habitName);
+    return isNonEmptyString(record?.lastRun) ? record.lastRun : null;
+}
+function applyHabitRuntimeState(agentRoot, habit) {
+    const runtimeLastRun = readHabitLastRun(agentRoot, habit.name);
+    if (runtimeLastRun === null)
+        return habit;
+    return { ...habit, lastRun: runtimeLastRun };
+}
+function writeHabitLastRun(agentRoot, habitName, lastRun, updatedAt = lastRun) {
+    const record = {
+        schemaVersion: 1,
+        name: habitName,
+        lastRun,
+        updatedAt,
+    };
+    (0, json_store_1.writeJsonFile)(habitRuntimeStateDir(agentRoot), habitName, record);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.habit_runtime_state_write",
+        message: "wrote habit runtime state",
+        meta: { agentRoot, habitName, lastRun, updatedAt },
+    });
+}
+function recordHabitRun(agentRoot, habitName, lastRun, options = {}) {
+    writeHabitLastRun(agentRoot, habitName, lastRun);
+    if (!options.definitionPath)
+        return;
+    try {
+        stripLegacyLastRunFromDefinition(options.definitionPath);
+    }
+    catch {
+        // Missing/deleted habit files should never block runtime-state recording.
+    }
+}

package/dist/heart/habits/habit-scheduler.js

@@ -37,6 +37,7 @@ exports.HabitScheduler = void 0;
 const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 const habit_parser_1 = require("./habit-parser");
+const habit_runtime_state_1 = require("./habit-runtime-state");
 const cadence_1 = require("../daemon/cadence");
 const WATCH_DEBOUNCE_MS = 200;
 class HabitScheduler {
@@ -167,7 +168,7 @@ class HabitScheduler {
         const filePath = path.join(this.habitsDir, `${name}.md`);
         try {
             const content = this.deps.readFile(filePath, "utf-8");
-            return (0, habit_parser_1.parseHabitFile)(content, filePath);
+            return (0, habit_runtime_state_1.applyHabitRuntimeState)(path.dirname(this.habitsDir), (0, habit_parser_1.parseHabitFile)(content, filePath));
         }
         catch {
             return null;
@@ -323,7 +324,7 @@ class HabitScheduler {
             const filePath = path.join(this.habitsDir, file);
             try {
                 const content = this.deps.readFile(filePath, "utf-8");
-                const habit = (0, habit_parser_1.parseHabitFile)(content, filePath);
+                const habit = (0, habit_runtime_state_1.applyHabitRuntimeState)(path.dirname(this.habitsDir), (0, habit_parser_1.parseHabitFile)(content, filePath));
                 habits.push(habit);
             }
             catch (error) {

package/dist/heart/hatch/hatch-flow.js

@@ -85,7 +85,6 @@ function writeHeartbeatHabit(bundleRoot, now) {
         title: "Heartbeat check-in",
         cadence: "30m",
         status: "active",
-        lastRun: "null",
         created: now.toISOString(),
     }, "Run a lightweight heartbeat cycle. Review task board and inbox.\nCheck on pending obligations. Journal anything important.");
     fs.writeFileSync(filePath, content, "utf-8");

package/dist/heart/outlook/readers/runtime-readers.js

@@ -46,6 +46,8 @@ exports.readDeskPrefs = readDeskPrefs;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../../nerves/runtime");
+const habit_parser_1 = require("../../habits/habit-parser");
+const habit_runtime_state_1 = require("../../habits/habit-runtime-state");
 const identity_1 = require("../../identity");
 const shared_1 = require("./shared");
 const agent_machine_1 = require("./agent-machine");
@@ -467,10 +469,11 @@ function readHabitView(agentRoot, options = {}) {
         if (!file.endsWith(".md"))
             continue;
         try {
-            const raw = fs.readFileSync(path.join(habitsDir, file), "utf-8");
-            const habit = parseHabitFrontmatter(raw);
-            if (!habit)
+            const filePath = path.join(habitsDir, file);
+            const raw = fs.readFileSync(filePath, "utf-8");
+            if (!/^---\r?\n[\s\S]*?\r?\n---/.test(raw))
                 continue;
+            const habit = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(raw, filePath));
             const cadenceMs = parseCadenceMs(habit.cadence);
             let isOverdue = false;
             let overdueMs = null;
@@ -482,10 +485,10 @@ function readHabitView(agentRoot, options = {}) {
                 }
             }
             items.push({
-                name: habit.name ?? file.slice(0, -3),
-                title: habit.title ?? file.slice(0, -3),
+                name: habit.name,
+                title: habit.title,
                 cadence: habit.cadence,
-                status: habit.status === "paused" ? "paused" : "active",
+                status: habit.status,
                 lastRun: habit.lastRun,
                 bodyExcerpt: (0, shared_1.truncateExcerpt)(habit.body, 120),
                 isDegraded: false,
@@ -514,25 +517,6 @@ function readHabitView(agentRoot, options = {}) {
         items,
     };
 }
-function parseHabitFrontmatter(content) {
-    const fmMatch = /^---\n([\s\S]*?)\n---/.exec(content);
-    if (!fmMatch)
-        return null;
-    const fm = fmMatch[1];
-    const body = content.slice(fmMatch[0].length).trim() || null;
-    function extract(key) {
-        const match = new RegExp(`^${key}:\\s*(.+)$`, "m").exec(fm);
-        return match ? match[1].trim() : null;
-    }
-    return {
-        name: extract("name"),
-        title: extract("title"),
-        cadence: extract("cadence"),
-        status: extract("status"),
-        lastRun: extract("lastRun") ?? extract("last_run"),
-        body,
-    };
-}
 function readNeedsMeView(agentName, options = {}) {
     const bundlesRoot = options.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
     const now = options.now?.() ?? new Date();

package/dist/mind/prompt.js

@@ -1044,8 +1044,10 @@ when i'm done thinking and the attention queue is clear, i rest.
 my habits live at habits/ — they're my autonomous rhythms. heartbeat
 is my breathing, other habits are patterns i choose. i can read, create,
 and modify them with read_file/write_file. the format is simple
-frontmatter (title, cadence, status, lastRun, created) plus a body
+frontmatter (title, cadence, status, created) plus a body
 that says what i do when the rhythm fires.
+runtime timestamps like lastRun live under state/habits/ so my tracked
+habit files stay declarative.
 
 \`ouro habit list\` shows my current habits. \`ouro habit create\` makes
 a new one. the cadence is personal — how often do i want each rhythm

package/dist/senses/inner-dialog-worker.js

@@ -35,13 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createInnerDialogWorker = createInnerDialogWorker;
 exports.startInnerDialogWorker = startInnerDialogWorker;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const inner_dialog_1 = require("./inner-dialog");
 const runtime_1 = require("../nerves/runtime");
 const identity_1 = require("../heart/identity");
 const pending_1 = require("../mind/pending");
-const habit_parser_1 = require("../heart/habits/habit-parser");
+const habit_runtime_state_1 = require("../heart/habits/habit-runtime-state");
 function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options), hasPendingWork = () => (0, pending_1.hasPendingMessages)((0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)()))) {
     let running = false;
     const queue = [];
@@ -71,25 +70,16 @@ function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runIn
                         },
                     });
                 }
-                // Update lastRun in habit frontmatter after a habit turn
+                // Record lastRun after a habit turn without dirtying the tracked habit file.
                 if (nextReason === "habit" && nextHabitName) {
                     try {
                         const agentRoot = (0, identity_1.getAgentRoot)();
-                        const habitFilePath = path.join(agentRoot, "habits", `${nextHabitName}.md`);
-                        const content = fs.readFileSync(habitFilePath, "utf-8");
-                        const parsed = (0, habit_parser_1.parseHabitFile)(content, habitFilePath);
-                        const frontmatter = {
-                            title: parsed.title,
-                            cadence: parsed.cadence,
-                            status: parsed.status,
-                            lastRun: new Date().toISOString(),
-                            created: parsed.created,
-                        };
-                        const rendered = (0, habit_parser_1.renderHabitFile)(frontmatter, parsed.body);
-                        fs.writeFileSync(habitFilePath, rendered, "utf-8");
+                        (0, habit_runtime_state_1.recordHabitRun)(agentRoot, nextHabitName, new Date().toISOString(), {
+                            definitionPath: path.join(agentRoot, "habits", `${nextHabitName}.md`),
+                        });
                     }
                     catch {
-                        // Habit file may have been deleted during the turn — skip gracefully
+                        // Habit file/state may be unavailable during the turn — skip gracefully
                     }
                 }
                 // Drain queue first

package/dist/senses/inner-dialog.js

@@ -71,6 +71,7 @@ const bluebubbles_1 = require("./bluebubbles");
 const habit_turn_message_1 = require("./habit-turn-message");
 const journal_index_1 = require("../mind/journal-index");
 const habit_parser_1 = require("../heart/habits/habit-parser");
+const habit_runtime_state_1 = require("../heart/habits/habit-runtime-state");
 const cadence_1 = require("../heart/daemon/cadence");
 const daemon_health_1 = require("../heart/daemon/daemon-health");
 const DEFAULT_INNER_DIALOG_INSTINCTS = [
@@ -493,7 +494,7 @@ function buildAlsoDueLine(agentRoot, currentHabitName, now) {
             continue;
         try {
             const content = fs.readFileSync(path.join(habitsDir, file), "utf-8");
-            const habit = (0, habit_parser_1.parseHabitFile)(content, path.join(habitsDir, file));
+            const habit = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(content, path.join(habitsDir, file)));
             if (habit.status !== "active" || !habit.cadence)
                 continue;
             const cadenceMs = (0, cadence_1.parseCadenceToMs)(habit.cadence);
@@ -568,7 +569,7 @@ async function runInnerDialogTurn(options) {
                 let habitLastRun = null;
                 try {
                     const habitContent = fs.readFileSync(habitFilePath, "utf-8");
-                    const parsed = (0, habit_parser_1.parseHabitFile)(habitContent, habitFilePath);
+                    const parsed = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(habitContent, habitFilePath));
                     habitBody = parsed.body || undefined;
                     habitTitle = parsed.title || habitName;
                     habitLastRun = parsed.lastRun;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.428",
+  "version": "0.1.0-alpha.429",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",