@entelligentsia/forgecli 0.7.9 → 0.7.10

package/dist/extensions/forgecli/viewport-events.js

@@ -0,0 +1,184 @@
+// viewport-events.ts
+//
+// Reusable subagent event observer. Wires `runForgeSubagent.onEvent` to:
+//   1. Append per-event tail lines (with tree connectors, glyphs, risky tag,
+//      thinking one-liners, batch markers) into SessionRegistry.
+//   2. Maintain cumulative phase token usage and push it to the registry on
+//      every turn_end — drives the sticky footer in the tail view AND the
+//      aggregate Σ meter in the chip strip.
+//   3. Surface counts (turn / tools / errors) so the orchestrator can render
+//      its end-of-phase summary.
+//
+// Used by run-task, fix-bug, and run-sprint (ceremony) so every subagent
+// "bubbles" usage up the same way. Top-level viewports read aggregate usage
+// via SessionRegistry.getAggregateUsage().
+import { argHint as fmtArgHint, extractThinkingOneLiner, extractTurnPreview, readUsage, resultShape, RISKY_TAG, toolGlyph, } from "./viewport-renderer.js";
+export function attachViewportObserver(opts) {
+    const { registry, sessionId, phaseRole, displayRole, beginHeader, writeDebug, setStatusVerbose, notify, verboseKeys, afterEach } = opts;
+    const role = displayRole ?? phaseRole;
+    const state = {
+        turn: 0,
+        toolCount: 0,
+        errCount: 0,
+        lastTool: "",
+        cumUsage: { input: 0, output: 0, cacheRead: 0 },
+    };
+    // Per-turn tree-connector state.
+    let toolsThisTurn = 0;
+    let firstLineOfTurn = true;
+    let currentTurnPrefixWidth = 0;
+    const argsByCallId = new Map();
+    const formatTime = (ms) => {
+        const d = new Date(ms);
+        const pad = (n) => String(n).padStart(2, "0");
+        return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+    };
+    const tailPrefix = () => `[${role} ${formatTime(Date.now())} t${state.turn}]`;
+    const appendTail = (line, opts) => {
+        registry.appendTail(sessionId, phaseRole, line, opts);
+    };
+    const extractErrorSummary = (result) => {
+        const raw = typeof result === "string"
+            ? result
+            : typeof result === "object" && result !== null
+                ? JSON.stringify(result)
+                : String(result);
+        const firstLine = raw.split(/\r?\n/).find((l) => l.trim().length > 0) ?? raw;
+        return firstLine.length > 160 ? `${firstLine.slice(0, 160)}…` : firstLine;
+    };
+    const emitTurnLine = (body, lineOpts) => {
+        const isFirst = firstLineOfTurn;
+        const isClosing = lineOpts?.closing === true;
+        let branch;
+        if (isFirst && isClosing)
+            branch = "─";
+        else if (isFirst)
+            branch = "╭";
+        else if (isClosing)
+            branch = "╰";
+        else
+            branch = "│";
+        let prefix;
+        if (isFirst) {
+            prefix = tailPrefix();
+            currentTurnPrefixWidth = prefix.length;
+        }
+        else {
+            prefix = " ".repeat(currentTurnPrefixWidth);
+        }
+        firstLineOfTurn = false;
+        appendTail(`${prefix} ${branch} ${body}`, lineOpts?.warning ? { warning: true } : undefined);
+    };
+    if (beginHeader)
+        appendTail(`${tailPrefix()} ${beginHeader}`);
+    const onEvent = (event) => {
+        switch (event.type) {
+            case "turn_start": {
+                state.turn++;
+                state.lastTool = "";
+                toolsThisTurn = 0;
+                firstLineOfTurn = true;
+                registry.bumpTurn(sessionId);
+                break;
+            }
+            case "turn_end": {
+                const e = event;
+                const delta = readUsage(e.message);
+                state.cumUsage.input += delta.input;
+                state.cumUsage.output += delta.output;
+                state.cumUsage.cacheRead += delta.cacheRead;
+                registry.setPhaseUsage(sessionId, phaseRole, state.cumUsage);
+                const closingBodies = [];
+                const thinking = extractThinkingOneLiner(e.message);
+                if (thinking)
+                    closingBodies.push(`✱ ${thinking}`);
+                const preview = extractTurnPreview(e.message);
+                if (preview) {
+                    registry.setTurnPreview(sessionId, preview);
+                    if (setStatusVerbose && verboseKeys?.messageKey) {
+                        setStatusVerbose(verboseKeys.messageKey, `  "${preview}"`);
+                    }
+                    closingBodies.push(`» "${preview}"`);
+                }
+                if (toolsThisTurn > 1) {
+                    closingBodies.push(`⇉ batched ${toolsThisTurn} tool calls in turn ${state.turn}`);
+                }
+                for (let i = 0; i < closingBodies.length; i++) {
+                    const isLast = i === closingBodies.length - 1;
+                    emitTurnLine(closingBodies[i], { closing: isLast });
+                }
+                // Bubble one consolidated event up to the registry so the
+                // top-level viewport can surface activity from any subagent
+                // with subagent-identified attribution.
+                registry.recordTurnEvent({
+                    sessionId,
+                    phaseRole,
+                    displayRole: role,
+                    turn: state.turn,
+                    preview: preview ?? "",
+                    thinking: thinking ?? "",
+                    deltaUsage: { ...delta },
+                    cumUsage: { ...state.cumUsage },
+                    timestamp: Date.now(),
+                });
+                break;
+            }
+            case "tool_execution_start": {
+                const e = event;
+                state.toolCount++;
+                toolsThisTurn++;
+                argsByCallId.set(e.toolCallId, e.args);
+                const hint = fmtArgHint(e.toolName, e.args);
+                const { glyph, risky } = toolGlyph(e.toolName, e.args);
+                state.lastTool = `${e.toolName}${hint ? ` ${hint}` : ""}`;
+                writeDebug?.({
+                    kind: "tool_start",
+                    toolName: e.toolName,
+                    toolCallId: e.toolCallId,
+                    args: e.args,
+                });
+                registry.recordToolStart(sessionId, e.toolCallId, e.toolName, e.args);
+                const riskPrefix = risky ? `${RISKY_TAG} ` : "";
+                emitTurnLine(`${riskPrefix}${glyph} ${e.toolName}${hint ? ` ${hint}` : ""}`, risky ? { warning: true } : undefined);
+                break;
+            }
+            case "tool_execution_end": {
+                const e = event;
+                argsByCallId.delete(e.toolCallId);
+                writeDebug?.({
+                    kind: "tool_end",
+                    toolName: e.toolName,
+                    toolCallId: e.toolCallId,
+                    isError: e.isError,
+                    result: e.result,
+                });
+                registry.recordToolEnd(sessionId, e.toolCallId, e.toolName, e.isError, e.result);
+                if (e.isError) {
+                    state.errCount++;
+                    emitTurnLine(`⚠ ${e.toolName} failed: ${extractErrorSummary(e.result)}`, { warning: true });
+                }
+                else {
+                    const shape = resultShape(e.toolName, e.result);
+                    emitTurnLine(`← ${e.toolName} ok${shape ? ` ${shape}` : ""}`);
+                }
+                break;
+            }
+            case "compaction_start": {
+                const e = event;
+                notify?.(`◌ ${role}: context compacting (${e.reason})…`, "info");
+                appendTail(`${tailPrefix()} ◌ compacting (${e.reason})`);
+                break;
+            }
+            case "auto_retry_start": {
+                const e = event;
+                const err = e.errorMessage ?? "";
+                notify?.(`↻ ${role}: model retry ${e.attempt}/${e.maxAttempts}${err ? `\n${err}` : ""}`, "warning");
+                appendTail(`${tailPrefix()} ↻ retry ${e.attempt}/${e.maxAttempts}${err ? `: ${extractErrorSummary(err)}` : ""}`, { warning: true });
+                break;
+            }
+        }
+        afterEach?.();
+    };
+    return { onEvent, state };
+}
+//# sourceMappingURL=viewport-events.js.map

package/dist/extensions/forgecli/viewport-events.js.map

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

package/dist/extensions/forgecli/viewport-renderer.d.ts

@@ -0,0 +1,55 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+export declare const RISKY_TAG = "\uD83D\uDD12";
+export interface GlyphInfo {
+    glyph: string;
+    risky: boolean;
+}
+export declare function toolGlyph(toolName: string, args: unknown): GlyphInfo;
+export declare function argHint(toolName: string, args: unknown, maxLen?: number): string;
+/**
+ * Truncate at a whitespace boundary when possible so we don't slice mid-token
+ * (e.g. `FORGE_ROOT=$(node -e` cut at the open paren). Appends `…(+Nc)` so the
+ * user knows there's more.
+ */
+export declare function truncateAtBoundary(s: string, max: number): string;
+/**
+ * Extract a small "shape" hint from a tool result so users see `read ok 247L`
+ * instead of `read ok`. Defensive: result shapes vary across tools and providers.
+ */
+export declare function resultShape(_toolName: string, result: unknown): string;
+/**
+ * Pull the first sentence (or first 100 chars) from any `thinking` block on an
+ * assistant message. Returns `undefined` if no thinking content present.
+ */
+export declare function extractThinkingOneLiner(message: AgentMessage | undefined): string | undefined;
+export interface UsageDelta {
+    input: number;
+    output: number;
+    cacheRead: number;
+}
+/** Extract usage from an assistant message; returns zeros if missing. */
+export declare function readUsage(message: AgentMessage | undefined): UsageDelta;
+/**
+ * Extract the last assistant-authored text from a turn_end message and
+ * collapse to a single-line preview (max 120 chars). Returns "" if the
+ * message has no text content (e.g. all-tool-call turn).
+ */
+export declare function extractTurnPreview(message: unknown): string;
+export declare function fmtTokenMeter(u: UsageDelta): string;
+/** Format a one-shot phase-completion line for the tail buffer. */
+export declare function fmtPhaseSummary(opts: {
+    role: string;
+    turns: number;
+    tools: number;
+    errors: number;
+    wallSeconds: number;
+    usage: UsageDelta;
+    model?: string;
+    provider?: string;
+}): string;
+/**
+ * Build the sticky footer line shown at the bottom of the tail view.
+ * Includes cacheRead only when nonzero — most non-Anthropic providers (ollama,
+ * glm, etc.) return 0 for cache fields and we don't want the noise.
+ */
+export declare function fmtTokenFooter(usage: UsageDelta | undefined): string;

package/dist/extensions/forgecli/viewport-renderer.js

@@ -0,0 +1,204 @@
+// viewport-renderer.ts
+//
+// Pure-string helpers for the subagent viewport tail buffer.
+// Centralises glyph selection, arg/result shape extraction, thinking one-liners,
+// and running-usage formatting so run-task / run-sprint / fix-bug can share
+// rendering without diverging.
+import path from "node:path";
+/** Per-tool glyph. Falls back to a generic arrow when unknown. */
+const TOOL_GLYPHS = {
+    bash: "$",
+    read: "⌕",
+    write: "✎",
+    edit: "✎",
+    glob: "⌕",
+    grep: "⌕",
+    notebookedit: "✎",
+};
+/** Bash patterns we want users to see flagged even when auto-approved. */
+const RISKY_BASH = /\b(rm\s+-rf|git\s+push\s+--force|chmod\s+777|sudo\s|curl\s+[^|]*\|\s*sh\b|npm\s+publish\b)/;
+export const RISKY_TAG = "🔒";
+export function toolGlyph(toolName, args) {
+    const a = (args && typeof args === "object" ? args : {});
+    const lower = toolName.toLowerCase();
+    let glyph = TOOL_GLYPHS[lower];
+    if (!glyph) {
+        if (/store[-_]?cli|forge[-_]?store/i.test(toolName))
+            glyph = "⚙";
+        else
+            glyph = "→";
+    }
+    let risky = false;
+    if (lower === "bash" && typeof a.command === "string" && RISKY_BASH.test(a.command)) {
+        risky = true;
+    }
+    return { glyph, risky };
+}
+export function argHint(toolName, args, maxLen = 60) {
+    if (!args || typeof args !== "object")
+        return "";
+    const a = args;
+    const fp = (a.file_path ?? a.path);
+    if (typeof fp === "string")
+        return path.basename(fp);
+    if (typeof a.command === "string")
+        return truncateAtBoundary(a.command, maxLen);
+    if (typeof a.pattern === "string")
+        return truncateAtBoundary(a.pattern, maxLen);
+    if (typeof a.query === "string")
+        return truncateAtBoundary(a.query, maxLen);
+    return "";
+}
+/**
+ * Truncate at a whitespace boundary when possible so we don't slice mid-token
+ * (e.g. `FORGE_ROOT=$(node -e` cut at the open paren). Appends `…(+Nc)` so the
+ * user knows there's more.
+ */
+export function truncateAtBoundary(s, max) {
+    if (s.length <= max)
+        return s;
+    const head = s.slice(0, max);
+    const lastSpace = head.lastIndexOf(" ");
+    const cut = lastSpace > Math.floor(max * 0.6) ? lastSpace : max;
+    const extra = s.length - cut;
+    // Strip trailing whitespace before the ellipsis so the body is visually
+    // clean and downstream string checks (`endsWith` / regex) behave predictably.
+    return `${s.slice(0, cut).replace(/\s+$/, "")}…(+${extra}c)`;
+}
+/**
+ * Extract a small "shape" hint from a tool result so users see `read ok 247L`
+ * instead of `read ok`. Defensive: result shapes vary across tools and providers.
+ */
+export function resultShape(_toolName, result) {
+    try {
+        if (typeof result === "string") {
+            if (result.length === 0)
+                return "empty";
+            const lines = result.split(/\r?\n/).length;
+            return lines > 1 ? `${lines}L` : `${result.length}c`;
+        }
+        if (result && typeof result === "object") {
+            const r = result;
+            if (typeof r.stdout === "string") {
+                const out = r.stdout;
+                if (out.length === 0)
+                    return "empty";
+                const lines = out.split(/\r?\n/).length;
+                return `${lines}L`;
+            }
+            if (typeof r.content === "string") {
+                const lines = r.content.split(/\r?\n/).length;
+                return `${lines}L`;
+            }
+            if (Array.isArray(r.content)) {
+                let total = 0;
+                for (const item of r.content) {
+                    const t = item?.text;
+                    if (typeof t === "string")
+                        total += t.split(/\r?\n/).length;
+                }
+                if (total > 0)
+                    return `${total}L`;
+            }
+        }
+    }
+    catch {
+        // fall through to no hint
+    }
+    return "";
+}
+/**
+ * Pull the first sentence (or first 100 chars) from any `thinking` block on an
+ * assistant message. Returns `undefined` if no thinking content present.
+ */
+export function extractThinkingOneLiner(message) {
+    if (!message || message.role !== "assistant")
+        return undefined;
+    const content = message.content;
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        const b = block;
+        if (b?.type !== "thinking" || typeof b.thinking !== "string")
+            continue;
+        const text = b.thinking.trim();
+        if (!text)
+            continue;
+        const m = text.match(/^[^\n.!?]+/);
+        const first = (m ? m[0] : text).trim();
+        return first.length > 100 ? `${first.slice(0, 100)}…` : first;
+    }
+    return undefined;
+}
+/** Extract usage from an assistant message; returns zeros if missing. */
+export function readUsage(message) {
+    const u = message?.usage;
+    return {
+        input: u?.input ?? 0,
+        output: u?.output ?? 0,
+        cacheRead: u?.cacheRead ?? 0,
+    };
+}
+/**
+ * Extract the last assistant-authored text from a turn_end message and
+ * collapse to a single-line preview (max 120 chars). Returns "" if the
+ * message has no text content (e.g. all-tool-call turn).
+ */
+export function extractTurnPreview(message) {
+    if (!message || typeof message !== "object")
+        return "";
+    const msg = message;
+    if (msg.role !== "assistant")
+        return "";
+    const content = msg.content;
+    if (!Array.isArray(content))
+        return "";
+    for (const c of content) {
+        if (!c || typeof c !== "object")
+            continue;
+        const part = c;
+        if (part.type === "text" && typeof part.text === "string" && part.text.trim()) {
+            const flat = part.text.replace(/\s+/g, " ").trim();
+            return flat.length > 120 ? `${flat.slice(0, 117)}…` : flat;
+        }
+    }
+    return "";
+}
+export function fmtTokenMeter(u) {
+    return `↑${humanTokens(u.input)}↓${humanTokens(u.output)}`;
+}
+function humanTokens(n) {
+    if (n < 1000)
+        return String(n);
+    if (n < 10_000)
+        return `${(n / 1000).toFixed(1)}k`;
+    if (n < 1_000_000)
+        return `${Math.round(n / 1000)}k`;
+    return `${(n / 1_000_000).toFixed(2)}M`;
+}
+/** Format a one-shot phase-completion line for the tail buffer. */
+export function fmtPhaseSummary(opts) {
+    const { role, turns, tools, errors, wallSeconds, usage, model, provider } = opts;
+    const errPart = errors > 0 ? ` err=${errors}` : "";
+    const modelPart = model ? ` model=${model}${provider ? `/${provider}` : ""}` : "";
+    return `▣ ${role}: turns=${turns} tools=${tools}${errPart} ${fmtTokenMeter(usage)} wall=${fmtWall(wallSeconds)}${modelPart}`;
+}
+/**
+ * Build the sticky footer line shown at the bottom of the tail view.
+ * Includes cacheRead only when nonzero — most non-Anthropic providers (ollama,
+ * glm, etc.) return 0 for cache fields and we don't want the noise.
+ */
+export function fmtTokenFooter(usage) {
+    if (!usage)
+        return "";
+    const cache = usage.cacheRead > 0 ? ` ⇪${humanTokens(usage.cacheRead)}` : "";
+    return `↑${humanTokens(usage.input)} ↓${humanTokens(usage.output)}${cache}`;
+}
+function fmtWall(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    const m = Math.floor(seconds / 60);
+    const s = seconds % 60;
+    return `${m}m${String(s).padStart(2, "0")}s`;
+}
+//# sourceMappingURL=viewport-renderer.js.map

package/dist/extensions/forgecli/viewport-renderer.js.map

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

package/dist/extensions/forgecli/viewport-theme.d.ts

@@ -0,0 +1,11 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+/**
+ * Parse one tail line into prefix + body, then colour both halves.
+ * Returns the line unchanged if no theme is available.
+ */
+export declare function paintTailLine(line: string, theme: Theme | undefined): string;
+/**
+ * Build the sticky token-meter footer. Right-aligned to the viewport width,
+ * preceded by a thin separator line so it visually anchors to the prompt.
+ */
+export declare function paintFooterLine(text: string, width: number, theme: Theme | undefined): string;

package/dist/extensions/forgecli/viewport-theme.js

@@ -0,0 +1,124 @@
+// viewport-theme.ts
+//
+// Paints subagent-tail lines using pi's Theme. The tail buffer (see
+// viewport-renderer.ts) stores plain strings so transcripts and audit logs
+// stay ANSI-clean; this module is the single place that maps line categories
+// to theme colors at render time.
+//
+// Why parse at render time rather than colour at emit time:
+//   1. Theme may change after a line is emitted (user toggles theme).
+//   2. The tail buffer doubles as a fall-back trace; ANSI escapes there would
+//      bleed into any plaintext consumer (clipboard, transcript debugging).
+//   3. Run-task.ts has no direct theme access — it runs as a command handler;
+//      Theme lives in the TUI widget callback. Painting at render keeps the
+//      emit path theme-agnostic and testable in isolation.
+//
+// Mapping (single source of truth for line category → ThemeColor):
+//
+//   prefix `[role HH:MM:SS …]`  → dim
+//   `$ bash …`                   → bashMode (glyph) + text (rest)
+//   `⌕ read/grep/glob …`         → accent (glyph)
+//   `✎ write/edit …`             → warning (glyph)  -- mutation
+//   `⚙ store-cli …`              → toolTitle (glyph)
+//   `→ …`  fallback              → muted (glyph)
+//   `← tool ok 247L`             → success (glyph + "ok N L")
+//   `⚠ tool failed: …`           → error
+//   `🔒 …`                       → error bold (glyph)
+//   `✱ thinking line`            → thinkingText italic
+//   `» "preview"`                → muted italic
+//   `⇉ batched N`                → dim
+//   `▣ summary`                  → accent bold
+//   `─── phase X/Y …`            → accent bold
+import { visibleWidth } from "@earendil-works/pi-tui";
+/**
+ * Parse one tail line into prefix + body, then colour both halves.
+ * Returns the line unchanged if no theme is available.
+ */
+export function paintTailLine(line, theme) {
+    if (!theme)
+        return line;
+    // Prefix: `[role HH:MM:SS t<turn> ↑X↓Y]` — everything up to the first `]`.
+    const closeIdx = line.indexOf("]");
+    if (closeIdx === -1) {
+        // No structured prefix — phase begin lines like `─── phase … ───`
+        // still get themed via body matcher.
+        return paintBody(line, theme);
+    }
+    const prefix = line.slice(0, closeIdx + 1);
+    const body = line.slice(closeIdx + 1);
+    const paintedPrefix = theme.fg("dim", prefix);
+    const paintedBody = paintBody(body, theme);
+    return `${paintedPrefix}${paintedBody}`;
+}
+/**
+ * Build the sticky token-meter footer. Right-aligned to the viewport width,
+ * preceded by a thin separator line so it visually anchors to the prompt.
+ */
+export function paintFooterLine(text, width, theme) {
+    const w = Math.max(visibleWidth(text), 0);
+    const padLen = Math.max(0, width - w);
+    const pad = " ".repeat(padLen);
+    if (!theme)
+        return `${pad}${text}`;
+    return `${pad}${theme.bold(theme.fg("accent", text))}`;
+}
+function paintBody(body, theme) {
+    const trimmed = body.replace(/^\s+/, "");
+    if (trimmed.length === 0)
+        return body;
+    const leadingWs = body.slice(0, body.length - trimmed.length);
+    // Tree connector at the start (`╭`/`│`/`╰`/`─`): paint dim then recurse so
+    // the inner glyph still gets its category colour. `─` only when followed by
+    // whitespace and NOT another `─` — that disambiguates a single-line-turn
+    // connector from a phase-boundary line (`─── phase X/Y …`).
+    const conn = trimmed.match(/^([╭│╰]|─(?=\s))\s+(.*)$/);
+    if (conn) {
+        const connector = conn[1];
+        const rest = conn[2];
+        return `${leadingWs}${theme.fg("dim", connector)} ${paintInner(rest, theme)}`;
+    }
+    return `${leadingWs}${paintInner(trimmed, theme)}`;
+}
+function paintInner(trimmed, theme) {
+    if (trimmed.length === 0)
+        return trimmed;
+    // Use codePointAt so non-BMP emoji like 🔒 (U+1F512, surrogate pair in
+    // UTF-16) match correctly. `trimmed[0]` returns only the high surrogate.
+    const cp = trimmed.codePointAt(0);
+    const first = cp !== undefined ? String.fromCodePoint(cp) : "";
+    switch (first) {
+        case "$": // bash
+            return `${theme.fg("bashMode", "$")}${trimmed.slice(1)}`;
+        case "⌕": // read/grep/glob
+            return `${theme.fg("accent", "⌕")}${trimmed.slice(1)}`;
+        case "✎": // write/edit
+            return `${theme.fg("warning", "✎")}${trimmed.slice(1)}`;
+        case "⚙": // store-cli
+            return `${theme.fg("toolTitle", "⚙")}${trimmed.slice(1)}`;
+        case "→": // fallback tool
+            return `${theme.fg("muted", "→")}${trimmed.slice(1)}`;
+        case "←": // tool result OK
+            return theme.fg("success", trimmed);
+        case "⚠": // tool failed
+            return theme.fg("error", trimmed);
+        case "🔒": // risky bash
+            return theme.bold(theme.fg("error", trimmed));
+        case "✱": // thinking
+            return theme.italic(theme.fg("thinkingText", trimmed));
+        case "»": // model preview text
+            return theme.italic(theme.fg("muted", trimmed));
+        case "⇉": // batched
+            return theme.fg("dim", trimmed);
+        case "▣": // phase summary
+            return theme.bold(theme.fg("accent", trimmed));
+        case "─": // phase boundary line `─── phase X/Y begin · taskId ───`
+            return theme.bold(theme.fg("accent", trimmed));
+        case "↻": // auto retry
+            return theme.fg("warning", trimmed);
+        case "◌": // compaction
+            return theme.fg("muted", trimmed);
+        default:
+            return trimmed;
+    }
+}
+//# sourceMappingURL=viewport-theme.js.map

package/dist/extensions/forgecli/viewport-theme.js.map

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

package/dist/forge-payload/.base-pack/workflows/_fragments/store-cli-verbs.md

@@ -3,13 +3,24 @@
 <!-- Canonical store-cli verb list. Referenced by meta workflows that issue
      store-cli calls. Surface it inline near the first store-cli invocation
      so subagents stop inventing REST-style verbs (`get`, `set`, `delete`)
-     when they have to improvise a follow-up call. See forge#95. -->
+     when they have to improvise a follow-up call. See forge#95 and
+     FORGE-S22-T02 (read-aliases). -->
 
 store-cli verbs: `read` | `list` | `write` | `emit` | `update-status` | `set-summary` | `set-bug-summary` | `describe` | `template` | `nlp` | `query` | `delete`
 
+Read-aliases (FORGE-S22-T02): `get` | `get-task` | `get-bug` | `get-sprint` | `get-summary` | `get-bug-summary`
+
 Notes for subagents:
 
-- **`read`** is the canonical "fetch one record" verb. There is no `get`.
+- **`read`** is the canonical "fetch one record" verb. The aliases
+  `get <entity> <id>`, `get-task <id>`, `get-bug <id>`, `get-sprint <id>`
+  are accepted and delegate byte-equally to `read`. Prefer the canonical
+  `read` form in new code; aliases exist to reduce friction when an agent
+  reaches for REST-style verbs.
+- **`get-summary <taskId> <phase>`** and **`get-bug-summary <bugId> <phase>`**
+  are direct summary readers — they extract `record.summaries[phase]` and
+  exit 1 if the phase is absent. They are NOT write verbs (do not confuse
+  with `set-summary` / `set-bug-summary`).
 - **`list`** filters by entity (`sprint`, `task`, `bug`, `event`, `feature`)
   and optional flags. There is no `find` or `search` — use `nlp` for
   natural-language lookup.
@@ -21,3 +32,8 @@ Notes for subagents:
   from the entity record. Do not inline summaries into the entity via `write`.
 - If you need a verb not on this list, run
   `node "$FORGE_ROOT/tools/store-cli.cjs" --help` before improvising.
+- If you supply an unknown verb, entity type, enum value, or field name,
+  store-cli appends a **Did you mean?** suggestion to the error message.
+  Suggestions use Levenshtein distance (≤ 2) and a curated drift map for
+  common agent misconceptions (e.g., `completed` → `committed`,
+  `task` → `taskId`, `set` → `set-summary`). See FORGE-S22-T03.