testeiya 0.7.0 → 0.8.1

package/dist/src/pipeline/pipeline.js

@@ -0,0 +1,415 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { chalkStderr as c } from "chalk";
+import { Git } from "../git.js";
+import { UsageError } from "../model.js";
+import { CommandStage } from "./command-stage.js";
+import { Diagram } from "./diagram.js";
+import { Gate } from "./gate.js";
+import { Launcher } from "./launcher.js";
+import { log } from "./log.js";
+import { PipelineFile } from "./pipeline-file.js";
+import { Report } from "./report.js";
+import { CHANGES_FILE, COPY_FILE, PipelineState, STATE_FILE, } from "./state.js";
+import { TaskStage } from "./task-stage.js";
+import { Variables } from "./variables.js";
+// A job-level reply, thread or session file belongs to a single task, never to
+// every stage of a pipeline.
+const JOB_ONLY = ["TESTEIYA_FOLLOW_UP", "TESTEIYA_THREAD", "TESTEIYA_SESSION_FILE"];
+/**
+ * One run of a pipeline file. It picks the round, checks the gates, runs the
+ * stages in order through one folder, then a summary that is the only report.
+ */
+export class Pipeline {
+    options;
+    cwd = process.cwd();
+    git = new Git(this.cwd);
+    launcher = new Launcher(this.cwd);
+    cli;
+    constructor(options) {
+        this.options = options;
+        this.cli = options.cli ?? fileURLToPath(new URL("../cli.js", import.meta.url));
+    }
+    static list(json) {
+        const pipelines = PipelineFile.bundled();
+        if (json) {
+            process.stdout.write(`${JSON.stringify({ pipelines }, null, 2)}\n`);
+            return 0;
+        }
+        process.stdout.write("\n");
+        for (const pipeline of pipelines) {
+            process.stdout.write(`  ${pipeline.name.padEnd(14)} ${c.dim(pipeline.description)}\n`);
+        }
+        process.stdout.write('\n  Run one with:  testeiya pipeline <name>, or pass your own .yml\n\n');
+        return 0;
+    }
+    async run() {
+        const { options, cwd } = this;
+        const file = PipelineFile.find(options.name);
+        const named = file.read();
+        const dir = this.folder(named.name);
+        if (dir === cwd || cwd.startsWith(dir + sep)) {
+            throw new UsageError("--dir must be a folder of its own, not the checkout or a folder above it");
+        }
+        const previous = PipelineState.read(dir);
+        const commit = await this.git.headCommit();
+        const history = previous?.rounds ?? [];
+        const retry = Boolean(previous && previous.commit === commit && PipelineState.STOPPED.includes(previous.status));
+        const again = Boolean(previous && !retry && previous.status !== "skipped" && previous.commit === commit);
+        const spec = this.spec(file, named, dir, retry);
+        const gates = this.gates(spec);
+        const stages = this.stages(spec.stages);
+        let round = history.length + 1;
+        let since = history.at(-1)?.commit ?? null;
+        if (retry || again) {
+            round = previous.round;
+            since = previous.since;
+        }
+        let aiProblem = null;
+        if (this.needsAi(stages))
+            aiProblem = await this.aiProblem();
+        if (aiProblem && !options.dryRun)
+            throw new UsageError(aiProblem);
+        const vars = this.variables(spec, dir, round);
+        const changes = await this.git.changes(since, vars.toEnv());
+        const results = await this.checkGates(gates, [spec.when, ...stages.map((stage) => stage.spec.when)].flat(), vars, changes);
+        log.header(spec.name, round, changes, dir);
+        const blocked = spec.when.find((name) => !results.get(name));
+        if (blocked) {
+            const reason = gates.get(blocked).message;
+            log.skipped(reason);
+            if (options.dryRun)
+                return 0;
+            const state = new PipelineState(dir, { name: spec.name, round, commit, since, status: "skipped", reason, stages: [], rounds: history });
+            state.save();
+            if (options.json)
+                process.stdout.write(`${JSON.stringify(state, null, 2)}\n`);
+            return 0;
+        }
+        // After the skip: a job gated on a pull request may name one that only exists when the gate passes.
+        const report = await Report.prepare(options);
+        if (options.dryRun)
+            return this.dryRun(stages, gates, results, aiProblem);
+        let created = previous?.created ?? [];
+        mkdirSync(dir, { recursive: true });
+        if (!retry) {
+            // A new round clears what the last one wrote and keeps the sessions.
+            for (const name of created)
+                rmSync(join(dir, name), { recursive: true, force: true });
+            created = [];
+            writeFileSync(join(dir, COPY_FILE), file.text());
+        }
+        if (changes.files)
+            writeFileSync(join(dir, CHANGES_FILE), `${changes.files.join("\n")}\n`);
+        this.checkInputs(stages, dir);
+        let kept = null;
+        if (retry)
+            kept = previous;
+        const state = new PipelineState(dir, {
+            name: spec.name,
+            round,
+            commit,
+            since,
+            status: "running",
+            stages: stages.map((stage) => this.keptRecord(stage, kept)),
+            rounds: history,
+            created,
+        });
+        state.trackFiles();
+        return this.runStages({ spec, stages, gates, results, state, vars, report, dir });
+    }
+    /** Validates the file, then checks every gate it declares. Runs no stage. */
+    async check() {
+        const file = PipelineFile.find(this.options.name);
+        const named = file.read();
+        const dir = this.folder(named.name, false);
+        const spec = this.spec(file, named, dir, false);
+        const gates = this.gates(spec);
+        const stages = this.stages(spec.stages);
+        this.checkInputs(stages, dir);
+        log.valid(spec.name, file.path);
+        let aiProblem = null;
+        if (this.needsAi(stages))
+            aiProblem = await this.aiProblem();
+        const vars = this.variables(spec, dir, 1);
+        const since = PipelineState.read(dir)?.rounds.at(-1)?.commit ?? null;
+        const changes = await this.git.changes(since, vars.toEnv());
+        const results = await this.checkGates(gates, [...gates.keys()], vars, changes);
+        const checked = [...results].map(([name, passed]) => ({ name, passed, message: gates.get(name).message }));
+        if (this.needsAi(stages))
+            checked.unshift({ name: "ai", passed: !aiProblem, message: aiProblem ?? "" });
+        const failed = checked.filter((gate) => !gate.passed).length;
+        if (this.options.json) {
+            process.stdout.write(`${JSON.stringify({ name: spec.name, file: file.path, gates: checked }, null, 2)}\n`);
+        }
+        for (const gate of checked)
+            log.gate(gate.name, gate.passed, gate.message);
+        if (this.options.diagram) {
+            const passed = new Map(checked.map((gate) => [gate.name, gate.passed]));
+            const path = resolve(`${spec.name}.diagram.md`);
+            writeFileSync(path, new Diagram(spec, stages, passed).toMarkdown());
+            log.note(c.dim(`\n  Diagram: ${path}`));
+        }
+        log.checked(failed);
+        if (failed)
+            return 1;
+        return 0;
+    }
+    async runStages(run) {
+        const { stages, state, results, gates } = run;
+        this.launcher.watchInterrupt();
+        state.save();
+        let stopped = false;
+        for (const [index, stage] of stages.entries()) {
+            const record = state.record.stages[index];
+            if (record.status === "pass" || record.status === "fail") {
+                log.stage(record, "kept from the last attempt");
+                continue;
+            }
+            if (stopped) {
+                record.status = "not-run";
+                continue;
+            }
+            const closed = stage.closedGate(results);
+            if (closed) {
+                stage.skip(record, gates.get(closed).message);
+                stopped = stage.stopsOn("gate");
+                state.save();
+                continue;
+            }
+            if (stage instanceof CommandStage && this.inputsSkipped(stage, run)) {
+                stage.skip(record, "its inputs come from skipped stages");
+                state.save();
+                continue;
+            }
+            await stage.run(this.context(run, stages.length === 1), record);
+            state.save();
+            const status = record.status;
+            if (status === "interrupted")
+                break;
+            if (status === "broken" || status === "timeout")
+                stopped = true;
+            if (status === "fail" && stage.stopsOn("fail"))
+                stopped = true;
+        }
+        if (this.launcher.interrupted)
+            return this.interrupted(state);
+        state.record.status = PipelineState.verdict(state.record.stages);
+        state.save();
+        if (stages.length > 1 && state.record.stages.some((record) => record.status !== "skipped" && record.status !== "not-run")) {
+            await this.summarize(run);
+            if (this.launcher.interrupted)
+                return this.interrupted(state);
+        }
+        state.finishRound();
+        state.save();
+        if (this.options.json)
+            process.stdout.write(`${JSON.stringify(state, null, 2)}\n`);
+        if (state.record.status === "pass")
+            return 0;
+        if (state.record.status === "fail" && this.options.exitZero)
+            return 0;
+        return 1;
+    }
+    /** The summary reads every stage and writes the one report that is posted. */
+    async summarize(run) {
+        const { state } = run;
+        const record = { id: "summary", status: "not-run" };
+        state.record.stages.push(record);
+        await this.summaryStage(run).run(this.context(run, true), record);
+        // The verdict came from the stages; the summary only explains it.
+        if (record.status === "fail") {
+            record.status = "pass";
+            delete record.reason;
+        }
+        if (!this.launcher.interrupted)
+            state.record.status = PipelineState.verdict(state.record.stages);
+    }
+    summaryStage(run) {
+        const { spec, stages, state } = run;
+        const files = state.record.stages.flatMap((record) => {
+            const stage = stages.find((entry) => entry.id === record.id);
+            const own = [record.report, record.log, ...(stage?.spec.outputs ?? [])];
+            return own.filter((name) => Boolean(name));
+        });
+        const lines = ["/pipeline-report", "", `Write the final report of the "${spec.name}" pipeline, round ${state.record.round}.`];
+        if (spec.summary)
+            lines.push("", spec.summary.trim());
+        lines.push("", `Read pipeline.json first. The verdict is ${state.record.status}. Explain it, never change it.`, `Stage files: ${files.join(", ") || "none"}`);
+        return new TaskStage({ id: "summary", task: lines.join("\n"), session: "summary", inputs: [STATE_FILE], outputs: [], when: [], stopOn: [] });
+    }
+    context(run, reporter) {
+        let report = null;
+        if (reporter)
+            report = run.report;
+        return {
+            dir: run.dir,
+            vars: run.vars,
+            launcher: this.launcher,
+            cli: this.cli,
+            model: this.options.model,
+            report,
+            missing: (input) => this.whyMissing(input, run),
+        };
+    }
+    interrupted(state) {
+        state.record.status = "interrupted";
+        for (const record of state.record.stages)
+            if (record.status === "running")
+                record.status = "interrupted";
+        state.save();
+        log.interrupted();
+        return 130;
+    }
+    /** A retry finishes the round it started, so a file edited since cannot reorder the stages half-way through. */
+    spec(file, named, dir, retry) {
+        let spec = named;
+        const copy = join(dir, COPY_FILE);
+        if (retry && existsSync(copy)) {
+            spec = file.parse(readFileSync(copy, "utf8"));
+            if (spec.name !== named.name)
+                throw new UsageError(`${dir} holds a run of "${spec.name}", not "${named.name}"`);
+        }
+        // Gates passed with --gate join `when`: the CI job decides if the run happens at all.
+        for (const name of Object.keys(this.options.gates ?? {})) {
+            if (spec.gates[name])
+                throw new UsageError(`--gate ${name}: the pipeline already defines this gate`);
+        }
+        return { ...spec, when: [...spec.when, ...Object.keys(this.options.gates ?? {})] };
+    }
+    gates(spec) {
+        const gates = new Map();
+        for (const [name, gate] of Object.entries(spec.gates))
+            gates.set(name, new Gate(name, gate));
+        for (const [name, run] of Object.entries(this.options.gates ?? {}))
+            gates.set(name, Gate.command(name, run));
+        return gates;
+    }
+    /** An output may not take a file another stage writes on its own. */
+    stages(specs) {
+        const stages = specs.map((spec) => {
+            if (spec.run !== undefined)
+                return new CommandStage(spec);
+            return new TaskStage(spec);
+        });
+        for (const stage of stages) {
+            for (const output of stage.spec.outputs) {
+                const owner = stages.find((other) => other.files().includes(output));
+                if (owner)
+                    throw new UsageError(`stage "${stage.id}" output ${output} is a file stage "${owner.id}" writes itself`);
+            }
+        }
+        return stages;
+    }
+    variables(spec, dir, round) {
+        const sets = this.options.sets ?? {};
+        return new Variables({ ...process.env })
+            .with({ ...sets, PIPELINE_DIR: dir, PIPELINE_NAME: spec.name, PIPELINE_ROUND: String(round) })
+            .withExpanded(spec.env)
+            .with(sets)
+            .without(JOB_ONLY);
+    }
+    /** Each gate once. A shallow clone cannot say what changed, and a silent skip would look like a quiet pull request. */
+    async checkGates(gates, names, vars, changes) {
+        const used = [...new Set(names)];
+        if (!changes.files && used.some((name) => gates.get(name).readsChanges)) {
+            throw new UsageError(`cannot read the changes: ${changes.error}. Check out with full history (fetch-depth: 0)`);
+        }
+        const results = new Map();
+        for (const name of used)
+            results.set(name, await gates.get(name).passes({ cwd: this.cwd, vars, changes }));
+        return results;
+    }
+    /** Every input comes from an earlier stage, the runner, or the folder itself. */
+    checkInputs(stages, dir) {
+        for (const [index, stage] of stages.entries()) {
+            for (const input of stage.inputs()) {
+                if (input === CHANGES_FILE || existsSync(join(dir, input)))
+                    continue;
+                if (stages.slice(0, index).some((earlier) => earlier.produces(input)))
+                    continue;
+                throw new UsageError(`stage "${stage.id}" reads ${input}, which no earlier stage writes`);
+            }
+        }
+    }
+    // A shell command cannot reason about a missing file; an agent stage is told instead.
+    inputsSkipped(stage, run) {
+        const inputs = stage.inputs();
+        if (inputs.length === 0)
+            return false;
+        return inputs.every((input) => {
+            const producer = run.stages.find((entry) => entry.produces(input));
+            if (!producer)
+                return false;
+            return run.state.stage(producer.id)?.status === "skipped";
+        });
+    }
+    whyMissing(input, run) {
+        const producer = run.stages.find((stage) => stage.produces(input));
+        if (!producer)
+            return "not found";
+        const record = run.state.stage(producer.id);
+        if (record?.status === "skipped")
+            return `stage ${producer.id} skipped: ${record.reason}`;
+        return `stage ${producer.id} did not write it`;
+    }
+    keptRecord(stage, previous) {
+        const record = previous?.stages.find((entry) => entry.id === stage.id);
+        if (!record)
+            return { id: stage.id, status: "not-run" };
+        if (record.status === "pass" || record.status === "fail")
+            return record;
+        return { id: stage.id, status: record.status, items: record.items };
+    }
+    /** The summary is an agent, so a pipeline with one needs a model. */
+    needsAi(stages) {
+        return stages.length > 1 || stages.some((stage) => stage instanceof TaskStage);
+    }
+    async aiProblem() {
+        if (!this.options.checkAi)
+            return null;
+        try {
+            await this.options.checkAi(this.options.model);
+            return null;
+        }
+        catch (err) {
+            if (err instanceof UsageError)
+                return err.message;
+            throw err;
+        }
+    }
+    folder(name, create = !this.options.dryRun) {
+        if (this.options.dir)
+            return resolve(this.options.dir);
+        if (!create)
+            return join(tmpdir(), `testeiya-${name}`);
+        return mkdtempSync(join(tmpdir(), `testeiya-${name}-`));
+    }
+    dryRun(stages, gates, results, aiProblem) {
+        if (this.needsAi(stages))
+            log.aiGate(aiProblem);
+        for (const [name, passed] of results)
+            log.gate(name, passed, gates.get(name).message);
+        log.note("");
+        let stopped = false;
+        for (const stage of stages) {
+            if (stopped) {
+                log.plan(stage.id, "not-run", "not run");
+                continue;
+            }
+            const closed = stage.closedGate(results);
+            if (closed) {
+                log.plan(stage.id, "skipped", `skipped: ${gates.get(closed).message}`);
+                stopped = stage.stopsOn("gate");
+                continue;
+            }
+            log.plan(stage.id, "runs", "runs");
+        }
+        if (stages.length > 1)
+            log.plan("summary", "runs", "runs, and reports");
+        return 0;
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/src/pipeline/pipeline.js.map

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

package/dist/src/pipeline/report.js

@@ -0,0 +1,61 @@
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { UsageError } from "../model.js";
+import { parseDestinations, preflight } from "../output.js";
+/**
+ * Where the pipeline's report goes. Only the reporting stage gets these
+ * destinations: the summary, or the one stage of a one-stage pipeline.
+ */
+export class Report {
+    options;
+    passed = [];
+    /** Markdown paths: the stage writes its own report, copied there after. */
+    copies = [];
+    constructor(outputs, options) {
+        this.options = options;
+        for (const output of outputs) {
+            const kind = parseDestinations([output]);
+            if (typeof kind !== "string" && kind[0]?.kind === "markdown")
+                this.copies.push(output);
+            else
+                this.passed.push(output);
+        }
+    }
+    /** Checked before the first stage, like any task: a run that cannot post spends nothing. */
+    static async prepare(options) {
+        const outputs = options.outputs ?? [];
+        const parsed = parseDestinations(outputs);
+        if (typeof parsed === "string")
+            throw new UsageError(parsed);
+        const unreachable = await preflight(parsed);
+        if (unreachable)
+            throw new UsageError(unreachable);
+        return new Report(outputs, options);
+    }
+    /** The `task` options that post the report. */
+    args() {
+        const { options } = this;
+        const args = [];
+        for (const output of this.passed)
+            args.push("-o", output);
+        if (options.thread)
+            args.push("--thread", options.thread);
+        if (options.header !== undefined)
+            args.push("--header", options.header);
+        if (options.footer !== undefined)
+            args.push("--footer", options.footer);
+        if (options.noDefaultFooter)
+            args.push("--no-default-footer");
+        return args;
+    }
+    // The stage already writes its own markdown report, and a task takes only one.
+    copy(report) {
+        if (!existsSync(report))
+            return;
+        for (const path of this.copies) {
+            mkdirSync(dirname(resolve(path)), { recursive: true });
+            copyFileSync(report, path);
+        }
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/src/pipeline/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/pipeline/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,MAAM,OAAO,MAAM;IAOE;IANF,MAAM,GAAa,EAAE,CAAC;IACvC,2EAA2E;IAC1D,MAAM,GAAa,EAAE,CAAC;IAEvC,YACE,OAAiB,EACA,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QAEvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,UAAU;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;gBAClF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,4FAA4F;IAC5F,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,WAAW;YAAE,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+CAA+C;IAC/C,IAAI;QACF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,eAAe;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,MAAc;QACjB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/src/pipeline/spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spec.js.map

package/dist/src/pipeline/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../src/pipeline/spec.ts"],"names":[],"mappings":""}