ralph-flow-pi 0.1.0

package/dist/tui/render.js

@@ -0,0 +1,266 @@
+/**
+ * Pure rendering: RunModel → terminal lines.
+ *
+ * No pi-tui, no side effects, no I/O. Given a model and a width it returns the
+ * exact lines the run view shows, so the entire look of the product is unit-
+ * testable without a terminal. run-view.ts is a thin pi-tui wrapper that pipes
+ * these lines to the screen and calls back in on input.
+ *
+ * The layout is a growing stream on top with a persistent status block pinned at
+ * the bottom (pi-tui's TUI keeps the tail visible, so "bottom" is always on
+ * screen while stream history scrolls up — the same shape as a chat's fixed
+ * input bar). This is what a chat transcript could never give: a live pipeline
+ * you can see all of, with each step's real work streaming in place.
+ */
+import { isTerminal, needsUser, } from "./run-model.js";
+import { visibleWidth, wrapTextWithAnsi, truncateToWidth } from "../pi/tui.js";
+// ─── minimal ANSI (kept local so this file stays pure and dependency-free) ────
+const ESC = "\x1b[";
+const codes = {
+    reset: `${ESC}0m`,
+    dim: `${ESC}2m`,
+    bold: `${ESC}1m`,
+    red: `${ESC}31m`,
+    green: `${ESC}32m`,
+    yellow: `${ESC}33m`,
+    blue: `${ESC}34m`,
+    magenta: `${ESC}35m`,
+    cyan: `${ESC}36m`,
+    gray: `${ESC}90m`,
+};
+const c = (code, s) => `${code}${s}${codes.reset}`;
+export const dim = (s) => c(codes.dim, s);
+export const bold = (s) => c(codes.bold, s);
+export const green = (s) => c(codes.green, s);
+export const red = (s) => c(codes.red, s);
+export const yellow = (s) => c(codes.yellow, s);
+export const cyan = (s) => c(codes.cyan, s);
+export const gray = (s) => c(codes.gray, s);
+export const magenta = (s) => c(codes.magenta, s);
+/**
+ * Display width, counting CJK/emoji as 2 columns (delegates to pi-tui so it
+ * agrees exactly with the width pi-tui's renderer enforces — a mismatch makes
+ * the TUI throw "line exceeds terminal width").
+ */
+export function visibleLength(s) {
+    return visibleWidth(s);
+}
+/**
+ * Wrap a logical line to `width` display columns, ANSI- and wide-char-aware.
+ * Uses pi-tui's own wrapper, so every line we emit is guaranteed to fit.
+ */
+export function wrap(text, width) {
+    if (width <= 0)
+        return [text];
+    const out = [];
+    for (const raw of text.split("\n")) {
+        const wrapped = wrapTextWithAnsi(raw, width);
+        if (wrapped.length === 0)
+            out.push("");
+        else
+            for (const l of wrapped)
+                out.push(l);
+    }
+    return out;
+}
+// ─── step list (the compact pipeline row that stays visible) ──────────────────
+const STEP_ICON = {
+    pending: gray("○"),
+    do: cyan("▶"),
+    check: yellow("🔍"),
+    passed: green("✓"),
+    failed: red("✗"),
+    gate: magenta("📋"),
+    done: green("✓"),
+};
+function stepIcon(status) {
+    return STEP_ICON[status] ?? gray("○");
+}
+/**
+ * Pipeline strip: an icon-only progress row, then a dedicated line naming
+ * the active step — number, description, DO/CHECK, elapsed. Two lines, not
+ * one, on purpose: cramming "步骤 3/7：技术方案设计 DO 45s" onto the same
+ * line as the icon row (the original design) made a user report they could
+ * only tell "some step is running" from a glance — the icons read fine as a
+ * progress bar, but the one piece of text answering "which step, doing
+ * what, DO or CHECK" was easy to miss appended after seven icons. Giving it
+ * its own line, led with the step's ordinal position, fixes that without
+ * adding new information — everything here was already computed, just
+ * under-emphasized. `now` defaults to the real clock but is an explicit
+ * param so tests stay deterministic — this is the only place render.ts
+ * touches wall-clock time at all.
+ */
+export function renderStepStrip(m, width, now = Date.now()) {
+    const icons = m.steps.map((s) => (s.id === m.activeStepId ? bold(stepIcon(s.status)) : stepIcon(s.status))).join(" ");
+    const active = m.steps.find((s) => s.id === m.activeStepId);
+    const out = wrap(icons, width);
+    if (active)
+        out.push(...wrap(activeLabel(m, active, now), width));
+    return out;
+}
+function activeLabel(m, step, now) {
+    const ordinal = m.steps.findIndex((s) => s.id === step.id) + 1;
+    const stepNum = bold(`步骤 ${ordinal}/${m.steps.length}`);
+    const phaseTag = m.activePhase === "do" ? cyan("DO") : m.activePhase === "check" ? yellow("CHECK") : "";
+    const elapsed = m.activePhase && m.phaseStartedAt ? dim(` ${formatElapsed(now - m.phaseStartedAt)}`) : "";
+    return `${stepNum}${dim("：")}${step.desc}${phaseTag ? " " + phaseTag : ""}${elapsed}`;
+}
+/**
+ * "3m05s" / "42s" — the only way to tell "still thinking" from "stuck" during
+ * a long silent stretch (no reasoning/tool events at all) is a ticking clock,
+ * not the stream itself.
+ */
+function formatElapsed(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return minutes > 0 ? `${minutes}m${String(seconds).padStart(2, "0")}s` : `${seconds}s`;
+}
+// ─── the stream (the active step's live work) ─────────────────────────────────
+/** Render one block. Reasoning is dimmed; tools show their key arg + a few result lines. */
+export function renderBlock(b, width) {
+    switch (b.kind) {
+        case "phase":
+            return [dim("─".repeat(Math.min(width, 40))), ...wrap(bold(b.phase === "do" ? `▶ DO${b.attempt > 1 ? ` · 第 ${b.attempt} 次` : ""}` : `🔍 CHECK（独立只读验证）`), width)];
+        case "reasoning": {
+            const lines = wrap(b.text.trim(), width);
+            return lines.map((l) => dim(l));
+        }
+        case "text":
+            return wrap(b.text.trim(), width);
+        case "tool": {
+            const lines = wrap(toolHead(b), width);
+            if (b.result && b.result.trim()) {
+                const resultLines = wrap(b.result.trim(), Math.max(1, width - 2)).slice(0, 12);
+                for (const rl of resultLines)
+                    lines.push("  " + dim(rl));
+            }
+            return lines;
+        }
+        case "verdict": {
+            if (b.infra)
+                return [yellow(`⚠ 验证未能运行：${b.reason}`)];
+            const head = b.passed ? green(`✓ 通过`) : red(`✗ 未通过`);
+            return wrap(`${head} ${dim("— " + b.reason)}`, width);
+        }
+        case "notice":
+            return wrap(b.text, width);
+        case "user":
+            return wrap(bold(cyan("› 你：")) + " " + b.text, width);
+    }
+}
+function toolHead(b) {
+    const mark = b.status === "running" ? cyan("▸") : b.status === "error" ? red("✗") : green("▸");
+    const arg = b.arg ? " " + dim(b.arg) : "";
+    return `${mark} ${b.name}${arg}`;
+}
+/** The active step's stream as lines. */
+export function renderStream(m, width) {
+    const blocks = m.activeStepId ? m.streams.get(m.activeStepId) ?? [] : [];
+    const out = [];
+    for (const b of blocks) {
+        for (const line of renderBlock(b, width))
+            out.push(line);
+    }
+    return out;
+}
+// ─── the persistent status block (pinned at the bottom) ───────────────────────
+const STATUS_HEAD = {
+    running: cyan("▶ 运行中"),
+    gate: magenta("📋 等待审查"),
+    paused: yellow("⏸ 已暂停"),
+    stalled: yellow("⚠ 已停止驱动"),
+    completed: green("✓ 已完成"),
+    cancelled: gray("已取消"),
+};
+/** Header + step strip + action prompt + hints — always visible at the bottom. */
+export function renderStatus(m, width, now = Date.now()) {
+    const out = [];
+    out.push(dim("─".repeat(width)));
+    // Title line: workflow · task.
+    const title = `${bold(m.workflowName)}${dim(" · ")}${truncate(m.task, Math.max(10, width - visibleLength(m.workflowName) - 4))}`;
+    out.push(...wrap(title, width));
+    // Pipeline strip (icons, then "步骤 N/Total：desc DO/CHECK elapsed" — the
+    // step counter lives there now, right next to what it's counting; restating
+    // it here would just be the same number twice).
+    out.push(...renderStepStrip(m, width, now));
+    // Run status (running / gate / paused / stalled / completed / cancelled).
+    out.push(...wrap(STATUS_HEAD[m.status], width));
+    // Action prompt when the user is needed.
+    for (const line of renderAction(m, width))
+        out.push(line);
+    // Key hints.
+    out.push(...wrap(dim(hintLine(m)), width));
+    return out;
+}
+/** The actionable block for gate / pause / stall / completion. */
+export function renderAction(m, width) {
+    if (m.status === "gate") {
+        return [
+            ...wrap(magenta("📋 ") + m.statusDetail, width),
+            ...wrap(`直接打字提修改意见，或输入 ${bold("/ralphflow-continue")} 通过、${bold("/ralphflow-cancel")} 取消`, width),
+        ];
+    }
+    if (m.status === "paused" || m.status === "stalled") {
+        return [
+            ...wrap(yellow("⏸ ") + m.statusDetail, width),
+            ...wrap(`可以先打字留一句补充说明，再输入 ${bold("/ralphflow-continue")} 继续、${bold("/ralphflow-cancel")} 取消`, width),
+        ];
+    }
+    if (m.status === "completed") {
+        const rp = m.reportPath ? dim(`报告：${m.reportPath}`) : "";
+        return wrap(green("✓ 工作流完成。") + (rp ? " " + rp : ""), width);
+    }
+    return [];
+}
+function hintLine(m) {
+    if (isTerminal(m))
+        return "Esc 退出 · ↑↓ 滚动";
+    if (m.activePhase === "check")
+        return "🔍 独立验证中，不可插话 · ↑↓ 滚动 · Esc 退出";
+    if (needsUser(m))
+        return "↑↓ 滚动 · Esc 退出（输入框为空时）";
+    return "随时打字插话，模型会接着聊 · ↑↓ 滚动 · Esc 退出（输入框为空时）";
+}
+// ─── whole screen (stream on top, status pinned below) ────────────────────────
+/**
+ * The complete document. pi-tui's `TUI` has no real scrollable viewport —
+ * there's no API for "pin this footer, scroll that region above it" (checked:
+ * `TUI extends Container`'s public surface has nothing scroll-related; the
+ * `previousViewportTop` field it does have is a private diffing internal, not
+ * something a Component can use). What `TUI` actually does is redraw the last
+ * `terminalRows` lines of *whatever this function returns this frame* — so
+ * "scrolling" only has one degree of freedom available: change how many lines
+ * this function returns, in front of a renderer that always anchors to the
+ * bottom of that array.
+ *
+ * The bug this used to have: the earlier version dropped lines straight off
+ * the end of `stream` as `scrollBack` grew, which shrinks the *whole returned
+ * array* by that much every keypress — since the status block sits at the very
+ * end, its position relative to the top of the (now shorter) array moves every
+ * time, and because the renderer bottom-anchors, that reads as the status
+ * block itself sliding up the screen the moment you press Up, before there's
+ * any real "scrolling" sensation at all. A user reported exactly this: "方向键
+ * 上去看的时候，不是滚动看，而是下面分割线的布局先往上跑."
+ *
+ * The fix: keep the returned array's total length **invariant to
+ * `scrollBack`** by left-padding with blank lines instead of shrinking the
+ * array. The status block then always sits at the same offset from the end of
+ * the document no matter how far back you've scrolled, so the bottom-anchored
+ * renderer keeps it visually still — only the *content* revealed above it
+ * changes as you page up, which is what "scrolling" is supposed to look like
+ * within a renderer that has no actual scroll primitive.
+ */
+export function renderScreen(m, width, scrollBack = 0, now = Date.now()) {
+    const stream = renderStream(m, width);
+    const status = renderStatus(m, width, now);
+    const visibleCount = Math.max(0, stream.length - scrollBack);
+    const revealed = stream.slice(0, visibleCount);
+    const padding = new Array(stream.length - revealed.length).fill("");
+    return [...padding, ...revealed, "", ...status];
+}
+function truncate(s, width) {
+    const clean = s.replace(/\s+/g, " ").trim();
+    return visibleWidth(clean) <= width ? clean : truncateToWidth(clean, Math.max(1, width));
+}
+//# sourceMappingURL=render.js.map

package/dist/tui/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/tui/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,UAAU,EAAE,SAAS,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/E,iFAAiF;AAEjF,MAAM,GAAG,GAAG,OAAO,CAAC;AACpB,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE,GAAG,GAAG,IAAI;IACjB,GAAG,EAAE,GAAG,GAAG,IAAI;IACf,IAAI,EAAE,GAAG,GAAG,IAAI;IAChB,GAAG,EAAE,GAAG,GAAG,KAAK;IAChB,KAAK,EAAE,GAAG,GAAG,KAAK;IAClB,MAAM,EAAE,GAAG,GAAG,KAAK;IACnB,IAAI,EAAE,GAAG,GAAG,KAAK;IACjB,OAAO,EAAE,GAAG,GAAG,KAAK;IACpB,IAAI,EAAE,GAAG,GAAG,KAAK;IACjB,IAAI,EAAE,GAAG,GAAG,KAAK;CAClB,CAAC;AACF,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACnE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;YAClC,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF,MAAM,SAAS,GAA+B;IAC5C,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;IAClB,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;CACjB,CAAC;AAEF,SAAS,QAAQ,CAAC,MAAkB;IAClC,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,CAAW,EAAE,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClF,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtH,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,CAAW,EAAE,IAAc,EAAE,GAAW;IAC3D,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1G,OAAO,GAAG,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,EAAU;IAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;AACzF,CAAC;AAED,iFAAiF;AAEjF,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,CAAc,EAAE,KAAa;IACvD,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACnK,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/E,KAAK,MAAM,EAAE,IAAI,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAyC;IACzD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/F,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;AACnC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,KAAa;IACrD,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF,MAAM,WAAW,GAA8B;IAC7C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;CACvB,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC/E,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,+BAA+B;IAC/B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjI,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChC,uEAAuE;IACvE,4EAA4E;IAC5E,gDAAgD;IAChD,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,yCAAyC;IACzC,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,aAAa;IACb,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,KAAa;IACrD,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC;YAC/C,GAAG,IAAI,CAAC,iBAAiB,IAAI,CAAC,qBAAqB,CAAC,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC;SAClG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO;YACL,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC;YAC7C,GAAG,IAAI,CAAC,oBAAoB,IAAI,CAAC,qBAAqB,CAAC,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC;SACrG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAW;IAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC3C,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO;QAAE,OAAO,gCAAgC,CAAC;IACvE,IAAI,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,wBAAwB,CAAC;IAClD,OAAO,wCAAwC,CAAC;AAClD,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,KAAa,EAAE,UAAU,GAAG,CAAC,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC/F,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,KAAa;IACxC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/tui/run-app.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The dedicated run view: renders one workflow instance running, live.
+ *
+ * `runInstanceInTui` is the reusable core — given an existing engine/runner
+ * and a TUI to render into, it drives one instance to completion/cancellation
+ * or until the user detaches, translating keystrokes into engine actions
+ * (approve / revise / resume / cancel / steer). The runner drives the
+ * workflow autonomously; this file just shows it and steers it. No LLM sits
+ * in the loop.
+ *
+ * Two callers:
+ *  - `runApp(cwd)`: the standalone CLI path (own process, own TUI, own
+ *    launcher to pick a workflow). Kept for direct invocation; no longer the
+ *    default `ralphflow` entry point (see cli.ts) — that's now the chat.
+ *  - `attachRunView` (tui/embed.ts): the chat session hands this its OWN
+ *    already-running TUI/engine/runner via `ctx.ui.custom()`, so starting a
+ *    workflow from chat takes over the SAME terminal instead of a second one.
+ */
+import type { Engine } from "../engine/core.js";
+import { type Runner } from "../engine/runner.js";
+import { TUI } from "../pi/tui.js";
+export declare function runApp(cwd: string): Promise<void>;
+export interface RunInstanceOutcome {
+    /**
+     * "completed"/"cancelled" mirror the instance's terminal fate. "detached"
+     * means the user left the run view (Esc on an empty input) while the
+     * workflow was still gate/paused/stalled/running — the runner keeps
+     * driving it untouched; nothing here pauses or aborts anything on detach.
+     */
+    outcome: "completed" | "cancelled" | "detached";
+    reportPath?: string;
+}
+/**
+ * Drive one instance to its end (or the user detaching), rendering it live
+ * into `tui`. Does not own `engine`/`runner`/`sessionId`/`tui` — the caller
+ * decides their lifetime, which is what lets this run against either a
+ * process's own dedicated TUI (`runApp`) or a chat session's TUI borrowed via
+ * `ctx.ui.custom()` (`attachRunView`).
+ */
+export declare function runInstanceInTui(opts: {
+    engine: Engine;
+    tui: TUI;
+    sessionId: string;
+    instId: string;
+    runner: Runner;
+}): Promise<RunInstanceOutcome>;
+/** Fold an attachNote'd note into whatever failure reason a resume already carries. */
+export declare function combineReason(prevReason: string | undefined, note: string | undefined): string | undefined;
+//# sourceMappingURL=run-app.d.ts.map

package/dist/tui/run-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-app.d.ts","sourceRoot":"","sources":["../../src/tui/run-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAgB,KAAK,MAAM,EAAqB,MAAM,qBAAqB,CAAC;AAUnF,OAAO,EAAE,GAAG,EAA8B,MAAM,cAAc,CAAC;AAsB/D,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCvD;AAqCD,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqF9B;AAqBD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG1G"}

package/dist/tui/run-app.js

@@ -0,0 +1,317 @@
+/**
+ * The dedicated run view: renders one workflow instance running, live.
+ *
+ * `runInstanceInTui` is the reusable core — given an existing engine/runner
+ * and a TUI to render into, it drives one instance to completion/cancellation
+ * or until the user detaches, translating keystrokes into engine actions
+ * (approve / revise / resume / cancel / steer). The runner drives the
+ * workflow autonomously; this file just shows it and steers it. No LLM sits
+ * in the loop.
+ *
+ * Two callers:
+ *  - `runApp(cwd)`: the standalone CLI path (own process, own TUI, own
+ *    launcher to pick a workflow). Kept for direct invocation; no longer the
+ *    default `ralphflow` entry point (see cli.ts) — that's now the chat.
+ *  - `attachRunView` (tui/embed.ts): the chat session hands this its OWN
+ *    already-running TUI/engine/runner via `ctx.ui.custom()`, so starting a
+ *    workflow from chat takes over the SAME terminal instead of a second one.
+ */
+import fs from "fs";
+import { createEngine } from "../engine/core.js";
+import { abortActiveCheck } from "../engine/check.js";
+import { createRunner } from "../engine/runner.js";
+import { withInstanceLock, isInstanceGone } from "../engine/lock.js";
+import { loadSkillIndex } from "../engine/skills.js";
+import { isSubWorkflowStep } from "../engine/types.js";
+import { applyCancelled, applyCompleted, applyGate, applyPaused, applyStalled, applyStepEvent, applyStepStart, applyUserMessage, applyVerdict, initRunModel, primeForAttach, } from "./run-model.js";
+import { runLauncher } from "./launcher.js";
+import { createRunView } from "./run-view.js";
+import { TUI, ProcessTerminal, initTheme } from "../pi/tui.js";
+/** A stable owner token for this process's run. */
+function makeSessionId() {
+    return `ralphflow-run-${process.pid}-${Date.now().toString(36)}`;
+}
+/**
+ * Terminal bell (BEL, \x07) on every state a human might need to come back
+ * for: gate, paused, stalled, completed. Cheapest possible "come look" signal
+ * that works identically whether the run view is the whole process (runApp)
+ * or a chat session's borrowed terminal (attachRunView) — most terminals/
+ * terminal multiplexers turn this into a visible tab/window flash or an
+ * audible ding even when the pane isn't focused, which a rendered line never
+ * achieves on its own. No config flag: this fires at most once per state
+ * transition (called from the same event handler that already renders once),
+ * never in a loop, so there is no plausible "too noisy" failure mode to gate.
+ */
+function bell() {
+    try {
+        process.stdout.write("\x07");
+    }
+    catch { }
+}
+export async function runApp(cwd) {
+    initTheme();
+    const engine = createEngine(cwd, { abortActiveCheck });
+    engine.ensureProjectWorkflows();
+    const sessionId = makeSessionId();
+    const tui = new TUI(new ProcessTerminal());
+    tui.start();
+    const runner = createRunner(engine, {}, {
+        skillPaths: () => loadSkillIndex(engine.getRalphFlowDir(), engine.getGlobalConfigHome()).paths,
+    });
+    engine.setAbortActiveStep?.(runner.abortActiveStep);
+    // Park interrupted instances on the way out so a restart resumes cleanly.
+    let shuttingDown = false;
+    const shutdown = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        try {
+            runner.pauseAllForShutdown();
+        }
+        catch { }
+        try {
+            tui.stop();
+        }
+        catch { }
+    };
+    process.on("SIGINT", () => { shutdown(); process.exit(0); });
+    process.on("SIGTERM", () => { shutdown(); process.exit(0); });
+    try {
+        const choice = await runLauncher(tui, engine);
+        if (choice.kind === "quit")
+            return;
+        const instId = choice.kind === "resume"
+            ? choice.instanceId
+            : createInstance(engine, choice.workflow, choice.task, sessionId);
+        if (!instId)
+            return; // creation failed (surfaced by createInstance)
+        await runInstanceInTui({ engine, tui, sessionId, instId, runner });
+    }
+    finally {
+        shutdown();
+    }
+}
+/**
+ * Create a fresh instance owned by this session and cache its first DO prompt.
+ * Mirrors ralphflow_start's creation path (normal or sub-workflow first step),
+ * minus the chat-surface text and auto-run — the run app drives it itself.
+ */
+function createInstance(engine, workflow, task, sessionId) {
+    const wf = engine.loadWorkflow(workflow);
+    if (!wf || wf.steps.length === 0)
+        return null;
+    const firstStep = wf.steps[0];
+    const instId = engine.generateInstanceId(workflow);
+    fs.mkdirSync(engine.getInstanceDir(instId), { recursive: true });
+    engine.writeArtifactsDirName(instId, task);
+    const baseState = {
+        active: true, workflow_name: workflow, current_step: firstStep.id, current_phase: "do",
+        fail_count: 0, user_task: task, paused: false, session_id: sessionId,
+    };
+    engine.writeState(baseState, instId);
+    engine.recordStepStart(instId, firstStep.id, "do");
+    engine.logEvent(instId, "info", "workflow_start", { workflow, instance: instId });
+    if (isSubWorkflowStep(firstStep)) {
+        engine.pushState(baseState, instId);
+        const sub = engine.resolveSubWorkflowEntry(instId, firstStep.workflow, task, firstStep);
+        if (sub.error) {
+            try {
+                fs.rmSync(engine.getInstanceDir(instId), { recursive: true, force: true });
+            }
+            catch { }
+            return null;
+        }
+    }
+    else {
+        if (wf.manual_step.includes(firstStep.id))
+            engine.writeManualStepMarker(instId);
+        engine.buildDoPrompt(instId, firstStep, task);
+    }
+    return instId;
+}
+/**
+ * Drive one instance to its end (or the user detaching), rendering it live
+ * into `tui`. Does not own `engine`/`runner`/`sessionId`/`tui` — the caller
+ * decides their lifetime, which is what lets this run against either a
+ * process's own dedicated TUI (`runApp`) or a chat session's TUI borrowed via
+ * `ctx.ui.custom()` (`attachRunView`).
+ */
+export function runInstanceInTui(opts) {
+    const { engine, tui, sessionId, instId, runner } = opts;
+    return new Promise((resolve) => {
+        const workflow = engine.loadWorkflow(engine.readState(instId).workflow_name);
+        const model = buildInitialModel(engine, instId, workflow);
+        // Reassigned to view.requestRender once the view exists (it also syncs the
+        // persistent input's mount/focus state — see run-view.ts).
+        let render = () => tui.requestRender();
+        /** Text left at a paused/stalled state via attachNote, consumed on resume. */
+        const pendingResumeNotes = new Map();
+        let removeInputListener = null;
+        let removeRunnerListener = null;
+        // Everything else re-renders reactively off runner events, but elapsed
+        // time needs a clock tick even during a long silent stretch (the model
+        // reasoning with no tool calls at all) — otherwise the timer freezes and
+        // looks exactly like the stuck-vs-thinking ambiguity it exists to solve.
+        // Cheap to over-fire: renderStepStrip only shows elapsed while a phase is
+        // active, and pi-tui's differential renderer no-ops an unchanged frame.
+        const tickTimer = setInterval(() => { if (model.activePhase)
+            render(); }, 1000);
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            clearInterval(tickTimer);
+            removeInputListener?.();
+            removeRunnerListener?.();
+            resolve({
+                outcome: model.status === "completed" ? "completed" : model.status === "cancelled" ? "cancelled" : "detached",
+                reportPath: model.reportPath,
+            });
+        };
+        // Structured events → the pure model → a render request. No parsing, no LLM.
+        const events = {
+            onStepStart: (_i, sid, phase, attempt) => { applyStepStart(model, sid, phase, attempt); render(); },
+            onStepEvent: (_i, sid, phase, e) => { applyStepEvent(model, sid, phase, e); render(); },
+            onVerdict: (_i, sid, r) => { applyVerdict(model, sid, r); render(); },
+            onGate: (_i, sid) => { applyGate(model, sid); render(); bell(); },
+            onPaused: (_i, st) => { applyPaused(model, st); render(); bell(); },
+            onStalled: (_i, sid, a) => { applyStalled(model, sid, a); render(); bell(); },
+            onCompleted: (_i, rp) => { applyCompleted(model, rp); render(); bell(); },
+        };
+        removeRunnerListener = runner.addEventListener(events);
+        const view = createRunView({
+            tui,
+            getModel: () => model,
+            onQuit: finish,
+            actions: {
+                approveGate: () => { void continueInstance(engine, runner, sessionId, instId); },
+                reviseGate: (instruction) => runner.reviseGate(instId, instruction),
+                resume: () => {
+                    const note = pendingResumeNotes.get(instId);
+                    pendingResumeNotes.delete(instId);
+                    void continueInstance(engine, runner, sessionId, instId, note);
+                },
+                cancel: () => { void cancelInstance(engine, runner, instId).then(() => { applyCancelled(model); render(); finish(); }); },
+                sendMessage: (text) => {
+                    // Optimistic local echo — same style as the other actions here, no
+                    // need to round-trip through a RunnerEvents callback for this.
+                    const sid = model.activeStepId;
+                    if (sid && model.activePhase === "do") {
+                        applyUserMessage(model, sid, text);
+                        render();
+                    }
+                    runner.sendUserMessage(instId, text);
+                },
+                attachNote: (text) => {
+                    const note = text.trim();
+                    if (!note)
+                        return;
+                    pendingResumeNotes.set(instId, note);
+                    const sid = model.activeStepId;
+                    if (sid) {
+                        applyUserMessage(model, sid, note);
+                        render();
+                    }
+                },
+            },
+        });
+        render = view.requestRender;
+        // Put the view on screen and route keys to it.
+        tui.clear();
+        tui.addChild(view.screen);
+        render();
+        removeInputListener = tui.addInputListener((data) => (view.handleInput(data) ? { consume: true } : undefined));
+        // Kick off the run.
+        runner.ensureRunning(instId);
+    });
+}
+/** Build the initial model, reflecting a resumed instance's current position. */
+function buildInitialModel(engine, instId, workflow) {
+    const state = engine.readState(instId);
+    const model = initRunModel(instId, workflow, state.user_task);
+    // Reflect where the instance actually is — this view may be attaching to
+    // one that's already running (ralphflow_watch, or ralphflow_continue
+    // landing back in the view), not one it just launched itself. See
+    // primeForAttach's own doc comment for why this is safe to call
+    // unconditionally, including for a genuinely fresh start.
+    const passedStepIds = [...new Set(engine.loadStepRecords(instId).filter((r) => r.phase === "check" && r.status === "passed").map((r) => r.stepId))];
+    primeForAttach(model, state, passedStepIds);
+    if (state.paused) {
+        applyPaused(model, state); // overrides activePhase back to null; keeps activeStepId/done-steps from above
+    }
+    return model;
+}
+/** Fold an attachNote'd note into whatever failure reason a resume already carries. */
+export function combineReason(prevReason, note) {
+    if (!note)
+        return prevReason;
+    return prevReason ? `${prevReason}\n\n用户补充说明：\n${note}` : `用户补充说明：\n${note}`;
+}
+/** Approve a gate / resume a pause or stall — the ralphflow_continue branches, run-view side. */
+async function continueInstance(engine, runner, sessionId, instId, note) {
+    try {
+        await withInstanceLock(engine.getInstanceDir(instId), instId, () => {
+            const state = engine.readState(instId);
+            if (!state || !state.active)
+                return;
+            engine.bindInstance(instId, sessionId);
+            // check_error pause → reset to check, re-verify.
+            if (state.paused && state.pause_reason === "check_error" && state.current_phase === "check") {
+                engine.writeState({ ...state, paused: false, pause_reason: undefined }, instId);
+                return;
+            }
+            // manual gate → clearing it IS the approval.
+            if (engine.markerExists(".manual-gate", instId)) {
+                engine.clearManualStepMarker(instId);
+                engine.clearManualGate(instId);
+                return;
+            }
+            // other pause → reset fail count, re-issue the DO prompt for a fresh attempt.
+            if (state.paused) {
+                const prevReason = combineReason(state.last_failure_reason, note);
+                const prevFail = state.fail_count;
+                engine.clearReinjectCounter(instId);
+                engine.clearDoneReported(instId);
+                engine.writeState({ ...state, current_phase: "do", paused: false, pause_reason: undefined, fail_count: 0 }, instId);
+                const step = engine.getStep(engine.loadWorkflow(state.workflow_name), state.current_step);
+                if (step && !isSubWorkflowStep(step))
+                    engine.buildDoPrompt(instId, step, state.user_task, prevReason, prevFail);
+                return;
+            }
+            // stalled → the keep-alive budget ran out and the loop exited on its own
+            // WITHOUT pausing the state (runner.ts: "the workflow is fine, the model
+            // is just stuck"), so none of the branches above fire for it. Rearm the
+            // budget explicitly, and fold in a note the same way a real retry would.
+            if (state.current_phase === "do" && !runner.isRunning(instId)) {
+                engine.clearReinjectCounter(instId);
+                if (note) {
+                    const step = engine.getStep(engine.loadWorkflow(state.workflow_name), state.current_step);
+                    if (step && !isSubWorkflowStep(step)) {
+                        engine.clearDoPromptCache(instId);
+                        engine.buildDoPrompt(instId, step, state.user_task, note, state.fail_count || undefined);
+                    }
+                }
+            }
+        });
+    }
+    catch (e) {
+        if (!isInstanceGone(e))
+            throw e;
+    }
+    if (engine.instanceExists(instId))
+        runner.ensureRunning(instId);
+}
+async function cancelInstance(engine, runner, instId) {
+    try {
+        await withInstanceLock(engine.getInstanceDir(instId), instId, () => {
+            runner.abortActiveStep(instId);
+            engine.destroyInstance(instId, "cancelled");
+        });
+    }
+    catch (e) {
+        if (!isInstanceGone(e))
+            throw e;
+    }
+}
+//# sourceMappingURL=run-app.js.map