pipeline-worker 0.1.26 → 0.1.27

package/dist/ui/renderer.js

@@ -0,0 +1,93 @@
+/**
+ * Rendering strategies for the run tree (ui/runTree.ts). Two implementations:
+ *
+ * - LineRenderer (here): append-only scrolled lines — used when stdout is not
+ *   a TTY (CI logs, piped output) or when PIPELINE_WORKER_PLAIN_OUTPUT=true.
+ *   Zero cursor movement; colors are applied via node:util's styleText, which
+ *   already disables itself on non-color streams.
+ * - TreeRenderer (ui/treeRenderer.ts): the live TTY dashboard with a pinned
+ *   bottom region.
+ *
+ * Renderers receive fine-grained TreeEvents from the facade (ui/steps.ts) and
+ * may ignore the granularity (TreeRenderer just repaints). log() is the one
+ * channel for freeform text — notes, agent output, warnings — so a renderer
+ * that owns the screen can route it above its pinned region.
+ */
+import { styleText } from 'node:util';
+import { formatTokens } from './format.js';
+export function formatElapsed(ms) {
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/** The parenthesized tail of a finished step: '(3.2s · 1.9k tok)', or '' when neither figure is known. */
+export function formatStepFigures(node) {
+    const parts = [];
+    if (node.durationMs !== undefined)
+        parts.push(formatElapsed(node.durationMs));
+    if (node.tokens !== undefined)
+        parts.push(formatTokens(node.tokens));
+    return parts.length > 0 ? ` (${parts.join(' · ')})` : '';
+}
+/** 'attempt N/M' when both sides are known, else ''. */
+export function formatAttempt(node) {
+    return node.attempt !== undefined && node.maxAttempts !== undefined ? `attempt ${node.attempt}/${node.maxAttempts}` : '';
+}
+const FINISH_GLYPH = { done: '✓', failed: '✗', skipped: '–' };
+const FINISH_COLOR = { done: 'green', failed: 'red', skipped: 'dim' };
+const FINAL_LINE = {
+    done: '🎉 Done',
+    failed: '✗ Run failed',
+    escalated: '🚨 Stopped for human review',
+    interrupted: '⏹ Interrupted',
+};
+/**
+ * Append-only narration, one block per step: a bold start line with the
+ * detail beneath it, phase changes as indented arrows, and a colored
+ * ✓/✗/– settle line with duration and token figures. Mirrors the shape of
+ * the old numbered-stage output so non-TTY logs stay diffable and greppable.
+ */
+export class LineRenderer {
+    out;
+    // The default defers the console.log lookup to call time (not construction),
+    // so a test — or the TreeRenderer's console interception — that swaps
+    // console.log after this renderer exists still receives the output.
+    constructor(out = (line) => console.log(line)) {
+        this.out = out;
+    }
+    onEvent(event) {
+        if (event.kind === 'start') {
+            const attempt = formatAttempt(event.node);
+            this.out('');
+            this.out(styleText(['bold', 'cyan'], `▶ ${event.node.label}${attempt ? ` — ${attempt}` : ''}`));
+            if (event.node.detail)
+                this.out(styleText('dim', `  ${event.node.detail}`));
+            return;
+        }
+        if (event.kind === 'update' && event.node.status === 'running' && event.node.detail) {
+            this.out(styleText('dim', `  → ${event.node.detail}`));
+            return;
+        }
+        if (event.kind === 'finish') {
+            const status = event.node.status;
+            const glyph = FINISH_GLYPH[status] ?? '?';
+            const skipTail = status === 'skipped' ? ' (skipped)' : '';
+            const detail = event.node.detail ? ` — ${event.node.detail}` : '';
+            this.out(styleText(FINISH_COLOR[status] ?? 'dim', `${glyph} ${event.node.label}${skipTail}${detail}${formatStepFigures(event.node)}`));
+        }
+        // 'add', 'tokens', and 'header' need no line of their own: tokens show on
+        // the finish line, and header changes only matter to the live dashboard.
+    }
+    log(text) {
+        this.out(text);
+    }
+    stop(status, detail, tree) {
+        if (status === 'running')
+            return;
+        const total = tree.totalTokens();
+        const tokensPart = total > 0 ? ` (${formatTokens(total)})` : '';
+        this.out('');
+        this.out(styleText('bold', `${FINAL_LINE[status]}${tokensPart}`));
+        if (detail)
+            this.out(styleText('dim', `  ${detail}`));
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/ui/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/ui/renderer.ts"],"names":[],"mappings":"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"}

package/dist/ui/runTree.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The run's step tree: a pure in-memory data model of every workflow step,
+ * its status, timing, attempt counters, and best-effort token spend. This is
+ * what the renderers (ui/renderer.ts, ui/treeRenderer.ts) draw from — it
+ * contains no ANSI, no console access, and never throws: an unknown step id
+ * is auto-added as a top-level node rather than crashing the workflow (the
+ * UI must never kill a run — see CLAUDE.md's never-throw contracts).
+ *
+ * Step identity is a string id ('capture', 'ci-watch', 'ci-watch/fix-2').
+ * Ids replaced the old hard-coded stage numbers ([7/14]) because the watch
+ * loop grows children dynamically — fix attempts, rebases — and stable ids
+ * don't need renumbering when a step is inserted.
+ */
+export type StepStatus = 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+/** The whole run's terminal status, shown in the header line. */
+export type RunStatus = 'running' | 'done' | 'failed' | 'escalated' | 'interrupted';
+export interface StepNode {
+    /** Unique within the tree; children conventionally use 'parent/child' ids. */
+    id: string;
+    /** Short name in the left column: 'capture', 'ci-watch', 'fix 2'. */
+    label: string;
+    /** Right-hand description; mutable while the step runs (phase updates). */
+    detail: string;
+    status: StepStatus;
+    /** Epoch ms when the step entered 'running'. */
+    startedAt?: number;
+    /** Set when the step finishes ('done'/'failed'). */
+    durationMs?: number;
+    /** Best-effort agent tokens attributed to this step; absent means unknown, never zero. */
+    tokens?: number;
+    /** Rendered as 'attempt N/M' when both are present. */
+    attempt?: number;
+    maxAttempts?: number;
+    children: StepNode[];
+}
+/** What a skeleton declares per step up front — everything else starts pending/empty. */
+export interface StepSeed {
+    id: string;
+    label: string;
+    detail: string;
+}
+export interface RunHeader {
+    /** The run's name: initially generic, updated once intent names the branch. */
+    title: string;
+    /** Short worktree identifier (last hex chars of the temp-branch uuid). */
+    worktreeShortId?: string;
+    status: RunStatus;
+}
+export type TreeEvent = {
+    kind: 'add';
+    node: StepNode;
+} | {
+    kind: 'start';
+    node: StepNode;
+} | {
+    kind: 'finish';
+    node: StepNode;
+} | {
+    kind: 'update';
+    node: StepNode;
+} | {
+    kind: 'tokens';
+    node: StepNode;
+} | {
+    kind: 'header';
+};
+/** One renderable row of the flattened tree: the node, its depth, and whether it is the last sibling at each ancestor level (for branch glyphs). */
+export interface TreeRow {
+    node: StepNode;
+    depth: number;
+    /** isLast[d] — whether the chain through this row is the final sibling at depth d. Drives '├─' vs '└─' and '│' vs ' ' continuation. */
+    isLast: boolean[];
+}
+export declare class RunTree {
+    private readonly onChange;
+    readonly roots: StepNode[];
+    readonly header: RunHeader;
+    private readonly index;
+    /** Tokens spent before this tree existed (a resumed run's persisted total) — folded into totalTokens(). */
+    private seededTokens;
+    constructor(skeleton: StepSeed[], header: {
+        title: string;
+        worktreeShortId?: string;
+    }, onChange: (event: TreeEvent) => void);
+    private insert;
+    get(id: string): StepNode | undefined;
+    /**
+     * The never-throw guarantee: any operation on an id nobody declared falls
+     * back to materializing that id as a fresh top-level node, so the workflow
+     * keeps narrating instead of dying on a UI bookkeeping mismatch.
+     */
+    private getOrAdd;
+    /** Adds a child under parentId (or top-level when parentId is undefined). Adding an id that already exists is a no-op returning the existing node. */
+    add(parentId: string | undefined, seed: StepSeed, extras?: Partial<StepNode>): StepNode;
+    start(id: string, patch?: Partial<Pick<StepNode, 'detail' | 'attempt' | 'maxAttempts'>>): StepNode;
+    finish(id: string, status: 'done' | 'failed' | 'skipped', patch?: Partial<Pick<StepNode, 'detail'>>): StepNode;
+    update(id: string, patch: Partial<Pick<StepNode, 'detail' | 'attempt' | 'maxAttempts'>>): StepNode;
+    addTokens(id: string, tokens: number): void;
+    /** Registers tokens spent before this tree existed (a resumed run's persisted total). */
+    seedTokens(tokens: number): void;
+    setHeader(patch: Partial<RunHeader>): void;
+    /** The run's total spend: every node's tokens plus any seeded pre-resume total. */
+    totalTokens(): number;
+    /** Depth-first rows for rendering, with last-sibling flags per ancestor level for branch glyphs. */
+    flatten(): TreeRow[];
+}

package/dist/ui/runTree.js

@@ -0,0 +1,133 @@
+/**
+ * The run's step tree: a pure in-memory data model of every workflow step,
+ * its status, timing, attempt counters, and best-effort token spend. This is
+ * what the renderers (ui/renderer.ts, ui/treeRenderer.ts) draw from — it
+ * contains no ANSI, no console access, and never throws: an unknown step id
+ * is auto-added as a top-level node rather than crashing the workflow (the
+ * UI must never kill a run — see CLAUDE.md's never-throw contracts).
+ *
+ * Step identity is a string id ('capture', 'ci-watch', 'ci-watch/fix-2').
+ * Ids replaced the old hard-coded stage numbers ([7/14]) because the watch
+ * loop grows children dynamically — fix attempts, rebases — and stable ids
+ * don't need renumbering when a step is inserted.
+ */
+export class RunTree {
+    onChange;
+    roots = [];
+    header;
+    index = new Map();
+    /** Tokens spent before this tree existed (a resumed run's persisted total) — folded into totalTokens(). */
+    seededTokens = 0;
+    constructor(skeleton, header, onChange) {
+        this.onChange = onChange;
+        this.header = { ...header, status: 'running' };
+        for (const seed of skeleton)
+            this.insert(undefined, seed);
+    }
+    insert(parent, seed, extras = {}) {
+        const node = { ...seed, status: 'pending', children: [], ...extras };
+        (parent ? parent.children : this.roots).push(node);
+        this.index.set(node.id, node);
+        return node;
+    }
+    get(id) {
+        return this.index.get(id);
+    }
+    /**
+     * The never-throw guarantee: any operation on an id nobody declared falls
+     * back to materializing that id as a fresh top-level node, so the workflow
+     * keeps narrating instead of dying on a UI bookkeeping mismatch.
+     */
+    getOrAdd(id) {
+        const existing = this.index.get(id);
+        if (existing)
+            return existing;
+        const node = this.insert(undefined, { id, label: id, detail: '' });
+        this.onChange({ kind: 'add', node });
+        return node;
+    }
+    /** Adds a child under parentId (or top-level when parentId is undefined). Adding an id that already exists is a no-op returning the existing node. */
+    add(parentId, seed, extras = {}) {
+        const existing = this.index.get(seed.id);
+        if (existing)
+            return existing;
+        const parent = parentId === undefined ? undefined : this.getOrAdd(parentId);
+        const node = this.insert(parent, seed, extras);
+        this.onChange({ kind: 'add', node });
+        return node;
+    }
+    start(id, patch = {}) {
+        const node = this.getOrAdd(id);
+        node.status = 'running';
+        node.startedAt = Date.now();
+        node.durationMs = undefined;
+        if (patch.detail !== undefined)
+            node.detail = patch.detail;
+        if (patch.attempt !== undefined)
+            node.attempt = patch.attempt;
+        if (patch.maxAttempts !== undefined)
+            node.maxAttempts = patch.maxAttempts;
+        this.onChange({ kind: 'start', node });
+        return node;
+    }
+    finish(id, status, patch = {}) {
+        const node = this.getOrAdd(id);
+        node.status = status;
+        if (node.startedAt !== undefined && status !== 'skipped')
+            node.durationMs = Date.now() - node.startedAt;
+        if (patch.detail !== undefined)
+            node.detail = patch.detail;
+        this.onChange({ kind: 'finish', node });
+        return node;
+    }
+    update(id, patch) {
+        const node = this.getOrAdd(id);
+        if (patch.detail !== undefined)
+            node.detail = patch.detail;
+        if (patch.attempt !== undefined)
+            node.attempt = patch.attempt;
+        if (patch.maxAttempts !== undefined)
+            node.maxAttempts = patch.maxAttempts;
+        this.onChange({ kind: 'update', node });
+        return node;
+    }
+    addTokens(id, tokens) {
+        if (!Number.isFinite(tokens) || tokens <= 0)
+            return;
+        const node = this.getOrAdd(id);
+        node.tokens = (node.tokens ?? 0) + tokens;
+        this.onChange({ kind: 'tokens', node });
+    }
+    /** Registers tokens spent before this tree existed (a resumed run's persisted total). */
+    seedTokens(tokens) {
+        if (!Number.isFinite(tokens) || tokens <= 0)
+            return;
+        this.seededTokens += tokens;
+        this.onChange({ kind: 'header' });
+    }
+    setHeader(patch) {
+        Object.assign(this.header, patch);
+        this.onChange({ kind: 'header' });
+    }
+    /** The run's total spend: every node's tokens plus any seeded pre-resume total. */
+    totalTokens() {
+        let total = this.seededTokens;
+        for (const node of this.index.values())
+            total += node.tokens ?? 0;
+        return total;
+    }
+    /** Depth-first rows for rendering, with last-sibling flags per ancestor level for branch glyphs. */
+    flatten() {
+        const rows = [];
+        const walk = (nodes, depth, ancestors) => {
+            nodes.forEach((node, i) => {
+                const isLast = [...ancestors, i === nodes.length - 1];
+                rows.push({ node, depth, isLast });
+                walk(node.children, depth + 1, isLast);
+            });
+        };
+        walk(this.roots, 0, []);
+        return rows;
+    }
+}
+//# sourceMappingURL=runTree.js.map

package/dist/ui/runTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTree.js","sourceRoot":"","sources":["../../src/ui/runTree.ts"],"names":[],"mappings":"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"}

package/dist/ui/sessions.js

@@ -4,6 +4,7 @@
  * narration style ui/steps.ts uses for a live run.
  */
 import { styleText } from 'node:util';
+import { formatTokens } from './format.js';
 const PHASE_COLOR = {
     diff: 'dim',
     intent: 'dim',
@@ -25,12 +26,16 @@ function formatBranchColumn(branch) {
 function formatMrColumn(mrIid) {
     return mrIid !== undefined ? `#${mrIid}` : '-';
 }
+/** '-' when the run's adapter never reported usage (pi/copilot, or a pre-token-accounting state file) — absence means unknown, never zero. */
+function formatTokensColumn(totalTokens) {
+    return (totalTokens !== undefined ? formatTokens(totalTokens) : '-').padEnd(9);
+}
 function formatSessionRow(session) {
     const { state } = session;
     const branch = formatBranchColumn(state.branch);
     const mr = formatMrColumn(state.mrIid);
     const attempts = `${String(state.ciFixAttempt).padEnd(6)} ${String(state.conflictAttempt).padEnd(8)}`;
-    return `${branch} ${formatPhase(state.phase)} ${attempts} ${mr.padEnd(7)} ${formatTimestamp(state.updatedAt)}`;
+    return `${branch} ${formatPhase(state.phase)} ${attempts} ${mr.padEnd(7)} ${formatTokensColumn(state.totalTokens)} ${formatTimestamp(state.updatedAt)}`;
 }
 /** `pipeline-worker sessions` with no --branch: one line per persisted run, most recently updated first. */
 export function printSessionList(sessions) {
@@ -38,7 +43,7 @@ export function printSessionList(sessions) {
         console.log('pipeline-worker: no sessions found in this repo (.pipeline-worker/state/ is empty).');
         return;
     }
-    console.log(styleText('bold', `${'BRANCH'.padEnd(40)} ${'PHASE'.padEnd(9)} CI-FIX CONFLICT MR/PR   UPDATED`));
+    console.log(styleText('bold', `${'BRANCH'.padEnd(40)} ${'PHASE'.padEnd(9)} CI-FIX CONFLICT MR/PR   ${'TOKENS'.padEnd(9)} UPDATED`));
     for (const session of sessions) {
         console.log(formatSessionRow(session));
     }
@@ -54,7 +59,8 @@ function formatOptionalMetaParts(state) {
 }
 function formatHistoryEntry(entry) {
     const message = entry.level === 'error' ? styleText('red', entry.message) : entry.message;
-    return `  ${LEVEL_ICON[entry.level]} ${styleText('dim', formatTimestamp(entry.at))} ${styleText('dim', `[${entry.phase}]`)} ${message}`;
+    const tokensPart = entry.tokens !== undefined ? ` ${styleText('dim', `· ${formatTokens(entry.tokens)}`)}` : '';
+    return `  ${LEVEL_ICON[entry.level]} ${styleText('dim', formatTimestamp(entry.at))} ${styleText('dim', `[${entry.phase}]`)} ${message}${tokensPart}`;
 }
 /** `pipeline-worker sessions --branch <name>`: one run's metadata plus its full step-by-step history. */
 export function printSessionDetail(session) {
@@ -63,7 +69,8 @@ export function printSessionDetail(session) {
     console.log(styleText('bold', `Session: ${state.branch}`));
     console.log(styleText('dim', `  target: ${state.targetBranch}`));
     console.log(styleText('dim', `  worktree: ${state.worktreePath}`));
-    console.log(styleText('dim', `  phase: ${state.phase}  ci-fix: ${state.ciFixAttempt}  conflict: ${state.conflictAttempt}${mrPart}${pipelinePart}`));
+    const tokensPart = state.totalTokens !== undefined ? `  tokens: ${formatTokens(state.totalTokens)}` : '';
+    console.log(styleText('dim', `  phase: ${state.phase}  ci-fix: ${state.ciFixAttempt}  conflict: ${state.conflictAttempt}${mrPart}${pipelinePart}${tokensPart}`));
     console.log(styleText('dim', `  started: ${formatTimestamp(state.startedAt)}  updated: ${formatTimestamp(state.updatedAt)}`));
     const history = state.history ?? [];
     if (history.length === 0) {

package/dist/ui/sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/ui/sessions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/ui/sessions.ts"],"names":[],"mappings":"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"}

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,21 @@ 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>;