@ouro.bot/cli 0.1.0-alpha.156 → 0.1.0-alpha.158

package/changelog.json

@@ -1,6 +1,30 @@
 {
   "_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.158",
+      "changes": [
+        "Task scanner v2: explicit identity via kind: task field. Scanner only parses files that declare themselves as task cards — doing docs, planning docs, and artifacts silently skipped. Eliminates 184 false parse errors on real bundles.",
+        "Typed issue model: every scanner issue has a code, description, proposed fix, confidence (safe/needs_review), and category (live/migration). Replaces flat parseErrors/invalidFilenames arrays.",
+        "Board health line: compact board shows health: clean or health: 1 live, 10 migration. Live vs migration split prevents cleanup noise from looking like breakage.",
+        "Fix command: ouro task fix (dry-run), ouro task fix --safe (apply deterministic fixes), ouro task fix <id> (inspect/apply individual issues). Currently auto-fixes schema-missing-kind.",
+        "Cancelled status: new terminal state reachable from any active status. Auto-archives with work directory, hidden from active board view.",
+        "Derived child_tasks: computed at scan time from parent_task links. child_tasks removed from authored schema — no more hand-maintained stale arrays.",
+        "Work directory awareness: same-stem directories detected and listed on TaskFile (hasWorkDir, workDirFiles). Scanner never descends into them.",
+        "Collection root clutter detection: non-task support docs at collection root summarized as one aggregated migration issue per collection.",
+        "Root-only scanning: flat directory reads replace recursive walks. Faster and correct."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.157",
+      "changes": [
+        "Habit turns as awareness: unified buildHabitTurnMessage replaces contextual-heartbeat. Continuity-first format (checkpoint leads, not elapsed time). Same format for all habits \u2014 no heartbeat special-casing.",
+        "First beat experience: new habits get \"your [Title] is alive. this is its first breath\" on first fire.",
+        "Fix: reconcile() now fires new/overdue habits immediately (was start()-only). New habits created via write_file fire within seconds.",
+        "Rhythm awareness across all channels: rhythmStatusSection() in system prompt shows heartbeat health in every conversation.",
+        "Removed contextual-heartbeat.ts entirely. Dead lastSurfaceAt parameter removed."
+      ]
+    },
     {
       "version": "0.1.0-alpha.156",
       "changes": [
@@ -1033,4 +1057,4 @@
       ]
     }
   ]
-}
+}

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

@@ -305,6 +305,7 @@ function usage() {
         "  ouro task create <title> [--type <type>] [--agent <name>]",
         "  ouro task update <id> <status> [--agent <name>]",
         "  ouro task show <id> [--agent <name>]",
+        "  ouro task fix [--safe|--all] [<id> [--option <N>]] [--agent <name>]",
         "  ouro task actionable|deps|sessions [--agent <name>]",
         "  ouro reminder create <title> --body <body> [--at <iso>] [--cadence <interval>] [--category <category>] [--agent <name>]",
         "  ouro friend list [--agent <name>]",
@@ -737,6 +738,31 @@ function parseTaskCommand(args) {
         return { kind: "task.deps", ...(agent ? { agent } : {}) };
     if (sub === "sessions")
         return { kind: "task.sessions", ...(agent ? { agent } : {}) };
+    if (sub === "fix") {
+        // fix --safe | fix --all | fix <id> [--option N] | fix (dry-run)
+        if (rest.length === 0)
+            return { kind: "task.fix", mode: "dry-run", ...(agent ? { agent } : {}) };
+        const first = rest[0];
+        if (first === "--safe" || first === "--all") {
+            return { kind: "task.fix", mode: "safe", ...(agent ? { agent } : {}) };
+        }
+        // first arg is an issue ID (contains a colon, e.g. schema-missing-kind:one-shots/foo.md)
+        const issueId = first;
+        let option;
+        for (let i = 1; i < rest.length; i++) {
+            if (rest[i] === "--option" && rest[i + 1]) {
+                option = parseInt(rest[i + 1], 10);
+                i += 1;
+            }
+        }
+        return {
+            kind: "task.fix",
+            mode: "single",
+            issueId,
+            ...(option !== undefined ? { option } : {}),
+            ...(agent ? { agent } : {}),
+        };
+    }
     throw new Error(`Usage\n${usage()}`);
 }
 function parseAuthCommand(args) {
@@ -1796,6 +1822,60 @@ function executeTaskCommand(command, taskMod) {
         const lines = taskMod.boardDeps();
         return lines.length > 0 ? lines.join("\n") : "no unresolved dependencies";
     }
+    if (command.kind === "task.fix") {
+        try {
+            const fixOptions = {
+                mode: command.mode,
+                ...(command.issueId ? { issueId: command.issueId } : {}),
+                ...(command.option !== undefined ? { option: command.option } : {}),
+            };
+            const result = taskMod.fix(fixOptions);
+            if (command.mode === "dry-run") {
+                if (result.remaining.length === 0) {
+                    return `task health: clean`;
+                }
+                const safeIssues = result.remaining.filter((i) => i.confidence === "safe");
+                const reviewIssues = result.remaining.filter((i) => i.confidence === "needs_review");
+                const lines = [`${result.remaining.length} issues found`];
+                if (safeIssues.length > 0) {
+                    lines.push("", `safe fixes (${safeIssues.length}):`);
+                    for (const issue of safeIssues) {
+                        lines.push(`  ${issue.code}:${issue.target} -- ${issue.description}`);
+                    }
+                }
+                if (reviewIssues.length > 0) {
+                    lines.push("", `needs review (${reviewIssues.length}):`);
+                    for (const issue of reviewIssues) {
+                        lines.push(`  ${issue.code}:${issue.target} -- ${issue.description}`);
+                    }
+                }
+                lines.push("", `task health: ${result.health}`);
+                return lines.join("\n");
+            }
+            // safe, single, or --all modes: show what was done
+            const lines = [];
+            if (result.applied.length > 0) {
+                lines.push(`${result.applied.length} applied:`);
+                for (const issue of result.applied) {
+                    lines.push(`  ${issue.code}:${issue.target}`);
+                }
+            }
+            if (result.remaining.length > 0) {
+                lines.push(`${result.remaining.length} remaining:`);
+                for (const issue of result.remaining) {
+                    lines.push(`  ${issue.code}:${issue.target} -- ${issue.description}`);
+                }
+            }
+            if (result.applied.length === 0 && result.remaining.length === 0) {
+                lines.push("no issues");
+            }
+            lines.push(`task health: ${result.health}`);
+            return lines.join("\n");
+        }
+        catch (error) {
+            return `error: ${error instanceof Error ? error.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(error)}`;
+        }
+    }
     // command.kind === "task.sessions"
     const lines = taskMod.boardSessions();
     return lines.length > 0 ? lines.join("\n") : "no active sessions";
@@ -2580,7 +2660,7 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
     // ── task subcommands (local, no daemon socket needed) ──
     if (command.kind === "task.board" || command.kind === "task.create" || command.kind === "task.update" ||
         command.kind === "task.show" || command.kind === "task.actionable" || command.kind === "task.deps" ||
-        command.kind === "task.sessions") {
+        command.kind === "task.sessions" || command.kind === "task.fix") {
         /* v8 ignore start -- production default: requires full identity setup @preserve */
         const taskMod = deps.taskModule ?? (0, tasks_1.getTaskModule)();
         /* v8 ignore stop */

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

@@ -73,7 +73,24 @@ class HabitScheduler {
         const jobs = this.buildJobs(habits);
         this.osCronManager.sync(jobs);
         this.verifyCronAndCreateFallbacks(jobs);
-        // Fire overdue habits immediately
+        this.fireOverdueHabits(habits);
+    }
+    reconcile() {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.habit_scheduler_reconcile",
+            message: "habit scheduler reconciling",
+            meta: { agent: this.agent },
+        });
+        // Clear ALL existing timers FIRST to prevent overlap window
+        this.clearAllTimerFallbacks();
+        const habits = this.scanHabits();
+        const jobs = this.buildJobs(habits);
+        this.osCronManager.sync(jobs);
+        this.verifyCronAndCreateFallbacks(jobs);
+        this.fireOverdueHabits(habits);
+    }
+    fireOverdueHabits(habits) {
         for (const habit of habits) {
             if (habit.status !== "active")
                 continue;
@@ -106,20 +123,6 @@ class HabitScheduler {
             }
         }
     }
-    reconcile() {
-        (0, runtime_1.emitNervesEvent)({
-            component: "daemon",
-            event: "daemon.habit_scheduler_reconcile",
-            message: "habit scheduler reconciling",
-            meta: { agent: this.agent },
-        });
-        // Clear ALL existing timers FIRST to prevent overlap window
-        this.clearAllTimerFallbacks();
-        const habits = this.scanHabits();
-        const jobs = this.buildJobs(habits);
-        this.osCronManager.sync(jobs);
-        this.verifyCronAndCreateFallbacks(jobs);
-    }
     stop() {
         (0, runtime_1.emitNervesEvent)({
             component: "daemon",

package/dist/mind/prompt.js

@@ -51,6 +51,7 @@ exports.channelNatureSection = channelNatureSection;
 exports.groupChatParticipationSection = groupChatParticipationSection;
 exports.feedbackSignalSection = feedbackSignalSection;
 exports.mixedTrustGroupSection = mixedTrustGroupSection;
+exports.rhythmStatusSection = rhythmStatusSection;
 exports.buildSystem = buildSystem;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -71,6 +72,7 @@ const session_activity_1 = require("../heart/session-activity");
 const active_work_1 = require("../heart/active-work");
 const commitments_1 = require("../heart/commitments");
 const obligation_steering_1 = require("./obligation-steering");
+const daemon_health_1 = require("../heart/daemon/daemon-health");
 // Lazy-loaded psyche text cache
 let _psycheCache = null;
 let _senseStatusLinesCache = null;
@@ -886,6 +888,39 @@ function mixedTrustGroupSection(context) {
         return "";
     return "## mixed trust group\nin this group chat, my capabilities depend on who's talking. some people here have full trust, others don't — i adjust what i can do based on who's asking.";
 }
+function formatElapsedBrief(ms) {
+    const minutes = Math.floor(ms / 60000);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h ago`;
+}
+function rhythmStatusSection() {
+    try {
+        const health = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
+        if (!health)
+            return "";
+        const habitNames = Object.keys(health.habits);
+        if (habitNames.length === 0)
+            return "";
+        const nowMs = Date.now();
+        const parts = [];
+        for (const name of habitNames) {
+            const h = health.habits[name];
+            const lastFired = h.lastFired ? formatElapsedBrief(nowMs - new Date(h.lastFired).getTime()) : "never";
+            parts.push(`${name} last fired ${lastFired}`);
+        }
+        const degradedNote = health.degraded.length > 0
+            ? health.degraded.map((d) => `${d.component}: ${d.reason}`).join("; ") + "."
+            : "healthy.";
+        return `my rhythms: ${parts.join(". ")}. ${degradedNote}`;
+        /* v8 ignore start -- defensive: readHealth handles its own errors; this catch is a safety net for truly unexpected failures @preserve */
+    }
+    catch {
+        return "";
+    }
+    /* v8 ignore stop */
+}
 async function buildSystem(channel = "cli", options, context) {
     (0, runtime_1.emitNervesEvent)({
         event: "mind.step_start",
@@ -906,6 +941,7 @@ async function buildSystem(channel = "cli", options, context) {
         channel === "inner" ? journalSection((0, identity_1.getAgentRoot)()) : "",
         loopOrientationSection(channel),
         runtimeInfoSection(channel),
+        rhythmStatusSection(),
         channelNatureSection((0, channel_1.getChannelCapabilities)(channel)),
         providerSection(),
         dateSection(),

package/dist/repertoire/guardrails.js

@@ -162,6 +162,7 @@ exports.OURO_CLI_TRUST_MANIFEST = {
     "task actionable": "friend",
     "task deps": "friend",
     "task sessions": "friend",
+    "task fix": "friend",
     "friend list": "friend",
     "friend show": "friend",
     "friend create": "friend",

package/dist/repertoire/tasks/board.js

@@ -7,14 +7,21 @@ exports.boardDeps = boardDeps;
 exports.boardSessions = boardSessions;
 const runtime_1 = require("../../nerves/runtime");
 const transitions_1 = require("./transitions");
-const BOARD_STATUS_ORDER = [
+const BOARD_ACTIVE_ORDER = [
     "blocked",
     "processing",
     "collaborating",
     "drafting",
     "validating",
     "paused",
+];
+const BOARD_TERMINAL_ORDER = [
     "done",
+    "cancelled",
+];
+const BOARD_STATUS_ORDER = [
+    ...BOARD_ACTIVE_ORDER,
+    ...BOARD_TERMINAL_ORDER,
 ];
 function compactName(task) {
     const suffix = task.stem.replace(/^\d{4}-\d{2}-\d{2}-\d{4}-/, "");
@@ -29,6 +36,7 @@ function groupByStatus(tasks) {
         paused: [],
         blocked: [],
         done: [],
+        cancelled: [],
     };
     for (const task of tasks) {
         grouped[task.status].push(compactName(task));
@@ -65,8 +73,20 @@ function activeBridgeLines(tasks) {
         .map((task) => `${task.stem} -> ${String(task.frontmatter.active_bridge).trim()}`)
         .sort();
 }
+function buildHealthLine(issues) {
+    if (issues.length === 0)
+        return "health: clean";
+    const liveCount = issues.filter((i) => i.category === "live").length;
+    const migrationCount = issues.filter((i) => i.category === "migration").length;
+    const parts = [];
+    if (liveCount > 0)
+        parts.push(`${liveCount} live`);
+    if (migrationCount > 0)
+        parts.push(`${migrationCount} migration`);
+    return `health: ${parts.join(", ")}`;
+}
 function actionRequired(index, byStatus) {
-    const actions = [...index.parseErrors, ...index.invalidFilenames.map((filePath) => `bad filename: ${filePath}`)];
+    const actions = index.issues.map((issue) => `${issue.code}: ${issue.description} [${issue.target}]`);
     if (byStatus.blocked.length > 0) {
         actions.push(`blocked tasks: ${byStatus.blocked.join(", ")}`);
     }
@@ -83,14 +103,19 @@ function buildTaskBoard(index) {
         meta: { taskCount: index.tasks.length },
     });
     const byStatus = groupByStatus(index.tasks);
-    const counts = transitions_1.TASK_VALID_STATUSES.map((status) => `${status}:${byStatus[status].length}`).join(" ");
+    const activeCounts = BOARD_ACTIVE_ORDER.map((status) => `${status}:${byStatus[status].length}`).join(" ");
     const processing = byStatus.processing.length > 0 ? `\n processing: ${byStatus.processing.join(", ")}` : "";
     const blocked = byStatus.blocked.length > 0 ? `\n blocked: ${byStatus.blocked.join(", ")}` : "";
-    const compact = `[Tasks] ${counts}${processing}${blocked}`;
+    const terminalParts = BOARD_TERMINAL_ORDER
+        .filter((status) => byStatus[status].length > 0)
+        .map((status) => `${status}:${byStatus[status].length}`);
+    const terminalLine = terminalParts.length > 0 ? `\n terminal: ${terminalParts.join(" ")}` : "";
+    const healthLine = `\n ${buildHealthLine(index.issues)}`;
+    const compact = `[Tasks] ${activeCounts}${processing}${blocked}${terminalLine}${healthLine}`;
     const fullLines = [];
     for (const status of BOARD_STATUS_ORDER) {
         const names = byStatus[status];
-        if (status === "done" && names.length === 0)
+        if ((status === "done" || status === "cancelled") && names.length === 0)
             continue;
         fullLines.push(`## ${status}`);
         fullLines.push(names.length > 0 ? names.map((name) => `- ${name}`).join("\n") : "- (none)");
@@ -114,6 +139,7 @@ function buildTaskBoard(index) {
         compact,
         full: fullLines.join("\n\n"),
         byStatus,
+        issues: index.issues,
         actionRequired: actionRequired(index, byStatus),
         unresolvedDependencies: unresolved,
         activeSessions: active,

package/dist/repertoire/tasks/fix.js

@@ -0,0 +1,182 @@
+"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.addKindToLegacyCard = addKindToLegacyCard;
+exports.applyFixes = applyFixes;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+const scanner_1 = require("./scanner");
+const parser_1 = require("./parser");
+function issueId(issue) {
+    return `${issue.code}:${issue.target}`;
+}
+function addKindToLegacyCard(root, issue) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "repertoire.fix_apply_start",
+        component: "repertoire",
+        message: "adding kind: task to legacy card",
+        meta: { target: issue.target },
+    });
+    const filePath = path.join(root, issue.target);
+    if (!fs.existsSync(filePath))
+        return false;
+    const content = fs.readFileSync(filePath, "utf-8");
+    const frontmatter = (0, scanner_1.tryExtractFrontmatter)(content);
+    if (!frontmatter)
+        return false;
+    // Add kind: task to frontmatter
+    frontmatter.kind = "task";
+    // Extract body (everything after the second ---)
+    const lines = content.split(/\r?\n/);
+    const firstDelim = lines.findIndex((line) => line.trim() === "---");
+    const secondDelim = lines.findIndex((line, idx) => idx > firstDelim && line.trim() === "---");
+    const body = lines.slice(secondDelim + 1).join("\n").replace(/^\n/, "");
+    const rendered = (0, parser_1.renderTaskFile)(frontmatter, body);
+    fs.writeFileSync(filePath, rendered, "utf-8");
+    return true;
+}
+function applySingleFix(root, issue) {
+    switch (issue.code) {
+        case "schema-missing-kind":
+            return addKindToLegacyCard(root, issue);
+        default:
+            return false;
+    }
+}
+function applyFixes(options, root) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "repertoire.fix_start",
+        component: "repertoire",
+        message: `applying fixes in ${options.mode} mode`,
+        meta: { mode: options.mode, root },
+    });
+    (0, scanner_1.clearTaskScanCache)();
+    const index = (0, scanner_1.scanTasks)(root);
+    const issues = index.issues;
+    if (options.mode === "dry-run") {
+        (0, runtime_1.emitNervesEvent)({
+            event: "repertoire.fix_complete",
+            component: "repertoire",
+            message: "dry-run complete, no changes made",
+            meta: { issueCount: issues.length },
+        });
+        const health = issues.length === 0 ? "clean" : buildHealthSummary(issues);
+        return {
+            applied: [],
+            remaining: issues,
+            skipped: [],
+            health,
+        };
+    }
+    if (options.mode === "single") {
+        const targetId = options.issueId ?? "";
+        const match = issues.find((i) => issueId(i) === targetId);
+        if (!match) {
+            (0, runtime_1.emitNervesEvent)({
+                event: "repertoire.fix_complete",
+                component: "repertoire",
+                message: "single fix: issue not found",
+                meta: { issueId: targetId },
+            });
+            const health = issues.length === 0 ? "clean" : buildHealthSummary(issues);
+            return {
+                applied: [],
+                remaining: issues,
+                skipped: [],
+                health,
+            };
+        }
+        const success = applySingleFix(root, match);
+        (0, scanner_1.clearTaskScanCache)();
+        const afterIndex = (0, scanner_1.scanTasks)(root);
+        const afterIssues = afterIndex.issues;
+        const health = afterIssues.length === 0 ? "clean" : buildHealthSummary(afterIssues);
+        (0, runtime_1.emitNervesEvent)({
+            event: "repertoire.fix_complete",
+            component: "repertoire",
+            message: `single fix ${success ? "applied" : "failed"}`,
+            meta: { issueId: targetId, success },
+        });
+        return {
+            applied: success ? [match] : [],
+            remaining: afterIssues,
+            skipped: success ? [] : [match],
+            health,
+        };
+    }
+    // safe mode: apply all safe-confidence fixes
+    const applied = [];
+    const skipped = [];
+    for (const issue of issues) {
+        if (issue.confidence !== "safe") {
+            skipped.push(issue);
+            continue;
+        }
+        const success = applySingleFix(root, issue);
+        if (success) {
+            applied.push(issue);
+        }
+        else {
+            skipped.push(issue);
+        }
+    }
+    (0, scanner_1.clearTaskScanCache)();
+    const afterIndex = (0, scanner_1.scanTasks)(root);
+    const afterIssues = afterIndex.issues;
+    const health = afterIssues.length === 0 ? "clean" : buildHealthSummary(afterIssues);
+    (0, runtime_1.emitNervesEvent)({
+        event: "repertoire.fix_complete",
+        component: "repertoire",
+        message: `safe fixes complete: ${applied.length} applied, ${skipped.length} skipped`,
+        meta: { applied: applied.length, skipped: skipped.length },
+    });
+    return {
+        applied,
+        remaining: afterIssues,
+        skipped,
+        health,
+    };
+}
+function buildHealthSummary(issues) {
+    const liveCount = issues.filter((i) => i.category === "live").length;
+    const migrationCount = issues.filter((i) => i.category === "migration").length;
+    const parts = [];
+    if (liveCount > 0)
+        parts.push(`${liveCount} live`);
+    if (migrationCount > 0)
+        parts.push(`${migrationCount} migration`);
+    return parts.join(", ");
+}

package/dist/repertoire/tasks/index.js

@@ -40,6 +40,7 @@ const path = __importStar(require("path"));
 const config_1 = require("../../heart/config");
 const runtime_1 = require("../../nerves/runtime");
 const board_1 = require("./board");
+const fix_1 = require("./fix");
 const lifecycle_1 = require("./lifecycle");
 const parser_1 = require("./parser");
 const scanner_1 = require("./scanner");
@@ -97,6 +98,7 @@ class FileTaskModule {
         const filePath = path.join(root, collection, filename);
         const today = formatDate();
         const frontmatter = {
+            kind: "task",
             type,
             category: input.category || "infrastructure",
             title: input.title,
@@ -108,7 +110,6 @@ class FileTaskModule {
             lastRun: input.lastRun ?? null,
             created: today,
             updated: today,
-            child_tasks: [],
             artifacts: [],
         };
         if (type === "one-shot") {
@@ -192,6 +193,9 @@ class FileTaskModule {
         }
         return (0, middleware_1.validateSpawn)(task, spawnType);
     }
+    fix(options) {
+        return (0, fix_1.applyFixes)(options, (0, scanner_1.getTaskRoot)());
+    }
     detectStale(thresholdDays) {
         return (0, lifecycle_1.detectStaleTasks)(this.scan(), thresholdDays);
     }

package/dist/repertoire/tasks/lifecycle.js

@@ -48,7 +48,7 @@ function archiveCompletedTasks(index) {
     const archived = [];
     const failures = [];
     for (const task of index.tasks) {
-        if (task.status !== "done")
+        if (task.status !== "done" && task.status !== "cancelled")
             continue;
         const archiveDir = path.join(index.root, "archive", task.collection);
         const archiveFile = path.join(archiveDir, task.name);
@@ -73,7 +73,7 @@ function detectStaleTasks(index, thresholdDays, now = new Date()) {
         const updated = Date.parse(task.updated);
         if (Number.isNaN(updated))
             return false;
-        if (task.status === "done")
+        if (task.status === "done" || task.status === "cancelled")
             return false;
         return updated < staleCutoffMs;
     });

package/dist/repertoire/tasks/parser.js

@@ -136,6 +136,9 @@ function parseTaskFile(content, filePath) {
             _isCanonicalFilename: (0, transitions_1.isCanonicalTaskFilename)(name),
         },
         body: parsed.body,
+        hasWorkDir: false,
+        workDirFiles: [],
+        derivedChildren: [],
     };
 }
 function formatFrontmatterValue(value) {

package/dist/repertoire/tasks/scanner.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTaskRoot = getTaskRoot;
 exports.ensureTaskLayout = ensureTaskLayout;
+exports.tryExtractFrontmatter = tryExtractFrontmatter;
 exports.clearTaskScanCache = clearTaskScanCache;
 exports.scanTasks = scanTasks;
 const fs = __importStar(require("fs"));
@@ -59,30 +60,57 @@ function ensureTaskLayout(root = getTaskRoot()) {
         fs.mkdirSync(dir, { recursive: true });
     }
 }
-function walkMarkdownFiles(dir, acc) {
-    if (!fs.existsSync(dir))
-        return;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.isDirectory()) {
-            if (transitions_1.TASK_RESERVED_DIRECTORIES.includes(entry.name)) {
+/**
+ * Attempt to extract frontmatter from markdown content.
+ * Returns parsed frontmatter dict or null. Never throws.
+ */
+function tryExtractFrontmatter(content) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "repertoire.frontmatter_extract_start",
+        component: "repertoire",
+        message: "attempting frontmatter extraction",
+    });
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---") {
+        return null;
+    }
+    const closing = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (closing === -1) {
+        return null;
+    }
+    const rawFrontmatter = lines.slice(1, closing).join("\n");
+    return (0, parser_1.parseFrontmatter)(rawFrontmatter);
+}
+const LEGACY_TASK_TYPES = ["one-shot", "ongoing", "habit"];
+function buildFingerprint(root) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "repertoire.fingerprint_build_start",
+        component: "repertoire",
+        message: "building scan fingerprint",
+        meta: { root },
+    });
+    const segments = [];
+    for (const collection of transitions_1.TASK_CANONICAL_COLLECTIONS) {
+        const collDir = path.join(root, collection);
+        const entries = fs.readdirSync(collDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
                 continue;
-            }
-            walkMarkdownFiles(path.join(dir, entry.name), acc);
-            continue;
-        }
-        if (entry.name.endsWith(".md")) {
-            acc.push(path.join(dir, entry.name));
+            const filePath = path.join(collDir, entry.name);
+            const stat = fs.statSync(filePath);
+            segments.push(`${filePath}:${stat.mtimeMs}:${stat.size}`);
         }
     }
-}
-function buildFingerprint(paths) {
-    const segments = paths
-        .map((filePath) => {
+    // Also include root-level md files for orphan detection fingerprinting
+    const rootEntries = fs.readdirSync(root, { withFileTypes: true });
+    for (const entry of rootEntries) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const filePath = path.join(root, entry.name);
         const stat = fs.statSync(filePath);
-        return `${filePath}:${stat.mtimeMs}:${stat.size}`;
-    })
-        .sort();
+        segments.push(`${filePath}:${stat.mtimeMs}:${stat.size}`);
+    }
+    segments.sort();
     return segments.join("|");
 }
 function clearTaskScanCache() {
@@ -96,35 +124,164 @@ function scanTasks(root = getTaskRoot()) {
         meta: { root },
     });
     ensureTaskLayout(root);
-    const files = [];
-    for (const collection of transitions_1.TASK_CANONICAL_COLLECTIONS) {
-        walkMarkdownFiles(path.join(root, collection), files);
-    }
-    const fingerprint = buildFingerprint(files);
+    const fingerprint = buildFingerprint(root);
     if (scanCache && scanCache.fingerprint === fingerprint) {
         return scanCache.index;
     }
     const tasks = [];
-    const parseErrors = [];
-    const invalidFilenames = [];
-    for (const filePath of files) {
-        const base = path.basename(filePath);
-        if (!(0, transitions_1.isCanonicalTaskFilename)(base)) {
-            invalidFilenames.push(filePath);
+    const issues = [];
+    // Scan each collection with flat directory reads (no recursion)
+    for (const collection of transitions_1.TASK_CANONICAL_COLLECTIONS) {
+        const collDir = path.join(root, collection);
+        const entries = fs.readdirSync(collDir, { withFileTypes: true });
+        const dirNames = new Set();
+        // Collect directory names for work dir detection
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                dirNames.add(entry.name);
+            }
         }
-        try {
+        // Process only .md files at collection root (flat, no recursion)
+        let supportDocCount = 0;
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            const filePath = path.join(collDir, entry.name);
             const content = fs.readFileSync(filePath, "utf-8");
-            tasks.push((0, parser_1.parseTaskFile)(content, filePath));
+            // Step 1: Try to extract frontmatter
+            const frontmatter = tryExtractFrontmatter(content);
+            if (!frontmatter) {
+                // No frontmatter — not a task, count as support doc clutter
+                supportDocCount += 1;
+                continue;
+            }
+            // Step 2: Check kind: task
+            const isKindTask = frontmatter.kind === "task";
+            const fmType = typeof frontmatter.type === "string" ? frontmatter.type.trim().toLowerCase() : "";
+            const isLegacyTask = !isKindTask && LEGACY_TASK_TYPES.includes(fmType);
+            if (!isKindTask && !isLegacyTask) {
+                // Has frontmatter but not a task — skip silently
+                continue;
+            }
+            // Step 3: Emit migration issue for legacy task
+            if (isLegacyTask) {
+                const relPath = path.relative(root, filePath);
+                issues.push({
+                    target: relPath,
+                    code: "schema-missing-kind",
+                    description: "Task card missing kind: task field",
+                    fix: "Add kind: task to frontmatter",
+                    confidence: "safe",
+                    category: "migration",
+                });
+            }
+            // Step 4: Parse the task file
+            try {
+                const task = (0, parser_1.parseTaskFile)(content, filePath);
+                // Check filename canonicality
+                const base = path.basename(filePath);
+                if (!(0, transitions_1.isCanonicalTaskFilename)(base)) {
+                    const relPath = path.relative(root, filePath);
+                    issues.push({
+                        target: relPath,
+                        code: "filename-not-canonical",
+                        description: `Non-canonical filename: ${base}`,
+                        fix: `Rename to canonical format (YYYY-MM-DD-HHMM-slug.md)`,
+                        confidence: "safe",
+                        category: "migration",
+                    });
+                }
+                // Work dir detection
+                const stem = base.replace(/\.md$/i, "");
+                if (dirNames.has(stem)) {
+                    task.hasWorkDir = true;
+                    const workDirPath = path.join(collDir, stem);
+                    task.workDirFiles = fs.readdirSync(workDirPath).sort();
+                }
+                tasks.push(task);
+            }
+            catch (error) {
+                // Parse error on a file we identified as a task — real issue
+                const relPath = path.relative(root, filePath);
+                issues.push({
+                    target: relPath,
+                    code: "schema-invalid",
+                    description: `Parse error: ${error instanceof Error ? error.message : String(error)}`,
+                    fix: "Fix the task card schema (ensure required fields: type, status, etc.)",
+                    confidence: "needs_review",
+                    category: "live",
+                });
+            }
+        }
+        // Summarize non-task support docs at collection root as one migration issue
+        if (supportDocCount > 0) {
+            (0, runtime_1.emitNervesEvent)({
+                event: "repertoire.support_docs_detected",
+                component: "repertoire",
+                message: "non-task support documents at collection root",
+                meta: { collection, count: supportDocCount },
+            });
+            issues.push({
+                target: collection,
+                code: "org-collection-root-clutter",
+                description: `${supportDocCount} non-task file${supportDocCount === 1 ? "" : "s"} at ${collection}/ root (doing docs, planning docs, etc.)`,
+                fix: "Move support docs into same-stem work directories for their parent tasks",
+                confidence: "needs_review",
+                category: "migration",
+            });
+        }
+    }
+    // Orphan detection: root-level .md files outside any canonical collection
+    const rootEntries = fs.readdirSync(root, { withFileTypes: true });
+    const collectionSet = new Set(transitions_1.TASK_CANONICAL_COLLECTIONS);
+    for (const entry of rootEntries) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const filePath = path.join(root, entry.name);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const frontmatter = tryExtractFrontmatter(content);
+        // Only flag as orphan if it has task-like frontmatter
+        if (!frontmatter)
+            continue;
+        const fmType = typeof frontmatter.type === "string" ? frontmatter.type.trim().toLowerCase() : "";
+        const hasTaskLikeContent = frontmatter.kind === "task" ||
+            LEGACY_TASK_TYPES.includes(fmType) ||
+            (typeof frontmatter.status === "string" && typeof frontmatter.title === "string");
+        if (hasTaskLikeContent) {
+            (0, runtime_1.emitNervesEvent)({
+                event: "repertoire.orphan_detected",
+                component: "repertoire",
+                message: "root-level orphan document detected",
+                meta: { filePath },
+            });
+            issues.push({
+                target: entry.name,
+                code: "org-root-level-doc",
+                description: `Root-level document outside any collection: ${entry.name}`,
+                fix: `Move to appropriate collection directory (${[...collectionSet].join(", ")})`,
+                confidence: "needs_review",
+                category: "migration",
+            });
         }
-        catch (error) {
-            parseErrors.push(`${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Populate derivedChildren from parent_task links
+    const stemToTask = new Map();
+    for (const task of tasks) {
+        stemToTask.set(task.stem, task);
+    }
+    for (const task of tasks) {
+        const parentStem = typeof task.frontmatter.parent_task === "string"
+            ? task.frontmatter.parent_task.trim()
+            : "";
+        if (parentStem && stemToTask.has(parentStem)) {
+            const parent = stemToTask.get(parentStem);
+            parent.derivedChildren.push(task.stem);
         }
     }
     const index = {
         root,
         tasks,
-        invalidFilenames,
-        parseErrors,
+        issues,
         fingerprint,
     };
     scanCache = { fingerprint, index };

package/dist/repertoire/tasks/transitions.js

@@ -16,15 +16,17 @@ exports.TASK_VALID_STATUSES = [
     "paused",
     "blocked",
     "done",
+    "cancelled",
 ];
 exports.TASK_STATUS_TRANSITIONS = {
-    drafting: ["processing", "collaborating"],
-    processing: ["validating", "paused", "blocked"],
-    validating: ["done", "processing", "collaborating"],
-    collaborating: ["processing", "validating", "paused"],
-    paused: ["processing", "blocked"],
-    blocked: ["processing", "paused"],
+    drafting: ["processing", "collaborating", "cancelled"],
+    processing: ["validating", "paused", "blocked", "cancelled"],
+    validating: ["done", "processing", "collaborating", "cancelled"],
+    collaborating: ["processing", "validating", "paused", "cancelled"],
+    paused: ["processing", "blocked", "cancelled"],
+    blocked: ["processing", "paused", "cancelled"],
     done: [],
+    cancelled: [],
 };
 exports.TASK_CANONICAL_TYPES = [
     "one-shot",
@@ -42,6 +44,7 @@ exports.TASK_RESERVED_DIRECTORIES = ["templates", ".trash", "archive"];
 exports.TASK_FILENAME_PATTERN = /^\d{4}-\d{2}-\d{2}-\d{4}-[a-z0-9][a-z0-9-]*\.md$/;
 exports.TASK_REQUIRED_TEMPLATE_FIELDS = {
     "one-shot": [
+        "kind",
         "type",
         "category",
         "title",
@@ -55,10 +58,10 @@ exports.TASK_REQUIRED_TEMPLATE_FIELDS = {
         "updated",
         "parent_task",
         "depends_on",
-        "child_tasks",
         "artifacts",
     ],
     ongoing: [
+        "kind",
         "type",
         "category",
         "title",
@@ -70,7 +73,6 @@ exports.TASK_REQUIRED_TEMPLATE_FIELDS = {
         "lastRun",
         "created",
         "updated",
-        "child_tasks",
         "artifacts",
     ],
 };

package/dist/repertoire/tools-base.js

@@ -179,7 +179,9 @@ function emptyTaskBoard() {
             paused: [],
             blocked: [],
             done: [],
+            cancelled: [],
         },
+        issues: [],
         actionRequired: [],
         unresolvedDependencies: [],
         activeSessions: [],

package/dist/senses/habit-turn-message.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHabitTurnMessage = buildHabitTurnMessage;
+const runtime_1 = require("../nerves/runtime");
+function formatElapsed(ms) {
+    const minutes = Math.floor(ms / 60000);
+    if (minutes < 60) {
+        return `${minutes} ${minutes === 1 ? "minute" : "minutes"}`;
+    }
+    const hours = Math.floor(minutes / 60);
+    return `${hours} ${hours === 1 ? "hour" : "hours"}`;
+}
+function buildHabitTurnMessage(options) {
+    const { habitName, habitTitle, habitBody, lastRun, checkpoint, alsoDue, staleObligations, parseErrors, degradedComponents, now, } = options;
+    const hasBody = habitBody !== undefined && habitBody !== "";
+    // First beat: lastRun is null
+    if (lastRun === null) {
+        // Cold start: no checkpoint, no body — bare awareness
+        if (!checkpoint && !hasBody) {
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.habit_turn_message_built",
+                message: "habit turn message built (cold start)",
+                meta: { habitName, coldStart: true },
+            });
+            return "...time passing. anything stirring?";
+        }
+        if (!hasBody) {
+            // First beat with no body: nudge
+            const sections = [
+                `your ${habitTitle} fired but has no instructions \u2014 add a body to \`habits/${habitName}.md\``,
+            ];
+            appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.habit_turn_message_built",
+                message: "habit turn message built (first beat, no body)",
+                meta: { habitName, firstBeat: true, hasBody: false },
+            });
+            return sections.join("\n\n");
+        }
+        const sections = [
+            `your ${habitTitle} is alive. this is its first breath.`,
+            habitBody,
+        ];
+        appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+        (0, runtime_1.emitNervesEvent)({
+            component: "senses",
+            event: "senses.habit_turn_message_built",
+            message: "habit turn message built (first beat)",
+            meta: { habitName, firstBeat: true },
+        });
+        return sections.join("\n\n");
+    }
+    // Normal turn
+    const sections = [];
+    // 1. Checkpoint
+    if (checkpoint) {
+        sections.push(`you were thinking about ${checkpoint}.`);
+    }
+    // 2. Elapsed time
+    const nowMs = now().getTime();
+    const lastRunMs = new Date(lastRun).getTime();
+    const elapsed = nowMs - lastRunMs;
+    sections.push(`${formatElapsed(elapsed)} have passed.`);
+    // 3. Body or no-body nudge
+    if (hasBody) {
+        sections.push(habitBody);
+    }
+    else {
+        sections.push(`your ${habitTitle} fired but has no instructions \u2014 add a body to \`habits/${habitName}.md\``);
+    }
+    // 4-7. Trailing extras
+    appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.habit_turn_message_built",
+        message: "habit turn message built",
+        meta: {
+            habitName,
+            hasCheckpoint: !!checkpoint,
+            hasBody: hasBody,
+            staleObligationCount: staleObligations.length,
+        },
+    });
+    return sections.join("\n\n");
+}
+function appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents) {
+    // 4. Also-due
+    if (alsoDue) {
+        sections.push(alsoDue);
+    }
+    // 5. Stale obligations
+    if (staleObligations.length > 0) {
+        const lines = staleObligations.map((o) => `something for ${o.friendName} has been sitting for ${formatElapsed(o.stalenessMs)}`);
+        sections.push(lines.join("\n"));
+    }
+    // 6. Parse errors
+    if (parseErrors.length > 0) {
+        const lines = parseErrors.map((e) => `I noticed my habit file \`${e.file}\` has invalid frontmatter \u2014 I should fix it. (${e.error})`);
+        sections.push(lines.join("\n"));
+    }
+    // 7. Degraded state
+    if (degradedComponents.length > 0) {
+        const reasons = degradedComponents.map((d) => `${d.component}: ${d.reason}`).join("; ");
+        sections.push(`[note: my scheduling is degraded: ${reasons}]`);
+    }
+}

package/dist/senses/inner-dialog.js

@@ -67,7 +67,7 @@ const manager_1 = require("../heart/bridges/manager");
 const session_activity_1 = require("../heart/session-activity");
 const bluebubbles_1 = require("./bluebubbles");
 const obligations_2 = require("../heart/obligations");
-const contextual_heartbeat_1 = require("./contextual-heartbeat");
+const habit_turn_message_1 = require("./habit-turn-message");
 const journal_index_1 = require("../mind/journal-index");
 const habit_parser_1 = require("../heart/daemon/habit-parser");
 const cadence_1 = require("../heart/daemon/cadence");
@@ -559,106 +559,65 @@ async function runInnerDialogTurn(options) {
                 const habitFilePath = path.join(agentRoot, "habits", `${habitName}.md`);
                 // Read and parse the habit file
                 let habitBody;
+                let habitTitle = habitName;
                 let habitLastRun = null;
                 try {
                     const habitContent = fs.readFileSync(habitFilePath, "utf-8");
                     const parsed = (0, habit_parser_1.parseHabitFile)(habitContent, habitFilePath);
-                    habitBody = parsed.body;
+                    habitBody = parsed.body || undefined;
+                    habitTitle = parsed.title || habitName;
                     habitLastRun = parsed.lastRun;
                 }
                 catch {
                     // Habit file missing or unreadable
                 }
-                if (habitName === "heartbeat") {
-                    // Heartbeat habit: use contextual heartbeat builder with habit body
-                    const journalDir = path.join(agentRoot, "journal");
-                    const runtimeStatePath = innerDialogRuntimeStatePath(sessionFilePath);
-                    let lastCompletedAt;
-                    try {
-                        const raw = fs.readFileSync(runtimeStatePath, "utf-8");
-                        const runtimeState = JSON.parse(raw);
-                        lastCompletedAt = typeof runtimeState.lastCompletedAt === "string" ? runtimeState.lastCompletedAt : undefined;
-                    }
-                    catch {
-                        // no runtime state — will get cold start fallback
-                    }
+                // If the habit file couldn't be read at all (no body, no title parsed), error message
+                if (habitBody === undefined && habitTitle === habitName) {
+                    userContent = `habit "${habitName}" could not be read (file not found or unreadable). check habits/${habitName}.md exists.`;
+                }
+                else {
+                    // Unified path: gather context for ALL habits (heartbeat included)
                     const obligations = (0, obligations_1.listActiveObligations)(agentName);
                     const nowMs = now().getTime();
-                    const pendingObligations = obligations.map((o) => ({
-                        id: o.id,
-                        content: o.delegatedContent,
+                    const staleObligations = obligations.map((o) => ({
                         friendName: o.origin.friendId,
-                        timestamp: o.createdAt,
-                        staleness: nowMs - o.createdAt,
+                        content: o.delegatedContent,
+                        stalenessMs: nowMs - o.createdAt,
                     }));
-                    const heartbeatContent = (0, contextual_heartbeat_1.buildContextualHeartbeat)({
-                        journalDir,
-                        lastCompletedAt,
-                        pendingObligations,
-                        lastSurfaceAt: undefined,
-                        checkpoint: state.checkpoint,
-                        now,
-                        readJournalDir: () => (0, prompt_1.readJournalFiles)(journalDir),
+                    const alsoDue = buildAlsoDueLine(agentRoot, habitName, now);
+                    // Degraded state (best-effort: never crash)
+                    let degradedComponents = [];
+                    try {
+                        const health = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
+                        if (health && health.degraded.length > 0) {
+                            degradedComponents = health.degraded.map((d) => ({ component: d.component, reason: d.reason }));
+                        }
+                    }
+                    catch {
+                        // Best-effort: missing file or parse error -> empty array, no crash
+                    }
+                    userContent = (0, habit_turn_message_1.buildHabitTurnMessage)({
+                        habitName,
+                        habitTitle,
                         habitBody,
+                        lastRun: habitLastRun,
+                        checkpoint: displayCheckpoint(state.checkpoint),
+                        alsoDue: alsoDue || undefined,
+                        staleObligations,
+                        parseErrors: options?.parseErrors ?? [],
+                        degradedComponents,
+                        now,
                     });
-                    // Build also-due line
-                    const alsoDue = buildAlsoDueLine(agentRoot, habitName, now);
-                    userContent = alsoDue ? `${heartbeatContent}\n\n${alsoDue}` : heartbeatContent;
-                    // Parse error nudge
-                    const parseErrorNudge = buildParseErrorNudge(options?.parseErrors ?? []);
-                    if (parseErrorNudge)
-                        userContent = `${userContent}\n\n${parseErrorNudge}`;
                     // Piggyback journal embedding indexing (best-effort, fire-and-forget)
+                    const journalDir = path.join(agentRoot, "journal");
                     /* v8 ignore start -- journal indexing piggyback: embedding provider may not be available; tested via journal-index unit tests @preserve */
                     void (0, journal_index_1.indexJournalFiles)(journalDir, path.join(journalDir, ".index.json"), {
                         embed: async () => [],
                     }).catch(() => {
-                        // swallowed: indexing failure must never block heartbeat
+                        // swallowed: indexing failure must never block habit turn
                     });
                     /* v8 ignore stop */
                 }
-                else if (habitBody !== undefined) {
-                    // Non-heartbeat habit: basic context + body
-                    const sections = [];
-                    // Elapsed time since last run
-                    if (habitLastRun) {
-                        const lastRunMs = new Date(habitLastRun).getTime();
-                        const elapsed = now().getTime() - lastRunMs;
-                        const minutes = Math.floor(elapsed / 60000);
-                        if (minutes < 60) {
-                            sections.push(`it's been ${minutes} ${minutes === 1 ? "minute" : "minutes"} since ${habitName} last ran.`);
-                        }
-                        else {
-                            const hours = Math.floor(minutes / 60);
-                            sections.push(`it's been ${hours} ${hours === 1 ? "hour" : "hours"} since ${habitName} last ran.`);
-                        }
-                    }
-                    sections.push(`## habit: ${habitName}\n${habitBody}`);
-                    // Also due line
-                    const alsoDue = buildAlsoDueLine(agentRoot, habitName, now);
-                    if (alsoDue)
-                        sections.push(alsoDue);
-                    // Parse error nudge
-                    const parseErrorNudge = buildParseErrorNudge(options?.parseErrors ?? []);
-                    if (parseErrorNudge)
-                        sections.push(parseErrorNudge);
-                    userContent = sections.join("\n\n");
-                }
-                else {
-                    // Habit file not found
-                    userContent = `habit "${habitName}" could not be read (file not found or unreadable). check habits/${habitName}.md exists.`;
-                }
-                // Degraded state nudge (best-effort: never crash on health file read failure)
-                try {
-                    const health = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
-                    if (health && health.degraded.length > 0) {
-                        const reasons = health.degraded.map((d) => `${d.component}: ${d.reason}`).join("; ");
-                        userContent = `${userContent}\n\n[note: my scheduling is degraded: ${reasons}]`;
-                    }
-                }
-                catch {
-                    // Best-effort: missing file or parse error -> no nudge, no crash
-                }
             }
             else {
                 userContent = buildInstinctUserMessage(instincts, reason, state);

package/dist/senses/pipeline.js

@@ -37,7 +37,9 @@ function emptyTaskBoard() {
             paused: [],
             blocked: [],
             done: [],
+            cancelled: [],
         },
+        issues: [],
         actionRequired: [],
         unresolvedDependencies: [],
         activeSessions: [],

package/package.json

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

package/dist/senses/contextual-heartbeat.js

@@ -1,106 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildContextualHeartbeat = buildContextualHeartbeat;
-const runtime_1 = require("../nerves/runtime");
-const STALE_THRESHOLD_MS = 30 * 60 * 1000; // 30 minutes
-const MAX_JOURNAL_FILES = 10;
-function formatElapsed(ms) {
-    const minutes = Math.floor(ms / 60000);
-    if (minutes < 60) {
-        return `${minutes} ${minutes === 1 ? "minute" : "minutes"}`;
-    }
-    const hours = Math.floor(minutes / 60);
-    return `${hours} ${hours === 1 ? "hour" : "hours"}`;
-}
-function formatRelativeTime(nowMs, mtimeMs) {
-    const diffMs = nowMs - mtimeMs;
-    const minutes = Math.floor(diffMs / 60000);
-    if (minutes < 1)
-        return "just now";
-    if (minutes < 60)
-        return `${minutes} ${minutes === 1 ? "minute" : "minutes"} ago`;
-    const hours = Math.floor(minutes / 60);
-    if (hours < 24)
-        return `${hours} ${hours === 1 ? "hour" : "hours"} ago`;
-    const days = Math.floor(hours / 24);
-    return `${days} ${days === 1 ? "day" : "days"} ago`;
-}
-function buildContextualHeartbeat(options) {
-    const { lastCompletedAt, pendingObligations, lastSurfaceAt, checkpoint, now, readJournalDir, habitBody, } = options;
-    const nowDate = now();
-    const nowMs = nowDate.getTime();
-    const journalFiles = readJournalDir();
-    // Cold start: no journal files and no runtime state
-    if (journalFiles.length === 0 && !lastCompletedAt) {
-        const lines = ["...time passing. anything stirring?"];
-        if (checkpoint) {
-            lines.push(`\nlast i remember: ${checkpoint}`);
-        }
-        (0, runtime_1.emitNervesEvent)({
-            component: "senses",
-            event: "senses.contextual_heartbeat_built",
-            message: "contextual heartbeat built (cold start)",
-            meta: { coldStart: true },
-        });
-        return lines.join("\n");
-    }
-    const sections = [];
-    // Elapsed time since last turn
-    if (lastCompletedAt) {
-        const lastMs = new Date(lastCompletedAt).getTime();
-        const elapsed = nowMs - lastMs;
-        sections.push(`it's been ${formatElapsed(elapsed)} since your last turn.`);
-    }
-    // Habit body (instructions from habit file)
-    if (habitBody) {
-        sections.push(habitBody);
-    }
-    // Pending attention count
-    if (pendingObligations.length > 0) {
-        const count = pendingObligations.length;
-        sections.push(`you're holding ${count} ${count === 1 ? "thought" : "thoughts"}.`);
-    }
-    // Journal index
-    if (journalFiles.length > 0) {
-        const sorted = [...journalFiles].sort((a, b) => b.mtime - a.mtime).slice(0, MAX_JOURNAL_FILES);
-        const indexLines = ["## journal"];
-        for (const file of sorted) {
-            const ago = formatRelativeTime(nowMs, file.mtime);
-            const previewClause = file.preview ? ` — ${file.preview}` : "";
-            indexLines.push(`- ${file.name} (${ago})${previewClause}`);
-        }
-        sections.push(indexLines.join("\n"));
-    }
-    // Journal entries since last surface
-    if (lastSurfaceAt && journalFiles.length > 0) {
-        const surfaceMs = new Date(lastSurfaceAt).getTime();
-        const entriesSinceSurface = journalFiles.filter((f) => f.mtime > surfaceMs).length;
-        if (entriesSinceSurface > 0) {
-            const surfaceElapsed = formatElapsed(nowMs - surfaceMs);
-            sections.push(`${entriesSinceSurface} journal ${entriesSinceSurface === 1 ? "entry" : "entries"} since you last surfaced, ${surfaceElapsed} ago.`);
-        }
-    }
-    // Stale obligation alerts
-    const staleObligations = pendingObligations.filter((o) => o.staleness >= STALE_THRESHOLD_MS);
-    if (staleObligations.length > 0) {
-        for (const obligation of staleObligations) {
-            sections.push(`this has been sitting for ${formatElapsed(obligation.staleness)}: ${obligation.content}`);
-        }
-    }
-    // Checkpoint
-    if (checkpoint) {
-        sections.push(`last i remember: ${checkpoint}`);
-    }
-    (0, runtime_1.emitNervesEvent)({
-        component: "senses",
-        event: "senses.contextual_heartbeat_built",
-        message: "contextual heartbeat built",
-        meta: {
-            hasJournal: journalFiles.length > 0,
-            hasLastCompleted: !!lastCompletedAt,
-            obligationCount: pendingObligations.length,
-            staleCount: staleObligations.length,
-        },
-    });
-    return sections.join("\n\n");
-}