gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/gsd/visualizer-views.js

@@ -0,0 +1,893 @@
+// View renderers for the GSD workflow visualizer overlay.
+import { truncateToWidth } from "@gsd/pi-tui";
+import { formatCost, formatTokenCount, classifyUnitPhase } from "./metrics.js";
+import { formatDuration, padRight, joinColumns, sparkline, STATUS_GLYPH, STATUS_COLOR } from "../shared/mod.js";
+function formatCompletionDate(input) {
+    if (!input)
+        return "unknown";
+    const parsed = new Date(input);
+    if (Number.isNaN(parsed.getTime()))
+        return input;
+    return parsed.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function sliceLabel(slice) {
+    return `${slice.milestoneId}/${slice.sliceId}`;
+}
+function renderFeatureStats(data, th, width) {
+    const stats = data.stats;
+    const lines = [];
+    lines.push(th.fg("accent", th.bold("Feature Snapshot")));
+    lines.push("");
+    const missingLabel = `Missing slices: ${th.fg("warning", String(stats.missingCount))}`;
+    lines.push(truncateToWidth(`  ${missingLabel}`, width));
+    if (stats.missingSlices.length > 0) {
+        for (const slice of stats.missingSlices) {
+            const row = `    ${th.fg("dim", sliceLabel(slice))} ${slice.title}`;
+            lines.push(truncateToWidth(row, width));
+        }
+        const remaining = stats.missingCount - stats.missingSlices.length;
+        if (remaining > 0) {
+            lines.push(truncateToWidth(`    ... and ${remaining} more`, width));
+        }
+    }
+    lines.push("");
+    const updatedLabel = `Updated (last 7 days): ${th.fg("accent", String(stats.updatedCount))}`;
+    lines.push(truncateToWidth(`  ${updatedLabel}`, width));
+    if (stats.updatedSlices.length > 0) {
+        for (const slice of stats.updatedSlices) {
+            const when = formatCompletionDate(slice.completedAt);
+            const row = `    ${th.fg("text", sliceLabel(slice))} ${th.fg("dim", when)} ${slice.title}`;
+            lines.push(truncateToWidth(row, width));
+        }
+    }
+    lines.push("");
+    lines.push(truncateToWidth(`  Recent completions: ${th.fg("success", String(stats.recentEntries.length))}`, width));
+    for (const entry of stats.recentEntries) {
+        const when = formatCompletionDate(entry.completedAt);
+        const row = `    ${th.fg("text", entry.sliceId)} — ${entry.oneLiner || entry.title} ${th.fg("dim", when)}`;
+        lines.push(truncateToWidth(row, width));
+    }
+    lines.push("");
+    return lines;
+}
+function renderDiscussionStatus(data, th, width) {
+    const states = data.discussion;
+    if (states.length === 0)
+        return [];
+    const counts = {
+        discussed: 0,
+        draft: 0,
+        undiscussed: 0,
+    };
+    for (const state of states)
+        counts[state.state]++;
+    const lines = [];
+    lines.push(th.fg("accent", th.bold("Discussion Status")));
+    lines.push("");
+    const summary = `  Discussed: ${th.fg("success", String(counts.discussed))}  Draft: ${th.fg("warning", String(counts.draft))}  Pending: ${th.fg("dim", String(counts.undiscussed))}`;
+    lines.push(truncateToWidth(summary, width));
+    lines.push("");
+    for (const state of states) {
+        const badge = state.state === "discussed"
+            ? th.fg("success", "Discussed")
+            : state.state === "draft"
+                ? th.fg("warning", "Draft")
+                : th.fg("dim", "Pending");
+        const when = state.lastUpdated ? ` ${th.fg("dim", formatCompletionDate(state.lastUpdated))}` : "";
+        const row = `    ${th.fg("text", state.milestoneId)} ${badge} ${state.title}${when}`;
+        lines.push(truncateToWidth(row, width));
+    }
+    lines.push("");
+    return lines;
+}
+function findVerification(data, milestoneId, sliceId) {
+    return data.sliceVerifications.find(v => v.milestoneId === milestoneId && v.sliceId === sliceId);
+}
+export function renderProgressView(data, th, width, filter, collapsed) {
+    const lines = [];
+    // Risk Heatmap
+    lines.push(...renderRiskHeatmap(data, th, width));
+    if (data.milestones.length > 0)
+        lines.push("");
+    // Filter indicator
+    if (filter && filter.text) {
+        lines.push(th.fg("accent", `Filter (${filter.field}): ${filter.text}`));
+        lines.push("");
+    }
+    lines.push(...renderFeatureStats(data, th, width));
+    lines.push(...renderDiscussionStatus(data, th, width));
+    for (const ms of data.milestones) {
+        // Apply filter to milestones
+        if (filter && filter.text) {
+            const matchesMs = matchesFilter(ms, filter);
+            if (!matchesMs)
+                continue;
+        }
+        // Milestone header line
+        const msStatus = ms.status === "complete" ? "done" : ms.status === "active" ? "active" : ms.status === "parked" ? "paused" : "pending";
+        const statusGlyph = th.fg(STATUS_COLOR[msStatus], STATUS_GLYPH[msStatus]);
+        const statusLabel = th.fg(STATUS_COLOR[msStatus], ms.status);
+        const collapseIndicator = collapsed?.has(ms.id) ? "[+] " : "";
+        const msLeft = `${collapseIndicator}${ms.id}: ${ms.title}`;
+        const msRight = `${statusGlyph} ${statusLabel}`;
+        lines.push(joinColumns(msLeft, msRight, width));
+        // If collapsed, skip rendering slices/tasks
+        if (collapsed?.has(ms.id))
+            continue;
+        if (ms.slices.length === 0 && ms.dependsOn.length > 0) {
+            lines.push(th.fg("dim", `  (depends on ${ms.dependsOn.join(", ")})`));
+            continue;
+        }
+        if (ms.status === "pending" && ms.dependsOn.length > 0) {
+            lines.push(th.fg("dim", `  (depends on ${ms.dependsOn.join(", ")})`));
+            continue;
+        }
+        for (const sl of ms.slices) {
+            // Apply filter to slices
+            if (filter && filter.text) {
+                if (!matchesSliceFilter(sl, filter))
+                    continue;
+            }
+            // Slice line
+            const slStatus = sl.done ? "done" : sl.active ? "active" : "pending";
+            const slGlyph = th.fg(STATUS_COLOR[slStatus], STATUS_GLYPH[slStatus]);
+            const riskColor = sl.risk === "high"
+                ? "warning"
+                : sl.risk === "medium"
+                    ? "text"
+                    : "dim";
+            const riskBadge = th.fg(riskColor, sl.risk);
+            // Verification badge
+            const ver = findVerification(data, ms.id, sl.id);
+            let verBadge = "";
+            if (ver) {
+                if (ver.verificationResult === "passed") {
+                    verBadge = " " + th.fg("success", "\u2713");
+                }
+                else if (ver.verificationResult === "failed") {
+                    verBadge = " " + th.fg("error", "\u2717");
+                }
+                else if (ver.verificationResult === "untested" || ver.verificationResult === "") {
+                    verBadge = " " + th.fg("dim", "?");
+                }
+                if (ver.blockerDiscovered) {
+                    verBadge += " " + th.fg("warning", "\u26a0");
+                }
+            }
+            const slLeft = `  ${slGlyph} ${sl.id}: ${sl.title}${verBadge}`;
+            lines.push(joinColumns(slLeft, riskBadge, width));
+            // Show tasks for active slice
+            if (sl.active && sl.tasks.length > 0) {
+                for (const task of sl.tasks) {
+                    const tStatus = task.done ? "done" : task.active ? "active" : "pending";
+                    const tGlyph = th.fg(STATUS_COLOR[tStatus], STATUS_GLYPH[tStatus]);
+                    const estimateStr = task.estimate ? th.fg("dim", ` (${task.estimate})`) : "";
+                    lines.push(`      ${tGlyph} ${task.id}: ${task.title}${estimateStr}`);
+                }
+            }
+        }
+    }
+    return lines;
+}
+function matchesFilter(ms, filter) {
+    const text = filter.text.toLowerCase();
+    if (filter.field === "status") {
+        return ms.status.includes(text);
+    }
+    if (filter.field === "risk") {
+        return ms.slices.some(s => s.risk.toLowerCase().includes(text));
+    }
+    // "all" or "keyword"
+    if (ms.id.toLowerCase().includes(text))
+        return true;
+    if (ms.title.toLowerCase().includes(text))
+        return true;
+    if (ms.status.includes(text))
+        return true;
+    return ms.slices.some(s => matchesSliceFilter(s, filter));
+}
+function matchesSliceFilter(sl, filter) {
+    const text = filter.text.toLowerCase();
+    if (filter.field === "status")
+        return true; // slices don't have named status
+    if (filter.field === "risk")
+        return sl.risk.toLowerCase().includes(text);
+    return sl.id.toLowerCase().includes(text) ||
+        sl.title.toLowerCase().includes(text) ||
+        sl.risk.toLowerCase().includes(text);
+}
+// ─── Risk Heatmap ────────────────────────────────────────────────────────────
+function renderRiskHeatmap(data, th, width) {
+    const allSlices = data.milestones.flatMap(m => m.slices);
+    if (allSlices.length === 0)
+        return [];
+    const lines = [];
+    lines.push(th.fg("accent", th.bold("Risk Heatmap")));
+    lines.push("");
+    for (const ms of data.milestones) {
+        if (ms.slices.length === 0)
+            continue;
+        const blocks = ms.slices.map(s => {
+            const color = s.risk === "high" ? "error" : s.risk === "medium" ? "warning" : "success";
+            return th.fg(color, "\u2588\u2588");
+        });
+        const row = `  ${padRight(ms.id, 6)} ${blocks.join(" ")}`;
+        lines.push(truncateToWidth(row, width));
+    }
+    lines.push("");
+    lines.push(`  ${th.fg("success", "\u2588\u2588")} low  ${th.fg("warning", "\u2588\u2588")} med  ${th.fg("error", "\u2588\u2588")} high`);
+    // Summary counts
+    let low = 0, med = 0, high = 0;
+    let highNotStarted = 0;
+    for (const sl of allSlices) {
+        if (sl.risk === "high") {
+            high++;
+            if (!sl.done && !sl.active)
+                highNotStarted++;
+        }
+        else if (sl.risk === "medium") {
+            med++;
+        }
+        else {
+            low++;
+        }
+    }
+    let summary = `  Risk: ${low} low, ${med} med, ${high} high`;
+    if (highNotStarted > 0) {
+        summary += ` | ${th.fg("error", `${highNotStarted} high-risk not started`)}`;
+    }
+    lines.push(summary);
+    return lines;
+}
+// ─── Dependencies View ───────────────────────────────────────────────────────
+export function renderDepsView(data, th, width) {
+    const lines = [];
+    // Milestone Dependencies
+    lines.push(th.fg("accent", th.bold("Milestone Dependencies")));
+    lines.push("");
+    const msDeps = data.milestones.filter((ms) => ms.dependsOn.length > 0);
+    if (msDeps.length === 0) {
+        lines.push(th.fg("dim", "  No milestone dependencies."));
+    }
+    else {
+        for (const ms of msDeps) {
+            for (const dep of ms.dependsOn) {
+                lines.push(`  ${th.fg("text", dep)} ${th.fg("accent", "\u2500\u2500\u25ba")} ${th.fg("text", ms.id)}`);
+            }
+        }
+    }
+    lines.push("");
+    // Slice Dependencies (active milestone)
+    lines.push(th.fg("accent", th.bold("Slice Dependencies (active milestone)")));
+    lines.push("");
+    const activeMs = data.milestones.find((ms) => ms.status === "active");
+    if (!activeMs) {
+        lines.push(th.fg("dim", "  No active milestone."));
+    }
+    else {
+        const slDeps = activeMs.slices.filter((sl) => sl.depends.length > 0);
+        if (slDeps.length === 0) {
+            lines.push(th.fg("dim", "  No slice dependencies."));
+        }
+        else {
+            for (const sl of slDeps) {
+                for (const dep of sl.depends) {
+                    lines.push(`  ${th.fg("text", dep)} ${th.fg("accent", "\u2500\u2500\u25ba")} ${th.fg("text", sl.id)}`);
+                }
+            }
+        }
+    }
+    lines.push("");
+    // Critical Path section
+    lines.push(...renderCriticalPath(data, th, width));
+    // Data Flow section from slice verifications
+    lines.push("");
+    lines.push(...renderDataFlow(data, th));
+    return lines;
+}
+// ─── Data Flow ───────────────────────────────────────────────────────────────
+function renderDataFlow(data, th) {
+    const lines = [];
+    const versWithProvides = data.sliceVerifications.filter(v => v.provides.length > 0);
+    const versWithRequires = data.sliceVerifications.filter(v => v.requires.length > 0);
+    if (versWithProvides.length === 0 && versWithRequires.length === 0)
+        return lines;
+    lines.push(th.fg("accent", th.bold("Data Flow")));
+    lines.push("");
+    for (const v of versWithProvides) {
+        for (const artifact of v.provides) {
+            lines.push(`  ${th.fg("text", v.sliceId)} ${th.fg("accent", "\u2500\u2500\u25ba")} ${th.fg("dim", `[${artifact}]`)}`);
+        }
+    }
+    for (const v of versWithRequires) {
+        for (const req of v.requires) {
+            lines.push(`  ${th.fg("dim", `[${req.provides}]`)} ${th.fg("accent", "\u25c4\u2500\u2500")} ${th.fg("text", req.slice)}`);
+        }
+    }
+    return lines;
+}
+// ─── Critical Path ───────────────────────────────────────────────────────────
+function renderCriticalPath(data, th, _width) {
+    const lines = [];
+    const cp = data.criticalPath;
+    lines.push(th.fg("accent", th.bold("Critical Path")));
+    lines.push("");
+    if (cp.milestonePath.length === 0) {
+        lines.push(th.fg("dim", "  No critical path data."));
+        return lines;
+    }
+    // Milestone chain
+    const chain = cp.milestonePath.map(id => {
+        const badge = th.fg("error", "[CRITICAL]");
+        return `${id} ${badge}`;
+    }).join(` ${th.fg("accent", "\u2500\u2500\u25ba")} `);
+    lines.push(`  ${chain}`);
+    lines.push("");
+    // Non-critical milestones with slack
+    for (const ms of data.milestones) {
+        if (cp.milestonePath.includes(ms.id))
+            continue;
+        const slack = cp.milestoneSlack.get(ms.id) ?? 0;
+        lines.push(th.fg("dim", `  ${ms.id} (slack: ${slack})`));
+    }
+    // Slice-level critical path
+    if (cp.slicePath.length > 0) {
+        lines.push("");
+        lines.push(th.fg("accent", th.bold("Slice Critical Path")));
+        lines.push("");
+        const sliceChain = cp.slicePath.join(` ${th.fg("accent", "\u2500\u2500\u25ba")} `);
+        lines.push(`  ${sliceChain}`);
+        // Bottleneck warnings
+        const activeMs = data.milestones.find(m => m.status === "active");
+        if (activeMs) {
+            for (const sid of cp.slicePath) {
+                const sl = activeMs.slices.find(s => s.id === sid);
+                if (sl && !sl.done && !sl.active) {
+                    lines.push(th.fg("warning", `  \u26a0 ${sid}: critical but not yet started`));
+                }
+            }
+        }
+    }
+    return lines;
+}
+// ─── Metrics View ────────────────────────────────────────────────────────────
+export function renderMetricsView(data, th, width) {
+    const lines = [];
+    if (data.totals === null) {
+        lines.push(th.fg("dim", "No metrics data available."));
+        return lines;
+    }
+    const totals = data.totals;
+    // Summary line
+    lines.push(th.fg("accent", th.bold("Summary")));
+    lines.push(`  Cost: ${th.fg("text", formatCost(totals.cost))}  ` +
+        `Tokens: ${th.fg("text", formatTokenCount(totals.tokens.total))}  ` +
+        `Units: ${th.fg("text", String(totals.units))}`);
+    lines.push(`  Tools: ${th.fg("text", String(totals.toolCalls))}  ` +
+        `Messages: ${th.fg("text", String(totals.assistantMessages))} sent / ${th.fg("text", String(totals.userMessages))} received`);
+    lines.push("");
+    const barWidth = Math.max(10, width - 40);
+    // By Phase
+    if (data.byPhase.length > 0) {
+        lines.push(th.fg("accent", th.bold("By Phase")));
+        lines.push("");
+        const maxPhaseCost = Math.max(...data.byPhase.map((p) => p.cost));
+        for (const phase of data.byPhase) {
+            const pct = totals.cost > 0 ? (phase.cost / totals.cost) * 100 : 0;
+            const fillLen = maxPhaseCost > 0
+                ? Math.round((phase.cost / maxPhaseCost) * barWidth)
+                : 0;
+            const bar = th.fg("accent", "\u2588".repeat(fillLen)) +
+                th.fg("dim", "\u2591".repeat(barWidth - fillLen));
+            const label = padRight(phase.phase, 14);
+            const costStr = formatCost(phase.cost);
+            const pctStr = `${pct.toFixed(1)}%`;
+            const tokenStr = formatTokenCount(phase.tokens.total);
+            lines.push(`  ${label} ${bar} ${costStr} ${pctStr} ${tokenStr}`);
+        }
+        lines.push("");
+    }
+    // By Model
+    if (data.byModel.length > 0) {
+        lines.push(th.fg("accent", th.bold("By Model")));
+        lines.push("");
+        const maxModelCost = Math.max(...data.byModel.map((m) => m.cost));
+        for (const model of data.byModel) {
+            const pct = totals.cost > 0 ? (model.cost / totals.cost) * 100 : 0;
+            const fillLen = maxModelCost > 0
+                ? Math.round((model.cost / maxModelCost) * barWidth)
+                : 0;
+            const bar = th.fg("accent", "\u2588".repeat(fillLen)) +
+                th.fg("dim", "\u2591".repeat(barWidth - fillLen));
+            const label = padRight(model.model, 20);
+            const costStr = formatCost(model.cost);
+            const pctStr = `${pct.toFixed(1)}%`;
+            lines.push(`  ${label} ${bar} ${costStr} ${pctStr}`);
+        }
+        lines.push("");
+    }
+    // By Tier
+    if (data.byTier.length > 0) {
+        lines.push(th.fg("accent", th.bold("By Tier")));
+        lines.push("");
+        const maxTierCost = Math.max(...data.byTier.map((t) => t.cost));
+        for (const tier of data.byTier) {
+            const pct = totals.cost > 0 ? (tier.cost / totals.cost) * 100 : 0;
+            const fillLen = maxTierCost > 0
+                ? Math.round((tier.cost / maxTierCost) * barWidth)
+                : 0;
+            const bar = th.fg("accent", "\u2588".repeat(fillLen)) +
+                th.fg("dim", "\u2591".repeat(barWidth - fillLen));
+            const label = padRight(tier.tier, 12);
+            const costStr = formatCost(tier.cost);
+            const pctStr = `${pct.toFixed(1)}%`;
+            const unitsStr = `${tier.units} units`;
+            lines.push(`  ${label} ${bar} ${costStr} ${pctStr} ${unitsStr}`);
+        }
+        if (data.tierSavingsLine) {
+            lines.push(`  ${th.fg("success", data.tierSavingsLine)}`);
+        }
+        lines.push("");
+    }
+    // Cost Projections
+    lines.push(...renderCostProjections(data, th, width));
+    return lines;
+}
+// ─── Cost Projections ────────────────────────────────────────────────────────
+function renderCostProjections(data, th, _width) {
+    const lines = [];
+    if (!data.totals || data.bySlice.length === 0)
+        return lines;
+    lines.push(th.fg("accent", th.bold("Projections")));
+    lines.push("");
+    // Average cost per slice
+    const sliceLevelEntries = data.bySlice.filter(s => s.sliceId.includes("/"));
+    if (sliceLevelEntries.length < 2) {
+        lines.push(th.fg("dim", "  Insufficient data for projections (need 2+ completed slices)."));
+        return lines;
+    }
+    const totalSliceCost = sliceLevelEntries.reduce((sum, s) => sum + s.cost, 0);
+    const avgCostPerSlice = totalSliceCost / sliceLevelEntries.length;
+    const projectedRemaining = avgCostPerSlice * data.remainingSliceCount;
+    lines.push(`  Avg cost/slice: ${th.fg("text", formatCost(avgCostPerSlice))}`);
+    lines.push(`  Projected remaining: ${th.fg("text", formatCost(projectedRemaining))} ` +
+        `(${formatCost(avgCostPerSlice)}/slice \u00d7 ${data.remainingSliceCount} remaining)`);
+    // Burn rate
+    if (data.totals.duration > 0) {
+        const costPerHour = data.totals.cost / (data.totals.duration / 3_600_000);
+        lines.push(`  Burn rate: ${th.fg("text", formatCost(costPerHour) + "/hr")}`);
+    }
+    // Sparkline of per-slice costs
+    const sliceCosts = sliceLevelEntries.map(s => s.cost);
+    if (sliceCosts.length > 0) {
+        const spark = sparkline(sliceCosts);
+        lines.push(`  Cost trend: ${spark}`);
+    }
+    // Budget warning: projected total > 2x current spend
+    const projectedTotal = data.totals.cost + projectedRemaining;
+    if (projectedTotal > 2 * data.totals.cost && data.remainingSliceCount > 0) {
+        lines.push(th.fg("warning", `  \u26a0 Projected total ${formatCost(projectedTotal)} exceeds 2\u00d7 current spend`));
+    }
+    return lines;
+}
+// ─── Timeline View (Gantt) ──────────────────────────────────────────────────
+export function renderTimelineView(data, th, width) {
+    const lines = [];
+    if (data.units.length === 0) {
+        lines.push(th.fg("dim", "No execution history."));
+        return lines;
+    }
+    // Gantt mode for wide terminals, list mode for narrow
+    if (width >= 90) {
+        return renderGanttView(data, th, width);
+    }
+    return renderTimelineList(data, th, width);
+}
+function shortenModel(model) {
+    return model.replace(/^claude-/, "").slice(0, 12);
+}
+function renderTimelineList(data, th, width) {
+    const lines = [];
+    // Show up to 20 most recent (units are sorted by startedAt asc, show most recent)
+    const recent = data.units.slice(-20).reverse();
+    const maxDuration = Math.max(...recent.map((u) => u.finishedAt - u.startedAt));
+    const timeBarWidth = Math.max(4, Math.min(12, width - 60));
+    for (const unit of recent) {
+        const dt = new Date(unit.startedAt);
+        const hh = String(dt.getHours()).padStart(2, "0");
+        const mm = String(dt.getMinutes()).padStart(2, "0");
+        const time = `${hh}:${mm}`;
+        const duration = unit.finishedAt - unit.startedAt;
+        const unitStatus = unit.finishedAt > 0 ? "done" : "active";
+        const glyph = th.fg(STATUS_COLOR[unitStatus], STATUS_GLYPH[unitStatus]);
+        const typeLabel = padRight(unit.type, 16);
+        const idLabel = padRight(unit.id, 14);
+        const fillLen = maxDuration > 0
+            ? Math.round((duration / maxDuration) * timeBarWidth)
+            : 0;
+        const bar = th.fg("accent", "\u2588".repeat(fillLen)) +
+            th.fg("dim", "\u2591".repeat(timeBarWidth - fillLen));
+        const durStr = formatDuration(duration);
+        const costStr = formatCost(unit.cost);
+        // Tier and model info
+        const tierLabel = unit.tier ? th.fg("dim", `[${unit.tier}]`) : "";
+        const modelLabel = th.fg("dim", shortenModel(unit.model));
+        const tierModelPart = [tierLabel, modelLabel].filter(Boolean).join(" ");
+        const line = `  ${time}  ${glyph} ${typeLabel} ${tierModelPart} ${idLabel} ${bar}  ${durStr}  ${costStr}`;
+        lines.push(truncateToWidth(line, width));
+    }
+    return lines;
+}
+function renderGanttView(data, th, width) {
+    const lines = [];
+    const recent = data.units.slice(-20);
+    if (recent.length === 0)
+        return lines;
+    const finishedUnits = recent.filter(u => u.finishedAt > 0);
+    if (finishedUnits.length === 0)
+        return renderTimelineList(data, th, width);
+    const minStart = Math.min(...recent.map(u => u.startedAt));
+    const maxEnd = Math.max(...recent.map(u => u.finishedAt > 0 ? u.finishedAt : Date.now()));
+    const totalSpan = maxEnd - minStart;
+    if (totalSpan <= 0)
+        return renderTimelineList(data, th, width);
+    const gutterWidth = 20;
+    const barArea = Math.max(10, width - gutterWidth - 25);
+    // Time axis labels
+    const startLabel = formatTimeLabel(minStart);
+    const endLabel = formatTimeLabel(maxEnd);
+    lines.push(`${" ".repeat(gutterWidth)} ${th.fg("dim", startLabel)}` +
+        `${" ".repeat(Math.max(1, barArea - startLabel.length - endLabel.length))}` +
+        `${th.fg("dim", endLabel)}`);
+    // Phase tracking for separators
+    let lastPhase = "";
+    for (const unit of recent) {
+        const phase = classifyUnitPhase(unit.type);
+        if (phase !== lastPhase && lastPhase !== "") {
+            lines.push(th.fg("dim", "  " + "\u2500".repeat(width - 4)));
+        }
+        lastPhase = phase;
+        const end = unit.finishedAt > 0 ? unit.finishedAt : Date.now();
+        const startPos = Math.round(((unit.startedAt - minStart) / totalSpan) * barArea);
+        const endPos = Math.round(((end - minStart) / totalSpan) * barArea);
+        const barLen = Math.max(1, endPos - startPos);
+        const phaseColor = phase === "research" ? "dim" :
+            phase === "planning" ? "accent" :
+                phase === "execution" ? "success" :
+                    "warning";
+        const barStr = " ".repeat(startPos) +
+            th.fg(phaseColor, "\u2588".repeat(barLen)) +
+            " ".repeat(Math.max(0, barArea - startPos - barLen));
+        const tierTag = unit.tier ? `[${unit.tier[0]}]` : "";
+        const gutter = padRight(truncateToWidth(`${unit.type.slice(0, 8)} ${unit.id}${tierTag}`, gutterWidth - 1), gutterWidth);
+        const duration = end - unit.startedAt;
+        const durStr = formatDuration(duration);
+        const costStr = formatCost(unit.cost);
+        lines.push(truncateToWidth(`${gutter}${barStr} ${durStr} ${costStr}`, width));
+    }
+    return lines;
+}
+function formatTimeLabel(ts) {
+    const dt = new Date(ts);
+    return `${String(dt.getHours()).padStart(2, "0")}:${String(dt.getMinutes()).padStart(2, "0")}`;
+}
+// ─── Agent View ──────────────────────────────────────────────────────────────
+export function renderAgentView(data, th, width) {
+    const lines = [];
+    const activity = data.agentActivity;
+    if (!activity) {
+        lines.push(th.fg("dim", "No agent activity data."));
+        return lines;
+    }
+    // Status line
+    const agentStatus = activity.active ? "active" : "pending";
+    const statusDot = th.fg(STATUS_COLOR[agentStatus], STATUS_GLYPH[agentStatus]);
+    const statusText = activity.active ? "ACTIVE" : "IDLE";
+    const elapsedStr = activity.active ? formatDuration(activity.elapsed) : "\u2014";
+    lines.push(joinColumns(`Status: ${statusDot} ${statusText}`, `Elapsed: ${elapsedStr}`, width));
+    if (activity.currentUnit) {
+        lines.push(`Current: ${th.fg("accent", `${activity.currentUnit.type} ${activity.currentUnit.id}`)}`);
+    }
+    else {
+        lines.push(th.fg("dim", "Not in auto mode"));
+    }
+    lines.push("");
+    // Progress bar
+    const completed = activity.completedUnits;
+    const total = Math.max(completed, activity.totalSlices);
+    if (total > 0) {
+        const pct = Math.min(1, completed / total);
+        const barW = Math.max(10, Math.min(30, width - 30));
+        const fillLen = Math.round(pct * barW);
+        const bar = th.fg("accent", "\u2588".repeat(fillLen)) +
+            th.fg("dim", "\u2591".repeat(barW - fillLen));
+        lines.push(`Progress ${bar} ${completed}/${total} slices`);
+    }
+    // Rate and session stats
+    const rateStr = activity.completionRate > 0
+        ? `${activity.completionRate.toFixed(1)} units/hr`
+        : "\u2014";
+    lines.push(`Rate: ${th.fg("text", rateStr)}    ` +
+        `Session: ${th.fg("text", formatCost(activity.sessionCost))}  ` +
+        `${th.fg("text", formatTokenCount(activity.sessionTokens))} tokens`);
+    lines.push("");
+    // Budget pressure
+    const health = data.health;
+    const truncColor = health.truncationRate < 10 ? "success" : health.truncationRate < 30 ? "warning" : "error";
+    const contColor = health.continueHereRate < 10 ? "success" : health.continueHereRate < 30 ? "warning" : "error";
+    lines.push(th.fg("accent", th.bold("Pressure")));
+    lines.push(`  Truncation rate: ${th.fg(truncColor, `${health.truncationRate.toFixed(1)}%`)}`);
+    lines.push(`  Continue-here rate: ${th.fg(contColor, `${health.continueHereRate.toFixed(1)}%`)}`);
+    // Pending captures
+    if (data.captures.pendingCount > 0) {
+        lines.push(`  Pending captures: ${th.fg("warning", String(data.captures.pendingCount))}`);
+    }
+    lines.push("");
+    // Recent completed units (last 5)
+    const recentUnits = data.units.filter(u => u.finishedAt > 0).slice(-5).reverse();
+    if (recentUnits.length > 0) {
+        lines.push(th.fg("accent", th.bold("Recent (last 5):")));
+        for (const u of recentUnits) {
+            const dt = new Date(u.startedAt);
+            const hh = String(dt.getHours()).padStart(2, "0");
+            const mm = String(dt.getMinutes()).padStart(2, "0");
+            const dur = formatDuration(u.finishedAt - u.startedAt);
+            const cost = formatCost(u.cost);
+            const typeLabel = padRight(u.type, 16);
+            lines.push(truncateToWidth(`  ${hh}:${mm}  ${th.fg(STATUS_COLOR.done, STATUS_GLYPH.done)} ${typeLabel} ${padRight(u.id, 16)} ${dur}  ${cost}`, width));
+        }
+    }
+    else {
+        lines.push(th.fg("dim", "No completed units yet."));
+    }
+    return lines;
+}
+// ─── Changelog View ──────────────────────────────────────────────────────────
+export function renderChangelogView(data, th, width) {
+    const lines = [];
+    const changelog = data.changelog;
+    if (changelog.entries.length === 0) {
+        lines.push(th.fg("dim", "No completed slices yet."));
+        return lines;
+    }
+    lines.push(th.fg("accent", th.bold("Changes")));
+    lines.push("");
+    for (const entry of changelog.entries) {
+        const header = `${entry.milestoneId}/${entry.sliceId}: ${entry.title}`;
+        lines.push(th.fg("success", header));
+        if (entry.oneLiner) {
+            lines.push(`  "${th.fg("text", entry.oneLiner)}"`);
+        }
+        if (entry.filesModified.length > 0) {
+            lines.push("  Files:");
+            for (const f of entry.filesModified) {
+                lines.push(truncateToWidth(`    ${th.fg(STATUS_COLOR.done, STATUS_GLYPH.done)} ${f.path} \u2014 ${f.description}`, width));
+            }
+        }
+        // Decisions and patterns from slice verification
+        const ver = findVerification(data, entry.milestoneId, entry.sliceId);
+        if (ver) {
+            if (ver.keyDecisions.length > 0) {
+                lines.push("  Decisions:");
+                for (const d of ver.keyDecisions) {
+                    lines.push(`    - ${d}`);
+                }
+            }
+            if (ver.patternsEstablished.length > 0) {
+                lines.push("  Patterns:");
+                for (const p of ver.patternsEstablished) {
+                    lines.push(`    - ${p}`);
+                }
+            }
+        }
+        if (entry.completedAt) {
+            lines.push(th.fg("dim", `  Completed: ${entry.completedAt}`));
+        }
+        lines.push("");
+    }
+    return lines;
+}
+// ─── Export View ─────────────────────────────────────────────────────────────
+export function renderExportView(_data, th, _width, lastExportPath) {
+    const lines = [];
+    lines.push(th.fg("accent", th.bold("Export Options")));
+    lines.push("");
+    lines.push(`  ${th.fg("accent", "[m]")}  Markdown report \u2014 full project summary with tables`);
+    lines.push(`  ${th.fg("accent", "[j]")}  JSON report \u2014 machine-readable project data`);
+    lines.push(`  ${th.fg("accent", "[s]")}  Snapshot \u2014 current view as plain text`);
+    if (lastExportPath) {
+        lines.push("");
+        lines.push(th.fg("dim", `Last export: ${lastExportPath}`));
+    }
+    return lines;
+}
+// ─── Knowledge View ──────────────────────────────────────────────────────────
+export function renderKnowledgeView(data, th, width) {
+    const lines = [];
+    const knowledge = data.knowledge;
+    if (!knowledge.exists) {
+        lines.push(th.fg("dim", "No KNOWLEDGE.md found"));
+        return lines;
+    }
+    if (knowledge.rules.length === 0 && knowledge.patterns.length === 0 && knowledge.lessons.length === 0) {
+        lines.push(th.fg("dim", "KNOWLEDGE.md exists but is empty"));
+        return lines;
+    }
+    // Rules section
+    if (knowledge.rules.length > 0) {
+        lines.push(th.fg("accent", th.bold("Rules")));
+        lines.push("");
+        for (const rule of knowledge.rules) {
+            lines.push(truncateToWidth(`  ${th.fg("accent", rule.id)}  ${th.fg("dim", `[${rule.scope}]`)}  ${rule.content}`, width));
+        }
+        lines.push("");
+    }
+    // Patterns section
+    if (knowledge.patterns.length > 0) {
+        lines.push(th.fg("accent", th.bold("Patterns")));
+        lines.push("");
+        for (const pattern of knowledge.patterns) {
+            lines.push(truncateToWidth(`  ${th.fg("accent", pattern.id)}  ${pattern.content}`, width));
+        }
+        lines.push("");
+    }
+    // Lessons section
+    if (knowledge.lessons.length > 0) {
+        lines.push(th.fg("accent", th.bold("Lessons Learned")));
+        lines.push("");
+        for (const lesson of knowledge.lessons) {
+            lines.push(truncateToWidth(`  ${th.fg("accent", lesson.id)}  ${lesson.content}`, width));
+        }
+        lines.push("");
+    }
+    return lines;
+}
+// ─── Captures View ───────────────────────────────────────────────────────────
+export function renderCapturesView(data, th, width) {
+    const lines = [];
+    const captures = data.captures;
+    // Summary line
+    const resolved = captures.entries.filter(e => e.status === "resolved").length;
+    lines.push(`${th.fg("text", String(captures.totalCount))} total \u00b7 ` +
+        `${th.fg("warning", String(captures.pendingCount))} pending \u00b7 ` +
+        `${th.fg("dim", String(resolved))} resolved`);
+    lines.push("");
+    if (captures.entries.length === 0) {
+        lines.push(th.fg("dim", "No captures recorded."));
+        return lines;
+    }
+    // Group by status: pending first, then triaged, then resolved
+    const statusOrder = { pending: 0, triaged: 1, resolved: 2 };
+    const sorted = [...captures.entries].sort((a, b) => (statusOrder[a.status] ?? 3) - (statusOrder[b.status] ?? 3));
+    for (const entry of sorted) {
+        const statusColor = entry.status === "pending" ? "warning" :
+            entry.status === "triaged" ? "accent" :
+                "dim";
+        const classColor = entry.classification === "inject" ? "warning" :
+            entry.classification === "quick-task" ? "accent" :
+                entry.classification === "replan" ? "error" :
+                    entry.classification === "defer" ? "text" :
+                        "dim";
+        const classBadge = entry.classification
+            ? th.fg(classColor, `(${entry.classification})`)
+            : "";
+        const statusBadge = th.fg(statusColor, `[${entry.status}]`);
+        const textPreview = truncateToWidth(entry.text, Math.max(20, width - 50));
+        lines.push(`  ${th.fg("accent", entry.id)} ${statusBadge} ${textPreview} ${classBadge}`);
+        if (entry.timestamp) {
+            lines.push(`    ${th.fg("dim", entry.timestamp)}`);
+        }
+    }
+    return lines;
+}
+// ─── Health View ─────────────────────────────────────────────────────────────
+export function renderHealthView(data, th, width) {
+    const lines = [];
+    const health = data.health;
+    // Budget section
+    lines.push(th.fg("accent", th.bold("Budget")));
+    lines.push("");
+    if (health.budgetCeiling !== undefined) {
+        const currentSpend = data.totals?.cost ?? 0;
+        const pct = health.budgetCeiling > 0 ? Math.min(1, currentSpend / health.budgetCeiling) : 0;
+        const barW = Math.max(10, Math.min(30, width - 40));
+        const fillLen = Math.round(pct * barW);
+        const budgetColor = pct < 0.7 ? "success" : pct < 0.9 ? "warning" : "error";
+        const bar = th.fg(budgetColor, "\u2588".repeat(fillLen)) +
+            th.fg("dim", "\u2591".repeat(barW - fillLen));
+        lines.push(`  Ceiling: ${th.fg("text", formatCost(health.budgetCeiling))}`);
+        lines.push(`  Spend:   ${bar} ${formatCost(currentSpend)} (${(pct * 100).toFixed(1)}%)`);
+    }
+    else {
+        lines.push(th.fg("dim", "  No budget ceiling set"));
+    }
+    lines.push(`  Token profile: ${th.fg("text", health.tokenProfile)}`);
+    lines.push("");
+    // Pressure section
+    lines.push(th.fg("accent", th.bold("Pressure")));
+    lines.push("");
+    const truncColor = health.truncationRate < 10 ? "success" : health.truncationRate < 30 ? "warning" : "error";
+    const contColor = health.continueHereRate < 10 ? "success" : health.continueHereRate < 30 ? "warning" : "error";
+    const pressBarW = Math.max(10, Math.min(20, width - 50));
+    const truncFill = Math.round((Math.min(health.truncationRate, 100) / 100) * pressBarW);
+    const truncBar = th.fg(truncColor, "\u2588".repeat(truncFill)) + th.fg("dim", "\u2591".repeat(pressBarW - truncFill));
+    lines.push(`  Truncation:    ${truncBar} ${health.truncationRate.toFixed(1)}%`);
+    const contFill = Math.round((Math.min(health.continueHereRate, 100) / 100) * pressBarW);
+    const contBar = th.fg(contColor, "\u2588".repeat(contFill)) + th.fg("dim", "\u2591".repeat(pressBarW - contFill));
+    lines.push(`  Continue-here: ${contBar} ${health.continueHereRate.toFixed(1)}%`);
+    lines.push("");
+    // Routing section
+    if (health.tierBreakdown.length > 0) {
+        lines.push(th.fg("accent", th.bold("Routing")));
+        lines.push("");
+        for (const tier of health.tierBreakdown) {
+            const downTag = tier.downgraded > 0 ? th.fg("warning", ` (${tier.downgraded} downgraded)`) : "";
+            lines.push(`  ${padRight(tier.tier, 12)} ${tier.units} units  ${formatCost(tier.cost)}${downTag}`);
+        }
+        if (health.tierSavingsLine) {
+            lines.push(`  ${th.fg("success", health.tierSavingsLine)}`);
+        }
+        lines.push("");
+    }
+    // Session section
+    lines.push(th.fg("accent", th.bold("Session")));
+    lines.push("");
+    lines.push(`  Tool calls: ${th.fg("text", String(health.toolCalls))}`);
+    lines.push(`  Messages: ${th.fg("text", String(health.assistantMessages))} sent / ${th.fg("text", String(health.userMessages))} received`);
+    // Environment section — issues only (from doctor-environment.ts, #1221)
+    if (health.environmentIssues?.length > 0) {
+        lines.push("");
+        lines.push(th.fg("accent", th.bold("Environment")));
+        lines.push("");
+        for (const r of health.environmentIssues) {
+            const icon = r.status === "error" ? th.fg("error", "✗") : th.fg("warning", "⚠");
+            lines.push(`  ${icon} ${th.fg("text", r.message)}`);
+            if (r.detail)
+                lines.push(`    ${th.fg("dim", r.detail)}`);
+        }
+    }
+    // Providers section
+    if (health.providers?.length > 0) {
+        lines.push("");
+        lines.push(th.fg("accent", th.bold("Providers")));
+        lines.push("");
+        const categoryOrder = ["llm", "remote", "search", "tool"];
+        const categoryLabels = { llm: "LLM", remote: "Notifications", search: "Search", tool: "Tools" };
+        const grouped = new Map();
+        for (const p of health.providers) {
+            const cat = p.category;
+            if (!grouped.has(cat))
+                grouped.set(cat, []);
+            grouped.get(cat).push(p);
+        }
+        for (const cat of categoryOrder) {
+            const items = grouped.get(cat);
+            if (!items || items.length === 0)
+                continue;
+            lines.push(`  ${th.fg("dim", categoryLabels[cat] ?? cat)}`);
+            for (const p of items) {
+                const icon = p.ok ? th.fg("success", "✓") : th.fg("error", "✗");
+                const msg = p.ok ? th.fg("dim", p.message) : th.fg("text", p.message);
+                lines.push(`    ${icon} ${msg}`);
+            }
+        }
+    }
+    // Skills section
+    if (health.skillSummary?.total > 0) {
+        lines.push("");
+        lines.push(th.fg("accent", th.bold("Skills")));
+        lines.push("");
+        const { total, warningCount, criticalCount, topIssue } = health.skillSummary;
+        const issueColor = criticalCount > 0 ? "error" : warningCount > 0 ? "warning" : "success";
+        const issueTag = criticalCount > 0
+            ? `${criticalCount} critical`
+            : warningCount > 0
+                ? `${warningCount} warning${warningCount > 1 ? "s" : ""}`
+                : "all healthy";
+        lines.push(`  ${th.fg("text", String(total))} skills tracked  ·  ${th.fg(issueColor, issueTag)}`);
+        if (topIssue)
+            lines.push(`  ${th.fg("warning", "⚠")} ${th.fg("dim", topIssue)}`);
+        lines.push(`  ${th.fg("dim", "→ /gsd skill-health for full report")}`);
+    }
+    return lines;
+}