@ouro.bot/cli 0.1.0-alpha.101 → 0.1.0-alpha.103

package/changelog.json

@@ -1,6 +1,20 @@
 {
   "_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.103",
+      "changes": [
+        "Status-check turns now answer in a fixed live-state shape that names the current conversation, active lane, artifact, latest checkpoint, and next action instead of drifting into broad mission summaries.",
+        "Those status turns now hold final streaming until the exact reply is ready and turn report-backs into same-thread obligation updates, so 'I'll report back here' comes back as a real in-thread follow-up instead of hidden background work."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.102",
+      "changes": [
+        "Live obligations now persist a concrete current artifact and next action, so status answers can anchor on the actual active lane, artifact, and immediate step instead of drifting into broad mission statements.",
+        "Obligation-bound coding feedback now turns PR milestones into structured report-backs and lifecycle updates, which keeps the originating live conversation informed when child work opens a PR, waits for merge, or needs a runtime update."
+      ]
+    },
     {
       "version": "0.1.0-alpha.101",
       "changes": [

package/dist/heart/active-work.js

@@ -63,6 +63,88 @@ function formatObligationSurface(obligation) {
             return ` (${obligation.currentSurface.label})`;
     }
 }
+function mergeArtifactFallback(obligation) {
+    const trimmed = obligation.content.trim();
+    if (!trimmed)
+        return "the fix";
+    const stripped = trimmed.replace(/^merge(?:\s+|$)/i, "").trim();
+    return stripped || "the fix";
+}
+function formatMergeArtifact(obligation) {
+    const currentArtifact = obligation.currentArtifact?.trim();
+    if (currentArtifact)
+        return currentArtifact;
+    if (obligation.currentSurface?.kind === "merge") {
+        const surfaceLabel = obligation.currentSurface.label.trim();
+        if (surfaceLabel)
+            return surfaceLabel;
+    }
+    return mergeArtifactFallback(obligation);
+}
+function findPrimaryOpenObligation(frame) {
+    return (frame.pendingObligations ?? []).find((ob) => ob.status !== "pending" && ob.status !== "fulfilled")
+        ?? (frame.pendingObligations ?? []).find(obligations_1.isOpenObligation)
+        ?? null;
+}
+function formatActiveLane(frame, obligation) {
+    const liveCodingSession = frame.codingSessions?.[0];
+    if (liveCodingSession) {
+        return `${formatCodingLaneLabel(liveCodingSession)}${describeCodingSessionScope(liveCodingSession, frame.currentSession)}`;
+    }
+    if (obligation?.currentSurface?.label) {
+        return obligation.currentSurface.label;
+    }
+    if (frame.inner?.job?.status === "running") {
+        return "inner dialog";
+    }
+    if (typeof frame.currentObligation === "string" && frame.currentObligation.trim().length > 0 && frame.currentSession) {
+        return "this same thread";
+    }
+    return null;
+}
+function formatCurrentArtifact(frame, obligation) {
+    if (obligation?.currentArtifact?.trim()) {
+        return obligation.currentArtifact.trim();
+    }
+    if (obligation?.currentSurface?.kind === "merge" && obligation.currentSurface.label.trim()) {
+        return obligation.currentSurface.label.trim();
+    }
+    if ((frame.codingSessions ?? []).length > 0) {
+        return "no PR or merge artifact yet";
+    }
+    if (typeof frame.currentObligation === "string" && frame.currentObligation.trim().length > 0) {
+        return "no artifact yet";
+    }
+    return null;
+}
+function formatNextAction(frame, obligation) {
+    if (obligation?.nextAction?.trim()) {
+        return obligation.nextAction.trim();
+    }
+    const liveCodingSession = frame.codingSessions?.[0];
+    if (liveCodingSession?.status === "waiting_input") {
+        return `answer ${formatCodingLaneLabel(liveCodingSession)} and continue`;
+    }
+    if (liveCodingSession?.status === "stalled") {
+        return `unstick ${formatCodingLaneLabel(liveCodingSession)} and continue`;
+    }
+    if (liveCodingSession) {
+        return "finish the coding pass and bring the result back here";
+    }
+    if (obligation?.status === "waiting_for_merge") {
+        return `wait for checks, merge ${formatMergeArtifact(obligation)}, then update runtime`;
+    }
+    if (obligation?.status === "updating_runtime") {
+        return "update runtime, verify version/changelog, then re-observe";
+    }
+    if (obligation) {
+        return "continue the active loop and bring the result back here";
+    }
+    if (typeof frame.currentObligation === "string" && frame.currentObligation.trim().length > 0) {
+        return `work on "${frame.currentObligation.trim()}" and bring back a concrete artifact`;
+    }
+    return null;
+}
 function suggestBridgeForActiveWork(input) {
     const targetCandidates = (input.targetCandidates ?? [])
         .filter((candidate) => {
@@ -173,6 +255,10 @@ function buildActiveWorkFrame(input) {
 }
 function formatActiveWorkFrame(frame) {
     const lines = ["## what i'm holding"];
+    const primaryObligation = findPrimaryOpenObligation(frame);
+    const activeLane = formatActiveLane(frame, primaryObligation);
+    const currentArtifact = formatCurrentArtifact(frame, primaryObligation);
+    const nextAction = formatNextAction(frame, primaryObligation);
     // Session line
     if (frame.currentSession) {
         let sessionLine = `i'm in a conversation on ${formatSessionLabel(frame.currentSession)}.`;
@@ -189,6 +275,22 @@ function formatActiveWorkFrame(frame) {
         lines.push("");
         lines.push("i'm not in a conversation right now.");
     }
+    if (activeLane || currentArtifact || nextAction) {
+        lines.push("");
+        lines.push("## current concrete state");
+        if (frame.currentSession) {
+            lines.push(`- live conversation: ${formatSessionLabel(frame.currentSession)}`);
+        }
+        if (activeLane) {
+            lines.push(`- active lane: ${activeLane}`);
+        }
+        if (currentArtifact) {
+            lines.push(`- current artifact: ${currentArtifact}`);
+        }
+        if (nextAction) {
+            lines.push(`- next action: ${nextAction}`);
+        }
+    }
     // Inner status block
     const job = frame.inner?.job;
     if (job) {

package/dist/heart/core.js

@@ -27,6 +27,7 @@ const azure_1 = require("./providers/azure");
 const minimax_1 = require("./providers/minimax");
 const openai_codex_1 = require("./providers/openai-codex");
 const github_copilot_1 = require("./providers/github-copilot");
+const obligation_steering_1 = require("../mind/obligation-steering");
 const pending_1 = require("../mind/pending");
 const identity_2 = require("./identity");
 const socket_client_1 = require("./daemon/socket-client");
@@ -272,6 +273,37 @@ function getFinalAnswerRetryError(mustResolveBeforeHandoff, intent, sawSteeringF
     }
     return null;
 }
+function hasExactStatusReplyShape(answer) {
+    const lines = answer.trimEnd().split(/\r?\n/);
+    if (lines.length !== 5)
+        return false;
+    return (/^live conversation:\s+\S.+$/i.test(lines[0])
+        && /^active lane:\s+\S.+$/i.test(lines[1])
+        && /^current artifact:\s+\S.+$/i.test(lines[2])
+        && /^latest checkpoint:\s+\S.+$/i.test(lines[3])
+        && /^next action:\s+\S.+$/i.test(lines[4]));
+}
+function extractLatestCheckpoint(answer) {
+    const latestLine = answer.trimEnd().split(/\r?\n/)[3];
+    return latestLine.replace(/^latest checkpoint:\s*/i, "").trim();
+}
+function getStatusReplyRetryError(answer, statusCheckRequested, activeWorkFrame) {
+    if (!statusCheckRequested || answer == null)
+        return null;
+    if (hasExactStatusReplyShape(answer))
+        return null;
+    if (!activeWorkFrame) {
+        return `the user asked for current status. call final_answer again using exactly these five non-empty lines and nothing else:
+live conversation: ...
+active lane: ...
+current artifact: ...
+latest checkpoint: ...
+next action: ...`;
+    }
+    return `the user asked for current status right now.
+${(0, obligation_steering_1.renderExactStatusReplyContract)(activeWorkFrame, (0, obligation_steering_1.findStatusObligation)(activeWorkFrame))}
+call final_answer again using that exact five-line shape and nothing else.`;
+}
 // Re-export kick utilities for backward compat
 var kicks_1 = require("./kicks");
 Object.defineProperty(exports, "hasToolIntent", { enumerable: true, get: function () { return kicks_1.hasToolIntent; } });
@@ -551,6 +583,7 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                 traceId,
                 toolChoiceRequired,
                 reasoningEffort: currentReasoningEffort,
+                eagerFinalAnswerStreaming: !options?.statusCheckRequested,
             });
             // Track usage from the latest API call
             if (result.usage)
@@ -599,15 +632,21 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                     // Supports: {"answer":"text","intent":"..."} or "text" (JSON string).
                     const { answer, intent } = parseFinalAnswerPayload(result.toolCalls[0].arguments);
                     const retryError = getFinalAnswerRetryError(mustResolveBeforeHandoffActive, intent, sawSteeringFollowUp, options?.delegationDecision, sawSendMessageSelf, sawGoInward, sawQuerySession, options?.currentObligation ?? null, options?.activeWorkFrame?.inner?.job, sawExternalStateQuery);
+                    const statusReplyRetryError = getStatusReplyRetryError(answer, options?.statusCheckRequested, options?.activeWorkFrame);
+                    const exactStatusReplyAccepted = Boolean(options?.statusCheckRequested) && !statusReplyRetryError && answer != null;
+                    const deliveredAnswer = exactStatusReplyAccepted && options?.activeWorkFrame
+                        ? (0, obligation_steering_1.buildExactStatusReply)(options.activeWorkFrame, (0, obligation_steering_1.findStatusObligation)(options.activeWorkFrame), extractLatestCheckpoint(answer))
+                        : answer;
                     const validDirectReply = mustResolveBeforeHandoffActive && intent === "direct_reply" && sawSteeringFollowUp;
                     const validTerminalIntent = intent === "complete" || intent === "blocked";
-                    const validClosure = answer != null
-                        && !retryError
-                        && (!mustResolveBeforeHandoffActive || validDirectReply || validTerminalIntent);
+                    const validClosure = deliveredAnswer != null
+                        && (exactStatusReplyAccepted || !retryError)
+                        && !statusReplyRetryError
+                        && (exactStatusReplyAccepted || !mustResolveBeforeHandoffActive || validDirectReply || validTerminalIntent);
                     if (validClosure) {
                         completion = {
-                            answer,
-                            intent: validDirectReply ? "direct_reply" : intent === "blocked" ? "blocked" : "complete",
+                            answer: deliveredAnswer,
+                            intent: validDirectReply && !exactStatusReplyAccepted ? "direct_reply" : intent === "blocked" ? "blocked" : "complete",
                         };
                         if (result.finalAnswerStreamed) {
                             // The streaming layer already parsed and emitted the answer
@@ -619,10 +658,10 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                             callbacks.onClearText?.();
                             // Emit the answer through the callback pipeline so channels receive it.
                             // Never truncate -- channel adapters handle splitting long messages.
-                            callbacks.onTextChunk(answer);
+                            callbacks.onTextChunk(deliveredAnswer);
                         }
                         messages.push(msg);
-                        if (validDirectReply) {
+                        if (validDirectReply && !exactStatusReplyAccepted) {
                             const resumeWork = "direct reply delivered. resume the unresolved obligation now and keep working until you can finish or clearly report that you are blocked.";
                             messages.push({ role: "tool", tool_call_id: result.toolCalls[0].id, content: resumeWork });
                             providerRuntime.appendToolOutput(result.toolCalls[0].id, resumeWork);
@@ -641,8 +680,11 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                         // assistant msg + error tool result and let the model try again.
                         callbacks.onClearText?.();
                         messages.push(msg);
-                        messages.push({ role: "tool", tool_call_id: result.toolCalls[0].id, content: retryError ?? "your final_answer was incomplete or malformed. call final_answer again with your complete response." });
-                        providerRuntime.appendToolOutput(result.toolCalls[0].id, retryError ?? "your final_answer was incomplete or malformed. call final_answer again with your complete response.");
+                        const toolRetryMessage = statusReplyRetryError
+                            ?? retryError
+                            ?? "your final_answer was incomplete or malformed. call final_answer again with your complete response.";
+                        messages.push({ role: "tool", tool_call_id: result.toolCalls[0].id, content: toolRetryMessage });
+                        providerRuntime.appendToolOutput(result.toolCalls[0].id, toolRetryMessage);
                     }
                     continue;
                 }

package/dist/heart/obligations.js

@@ -140,6 +140,12 @@ function advanceObligation(agentRoot, obligationId, update) {
     if (update.currentSurface) {
         obligation.currentSurface = update.currentSurface;
     }
+    if (typeof update.currentArtifact === "string") {
+        obligation.currentArtifact = update.currentArtifact;
+    }
+    if (typeof update.nextAction === "string") {
+        obligation.nextAction = update.nextAction;
+    }
     if (typeof update.latestNote === "string") {
         obligation.latestNote = update.latestNote;
     }

package/dist/heart/providers/anthropic.js

@@ -238,7 +238,7 @@ async function streamAnthropicMessages(client, model, request) {
     const toolCalls = new Map();
     const thinkingBlocks = new Map();
     const redactedBlocks = new Map();
-    const answerStreamer = new streaming_1.FinalAnswerStreamer(request.callbacks);
+    const answerStreamer = new streaming_1.FinalAnswerStreamer(request.callbacks, request.eagerFinalAnswerStreaming);
     try {
         for await (const event of response) {
             if (request.signal?.aborted)

package/dist/heart/providers/azure.js

@@ -136,7 +136,7 @@ function createAzureProviderRuntime() {
                 params.metadata = { trace_id: request.traceId };
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
-            const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal);
+            const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
             for (const item of result.outputItems)
                 nativeInput.push(item);
             return result;

package/dist/heart/providers/github-copilot.js

@@ -88,7 +88,7 @@ function createGithubCopilotProviderRuntime() {
                 if (request.toolChoiceRequired)
                     params.tool_choice = "required";
                 try {
-                    return await (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal);
+                    return await (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
                 }
                 catch (error) {
                     throw withAuthGuidance(error);
@@ -135,7 +135,7 @@ function createGithubCopilotProviderRuntime() {
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
             try {
-                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal);
+                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
                 for (const item of result.outputItems)
                     nativeInput.push(item);
                 return result;

package/dist/heart/providers/minimax.js

@@ -51,7 +51,7 @@ function createMinimaxProviderRuntime() {
                 params.metadata = { trace_id: request.traceId };
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
-            return (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal);
+            return (0, streaming_1.streamChatCompletion)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
         },
     };
 }

package/dist/heart/providers/openai-codex.js

@@ -158,7 +158,7 @@ function createOpenAICodexProviderRuntime() {
             if (request.toolChoiceRequired)
                 params.tool_choice = "required";
             try {
-                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal);
+                const result = await (0, streaming_1.streamResponsesApi)(this.client, params, request.callbacks, request.signal, request.eagerFinalAnswerStreaming);
                 for (const item of result.outputItems)
                     nativeInput.push(item);
                 return result;

package/dist/heart/streaming.js

@@ -84,13 +84,17 @@ class FinalAnswerStreamer {
     parser = new FinalAnswerParser();
     _detected = false;
     callbacks;
-    constructor(callbacks) {
+    enabled;
+    constructor(callbacks, enabled = true) {
         this.callbacks = callbacks;
+        this.enabled = enabled;
     }
     get detected() { return this._detected; }
     get streamed() { return this.parser.active; }
     /** Mark final_answer as detected. Calls onClearText on the callbacks. */
     activate() {
+        if (!this.enabled)
+            return;
         if (this._detected)
             return;
         this._detected = true;
@@ -98,6 +102,8 @@ class FinalAnswerStreamer {
     }
     /** Feed an argument delta through the parser. Emits text via onTextChunk. */
     processDelta(delta) {
+        if (!this.enabled)
+            return;
         if (!this._detected)
             return;
         const text = this.parser.process(delta);
@@ -227,7 +233,7 @@ function toResponsesTools(ccTools) {
         strict: false,
     }));
 }
-async function streamChatCompletion(client, createParams, callbacks, signal) {
+async function streamChatCompletion(client, createParams, callbacks, signal, eagerFinalAnswerStreaming = true) {
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.stream_start",
@@ -241,7 +247,7 @@ async function streamChatCompletion(client, createParams, callbacks, signal) {
     let toolCalls = {};
     let streamStarted = false;
     let usage;
-    const answerStreamer = new FinalAnswerStreamer(callbacks);
+    const answerStreamer = new FinalAnswerStreamer(callbacks, eagerFinalAnswerStreaming);
     // State machine for parsing inline <think> tags (MiniMax pattern)
     let contentBuf = "";
     let inThinkTag = false;
@@ -387,7 +393,7 @@ async function streamChatCompletion(client, createParams, callbacks, signal) {
         finalAnswerStreamed: answerStreamer.streamed,
     };
 }
-async function streamResponsesApi(client, createParams, callbacks, signal) {
+async function streamResponsesApi(client, createParams, callbacks, signal, eagerFinalAnswerStreaming = true) {
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.stream_start",
@@ -402,7 +408,7 @@ async function streamResponsesApi(client, createParams, callbacks, signal) {
     const outputItems = [];
     let currentToolCall = null;
     let usage;
-    const answerStreamer = new FinalAnswerStreamer(callbacks);
+    const answerStreamer = new FinalAnswerStreamer(callbacks, eagerFinalAnswerStreaming);
     let functionCallCount = 0;
     for await (const event of response) {
         if (signal?.aborted)

package/dist/mind/obligation-steering.js

@@ -1,13 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findActivePersistentObligation = findActivePersistentObligation;
+exports.findStatusObligation = findStatusObligation;
 exports.renderActiveObligationSteering = renderActiveObligationSteering;
+exports.renderConcreteStatusGuidance = renderConcreteStatusGuidance;
+exports.renderLiveThreadStatusShape = renderLiveThreadStatusShape;
+exports.buildExactStatusReply = buildExactStatusReply;
+exports.renderExactStatusReplyContract = renderExactStatusReplyContract;
 const runtime_1 = require("../nerves/runtime");
 function findActivePersistentObligation(frame) {
     if (!frame)
         return null;
     return (frame.pendingObligations ?? []).find((ob) => ob.status !== "pending" && ob.status !== "fulfilled") ?? null;
 }
+function obligationTimestampMs(obligation) {
+    return Date.parse(obligation.updatedAt ?? obligation.createdAt);
+}
+function newestObligationFirst(left, right) {
+    return obligationTimestampMs(right) - obligationTimestampMs(left);
+}
+function matchesCurrentSession(frame, obligation) {
+    return Boolean(frame.currentSession
+        && obligation.origin.friendId === frame.currentSession.friendId
+        && obligation.origin.channel === frame.currentSession.channel
+        && obligation.origin.key === frame.currentSession.key);
+}
+function findStatusObligation(frame) {
+    if (!frame)
+        return null;
+    const openObligations = [...(frame.pendingObligations ?? [])]
+        .filter((obligation) => obligation.status !== "fulfilled")
+        .sort(newestObligationFirst);
+    const sameSession = openObligations.find((obligation) => matchesCurrentSession(frame, obligation));
+    if (sameSession)
+        return sameSession;
+    return openObligations[0] ?? null;
+}
 function renderActiveObligationSteering(obligation) {
     (0, runtime_1.emitNervesEvent)({
         component: "mind",
@@ -29,3 +57,137 @@ i'm already working on something i owe ${name}.${surfaceLine}
 
 i should close that loop before i act like this is a fresh blank turn.`;
 }
+function mergeArtifactFallback(obligation) {
+    const trimmed = obligation.content.trim();
+    if (!trimmed)
+        return "the fix";
+    const stripped = trimmed.replace(/^merge(?:\s+|$)/i, "").trim();
+    return stripped || "the fix";
+}
+function formatMergeArtifact(obligation) {
+    const currentArtifact = obligation.currentArtifact?.trim();
+    if (currentArtifact)
+        return currentArtifact;
+    if (obligation.currentSurface?.kind === "merge") {
+        const surfaceLabel = obligation.currentSurface.label.trim();
+        if (surfaceLabel)
+            return surfaceLabel;
+    }
+    return mergeArtifactFallback(obligation);
+}
+function formatActiveLane(frame, obligation) {
+    const liveCodingSession = frame.codingSessions?.[0];
+    if (liveCodingSession) {
+        const sameThread = frame.currentSession
+            && liveCodingSession.originSession
+            && liveCodingSession.originSession.friendId === frame.currentSession.friendId
+            && liveCodingSession.originSession.channel === frame.currentSession.channel
+            && liveCodingSession.originSession.key === frame.currentSession.key;
+        return sameThread
+            ? `${liveCodingSession.runner} ${liveCodingSession.id} for this same thread`
+            : liveCodingSession.originSession
+                ? `${liveCodingSession.runner} ${liveCodingSession.id} for ${liveCodingSession.originSession.channel}/${liveCodingSession.originSession.key}`
+                : `${liveCodingSession.runner} ${liveCodingSession.id}`;
+    }
+    return obligation.currentSurface?.label
+        || (frame.currentObligation?.trim() ? "this same thread" : "this live loop");
+}
+function formatCurrentArtifact(frame, obligation) {
+    if (obligation?.currentArtifact)
+        return obligation.currentArtifact;
+    if (obligation?.currentSurface?.kind === "merge")
+        return obligation.currentSurface.label;
+    if (frame.currentObligation?.trim())
+        return "no artifact yet";
+    if ((frame.codingSessions ?? []).length > 0)
+        return "no PR or merge artifact yet";
+    return obligation ? "no explicit artifact yet" : "";
+}
+function isStatusCheckPrompt(text) {
+    const trimmed = text?.trim();
+    if (!trimmed)
+        return false;
+    return /^(what are you doing|what(?:'|’)s your status|status|status update|what changed|where are you at|where things stand)\??$/i.test(trimmed);
+}
+function formatNextAction(frame, obligation) {
+    if (obligation?.nextAction)
+        return obligation.nextAction;
+    const currentObligation = frame.currentObligation?.trim() ?? "";
+    const statusCheckPrompt = isStatusCheckPrompt(currentObligation);
+    const liveCodingSession = frame.codingSessions?.[0];
+    if (liveCodingSession?.status === "waiting_input") {
+        return `answer ${liveCodingSession.runner} ${liveCodingSession.id} and continue`;
+    }
+    if (liveCodingSession?.status === "stalled") {
+        return `unstick ${liveCodingSession.runner} ${liveCodingSession.id} and continue`;
+    }
+    if (liveCodingSession) {
+        return "finish the coding pass and bring the result back here";
+    }
+    if (obligation?.status === "waiting_for_merge") {
+        return `wait for checks, merge ${formatMergeArtifact(obligation)}, then update runtime`;
+    }
+    if (obligation?.status === "updating_runtime") {
+        return "update runtime, verify version/changelog, then re-observe";
+    }
+    if (currentObligation && !statusCheckPrompt) {
+        return `work on "${currentObligation}" and bring back a concrete artifact`;
+    }
+    return obligation ? "continue the active loop and bring the result back here" : "";
+}
+function renderConcreteStatusGuidance(frame, obligation) {
+    const activeLane = obligation ? formatActiveLane(frame, obligation) : (frame.currentObligation?.trim() ? "this same thread" : "");
+    const currentArtifact = formatCurrentArtifact(frame, obligation);
+    const nextAction = formatNextAction(frame, obligation);
+    const liveConversation = frame.currentSession
+        ? `${frame.currentSession.channel}/${frame.currentSession.key}`
+        : "";
+    if (!activeLane && !currentArtifact && !nextAction)
+        return "";
+    return `if someone asks what i'm doing or for status mid-task, i answer from these live facts instead of copying a canned block.
+the live conversation is ${liveConversation || "not in a live conversation"}.
+the active lane is ${activeLane}.
+the current artifact is ${currentArtifact}.
+if i just finished or verified something concrete in this live lane, i name that as the latest checkpoint.
+the next action is ${nextAction}.
+
+i use those facts to answer naturally unless this turn is an explicit direct status check, where the separate exact five-line contract applies.`;
+}
+function renderLiveThreadStatusShape(frame) {
+    if (!frame.currentSession)
+        return "";
+    return `if someone asks what i'm doing or for status mid-task in this live thread, i answer in these exact lines, in order, with no intro paragraph:
+live conversation: ${frame.currentSession.channel}/${frame.currentSession.key}
+active lane: this same thread
+current artifact: <actual artifact or "no artifact yet">
+latest checkpoint: <freshest concrete thing i just finished or verified>
+next action: <smallest concrete next step i'm taking now>
+
+no recap paragraph before those lines.
+no option list.
+present tense only.
+if a finished step matters, i label it "just finished" instead of presenting it as current work.`;
+}
+function buildExactStatusReply(frame, obligation, latestCheckpoint) {
+    const liveConversation = frame.currentSession
+        ? `${frame.currentSession.channel}/${frame.currentSession.key}`
+        : "not in a live conversation";
+    const activeLane = obligation
+        ? formatActiveLane(frame, obligation)
+        : (frame.currentSession ? "this same thread" : "this live loop");
+    const currentArtifact = formatCurrentArtifact(frame, obligation) || 'no artifact yet';
+    const nextAction = formatNextAction(frame, obligation) || "continue the active loop and bring the result back here";
+    const latest = latestCheckpoint.trim() || "<freshest concrete thing i just finished or verified>";
+    return [
+        `live conversation: ${liveConversation}`,
+        `active lane: ${activeLane}`,
+        `current artifact: ${currentArtifact}`,
+        `latest checkpoint: ${latest}`,
+        `next action: ${nextAction}`,
+    ].join("\n");
+}
+function renderExactStatusReplyContract(frame, obligation) {
+    return `reply using exactly these five lines and nothing else:
+${buildExactStatusReply(frame, obligation, "<freshest concrete thing i just finished or verified>")}
+`;
+}

package/dist/mind/prompt.js

@@ -464,13 +464,18 @@ function centerOfGravitySteeringSection(channel, options) {
     if (!frame)
         return "";
     const cog = frame.centerOfGravity;
-    if (cog === "local-turn")
-        return "";
     const job = frame.inner?.job;
     const activeObligation = (0, obligation_steering_1.findActivePersistentObligation)(frame);
+    const statusObligation = (0, obligation_steering_1.findStatusObligation)(frame);
+    const genericConcreteStatus = (0, obligation_steering_1.renderConcreteStatusGuidance)(frame, statusObligation);
+    if (cog === "local-turn") {
+        return genericConcreteStatus || (0, obligation_steering_1.renderLiveThreadStatusShape)(frame);
+    }
     if (cog === "inward-work") {
         if (activeObligation) {
-            return (0, obligation_steering_1.renderActiveObligationSteering)(activeObligation);
+            return `${(0, obligation_steering_1.renderActiveObligationSteering)(activeObligation)}
+
+${genericConcreteStatus}`;
         }
         if (job?.status === "queued" || job?.status === "running") {
             const originClause = job.origin
@@ -512,6 +517,9 @@ i already have coding work running in ${liveCodingSession.runner} ${liveCodingSe
 
 i should orient around that live lane first, then decide what still needs to come back here.`;
         }
+        if (genericConcreteStatus) {
+            return genericConcreteStatus;
+        }
         return `## where my attention is
 i have unfinished work that needs attention before i move on.
 
@@ -527,6 +535,17 @@ i should keep the different sides aligned. what i learn here may matter there, a
     /* v8 ignore next -- unreachable: all center-of-gravity modes covered above @preserve */
     return "";
 }
+function statusCheckSection(channel, options) {
+    if (channel === "inner" || !options?.statusCheckRequested)
+        return "";
+    const frame = options.activeWorkFrame;
+    if (!frame)
+        return "";
+    const activeObligation = (0, obligation_steering_1.findStatusObligation)(frame);
+    return `## status question on this turn
+the user is asking for current status right now.
+${(0, obligation_steering_1.renderExactStatusReplyContract)(frame, activeObligation)}`;
+}
 function commitmentsSection(options) {
     if (!options?.activeWorkFrame)
         return "";
@@ -734,6 +753,7 @@ async function buildSystem(channel = "cli", options, context) {
         skillsSection(),
         taskBoardSection(),
         activeWorkSection(options),
+        statusCheckSection(channel, options),
         centerOfGravitySteeringSection(channel, options),
         commitmentsSection(options),
         delegationHintSection(options),

package/dist/repertoire/coding/feedback.js

@@ -14,6 +14,8 @@ const OBLIGATION_WAKE_UPDATE_KINDS = new Set([
     "failed",
     "killed",
 ]);
+const PULL_REQUEST_NUMBER_PATTERN = /\bPR\s*#(\d+)\b/i;
+const PULL_REQUEST_URL_PATTERN = /\/pull\/(\d+)(?:\b|\/)?/i;
 function clip(text, maxLength = 280) {
     const trimmed = text.trim();
     if (trimmed.length <= maxLength)
@@ -57,17 +59,76 @@ function formatSessionLabel(session) {
         : "";
     return `${session.runner} ${session.id}${origin}`;
 }
+function extractPullRequestLabel(snippet) {
+    if (!snippet)
+        return null;
+    const numberMatch = snippet.match(PULL_REQUEST_NUMBER_PATTERN);
+    if (numberMatch)
+        return `PR #${numberMatch[1]}`;
+    const urlMatch = snippet.match(PULL_REQUEST_URL_PATTERN);
+    if (urlMatch)
+        return `PR #${urlMatch[1]}`;
+    return null;
+}
+function isMergedPullRequestSnippet(snippet) {
+    return /\bmerged\b/i.test(snippet) || /\blanded\b/i.test(snippet);
+}
+function deriveObligationMilestone(update) {
+    const snippet = pickUpdateSnippet(update);
+    const pullRequest = extractPullRequestLabel(snippet);
+    if (update.kind === "completed" && snippet && pullRequest && isMergedPullRequestSnippet(snippet)) {
+        return {
+            status: "updating_runtime",
+            currentSurface: { kind: "runtime", label: "ouro up" },
+            currentArtifact: pullRequest,
+            nextAction: "update runtime, verify version/changelog, then re-observe",
+        };
+    }
+    if (update.kind === "completed" && pullRequest) {
+        return {
+            status: "waiting_for_merge",
+            currentSurface: { kind: "merge", label: pullRequest },
+            currentArtifact: pullRequest,
+            nextAction: `wait for checks, merge ${pullRequest}, then update runtime`,
+        };
+    }
+    if (update.kind === "waiting_input") {
+        return {
+            status: "investigating",
+            currentSurface: { kind: "coding", label: `${update.session.runner} ${update.session.id}` },
+            nextAction: `answer ${update.session.runner} ${update.session.id} and continue`,
+        };
+    }
+    if (update.kind === "stalled") {
+        return {
+            status: "investigating",
+            currentSurface: { kind: "coding", label: `${update.session.runner} ${update.session.id}` },
+            nextAction: `unstick ${update.session.runner} ${update.session.id} and continue`,
+        };
+    }
+    if (update.kind === "progress" || update.kind === "spawned" || update.kind === "failed" || update.kind === "killed" || update.kind === "completed") {
+        return {
+            status: "investigating",
+            currentSurface: { kind: "coding", label: `${update.session.runner} ${update.session.id}` },
+        };
+    }
+    return null;
+}
 function isSafeProgressSnippet(snippet) {
+    const normalized = snippet.trim();
     const wordCount = snippet.split(/\s+/).filter(Boolean).length;
-    return (snippet.length <= 80
+    return (normalized.length <= 80
+        && wordCount >= 2
         && wordCount <= 8
-        && !snippet.includes(":")
-        && !snippet.startsWith("**")
-        && !/^Respond with\b/i.test(snippet)
-        && !/^Coding session metadata\b/i.test(snippet)
-        && !/^sessionId\b/i.test(snippet)
-        && !/^taskRef\b/i.test(snippet)
-        && !/^parentAgent\b/i.test(snippet));
+        && /[A-Za-z]{3,}/.test(normalized)
+        && !normalized.includes(":")
+        && !/[{}\[\]();]/.test(normalized)
+        && !normalized.startsWith("**")
+        && !/^Respond with\b/i.test(normalized)
+        && !/^Coding session metadata\b/i.test(normalized)
+        && !/^sessionId\b/i.test(normalized)
+        && !/^taskRef\b/i.test(normalized)
+        && !/^parentAgent\b/i.test(normalized));
 }
 function pickUpdateSnippet(update) {
     return (lastMeaningfulLine(update.text)
@@ -94,6 +155,22 @@ function formatUpdateMessage(update) {
             return `${label} started`;
     }
 }
+function formatReportBackMessage(update, baseMessage) {
+    if (!baseMessage)
+        return null;
+    if (!update.session.obligationId || !update.session.originSession) {
+        return baseMessage;
+    }
+    const milestone = deriveObligationMilestone(update);
+    const extraLines = [];
+    if (milestone?.currentArtifact) {
+        extraLines.push(`current artifact: ${milestone.currentArtifact}`);
+    }
+    if (milestone?.nextAction) {
+        extraLines.push(`next: ${milestone.nextAction}`);
+    }
+    return extraLines.length > 0 ? `${baseMessage}\n${extraLines.join("\n")}` : baseMessage;
+}
 function obligationNoteFromUpdate(update) {
     const snippet = pickUpdateSnippet(update);
     switch (update.kind) {
@@ -121,10 +198,13 @@ function syncObligationFromUpdate(update) {
     const obligationId = update.session.obligationId;
     if (!obligationId)
         return;
+    const milestone = deriveObligationMilestone(update);
     try {
         (0, obligations_1.advanceObligation)((0, identity_1.getAgentRoot)(), obligationId, {
-            status: "investigating",
-            currentSurface: { kind: "coding", label: `${update.session.runner} ${update.session.id}` },
+            status: milestone?.status ?? "investigating",
+            currentSurface: milestone?.currentSurface ?? { kind: "coding", label: `${update.session.runner} ${update.session.id}` },
+            currentArtifact: milestone?.currentArtifact,
+            nextAction: milestone?.nextAction,
             latestNote: obligationNoteFromUpdate(update) ?? undefined,
         });
     }
@@ -193,10 +273,10 @@ function attachCodingSessionFeedback(manager, session, target) {
     };
     const spawnedUpdate = { kind: "spawned", session };
     syncObligationFromUpdate(spawnedUpdate);
-    sendMessage(formatUpdateMessage(spawnedUpdate));
+    sendMessage(formatReportBackMessage(spawnedUpdate, formatUpdateMessage(spawnedUpdate)));
     unsubscribe = manager.subscribe(session.id, async (update) => {
         syncObligationFromUpdate(update);
-        sendMessage(formatUpdateMessage(update));
+        sendMessage(formatReportBackMessage(update, formatUpdateMessage(update)));
         await wakeInnerDialogForObligation(update);
         if (TERMINAL_UPDATE_KINDS.has(update.kind)) {
             closed = true;

package/dist/repertoire/coding/tools.js

@@ -99,6 +99,9 @@ function selectCodingStatusSessions(sessions, currentSession) {
     }
     return [...sessions].sort(latestSessionFirst);
 }
+function buildCodingObligationContent(taskRef) {
+    return `finish ${taskRef} and bring the result back`;
+}
 const codingSpawnTool = {
     type: "function",
     function: {
@@ -231,6 +234,13 @@ exports.codingToolDefinitions = [
                 }
                 return JSON.stringify({ ...existingSession, reused: true });
             }
+            if (request.originSession && !request.obligationId) {
+                const created = (0, obligations_1.createObligation)((0, identity_1.getAgentRoot)(), {
+                    origin: request.originSession,
+                    content: buildCodingObligationContent(taskRef),
+                });
+                request.obligationId = created.id;
+            }
             const session = await manager.spawnSession(request);
             if (session.obligationId) {
                 (0, obligations_1.advanceObligation)((0, identity_1.getAgentRoot)(), session.obligationId, {

package/dist/senses/pipeline.js

@@ -38,6 +38,23 @@ function emptyTaskBoard() {
         activeBridges: [],
     };
 }
+const STATUS_CHECK_PATTERNS = [
+    /^\s*what are you doing\??\s*$/i,
+    /^\s*what'?s your status\??\s*$/i,
+    /^\s*status\??\s*$/i,
+    /^\s*status update\??\s*$/i,
+    /^\s*what changed\??\s*$/i,
+    /^\s*where (?:are you at|things stand)\??\s*$/i,
+];
+function isStatusCheckRequested(ingressTexts) {
+    const latest = ingressTexts
+        ?.map((text) => text.trim())
+        .filter((text) => text.length > 0)
+        .at(-1);
+    if (!latest)
+        return false;
+    return STATUS_CHECK_PATTERNS.some((pattern) => pattern.test(latest));
+}
 function readInnerWorkState() {
     const defaultJob = {
         status: "idle",
@@ -271,6 +288,7 @@ async function handleInboundTurn(input) {
     }
     // Step 5: runAgent
     const existingToolContext = input.runAgentOptions?.toolContext;
+    const statusCheckRequested = isStatusCheckRequested(input.continuityIngressTexts);
     const runAgentOptions = {
         ...input.runAgentOptions,
         bridgeContext,
@@ -278,6 +296,8 @@ async function handleInboundTurn(input) {
         delegationDecision,
         currentSessionKey: currentSession.key,
         currentObligation,
+        statusCheckRequested,
+        toolChoiceRequired: statusCheckRequested ? true : input.runAgentOptions?.toolChoiceRequired,
         mustResolveBeforeHandoff,
         setMustResolveBeforeHandoff: (value) => {
             mustResolveBeforeHandoff = value;

package/package.json

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