@openrig/cli 0.4.4 → 0.4.6

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

@@ -0,0 +1,71 @@
+import type { DaemonClient } from "../client.js";
+/**
+ * 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 declare const EXIT_WORKFLOW_FAILED = 3;
+export interface FollowInstanceView {
+    instanceId: string;
+    workflowName?: string;
+    status: string;
+    currentStepId?: string | null;
+    currentFrontier?: string[];
+}
+export interface FollowTrailRow {
+    stepId: string;
+    stepRole?: string;
+    closedAt?: string;
+    closureReason: string;
+    actorSession: string;
+    nextQitemId?: string | null;
+    priorQitemId: string;
+}
+export interface FollowIo {
+    /** stdout line sink (tests inject; default console.log). */
+    out: (line: string) => void;
+    /** stderr line sink for honest transport-state notices. */
+    err: (line: string) => void;
+    /** sleep injection so tests never wait wall-clock. */
+    sleep: (ms: number) => Promise<void>;
+    /** fetch injection for the SSE leg (tests stub the stream). */
+    fetchImpl: typeof fetch;
+}
+export declare function realFollowIo(): FollowIo;
+export interface FollowOptions {
+    json: boolean;
+    io?: FollowIo;
+    /** SSE reconnect attempts before degrading to the poll fallback. */
+    maxReconnects?: number;
+    /** Poll fallback interval (ms). */
+    pollIntervalMs?: number;
+}
+/** Outcome → process exit code, per the FR-1 contract. */
+export declare function outcomeExitCode(status: string): number;
+/**
+ * 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 declare function followInstance(client: DaemonClient, instanceId: string, opts: FollowOptions): Promise<number>;
+//# sourceMappingURL=workflow-follow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-follow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow-follow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAKtC,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAiBD,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,2DAA2D;IAC3D,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,sDAAsD;IACtD,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,+DAA+D;IAC/D,SAAS,EAAE,OAAO,KAAK,CAAC;CACzB;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAOvC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAsCD,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAiCD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,MAAM,CAAC,CAiGjB"}

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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"}