@entelligentsia/forgecli 1.0.20 → 1.0.21

package/dist/extensions/forgecli/tui/input-router.js

@@ -0,0 +1,136 @@
+// Centralised onTerminalInput dispatch for forge-cli.
+//
+// Plan 16 Slice 4c. Pi-mono's `ctx.ui.onTerminalInput` lets any extension hook
+// raw stdin, with the first consumer winning. Pi runs listeners BEFORE
+// routing to the focused overlay (pi-mono/packages/tui/src/tui.ts:544-560).
+// That made forge-cli's two existing arrow-activator listeners
+// (thread-switcher, whats-new-widget) silently eat ↑/↓ when the config TUI was
+// mounted as an overlay.
+//
+// This router gives forge-cli a single pi listener whose dispatch is
+// overlay-aware: listeners flagged `skipWhenOverlayActive: true` are bypassed
+// whenever an overlay has been registered via `pushOverlay()`. Other listeners
+// (critical hotkeys, theme switchers, etc.) still run.
+//
+// Wiring:
+//   1. index.ts session_start: `ctx.ui.onTerminalInput((d) => router.dispatch(d))`.
+//   2. Each consumer: `router.register(listener, { name, skipWhenOverlayActive })`.
+//   3. Each overlay mounter: `router.pushOverlay()` before ctx.ui.custom,
+//      `popOverlay()` in a finally.
+//
+// Debug logging (when FORGE_DEBUG_INPUT=1):
+//   Each dispatch + push/pop is logged with timestamp + listener name +
+//   overlay depth + raw byte sequence (hex-escaped). Default target:
+//   /tmp/forge-input-router.log. Override with FORGE_DEBUG_INPUT_LOG=<path>.
+//   Logging goes through fs.appendFileSync — synchronous so events are
+//   captured even when the process crashes mid-render.
+import * as fs from "node:fs";
+function debugEnabled() {
+    return process.env.FORGE_DEBUG_INPUT === "1";
+}
+function debugLogPath() {
+    return process.env.FORGE_DEBUG_INPUT_LOG ?? "/tmp/forge-input-router.log";
+}
+function hexEscape(s) {
+    // Render printable ASCII as-is, escape everything else as \xNN. Helps spot
+    // arrow sequences (\x1b[A etc.) and Kitty-protocol variants at a glance.
+    return [...s]
+        .map((c) => {
+        const cp = c.codePointAt(0);
+        if (cp >= 0x20 && cp <= 0x7e)
+            return c;
+        return `\\x${cp.toString(16).padStart(2, "0")}`;
+    })
+        .join("");
+}
+function logEvent(line) {
+    if (!debugEnabled())
+        return;
+    try {
+        const ts = new Date().toISOString();
+        fs.appendFileSync(debugLogPath(), `${ts} ${line}\n`);
+    }
+    catch {
+        // Logging must never crash the host; failure to write is silently ignored.
+    }
+}
+export class ForgeInputRouter {
+    listeners = [];
+    overlayDepth = 0;
+    register(listener, opts) {
+        const entry = { fn: listener, opts };
+        this.listeners.push(entry);
+        logEvent(`register name=${opts.name} skipWhenOverlayActive=${!!opts.skipWhenOverlayActive} total=${this.listeners.length}`);
+        return () => {
+            const i = this.listeners.indexOf(entry);
+            if (i >= 0) {
+                this.listeners.splice(i, 1);
+                logEvent(`unregister name=${opts.name} remaining=${this.listeners.length}`);
+            }
+        };
+    }
+    pushOverlay() {
+        this.overlayDepth++;
+        logEvent(`pushOverlay depth=${this.overlayDepth}`);
+    }
+    popOverlay() {
+        if (this.overlayDepth > 0)
+            this.overlayDepth--;
+        logEvent(`popOverlay depth=${this.overlayDepth}`);
+    }
+    isOverlayActive() {
+        return this.overlayDepth > 0;
+    }
+    /**
+     * Mirrors pi's listener-chain semantics (tui.ts:544-560):
+     * - Each listener may return { consume: true } to stop dispatch.
+     * - Each listener may return { data: rewritten } to alter the value the
+     *   next listener (and ultimately the focused overlay) sees.
+     * - Listeners flagged skipWhenOverlayActive=true are silently bypassed
+     *   whenever overlayDepth > 0.
+     */
+    dispatch(data) {
+        if (debugEnabled()) {
+            logEvent(`dispatch IN data="${hexEscape(data)}" overlayDepth=${this.overlayDepth} listeners=${this.listeners.length}`);
+        }
+        let current = data;
+        for (const entry of this.listeners) {
+            if (this.overlayDepth > 0 && entry.opts.skipWhenOverlayActive) {
+                logEvent(`  skip name=${entry.opts.name} (overlay active)`);
+                continue;
+            }
+            const result = entry.fn(current);
+            if (debugEnabled()) {
+                const r = result === undefined
+                    ? "passthrough"
+                    : `${result.consume ? "consume" : ""}${result.data !== undefined ? ` data="${hexEscape(result.data)}"` : ""}`.trim() ||
+                        "noop";
+                logEvent(`  call name=${entry.opts.name} → ${r}`);
+            }
+            if (result?.consume) {
+                logEvent(`dispatch OUT consumed-by=${entry.opts.name}`);
+                return { consume: true };
+            }
+            if (result?.data !== undefined)
+                current = result.data;
+        }
+        if (current !== data) {
+            logEvent(`dispatch OUT rewritten data="${hexEscape(current)}"`);
+            return { data: current };
+        }
+        logEvent(`dispatch OUT passthrough (focused overlay should receive)`);
+        return undefined;
+    }
+}
+// ── Module-level singleton ───────────────────────────────────────────────────
+let singleton = null;
+export function getInputRouter() {
+    if (!singleton)
+        singleton = new ForgeInputRouter();
+    return singleton;
+}
+/** Test helper — replace the singleton with a fresh router. */
+export function __resetInputRouterForTesting() {
+    singleton = null;
+}
+//# sourceMappingURL=input-router.js.map

package/dist/extensions/forgecli/tui/input-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-router.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/tui/input-router.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,+EAA+E;AAC/E,uEAAuE;AACvE,4EAA4E;AAC5E,+DAA+D;AAC/D,+EAA+E;AAC/E,yBAAyB;AACzB,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,UAAU;AACV,oFAAoF;AACpF,oFAAoF;AACpF,0EAA0E;AAC1E,oCAAoC;AACpC,EAAE;AACF,4CAA4C;AAC5C,wEAAwE;AACxE,qEAAqE;AACrE,6EAA6E;AAC7E,uEAAuE;AACvE,uDAAuD;AAEvD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAmB9B,SAAS,YAAY;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,6BAA6B,CAAC;AAC3E,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC3B,2EAA2E;IAC3E,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAC7B,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI;YAAE,OAAO,CAAC,CAAC;QACvC,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACjD,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC7B,IAAI,CAAC,YAAY,EAAE;QAAE,OAAO;IAC5B,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACR,2EAA2E;IAC5E,CAAC;AACF,CAAC;AAED,MAAM,OAAO,gBAAgB;IACpB,SAAS,GAAY,EAAE,CAAC;IACxB,YAAY,GAAG,CAAC,CAAC;IAEzB,QAAQ,CAAC,QAAwB,EAAE,IAAqB;QACvD,MAAM,KAAK,GAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,QAAQ,CACP,iBAAiB,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC,IAAI,CAAC,qBAAqB,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CACjH,CAAC;QACF,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC5B,QAAQ,CAAC,mBAAmB,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7E,CAAC;QACF,CAAC,CAAC;IACH,CAAC;IAED,WAAW;QACV,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,QAAQ,CAAC,qBAAqB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,UAAU;QACT,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/C,QAAQ,CAAC,oBAAoB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,eAAe;QACd,OAAO,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAY;QACpB,IAAI,YAAY,EAAE,EAAE,CAAC;YACpB,QAAQ,CACP,qBAAqB,SAAS,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,YAAY,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAC5G,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC/D,QAAQ,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,CAAC;gBAC5D,SAAS;YACV,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,YAAY,EAAE,EAAE,CAAC;gBACpB,MAAM,CAAC,GACN,MAAM,KAAK,SAAS;oBACnB,CAAC,CAAC,aAAa;oBACf,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;wBACnH,MAAM,CAAC;gBACV,QAAQ,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC1B,CAAC;YACD,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;gBAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,QAAQ,CAAC,gCAAgC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,QAAQ,CAAC,2DAA2D,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;IAClB,CAAC;CACD;AAED,gFAAgF;AAEhF,IAAI,SAAS,GAA4B,IAAI,CAAC;AAE9C,MAAM,UAAU,cAAc;IAC7B,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACnD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,4BAA4B;IAC3C,SAAS,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/extensions/forgecli/tui/orchestrator-status-bar.d.ts

@@ -0,0 +1,26 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { Component } from "@earendil-works/pi-tui";
+import type { OrchestratorTree } from "../orchestrator-tree.js";
+export declare class OrchestratorStatusBar implements Component {
+    private tree;
+    private theme;
+    private active;
+    private disposed;
+    private invalidationCb?;
+    private spinnerTimer?;
+    private spinnerIdx;
+    private onAction?;
+    private disposeFns;
+    constructor(tree: OrchestratorTree, theme: Theme);
+    setInvalidationCallback(cb: () => void): void;
+    setOnAction(cb: () => void): void;
+    setActive(active: boolean): void;
+    isActive(): boolean;
+    private ensureSpinnerTimer;
+    private stopSpinnerTimer;
+    render(width: number): string[];
+    invalidate(): void;
+    dispose(): void;
+    /** Walk depth-first to find the deepest running/cancelling leaf. */
+    private findDeepestRunningLeaf;
+}

package/dist/extensions/forgecli/tui/orchestrator-status-bar.js

@@ -0,0 +1,213 @@
+// orchestrator-status-bar.ts — One-line status bar for running orchestrations.
+//
+// Two render modes, distinguished by focus indicator:
+//
+//   INACTIVE (outline ○ prefix — navigation hint):
+//     ○ [CART-S03-T01 · writeback:1 ⠋] "preview…"  ↓ dashboard
+//
+//     ○ signals "you can ↓ here". Colour carries status: green=completed,
+//     red=failed, accent=running, muted=other terminal.
+//
+//   ACTIVE (filled ● prefix — focus confirmation):
+//     ● [CART-S03-T01 · writeback:1 ⠋] "preview…"  ⏎ open · esc back
+//
+//     ● signals "you're here". ↑/Esc returns focus to the prompt.
+//
+// Visual semantics (two dimensions on one circle):
+//   Shape:  ○ = not focused,  ● = focused
+//   Colour: accent=running, success=completed, error=failed, muted=terminal
+//   ⠋ spinner: shows activity (only for running/cancelling nodes)
+//
+// Focus lifecycle:  ↓ activates → ↑/Esc deactivates → prompt gets focus.
+// All activation/deactivation is handled by the ForgeInputRouter listener
+// in thread-switcher.ts (not by this widget's handleInput, which is dead
+// code for setWidget components since pi-tui routes input to the prompt
+// editor before setWidget components).
+//
+// Iron Laws conformance:
+//   IL1 — All visible strings route through theme.fg()/bg()/bold(). No raw glyphs.
+//   IL7 — Spinner timer guarded by disposed flag to prevent stale callbacks.
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { fmtTokenMeter } from "../viewport/renderer.js";
+// ── Braille spinner ────────────────────────────────────────────────────────
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const SPINNER_INTERVAL_MS = 100;
+// ── Focus indicator colour: derives the theme colour from the root's
+// aggregate status. The shape (○/●) carries focus; the colour carries
+// status. Both dimensions on the same circle glyph.
+//
+//   ○ green  = not focused, completed    ● green  = focused, completed
+//   ○ red    = not focused, failed       ● red    = focused, failed
+//   ○ dim    = not focused, terminal     ● dim    = focused, terminal
+//   ○ accent = not focused, running      ● accent = focused, running
+function focusIndicatorColour(roots, theme) {
+    // Derive the aggregate status from all visible roots.
+    // Running/cancelling wins over terminal; failed wins over completed.
+    const hasRunning = roots.some((r) => r.status === "running" || r.status === "cancelling");
+    if (hasRunning)
+        return "accent";
+    const hasFailed = roots.some((r) => r.status === "failed" || r.status === "escalated");
+    if (hasFailed)
+        return "error";
+    const hasCompleted = roots.some((r) => r.status === "completed");
+    if (hasCompleted)
+        return "success";
+    // Terminal but not failed/completed (cancelled, pending, etc.).
+    return "muted";
+}
+// ── OrchestratorStatusBar ──────────────────────────────────────────────────
+export class OrchestratorStatusBar {
+    tree;
+    theme;
+    active = false;
+    disposed = false; // IL7: guards interval callbacks after dispose
+    invalidationCb;
+    spinnerTimer;
+    spinnerIdx = 0;
+    onAction; // callback to open dashboard
+    disposeFns = [];
+    constructor(tree, theme) {
+        this.tree = tree;
+        this.theme = theme;
+        const onChange = () => {
+            if (!this.disposed) {
+                this.ensureSpinnerTimer(); // restart spinner if roots became active
+                this.invalidationCb?.();
+            }
+        };
+        this.tree.on("change", onChange);
+        this.tree.on("tree", onChange);
+        this.tree.on("tail", onChange);
+        this.tree.on("preview", onChange);
+        this.disposeFns.push(() => { this.tree.off("change", onChange); this.tree.off("tree", onChange); this.tree.off("tail", onChange); this.tree.off("preview", onChange); });
+    }
+    setInvalidationCallback(cb) {
+        this.invalidationCb = cb;
+        this.ensureSpinnerTimer();
+    }
+    setOnAction(cb) {
+        this.onAction = cb;
+    }
+    setActive(active) {
+        this.active = active;
+        if (!this.disposed) {
+            this.ensureSpinnerTimer(); // restart spinner if needed
+            this.invalidationCb?.();
+        }
+    }
+    isActive() {
+        return this.active;
+    }
+    ensureSpinnerTimer() {
+        if (this.spinnerTimer)
+            return;
+        // Only start the timer when there are running/cancelling roots to animate.
+        const anyActive = this.tree.getActiveRoots().some((r) => r.status === "running" || r.status === "cancelling");
+        if (!anyActive)
+            return; // no spinner needed yet
+        this.spinnerTimer = setInterval(() => {
+            // IL7: guard against firing after dispose.
+            if (this.disposed) {
+                this.stopSpinnerTimer();
+                return;
+            }
+            const anyActive = this.tree.getActiveRoots().some((r) => r.status === "running" || r.status === "cancelling");
+            if (!anyActive) {
+                // One last render to settle spinner, then stop.
+                this.invalidationCb?.();
+                this.stopSpinnerTimer();
+                return;
+            }
+            this.spinnerIdx = (this.spinnerIdx + 1) % SPINNER_FRAMES.length;
+            this.invalidationCb?.();
+        }, SPINNER_INTERVAL_MS);
+    }
+    stopSpinnerTimer() {
+        if (this.spinnerTimer) {
+            clearInterval(this.spinnerTimer);
+            this.spinnerTimer = undefined;
+        }
+    }
+    render(width) {
+        const roots = this.tree.getActiveRoots();
+        if (roots.length === 0)
+            return []; // Hidden when nothing is running.
+        const dim = (s) => this.theme.fg("dim", s);
+        const bold = (s) => this.theme.bold(this.theme.fg("accent", s));
+        // Build a segment for each active root.
+        const segments = [];
+        for (const root of roots) {
+            // Find the deepest running leaf or the root itself.
+            const leaf = this.findDeepestRunningLeaf(root.id);
+            const displayNode = leaf ?? root;
+            // Label: root label, with current phase as suffix if different.
+            let label = root.label;
+            if (leaf && leaf.id !== root.id) {
+                const shortRole = leaf.id.includes(":") ? leaf.id.split(":").slice(1).join(":") : leaf.label;
+                label = `${root.label} · ${shortRole}`;
+            }
+            // Usage footer (right-aligned within segment).
+            const usage = this.tree.getSubtreeUsage(root.id);
+            const meter = fmtTokenMeter(usage);
+            const meterPart = meter ? dim(` ${meter}`) : "";
+            // IL1: spinner (worm) shows activity — only for running/cancelling.
+            // Not shown for terminal states (completed, failed, etc.).
+            const spin = (displayNode.status === "running" || displayNode.status === "cancelling")
+                ? ` ${this.theme.fg("accent", SPINNER_FRAMES[this.spinnerIdx])}`
+                : "";
+            // Turn preview (truncated).
+            const preview = displayNode.lastTurnPreview
+                ? dim(` "${truncateToWidth(displayNode.lastTurnPreview, 60)}"`)
+                : "";
+            const segment = `${bold(`[${label}]`)}${spin}${preview}${meterPart}`;
+            segments.push(segment);
+        }
+        // Right-side hint depends on active state.
+        const hint = this.active
+            ? dim(" ⏎ open · esc back")
+            : dim(" ↓ dashboard");
+        // Focus indicator: ○/● coloured by aggregate status.
+        // Shape: ○ when inactive ("↓ here"), ● when active ("you're here").
+        // Colour: accent=running, success=completed, error=failed, muted=terminal.
+        const indicatorColour = focusIndicatorColour(roots, this.theme);
+        const indicatorGlyph = this.active ? "●" : "○";
+        const prefix = this.theme.fg(indicatorColour, indicatorGlyph) + " ";
+        const joined = segments.join(dim(" │ "));
+        const line = `${prefix}${joined}${hint}`;
+        return [truncateToWidth(line, width)];
+    }
+    invalidate() {
+        // Re-render driven by external invalidationCb → tui.requestRender().
+    }
+    // Note: handleInput is dead code for setWidget("belowEditor") components —
+    // pi-tui routes input to the prompt editor, not to belowEditor widgets.
+    // All key handling (↓ focus, ↑/Esc unfocus, Enter open dashboard) is in
+    // the ForgeInputRouter listener in thread-switcher.ts.
+    // Keeping the method for Component interface conformance; it does nothing.
+    dispose() {
+        this.disposed = true; // IL7: set before clearing timer so callback sees it
+        this.stopSpinnerTimer();
+        for (const fn of this.disposeFns)
+            fn();
+        this.disposeFns = [];
+    }
+    /** Walk depth-first to find the deepest running/cancelling leaf. */
+    findDeepestRunningLeaf(id) {
+        const node = this.tree.getNode(id);
+        if (!node)
+            return undefined;
+        if (node.kind === "leaf" && (node.status === "running" || node.status === "cancelling")) {
+            return node;
+        }
+        for (const childId of node.children) {
+            const found = this.findDeepestRunningLeaf(childId);
+            if (found)
+                return found;
+        }
+        // If no running leaf, return the root if it's running.
+        if (node.status === "running" || node.status === "cancelling")
+            return node;
+        return undefined;
+    }
+}
+//# sourceMappingURL=orchestrator-status-bar.js.map

package/dist/extensions/forgecli/tui/orchestrator-status-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-status-bar.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/tui/orchestrator-status-bar.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/tui/thread-switcher.d.ts

@@ -0,0 +1,18 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type OrchestratorTree } from "../orchestrator-tree.js";
+export interface OpenDashboardOptions {
+    /**
+     * Inject a detached tree (transcript replay). Defaults to the live
+     * singleton. Injected trees are NEVER memoized into the module-level
+     * treeRef — a replay must not pollute the live dashboard entry points.
+     */
+    tree?: OrchestratorTree;
+    /** Read-only mode: cancel (`x`) disabled; footer marks the replay. */
+    readOnly?: boolean;
+}
+/** Open the dashboard overlay. Shared by /forge:threads, /forge:dashboard,
+ *  the status bar Enter action, and transcript replay (injected tree).
+ *  Returns the overlay's lifetime promise so callers (replay re-entry loop)
+ *  can await close; existing fire-and-forget call sites ignore it. */
+export declare function openDashboardTui(ctx: ExtensionContext, opts?: OpenDashboardOptions): Promise<void>;
+export declare function registerThreadSwitcher(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/tui/thread-switcher.js

@@ -0,0 +1,194 @@
+// thread-switcher.ts — orchestrator status bar + dashboard overlay for forge.
+//
+// Two elements:
+//   1. OrchestratorStatusBar (belowEditor widget): a one-line summary of
+//      running orchestrations — label, current phase, status glyph, spinner,
+//      turn preview, token meter. Press ↓ to open the dashboard overlay.
+//      Hidden when no orchestration is running.
+//
+//   2. Dashboard overlay (/forge:dashboard command or ↓ from status bar):
+//      full-screen two-panel tree browser + detail view. See dashboard/.
+//
+// The chip strip and TailViewComponent have been retired — the dashboard
+// replaces them for all orchestration visualization. The main viewport
+// stays clean for user prompts and new tasks.
+import { getInputRouter } from "./input-router.js";
+import { matchesKey, Key } from "@earendil-works/pi-tui";
+import { getOrchestratorTree } from "../orchestrator-tree.js";
+import { DashboardComponent, DashboardController } from "../dashboard/component.js";
+import { OrchestratorStatusBar } from "./orchestrator-status-bar.js";
+import { getSessionRegistry, } from "../session-registry.js";
+import { fmtModelLabel, fmtTokenFooter } from "../viewport/renderer.js";
+import { paintFooterLine } from "../viewport/theme.js";
+const STATUS_BAR_WIDGET_KEY = "forge:orchestrator-status-bar";
+const FOOTER_WIDGET_KEY = "forge:viewport-footer";
+// ── Aggregate token footer ──────────────────────────────────────────────────
+// Mirrors the per-phase footer rendered inside TailView when a subagent chip
+// was focused. Now shown at the bottom of the main viewport whenever an
+// orchestration is active.
+class ViewportFooterComponent {
+    registry;
+    theme;
+    getOrchestratorModel;
+    invalidationCb;
+    constructor(registry, theme, getOrchestratorModel) {
+        this.registry = registry;
+        this.theme = theme;
+        this.getOrchestratorModel = getOrchestratorModel;
+        const onChange = () => this.invalidationCb?.();
+        registry.on("change", onChange);
+        registry.on("tail", onChange);
+        registry.on("turn", onChange);
+        this.dispose = () => {
+            registry.off("change", onChange);
+            registry.off("tail", onChange);
+            registry.off("turn", onChange);
+        };
+    }
+    render(width) {
+        const sessions = this.registry.listSessions();
+        const hasActive = sessions.some((s) => s.status === "running" || s.status === "cancelling");
+        if (!hasActive)
+            return [];
+        const tokens = fmtTokenFooter(this.registry.getAggregateUsage(), this.registry.getAggregateCompression());
+        const orchModel = fmtModelLabel(this.getOrchestratorModel?.());
+        if (!tokens && !orchModel)
+            return [];
+        const left = orchModel ? `⌂ ${orchModel}` : "";
+        const right = tokens ? `Σ ${tokens}` : "";
+        const text = left && right ? `${left}  ${right}` : left || right;
+        return [paintFooterLine(text, width, this.theme)];
+    }
+    invalidate() { }
+    setInvalidationCallback(cb) {
+        this.invalidationCb = cb;
+    }
+    dispose;
+}
+// ── Registration ─────────────────────────────────────────────────────────────
+function isDownArrow(data) {
+    return data === "\x1b[B" || data === "\x1bOB";
+}
+let statusBarRef;
+let statusBarTui;
+// Module-level tree reference so openDashboardTui can access the singleton
+// without being nested inside registerThreadSwitcher.
+let treeRef;
+/** Open the dashboard overlay. Shared by /forge:threads, /forge:dashboard,
+ *  the status bar Enter action, and transcript replay (injected tree).
+ *  Returns the overlay's lifetime promise so callers (replay re-entry loop)
+ *  can await close; existing fire-and-forget call sites ignore it. */
+export function openDashboardTui(ctx, opts = {}) {
+    const tree = opts.tree ?? treeRef ?? getOrchestratorTree();
+    if (!opts.tree && !treeRef)
+        treeRef = tree;
+    const controller = new DashboardController(tree, undefined, { readOnly: opts.readOnly ?? false });
+    const router = getInputRouter();
+    router.pushOverlay();
+    return ctx.ui
+        .custom((tui, theme, _kb, done) => {
+        const component = new DashboardComponent(controller, tui, theme, done);
+        return component;
+    }, {
+        overlay: true,
+        overlayOptions: {
+            width: "100%",
+            anchor: "center",
+            margin: 0,
+        },
+    })
+        .then(() => undefined)
+        .finally(() => {
+        router.popOverlay();
+    });
+}
+export function registerThreadSwitcher(pi) {
+    const registry = getSessionRegistry();
+    const tree = getOrchestratorTree();
+    treeRef = tree;
+    let mounted = false;
+    let currentCtx;
+    function mount(ctx) {
+        currentCtx = ctx;
+        if (mounted)
+            return;
+        // ── Orchestrator status bar (belowEditor) ────────────────────────
+        ctx.ui.setWidget(STATUS_BAR_WIDGET_KEY, (tui, theme) => {
+            statusBarTui = tui;
+            const bar = new OrchestratorStatusBar(tree, theme);
+            bar.setInvalidationCallback(() => tui.requestRender());
+            bar.setOnAction(() => {
+                // Enter on focused status bar → open dashboard.
+                const live = currentCtx;
+                if (live)
+                    openDashboardTui(live);
+            });
+            statusBarRef = bar;
+            return bar;
+        }, { placement: "belowEditor" });
+        // ── Aggregate token footer (aboveEditor) ─────────────────────────
+        ctx.ui.setWidget(FOOTER_WIDGET_KEY, (tui, theme) => {
+            const getOrchestratorModel = () => {
+                try {
+                    const m = ctx.model;
+                    if (!m)
+                        return undefined;
+                    return { provider: m.provider, model: m.id };
+                }
+                catch {
+                    return undefined;
+                }
+            };
+            const footer = new ViewportFooterComponent(registry, theme, getOrchestratorModel);
+            footer.setInvalidationCallback(() => tui.requestRender());
+            return footer;
+        }, { placement: "aboveEditor" });
+        // ── Input routing: ↓ focuses status bar; Enter opens dashboard ────────
+        getInputRouter().register((data) => {
+            if (!statusBarRef || !statusBarTui)
+                return undefined;
+            // Allow ↓ navigation whenever orchestration roots are visible —
+            // this includes completed/failed/escalated roots so the user
+            // can review results even after execution ends.
+            const activeRoots = tree.getActiveRoots();
+            if (activeRoots.length === 0)
+                return undefined;
+            // ↓ focuses the status bar (makes it active).
+            if (isDownArrow(data)) {
+                statusBarRef.setActive(true);
+                return { consume: true };
+            }
+            // When the status bar is focused, ↑ / Esc return focus to the prompt.
+            if (statusBarRef.isActive() && (matchesKey(data, Key.up) || matchesKey(data, Key.escape))) {
+                statusBarRef.setActive(false);
+                return { consume: true };
+            }
+            // When the status bar is focused, Enter opens the dashboard.
+            if (statusBarRef.isActive() && matchesKey(data, Key.enter)) {
+                statusBarRef.setActive(false);
+                const live = currentCtx;
+                if (live)
+                    openDashboardTui(live);
+                return { consume: true };
+            }
+            return undefined;
+        }, { name: "orchestrator-status-bar", skipWhenOverlayActive: true });
+        mounted = true;
+    }
+    pi.registerCommand("forge:threads", {
+        description: "Open the Forge orchestrator dashboard. " +
+            "Shows a two-panel view of sprint/task/phase tree with status, " +
+            "metrics, and live activity. You can also press ↓ from the prompt " +
+            "when an orchestration is running.",
+        async handler(_args, ctx) {
+            mount(ctx);
+            openDashboardTui(ctx);
+        },
+    });
+    // Mount at session_start so the status bar + ↓ listener are live from
+    // the first keystroke. mount() is idempotent.
+    pi.on("session_start", async (_event, ctx) => {
+        mount(ctx);
+    });
+}
+//# sourceMappingURL=thread-switcher.js.map

package/dist/extensions/forgecli/tui/thread-switcher.js.map

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