@openrig/cli 0.4.4 → 0.4.7

package/dist/commands/workflow-follow.js

@@ -0,0 +1,259 @@
+/**
+ * OPR.0.4.6.WF3 FR-1 — the shared follow engine behind `rig workflow
+ * run` and `rig workflow watch`: two verbs, ONE renderer (the argo
+ * shape: same render at attach and live).
+ *
+ * Transport: the SHIPPED workflow SSE endpoint (`GET
+ * /api/workflow/sse`) consumed with the in-repo chatroom reader
+ * pattern (fetch + event-stream line decode). Zero daemon changes
+ * (BR-2) — this file only reads.
+ *
+ * Attach race (arch R2, snapshot-first-then-stream): the stream is
+ * OPENED first, then a state snapshot (`/trace`) is rendered, then
+ * live events flow. Events that duplicate a trail row already in the
+ * snapshot are deduped by priorQitemId, so fast early steps that
+ * close before attach are still shown exactly once.
+ *
+ * Exit codes (arch n1 — outcome codes DISTINCT from error codes):
+ *   0 = workflow completed
+ *   3 = workflow FAILED (the outcome-as-exit-code kubectl default —
+ *       a workflow that fails is a command that fails; never collides
+ *       with the shipped 1=4xx / 2=5xx transport codes)
+ */
+export const EXIT_WORKFLOW_FAILED = 3;
+/** Terminal statuses a follow run resolves on. */
+const TERMINAL_STATUSES = new Set(["completed", "failed"]);
+export function realFollowIo() {
+    return {
+        out: (line) => console.log(line),
+        err: (line) => process.stderr.write(`${line}\n`),
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        fetchImpl: fetch,
+    };
+}
+const STATUS_GLYPH = {
+    completed: "✔",
+    failed: "✖",
+    active: "●",
+    waiting: "◐",
+};
+function glyphFor(status) {
+    return STATUS_GLYPH[status] ?? "●";
+}
+function renderTrailRow(row) {
+    const exitGlyph = row.closureReason === "failed" ? "✖" : "✔";
+    const next = row.nextQitemId ? ` → ${row.nextQitemId}` : "";
+    return `  ${exitGlyph} ${row.stepId}  ${row.closureReason}  by ${row.actorSession}${next}`;
+}
+function renderEvent(event) {
+    switch (event.type) {
+        case "workflow.instantiated":
+            return `  ● instance ${event.instanceId ?? ""} created${event.workflowName ? ` (${event.workflowName})` : ""}`;
+        case "workflow.step_closed":
+            return `  ${event.closureReason === "failed" ? "✖" : "✔"} ${event.stepId ?? "(step)"}  ${event.closureReason ?? ""}  by ${event.actorSession ?? "(unknown)"}`;
+        case "workflow.next_qitem_projected":
+            return `  → ${event.nextStepId ?? "(next)"}  owner ${event.nextOwner ?? "(unresolved)"}  packet ${event.nextQitemId ?? ""}`;
+        case "workflow.completed":
+            return `  ✔ workflow completed`;
+        case "workflow.failed":
+            return `  ✖ workflow FAILED: ${event.reason ?? "(no reason recorded)"}`;
+        default:
+            // routing_table_changed and future additive types render as a
+            // neutral one-liner rather than being silently dropped.
+            return `  · ${event.type}`;
+    }
+}
+/** Outcome → process exit code, per the FR-1 contract. */
+export function outcomeExitCode(status) {
+    if (status === "failed")
+        return EXIT_WORKFLOW_FAILED;
+    return 0;
+}
+async function fetchSnapshot(client, instanceId) {
+    const res = await client.get(`/api/workflow/${encodeURIComponent(instanceId)}/trace`);
+    if (res.status >= 400 || !res.data?.instance) {
+        return { ok: false, status: res.status, body: res.data };
+    }
+    return { ok: true, snapshot: { instance: res.data.instance, trail: res.data.trail ?? [] } };
+}
+function renderSnapshot(snapshot, io, json) {
+    if (json) {
+        io.out(JSON.stringify({ type: "snapshot", instance: snapshot.instance, trail: snapshot.trail }));
+        return;
+    }
+    const inst = snapshot.instance;
+    io.out(`${glyphFor(inst.status)} ${inst.instanceId}${inst.workflowName ? `  ${inst.workflowName}` : ""}  status=${inst.status}`);
+    for (const row of snapshot.trail)
+        io.out(renderTrailRow(row));
+    if (inst.currentStepId) {
+        io.out(`  ▸ at step ${inst.currentStepId}  frontier=[${(inst.currentFrontier ?? []).join(", ")}]`);
+    }
+}
+/**
+ * Follow one instance to a terminal state. Returns the exit code the
+ * caller should set (0 completed / 3 failed / 1 transport-4xx / 2
+ * transport-5xx). Never throws for stream drops — those degrade
+ * honestly (reconnect notice → poll-fallback notice), per the
+ * chatroom precedent: the render may fall back, it never freezes
+ * silently.
+ */
+export async function followInstance(client, instanceId, opts) {
+    const io = opts.io ?? realFollowIo();
+    const maxReconnects = opts.maxReconnects ?? 3;
+    const pollIntervalMs = opts.pollIntervalMs ?? 3000;
+    // Walk-caught (VM iteration 2): without aborting the SSE connection
+    // on return, the open socket keeps the node event loop alive and the
+    // process hangs ~minutes after the terminal event before exiting —
+    // a kubectl-style verb must exit PROMPTLY on outcome. Every return
+    // path aborts via the finally below.
+    const aborter = new AbortController();
+    try {
+        // 1. Open the stream FIRST (arch R2) so no event can fall between
+        //    snapshot and attach. Events are buffered by the reader until
+        //    the snapshot has rendered.
+        const sseUrl = `${client.baseUrl}/api/workflow/sse`;
+        let streamRes = null;
+        try {
+            streamRes = await io.fetchImpl(sseUrl, {
+                headers: { Accept: "text/event-stream" },
+                signal: aborter.signal,
+            });
+            if (!streamRes.ok || !streamRes.body)
+                streamRes = null;
+        }
+        catch {
+            streamRes = null;
+        }
+        // 2. Snapshot + render.
+        const snap = await fetchSnapshot(client, instanceId);
+        if (!snap.ok) {
+            io.out(JSON.stringify(snap.body ?? { error: "trace_failed" }, null, opts.json ? 0 : 2));
+            return snap.status >= 500 ? 2 : 1;
+        }
+        renderSnapshot(snap.snapshot, io, opts.json);
+        if (TERMINAL_STATUSES.has(snap.snapshot.instance.status)) {
+            return outcomeExitCode(snap.snapshot.instance.status);
+        }
+        // Dedup guard: trail rows already rendered by the snapshot must not
+        // re-render when the (already-open) stream replays their events.
+        const seenClosures = new Set(snap.snapshot.trail.map((row) => row.priorQitemId));
+        let reconnectsLeft = maxReconnects;
+        // 3. Stream loop with honest degradation.
+        while (true) {
+            if (streamRes?.body) {
+                const outcome = await consumeStream(streamRes.body, instanceId, seenClosures, io, opts.json);
+                if (outcome !== null)
+                    return outcome;
+                // Stream ended without a terminal event — the drop path.
+                streamRes = null;
+            }
+            if (reconnectsLeft > 0) {
+                reconnectsLeft -= 1;
+                io.err(`stream dropped — reconnecting (${maxReconnects - reconnectsLeft}/${maxReconnects})`);
+                try {
+                    const retry = await io.fetchImpl(sseUrl, {
+                        headers: { Accept: "text/event-stream" },
+                        signal: aborter.signal,
+                    });
+                    if (retry.ok && retry.body) {
+                        streamRes = retry;
+                        continue;
+                    }
+                }
+                catch {
+                    // fall through to next reconnect / poll fallback
+                }
+                continue;
+            }
+            // 4. Poll fallback — announced, never silent (the chatroom rule).
+            io.err(`stream unavailable — degrading to poll fallback every ${Math.round(pollIntervalMs / 1000)}s`);
+            while (true) {
+                await io.sleep(pollIntervalMs);
+                const poll = await fetchSnapshot(client, instanceId);
+                if (!poll.ok) {
+                    io.out(JSON.stringify(poll.body ?? { error: "poll_failed" }, null, opts.json ? 0 : 2));
+                    return poll.status >= 500 ? 2 : 1;
+                }
+                // Render only trail rows not yet seen, preserving exactly-once.
+                for (const row of poll.snapshot.trail) {
+                    if (seenClosures.has(row.priorQitemId))
+                        continue;
+                    seenClosures.add(row.priorQitemId);
+                    if (opts.json)
+                        io.out(JSON.stringify({ type: "trail", row }));
+                    else
+                        io.out(renderTrailRow(row));
+                }
+                if (TERMINAL_STATUSES.has(poll.snapshot.instance.status)) {
+                    if (opts.json)
+                        io.out(JSON.stringify({ type: "terminal", status: poll.snapshot.instance.status }));
+                    else
+                        io.out(`  ${glyphFor(poll.snapshot.instance.status)} workflow ${poll.snapshot.instance.status}`);
+                    return outcomeExitCode(poll.snapshot.instance.status);
+                }
+            }
+        }
+    }
+    finally {
+        // Kill the SSE socket so the process exits promptly on outcome
+        // (the walk-caught hang: an un-aborted keep-alive held the event
+        // loop open for minutes after workflow.completed).
+        aborter.abort();
+    }
+}
+/**
+ * Consume one SSE body until a terminal event for the instance (→
+ * exit code) or stream end (→ null: caller reconnects/degrades).
+ */
+async function consumeStream(body, instanceId, seenClosures, io, json) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                return null;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.startsWith("data:"))
+                    continue;
+                let event;
+                try {
+                    event = JSON.parse(line.slice(5).trim());
+                }
+                catch {
+                    continue; // malformed data line — skip (chatroom precedent)
+                }
+                if (event.instanceId !== instanceId)
+                    continue;
+                if (event.type === "workflow.step_closed" && typeof event.priorQitemId === "string") {
+                    if (seenClosures.has(event.priorQitemId))
+                        continue; // snapshot already showed it
+                    seenClosures.add(event.priorQitemId);
+                }
+                if (json) {
+                    io.out(JSON.stringify(event));
+                }
+                else {
+                    const rendered = renderEvent(event);
+                    if (rendered !== null)
+                        io.out(rendered);
+                }
+                if (event.type === "workflow.completed")
+                    return 0;
+                if (event.type === "workflow.failed")
+                    return EXIT_WORKFLOW_FAILED;
+            }
+        }
+    }
+    catch {
+        return null; // read error = drop; caller handles honestly
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=workflow-follow.js.map

package/dist/commands/workflow-follow.js.map

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

package/dist/commands/workflow-render.d.ts

@@ -0,0 +1,114 @@
+/**
+ * OPR.0.4.6.WF3 FR-2 — the glanceable human renderers for
+ * trace/list/show. RENDER-SIDE ONLY (BR-2): these functions format
+ * daemon payloads the CLI already receives; `--json` paths never come
+ * through here and stay byte-identical to the shipped output.
+ *
+ * Shapes ported from in-repo precedent: the `rig ps` table mechanics
+ * (fitCell/truncate) and the argo-get per-step tree bar (STEP / ACTOR
+ * / EXIT / DURATION columns with status glyphs).
+ *
+ * Present-tolerant fields: WF-2's branch/gate additions
+ * (closureEvidence.branch_taken etc.) render when the payload carries
+ * them and leave no residue when absent — this module never requires
+ * them (WF-3 builds against the pre-WF-2 tip; the fields land with
+ * WF-2).
+ */
+export interface RenderInstance {
+    instanceId: string;
+    workflowName?: string;
+    workflowVersion?: string;
+    status: string;
+    createdBySession?: string;
+    createdAt?: string;
+    currentStepId?: string | null;
+    currentFrontier?: string[];
+    hopCount?: number;
+    /** OPR.0.4.6.FAC1: the instance's bound rig (API-carried; null/absent = unbound, renders nothing). */
+    boundRig?: string | null;
+    /**
+     * WF-1 FR-2's API-carried classification (present since the
+     * completion fixback at 384e60f1). RAIL 1 (arch ruling): the CLI
+     * CONSUMES this verbatim and never recomputes a threshold or class.
+     */
+    deadline?: {
+        state: string;
+        evidence?: {
+            stepId?: string | null;
+            ownerSession?: string;
+            overdueBySeconds?: number;
+            ageSeconds?: number;
+        } | null;
+    };
+    /** Present on waiting instances that recorded their park decision. */
+    lastContinuationDecision?: {
+        blockedOn?: string | null;
+    } | null;
+}
+export interface RenderTrailRow {
+    stepId: string;
+    stepRole?: string;
+    closedAt?: string;
+    closureReason: string;
+    closureEvidence?: Record<string, unknown> | null;
+    actorSession: string;
+    nextQitemId?: string | null;
+    priorQitemId?: string;
+}
+export declare function statusGlyph(status: string): string;
+/** Compact human duration between two ISO timestamps ("3s", "4m", "2h", "5d"). */
+export declare function humanDuration(fromIso: string | undefined, toIso: string | undefined): string;
+/** Instance age relative to a supplied "now" (injectable for tests). */
+export declare function humanAge(createdAt: string | undefined, nowIso: string): string;
+/** Compact render of a plain seconds quantity (same scale rules). */
+export declare function humanSeconds(seconds: number): string;
+/**
+ * The trace tree (mini-req 2's bar: where it is + how it got there,
+ * one screen, no JSON literacy required).
+ */
+export declare function renderTraceTree(instance: RenderInstance, trail: RenderTrailRow[], nowIso?: string): string[];
+/**
+ * OPR.0.4.6.WF3 FR-3 — the attention marker for a list row (the
+ * single marker home). Classes: failed · stuck (consumed VERBATIM
+ * from the API-carried deadline classification — rail 1: the CLI
+ * never recomputes a threshold or class) · waiting. A row shows its
+ * highest-priority class; the `status` verb shows ALL classes per
+ * instance (exactly-once, combined reasons).
+ */
+export declare function attentionMarker(instance: RenderInstance): string;
+export interface AttentionRow {
+    instanceId: string;
+    workflowName: string;
+    /** All classes for this instance — exactly-once row, combined. */
+    classes: string[];
+    reasons: string[];
+    /** The actionable affordance (what-to-do-next), per class priority. */
+    affordance: string;
+}
+export interface AttentionRollup {
+    counts: {
+        total: number;
+        active: number;
+        waiting: number;
+        completed: number;
+        failed: number;
+    };
+    attention: AttentionRow[];
+}
+/**
+ * Compose the rollup from list rows. Pure arithmetic over
+ * pre-classified rows (the arch ruling's boundary: counting +
+ * grouping + rendering is render-side; the ONE correctness-rule
+ * composition — the threshold classification — arrives ALREADY DONE
+ * in instance.deadline). Per-instance dedup by instanceId (rail 2):
+ * an instance with multiple attention reasons renders ONCE with all
+ * of them.
+ */
+export declare function composeAttentionRollup(instances: RenderInstance[]): AttentionRollup;
+/** Human render of the rollup — proven-empty, never blank. */
+export declare function renderStatus(rollup: AttentionRollup): string[];
+/** The list table: INSTANCE · WORKFLOW · STATUS · STEP · AGE · ATTN. */
+export declare function renderInstanceList(instances: RenderInstance[], nowIso?: string): string[];
+/** The show summary, headed by the status line. */
+export declare function renderInstanceShow(instance: RenderInstance, nowIso?: string): string[];
+//# sourceMappingURL=workflow-render.d.ts.map

package/dist/commands/workflow-render.d.ts.map

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

package/dist/commands/workflow-render.js

@@ -0,0 +1,223 @@
+/**
+ * OPR.0.4.6.WF3 FR-2 — the glanceable human renderers for
+ * trace/list/show. RENDER-SIDE ONLY (BR-2): these functions format
+ * daemon payloads the CLI already receives; `--json` paths never come
+ * through here and stay byte-identical to the shipped output.
+ *
+ * Shapes ported from in-repo precedent: the `rig ps` table mechanics
+ * (fitCell/truncate) and the argo-get per-step tree bar (STEP / ACTOR
+ * / EXIT / DURATION columns with status glyphs).
+ *
+ * Present-tolerant fields: WF-2's branch/gate additions
+ * (closureEvidence.branch_taken etc.) render when the payload carries
+ * them and leave no residue when absent — this module never requires
+ * them (WF-3 builds against the pre-WF-2 tip; the fields land with
+ * WF-2).
+ */
+const STATUS_GLYPH = {
+    completed: "✔",
+    failed: "✖",
+    active: "●",
+    waiting: "◐",
+};
+export function statusGlyph(status) {
+    return STATUS_GLYPH[status] ?? "●";
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+function fitCell(value, width) {
+    return truncate(value, width).padEnd(width);
+}
+/** Compact human duration between two ISO timestamps ("3s", "4m", "2h", "5d"). */
+export function humanDuration(fromIso, toIso) {
+    if (!fromIso || !toIso)
+        return "";
+    const ms = Date.parse(toIso) - Date.parse(fromIso);
+    if (!Number.isFinite(ms) || ms < 0)
+        return "";
+    const s = Math.round(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.round(s / 60);
+    // Minutes render up to AND INCLUDING 120 so sub-/at-2h durations keep
+    // their precision ("90m"/"120m" beat a rounded-up "2h" for judging
+    // step latency). Guard prepass catch: `m < 120` excluded exactly 120.
+    if (m <= 120)
+        return `${m}m`;
+    const h = Math.round(m / 60);
+    if (h < 48)
+        return `${h}h`;
+    return `${Math.round(h / 24)}d`;
+}
+/** Instance age relative to a supplied "now" (injectable for tests). */
+export function humanAge(createdAt, nowIso) {
+    return humanDuration(createdAt, nowIso);
+}
+/** Compact render of a plain seconds quantity (same scale rules). */
+export function humanSeconds(seconds) {
+    return humanDuration("1970-01-01T00:00:00.000Z", new Date(seconds * 1000).toISOString());
+}
+/**
+ * The trace tree (mini-req 2's bar: where it is + how it got there,
+ * one screen, no JSON literacy required).
+ */
+export function renderTraceTree(instance, trail, nowIso = new Date().toISOString()) {
+    const lines = [];
+    const name = instance.workflowName ? `${instance.workflowName}${instance.workflowVersion ? ` v${instance.workflowVersion}` : ""}` : "";
+    lines.push(`${statusGlyph(instance.status)} ${instance.instanceId}  ${name}  status=${instance.status}${instance.hopCount !== undefined ? `  hops=${instance.hopCount}` : ""}${instance.boundRig ? `  rig=${instance.boundRig}` : ""}`);
+    if (instance.createdAt) {
+        lines.push(`  created ${instance.createdAt}${instance.createdBySession ? ` by ${instance.createdBySession}` : ""}  age ${humanAge(instance.createdAt, nowIso)}`);
+    }
+    lines.push("");
+    lines.push(`  ${fitCell("STEP", 22)}${fitCell("ACTOR", 28)}${fitCell("EXIT", 10)}DURATION`);
+    let prevClosed = instance.createdAt;
+    for (let i = 0; i < trail.length; i++) {
+        const row = trail[i];
+        if (!row)
+            continue;
+        const glyph = row.closureReason === "failed" ? "✖" : "✔";
+        const bar = i === trail.length - 1 && !instance.currentStepId ? "└─" : "├─";
+        const duration = humanDuration(prevClosed, row.closedAt);
+        lines.push(`  ${bar} ${glyph} ${fitCell(row.stepId, 20)}${fitCell(row.actorSession, 28)}${fitCell(row.closureReason, 10)}${duration}`);
+        const branchTaken = row.closureEvidence?.["branch_taken"];
+        if (typeof branchTaken === "string" && branchTaken.length > 0) {
+            lines.push(`  │    ↳ branch: ${branchTaken}`);
+        }
+        prevClosed = row.closedAt ?? prevClosed;
+    }
+    if (instance.currentStepId) {
+        const owner = ""; // frontier owner is a queue-side fact; the frontier packet ids are what the payload carries
+        lines.push(`  └─ ▸ ${fitCell(instance.currentStepId, 20)}${fitCell(owner || "(current)", 28)}${fitCell("open", 10)}frontier=[${(instance.currentFrontier ?? []).join(", ")}]`);
+    }
+    else if (trail.length === 0) {
+        lines.push(`  (no steps closed yet)`);
+    }
+    return lines;
+}
+/**
+ * OPR.0.4.6.WF3 FR-3 — the attention marker for a list row (the
+ * single marker home). Classes: failed · stuck (consumed VERBATIM
+ * from the API-carried deadline classification — rail 1: the CLI
+ * never recomputes a threshold or class) · waiting. A row shows its
+ * highest-priority class; the `status` verb shows ALL classes per
+ * instance (exactly-once, combined reasons).
+ */
+export function attentionMarker(instance) {
+    if (instance.status === "failed")
+        return "▲ failed";
+    if (isStuck(instance))
+        return "▲ stuck";
+    if (instance.status === "waiting")
+        return "▲ waiting";
+    return "";
+}
+/** Rail 1: stuck-ness is READ from the API field, never derived. */
+function isStuck(instance) {
+    const state = instance.deadline?.state;
+    return typeof state === "string" && state.startsWith("overdue");
+}
+/**
+ * Compose the rollup from list rows. Pure arithmetic over
+ * pre-classified rows (the arch ruling's boundary: counting +
+ * grouping + rendering is render-side; the ONE correctness-rule
+ * composition — the threshold classification — arrives ALREADY DONE
+ * in instance.deadline). Per-instance dedup by instanceId (rail 2):
+ * an instance with multiple attention reasons renders ONCE with all
+ * of them.
+ */
+export function composeAttentionRollup(instances) {
+    const counts = { total: instances.length, active: 0, waiting: 0, completed: 0, failed: 0 };
+    const attention = [];
+    for (const inst of instances) {
+        if (inst.status === "active")
+            counts.active += 1;
+        else if (inst.status === "waiting")
+            counts.waiting += 1;
+        else if (inst.status === "completed")
+            counts.completed += 1;
+        else if (inst.status === "failed")
+            counts.failed += 1;
+        const classes = [];
+        const reasons = [];
+        if (inst.status === "failed") {
+            classes.push("failed");
+            reasons.push("workflow failed");
+        }
+        if (isStuck(inst)) {
+            classes.push("stuck");
+            const ev = inst.deadline?.evidence;
+            reasons.push(`${inst.deadline?.state}${ev?.stepId ? ` at step ${ev.stepId}` : ""}${ev?.ownerSession ? ` (owner ${ev.ownerSession})` : ""}${typeof ev?.overdueBySeconds === "number" ? `, overdue ${humanSeconds(ev.overdueBySeconds)}` : ""}`);
+        }
+        if (inst.status === "waiting") {
+            classes.push("waiting");
+            const blocker = inst.lastContinuationDecision?.blockedOn;
+            reasons.push(`waiting${blocker ? ` on ${blocker}` : " (blocker unrecorded)"}`);
+        }
+        if (classes.length === 0)
+            continue;
+        // Affordance by highest-priority class. `route` ships in this same
+        // slice (commit 6) — the verbs land together at merge (BR-1 holds
+        // at the shipped boundary).
+        const affordance = classes.includes("failed")
+            ? `inspect: rig workflow trace ${inst.instanceId}`
+            : classes.includes("stuck")
+                ? `re-route: rig workflow route ${inst.instanceId} --to <seat>`
+                : `resolve the blocker, then the owner projects (rig workflow trace ${inst.instanceId})`;
+        attention.push({
+            instanceId: inst.instanceId,
+            workflowName: inst.workflowName ?? "",
+            classes,
+            reasons,
+            affordance,
+        });
+    }
+    return { counts, attention };
+}
+/** Human render of the rollup — proven-empty, never blank. */
+export function renderStatus(rollup) {
+    const c = rollup.counts;
+    const lines = [];
+    lines.push(`${c.total} instance${c.total === 1 ? "" : "s"}: ${c.active} active · ${c.waiting} waiting · ${c.completed} completed · ${c.failed} failed`);
+    if (rollup.attention.length === 0) {
+        lines.push("No instances need attention (proven empty — every in-flight instance reads healthy).");
+        return lines;
+    }
+    lines.push("");
+    lines.push(`${fitCell("", 2)}${fitCell("INSTANCE", 30)}${fitCell("WORKFLOW", 20)}${fitCell("CLASS", 16)}REASON`);
+    for (const row of rollup.attention) {
+        lines.push(`${fitCell("▲", 2)}${fitCell(row.instanceId, 30)}${fitCell(row.workflowName, 20)}${fitCell(row.classes.join("+"), 16)}${row.reasons.join("; ")}`);
+        lines.push(`  ${fitCell("", 2)}└ ${row.affordance}`);
+    }
+    return lines;
+}
+/** The list table: INSTANCE · WORKFLOW · STATUS · STEP · AGE · ATTN. */
+export function renderInstanceList(instances, nowIso = new Date().toISOString()) {
+    if (instances.length === 0)
+        return ["No workflow instances."];
+    const lines = [];
+    lines.push(`${fitCell("", 2)}${fitCell("INSTANCE", 30)}${fitCell("WORKFLOW", 22)}${fitCell("STATUS", 11)}${fitCell("STEP", 20)}${fitCell("AGE", 6)}ATTN`);
+    for (const inst of instances) {
+        lines.push(`${fitCell(statusGlyph(inst.status), 2)}${fitCell(inst.instanceId, 30)}${fitCell(inst.workflowName ?? "", 22)}${fitCell(inst.status, 11)}${fitCell(inst.currentStepId ?? "-", 20)}${fitCell(humanAge(inst.createdAt, nowIso), 6)}${attentionMarker(inst)}`);
+    }
+    return lines;
+}
+/** The show summary, headed by the status line. */
+export function renderInstanceShow(instance, nowIso = new Date().toISOString()) {
+    const lines = [];
+    lines.push(`${statusGlyph(instance.status)} ${instance.instanceId}  status=${instance.status}`);
+    if (instance.workflowName)
+        lines.push(`  workflow: ${instance.workflowName}${instance.workflowVersion ? ` v${instance.workflowVersion}` : ""}`);
+    // OPR.0.4.6.FAC1: the bound rig renders when present (unbound rows unchanged).
+    if (instance.boundRig)
+        lines.push(`  rig:      ${instance.boundRig}`);
+    if (instance.createdAt)
+        lines.push(`  created:  ${instance.createdAt}${instance.createdBySession ? ` by ${instance.createdBySession}` : ""}  (age ${humanAge(instance.createdAt, nowIso)})`);
+    if (instance.currentStepId)
+        lines.push(`  at step:  ${instance.currentStepId}  frontier=[${(instance.currentFrontier ?? []).join(", ")}]`);
+    if (instance.hopCount !== undefined)
+        lines.push(`  hops:     ${instance.hopCount}`);
+    lines.push(`  next:     rig workflow trace ${instance.instanceId}`);
+    return lines;
+}
+//# sourceMappingURL=workflow-render.js.map

package/dist/commands/workflow-render.js.map

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

package/dist/commands/workflow.d.ts

@@ -22,5 +22,6 @@ export declare const PROJECT_EXIT_KINDS: readonly ["handoff", "waiting", "done",
 export type ProjectExitKind = (typeof PROJECT_EXIT_KINDS)[number];
 export declare function isProjectExitKind(value: unknown): value is ProjectExitKind;
 export declare function printOutcomeSummary(json: boolean, status: number, summary: OutcomeSummary | null): void;
+export declare function printWorkflowAdvisories(advisories: string[] | undefined): void;
 export declare function workflowCommand(depsOverride?: WorkflowDeps): Command;
 //# sourceMappingURL=workflow.d.ts.map

package/dist/commands/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAa,SAAQ,UAAU;CAAG;AA6BnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,eAAO,MAAM,kBAAkB,mDAAoD,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAMvG;AAMD,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAkTpE"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW9C;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAa,SAAQ,UAAU;CAAG;AAwCnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,eAAO,MAAM,kBAAkB,mDAAoD,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAMvG;AAYD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAK9E;AAED,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CA8jBpE"}