@ouro.bot/cli 0.1.0-alpha.191 → 0.1.0-alpha.193

package/changelog.json

@@ -2,8 +2,15 @@
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
     {
-      "version": "0.1.0-alpha.191",
+      "version": "0.1.0-alpha.193",
       "changes": [
+        "feat: Outlook visibility \u2014 orientation, obligations, changes, self-fix, memory decisions, route migration to /"
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.192",
+      "changes": [
+        "refactor: canonical obligations \u2014 ActiveWorkFrame as single source of truth for prompt sections",
         "feat(mcp): dynamic server add/remove \u2014 agents can manage MCP servers without daemon restart"
       ]
     },
@@ -1197,4 +1204,4 @@
       ]
     }
   ]
-}
+}

package/dist/heart/active-work.js

@@ -666,8 +666,8 @@ function formatActiveWorkFrame(frame, options) {
     }
     if ((frame.pendingObligations ?? []).length > 0) {
         const openCount = frame.pendingObligations.filter((ob) => (0, obligations_1.isOpenObligationStatus)(ob.status)).length;
-        if (options?.hasWakePacket && openCount > 0) {
-            // Wake packet carries enriched obligations (with resumeHint, stalenessClass, waitingOn).
+        if (options?.obligationDetailsRenderedElsewhere && openCount > 0) {
+            // Enriched obligation data (with resumeHint, stalenessClass, waitingOn) is rendered elsewhere.
             // Avoid duplicating the full list — just anchor the count here.
             lines.push("");
             lines.push(`return obligations: ${openCount} active (canonical details in **Owed** section of wake packet)`);

package/dist/heart/daemon/daemon.js

@@ -208,7 +208,7 @@ class OuroDaemon {
                 daemon: "running",
                 health: workers.every((worker) => worker.status === "running") ? "ok" : "warn",
                 socketPath: this.socketPath,
-                outlookUrl: `${this.outlookServer?.origin ?? "http://127.0.0.1:0"}/outlook`,
+                outlookUrl: this.outlookServer?.origin ?? "http://127.0.0.1:0",
                 ...(0, runtime_metadata_1.getRuntimeMetadata)(),
                 workerCount: workers.length,
                 senseCount: senses.length,

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

@@ -196,6 +196,12 @@ async function startOutlookHttpServer(options = {}) {
         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)),
@@ -208,14 +214,8 @@ async function startOutlookHttpServer(options = {}) {
     }) : null;
     /* v8 ignore stop */
     const server = http.createServer((request, response) => {
-        const pathname = normalizePath(request.url);
+        let pathname = normalizePath(request.url);
         const origin = `http://${host}:${server.address().port}`;
-        if (pathname === "/outlook/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;
-        }
         /* v8 ignore start — SPA static asset serving */
         // Serve built SPA static assets: /assets/*
         if (pathname.startsWith("/assets/")) {
@@ -235,23 +235,39 @@ async function startOutlookHttpServer(options = {}) {
             response.end();
             return;
         }
-        if (pathname === "/outlook/api/machine") {
+        // 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 === "/outlook/api/machine/health") {
+        if (pathname === "/api/machine/health") {
             const health = hooks.readDaemonHealth();
             writeJson(response, 200, health ?? { status: "unavailable" });
             return;
         }
-        if (pathname === "/outlook/api/machine/logs") {
+        if (pathname === "/api/machine/logs") {
             writeJson(response, 200, hooks.readLogs());
             return;
         }
-        // Agent-level endpoints: /outlook/api/agents/:agent[/:surface[/:params...]]
-        const agentMatch = /^\/outlook\/api\/agents\/([^/]+)(?:\/(.+))?$/.exec(pathname);
+        // 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;
@@ -306,6 +322,30 @@ async function startOutlookHttpServer(options = {}) {
                 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 = "";

package/dist/heart/daemon/outlook-read.js

@@ -48,6 +48,11 @@ exports.readHabitView = readHabitView;
 exports.readNeedsMeView = readNeedsMeView;
 exports.readDeskPrefs = readDeskPrefs;
 exports.readOutlookContinuity = readOutlookContinuity;
+exports.readOrientationView = readOrientationView;
+exports.readObligationDetailView = readObligationDetailView;
+exports.readChangesView = readChangesView;
+exports.readSelfFixView = readSelfFixView;
+exports.readMemoryDecisionView = readMemoryDecisionView;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
@@ -1329,3 +1334,286 @@ function readOutlookContinuity(agentRoot, agentName) {
         },
     };
 }
+// ---------------------------------------------------------------------------
+// Orientation reader — daemon-side assembly of "where am I?"
+// ---------------------------------------------------------------------------
+function readOrientationView(agentRoot, agentName) {
+    // Read obligations for primary selection
+    let obligations = [];
+    try {
+        obligations = (0, obligations_1.readObligations)(agentRoot);
+    }
+    catch {
+        obligations = [];
+    }
+    const openObligations = obligations.filter(obligations_1.isOpenObligation);
+    // Select primary obligation (most advanced status, then most recent)
+    const statusPriority = {
+        returning: 0,
+        collaborating: 1,
+        in_progress: 2,
+        delegated: 3,
+        accepted: 4,
+        pending: 5,
+    };
+    const sorted = [...openObligations].sort((a, b) => {
+        const sp = (statusPriority[a.status] ?? 99) - (statusPriority[b.status] ?? 99);
+        if (sp !== 0)
+            return sp;
+        const aMs = new Date(a.updatedAt ?? a.createdAt).getTime();
+        const bMs = new Date(b.updatedAt ?? b.createdAt).getTime();
+        return bMs - aMs;
+    });
+    const primary = sorted[0] ?? null;
+    // Read session activity for current session and others
+    let sessions = [];
+    try {
+        sessions = (0, session_activity_1.listSessionActivity)({
+            sessionsDir: path.join(agentRoot, "state", "sessions"),
+            friendsDir: path.join(agentRoot, "friends"),
+            agentName,
+        });
+    }
+    catch {
+        sessions = [];
+    }
+    const sortedSessions = [...sessions].sort((a, b) => b.lastActivityMs - a.lastActivityMs);
+    const currentSession = sortedSessions.length > 0
+        ? {
+            friendId: sortedSessions[0].friendId,
+            channel: sortedSessions[0].channel,
+            key: sortedSessions[0].key,
+            lastActivityAt: sortedSessions[0].lastActivityAt,
+        }
+        : null;
+    const otherActiveSessions = sortedSessions.slice(1).map((s) => ({
+        friendId: s.friendId,
+        friendName: s.friendName,
+        channel: s.channel,
+        key: s.key,
+        lastActivityAt: s.lastActivityAt,
+    }));
+    // Derive center of gravity summary
+    const parts = [];
+    if (primary)
+        parts.push(primary.content);
+    if (openObligations.length > 1)
+        parts.push(`${openObligations.length} open obligations`);
+    if (sessions.length > 0)
+        parts.push(`${sessions.length} active sessions`);
+    const centerOfGravity = parts.length > 0 ? parts.join(" | ") : "idle";
+    const primaryObligation = primary
+        ? {
+            id: primary.id,
+            content: primary.content,
+            status: primary.status,
+            nextAction: primary.nextAction ?? null,
+            waitingOn: primary.meaning?.waitingOn?.detail ?? null,
+        }
+        : null;
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.outlook_orientation_read",
+        message: `outlook orientation: ${openObligations.length} obligations, ${sessions.length} sessions`,
+        meta: { obligationCount: openObligations.length, sessionCount: sessions.length, primaryId: primary?.id ?? null },
+    });
+    return {
+        currentSession,
+        centerOfGravity,
+        primaryObligation,
+        resumeHandle: null,
+        otherActiveSessions,
+        rawState: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// Obligation detail reader — richer view with primary selection context
+// ---------------------------------------------------------------------------
+function readObligationDetailView(agentRoot) {
+    let obligations = [];
+    try {
+        obligations = (0, obligations_1.readObligations)(agentRoot);
+    }
+    catch {
+        obligations = [];
+    }
+    const openObligations = obligations.filter(obligations_1.isOpenObligation);
+    // Select primary (same logic as orientation)
+    const statusPriority = {
+        returning: 0,
+        collaborating: 1,
+        in_progress: 2,
+        delegated: 3,
+        accepted: 4,
+        pending: 5,
+    };
+    const sorted = [...openObligations].sort((a, b) => {
+        const sp = (statusPriority[a.status] ?? 99) - (statusPriority[b.status] ?? 99);
+        if (sp !== 0)
+            return sp;
+        const aMs = new Date(a.updatedAt ?? a.createdAt).getTime();
+        const bMs = new Date(b.updatedAt ?? b.createdAt).getTime();
+        return bMs - aMs;
+    });
+    const primary = sorted[0] ?? null;
+    const items = openObligations.map((ob) => ({
+        id: ob.id,
+        status: ob.status,
+        content: ob.content,
+        updatedAt: ob.updatedAt ?? ob.createdAt,
+        nextAction: ob.nextAction ?? null,
+        origin: ob.origin ?? null,
+        currentSurface: ob.currentSurface ? { kind: ob.currentSurface.kind, label: ob.currentSurface.label } : null,
+        meaning: ob.meaning ? { waitingOn: ob.meaning.waitingOn?.detail ?? null } : null,
+        isPrimary: primary ? ob.id === primary.id : false,
+    }));
+    let primarySelectionReason = null;
+    if (primary) {
+        if (primary.status !== "pending") {
+            primarySelectionReason = `most advanced status: ${primary.status}`;
+        }
+        else {
+            primarySelectionReason = "most recent pending";
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.outlook_obligations_read",
+        message: `outlook obligations: ${openObligations.length} open`,
+        meta: { openCount: openObligations.length, primaryId: primary?.id ?? null },
+    });
+    return {
+        openCount: openObligations.length,
+        primaryId: primary?.id ?? null,
+        primarySelectionReason,
+        items,
+    };
+}
+// ---------------------------------------------------------------------------
+// Changes reader — cross-session drift via snapshot comparison
+// ---------------------------------------------------------------------------
+const active_work_1 = require("../active-work");
+function readChangesView(agentRoot) {
+    const snapshotPath = path.join(agentRoot, "state", "outlook", "active-work-snapshot.json");
+    // Read prior snapshot
+    let previous = null;
+    try {
+        const raw = fs.readFileSync(snapshotPath, "utf-8");
+        previous = JSON.parse(raw);
+        if (!previous.obligationSnapshots || !previous.codingSnapshots)
+            previous = null;
+    }
+    catch {
+        previous = null;
+    }
+    // Build current snapshot from raw state
+    let obligations = [];
+    try {
+        obligations = (0, obligations_1.readObligations)(agentRoot);
+    }
+    catch {
+        obligations = [];
+    }
+    const openObligations = obligations.filter(obligations_1.isOpenObligation);
+    const current = {
+        obligationSnapshots: openObligations.map((ob) => ({
+            id: ob.id,
+            status: ob.status,
+            artifact: ob.currentArtifact?.trim() || null,
+            nextAction: ob.nextAction?.trim() || null,
+        })),
+        codingSnapshots: [],
+        timestamp: new Date().toISOString(),
+    };
+    // Persist current as the new snapshot
+    try {
+        fs.mkdirSync(path.dirname(snapshotPath), { recursive: true });
+        fs.writeFileSync(snapshotPath, JSON.stringify(current, null, 2) + "\n", "utf-8");
+    }
+    catch {
+        // Best effort
+    }
+    if (!previous) {
+        return { changeCount: 0, items: [], snapshotAge: null, formatted: "" };
+    }
+    const changes = (0, active_work_1.detectActiveWorkChanges)(previous, current);
+    const formatted = (0, active_work_1.formatActiveWorkChanges)(changes);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.outlook_changes_read",
+        message: `outlook changes: ${changes.length} detected`,
+        meta: { changeCount: changes.length, snapshotAge: previous.timestamp },
+    });
+    return {
+        changeCount: changes.length,
+        items: changes.map((c) => ({ kind: c.kind, id: c.id, from: c.from, to: c.to, summary: c.summary })),
+        snapshotAge: previous.timestamp,
+        formatted,
+    };
+}
+// ---------------------------------------------------------------------------
+// Self-fix workflow reader — derived from task board and coding state
+// ---------------------------------------------------------------------------
+function readSelfFixView(agentRoot) {
+    // Derive self-fix state from task scanner
+    let tasks = [];
+    try {
+        const scanned = (0, scanner_1.scanTasks)(path.join(agentRoot, "tasks"));
+        tasks = scanned.tasks.map((t) => ({ name: t.name, title: t.title, status: t.status }));
+    }
+    catch {
+        tasks = [];
+    }
+    // Look for self-fix-related tasks
+    const selfFixTasks = tasks.filter((t) => t.title.toLowerCase().includes("fix") || t.title.toLowerCase().includes("self-fix"));
+    if (selfFixTasks.length === 0) {
+        return { active: false, currentStep: null, steps: [] };
+    }
+    const steps = selfFixTasks.map((t) => ({
+        label: t.title,
+        status: t.status === "done" ? "done" : t.status === "processing" ? "active" : "pending",
+        detail: `task ${t.name}: ${t.status}`,
+    }));
+    const activeStep = steps.find((s) => s.status === "active");
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.outlook_selffix_read",
+        message: `outlook self-fix: ${selfFixTasks.length} tasks`,
+        meta: { taskCount: selfFixTasks.length, active: !!activeStep },
+    });
+    return {
+        active: !!activeStep,
+        currentStep: activeStep?.label ?? null,
+        steps,
+    };
+}
+// ---------------------------------------------------------------------------
+// Memory decisions reader — append-only JSONL log
+// ---------------------------------------------------------------------------
+function readMemoryDecisionView(agentRoot, limit = 50) {
+    const logPath = path.join(agentRoot, "state", "outlook", "memory-decisions.jsonl");
+    let lines = [];
+    try {
+        const raw = fs.readFileSync(logPath, "utf-8");
+        lines = raw.split("\n").filter((l) => l.trim().length > 0);
+    }
+    catch {
+        return { totalCount: 0, items: [] };
+    }
+    const items = [];
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.kind && parsed.decision && parsed.timestamp) {
+                items.push(parsed);
+            }
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    // Reverse chronological
+    items.reverse();
+    const limited = items.slice(0, limit);
+    return { totalCount: items.length, items: limited };
+}

package/dist/heart/wake-packet.js

@@ -65,10 +65,11 @@ function buildPresenceSection(peers) {
         .map((p) => `- ${p.agentName}: ${p.availability}/${p.lane}`)
         .join("\n");
 }
-function buildResumeHint(view) {
+function buildResumeHint(view, obligations) {
     // Compose from authored obligation resumeHints and top intentions
     const hints = [];
-    for (const ob of view.activeObligations) {
+    const effectiveObligations = obligations ?? view.activeObligations;
+    for (const ob of effectiveObligations) {
         if (ob.meaning?.resumeHint) {
             hints.push(ob.meaning.resumeHint);
         }
@@ -78,23 +79,24 @@ function buildResumeHint(view) {
     }
     if (hints.length === 0) {
         // Fall back to top obligation content
-        if (view.activeObligations.length > 0) {
-            hints.push(view.activeObligations[0].content);
+        if (effectiveObligations.length > 0) {
+            hints.push(effectiveObligations[0].content);
         }
     }
     if (hints.length === 0)
         return "";
     return hints.join("; ");
 }
-function buildWakePacket(view) {
+function buildWakePacket(view, opts) {
     const tempo = view.tempo;
     const tokenBudget = tempo_1.TEMPO_BUDGETS[tempo];
+    const effectiveObligations = opts?.canonicalObligations ? opts.canonicalObligations.all : view.activeObligations;
     const packet = {
         plotLine: buildPlotLine(view.recentEpisodes, tempo),
-        obligations: buildObligationsSection(view.activeObligations),
+        obligations: buildObligationsSection(effectiveObligations),
         cares: buildCaresSection(view.activeCares),
         presence: buildPresenceSection(view.peerPresence),
-        resumeHint: buildResumeHint(view),
+        resumeHint: buildResumeHint(view, opts?.canonicalObligations ? effectiveObligations : undefined),
         tempo,
         tokenBudget,
         assembledAt: new Date().toISOString(),

package/dist/mind/prompt.js

@@ -106,7 +106,10 @@ function resetPsycheCache() {
 }
 const DEFAULT_ACTIVE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
 function buildSessionSummary(options) {
-    const { sessionsDir, friendsDir, agentName, currentFriendId, currentChannel, currentKey, activeThresholdMs = DEFAULT_ACTIVE_THRESHOLD_MS, } = options;
+    const { sessionsDir, friendsDir, agentName, currentSession, activeThresholdMs = DEFAULT_ACTIVE_THRESHOLD_MS, } = options;
+    const currentFriendId = currentSession?.friendId ?? options.currentFriendId;
+    const currentChannel = currentSession?.channel ?? options.currentChannel;
+    const currentKey = currentSession?.key ?? options.currentKey;
     const now = Date.now();
     const query = {
         sessionsDir,
@@ -519,7 +522,7 @@ function wakePacketSection(options) {
 function activeWorkSection(options) {
     if (!options?.activeWorkFrame)
         return "";
-    return (0, active_work_1.formatActiveWorkFrame)(options.activeWorkFrame, { hasWakePacket: !!options?.wakePacket });
+    return (0, active_work_1.formatActiveWorkFrame)(options.activeWorkFrame, { obligationDetailsRenderedElsewhere: !!options?.wakePacket });
 }
 function liveWorldStateSection(options) {
     if (!options?.activeWorkFrame)
@@ -1079,6 +1082,9 @@ async function buildSystem(channel = "cli", options, context) {
             sessionsDir: path.join((0, identity_1.getAgentRoot)(), "state", "sessions"),
             friendsDir: path.join((0, identity_1.getAgentRoot)(), "friends"),
             agentName: (0, identity_1.getAgentName)(),
+            currentSession: options?.activeWorkFrame?.currentSession
+                ? { friendId: options.activeWorkFrame.currentSession.friendId, channel: options.activeWorkFrame.currentSession.channel, key: options.activeWorkFrame.currentSession.key }
+                : undefined,
             currentFriendId: context?.friend?.id,
             currentChannel: channel,
             currentKey: options?.currentSessionKey ?? "session",