pipeline-worker 0.1.26 → 0.1.28

package/dist/ui/steps.d.ts

@@ -1,22 +1,84 @@
 /**
- * Friendly progress narration for `pipeline-worker run`: a bold, colored,
- * numbered headline per workflow step (with an icon and a "[n/TOTAL_STAGES]"
- * counter) and a dim technical detail line underneath — mirrors how Claude
- * Code narrates its own tool calls, so a non-technical user can follow along
- * without reading source.
+ * The workflow's one door to the terminal: module-level functions the
+ * workflow code calls by step id, backed by a RunTree (the data model) and a
+ * Renderer (LineRenderer for non-TTY/plain output, TreeRenderer for the live
+ * TTY dashboard). Workflow code never touches process.stdout itself — see
+ * CLAUDE.md's terminal-output discipline.
+ *
+ * The facade is safe to use without beginRun() (unit tests exercise workflow
+ * helpers directly): the first call lazily creates an empty tree with a
+ * LineRenderer, and unknown step ids materialize as top-level nodes instead
+ * of throwing — the UI must never kill the run.
  */
+import { type RunStatus, type StepSeed } from './runTree.js';
 import type { RiskLevel } from '../types.js';
 import type { AgentInvokeResult } from '../agent/types.js';
 /**
- * Keeps a spinner redraw to a single physical row. Without this, a line
- * longer than the terminal's column count auto-wraps, and the `\r\x1b[K`
- * redraw in runStep() below only rewinds/clears the row the cursor is on —
- * not the wrapped continuation from the previous frame — so each tick
- * appends a new line instead of animating in place.
+ * Keeps a spinner/tree redraw to a single physical row. Without this, a line
+ * longer than the terminal's column count auto-wraps, and cursor-based
+ * erasing only rewinds the rows it knows about — not the wrapped
+ * continuation — so each frame appends garbage instead of animating in place.
  */
 export declare function truncateToWidth(text: string, width: number): string;
-/** A one-off status line with no associated work to wait on (e.g. a final summary). */
-export declare function step(icon: string, title: string, detail?: string): void;
+/**
+ * Pure selection logic, kept separate from createRenderer() so it's testable
+ * without touching the real process.stdout (flipping process.stdout.isTTY in
+ * a test would make a real TreeRenderer hide the cursor on the terminal
+ * actually running the test suite). The live tree dashboard needs a real
+ * terminal to redraw in place; CI logs, piped output, and
+ * PIPELINE_WORKER_PLAIN_OUTPUT (an explicit escape hatch — useful when filing
+ * a bug report, or any tool that greps run output) all fall back to the
+ * append-only LineRenderer instead.
+ */
+export declare function selectRendererMode(isTTY: boolean, plainOutputEnv: string | undefined): 'tree' | 'line';
+/** Starts a new run display. Replaces any previous run's tree (each CLI invocation begins at most one). */
+export declare function beginRun(skeleton: StepSeed[], header: {
+    title: string;
+    worktreeShortId?: string;
+}): void;
+/**
+ * Settles the run display into its terminal status. Idempotent: only the
+ * first call paints, so error paths can call endRun('failed') defensively
+ * without stomping an earlier, more specific verdict.
+ */
+export declare function endRun(status: Exclude<RunStatus, 'running'>, detail?: string): void;
+/** Adds a step that wasn't in the skeleton — the watch loop's fix/rebase attempts, conflict resolution, squash. */
+export declare function addDynamicStep(parentId: string | undefined, id: string, label: string, detail?: string): void;
+/** Marks a step running without tying it to a single task closure — for steps whose phases span several calls (see runPhase). */
+export declare function startStep(id: string, patch?: {
+    detail?: string;
+    attempt?: number;
+    maxAttempts?: number;
+}): void;
+export declare function finishStep(id: string, status?: 'done' | 'failed', patch?: {
+    detail?: string;
+}): void;
+export declare function updateStep(id: string, patch: {
+    detail?: string;
+    attempt?: number;
+    maxAttempts?: number;
+}): void;
+/** Announces a step that did not run this time, and why — a skipped stage stays visible instead of silently vanishing (which reads as a bug, not a choice). */
+export declare function skipStep(id: string, reason: string): void;
+/** Runs one step to completion: running → done, or running → failed + rethrow. */
+export declare function runStep<T>(id: string, detail: string, task: () => Promise<T>): Promise<T>;
+/**
+ * Runs one phase of an already-running step (a fix attempt's agent turn,
+ * local verify, push, ...), mutating the step's detail rather than creating
+ * grandchildren — the tree stays one row per attempt, as the dashboard
+ * renders it. Failure marks the whole step failed and rethrows; success
+ * leaves it running for the next phase (the caller finishes it).
+ */
+export declare function runPhase<T>(id: string, detail: string, task: () => Promise<T>): Promise<T>;
+/** Updates the header line: the run's display name (once intent names the branch) and the worktree short id. */
+export declare function setRunHeader(patch: {
+    title?: string;
+    worktreeShortId?: string;
+}): void;
+/** Folds a resumed run's persisted token total into the header figure, so the dashboard shows the whole run's spend, not just this process's share. */
+export declare function seedRunTokens(tokens: number): void;
+/** A bold one-off announcement outside any step (adopting a branch, pipeline failed, ...). */
+export declare function announce(text: string, detail?: string): void;
 /**
  * An indented supplementary detail line under the current step (e.g. an
  * agent's summary, a result). Input is freeform (agent output, forge data)
@@ -26,36 +88,31 @@ export declare function step(icon: string, title: string, detail?: string): void
 export declare function note(text: string): void;
 /** Like note(), but colors the text by risk level (green/yellow/red for low/medium/high). */
 export declare function noteRisk(risk: RiskLevel, reason: string): void;
-/**
- * Announces a numbered stage that did not run this time, and why, so the
- * printed sequence stays gap-free instead of a conditional stage silently
- * vanishing from between its neighbors (which reads as a bug, not a choice).
- */
-export declare function skipStep(stage: number | string, icon: string, title: string, reason: string): void;
 /**
  * Reports which agent CLI session handled a turn, how long it took, and the
  * worktree it ran in, so a user who wants to see how a conflict was resolved
  * or a CI failure was fixed can look it up afterwards (`claude --resume <id>`
  * or, for Copilot, `copilot --resume <id>` — see agent/copilot.ts on why that
  * id is one we assigned rather than one the CLI reported). Session history is
- * scoped to the working directory the CLI ran in (see agent/claude.ts:
- * `cwd: opts.cwd` is always the worktree, never the caller's own repo), so
- * `--resume` only finds the session when run from that same worktree path —
- * printing the path lets the user `cd` there first. This function has no way
- * to know which adapter produced `result` (`AgentInvokeResult` doesn't carry
- * one), so it names the path rather than assembling a `claude`/`copilot`
- * command that would guess wrong half the time. A no-op when the adapter
- * didn't return a sessionId, which keeps this safe to call unconditionally.
+ * scoped to the working directory the CLI ran in, so `--resume` only finds
+ * the session when run from that same worktree path — printing the path lets
+ * the user `cd` there first. A no-op when the adapter didn't return a
+ * sessionId, which keeps this safe to call unconditionally.
+ *
+ * Also attributes the turn's token spend (when the adapter reported any) to
+ * the step that ran it, which is what feeds the per-step and header token
+ * figures on the dashboard.
  */
 export declare function noteSession(result: AgentInvokeResult, worktreePath: string): void;
 /** Prints an agent's response (truncated) followed by its resumable session info — the shared tail of every conflict/CI-fix agent invocation. */
 export declare function reportAgentInvocation(result: AgentInvokeResult, worktreePath: string): void;
-/**
- * Runs one numbered workflow stage with a colored, iconed title, then a live
- * status line beneath it while `task` runs: a spinner plus a counting-up
- * elapsed timer in a TTY, settling into a green checkmark or red cross with
- * the total duration on completion. Falls back to a single static print when
- * stdout isn't a TTY (CI logs, redirected files) since carriage-return
- * spinners would just garble those.
- */
-export declare function runStep<T>(stage: number | string, icon: string, title: string, detail: string, task: () => Promise<T>): Promise<T>;
+/** Outputs a formatted section header with title and emoji. */
+export declare function sectionHeader(title: string, emoji: string): void;
+/** Outputs a formatted section with header, bullet points, and spacing. */
+export declare function outputSection(title: string, emoji: string, items: Array<{
+    label: string;
+    value: string;
+    wrap?: boolean;
+}>): void;
+/** Outputs a section footer (blank line for spacing). */
+export declare function sectionFooter(): void;

package/dist/ui/steps.js

@@ -1,36 +1,29 @@
 /**
- * Friendly progress narration for `pipeline-worker run`: a bold, colored,
- * numbered headline per workflow step (with an icon and a "[n/TOTAL_STAGES]"
- * counter) and a dim technical detail line underneath — mirrors how Claude
- * Code narrates its own tool calls, so a non-technical user can follow along
- * without reading source.
+ * The workflow's one door to the terminal: module-level functions the
+ * workflow code calls by step id, backed by a RunTree (the data model) and a
+ * Renderer (LineRenderer for non-TTY/plain output, TreeRenderer for the live
+ * TTY dashboard). Workflow code never touches process.stdout itself — see
+ * CLAUDE.md's terminal-output discipline.
+ *
+ * The facade is safe to use without beginRun() (unit tests exercise workflow
+ * helpers directly): the first call lazily creates an empty tree with a
+ * LineRenderer, and unknown step ids materialize as top-level nodes instead
+ * of throwing — the UI must never kill the run.
  */
 import { styleText } from 'node:util';
+import { RunTree } from './runTree.js';
+import { LineRenderer } from './renderer.js';
+import { TreeRenderer } from './treeRenderer.js';
+import { boxHeader, formatBulletBlock } from './format.js';
 const RISK_COLOR = { low: 'green', medium: 'yellow', high: 'red' };
+let active;
+/** The most recently started step — where noteSession attributes an agent turn's tokens. */
+let lastStepId;
 /**
- * The workflow always runs stages 1-13 in order. Some stages are opt-in or
- * conditional on runtime state and are announced via skipStep() with a
- * reason instead of running when their condition isn't met (stage 8:
- * config.updateChangelog; stage 11: reused when an MR/PR already exists;
- * stage 13: config.cleanupOnSuccess) — so the numbering stays sequential and
- * a skipped stage is still visible instead of silently vanishing.
- *
- * Stage 12 (watching the pipeline, and fixing/escalating on failure) loops
- * and branches internally, so its sub-steps are numbered 12.1-12.7 (see
- * watchPipeline.ts) rather than each claiming the bare "12".
- */
-const TOTAL_STAGES = 13;
-const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-const SPINNER_INTERVAL_MS = 80;
-function formatElapsed(ms) {
-    return `${(ms / 1000).toFixed(1)}s`;
-}
-/**
- * Keeps a spinner redraw to a single physical row. Without this, a line
- * longer than the terminal's column count auto-wraps, and the `\r\x1b[K`
- * redraw in runStep() below only rewinds/clears the row the cursor is on —
- * not the wrapped continuation from the previous frame — so each tick
- * appends a new line instead of animating in place.
+ * Keeps a spinner/tree redraw to a single physical row. Without this, a line
+ * longer than the terminal's column count auto-wraps, and cursor-based
+ * erasing only rewinds the rows it knows about — not the wrapped
+ * continuation — so each frame appends garbage instead of animating in place.
  */
 export function truncateToWidth(text, width) {
     if (width <= 0 || text.length <= width)
@@ -39,16 +32,133 @@ export function truncateToWidth(text, width) {
         return text.slice(0, 1);
     return `${text.slice(0, width - 1)}…`;
 }
-/** stage accepts a decimal string (e.g. "12.3") for a sub-step of a numbered stage — see TOTAL_STAGES. */
-function stageHeader(stage, icon, title) {
-    return styleText(['bold', 'cyan'], `[${stage}/${TOTAL_STAGES}] ${icon} ${title}`);
+/**
+ * Pure selection logic, kept separate from createRenderer() so it's testable
+ * without touching the real process.stdout (flipping process.stdout.isTTY in
+ * a test would make a real TreeRenderer hide the cursor on the terminal
+ * actually running the test suite). The live tree dashboard needs a real
+ * terminal to redraw in place; CI logs, piped output, and
+ * PIPELINE_WORKER_PLAIN_OUTPUT (an explicit escape hatch — useful when filing
+ * a bug report, or any tool that greps run output) all fall back to the
+ * append-only LineRenderer instead.
+ */
+export function selectRendererMode(isTTY, plainOutputEnv) {
+    const plain = ['true', '1'].includes((plainOutputEnv ?? '').toLowerCase());
+    return isTTY && !plain ? 'tree' : 'line';
+}
+function createRenderer() {
+    const mode = selectRendererMode(process.stdout.isTTY === true, process.env.PIPELINE_WORKER_PLAIN_OUTPUT);
+    return mode === 'tree' ? new TreeRenderer() : new LineRenderer();
+}
+/**
+ * Constructs a tree wired to a fresh renderer, then fires one synthetic
+ * event so the renderer attaches and paints the initial (all-pending)
+ * frame immediately — the skeleton's nodes are inserted directly in the
+ * RunTree constructor, with no 'add' events of their own, so without this a
+ * TreeRenderer would stay unattached (and crash on the first freeform log()
+ * call) until the first real mutation.
+ */
+function createActiveRun(skeleton, header) {
+    const renderer = createRenderer();
+    const tree = new RunTree(skeleton, header, (event) => renderer.onEvent(event, tree));
+    renderer.onEvent({ kind: 'header' }, tree);
+    return { tree, renderer, ended: false };
+}
+function ensureActive() {
+    active ??= createActiveRun([], { title: 'run' });
+    return active;
+}
+/** Starts a new run display. Replaces any previous run's tree (each CLI invocation begins at most one). */
+export function beginRun(skeleton, header) {
+    active = createActiveRun(skeleton, header);
+    lastStepId = undefined;
+}
+/**
+ * Settles the run display into its terminal status. Idempotent: only the
+ * first call paints, so error paths can call endRun('failed') defensively
+ * without stomping an earlier, more specific verdict.
+ */
+export function endRun(status, detail) {
+    const run = ensureActive();
+    if (run.ended)
+        return;
+    run.ended = true;
+    run.tree.setHeader({ status });
+    run.renderer.stop(status, detail, run.tree);
+}
+/** Adds a step that wasn't in the skeleton — the watch loop's fix/rebase attempts, conflict resolution, squash. */
+export function addDynamicStep(parentId, id, label, detail = '') {
+    ensureActive().tree.add(parentId, { id, label, detail });
+}
+/** Marks a step running without tying it to a single task closure — for steps whose phases span several calls (see runPhase). */
+export function startStep(id, patch = {}) {
+    lastStepId = id;
+    ensureActive().tree.start(id, patch);
+}
+export function finishStep(id, status = 'done', patch = {}) {
+    ensureActive().tree.finish(id, status, patch);
+}
+export function updateStep(id, patch) {
+    ensureActive().tree.update(id, patch);
+}
+/** Announces a step that did not run this time, and why — a skipped stage stays visible instead of silently vanishing (which reads as a bug, not a choice). */
+export function skipStep(id, reason) {
+    ensureActive().tree.finish(id, 'skipped', { detail: reason });
+}
+/** Runs one step to completion: running → done, or running → failed + rethrow. */
+export async function runStep(id, detail, task) {
+    const run = ensureActive();
+    lastStepId = id;
+    run.tree.start(id, { detail });
+    try {
+        const result = await task();
+        run.tree.finish(id, 'done');
+        return result;
+    }
+    catch (error) {
+        run.tree.finish(id, 'failed');
+        throw error;
+    }
+}
+/**
+ * Runs one phase of an already-running step (a fix attempt's agent turn,
+ * local verify, push, ...), mutating the step's detail rather than creating
+ * grandchildren — the tree stays one row per attempt, as the dashboard
+ * renders it. Failure marks the whole step failed and rethrows; success
+ * leaves it running for the next phase (the caller finishes it).
+ */
+export async function runPhase(id, detail, task) {
+    const run = ensureActive();
+    const node = run.tree.get(id);
+    if (!node || node.status !== 'running') {
+        startStep(id, { detail });
+    }
+    else {
+        run.tree.update(id, { detail });
+    }
+    try {
+        return await task();
+    }
+    catch (error) {
+        run.tree.finish(id, 'failed');
+        throw error;
+    }
+}
+/** Updates the header line: the run's display name (once intent names the branch) and the worktree short id. */
+export function setRunHeader(patch) {
+    ensureActive().tree.setHeader(patch);
+}
+/** Folds a resumed run's persisted token total into the header figure, so the dashboard shows the whole run's spend, not just this process's share. */
+export function seedRunTokens(tokens) {
+    ensureActive().tree.seedTokens(tokens);
 }
-/** A one-off status line with no associated work to wait on (e.g. a final summary). */
-export function step(icon, title, detail) {
-    console.log(); // blank line for clear separation between stages
-    console.log(styleText('bold', `${icon} ${title}`));
+/** A bold one-off announcement outside any step (adopting a branch, pipeline failed, ...). */
+export function announce(text, detail) {
+    const run = ensureActive();
+    run.renderer.log('');
+    run.renderer.log(styleText('bold', text));
     if (detail)
-        console.log(styleText('dim', `  ${detail}`));
+        run.renderer.log(styleText('dim', `  ${detail}`));
 }
 /**
  * An indented supplementary detail line under the current step (e.g. an
@@ -57,21 +167,11 @@ export function step(icon, title, detail) {
  * otherwise a multi-line value would break out of the "one dim line" format.
  */
 export function note(text) {
-    console.log(styleText('dim', `  ${text.replace(/\s*\n\s*/g, ' ')}`));
+    ensureActive().renderer.log(styleText('dim', `  ${text.replace(/\s*\n\s*/g, ' ')}`));
 }
 /** Like note(), but colors the text by risk level (green/yellow/red for low/medium/high). */
 export function noteRisk(risk, reason) {
-    console.log(styleText('dim', '  ') + styleText(RISK_COLOR[risk], `risk: ${risk} — ${reason.replace(/\s*\n\s*/g, ' ')}`));
-}
-/**
- * Announces a numbered stage that did not run this time, and why, so the
- * printed sequence stays gap-free instead of a conditional stage silently
- * vanishing from between its neighbors (which reads as a bug, not a choice).
- */
-export function skipStep(stage, icon, title, reason) {
-    console.log();
-    console.log(styleText('dim', `[${stage}/${TOTAL_STAGES}] ${icon} ${title} (skipped)`));
-    console.log(styleText('dim', `  ${reason.replace(/\s*\n\s*/g, ' ')}`));
+    ensureActive().renderer.log(styleText('dim', '  ') + styleText(RISK_COLOR[risk], `risk: ${risk} — ${reason.replace(/\s*\n\s*/g, ' ')}`));
 }
 /**
  * Reports which agent CLI session handled a turn, how long it took, and the
@@ -79,16 +179,19 @@ export function skipStep(stage, icon, title, reason) {
  * or a CI failure was fixed can look it up afterwards (`claude --resume <id>`
  * or, for Copilot, `copilot --resume <id>` — see agent/copilot.ts on why that
  * id is one we assigned rather than one the CLI reported). Session history is
- * scoped to the working directory the CLI ran in (see agent/claude.ts:
- * `cwd: opts.cwd` is always the worktree, never the caller's own repo), so
- * `--resume` only finds the session when run from that same worktree path —
- * printing the path lets the user `cd` there first. This function has no way
- * to know which adapter produced `result` (`AgentInvokeResult` doesn't carry
- * one), so it names the path rather than assembling a `claude`/`copilot`
- * command that would guess wrong half the time. A no-op when the adapter
- * didn't return a sessionId, which keeps this safe to call unconditionally.
+ * scoped to the working directory the CLI ran in, so `--resume` only finds
+ * the session when run from that same worktree path — printing the path lets
+ * the user `cd` there first. A no-op when the adapter didn't return a
+ * sessionId, which keeps this safe to call unconditionally.
+ *
+ * Also attributes the turn's token spend (when the adapter reported any) to
+ * the step that ran it, which is what feeds the per-step and header token
+ * figures on the dashboard.
  */
 export function noteSession(result, worktreePath) {
+    if (result.usage?.totalTokens !== undefined && lastStepId !== undefined) {
+        ensureActive().tree.addTokens(lastStepId, result.usage.totalTokens);
+    }
     if (!result.sessionId)
         return;
     const duration = result.durationMs !== undefined ? ` — ${(result.durationMs / 1000).toFixed(1)}s` : '';
@@ -100,45 +203,26 @@ export function reportAgentInvocation(result, worktreePath) {
     note(`agent: ${text.slice(0, 300).trim()}${text.length > 300 ? '…' : ''}`);
     noteSession(result, worktreePath);
 }
-/**
- * Runs one numbered workflow stage with a colored, iconed title, then a live
- * status line beneath it while `task` runs: a spinner plus a counting-up
- * elapsed timer in a TTY, settling into a green checkmark or red cross with
- * the total duration on completion. Falls back to a single static print when
- * stdout isn't a TTY (CI logs, redirected files) since carriage-return
- * spinners would just garble those.
- */
-export async function runStep(stage, icon, title, detail, task) {
-    console.log(); // blank line for clear separation between stages
-    console.log(stageHeader(stage, icon, title));
-    if (!process.stdout.isTTY) {
-        console.log(styleText('dim', `  ${detail}`));
-        return task();
+/** Outputs a formatted section header with title and emoji. */
+export function sectionHeader(title, emoji) {
+    const run = ensureActive();
+    for (const line of boxHeader(title, emoji)) {
+        run.renderer.log(line);
     }
-    const start = Date.now();
-    let frame = 0;
-    const render = (glyph, color = 'dim') => {
-        const line = `  ${glyph} ${detail} (${formatElapsed(Date.now() - start)})`;
-        const width = process.stdout.columns ?? line.length;
-        process.stdout.write(`\r\x1b[K${styleText(color, truncateToWidth(line, width))}`);
-    };
-    render(SPINNER_FRAMES[0]);
-    const timer = setInterval(() => {
-        frame = (frame + 1) % SPINNER_FRAMES.length;
-        render(SPINNER_FRAMES[frame]);
-    }, SPINNER_INTERVAL_MS);
-    try {
-        const result = await task();
-        clearInterval(timer);
-        render('✓', 'green');
-        process.stdout.write('\n');
-        return result;
+}
+/** Outputs a formatted section with header, bullet points, and spacing. */
+export function outputSection(title, emoji, items) {
+    const run = ensureActive();
+    for (const line of boxHeader(title, emoji)) {
+        run.renderer.log(line);
     }
-    catch (error) {
-        clearInterval(timer);
-        render('✗', 'red');
-        process.stdout.write('\n');
-        throw error;
+    for (const line of formatBulletBlock(items)) {
+        run.renderer.log(line);
     }
+    run.renderer.log('');
+}
+/** Outputs a section footer (blank line for spacing). */
+export function sectionFooter() {
+    ensureActive().renderer.log('');
 }
 //# sourceMappingURL=steps.js.map

package/dist/ui/steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/ui/steps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/ui/steps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAiC,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAI3D,MAAM,UAAU,GAAkD,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAQlH,IAAI,MAA6B,CAAC;AAClC,4FAA4F;AAC5F,IAAI,UAA8B,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,cAAkC;IACnF,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3E,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACzG,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,QAAoB,EAAE,MAAmD;IAChG,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,QAAQ,CAAC,QAAoB,EAAE,MAAmD;IAChG,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,MAAqC,EAAE,MAAe;IAC3E,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO;IACtB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;IACjB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,cAAc,CAAC,QAA4B,EAAE,EAAU,EAAE,KAAa,EAAE,MAAM,GAAG,EAAE;IACjG,YAAY,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,iIAAiI;AACjI,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,QAAqE,EAAE;IAC3G,UAAU,GAAG,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,SAA4B,MAAM,EAAE,QAA6B,EAAE;IACxG,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,KAAkE;IACvG,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,+JAA+J;AAC/J,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,MAAc;IACjD,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,EAAU,EAAE,MAAc,EAAE,IAAsB;IACjF,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,UAAU,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,EAAU,EAAE,MAAc,EAAE,IAAsB;IAClF,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACvC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,YAAY,CAAC,KAAmD;IAC9E,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,uJAAuJ;AACvJ,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,YAAY,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAe;IACpD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1C,IAAI,MAAM;QAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,MAAc;IACtD,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3I,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,EAAE,YAAoB;IACzE,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACxE,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,GAAG,QAAQ,SAAS,YAAY,qBAAqB,CAAC,CAAC;AAChG,CAAC;AAED,iJAAiJ;AACjJ,MAAM,UAAU,qBAAqB,CAAC,MAAyB,EAAE,YAAoB;IACnF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,KAAa,EACb,KAA8D;IAE9D,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa;IAC3B,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/ui/treeRenderer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The live TTY dashboard: a pinned bottom region holding the run header and
+ * the step tree, repainted in place, with freeform log lines (notes, agent
+ * output, stray console writes) scrolling into the terminal's scrollback
+ * ABOVE the region — the same strategy ora/listr2 use, hand-rolled to keep
+ * the dependency count at zero.
+ *
+ *   pipeline-worker · fix-login-redirect · worktree a91f · running · 9.4k tok
+ *   ├─ ✓ capture    staged + unstaged diff                                0.4s
+ *   ├─ ● ci-watch   pipeline #8123: fixing                 attempt 2/5 · 4.4k tok
+ *   └─ ○ merge      auto-merge + sync local main
+ *
+ * Invariants that keep the redraw exact:
+ * - Every painted line is pre-truncated to the terminal width, so no line
+ *   can wrap; `renderedLines` therefore always equals the physical rows the
+ *   region occupies, and one `ESC[{n}A CR ESC[J` erases exactly the region.
+ * - While attached, console.log/error are intercepted and routed through
+ *   log(), so nothing can print into the middle of the region (CLAUDE.md's
+ *   terminal-output discipline keeps direct process.stdout writers out of
+ *   the rest of the codebase).
+ * - The cursor is hidden on attach and restored on stop AND on process exit
+ *   (the 'exit' hook only does a sync write, which is allowed there), so a
+ *   ctrl-C mid-frame never leaves a cursorless terminal.
+ */
+import { type Renderer } from './renderer.js';
+import type { RunStatus, RunTree, TreeEvent, TreeRow } from './runTree.js';
+/** The slice of a TTY WriteStream the renderer needs — injectable so tests drive a fake with fixed geometry. */
+export interface OutStream {
+    write(text: string): void;
+    columns?: number;
+    rows?: number;
+    on?(event: 'resize', listener: () => void): void;
+    off?(event: 'resize', listener: () => void): void;
+}
+/** A collapsed run of finished rows, produced by fitToHeight when the tree outgrows the screen. */
+export interface ElisionRow {
+    summary: string;
+    depth: number;
+}
+export type DisplayRow = TreeRow | ElisionRow;
+/**
+ * Elides rows until header + rows fit in `maxRows`, keeping what the user
+ * actually watches: the running/failed/pending steps. Two passes, both
+ * deterministic (pure function, unit-tested directly):
+ *
+ * 1. collapse each parent's leading finished children (a long fix-attempt
+ *    history) into one `… ✓ N earlier attempts` row, keeping the last
+ *    finished child for context;
+ * 2. collapse leading fully-finished top-level steps into `… ✓ N earlier
+ *    steps`.
+ *
+ * If the tree still doesn't fit (tiny terminal), keep the tail — the newest
+ * rows are the live ones.
+ */
+export declare function fitToHeight(rows: TreeRow[], maxRows: number): DisplayRow[];
+export declare class TreeRenderer implements Renderer {
+    private readonly out;
+    private tree;
+    private renderedLines;
+    private frame;
+    private timer;
+    private stopped;
+    private readonly originalConsole;
+    private readonly onResize;
+    private readonly restoreCursorOnExit;
+    constructor(out?: OutStream);
+    private columns;
+    /**
+     * Repaints immediately on every tree mutation — a step finishing or a
+     * token count changing must show up right away, not on the next spinner
+     * tick. The interval timer (attach()) exists only to keep the spinner
+     * glyph and the running step's elapsed-time counter animating during long
+     * stretches with no tree events at all (a multi-minute CI poll).
+     */
+    onEvent(event: TreeEvent, tree: RunTree): void;
+    private attach;
+    private eraseRegion;
+    /** Freeform text: erase the region, let the text enter scrollback, repaint beneath it. */
+    log(text: string): void;
+    private headerLine;
+    private statusGlyph;
+    /** Right-hand figures: 'attempt 2/5 · 4.4k tok · 3.2s' — whichever are known. */
+    private figures;
+    private branchPrefix;
+    private rowLine;
+    private buildFrame;
+    private paint;
+    stop(status: RunStatus, detail: string | undefined, tree: RunTree): void;
+}