@ouro.bot/cli 0.1.0-alpha.325 → 0.1.0-alpha.327

package/changelog.json

@@ -1,6 +1,19 @@
 {
   "_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.327",
+      "changes": [
+        "fix(daemon): make startup stability polling respect stdout TTY capability so captured `ouro up` output is plain append-only text without raw ANSI cursor-control or color escapes, while interactive terminals keep in-place progress rendering."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.326",
+      "changes": [
+        "refactor(outlook): split the Outlook HTTP server boundary into focused transport, static/path, default-hook, route-dispatch, and JSON-response helpers while preserving the public `startOutlookHttpServer()` API and existing HTTP behavior.",
+        "test(outlook): add direct seam coverage for Outlook HTTP helper modules, route/static/SSE/default-hook behavior, and nerves file-completeness exemptions for the new helper-module pattern."
+      ]
+    },
     {
       "version": "0.1.0-alpha.325",
       "changes": [

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

@@ -167,6 +167,8 @@ async function ensureDaemonRunning(deps) {
             daemonPid: runtimeResult.startedPid ?? null,
             /* v8 ignore next -- thin wrapper: raw process.stdout.write for ANSI cursor control @preserve */
             writeRaw: (text) => process.stdout.write(text),
+            /* v8 ignore next -- thin wrapper: real stdout TTY detection injected for captured-output safety @preserve */
+            isTTY: process.stdout.isTTY === true,
             /* v8 ignore next -- thin wrapper: real Date.now() injected for testability @preserve */
             now: () => Date.now(),
             /* v8 ignore next -- thin wrapper: real setTimeout injected for testability @preserve */
@@ -205,6 +207,8 @@ async function ensureDaemonRunning(deps) {
                 daemonPid: lastPid,
                 /* v8 ignore next -- thin wrapper: raw process.stdout.write for ANSI cursor control @preserve */
                 writeRaw: (text) => process.stdout.write(text),
+                /* v8 ignore next -- thin wrapper: real stdout TTY detection injected for captured-output safety @preserve */
+                isTTY: process.stdout.isTTY === true,
                 /* v8 ignore next -- thin wrapper: real Date.now() injected for testability @preserve */
                 now: () => Date.now(),
                 /* v8 ignore next -- thin wrapper: real setTimeout injected for testability @preserve */

package/dist/heart/daemon/startup-tui.js

@@ -68,66 +68,57 @@ function assessStability(payload, now) {
  * Build an ANSI string for in-place terminal display during polling.
  * Uses cursor-up and line-clear escapes to overwrite previous output.
  */
-function renderStartupProgress(payload, elapsed, prevLineCount = 0) {
+function renderStartupProgress(payload, elapsed, prevLineCount = 0, options = {}) {
+    const isTTY = options.isTTY ?? true;
     const frameIndex = Math.floor(elapsed / 100) % SPINNER_FRAMES.length;
     const spinner = SPINNER_FRAMES[frameIndex];
     const lines = [];
     const elapsedSec = (elapsed / 1000).toFixed(1);
-    lines.push(`${spinner} ${BOLD}waiting for agents${RESET} ${DIM}(${elapsedSec}s)${RESET}`);
+    lines.push(isTTY
+        ? `${spinner} ${BOLD}waiting for agents${RESET} ${DIM}(${elapsedSec}s)${RESET}`
+        : `${spinner} waiting for agents (${elapsedSec}s)`);
     for (const worker of payload.workers) {
-        const statusColor = worker.status === "running" ? GREEN
-            : worker.status === "crashed" ? RED
-                : YELLOW;
-        const statusText = `${statusColor}${worker.status}${RESET}`;
+        const statusText = isTTY ? colorStatus(worker.status) : worker.status;
         lines.push(`  ${worker.agent}/${worker.worker}: ${statusText}`);
     }
-    let output = "";
-    if (prevLineCount > 0) {
-        output += `\x1b[${prevLineCount}A`;
-    }
-    for (const line of lines) {
-        output += `\x1b[2K${line}\n`;
-    }
-    return output;
+    return renderStartupLines(lines, prevLineCount, isTTY);
 }
 /**
  * Render a pre-socket status line showing what the daemon is doing.
  */
-function renderWaitingForDaemon(elapsed, latestEvent, prevLineCount = 0) {
+function renderWaitingForDaemon(elapsed, latestEvent, prevLineCount = 0, options = {}) {
+    const isTTY = options.isTTY ?? true;
     const elapsedSec = (elapsed / 1000).toFixed(1);
     const frameIndex = Math.floor(elapsed / 100) % SPINNER_FRAMES.length;
     const spinner = SPINNER_FRAMES[frameIndex];
     const lines = [];
-    lines.push(`${spinner} ${BOLD}waiting for daemon${RESET} ${DIM}(${elapsedSec}s)${RESET}`);
+    lines.push(isTTY
+        ? `${spinner} ${BOLD}waiting for daemon${RESET} ${DIM}(${elapsedSec}s)${RESET}`
+        : `${spinner} waiting for daemon (${elapsedSec}s)`);
     if (latestEvent) {
-        lines.push(`  ${DIM}${latestEvent}${RESET}`);
-    }
-    let output = "";
-    if (prevLineCount > 0) {
-        output += `\x1b[${prevLineCount}A`;
-    }
-    for (const line of lines) {
-        output += `\x1b[2K${line}\n`;
+        lines.push(isTTY ? `  ${DIM}${latestEvent}${RESET}` : `  ${latestEvent}`);
     }
-    return output;
+    return renderStartupLines(lines, prevLineCount, isTTY);
 }
 /**
  * Render the final summary after all agents have resolved.
  */
-function renderFinalSummary(result) {
+function renderFinalSummary(result, isTTY) {
     const lines = [];
     for (const agent of result.stable) {
-        lines.push(`  ${GREEN}\u2713${RESET} ${agent}: ${GREEN}stable${RESET}`);
+        lines.push(isTTY ? `  ${GREEN}\u2713${RESET} ${agent}: ${GREEN}stable${RESET}` : `  \u2713 ${agent}: stable`);
     }
     for (const d of result.degraded) {
-        lines.push(`  ${RED}\u2717${RESET} ${d.agent}: ${RED}degraded${RESET}`);
+        lines.push(isTTY ? `  ${RED}\u2717${RESET} ${d.agent}: ${RED}degraded${RESET}` : `  \u2717 ${d.agent}: degraded`);
         if (d.errorReason !== "unknown error") {
-            lines.push(`    ${DIM}error: ${d.errorReason}${RESET}`);
+            lines.push(isTTY ? `    ${DIM}error: ${d.errorReason}${RESET}` : `    error: ${d.errorReason}`);
         }
         if (d.fixHint !== "check daemon logs") {
-            lines.push(`    ${DIM}fix:   ${d.fixHint}${RESET}`);
+            lines.push(isTTY ? `    ${DIM}fix:   ${d.fixHint}${RESET}` : `    fix:   ${d.fixHint}`);
         }
     }
+    if (!isTTY)
+        return lines.join("\n") + "\n";
     return lines.map((line) => `\x1b[2K${line}`).join("\n") + "\n";
 }
 // ── Polling loop ──
@@ -141,6 +132,7 @@ function renderFinalSummary(result) {
 async function pollDaemonStartup(deps) {
     const startTime = deps.now();
     let prevLineCount = 0;
+    const isTTY = deps.isTTY ?? true;
     const isAlive = deps.isProcessAlive ?? defaultIsProcessAlive;
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
@@ -169,7 +161,7 @@ async function pollDaemonStartup(deps) {
                     meta: { pid: deps.daemonPid, lastEvent: latestEvent },
                 });
                 // Clear the waiting line
-                if (prevLineCount > 0) {
+                if (isTTY && prevLineCount > 0) {
                     let clear = `\x1b[${prevLineCount}A`;
                     for (let i = 0; i < prevLineCount; i++)
                         clear += `\x1b[2K\n`;
@@ -182,12 +174,12 @@ async function pollDaemonStartup(deps) {
             }
             // Show what the daemon is doing from its log
             const latestEvent = deps.readLatestDaemonEvent?.() ?? null;
-            const output = renderWaitingForDaemon(elapsed, latestEvent, prevLineCount);
+            const output = renderWaitingForDaemon(elapsed, latestEvent, prevLineCount, { isTTY });
             deps.writeRaw(output);
             prevLineCount = latestEvent ? 2 : 1;
         }
         if (payload) {
-            const output = renderStartupProgress(payload, elapsed, prevLineCount);
+            const output = renderStartupProgress(payload, elapsed, prevLineCount, { isTTY });
             deps.writeRaw(output);
             prevLineCount = payload.workers.length + 1;
             const assessment = assessStability(payload, now);
@@ -196,7 +188,7 @@ async function pollDaemonStartup(deps) {
                     stable: assessment.stable,
                     degraded: assessment.degraded,
                 };
-                const summary = renderFinalSummary(result);
+                const summary = renderFinalSummary(result, isTTY);
                 deps.writeRaw(summary);
                 (0, runtime_1.emitNervesEvent)({
                     component: "daemon",
@@ -214,6 +206,24 @@ async function pollDaemonStartup(deps) {
         await deps.sleep(POLL_INTERVAL_MS);
     }
 }
+function colorStatus(status) {
+    const statusColor = status === "running" ? GREEN
+        : status === "crashed" ? RED
+            : YELLOW;
+    return `${statusColor}${status}${RESET}`;
+}
+function renderStartupLines(lines, prevLineCount, isTTY) {
+    if (!isTTY)
+        return lines.join("\n") + "\n";
+    let output = "";
+    if (prevLineCount > 0) {
+        output += `\x1b[${prevLineCount}A`;
+    }
+    for (const line of lines) {
+        output += `\x1b[2K${line}\n`;
+    }
+    return output;
+}
 /* v8 ignore start -- process liveness check: uses real process.kill(0), tested via deployment @preserve */
 function defaultIsProcessAlive(pid) {
     try {

package/dist/heart/outlook/outlook-http-hooks.js

@@ -0,0 +1,64 @@
+"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.createOutlookHttpReadHooks = createOutlookHttpReadHooks;
+const path = __importStar(require("path"));
+const outlook_read_1 = require("./outlook-read");
+function createOutlookHttpReadHooks(options) {
+    const bundlesRoot = options.bundlesRoot;
+    const readOptions = bundlesRoot ? { bundlesRoot } : undefined;
+    const agentRoot = (agentName) => path.join(bundlesRoot ?? "", `${agentName}.ouro`);
+    return {
+        agentRoot,
+        readAgentSessions: options.readAgentSessions ?? ((agentName) => (0, outlook_read_1.readSessionInventory)(agentName, readOptions)),
+        readAgentTranscript: options.readAgentTranscript ?? ((agentName, friendId, channel, key) => (0, outlook_read_1.readSessionTranscript)(agentName, friendId, channel, key, readOptions)),
+        readAgentCoding: options.readAgentCoding ?? ((agentName) => (0, outlook_read_1.readCodingDeep)(agentRoot(agentName))),
+        readAgentAttention: options.readAgentAttention ?? ((agentName) => (0, outlook_read_1.readAttentionView)(agentName, readOptions)),
+        readAgentBridges: options.readAgentBridges ?? ((agentName) => (0, outlook_read_1.readBridgeInventory)(agentRoot(agentName))),
+        readAgentMemory: options.readAgentMemory ?? ((agentName) => (0, outlook_read_1.readMemoryView)(agentRoot(agentName))),
+        readAgentFriends: options.readAgentFriends ?? ((agentName) => (0, outlook_read_1.readFriendView)(agentName, readOptions)),
+        readAgentContinuity: options.readAgentContinuity ?? ((agentName) => (0, outlook_read_1.readOutlookContinuity)(agentRoot(agentName), agentName)),
+        readAgentOrientation: options.readAgentOrientation ?? ((agentName) => (0, outlook_read_1.readOrientationView)(agentRoot(agentName), agentName)),
+        readAgentObligations: options.readAgentObligations ?? ((agentName) => (0, outlook_read_1.readObligationDetailView)(agentRoot(agentName))),
+        readAgentChanges: options.readAgentChanges ?? ((agentName) => (0, outlook_read_1.readChangesView)(agentRoot(agentName))),
+        readAgentSelfFix: options.readAgentSelfFix ?? ((agentName) => (0, outlook_read_1.readSelfFixView)(agentRoot(agentName))),
+        readAgentMemoryDecisions: options.readAgentMemoryDecisions ?? ((agentName) => (0, outlook_read_1.readMemoryDecisionView)(agentRoot(agentName))),
+        readAgentHabits: options.readAgentHabits ?? ((agentName) => (0, outlook_read_1.readHabitView)(agentRoot(agentName))),
+        readDaemonHealth: options.readDaemonHealth ?? (() => (0, outlook_read_1.readDaemonHealthDeep)(options.healthPath)),
+        readLogs: options.readLogs ?? (() => (0, outlook_read_1.readLogView)(options.logPath ?? null)),
+        readDeskPrefs: (agentName) => (0, outlook_read_1.readDeskPrefs)(agentRoot(agentName)),
+        readNeedsMe: (agentName) => (0, outlook_read_1.readNeedsMeView)(agentName, readOptions),
+    };
+}

package/dist/heart/outlook/outlook-http-response.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeJson = writeJson;
+function writeJson(response, statusCode, payload) {
+    response.writeHead(statusCode, { "content-type": "application/json; charset=utf-8" });
+    response.end(`${JSON.stringify(payload, null, 2)}\n`);
+}

package/dist/heart/outlook/outlook-http-routes.js

@@ -0,0 +1,232 @@
+"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.createOutlookHttpRequestHandler = createOutlookHttpRequestHandler;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const outlook_http_response_1 = require("./outlook-http-response");
+const outlook_http_static_1 = require("./outlook-http-static");
+function createOutlookHttpRequestHandler(options) {
+    const staticFiles = options.staticFiles ?? { resolveSpaDistDir: outlook_http_static_1.resolveSpaDistDir, serveStaticFile: outlook_http_static_1.serveStaticFile };
+    return (request, response) => {
+        let pathname = (0, outlook_http_static_1.normalizeOutlookRequestPath)(request.url);
+        const origin = `http://${options.host}:${options.getPort()}`;
+        if (pathname.startsWith("/assets/")) {
+            const spaDir = staticFiles.resolveSpaDistDir();
+            if (spaDir) {
+                const assetPath = path.join(spaDir, pathname);
+                if (staticFiles.serveStaticFile(response, assetPath))
+                    return;
+            }
+            (0, outlook_http_response_1.writeJson)(response, 404, { ok: false, error: "asset not found" });
+            return;
+        }
+        if (pathname === "/outlook") {
+            response.writeHead(301, { location: "/" });
+            response.end();
+            return;
+        }
+        pathname = (0, outlook_http_static_1.normalizeLegacyOutlookApiPath)(pathname);
+        if (pathname === "/api/events") {
+            response.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", "connection": "keep-alive", "access-control-allow-origin": "*" });
+            response.write(":ok\n\n");
+            options.sse.add(response);
+            return;
+        }
+        if (pathname === "/api/machine") {
+            const machine = options.readMachineState();
+            const machineView = options.readMachineView?.({ origin, machine });
+            (0, outlook_http_response_1.writeJson)(response, 200, machineView ?? machine);
+            return;
+        }
+        if (pathname === "/api/machine/health") {
+            const health = options.hooks.readDaemonHealth();
+            (0, outlook_http_response_1.writeJson)(response, 200, health ?? { status: "unavailable" });
+            return;
+        }
+        if (pathname === "/api/machine/logs") {
+            (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readLogs());
+            return;
+        }
+        const agentMatch = /^\/api\/agents\/([^/]+)(?:\/(.+))?$/.exec(pathname);
+        if (agentMatch) {
+            handleAgentRoute(request, response, {
+                agent: decodeURIComponent(agentMatch[1]),
+                surface: agentMatch[2] ?? null,
+                options,
+            });
+            return;
+        }
+        const spaDir = staticFiles.resolveSpaDistDir();
+        if (spaDir) {
+            if (staticFiles.serveStaticFile(response, path.join(spaDir, "index.html")))
+                return;
+        }
+        (0, outlook_http_response_1.writeJson)(response, 404, { ok: false, error: `not found: ${pathname}` });
+    };
+}
+function handleAgentRoute(request, response, context) {
+    const { agent, surface, options } = context;
+    if (!surface) {
+        const view = options.readAgentView?.(agent);
+        if (view) {
+            (0, outlook_http_response_1.writeJson)(response, 200, view);
+            return;
+        }
+        const state = options.readAgentState(agent);
+        if (!state) {
+            (0, outlook_http_response_1.writeJson)(response, 404, { ok: false, error: `unknown agent: ${agent}` });
+            return;
+        }
+        (0, outlook_http_response_1.writeJson)(response, 200, state);
+        return;
+    }
+    if (surface === "sessions") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentSessions(agent));
+        return;
+    }
+    const transcriptMatch = /^sessions\/([^/]+)\/([^/]+)\/([^/]+)$/.exec(surface);
+    if (transcriptMatch) {
+        const friendId = decodeURIComponent(transcriptMatch[1]);
+        const channel = decodeURIComponent(transcriptMatch[2]);
+        const key = decodeURIComponent(transcriptMatch[3]);
+        const transcript = options.hooks.readAgentTranscript(agent, friendId, channel, key);
+        if (!transcript) {
+            (0, outlook_http_response_1.writeJson)(response, 404, { ok: false, error: "session not found" });
+            return;
+        }
+        (0, outlook_http_response_1.writeJson)(response, 200, transcript);
+        return;
+    }
+    if (surface === "coding") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentCoding(agent));
+        return;
+    }
+    if (surface === "attention") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentAttention(agent));
+        return;
+    }
+    if (surface === "bridges") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentBridges(agent));
+        return;
+    }
+    if (surface === "memory") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentMemory(agent));
+        return;
+    }
+    if (surface === "friends") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentFriends(agent));
+        return;
+    }
+    if (surface === "continuity") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentContinuity(agent));
+        return;
+    }
+    if (surface === "orientation") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentOrientation(agent));
+        return;
+    }
+    if (surface === "obligations") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentObligations(agent));
+        return;
+    }
+    if (surface === "changes") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentChanges(agent));
+        return;
+    }
+    if (surface === "self-fix") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentSelfFix(agent));
+        return;
+    }
+    if (surface === "memory-decisions") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentMemoryDecisions(agent));
+        return;
+    }
+    if (surface === "dismiss-obligation" && request.method === "POST") {
+        handleDismissObligation(request, response, options.hooks.agentRoot(agent));
+        return;
+    }
+    if (surface === "desk-prefs") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readDeskPrefs(agent));
+        return;
+    }
+    if (surface === "needs-me") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readNeedsMe(agent));
+        return;
+    }
+    if (surface === "habits") {
+        (0, outlook_http_response_1.writeJson)(response, 200, options.hooks.readAgentHabits(agent));
+        return;
+    }
+    if (surface === "inner-transcript") {
+        const transcript = options.hooks.readAgentTranscript(agent, "self", "inner", "dialog");
+        (0, outlook_http_response_1.writeJson)(response, 200, transcript ?? { messageCount: 0, messages: [] });
+        return;
+    }
+    (0, outlook_http_response_1.writeJson)(response, 404, { ok: false, error: `unknown agent surface: ${surface}` });
+}
+function handleDismissObligation(request, response, agentRoot) {
+    let body = "";
+    request.on("data", (chunk) => {
+        body += chunk;
+    });
+    request.on("end", () => {
+        try {
+            const { obligationId } = JSON.parse(body);
+            if (!obligationId) {
+                (0, outlook_http_response_1.writeJson)(response, 400, { ok: false, error: "obligationId required" });
+                return;
+            }
+            const prefsPath = path.join(agentRoot, "state", "outlook-prefs.json");
+            let prefs = {};
+            try {
+                prefs = JSON.parse(fs.readFileSync(prefsPath, "utf-8"));
+            }
+            catch {
+                // Missing or malformed prefs start from a clean preference object.
+            }
+            const dismissed = Array.isArray(prefs.dismissedObligations) ? prefs.dismissedObligations : [];
+            if (!dismissed.includes(obligationId))
+                dismissed.push(obligationId);
+            prefs.dismissedObligations = dismissed;
+            fs.mkdirSync(path.dirname(prefsPath), { recursive: true });
+            fs.writeFileSync(prefsPath, `${JSON.stringify(prefs, null, 2)}\n`, "utf-8");
+            (0, outlook_http_response_1.writeJson)(response, 200, { ok: true, dismissed: dismissed.length });
+        }
+        catch (error) {
+            (0, outlook_http_response_1.writeJson)(response, 500, { ok: false, error: String(error) });
+        }
+    });
+}

package/dist/heart/outlook/outlook-http-static.js

@@ -0,0 +1,99 @@
+"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.normalizeOutlookRequestPath = normalizeOutlookRequestPath;
+exports.normalizeLegacyOutlookApiPath = normalizeLegacyOutlookApiPath;
+exports.resolveSpaDistDir = resolveSpaDistDir;
+exports.serveStaticFile = serveStaticFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".css": "text/css",
+    ".json": "application/json",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+    ".woff2": "font/woff2",
+};
+function normalizeOutlookRequestPath(urlValue = "/") {
+    const parsed = new URL(urlValue, "http://127.0.0.1");
+    const normalizedPath = parsed.pathname.replace(/\/+$/, "");
+    if (normalizedPath.length === 0)
+        return "/";
+    return normalizedPath;
+}
+function normalizeLegacyOutlookApiPath(pathname) {
+    if (pathname.startsWith("/outlook/api/"))
+        return pathname.slice("/outlook".length);
+    if (pathname === "/outlook/api")
+        return "/api";
+    return pathname;
+}
+function defaultSpaDistCandidates() {
+    return [
+        path.resolve(__dirname, "..", "..", "..", "packages", "outlook-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "packages", "outlook-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "..", "..", "packages", "outlook-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "outlook-ui"),
+        path.resolve(__dirname, "..", "outlook-ui"),
+    ];
+}
+function resolveSpaDistDir(candidates = defaultSpaDistCandidates()) {
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(candidate, "index.html")))
+            return candidate;
+    }
+    return null;
+}
+function serveStaticFile(response, filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return false;
+        const ext = path.extname(filePath);
+        const contentType = MIME_TYPES[ext] ?? "application/octet-stream";
+        const content = fs.readFileSync(filePath);
+        response.writeHead(200, {
+            "content-type": contentType,
+            "cache-control": ext === ".html" ? "no-cache" : "public, max-age=31536000, immutable",
+        });
+        response.end(content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/heart/outlook/outlook-http-transport.js

@@ -0,0 +1,116 @@
+"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.createSseBroadcaster = createSseBroadcaster;
+exports.createStateChangedBroadcast = createStateChangedBroadcast;
+exports.createBundleWatcher = createBundleWatcher;
+const fs = __importStar(require("fs"));
+const DEFAULT_BUNDLE_WATCHER_DEPS = {
+    existsSync: fs.existsSync,
+    watch: fs.watch,
+    setTimeout,
+    clearTimeout,
+};
+function createSseBroadcaster() {
+    let nextId = 1;
+    const clients = new Set();
+    function add(response) {
+        const client = { id: nextId++, response };
+        clients.add(client);
+        response.on("close", () => clients.delete(client));
+        return client;
+    }
+    function broadcast(event, data = {}) {
+        const payload = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const client of clients) {
+            try {
+                client.response.write(payload);
+            }
+            catch {
+                clients.delete(client);
+            }
+        }
+    }
+    function disconnectAll() {
+        for (const client of clients) {
+            try {
+                client.response.end();
+            }
+            catch {
+                // The client may already have closed between the loop snapshot and end.
+            }
+        }
+        clients.clear();
+    }
+    return { add, broadcast, disconnectAll };
+}
+function createStateChangedBroadcast(sse) {
+    return () => {
+        sse.broadcast("state-changed", { at: new Date().toISOString() });
+    };
+}
+function createBundleWatcher(bundlesRoot, onChange, deps = DEFAULT_BUNDLE_WATCHER_DEPS) {
+    const watchers = [];
+    let debounceTimer = null;
+    const debounceMs = 500;
+    function debouncedOnChange() {
+        if (debounceTimer)
+            deps.clearTimeout(debounceTimer);
+        debounceTimer = deps.setTimeout(onChange, debounceMs);
+    }
+    try {
+        if (deps.existsSync(bundlesRoot)) {
+            watchers.push(deps.watch(bundlesRoot, { recursive: true }, debouncedOnChange));
+        }
+    }
+    catch {
+        // Watching is best-effort; manual broadcasts still keep Outlook usable.
+    }
+    return {
+        stop() {
+            if (debounceTimer)
+                deps.clearTimeout(debounceTimer);
+            for (const watcher of watchers) {
+                try {
+                    watcher.close();
+                }
+                catch {
+                    // Already closed.
+                }
+            }
+            watchers.length = 0;
+        },
+    };
+}

package/dist/heart/outlook/outlook-http.js

@@ -34,140 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startOutlookHttpServer = startOutlookHttpServer;
-const fs = __importStar(require("fs"));
 const http = __importStar(require("http"));
-const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 const outlook_read_1 = require("./outlook-read");
-function createSseBroadcaster() {
-    let nextId = 1;
-    const clients = new Set();
-    function add(response) {
-        const client = { id: nextId++, response };
-        clients.add(client);
-        response.on("close", () => clients.delete(client));
-        return client;
-    }
-    function broadcast(event, data = {}) {
-        const payload = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
-        for (const client of clients) {
-            try {
-                client.response.write(payload);
-                /* v8 ignore start */
-            }
-            catch {
-                clients.delete(client);
-            }
-            /* v8 ignore stop */
-        }
-    }
-    function disconnectAll() {
-        for (const client of clients) {
-            try {
-                client.response.end();
-                /* v8 ignore start */
-            }
-            catch {
-                /* already closed */
-            }
-            /* v8 ignore stop */
-        }
-        clients.clear();
-    }
-    return { add, broadcast, disconnectAll };
-}
-/* v8 ignore start — filesystem watcher, tested via integration */
-function createBundleWatcher(bundlesRoot, onChange) {
-    const watchers = [];
-    let debounceTimer = null;
-    const DEBOUNCE_MS = 500;
-    function debouncedOnChange() {
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(onChange, DEBOUNCE_MS);
-    }
-    try {
-        if (fs.existsSync(bundlesRoot)) {
-            const watcher = fs.watch(bundlesRoot, { recursive: true }, debouncedOnChange);
-            watchers.push(watcher);
-        }
-    }
-    catch {
-        // watch not available — SSE will rely on manual broadcast
-    }
-    return {
-        stop() {
-            if (debounceTimer)
-                clearTimeout(debounceTimer);
-            for (const w of watchers)
-                try {
-                    w.close();
-                }
-                catch { /* ignore */ }
-            watchers.length = 0;
-        },
-    };
-}
-/* v8 ignore stop */
-function writeJson(response, statusCode, payload) {
-    response.writeHead(statusCode, { "content-type": "application/json; charset=utf-8" });
-    response.end(`${JSON.stringify(payload, null, 2)}\n`);
-}
-/* v8 ignore start — SPA static file serving infrastructure */
-const MIME_TYPES = {
-    ".html": "text/html",
-    ".js": "application/javascript",
-    ".css": "text/css",
-    ".json": "application/json",
-    ".svg": "image/svg+xml",
-    ".png": "image/png",
-    ".ico": "image/x-icon",
-    ".woff2": "font/woff2",
-};
-function resolveSpaDistDir() {
-    // Look for the built SPA relative to this file's location
-    // In production: dist/heart/daemon/outlook-http.js -> ../../packages/outlook-ui/dist/
-    // In dev: packages/outlook-ui/dist/
-    const candidates = [
-        path.resolve(__dirname, "..", "..", "..", "packages", "outlook-ui", "dist"),
-        path.resolve(__dirname, "..", "..", "packages", "outlook-ui", "dist"),
-        path.resolve(__dirname, "..", "..", "..", "..", "packages", "outlook-ui", "dist"),
-        // npm-published layout: the SPA dist is copied to dist/outlook-ui/
-        path.resolve(__dirname, "..", "..", "outlook-ui"),
-        path.resolve(__dirname, "..", "outlook-ui"),
-    ];
-    for (const candidate of candidates) {
-        if (fs.existsSync(path.join(candidate, "index.html")))
-            return candidate;
-    }
-    return null;
-}
-function serveStaticFile(response, filePath) {
-    try {
-        if (!fs.existsSync(filePath))
-            return false;
-        const ext = path.extname(filePath);
-        const contentType = MIME_TYPES[ext] ?? "application/octet-stream";
-        const content = fs.readFileSync(filePath);
-        response.writeHead(200, {
-            "content-type": contentType,
-            "cache-control": ext === ".html" ? "no-cache" : "public, max-age=31536000, immutable",
-        });
-        response.end(content);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/* v8 ignore stop */
-function normalizePath(urlValue = "/") {
-    const parsed = new URL(urlValue, "http://127.0.0.1");
-    const normalizedPath = parsed.pathname.replace(/\/+$/, "");
-    if (normalizedPath.length === 0)
-        return "/";
-    return normalizedPath;
-}
+const outlook_http_hooks_1 = require("./outlook-http-hooks");
+const outlook_http_routes_1 = require("./outlook-http-routes");
+const outlook_http_transport_1 = require("./outlook-http-transport");
 async function startOutlookHttpServer(options = {}) {
     const host = options.host ?? "127.0.0.1";
     const port = options.port ?? 0;
@@ -175,238 +47,26 @@ async function startOutlookHttpServer(options = {}) {
     const opts = bundlesRoot ? { bundlesRoot } : undefined;
     const readMachineState = options.readMachineState ?? (() => (0, outlook_read_1.readOutlookMachineState)(opts));
     const readMachineView = options.readMachineView;
-    /* v8 ignore start */
     const readAgentState = options.readAgentState ?? ((agentName) => {
         if (opts)
             return (0, outlook_read_1.readOutlookAgentState)(agentName, opts);
         return (0, outlook_read_1.readOutlookAgentState)(agentName);
     });
-    /* v8 ignore stop */
     const readAgentView = options.readAgentView;
-    /* v8 ignore start — default hook wiring, tested via integration */
-    const agentRoot = (agentName) => {
-        const base = bundlesRoot ?? "";
-        return path.join(base, `${agentName}.ouro`);
-    };
-    const hooks = {
-        readAgentSessions: options.readAgentSessions ?? ((agentName) => (0, outlook_read_1.readSessionInventory)(agentName, bundlesRoot ? { bundlesRoot } : undefined)),
-        readAgentTranscript: options.readAgentTranscript ?? ((agentName, friendId, channel, key) => (0, outlook_read_1.readSessionTranscript)(agentName, friendId, channel, key, bundlesRoot ? { bundlesRoot } : undefined)),
-        readAgentCoding: options.readAgentCoding ?? ((agentName) => (0, outlook_read_1.readCodingDeep)(agentRoot(agentName))),
-        readAgentAttention: options.readAgentAttention ?? ((agentName) => (0, outlook_read_1.readAttentionView)(agentName, bundlesRoot ? { bundlesRoot } : undefined)),
-        readAgentBridges: options.readAgentBridges ?? ((agentName) => (0, outlook_read_1.readBridgeInventory)(agentRoot(agentName))),
-        readAgentMemory: options.readAgentMemory ?? ((agentName) => (0, outlook_read_1.readMemoryView)(agentRoot(agentName))),
-        readAgentFriends: options.readAgentFriends ?? ((agentName) => (0, outlook_read_1.readFriendView)(agentName, bundlesRoot ? { bundlesRoot } : undefined)),
-        readAgentContinuity: options.readAgentContinuity ?? ((agentName) => (0, outlook_read_1.readOutlookContinuity)(agentRoot(agentName), agentName)),
-        readAgentOrientation: options.readAgentOrientation ?? ((agentName) => (0, outlook_read_1.readOrientationView)(agentRoot(agentName), agentName)),
-        readAgentObligations: options.readAgentObligations ?? ((agentName) => (0, outlook_read_1.readObligationDetailView)(agentRoot(agentName))),
-        readAgentChanges: options.readAgentChanges ?? ((agentName) => (0, outlook_read_1.readChangesView)(agentRoot(agentName))),
-        readAgentSelfFix: options.readAgentSelfFix ?? ((agentName) => (0, outlook_read_1.readSelfFixView)(agentRoot(agentName))),
-        readAgentMemoryDecisions: options.readAgentMemoryDecisions ?? ((agentName) => (0, outlook_read_1.readMemoryDecisionView)(agentRoot(agentName))),
-        readAgentHabits: options.readAgentHabits ?? ((agentName) => (0, outlook_read_1.readHabitView)(agentRoot(agentName))),
-        readDaemonHealth: options.readDaemonHealth ?? (() => (0, outlook_read_1.readDaemonHealthDeep)(options.healthPath)),
-        readLogs: options.readLogs ?? (() => (0, outlook_read_1.readLogView)(options.logPath ?? null)),
-    };
-    /* v8 ignore stop */
-    const sse = createSseBroadcaster();
-    /* v8 ignore start — watcher callback fires on filesystem changes */
-    const bundleWatcher = bundlesRoot ? createBundleWatcher(bundlesRoot, () => {
-        sse.broadcast("state-changed", { at: new Date().toISOString() });
-    }) : null;
-    /* v8 ignore stop */
-    const server = http.createServer((request, response) => {
-        let pathname = normalizePath(request.url);
-        const origin = `http://${host}:${server.address().port}`;
-        /* v8 ignore start — SPA static asset serving */
-        // Serve built SPA static assets: /assets/*
-        if (pathname.startsWith("/assets/")) {
-            const spaDir = resolveSpaDistDir();
-            if (spaDir) {
-                const assetPath = path.join(spaDir, pathname);
-                if (serveStaticFile(response, assetPath))
-                    return;
-            }
-            writeJson(response, 404, { ok: false, error: "asset not found" });
-            return;
-        }
-        /* v8 ignore stop */
-        // Legacy /outlook route — redirect to root
-        if (pathname === "/outlook") {
-            response.writeHead(301, { location: "/" });
-            response.end();
-            return;
-        }
-        // Compatibility alias: /outlook/api/* → /api/*
-        /* v8 ignore start -- legacy compat path: tested via integration @preserve */
-        if (pathname.startsWith("/outlook/api/")) {
-            pathname = pathname.slice("/outlook".length);
-        }
-        else if (pathname === "/outlook/api") {
-            pathname = "/api";
-        }
-        /* v8 ignore stop */
-        // SSE event stream
-        if (pathname === "/api/events") {
-            response.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", "connection": "keep-alive", "access-control-allow-origin": "*" });
-            response.write(":ok\n\n");
-            sse.add(response);
-            return;
-        }
-        if (pathname === "/api/machine") {
-            const machine = readMachineState();
-            const machineView = readMachineView?.({ origin, machine });
-            writeJson(response, 200, machineView ?? machine);
-            return;
-        }
-        if (pathname === "/api/machine/health") {
-            const health = hooks.readDaemonHealth();
-            writeJson(response, 200, health ?? { status: "unavailable" });
-            return;
-        }
-        if (pathname === "/api/machine/logs") {
-            writeJson(response, 200, hooks.readLogs());
-            return;
-        }
-        // Agent-level endpoints: /api/agents/:agent[/:surface[/:params...]]
-        const agentMatch = /^\/api\/agents\/([^/]+)(?:\/(.+))?$/.exec(pathname);
-        if (agentMatch) {
-            const agent = decodeURIComponent(agentMatch[1]);
-            const surface = agentMatch[2] ?? null;
-            if (!surface) {
-                const view = readAgentView?.(agent);
-                if (view) {
-                    writeJson(response, 200, view);
-                    return;
-                }
-                const state = readAgentState(agent);
-                if (!state) {
-                    writeJson(response, 404, { ok: false, error: `unknown agent: ${agent}` });
-                    return;
-                }
-                writeJson(response, 200, state);
-                return;
-            }
-            if (surface === "sessions") {
-                writeJson(response, 200, hooks.readAgentSessions(agent));
-                return;
-            }
-            const transcriptMatch = /^sessions\/([^/]+)\/([^/]+)\/([^/]+)$/.exec(surface);
-            if (transcriptMatch) {
-                const friendId = decodeURIComponent(transcriptMatch[1]);
-                const channel = decodeURIComponent(transcriptMatch[2]);
-                const key = decodeURIComponent(transcriptMatch[3]);
-                const transcript = hooks.readAgentTranscript(agent, friendId, channel, key);
-                if (!transcript) {
-                    writeJson(response, 404, { ok: false, error: "session not found" });
-                    return;
-                }
-                writeJson(response, 200, transcript);
-                return;
-            }
-            if (surface === "coding") {
-                writeJson(response, 200, hooks.readAgentCoding(agent));
-                return;
-            }
-            if (surface === "attention") {
-                writeJson(response, 200, hooks.readAgentAttention(agent));
-                return;
-            }
-            if (surface === "bridges") {
-                writeJson(response, 200, hooks.readAgentBridges(agent));
-                return;
-            }
-            if (surface === "memory") {
-                writeJson(response, 200, hooks.readAgentMemory(agent));
-                return;
-            }
-            if (surface === "friends") {
-                writeJson(response, 200, hooks.readAgentFriends(agent));
-                return;
-            }
-            if (surface === "continuity") {
-                writeJson(response, 200, hooks.readAgentContinuity(agent));
-                return;
-            }
-            if (surface === "orientation") {
-                writeJson(response, 200, hooks.readAgentOrientation(agent));
-                return;
-            }
-            if (surface === "obligations") {
-                writeJson(response, 200, hooks.readAgentObligations(agent));
-                return;
-            }
-            if (surface === "changes") {
-                writeJson(response, 200, hooks.readAgentChanges(agent));
-                return;
-            }
-            if (surface === "self-fix") {
-                writeJson(response, 200, hooks.readAgentSelfFix(agent));
-                return;
-            }
-            if (surface === "memory-decisions") {
-                writeJson(response, 200, hooks.readAgentMemoryDecisions(agent));
-                return;
-            }
-            /* v8 ignore start — desk prefs write + reads */
-            if (surface === "dismiss-obligation" && request.method === "POST") {
-                let body = "";
-                request.on("data", (chunk) => { body += chunk; });
-                request.on("end", () => {
-                    try {
-                        const { obligationId } = JSON.parse(body);
-                        if (!obligationId) {
-                            writeJson(response, 400, { ok: false, error: "obligationId required" });
-                            return;
-                        }
-                        const prefsPath = path.join(agentRoot(agent), "state", "outlook-prefs.json");
-                        let prefs = {};
-                        try {
-                            prefs = JSON.parse(fs.readFileSync(prefsPath, "utf-8"));
-                        }
-                        catch { /* new file */ }
-                        const dismissed = Array.isArray(prefs.dismissedObligations) ? prefs.dismissedObligations : [];
-                        if (!dismissed.includes(obligationId))
-                            dismissed.push(obligationId);
-                        prefs.dismissedObligations = dismissed;
-                        fs.mkdirSync(path.dirname(prefsPath), { recursive: true });
-                        fs.writeFileSync(prefsPath, JSON.stringify(prefs, null, 2) + "\n", "utf-8");
-                        writeJson(response, 200, { ok: true, dismissed: dismissed.length });
-                    }
-                    catch (error) {
-                        writeJson(response, 500, { ok: false, error: String(error) });
-                    }
-                });
-                return;
-            }
-            if (surface === "desk-prefs") {
-                writeJson(response, 200, (0, outlook_read_1.readDeskPrefs)(agentRoot(agent)));
-                return;
-            }
-            if (surface === "needs-me") {
-                writeJson(response, 200, (0, outlook_read_1.readNeedsMeView)(agent, opts));
-                return;
-            }
-            /* v8 ignore stop */
-            if (surface === "habits") {
-                writeJson(response, 200, hooks.readAgentHabits(agent));
-                return;
-            }
-            if (surface === "inner-transcript") {
-                const transcript = hooks.readAgentTranscript(agent, "self", "inner", "dialog");
-                writeJson(response, 200, transcript ?? { messageCount: 0, messages: [] });
-                return;
-            }
-            writeJson(response, 404, { ok: false, error: `unknown agent surface: ${surface}` });
-            return;
-        }
-        /* v8 ignore start — SPA fallback for client-side routing @preserve */
-        const spaDir = resolveSpaDistDir();
-        if (spaDir) {
-            if (serveStaticFile(response, path.join(spaDir, "index.html")))
-                return;
-        }
-        writeJson(response, 404, { ok: false, error: `not found: ${pathname}` });
-        /* v8 ignore stop */
-    });
+    const hooks = (0, outlook_http_hooks_1.createOutlookHttpReadHooks)(options);
+    const sse = (0, outlook_http_transport_1.createSseBroadcaster)();
+    const bundleWatcher = bundlesRoot ? (0, outlook_http_transport_1.createBundleWatcher)(bundlesRoot, (0, outlook_http_transport_1.createStateChangedBroadcast)(sse)) : null;
+    let server;
+    server = http.createServer((0, outlook_http_routes_1.createOutlookHttpRequestHandler)({
+        host,
+        getPort: () => server.address().port,
+        readMachineState,
+        readMachineView,
+        readAgentState,
+        readAgentView,
+        hooks,
+        sse,
+    }));
     await new Promise((resolve, reject) => {
         server.once("error", reject);
         server.listen(port, host, () => resolve());

package/dist/nerves/coverage/file-completeness.js

@@ -95,6 +95,13 @@ const DISPATCH_EXEMPT_PATTERNS = [
     // consumed by server readers and the UI. Outlook read/render modules own
     // the observability for these projections.
     "heart/outlook/outlook-types",
+    // Outlook HTTP helper modules: route/static/transport/hook seams are
+    // dispatched by outlook-http.ts, whose server lifecycle owns observability.
+    "heart/outlook/outlook-http-transport",
+    "heart/outlook/outlook-http-static",
+    "heart/outlook/outlook-http-hooks",
+    "heart/outlook/outlook-http-routes",
+    "heart/outlook/outlook-http-response",
 ];
 function isDispatchExempt(filePath) {
     return DISPATCH_EXEMPT_PATTERNS.some((pattern) => filePath.includes(pattern));

package/package.json

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