@ouro.bot/cli 0.1.0-alpha.665 → 0.1.0-alpha.667

package/dist/heart/cross-chat-delivery.js

@@ -13,11 +13,12 @@ function buildPendingEnvelope(request, agentName, now) {
         timestamp: now,
     };
 }
-function queueForLater(request, deps, detail) {
+function queueForLater(request, deps, detail, rawStatus = "queued_for_later") {
     deps.queuePending(buildPendingEnvelope(request, deps.agentName, (deps.now ?? Date.now)()));
     return {
         status: "queued_for_later",
         detail,
+        ...(rawStatus !== "queued_for_later" ? { rawStatus } : {}),
     };
 }
 function isExplicitlyAuthorized(request) {
@@ -94,7 +95,7 @@ async function deliverCrossChatMessage(request, deps) {
             });
             return result;
         }
-        const result = queueForLater(request, deps, direct.detail.trim() || "live delivery unavailable right now; queued for the next active turn");
+        const result = queueForLater(request, deps, direct.detail.trim() || "live delivery unavailable right now; queued for the next active turn", direct.status);
         (0, runtime_1.emitNervesEvent)({
             component: "engine",
             event: "engine.cross_chat_delivery_end",

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

@@ -96,6 +96,7 @@ const cli_help_1 = require("./cli-help");
 const plugin_cli_1 = require("./plugin-cli");
 const cli_desk_1 = require("./cli-desk");
 const migrate_to_desk_1 = require("./migrate-to-desk");
+const core_2 = require("../../nerves/review/core");
 const cli_render_1 = require("./cli-render");
 const cli_defaults_1 = require("./cli-defaults");
 const agent_config_check_1 = require("./agent-config-check");
@@ -150,6 +151,58 @@ function returnCliFailure(deps, message, exitCode = 1) {
     deps.writeStdout(message);
     return message;
 }
+function renderHabitSummaryCli(summary) {
+    return [
+        `${summary.runId}  habit=${summary.habitName}  outcome=${summary.status}  completedAt=${summary.completedAt}`,
+        summary.operationId ? `operation=${summary.operationId}` : null,
+        `summary=${summary.summary}`,
+        summary.nextLikelyStep ? `next=${summary.nextLikelyStep}` : null,
+        summary.decisions.length > 0 ? `decisions=${summary.decisions.join("; ")}` : null,
+        `pending=${summary.pending.count}${summary.pending.files.length > 0 ? ` (${summary.pending.files.join(", ")})` : ""}`,
+        `messages=${summary.messagesSent.length}`,
+        `tools=${summary.toolsUsed.length > 0 ? summary.toolsUsed.join(",") : "none"}`,
+        summary.producedRefs.length > 0 ? `refs=${summary.producedRefs.map((ref) => `${ref.kind}:${ref.locator}`).join(",")}` : null,
+        summary.errors.length > 0 ? `errors=${summary.errors.join("; ")}` : null,
+        summary.warnings.length > 0 ? `warnings=${summary.warnings.join("; ")}` : null,
+        `receipt=${summary.sources.receipt}`,
+        `session=${summary.sources.session}`,
+        `runtime=${summary.sources.runtimeState}`,
+    ].filter((line) => Boolean(line)).join("\n");
+}
+function executeNervesReviewCommand(command, deps) {
+    let sinceMs;
+    if (command.since) {
+        const parsed = (0, core_2.parseDuration)(command.since);
+        if (parsed === null) {
+            const message = `nerves-review: --since '${command.since}' is not a valid duration (e.g. 5m, 2h, 1d)`;
+            deps.setExitCode?.(2);
+            deps.writeStdout(message);
+            return message;
+        }
+        sinceMs = parsed;
+    }
+    const logsDir = (0, identity_1.getAgentDaemonLogsDir)(command.agent);
+    const filePath = path.join(logsDir, `${command.process}.ndjson`);
+    const entries = (0, core_2.reviewNerveEvents)(filePath, {
+        componentSubstring: command.component,
+        eventSubstring: command.event,
+        level: command.level,
+        sinceMs,
+        limit: command.limit,
+        nowMs: Date.now(),
+    });
+    const message = entries.length === 0
+        ? `(no matching nerves events in ${filePath})`
+        : entries.map((entry) => command.json ? entry.raw : (0, core_2.formatNerveEntry)(entry)).join("\n");
+    deps.writeStdout(message);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.nerves_review_cli_read",
+        message: "nerves review CLI read local log events",
+        meta: { agent: command.agent, process: command.process, count: entries.length, json: command.json },
+    });
+    return message;
+}
 function summarizeDaemonStartupFailure(result) {
     if (result.startupFailureReason && result.startupFailureReason.trim().length > 0) {
         return result.startupFailureReason;
@@ -364,6 +417,10 @@ function agentResolutionFailureMode(command) {
         case "friend.update":
         case "habit.list":
         case "habit.create":
+        case "habit.runs":
+        case "habit.inspect":
+        case "habit.summary":
+        case "nerves-review":
         case "thoughts":
         case "attention.list":
         case "attention.show":
@@ -5682,6 +5739,9 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
     if (command.kind === "hook") {
         await refreshHookSentinel(command, deps);
     }
+    if (command.kind === "nerves-review") {
+        return executeNervesReviewCommand(command, deps);
+    }
     if (args.length === 0) {
         const discovered = await Promise.resolve(deps.listDiscoveredAgents ? deps.listDiscoveredAgents() : (0, cli_defaults_1.defaultListDiscoveredAgents)());
         /* v8 ignore start -- the interactive home shell is exercised extensively in daemon-cli tests; V8 miscounts this orchestrator because it chains through recursive command handoffs and early chat health exits @preserve */
@@ -6841,9 +6901,11 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
         return result.summary;
     }
     // ── habit subcommands (local, no daemon socket needed) ──
-    if (command.kind === "habit.list" || command.kind === "habit.create") {
+    if (command.kind === "habit.list" || command.kind === "habit.create" || command.kind === "habit.runs" || command.kind === "habit.inspect" || command.kind === "habit.summary") {
         const { parseHabitFile, renderHabitFile } = await Promise.resolve().then(() => __importStar(require("../habits/habit-parser")));
         const { applyHabitRuntimeState } = await Promise.resolve().then(() => __importStar(require("../habits/habit-runtime-state")));
+        const { listHabitRunReceipts, readHabitRunReceipt } = await Promise.resolve().then(() => __importStar(require("../../arc/flight-recorder")));
+        const { readHabitSessionSummary } = await Promise.resolve().then(() => __importStar(require("../habits/habit-session-summary")));
         /* 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 */
@@ -6874,6 +6936,82 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             deps.writeStdout(message);
             return message;
         }
+        if (command.kind === "habit.runs") {
+            const receipts = listHabitRunReceipts(bundleRoot, { limit: command.limit });
+            const message = receipts.length === 0
+                ? "no habit runs found"
+                : receipts.map((receipt) => [
+                    receipt.runId,
+                    `habit=${receipt.habitName}`,
+                    `trigger=${receipt.trigger}`,
+                    `outcome=${receipt.outcome}`,
+                    `endedAt=${receipt.endedAt}`,
+                    `receipt=${receipt.receiptLocator}`,
+                ].join("  ")).join("\n");
+            deps.writeStdout(message);
+            (0, runtime_1.emitNervesEvent)({
+                component: "daemon",
+                event: "daemon.habit_runs_cli_read",
+                message: "habit run receipts listed from CLI",
+                meta: { agent: command.agent, limit: command.limit, count: receipts.length },
+            });
+            return message;
+        }
+        if (command.kind === "habit.inspect") {
+            const receipt = readHabitRunReceipt(bundleRoot, command.runId);
+            if (!receipt) {
+                const message = `error: habit run '${command.runId}' not found`;
+                deps.writeStdout(message);
+                deps.setExitCode?.(1);
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "daemon",
+                    event: "daemon.habit_run_cli_read_missing",
+                    message: "habit run receipt not found from CLI",
+                    meta: { agent: command.agent, runId: command.runId },
+                });
+                return message;
+            }
+            const message = `${JSON.stringify(receipt, null, 2)}\n`;
+            deps.writeStdout(message);
+            (0, runtime_1.emitNervesEvent)({
+                component: "daemon",
+                event: "daemon.habit_run_cli_read",
+                message: "habit run receipt read from CLI",
+                meta: { agent: command.agent, runId: command.runId },
+            });
+            return message;
+        }
+        if (command.kind === "habit.summary") {
+            const summary = readHabitSessionSummary(bundleRoot, {
+                ...(command.runId ? { runId: command.runId } : {}),
+                ...(command.habitName ? { habitName: command.habitName } : {}),
+                ...(command.operationId ? { operationId: command.operationId } : {}),
+                ...(command.which ? { which: command.which } : {}),
+            });
+            if (!summary) {
+                const message = "error: habit summary not found";
+                deps.writeStdout(message);
+                deps.setExitCode?.(1);
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "daemon",
+                    event: "daemon.habit_summary_cli_read_missing",
+                    message: "habit run summary not found from CLI",
+                    meta: { agent: command.agent, runId: command.runId, habitName: command.habitName, operationId: command.operationId, which: command.which },
+                });
+                return message;
+            }
+            const message = command.json ? `${JSON.stringify(summary, null, 2)}\n` : renderHabitSummaryCli(summary);
+            deps.writeStdout(message);
+            (0, runtime_1.emitNervesEvent)({
+                component: "daemon",
+                event: "daemon.habit_summary_cli_read",
+                message: "habit run summary read from CLI",
+                meta: { agent: command.agent, runId: summary.runId, habitName: summary.habitName, json: command.json },
+            });
+            return message;
+        }
         // habit.create
         const filePath = path.join(habitsDir, `${command.name}.md`);
         if (fs.existsSync(filePath)) {

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

@@ -127,7 +127,7 @@ exports.COMMAND_REGISTRY = {
     poke: {
         category: "Tasks",
         description: "Poke an agent about a task or habit",
-        usage: "ouro poke <agent> --task <task-id> | --habit <name>",
+        usage: "ouro poke <agent> --task <task-id> | --habit <name> [--trigger poke|launchd|cron|overdue|manual]",
         example: "ouro poke ouroboros --task abc123",
     },
     habit: {
@@ -135,7 +135,7 @@ exports.COMMAND_REGISTRY = {
         description: "Manage agent habits",
         usage: "ouro habit <subcommand> [--agent <name>]",
         example: "ouro habit list",
-        subcommands: ["list", "create", "poke"],
+        subcommands: ["list", "create", "runs", "inspect", "summary", "poke"],
     },
     desk: {
         category: "Tasks",
@@ -158,6 +158,12 @@ exports.COMMAND_REGISTRY = {
         example: "ouro work sentinel --agent slugger --format json",
         subcommands: ["card", "gauntlet", "sentinel"],
     },
+    "nerves-review": {
+        category: "Internal",
+        description: "Read-only review of recent nerves events from an agent log stream",
+        usage: "ouro nerves-review [--agent <name>] [--process <name>] [--component <substr>] [--event <substr>] [--level <level>] [--since <duration>] [--limit <n>] [--json]",
+        example: "ouro nerves-review --agent slugger --component daemon --event habit --since 30m --json",
+    },
     "work card": {
         category: "Tasks",
         description: "Show the agent's durable Work Card compiled from arc records.",
@@ -395,6 +401,11 @@ const SUBCOMMAND_HELP = {
         usage: "ouro account ensure [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]",
         example: "ouro account ensure --agent <agent> --owner-email you@example.com --source hey",
     },
+    "habit summary": {
+        description: "Read a habit run summary from receipts and session artifacts without contacting the daemon",
+        usage: "ouro habit summary [--agent <name>] (--run-id <id>|--habit <name>|--operation-id <id>) [--which latest|previous|latest-success|latest-failure] [--json]",
+        example: "ouro habit summary --agent slugger --operation-id habit:standup --which latest --json",
+    },
     "mail import-mbox": {
         description: "Import a HEY or other MBOX export into an existing delegated Mailroom source grant",
         usage: "ouro mail import-mbox (--file <path>|--discover) [--owner-email <email>] [--source <label>] [--agent <name>] [--foreground]",

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

@@ -17,6 +17,7 @@ exports.parseOuroCommand = parseOuroCommand;
 const types_1 = require("../../mind/friends/types");
 const cli_help_1 = require("./cli-help");
 const cli_desk_1 = require("./cli-desk");
+const flight_recorder_1 = require("../../arc/flight-recorder");
 const vault_items_1 = require("./vault-items");
 // ── Shared helpers ──
 function extractAgentFlag(args) {
@@ -104,9 +105,12 @@ function usage() {
         "  ouro chat <agent>",
         "  ouro msg --to <agent> [--session <id>] [--task <ref>] <message>",
         "  ouro poke <agent> --task <task-id>",
-        "  ouro poke <agent> --habit <name>",
+        "  ouro poke <agent> --habit <name> [--trigger poke|launchd|cron|overdue|manual]",
         "  ouro habit list [--agent <name>]",
         "  ouro habit create [--agent <name>] <name> [--cadence <interval>]",
+        "  ouro habit runs [--agent <name>] [--limit <n>]",
+        "  ouro habit inspect [--agent <name>] <runId>",
+        "  ouro habit summary [--agent <name>] (--run-id <id>|--habit <name>|--operation-id <id>) [--which latest|previous|latest-success|latest-failure] [--json]",
         "  ouro link <agent> --friend <id> --provider <provider> --external-id <external-id>",
         "  ouro bluebubbles replay [--agent <name>] --message-guid <guid> [--event-type new-message|updated-message] [--json]",
         "  ouro friend list [--agent <name>]",
@@ -115,6 +119,7 @@ function usage() {
         "  ouro friend update <id> --trust <level> [--agent <name>]",
         "  ouro thoughts [--last <n>] [--json] [--follow] [--agent <name>]",
         "  ouro work card|gauntlet|sentinel [refresh] [--agent <name>] [--format text|json|--json]",
+        "  ouro nerves-review [--agent <name>] [--process <name>] [--component <substr>] [--event <substr>] [--level <level>] [--since <duration>] [--limit <n>] [--json]",
         "  ouro inner [--agent <name>]",
         "  ouro friend link <agent> --friend <id> --provider <p> --external-id <eid>",
         "  ouro friend unlink <agent> --friend <id> --provider <p> --external-id <eid>",
@@ -175,6 +180,7 @@ function parsePokeCommand(args) {
     let taskId;
     let habitName;
     let awaitName;
+    let trigger;
     for (let i = 1; i < args.length; i += 1) {
         if (args[i] === "--task") {
             taskId = args[i + 1];
@@ -188,12 +194,21 @@ function parsePokeCommand(args) {
             awaitName = args[i + 1];
             i += 1;
         }
+        if (args[i] === "--trigger") {
+            const rawTrigger = args[i + 1];
+            if (!(0, flight_recorder_1.isHabitRunTrigger)(rawTrigger))
+                throw new Error("invalid habit trigger");
+            trigger = rawTrigger;
+            i += 1;
+        }
     }
     // Priority order: --await > --habit > --task
     if (awaitName)
         return { kind: "await.poke", agent, awaitName };
     if (habitName)
-        return { kind: "habit.poke", agent, habitName };
+        return { kind: "habit.poke", agent, habitName, trigger: trigger ?? "poke" };
+    if (trigger)
+        throw new Error(`Usage\n${usage()}`);
     if (!taskId)
         throw new Error(`Usage\n${usage()}`);
     return { kind: "task.poke", agent, taskId };
@@ -227,6 +242,74 @@ function parseHabitCommand(args) {
             throw new Error(`Usage\n${usage()}`);
         return { kind: "habit.create", name, ...(agent ? { agent } : {}), ...(cadence ? { cadence } : {}) };
     }
+    if (sub === "runs") {
+        let limit = 20;
+        const options = rest.slice(1);
+        for (let i = 0; i < options.length; i += 1) {
+            if (options[i] !== "--limit" || !options[i + 1])
+                throw new Error(`Usage\n${usage()}`);
+            const parsedLimit = Number.parseInt(options[i + 1], 10);
+            if (!Number.isInteger(parsedLimit) || String(parsedLimit) !== options[i + 1] || parsedLimit < 1 || parsedLimit > 100) {
+                throw new Error("--limit must be an integer between 1 and 100");
+            }
+            limit = parsedLimit;
+            i += 1;
+        }
+        return { kind: "habit.runs", ...(agent ? { agent } : {}), limit };
+    }
+    if (sub === "inspect") {
+        const positional = rest.slice(1);
+        if (positional.length !== 1 || !positional[0])
+            throw new Error(`Usage\n${usage()}`);
+        return { kind: "habit.inspect", ...(agent ? { agent } : {}), runId: positional[0] };
+    }
+    if (sub === "summary") {
+        let runId;
+        let habitName;
+        let operationId;
+        let which;
+        let json = false;
+        const options = rest.slice(1);
+        for (let i = 0; i < options.length; i += 1) {
+            const option = options[i];
+            if (option === "--json") {
+                json = true;
+                continue;
+            }
+            if ((option === "--run-id" || option === "--habit" || option === "--operation-id" || option === "--which") && options[i + 1]) {
+                const value = options[++i];
+                if (option === "--run-id")
+                    runId = value;
+                if (option === "--habit")
+                    habitName = value;
+                if (option === "--operation-id")
+                    operationId = value;
+                if (option === "--which") {
+                    if (!["latest", "previous", "latest-success", "latest-failure"].includes(value)) {
+                        throw new Error("--which must be latest, previous, latest-success, or latest-failure");
+                    }
+                    which = value;
+                }
+                continue;
+            }
+            throw new Error(`Usage\n${usage()}`);
+        }
+        if (runId !== undefined && (habitName !== undefined || operationId !== undefined || which !== undefined)) {
+            throw new Error("--run-id cannot be combined with --habit, --operation-id, or --which");
+        }
+        if (runId === undefined && habitName === undefined && operationId === undefined) {
+            throw new Error("provide --run-id, --habit, or --operation-id");
+        }
+        return {
+            kind: "habit.summary",
+            ...(agent ? { agent } : {}),
+            ...(runId ? { runId } : {}),
+            ...(habitName ? { habitName } : {}),
+            ...(operationId ? { operationId } : {}),
+            ...(which ? { which } : {}),
+            json,
+        };
+    }
     throw new Error(`Usage\n${usage()}`);
 }
 function parseLinkCommand(args, kind = "friend.link") {
@@ -1503,6 +1586,57 @@ function parseBlueBubblesCommand(args) {
         ...(json ? { json: true } : {}),
     };
 }
+function parseNervesReviewCommand(args) {
+    const { agent, rest } = extractAgentFlag(args);
+    let processName = "daemon";
+    let component;
+    let event;
+    let level;
+    let since;
+    let limit;
+    let json = false;
+    for (let i = 0; i < rest.length; i += 1) {
+        const token = rest[i];
+        const next = rest[i + 1];
+        if (token === "--json") {
+            json = true;
+            continue;
+        }
+        if ((token === "--process" || token === "--component" || token === "--event" || token === "--level" || token === "--since" || token === "--limit") && next) {
+            if (token === "--process")
+                processName = next;
+            if (token === "--component")
+                component = next;
+            if (token === "--event")
+                event = next;
+            if (token === "--level")
+                level = next;
+            if (token === "--since")
+                since = next;
+            if (token === "--limit") {
+                const parsed = Number.parseInt(next, 10);
+                if (!Number.isInteger(parsed) || String(parsed) !== next || parsed < 1 || parsed > 1000) {
+                    throw new Error("--limit must be an integer between 1 and 1000");
+                }
+                limit = parsed;
+            }
+            i += 1;
+            continue;
+        }
+        throw new Error(`Usage\n${usage()}`);
+    }
+    return {
+        kind: "nerves-review",
+        ...(agent ? { agent } : {}),
+        process: processName,
+        ...(component ? { component } : {}),
+        ...(event ? { event } : {}),
+        ...(level ? { level } : {}),
+        ...(since ? { since } : {}),
+        ...(limit ? { limit } : {}),
+        json,
+    };
+}
 // ── Main dispatch ──
 function parseOuroCommand(args) {
     const [head, second] = args;
@@ -1670,6 +1804,8 @@ function parseOuroCommand(args) {
         return parseMessageCommand(args.slice(1));
     if (head === "poke")
         return parsePokeCommand(args.slice(1));
+    if (head === "nerves-review")
+        return parseNervesReviewCommand(args.slice(1));
     if (head === "link")
         return parseLinkCommand(args.slice(1));
     if (head === "mcp-serve")

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

@@ -149,9 +149,30 @@ const processManager = new process_manager_1.DaemonProcessManager({
     },
     /* v8 ignore stop */
 });
-const scheduler = new task_scheduler_1.TaskDrivenScheduler({
+const taskScheduler = new task_scheduler_1.TaskDrivenScheduler({
     agents: [...managedAgents],
 });
+const habitSchedulers = [];
+const awaitSchedulers = [];
+const scheduler = {
+    listJobs: () => [
+        ...taskScheduler.listJobs(),
+        ...habitSchedulers.flatMap((habitScheduler) => habitScheduler.listJobs()),
+    ],
+    triggerJob: (jobId) => taskScheduler.triggerJob(jobId),
+    triggerHabitJob: async (jobId) => {
+        for (const habitScheduler of habitSchedulers) {
+            const result = await habitScheduler.triggerJob(jobId, "cron");
+            if (result.ok)
+                return result;
+        }
+        return { ok: false, message: `unknown habit job: ${jobId}` };
+    },
+    start: () => taskScheduler.start(),
+    stop: () => taskScheduler.stop(),
+    reconcile: () => taskScheduler.reconcile(),
+    recordTaskRun: (agent, taskId) => taskScheduler.recordTaskRun(agent, taskId),
+};
 const router = new message_router_1.FileMessageRouter();
 const senseManager = new sense_manager_1.DaemonSenseManager({
     agents: [...managedAgents],
@@ -201,8 +222,6 @@ const healthMonitor = new health_monitor_1.HealthMonitor({
         catch { /* recovery is best-effort */ }
     },
 });
-const habitSchedulers = [];
-const awaitSchedulers = [];
 let entryRuntimeStopping = false;
 let stopCommandExitScheduled = false;
 function stopEntryRuntime() {
@@ -393,8 +412,8 @@ void daemon.start().then(async () => {
                 agent,
                 habitsDir,
                 osCronManager,
-                onHabitFire: (habitName) => {
-                    processManager.sendToAgent(agent, { type: "habit", habitName, trigger: "overdue" });
+                onHabitFire: (habitName, trigger) => {
+                    processManager.sendToAgent(agent, { type: "habit", habitName, trigger });
                 },
                 deps: {
                     readdir: (dir) => fs.readdirSync(dir),

package/dist/heart/daemon/daemon.js

@@ -67,6 +67,7 @@ const mailbox_read_1 = require("../mailbox/mailbox-read");
 const mailbox_view_1 = require("../mailbox/mailbox-view");
 const provider_visibility_1 = require("../provider-visibility");
 const socket_client_1 = require("./socket-client");
+const flight_recorder_1 = require("../../arc/flight-recorder");
 const PIDFILE_PATH = path.join(os.homedir(), ".ouro-cli", "daemon.pids");
 /**
  * Defense-in-depth: detect if we're running under vitest. The pidfile lives
@@ -1236,6 +1237,10 @@ class OuroDaemon {
                 return { ok: true, summary, data: jobs };
             }
             case "cron.trigger": {
+                const habitResult = await this.scheduler.triggerHabitJob?.(command.jobId);
+                if (habitResult?.ok) {
+                    return { ok: true, message: habitResult.message };
+                }
                 const result = await this.scheduler.triggerJob(command.jobId);
                 return { ok: result.ok, message: result.message };
             }
@@ -1302,7 +1307,11 @@ class OuroDaemon {
                 };
             }
             case "habit.poke": {
-                this.processManager.sendToAgent?.(command.agent, { type: "habit", habitName: command.habitName, trigger: "poke" });
+                const trigger = command.trigger ?? "poke";
+                if (!(0, flight_recorder_1.isHabitRunTrigger)(trigger)) {
+                    return { ok: false, error: `invalid habit trigger: ${String(trigger)}` };
+                }
+                this.processManager.sendToAgent?.(command.agent, { type: "habit", habitName: command.habitName, trigger });
                 return {
                     ok: true,
                     message: `poked habit ${command.habitName} for ${command.agent}`,

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

@@ -104,6 +104,11 @@ function parseSurface(raw) {
         extra: record ? parseStringArray(record.extra) : [],
     };
 }
+function parseContinuity(raw) {
+    const record = objectRecord(raw);
+    const mode = record ? record.mode : null;
+    return { mode: mode === "stateful" ? "stateful" : "fresh" };
+}
 function extractFrontmatterAndBody(content) {
     const lines = content.split(/\r?\n/);
     if (lines[0]?.trim() !== "---") {
@@ -137,6 +142,7 @@ function parseHabitFile(content, filePath) {
             tools: undefined,
             origin: null,
             surface: { family: true, originator: true, extra: [] },
+            continuity: { mode: "fresh" },
             body: content.trim(),
         };
     }
@@ -154,6 +160,7 @@ function parseHabitFile(content, filePath) {
     const tools = parseToolsField(frontmatter.tools);
     const origin = parseOrigin(frontmatter.origin);
     const surface = parseSurface(frontmatter.surface);
+    const continuity = parseContinuity(frontmatter.continuity);
     return {
         name: stem,
         title,
@@ -164,6 +171,7 @@ function parseHabitFile(content, filePath) {
         tools,
         origin,
         surface,
+        continuity,
         body,
     };
 }

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

@@ -47,6 +47,9 @@ function habitRuntimeStateDir(agentRoot) {
 function isNonEmptyString(value) {
     return typeof value === "string" && value.trim().length > 0;
 }
+function nullableCursor(value) {
+    return isNonEmptyString(value) ? value.trim() : null;
+}
 function stripLegacyLastRunFromDefinition(definitionPath) {
     const content = fs.readFileSync(definitionPath, "utf-8");
     const lines = content.split(/\r?\n/);
@@ -72,23 +75,34 @@ function applyHabitRuntimeState(agentRoot, habit) {
         return habit;
     return { ...habit, lastRun: runtimeLastRun };
 }
-function writeHabitLastRun(agentRoot, habitName, lastRun, updatedAt = lastRun) {
+function writeHabitLastRun(agentRoot, habitName, lastRun, updatedAt = lastRun, options = {}) {
     const record = {
         schemaVersion: 1,
         name: habitName,
         lastRun,
         updatedAt,
+        activeOperationId: nullableCursor(options.activeOperationId),
+        latestRunId: nullableCursor(options.latestRunId),
+        latestReceiptLocator: nullableCursor(options.latestReceiptLocator),
     };
     (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 },
+        meta: {
+            agentRoot,
+            habitName,
+            lastRun,
+            updatedAt,
+            activeOperationId: record.activeOperationId,
+            latestRunId: record.latestRunId,
+            latestReceiptLocator: record.latestReceiptLocator,
+        },
     });
 }
 function recordHabitRun(agentRoot, habitName, lastRun, options = {}) {
-    writeHabitLastRun(agentRoot, habitName, lastRun);
+    writeHabitLastRun(agentRoot, habitName, lastRun, lastRun, options);
     if (!options.definitionPath)
         return;
     try {