@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/core/readiness-probe.d.ts

@@ -0,0 +1,89 @@
+/** The one command that repairs every not-ready check (installs plugins + syncs the cache). */
+export declare const READINESS_REPAIR_COMMAND = "npx @svenroth-ai/shipwright@latest";
+/** Minimum working Python the plugin hooks require. */
+export declare const MIN_PYTHON = "3.11.0";
+export interface ReadinessCheck {
+    /** Stable id: claude | plugins | cache | uv | python | git. */
+    key: string;
+    /** Human label ("Claude CLI", "Shipwright plugins", …). */
+    label: string;
+    ok: boolean;
+    /** Version / count / "not found" — the concrete finding. */
+    detail: string;
+    /** Plain-language why-it-matters (empty for the self-evident ones). */
+    why: string;
+    /** A door is pointless without it. All six are critical today. */
+    critical: boolean;
+}
+export interface ReadinessReport {
+    /** Every critical check passed → the doors may open. */
+    ready: boolean;
+    checks: ReadinessCheck[];
+    /** Printed under the not-ready list — the ONE command that fixes all of it. */
+    repairCommand: string;
+}
+export interface RunResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+export type RunFn = (cmd: string, args?: string[]) => Promise<RunResult>;
+/** Per-probe timeout. A `--version` that hangs longer than this is treated as
+ *  "not found" — the process is killed, and because the runner is ASYNC the
+ *  event loop is never blocked while it waits. */
+export declare const PROBE_TIMEOUT_MS = 8000;
+/**
+ * Default runner: `<cmd> --version` and report whether it actually RAN — ASYNC.
+ *
+ * `execFile` (NOT `spawnSync`) so the probe never blocks the event loop: the
+ * `/api/readiness` handler shares the single-threaded loop with the live
+ * embedded-terminal WebSockets and the 1s transcript poll, so a tool that hangs
+ * on `--version` must not freeze every open connection. shell:false (execFile
+ * default) — no shell process, no injection surface. The probed tools (`uv`,
+ * `python*`, `git`) are real executables, so Windows resolves them by bare name
+ * (appends `.exe`; verified git/python/py/uv all run). This is deliberately NOT
+ * the bootstrapper preflight.mjs case, which shells out ONLY to resolve `.cmd`
+ * shims (claude/npm/gh) — none of those are probed here.
+ */
+export declare function defaultRun(cmd: string, args?: string[]): Promise<RunResult>;
+/** First `\d+.\d+(.\d+)?` token in a `--version` blob, or "". */
+export declare function extractVersion(out: string): string;
+/** Numeric semver-ish compare: -1 / 0 / 1. Missing segments are 0. */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Resolve ONE working Python by TEST-RUNNING `--version` (python3 → python →
+ * py). The MS-Store stub fails `run().ok` and is skipped.
+ */
+export declare function resolvePython(run: RunFn): Promise<{
+    bin: string;
+    version: string;
+} | null>;
+export interface ProbeDeps {
+    run?: RunFn;
+    existsFn?: (p: string) => boolean;
+    readdirFn?: (p: string) => string[];
+    homeDir?: string;
+    /** Claude CLI verdict from the shared cli-compat probe (already resolved). */
+    claude: {
+        supported: boolean;
+        raw: string;
+        minSupported: string;
+    };
+}
+/** `<home>/.claude/plugins/cache/shipwright` — the marketplace cache root (A06). */
+export declare function shipwrightCacheRoot(homeDir: string): string;
+/**
+ * The plugins the wizard's doors DIRECTLY invoke. A cache full of `shipwright-*`
+ * dirs is not enough — if `shipwright-adopt`/`shipwright-grade` are absent, the
+ * Adopt/Grade doors open into a missing command. Checking these two (rather than
+ * hardcoding the whole manifest, which A06 derives) is the honest floor.
+ */
+export declare const DOOR_REQUIRED_PLUGINS: readonly ["shipwright-adopt", "shipwright-grade"];
+/**
+ * Run the readiness probe — ASYNC. Pure over its seams; the route calls it with
+ * the real fs + execFile + the live cli-compat verdict. The three independent
+ * tool probes (uv · python · git) run in parallel (Promise.all), so the whole
+ * gate is bounded by the slowest single probe, not their sum.
+ */
+export declare function probeReadiness(deps: ProbeDeps): Promise<ReadinessReport>;
+//# sourceMappingURL=readiness-probe.d.ts.map

package/server/dist/core/readiness-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probe.d.ts","sourceRoot":"","sources":["../../src/core/readiness-probe.ts"],"names":[],"mappings":"AAqCA,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,uCAAuC,CAAC;AAE7E,uDAAuD;AACvD,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAEzE;;kDAEkD;AAClD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB1F;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAMhG;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,mDAAoD,CAAC;AAEvF;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CA2G9E"}

package/server/dist/core/readiness-probe.js

@@ -0,0 +1,216 @@
+/*
+ * readiness-probe — the FIRST-CONTACT readiness GATE, server-side (FR-01.51).
+ *
+ * "One truth, two surfaces": the Command Center's Intent-Wizard door picker
+ * (A08) and First Contact (A14) both gate on THE SAME set the npx bootstrapper's
+ * preflight checks — because promising "ready" on the first screen a user sees,
+ * without checking, is the same lie as an installer that reports success over a
+ * dead install. The bootstrapper (`bootstrapper/lib/preflight.mjs`) is a Node
+ * CLI; the browser cannot spawn subprocesses, so this module re-expresses the
+ * SAME check set server-side and the wizard reads it over `/api/readiness`.
+ *
+ * The check set (what actually kills a first run):
+ *   - Claude CLI (>= MIN_SUPPORTED_CLI)  — the engine the Command Center drives
+ *   - Shipwright plugins installed       — no plugins = a cockpit with no engine
+ *   - Coherent plugin cache (shared/)    — `claude plugin install` does NOT
+ *                                          deliver `cache/shipwright/shared/`,
+ *                                          into which every hook resolves (A06 §2b)
+ *   - uv                                 — 159 `uv run` hook call-sites die without it
+ *   - a WORKING Python (>= 3.11)         — TEST-RUN, never mere PATH presence
+ *                                          (Windows `python3` is a Store stub)
+ *   - git                                — the SDLC plugins are git-based
+ *
+ * Pure over its injected seams (`run`, `existsFn`, `readdirFn`, `homeDir`,
+ * `platform`, `claude`) so every branch is unit-testable without a real
+ * toolchain and the route can memoise a single probe.
+ *
+ * NOT a cross-package import of preflight.mjs (CLAUDE.md rule 7 / DO-NOT #7 —
+ * no cross-package imports; shared shapes are verbatim-mirrored + guarded). The
+ * check SET and the probe methodology are the shared truth; this is its server
+ * mirror.
+ */
+import { execFile } from "node:child_process";
+import { existsSync as fsExistsSync, readdirSync as fsReaddirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** The one command that repairs every not-ready check (installs plugins + syncs the cache). */
+export const READINESS_REPAIR_COMMAND = "npx @svenroth-ai/shipwright@latest";
+/** Minimum working Python the plugin hooks require. */
+export const MIN_PYTHON = "3.11.0";
+/** Per-probe timeout. A `--version` that hangs longer than this is treated as
+ *  "not found" — the process is killed, and because the runner is ASYNC the
+ *  event loop is never blocked while it waits. */
+export const PROBE_TIMEOUT_MS = 8000;
+/**
+ * Default runner: `<cmd> --version` and report whether it actually RAN — ASYNC.
+ *
+ * `execFile` (NOT `spawnSync`) so the probe never blocks the event loop: the
+ * `/api/readiness` handler shares the single-threaded loop with the live
+ * embedded-terminal WebSockets and the 1s transcript poll, so a tool that hangs
+ * on `--version` must not freeze every open connection. shell:false (execFile
+ * default) — no shell process, no injection surface. The probed tools (`uv`,
+ * `python*`, `git`) are real executables, so Windows resolves them by bare name
+ * (appends `.exe`; verified git/python/py/uv all run). This is deliberately NOT
+ * the bootstrapper preflight.mjs case, which shells out ONLY to resolve `.cmd`
+ * shims (claude/npm/gh) — none of those are probed here.
+ */
+export function defaultRun(cmd, args = ["--version"]) {
+    return new Promise((resolve) => {
+        execFile(cmd, args, { encoding: "utf-8", timeout: PROBE_TIMEOUT_MS, windowsHide: true }, (error, stdout, stderr) => {
+            const out = String(stdout ?? "");
+            const err = String(stderr ?? "");
+            // execFile sets `error` on a non-zero exit, a spawn failure (ENOENT) OR
+            // a timeout (killed) — all of which mean "did not run cleanly". A real
+            // tool exits 0 (no error) AND prints a version; the MS-Store python3 stub
+            // exits non-zero, so requiring no-error + a digit-bearing line rejects it
+            // (the whole reason this is not `command -v`).
+            const ok = !error && /\d+\.\d+/.test(out + err);
+            resolve({ ok, stdout: out, stderr: err });
+        });
+    });
+}
+/** First `\d+.\d+(.\d+)?` token in a `--version` blob, or "". */
+export function extractVersion(out) {
+    const m = /(\d+\.\d+(?:\.\d+)?)/.exec(String(out ?? ""));
+    return m ? m[1] : "";
+}
+/** Numeric semver-ish compare: -1 / 0 / 1. Missing segments are 0. */
+export function compareVersions(a, b) {
+    const pa = a.split(".").map((x) => parseInt(x, 10) || 0);
+    const pb = b.split(".").map((x) => parseInt(x, 10) || 0);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d < 0 ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Resolve ONE working Python by TEST-RUNNING `--version` (python3 → python →
+ * py). The MS-Store stub fails `run().ok` and is skipped.
+ */
+export async function resolvePython(run) {
+    for (const bin of ["python3", "python", "py"]) {
+        const r = await run(bin, ["--version"]);
+        if (r.ok)
+            return { bin, version: extractVersion(r.stdout + r.stderr) };
+    }
+    return null;
+}
+/** `<home>/.claude/plugins/cache/shipwright` — the marketplace cache root (A06). */
+export function shipwrightCacheRoot(homeDir) {
+    return path.join(homeDir, ".claude", "plugins", "cache", "shipwright");
+}
+/**
+ * The plugins the wizard's doors DIRECTLY invoke. A cache full of `shipwright-*`
+ * dirs is not enough — if `shipwright-adopt`/`shipwright-grade` are absent, the
+ * Adopt/Grade doors open into a missing command. Checking these two (rather than
+ * hardcoding the whole manifest, which A06 derives) is the honest floor.
+ */
+export const DOOR_REQUIRED_PLUGINS = ["shipwright-adopt", "shipwright-grade"];
+/**
+ * Run the readiness probe — ASYNC. Pure over its seams; the route calls it with
+ * the real fs + execFile + the live cli-compat verdict. The three independent
+ * tool probes (uv · python · git) run in parallel (Promise.all), so the whole
+ * gate is bounded by the slowest single probe, not their sum.
+ */
+export async function probeReadiness(deps) {
+    const run = deps.run ?? defaultRun;
+    const existsFn = deps.existsFn ?? fsExistsSync;
+    const readdirFn = deps.readdirFn ?? ((p) => fsReaddirSync(p));
+    const homeDir = deps.homeDir ?? os.homedir();
+    const cacheRoot = shipwrightCacheRoot(homeDir);
+    // Fire the independent toolchain probes concurrently — the event loop is free
+    // the whole time (execFile is async), and the total wait is max(uv, py, git).
+    const [uv, py, git] = await Promise.all([
+        run("uv", ["--version"]),
+        resolvePython(run),
+        run("git", ["--version"]),
+    ]);
+    const checks = [];
+    // Claude CLI — the engine. Verdict comes pre-resolved from cli-compat.
+    checks.push({
+        key: "claude",
+        label: "Claude CLI",
+        ok: deps.claude.supported,
+        detail: deps.claude.supported
+            ? deps.claude.raw || "detected"
+            : deps.claude.raw
+                ? `${deps.claude.raw} (need >= ${deps.claude.minSupported})`
+                : "not found",
+        why: "the engine the Command Center drives",
+        critical: true,
+    });
+    // Shipwright plugins installed — the marketplace cache holds one dir per plugin.
+    // A door-critical plugin that is absent means that door opens into a missing
+    // command, so "some plugins installed" is not the same as "ready".
+    let pluginNames = [];
+    try {
+        pluginNames = readdirFn(cacheRoot).filter((n) => n.startsWith("shipwright-"));
+    }
+    catch {
+        pluginNames = [];
+    }
+    const installed = new Set(pluginNames);
+    const missingRequired = DOOR_REQUIRED_PLUGINS.filter((p) => !installed.has(p));
+    const pluginsOk = pluginNames.length > 0 && missingRequired.length === 0;
+    checks.push({
+        key: "plugins",
+        label: "Shipwright plugins",
+        ok: pluginsOk,
+        detail: pluginNames.length === 0
+            ? "none installed"
+            : missingRequired.length > 0
+                ? `${pluginNames.length} installed, missing: ${missingRequired.join(", ")}`
+                : `${pluginNames.length} installed`,
+        why: "without them there are no /shipwright-* commands at all",
+        critical: true,
+    });
+    // Coherent plugin cache — the shared/ canary every hook resolves into. This is
+    // the tree `claude plugin install` does NOT deliver (A06 §2b).
+    const canary = path.join(cacheRoot, "shared", "scripts", "hooks", "capture_session_id.py");
+    const cacheOk = existsFn(canary);
+    checks.push({
+        key: "cache",
+        label: "Plugin cache",
+        ok: cacheOk,
+        detail: cacheOk ? "shared/ present" : "shared/ missing",
+        why: "every plugin hook resolves into cache/shipwright/shared/",
+        critical: true,
+    });
+    // uv — every hook shells through it (probed above, in parallel).
+    checks.push({
+        key: "uv",
+        label: "uv",
+        ok: uv.ok,
+        detail: uv.ok ? extractVersion(uv.stdout + uv.stderr) : "not found",
+        why: "every plugin hook runs through it",
+        critical: true,
+    });
+    // python — TEST-RUN probe (Store-stub trap), require >= 3.11 (probed above).
+    const pyOk = py != null && compareVersions(py.version, MIN_PYTHON) >= 0;
+    checks.push({
+        key: "python",
+        label: "Python",
+        ok: pyOk,
+        detail: py
+            ? pyOk
+                ? `${py.version} (${py.bin})`
+                : `${py.version} (need >= ${MIN_PYTHON})`
+            : "not found (tried python3, python, py)",
+        why: "the shared scripts run on it",
+        critical: true,
+    });
+    // git — the SDLC plugins are git-based (probed above, in parallel).
+    checks.push({
+        key: "git",
+        label: "git",
+        ok: git.ok,
+        detail: git.ok ? extractVersion(git.stdout + git.stderr) : "not found",
+        why: "",
+        critical: true,
+    });
+    const ready = checks.every((c) => c.ok || !c.critical);
+    return { ready, checks, repairCommand: READINESS_REPAIR_COMMAND };
+}
+//# sourceMappingURL=readiness-probe.js.map

package/server/dist/core/readiness-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probe.js","sourceRoot":"","sources":["../../src/core/readiness-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,WAAW,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,+FAA+F;AAC/F,MAAM,CAAC,MAAM,wBAAwB,GAAG,oCAAoC,CAAC;AAE7E,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AA+BnC;;kDAEkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAAiB,CAAC,WAAW,CAAC;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CACN,GAAG,EACH,IAAI,EACJ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,EAAE,EACnE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACjC,wEAAwE;YACxE,uEAAuE;YACvE,0EAA0E;YAC1E,0EAA0E;YAC1E,+CAA+C;YAC/C,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAU;IAC5C,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAU,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAe;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE/C,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;QACxB,aAAa,CAAC,GAAG,CAAC;QAClB,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,uEAAuE;IACvE,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,YAAY;QACnB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAC3B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,UAAU;YAC/B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;gBACf,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,aAAa,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG;gBAC5D,CAAC,CAAC,WAAW;QACjB,GAAG,EAAE,sCAAsC;QAC3C,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,iFAAiF;IACjF,6EAA6E;IAC7E,mEAAmE;IACnE,IAAI,WAAW,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IACzE,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,oBAAoB;QAC3B,EAAE,EAAE,SAAS;QACb,MAAM,EACJ,WAAW,CAAC,MAAM,KAAK,CAAC;YACtB,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC3E,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,YAAY;QACzC,GAAG,EAAE,yDAAyD;QAC9D,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,+EAA+E;IAC/E,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,cAAc;QACrB,EAAE,EAAE,OAAO;QACX,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;QACvD,GAAG,EAAE,0DAA0D;QAC/D,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,iEAAiE;IACjE,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,IAAI;QACX,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW;QACnE,GAAG,EAAE,mCAAmC;QACxC,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,6EAA6E;IAC7E,MAAM,IAAI,GAAG,EAAE,IAAI,IAAI,IAAI,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,QAAQ;QACf,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,EAAE;YACR,CAAC,CAAC,IAAI;gBACJ,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,GAAG,GAAG;gBAC7B,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,aAAa,UAAU,GAAG;YAC3C,CAAC,CAAC,uCAAuC;QAC3C,GAAG,EAAE,8BAA8B;QACnC,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,KAAK;QACZ,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW;QACtE,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,wBAAwB,EAAE,CAAC;AACpE,CAAC"}

package/server/dist/core/run-config-reader.d.ts

@@ -0,0 +1,35 @@
+import { type RunConfigV2 } from "../types/run-config-v2.js";
+export interface ReaderDiagnostics {
+    /** phase_task entries that failed validation and were dropped. */
+    droppedPhaseTaskIds: string[];
+    /** Non-fatal anomalies the UI can surface (currently used for retry hints). */
+    warnings: string[];
+}
+export type RunConfigReadResult = {
+    status: "missing";
+} | {
+    status: "v1_legacy";
+} | {
+    status: "ok";
+    config: RunConfigV2;
+    diagnostics: ReaderDiagnostics;
+} | {
+    status: "invalid";
+    reason: string;
+};
+export interface ReadRunConfigDeps {
+    /** Injected for tests; defaults to fs/promises.readFile + utf-8. */
+    readFile?: (path: string) => Promise<string>;
+    /** Injected for tests; defaults to fs/promises.stat. */
+    stat?: (path: string) => Promise<{
+        mtimeMs: number;
+    } | null>;
+    /** Injected for tests so they don't actually wait the backoff. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Override the default `Date.now`. Used by cache-TTL tests. */
+    now?: () => number;
+}
+export declare function readRunConfig(projectPath: string, deps?: ReadRunConfigDeps): Promise<RunConfigReadResult>;
+/** Test helper — drops the per-path last-good cache. */
+export declare function clearRunConfigReaderCache(): void;
+//# sourceMappingURL=run-config-reader.d.ts.map

package/server/dist/core/run-config-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-config-reader.d.ts","sourceRoot":"","sources":["../../src/core/run-config-reader.ts"],"names":[],"mappings":"AA6BA,OAAO,EAaL,KAAK,WAAW,EAIjB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAuC1C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,wDAAwD;IACxD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,kEAAkE;IAClE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CA6F9B;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}