stageflow 0.3.0 → 0.9.0

package/dist/cli/runCommand.d.ts

@@ -1,6 +1,7 @@
+import type { RunStore } from "../runstore/port.js";
 import { type StartRunResult } from "../runtime/runManager.js";
 import { type CliRunReportIo } from "./runOutput.js";
-export declare const RUN_USAGE = "Usage:\n  sf run --task <path> --pipeline <path> [--checkout <path>] [--json] [--skip-gates] [--git-sha <sha>] [--ci-pr-url <url>] [--ci-job-url <url>] [--operator-cwd <path>] [--operator-agent-dir <path>]";
+export declare const RUN_USAGE = "Usage:\n  sf run --task <path> --pipeline <path> [--checkout <path>] [--json] [--include stages] [--skip-gates] [--git-sha <sha>] [--ci-pr-url <url>] [--ci-job-url <url>] [--operator-cwd <path>] [--operator-agent-dir <path>]";
 export type RunCommandIo = CliRunReportIo;
 export type StartRunFn = (input: {
     task: string;
@@ -15,6 +16,8 @@ export declare function completeCliRun(started: Extract<StartRunResult, {
     ok: true;
 }>, io?: RunCommandIo, options?: {
     json?: boolean;
+    store?: RunStore;
+    includeStages?: boolean;
 }): Promise<number>;
 export declare function runRunCommand(args: string[], options?: {
     cwd?: string;
@@ -22,5 +25,6 @@ export declare function runRunCommand(args: string[], options?: {
     isGitProject?: boolean;
     io?: Partial<RunCommandIo>;
     startRun?: StartRunFn;
+    store?: RunStore;
     env?: Record<string, string | undefined>;
 }): Promise<number>;

package/dist/cli/runCommand.js

@@ -8,17 +8,17 @@ import { resolveCiIdentity } from "./ciIdentity.js";
 import { resolveOperatorCatalog } from "./operatorCatalog.js";
 import { exitCodeForValidation, formatValidationHuman, formatValidationJson, } from "./validateOutput.js";
 export const RUN_USAGE = `Usage:
-  sf run --task <path> --pipeline <path> [--checkout <path>] [--json] [--skip-gates] [--git-sha <sha>] [--ci-pr-url <url>] [--ci-job-url <url>] [--operator-cwd <path>] [--operator-agent-dir <path>]`;
+  sf run --task <path> --pipeline <path> [--checkout <path>] [--json] [--include stages] [--skip-gates] [--git-sha <sha>] [--ci-pr-url <url>] [--ci-job-url <url>] [--operator-cwd <path>] [--operator-agent-dir <path>]`;
 const defaultIo = {
     log: (line) => console.log(line),
     error: (line) => console.error(line),
 };
 function parseRunArgs(args) {
     if (args.length === 0) {
-        return { help: false, json: false, skipGates: false };
+        return { help: false, json: false, includeStages: false, skipGates: false };
     }
     if (args[0] === "--help" || args[0] === "-h") {
-        return { help: true, json: false, skipGates: false };
+        return { help: true, json: false, includeStages: false, skipGates: false };
     }
     let task;
     let pipeline;
@@ -29,6 +29,7 @@ function parseRunArgs(args) {
     let operatorCwd;
     let operatorAgentDir;
     let json = false;
+    let includeStages = false;
     let skipGates = false;
     let help = false;
     for (let i = 0; i < args.length; i++) {
@@ -95,6 +96,18 @@ function parseRunArgs(args) {
         else if (arg === "--json") {
             json = true;
         }
+        else if (arg === "--include") {
+            const value = args[++i];
+            if (value === undefined || value.length === 0) {
+                throw new Error("Missing value for --include");
+            }
+            if (value === "stages") {
+                includeStages = true;
+            }
+            else {
+                throw new Error(`Unknown --include value: ${value}`);
+            }
+        }
         else if (arg === "--skip-gates") {
             skipGates = true;
         }
@@ -108,6 +121,7 @@ function parseRunArgs(args) {
     return {
         help,
         json,
+        includeStages,
         skipGates,
         task,
         pipeline,
@@ -136,7 +150,12 @@ function defaultStartRun(cwd, projectRoot, isGitProject, operatorCatalog) {
 }
 export async function completeCliRun(started, io = defaultIo, options = {}) {
     const result = await started.done;
-    return reportCliRun({ kind: "completion", result }, { json: options.json, io });
+    return reportCliRun({ kind: "completion", result }, {
+        json: options.json,
+        io,
+        store: options.store,
+        includeStages: options.includeStages,
+    });
 }
 export async function runRunCommand(args, options = {}) {
     const cwd = options.cwd ?? process.cwd();
@@ -162,6 +181,10 @@ export async function runRunCommand(args, options = {}) {
         out.error(RUN_USAGE);
         return 1;
     }
+    if (parsed.includeStages && !parsed.json) {
+        out.error("error: --include stages requires --json");
+        return 1;
+    }
     const operatorCatalog = resolveOperatorCatalog({
         flags: {
             operatorCwd: parsed.operatorCwd,
@@ -180,6 +203,10 @@ export async function runRunCommand(args, options = {}) {
         },
         env: options.env ?? process.env,
     });
+    const store = options.store ??
+        (parsed.includeStages
+            ? createRunStore({ rootDir: projectRoot })
+            : undefined);
     try {
         const started = await startRun({
             task: parsed.task,
@@ -191,7 +218,11 @@ export async function runRunCommand(args, options = {}) {
         if (!started.ok) {
             return reportCliRun({ kind: "start-failure", started }, { json: parsed.json, io: out });
         }
-        return completeCliRun(started, out, { json: parsed.json });
+        return completeCliRun(started, out, {
+            json: parsed.json,
+            includeStages: parsed.includeStages,
+            store,
+        });
     }
     catch (err) {
         if (err instanceof PipelineValidationError) {

package/dist/cli/runOutput.d.ts

@@ -1,3 +1,4 @@
+import type { RunStore } from "../runstore/port.js";
 import type { PipelineRunResult } from "../runtime/pipelineRunner.js";
 import type { StartRunResult } from "../runtime/runManager.js";
 export type CliRunReportIo = {
@@ -16,4 +17,6 @@ export type CliRunReportEvent = {
 export declare function reportCliRun(event: CliRunReportEvent, options: {
     json?: boolean;
     io: CliRunReportIo;
-}): number;
+    store?: RunStore;
+    includeStages?: boolean;
+}): Promise<number>;

package/dist/cli/runOutput.js

@@ -1,3 +1,4 @@
+import { projectRun } from "../projection/projectRun.js";
 function stringify(payload) {
     return JSON.stringify(payload, null, 2);
 }
@@ -44,22 +45,22 @@ function formatStartFailureJson(started) {
     }
     return formatRunStartFailedJson(started);
 }
-function formatRunCompletionJson(result) {
+function baseRunCompletionPayload(result) {
     if (result.outcome === "succeeded") {
-        return stringify({
+        return {
             ok: true,
             outcome: "succeeded",
             runId: result.runId,
             runDir: result.runDir,
-        });
+        };
     }
     if (result.outcome === "waiting") {
-        return stringify({
+        return {
             ok: false,
             outcome: "waiting",
             runId: result.runId,
             runDir: result.runDir,
-        });
+        };
     }
     const payload = {
         ok: false,
@@ -69,7 +70,18 @@ function formatRunCompletionJson(result) {
     };
     if (result.reason !== undefined)
         payload.reason = result.reason;
-    return stringify(payload);
+    return payload;
+}
+function formatRunCompletionJson(result) {
+    return stringify(baseRunCompletionPayload(result));
+}
+async function formatRunCompletionJsonWithStages(result, store) {
+    const detail = await store.readRun(result.runId);
+    const projection = projectRun(detail);
+    return stringify({
+        ...baseRunCompletionPayload(result),
+        stages: projection.stages,
+    });
 }
 function writeStartFailureHuman(started, io) {
     const code = started.code ?? "error";
@@ -105,7 +117,7 @@ function exitCodeForRunOutcome(outcome) {
             return 1;
     }
 }
-export function reportCliRun(event, options) {
+export async function reportCliRun(event, options) {
     if (event.kind === "start-failure") {
         if (options.json) {
             options.io.log(formatStartFailureJson(event.started));
@@ -116,7 +128,23 @@ export function reportCliRun(event, options) {
         return 1;
     }
     if (options.json) {
-        options.io.log(formatRunCompletionJson(event.result));
+        if (options.includeStages) {
+            if (!options.store) {
+                options.io.error("error: --include stages requires an internal run store (report bug)");
+                return 1;
+            }
+            try {
+                options.io.log(await formatRunCompletionJsonWithStages(event.result, options.store));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                options.io.error(`failed to read run for --include stages: ${message}`);
+                return 1;
+            }
+        }
+        else {
+            options.io.log(formatRunCompletionJson(event.result));
+        }
     }
     else {
         writeCompletionHuman(event.result, options.io);

package/dist/cli/runsCommand.d.ts

@@ -0,0 +1,22 @@
+import type { RunStore } from "../runstore/port.js";
+import { RunManager } from "../runtime/runManager.js";
+export declare const RUNS_USAGE = "Usage:\n  sf runs list [--status created|running|succeeded|failed] [--since <iso>] [--pipeline <id-or-path>] [--json]\n  sf runs show --run <runId> [--from <sf-run.json>] [--json]\n  sf runs waiting [--run <runId>] [--json]\n  sf runs wait --run <runId> [--from <sf-run.json>] [--until any|waiting|terminal] [--timeout-ms <n>] [--json]\n  sf runs answer --run <runId> --stage <stageId> [--answer '<json>'] [--json]\n  sf runs retry --run <runId> --stage <stageId> [--json]\n  sf runs abandon --run <runId> --stage <stageId> [--json]\n  sf runs rerun --run <runId> [--json]";
+export type RunsCommandIo = {
+    log: (line: string) => void;
+    error: (line: string) => void;
+};
+export type HostProbeResult = "up" | "down";
+export declare function defaultProbeHost(): Promise<HostProbeResult>;
+export declare function runRunsCommand(args: string[], options?: {
+    cwd?: string;
+    projectRoot?: string;
+    isGitProject?: boolean;
+    io?: Partial<RunsCommandIo>;
+    store?: RunStore;
+    probeHost?: () => Promise<HostProbeResult>;
+    stdinIsTTY?: boolean;
+    readStdin?: () => string;
+    waitSignal?: AbortSignal;
+    env?: NodeJS.ProcessEnv;
+    createManager?: (store: RunStore) => RunManager;
+}): Promise<number>;