@cleocode/core 2026.9.22 → 2026.9.24

package/dist/release/preflight-skip.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Decide which `release-prepare.yml` preflight test suites a `cleo release open`
+ * dispatch may skip, from CI results GitHub already holds for the SAME commit.
+ *
+ * `release-prepare` re-runs the full Linux test sweep on the commit it
+ * checks out — main's HEAD — which is the commit main's own push CI has
+ * already tested. When that push run is green, the release-prepare shards
+ * prove nothing new and cost ~20 minutes of the release's critical path.
+ * Likewise the macOS shards, which moved from every main push to nightly +
+ * release: when the nightly macOS jobs for the exact commit are green, the
+ * release has nothing left to learn from them.
+ *
+ * Every check is keyed on ONE commit SHA, resolved here and forwarded to the
+ * workflow as `verified-sha`. The workflow honours a skip only when it checked
+ * out that same commit, so a push to main between this check and the dispatch
+ * cannot borrow a green result from a different tree. Any failure to answer —
+ * `gh` error, timeout, unparseable output, no run, a run still in progress —
+ * resolves to "run the tests", never to "skip".
+ *
+ * Each `gh` call is bounded by {@link PREFLIGHT_CHECK_TIMEOUT_MS}.
+ *
+ * @task release-speed
+ */
+/** Timeout for each `gh` call made while deciding preflight skips (ms). */
+export declare const PREFLIGHT_CHECK_TIMEOUT_MS = 15000;
+/** Workflow file whose `push` run on main carries the Linux test shards. */
+export declare const MAIN_CI_WORKFLOW: "ci.yml";
+/**
+ * Runs `gh <args>` in `cwd` with a timeout and returns stdout. Throws on a
+ * non-zero exit or timeout.
+ */
+export type PreflightGhRunner = (args: readonly string[], cwd: string, timeoutMs: number) => string;
+/**
+ * The outcome of {@link decidePreflightSkips}, forwarded to the workflow and
+ * returned in the `cleo release open` result.
+ */
+export interface PreflightSkipDecision {
+    /** Commit every check was made against (main's HEAD), or `null` if unresolved. */
+    verifiedSha: string | null;
+    /** True iff main's push CI for {@link verifiedSha} is green AND ran every Linux Unit Tests shard green. */
+    skipTests: boolean;
+    /** True iff every macOS job of a nightly (or push) run for {@link verifiedSha} succeeded. */
+    skipMacosTests: boolean;
+    /** Human-readable account of both decisions (lands in the run summary). */
+    reason: string;
+}
+/**
+ * Check GitHub for CI results on the dispatch branch's HEAD and decide which
+ * `release-prepare` preflight test suites may be skipped.
+ *
+ * - Linux: skipped iff the newest `push` run of {@link MAIN_CI_WORKFLOW} on
+ *   `branch` for HEAD's SHA is `completed` + `success` AND its Linux
+ *   `Unit Tests` jobs exist, cover shards `1..N`, and all succeeded. A green
+ *   run whose tests were skipped (docs-only push) does not qualify.
+ * - macOS: skipped iff a completed `schedule` (nightly) run — or the push run
+ *   above — for HEAD's SHA has at least one macOS job and every macOS job
+ *   concluded `success`.
+ *
+ * Never throws: any error resolves to running the suite.
+ *
+ * @param runGh - bounded `gh` runner (see {@link PreflightGhRunner})
+ * @param cwd - repository checkout the `gh` calls resolve `{owner}/{repo}` from
+ * @param branch - the branch `workflow_dispatch` checks out (the default branch)
+ * @returns the decision, including the SHA it is valid for
+ *
+ * @example
+ * ```ts
+ * const decision = decidePreflightSkips(runGh, projectRoot, 'main');
+ * if (decision.skipTests) fields.push('--field', 'skip-tests=true');
+ * ```
+ */
+export declare function decidePreflightSkips(runGh: PreflightGhRunner, cwd: string, branch: string): PreflightSkipDecision;
+//# sourceMappingURL=preflight-skip.d.ts.map

package/dist/release/preflight-skip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-skip.d.ts","sourceRoot":"","sources":["../../src/release/preflight-skip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAKlD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpG;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2GAA2G;IAC3G,SAAS,EAAE,OAAO,CAAC;IACnB,6FAA6F;IAC7F,cAAc,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AA0HD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,qBAAqB,CAyFvB"}

package/dist/release/preflight-skip.js

@@ -0,0 +1,254 @@
+/**
+ * Decide which `release-prepare.yml` preflight test suites a `cleo release open`
+ * dispatch may skip, from CI results GitHub already holds for the SAME commit.
+ *
+ * `release-prepare` re-runs the full Linux test sweep on the commit it
+ * checks out — main's HEAD — which is the commit main's own push CI has
+ * already tested. When that push run is green, the release-prepare shards
+ * prove nothing new and cost ~20 minutes of the release's critical path.
+ * Likewise the macOS shards, which moved from every main push to nightly +
+ * release: when the nightly macOS jobs for the exact commit are green, the
+ * release has nothing left to learn from them.
+ *
+ * Every check is keyed on ONE commit SHA, resolved here and forwarded to the
+ * workflow as `verified-sha`. The workflow honours a skip only when it checked
+ * out that same commit, so a push to main between this check and the dispatch
+ * cannot borrow a green result from a different tree. Any failure to answer —
+ * `gh` error, timeout, unparseable output, no run, a run still in progress —
+ * resolves to "run the tests", never to "skip".
+ *
+ * Each `gh` call is bounded by {@link PREFLIGHT_CHECK_TIMEOUT_MS}.
+ *
+ * @task release-speed
+ */
+/** Timeout for each `gh` call made while deciding preflight skips (ms). */
+export const PREFLIGHT_CHECK_TIMEOUT_MS = 15_000;
+/** Workflow file whose `push` run on main carries the Linux test shards. */
+export const MAIN_CI_WORKFLOW = 'ci.yml';
+/** Most runs whose jobs are inspected for macOS results (bounds `gh` calls). */
+const MAX_MACOS_CANDIDATE_RUNS = 5;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract `workflow_runs[]` from a runs-list response, dropping malformed rows. */
+function parseRuns(raw) {
+    const body = parseJson(raw);
+    if (!isRecord(body) || !Array.isArray(body['workflow_runs']))
+        return [];
+    const runs = [];
+    for (const row of body['workflow_runs']) {
+        if (!isRecord(row))
+            continue;
+        const { id, head_sha, status, conclusion, event, html_url } = row;
+        if (typeof id !== 'number' || typeof head_sha !== 'string' || typeof status !== 'string') {
+            continue;
+        }
+        runs.push({
+            id,
+            headSha: head_sha,
+            status,
+            conclusion: typeof conclusion === 'string' ? conclusion : null,
+            event: typeof event === 'string' ? event : '',
+            url: typeof html_url === 'string' ? html_url : `run ${id}`,
+        });
+    }
+    // Newest first: a re-run or a later attempt supersedes an earlier result.
+    return runs.sort((a, b) => b.id - a.id);
+}
+/**
+ * Extract `jobs[]` from a run-jobs response, dropping malformed rows.
+ *
+ * Returns `null` when the body is not a jobs page or when `total_count` says
+ * the page is incomplete (more jobs than one `per_page=100` page holds), so a
+ * caller can never judge a run from a partial job list.
+ */
+function parseJobs(raw) {
+    const body = parseJson(raw);
+    if (!isRecord(body) || !Array.isArray(body['jobs']))
+        return null;
+    const total = body['total_count'];
+    if (typeof total === 'number' && total > body['jobs'].length)
+        return null;
+    const jobs = [];
+    for (const row of body['jobs']) {
+        if (!isRecord(row) || typeof row['name'] !== 'string')
+            continue;
+        const conclusion = row['conclusion'];
+        jobs.push({
+            name: row['name'],
+            conclusion: typeof conclusion === 'string' ? conclusion : null,
+        });
+    }
+    return jobs;
+}
+/** A `Unit Tests (<os>, shard <n>)` job from {@link MAIN_CI_WORKFLOW}, any OS. */
+function isUnitTestJob(name) {
+    return /^Unit Tests\b/.test(name);
+}
+/** A job that ran the test suite on macOS, by the name GitHub renders for it. */
+function isMacosJob(name) {
+    return /mac\s*os/i.test(name);
+}
+/**
+ * Judge whether a run's Linux `Unit Tests` shards prove the tree was tested.
+ * Returns `null` when they do, otherwise why not (for the run summary).
+ *
+ * Requires at least one Linux shard, every one concluded `success`, and the
+ * shard numbers form the complete set `1..N` (a missing shard is not a pass).
+ */
+function judgeLinuxUnitTests(jobs) {
+    if (jobs === null)
+        return 'its job list could not be read';
+    const linux = jobs.filter((j) => isUnitTestJob(j.name) && !isMacosJob(j.name));
+    if (linux.length === 0)
+        return 'it ran no Linux Unit Tests jobs';
+    const notGreen = linux.filter((j) => j.conclusion !== 'success');
+    if (notGreen.length > 0) {
+        return `${notGreen.length} Linux Unit Tests job(s) did not succeed (${notGreen
+            .map((j) => `${j.name}: ${j.conclusion ?? 'no conclusion'}`)
+            .join(', ')})`;
+    }
+    const shards = new Set();
+    for (const job of linux) {
+        const match = /shard\s+(\d+)/i.exec(job.name);
+        if (match === null)
+            return `Linux job "${job.name}" names no shard`;
+        shards.add(Number(match[1]));
+    }
+    const max = Math.max(...shards);
+    for (let n = 1; n <= max; n++) {
+        if (!shards.has(n))
+            return `Linux Unit Tests shard ${n} of ${max} is missing`;
+    }
+    return null;
+}
+function shortSha(sha) {
+    return sha.slice(0, 12);
+}
+/**
+ * Check GitHub for CI results on the dispatch branch's HEAD and decide which
+ * `release-prepare` preflight test suites may be skipped.
+ *
+ * - Linux: skipped iff the newest `push` run of {@link MAIN_CI_WORKFLOW} on
+ *   `branch` for HEAD's SHA is `completed` + `success` AND its Linux
+ *   `Unit Tests` jobs exist, cover shards `1..N`, and all succeeded. A green
+ *   run whose tests were skipped (docs-only push) does not qualify.
+ * - macOS: skipped iff a completed `schedule` (nightly) run — or the push run
+ *   above — for HEAD's SHA has at least one macOS job and every macOS job
+ *   concluded `success`.
+ *
+ * Never throws: any error resolves to running the suite.
+ *
+ * @param runGh - bounded `gh` runner (see {@link PreflightGhRunner})
+ * @param cwd - repository checkout the `gh` calls resolve `{owner}/{repo}` from
+ * @param branch - the branch `workflow_dispatch` checks out (the default branch)
+ * @returns the decision, including the SHA it is valid for
+ *
+ * @example
+ * ```ts
+ * const decision = decidePreflightSkips(runGh, projectRoot, 'main');
+ * if (decision.skipTests) fields.push('--field', 'skip-tests=true');
+ * ```
+ */
+export function decidePreflightSkips(runGh, cwd, branch) {
+    const gh = (args) => {
+        try {
+            return runGh(args, cwd, PREFLIGHT_CHECK_TIMEOUT_MS);
+        }
+        catch {
+            return null;
+        }
+    };
+    const shaRaw = gh(['api', `repos/{owner}/{repo}/commits/${branch}`, '--jq', '.sha']);
+    const sha = shaRaw?.trim() ?? '';
+    if (!/^[0-9a-f]{40}$/.test(sha)) {
+        return {
+            verifiedSha: null,
+            skipTests: false,
+            skipMacosTests: false,
+            reason: `Could not resolve the HEAD of ${branch} via gh; running every preflight suite.`,
+        };
+    }
+    // ── Linux: main's own push CI for this exact commit ─────────────────────
+    const pushRaw = gh([
+        'api',
+        `repos/{owner}/{repo}/actions/workflows/${MAIN_CI_WORKFLOW}/runs?head_sha=${sha}&event=push&branch=${branch}&per_page=20`,
+    ]);
+    const pushRuns = pushRaw === null ? [] : parseRuns(pushRaw).filter((r) => r.headSha === sha);
+    const pushRun = pushRuns[0];
+    let skipTests = false;
+    let linuxReason;
+    if (pushRaw === null) {
+        linuxReason = `Linux tests run: could not query ${MAIN_CI_WORKFLOW} runs for ${shortSha(sha)}.`;
+    }
+    else if (pushRun === undefined) {
+        linuxReason = `Linux tests run: no ${MAIN_CI_WORKFLOW} push run on ${branch} for ${shortSha(sha)}.`;
+    }
+    else if (pushRun.status !== 'completed') {
+        linuxReason = `Linux tests run: ${MAIN_CI_WORKFLOW} push run for ${shortSha(sha)} is ${pushRun.status} (${pushRun.url}).`;
+    }
+    else if (pushRun.conclusion !== 'success') {
+        linuxReason = `Linux tests run: ${MAIN_CI_WORKFLOW} push run for ${shortSha(sha)} concluded ${pushRun.conclusion ?? 'without a conclusion'} (${pushRun.url}).`;
+    }
+    else {
+        // A green run is not a tested run: a docs-only push skips `Unit Tests`
+        // (the `changes` gate) and still concludes `success`. Only green Linux
+        // `Unit Tests` jobs — every shard present and successful — prove the
+        // tree was tested.
+        const jobsRaw = gh([
+            'api',
+            `repos/{owner}/{repo}/actions/runs/${pushRun.id}/jobs?per_page=100`,
+        ]);
+        const jobs = jobsRaw === null ? null : parseJobs(jobsRaw);
+        const verdict = judgeLinuxUnitTests(jobs);
+        if (verdict === null) {
+            skipTests = true;
+            linuxReason = `Linux tests skipped: every Linux Unit Tests shard of the ${MAIN_CI_WORKFLOW} push run for ${shortSha(sha)} is green (${pushRun.url}).`;
+        }
+        else {
+            linuxReason = `Linux tests run: ${MAIN_CI_WORKFLOW} push run for ${shortSha(sha)} is green but ${verdict} (${pushRun.url}).`;
+        }
+    }
+    // ── macOS: nightly (schedule) runs, or the push run, for this commit ─────
+    const scheduleRaw = gh([
+        'api',
+        `repos/{owner}/{repo}/actions/runs?head_sha=${sha}&event=schedule&per_page=20`,
+    ]);
+    const scheduleRuns = scheduleRaw === null ? [] : parseRuns(scheduleRaw).filter((r) => r.headSha === sha);
+    const candidates = [...scheduleRuns, ...(pushRun ? [pushRun] : [])]
+        .filter((r) => r.status === 'completed')
+        .slice(0, MAX_MACOS_CANDIDATE_RUNS);
+    let skipMacosTests = false;
+    let macosReason = `macOS tests run: no completed nightly run with macOS jobs for ${shortSha(sha)}.`;
+    for (const run of candidates) {
+        const jobsRaw = gh(['api', `repos/{owner}/{repo}/actions/runs/${run.id}/jobs?per_page=100`]);
+        const jobs = jobsRaw === null ? null : parseJobs(jobsRaw);
+        if (jobs === null)
+            continue;
+        const macosJobs = jobs.filter((j) => isMacosJob(j.name));
+        if (macosJobs.length === 0)
+            continue;
+        const failed = macosJobs.filter((j) => j.conclusion !== 'success');
+        if (failed.length === 0) {
+            skipMacosTests = true;
+            macosReason = `macOS tests skipped: all ${macosJobs.length} macOS job(s) of the ${run.event} run for ${shortSha(sha)} are green (${run.url}).`;
+            break;
+        }
+        macosReason = `macOS tests run: ${failed.length} macOS job(s) of the ${run.event} run for ${shortSha(sha)} did not succeed (${run.url}).`;
+    }
+    return {
+        verifiedSha: sha,
+        skipTests,
+        skipMacosTests,
+        reason: `${linuxReason} ${macosReason}`,
+    };
+}
+//# sourceMappingURL=preflight-skip.js.map

package/dist/release/preflight-skip.js.map

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

package/dist/render/decide/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Human renderers for `cleo decide` (System One): `config`, `status`, `ask`
+ * and the profile list (`profiles`, `use`, `config --remove`).
+ *
+ * The CLI shows these on an interactive terminal (see
+ * `packages/cleo/src/cli/lib/interactive-commands.ts`); `--json` and any
+ * piped or non-TTY run keep the LAFS envelope. Every value rendered here is
+ * already secret-free: keys appear only as the masked last-4 preview the
+ * decide operations return.
+ *
+ * @task T12733
+ * @epic T12486
+ */
+/**
+ * Human form of `cleo decide ask`: the question, the state, the answer as
+ * yes/no with confidence, and source · latency · cost · request id.
+ *
+ * @param data - `DecideAskResult`.
+ * @param quiet - Print only the answer.
+ * @returns Rendered text.
+ */
+export declare function renderDecideAsk(data: Record<string, unknown>, quiet: boolean): string;
+/**
+ * Human form of the profile list (`cleo decide profiles`, `use`,
+ * `config --remove`): one line per profile, the active one marked.
+ *
+ * @param data - `DecideProfileListResult`.
+ * @param quiet - Print only the ids.
+ * @returns Rendered text.
+ */
+export declare function renderDecideProfiles(data: Record<string, unknown>, quiet: boolean): string;
+/**
+ * Human form of `cleo decide config`: the wizard result (with its smoke
+ * test), a scripted configure result, the profile list after `--remove`, or
+ * the active settings when no flags are given.
+ *
+ * @param data - `DecideWizardResult`, `DecideConfigureResult`, `DecideProfileListResult` or `DecideCredentialsSummary`.
+ * @param quiet - Print only the one-line outcome.
+ * @returns Rendered text.
+ */
+export declare function renderDecideConfig(data: Record<string, unknown>, quiet: boolean): string;
+/**
+ * Human form of `cleo decide status`: reachability, settings, capabilities,
+ * balance and month-to-date spend against the cap.
+ *
+ * @param data - `DecideProbeResult`.
+ * @param quiet - Print only the state.
+ * @returns Rendered text.
+ */
+export declare function renderDecideStatus(data: Record<string, unknown>, quiet: boolean): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/render/decide/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/decide/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmJH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CA4B1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAyBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAsCxF"}