@ouro.bot/cli 0.1.0-alpha.5 → 0.1.0-alpha.500

package/dist/senses/commands.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCommandRegistry = createCommandRegistry;
 exports.getToolChoiceRequired = getToolChoiceRequired;
 exports.resetToolChoiceRequired = resetToolChoiceRequired;
+exports.getDebugMode = getDebugMode;
+exports.resetDebugMode = resetDebugMode;
 exports.registerDefaultCommands = registerDefaultCommands;
+exports.getSharedCommandRegistry = getSharedCommandRegistry;
+exports.resetSharedCommandRegistry = resetSharedCommandRegistry;
 exports.parseSlashCommand = parseSlashCommand;
 const identity_1 = require("../heart/identity");
 const runtime_1 = require("../nerves/runtime");
@@ -21,7 +25,7 @@ function createCommandRegistry() {
         },
         dispatch(name, ctx) {
             const cmd = commands.get(name);
-            if (!cmd)
+            if (!cmd || !cmd.channels.includes(ctx.channel))
                 return { handled: false };
             return { handled: true, result: cmd.handler(ctx) };
         },
@@ -35,6 +39,14 @@ function getToolChoiceRequired() {
 function resetToolChoiceRequired() {
     _toolChoiceRequired = false;
 }
+// Module-level toggle for debug mode
+let _debugMode = false;
+function getDebugMode() {
+    return _debugMode;
+}
+function resetDebugMode() {
+    _debugMode = false;
+}
 function registerDefaultCommands(registry) {
     (0, runtime_1.emitNervesEvent)({
         event: "repertoire.load_start",
@@ -51,7 +63,7 @@ function registerDefaultCommands(registry) {
     registry.register({
         name: "new",
         description: "start a new conversation",
-        channels: ["cli", "teams"],
+        channels: ["teams"],
         handler: () => ({ action: "new" }),
     });
     registry.register({
@@ -60,10 +72,36 @@ function registerDefaultCommands(registry) {
         channels: ["cli", "teams"],
         handler: (ctx) => {
             const cmds = registry.list(ctx.channel);
-            const lines = cmds.map((c) => `/${c.name} - ${c.description}`);
+            const lines = cmds.map((c) => `/${c.name} \u2014 ${c.description}`);
             return { action: "response", message: lines.join("\n") };
         },
     });
+    registry.register({
+        name: "help",
+        description: "show keyboard shortcuts and tips",
+        channels: ["cli"],
+        /* v8 ignore start -- integration: /help command tested via E2E @preserve */
+        handler: () => ({
+            action: "response",
+            message: [
+                "Keyboard shortcuts:",
+                "  Ctrl-C        abort current generation / clear input / exit (twice within 2s)",
+                "  Escape        clear input",
+                "  ↑ / ↓         browse input history (includes previous sessions)",
+                "  Option+← / →  jump between words",
+                "  Ctrl+A / E    jump to start / end of line",
+                "  Option+Delete  delete word backward",
+                "  Option+D      delete word forward",
+                "  Alt+Enter     insert newline (multi-line input)",
+                "",
+                "Commands:",
+                "  /help         this help",
+                "  /commands     list all commands",
+                "  /exit         quit",
+            ].join("\n"),
+        }),
+        /* v8 ignore stop */
+    });
     registry.register({
         name: "tool-required",
         description: "toggle tool_choice required mode (forces tool calls)",
@@ -73,6 +111,20 @@ function registerDefaultCommands(registry) {
             return { action: "response", message: `tool-required mode: ${_toolChoiceRequired ? "ON" : "OFF"}` };
         },
     });
+    registry.register({
+        name: "debug",
+        description: "toggle debug mode — see more detail about what I'm doing",
+        channels: ["cli", "teams", "bluebubbles", "mail", "mcp"],
+        handler: () => {
+            _debugMode = !_debugMode;
+            return {
+                action: "response",
+                message: _debugMode
+                    ? "debug mode on — you'll see more detail about what I'm doing"
+                    : "debug mode off — back to clean output",
+            };
+        },
+    });
     (0, runtime_1.emitNervesEvent)({
         event: "repertoire.load_end",
         component: "repertoire",
@@ -80,6 +132,17 @@ function registerDefaultCommands(registry) {
         meta: {},
     });
 }
+let _sharedRegistry = null;
+function getSharedCommandRegistry() {
+    if (!_sharedRegistry) {
+        _sharedRegistry = createCommandRegistry();
+        registerDefaultCommands(_sharedRegistry);
+    }
+    return _sharedRegistry;
+}
+function resetSharedCommandRegistry() {
+    _sharedRegistry = null;
+}
 function parseSlashCommand(input) {
     const trimmed = input.trim();
     if (!trimmed.startsWith("/"))

package/dist/senses/continuity.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeContinuityClauses = normalizeContinuityClauses;
+exports.resolveMustResolveBeforeHandoff = resolveMustResolveBeforeHandoff;
+exports.classifySteeringFollowUpEffect = classifySteeringFollowUpEffect;
+const runtime_1 = require("../nerves/runtime");
+const NO_HANDOFF_CLAUSES = new Set([
+    "dont return control until complete or blocked",
+    "do not return control until complete or blocked",
+    "dont hand back control until complete or blocked",
+    "do not hand back control until complete or blocked",
+    "keep going until youre done",
+    "keep going until you are done",
+    "keep working until youre done",
+    "keep working until you are done",
+    "dont stop until youre done",
+    "do not stop until youre done",
+    "only come back if blocked",
+    "only return if blocked",
+    "only respond if blocked",
+    "work autonomously on this",
+    "work on this autonomously",
+    "handle this autonomously",
+]);
+const CANCEL_SUPERSEDE_CLAUSES = new Set([
+    "stop",
+    "cancel that",
+    "cancel this",
+    "never mind",
+    "nevermind",
+    "forget it",
+    "ignore that",
+    "ignore this",
+    "hold off",
+    "ill take it from here",
+    "i will take it from here",
+    "lets do something else",
+    "stop working on that",
+    "stop working on this",
+    "dont do that",
+    "do not do that",
+]);
+function normalizeContinuityClauses(text) {
+    return text
+        .toLowerCase()
+        .split(/[\n.!?;]+/)
+        .map((clause) => clause.replace(/[^a-z\s]/g, "").replace(/\s+/g, " ").trim())
+        .filter(Boolean);
+}
+function resolveMustResolveBeforeHandoff(initialValue, ingressTexts) {
+    let current = initialValue;
+    for (const text of ingressTexts ?? []) {
+        for (const clause of normalizeContinuityClauses(text)) {
+            if (CANCEL_SUPERSEDE_CLAUSES.has(clause)) {
+                current = false;
+                continue;
+            }
+            if (NO_HANDOFF_CLAUSES.has(clause)) {
+                current = true;
+            }
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.continuity_state_resolved",
+        message: "resolved continuity handoff state from ingress text",
+        meta: {
+            initialValue,
+            finalValue: current,
+            ingressCount: ingressTexts?.length ?? 0,
+        },
+    });
+    return current;
+}
+function classifySteeringFollowUpEffect(text) {
+    const clauses = normalizeContinuityClauses(text);
+    let effect = "none";
+    if (clauses.some((clause) => CANCEL_SUPERSEDE_CLAUSES.has(clause))) {
+        effect = "clear_and_supersede";
+    }
+    else if (clauses.some((clause) => NO_HANDOFF_CLAUSES.has(clause))) {
+        effect = "set_no_handoff";
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.continuity_follow_up_classified",
+        message: "classified steering follow-up continuity effect",
+        meta: {
+            effect,
+            clauseCount: clauses.length,
+        },
+    });
+    return effect;
+}

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) => `[internal] obligation: ${o.friendName} — waiting ${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-worker.js

@@ -1,30 +1,201 @@
 "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.HABIT_RECURSION_BURST_THRESHOLD = exports.HABIT_RECURSION_BURST_WINDOW_MS = exports.HABIT_RECURSION_MIN_INTERVAL_MS = exports.MAX_CONSECUTIVE_INSTINCT_TURNS = void 0;
 exports.createInnerDialogWorker = createInnerDialogWorker;
 exports.startInnerDialogWorker = startInnerDialogWorker;
+const path = __importStar(require("path"));
 const inner_dialog_1 = require("./inner-dialog");
 const runtime_1 = require("../nerves/runtime");
-function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options)) {
+const identity_1 = require("../heart/identity");
+const pending_1 = require("../mind/pending");
+const habit_runtime_state_1 = require("../heart/habits/habit-runtime-state");
+/**
+ * Cap on consecutive `instinct` follow-on turns triggered by `hasPendingWork()`
+ * with no externally-queued work in between. Without this cap, a turn that
+ * writes anything back into the inner-dialog pending dir as a side effect of
+ * processing (e.g. a surface tool routing a response) puts the worker into
+ * a self-sustaining loop where the next turn's drain produces another write,
+ * and so on. Real workflows rarely chain more than 2–3 instinct turns; an
+ * external trigger (habit, poke, chat) resets the counter so legitimate
+ * follow-on work is unaffected.
+ *
+ * Three feels right: legitimate cascading follow-ups (e.g. processing a
+ * batch of delegated returns) get through; a true self-loop caps fast.
+ */
+exports.MAX_CONSECUTIVE_INSTINCT_TURNS = 3;
+/**
+ * Habit recursion detector thresholds. The instinct cap above protects
+ * against pending-dir self-loops; this protects against the *external*
+ * IPC self-loop where heartbeat-shaped messages get re-issued faster
+ * than their cadence — e.g. a hook misconfigured to repost on every
+ * heartbeat, a daemon retry storm, or a stuck timer firing back-to-back.
+ *
+ * MIN_INTERVAL_MS — two of the same habit within this window is suspect
+ * regardless of cadence (no realistic habit fires every few seconds).
+ * BURST_THRESHOLD over BURST_WINDOW_MS catches slower runaways that stay
+ * just under MIN_INTERVAL_MS.
+ *
+ * Detection is observation-only: it emits warn-level nerves events, it
+ * does not drop the message. An operator (or follow-up auto-recovery)
+ * decides what to do with the signal.
+ */
+exports.HABIT_RECURSION_MIN_INTERVAL_MS = 5_000;
+exports.HABIT_RECURSION_BURST_WINDOW_MS = 60_000;
+exports.HABIT_RECURSION_BURST_THRESHOLD = 5;
+function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options), hasPendingWork = () => (0, pending_1.hasPendingMessages)((0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)())), nowSource = () => Date.now()) {
     let running = false;
-    async function run(reason) {
-        if (running)
-            return;
-        running = true;
-        try {
-            await runTurn({ reason });
+    const queue = [];
+    const lastFireByHabit = new Map();
+    const recentHabitFires = [];
+    function recordHabitFireForRecursion(habitName) {
+        const now = nowSource();
+        const previous = lastFireByHabit.get(habitName);
+        if (previous !== undefined) {
+            const intervalMs = now - previous;
+            if (intervalMs < exports.HABIT_RECURSION_MIN_INTERVAL_MS) {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "senses",
+                    event: "senses.habit_recursion_suspected",
+                    message: "habit fired suspiciously fast after the previous fire — possible self-recursion or duplicate dispatch",
+                    meta: {
+                        habitName,
+                        intervalMs,
+                        thresholdMs: exports.HABIT_RECURSION_MIN_INTERVAL_MS,
+                    },
+                });
+            }
         }
-        catch (error) {
+        lastFireByHabit.set(habitName, now);
+        recentHabitFires.push(now);
+        while (recentHabitFires.length > 0 && now - recentHabitFires[0] > exports.HABIT_RECURSION_BURST_WINDOW_MS) {
+            recentHabitFires.shift();
+        }
+        if (recentHabitFires.length >= exports.HABIT_RECURSION_BURST_THRESHOLD) {
             (0, runtime_1.emitNervesEvent)({
-                level: "error",
+                level: "warn",
                 component: "senses",
-                event: "senses.inner_dialog_worker_error",
-                message: "inner dialog worker turn failed",
+                event: "senses.habit_recursion_burst",
+                message: "habit messages arriving in a burst — possible runaway loop",
                 meta: {
-                    reason,
-                    error: error instanceof Error ? error.message : String(error),
+                    count: recentHabitFires.length,
+                    windowMs: exports.HABIT_RECURSION_BURST_WINDOW_MS,
+                    thresholdCount: exports.HABIT_RECURSION_BURST_THRESHOLD,
+                    lastHabitName: habitName,
                 },
             });
         }
+    }
+    async function run(reason, taskId, habitName) {
+        if (running) {
+            queue.push({ reason, taskId, habitName });
+            return;
+        }
+        running = true;
+        try {
+            let nextReason = reason;
+            let nextTaskId = taskId;
+            let nextHabitName = habitName;
+            let consecutiveInstinctTurns = reason === "instinct" ? 1 : 0;
+            do {
+                try {
+                    await runTurn({ reason: nextReason, taskId: nextTaskId, habitName: nextHabitName });
+                }
+                catch (error) {
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "error",
+                        component: "senses",
+                        event: "senses.inner_dialog_worker_error",
+                        message: "inner dialog worker turn failed",
+                        meta: {
+                            reason: nextReason,
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+                }
+                // Record lastRun after a habit turn without dirtying the tracked habit file.
+                if (nextReason === "habit" && nextHabitName) {
+                    try {
+                        const agentRoot = (0, identity_1.getAgentRoot)();
+                        (0, habit_runtime_state_1.recordHabitRun)(agentRoot, nextHabitName, new Date().toISOString(), {
+                            definitionPath: path.join(agentRoot, "habits", `${nextHabitName}.md`),
+                        });
+                    }
+                    catch {
+                        // Habit file/state may be unavailable during the turn — skip gracefully
+                    }
+                }
+                // Drain queue first. Externally-queued work resets the instinct cap
+                // because a real outside trigger arrived between turns.
+                if (queue.length > 0) {
+                    const next = queue.shift();
+                    nextReason = next.reason;
+                    nextTaskId = next.taskId;
+                    nextHabitName = next.habitName;
+                    consecutiveInstinctTurns = nextReason === "instinct" ? consecutiveInstinctTurns + 1 : 0;
+                    continue;
+                }
+                // Then check hasPendingWork fallback. This is the loop site: any
+                // tool that writes to the inner-dialog pending dir during a turn
+                // would cause hasPendingWork() to be true here, producing a
+                // self-sustaining "instinct" loop with no external input. Cap it.
+                if (hasPendingWork()) {
+                    if (consecutiveInstinctTurns >= exports.MAX_CONSECUTIVE_INSTINCT_TURNS) {
+                        (0, runtime_1.emitNervesEvent)({
+                            level: "warn",
+                            component: "senses",
+                            event: "senses.inner_dialog_worker_instinct_loop_capped",
+                            message: "inner dialog worker stopped chaining instinct turns; pending work remains for next external trigger",
+                            meta: {
+                                consecutiveInstinctTurns,
+                                cap: exports.MAX_CONSECUTIVE_INSTINCT_TURNS,
+                                lastReason: nextReason,
+                            },
+                        });
+                        break;
+                    }
+                    consecutiveInstinctTurns += 1;
+                    nextReason = "instinct";
+                    nextTaskId = undefined;
+                    nextHabitName = undefined;
+                    continue;
+                }
+                break;
+            } while (true);
+        }
         finally {
             running = false;
         }
@@ -33,12 +204,24 @@ function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runIn
         if (!message || typeof message !== "object")
             return;
         const maybeMessage = message;
+        if (maybeMessage.type === "habit") {
+            /* v8 ignore next -- defensive fallback: live habit dispatch always sets habitName @preserve */
+            const habitName = maybeMessage.habitName ?? "(unnamed)";
+            recordHabitFireForRecursion(habitName);
+            await run("habit", undefined, maybeMessage.habitName);
+            return;
+        }
         if (maybeMessage.type === "heartbeat") {
-            await run("heartbeat");
+            // Backward compatibility: heartbeat -> habit/heartbeat
+            recordHabitFireForRecursion("heartbeat");
+            await run("habit", undefined, "heartbeat");
+            return;
+        }
+        if (maybeMessage.type === "poke") {
+            await run("instinct", maybeMessage.taskId);
             return;
         }
-        if (maybeMessage.type === "poke" ||
-            maybeMessage.type === "chat" ||
+        if (maybeMessage.type === "chat" ||
             maybeMessage.type === "message") {
             await run("instinct");
             return;