testeiya 0.10.1 → 0.10.2

package/dist/src/output.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Where the report goes. Only known schemes are recognised: a generic
+ * `<word>:` test would swallow `C:\reports\out.md` on Windows.
+ */
+export declare function parseDestinations(values: string[], json?: boolean): Destination[] | string;
+/** The file the agent is told to write, if any. */
+export declare function markdownPath(destinations: Destination[]): string | undefined;
+/**
+ * Check every destination before the run starts. A ten-minute run that then
+ * cannot post is the worst outcome, so this spends no tokens to find out.
+ */
+export declare function preflight(destinations: Destination[]): Promise<string | null>;
+/** Route the finished report. Returns a message when a destination failed. */
+export declare function deliver(destinations: Destination[], envelope: RunEnvelope, thread?: ThreadState): Promise<string | null>;
+/**
+ * This thread's comments, read before the run. Collapsing them afterwards needs
+ * no judgement: the answer posted in between cannot be in a list taken before
+ * it existed, which is the one thing an agent working the thread cannot know.
+ */
+export declare function threadComments(pr: number | undefined, thread?: string): Promise<string[]>;
+/**
+ * The report as delivered, header above it and footer under it. The marker goes
+ * on top only in a thread: it is how a later round finds the comments we posted.
+ */
+export declare function decorate(report: string, decoration?: Decoration): string;
+/**
+ * What signs the text as ours. An HTML comment is invisible wherever markdown
+ * renders, and a later round reading the thread back knows which comments it
+ * wrote, which conversation they belong to, and what they were written against.
+ * Key=value, so a round with nothing restored can still parse it with `split`.
+ */
+export declare function marker(fields?: MarkerFields): string;
+/** A thread name safe inside an HTML comment, which cannot contain `--`. */
+export declare function threadName(value?: string): string;
+/** What a posted comment opens with when the caller writes no header of their own. */
+export declare function defaultHeader(): string;
+/** What signs the report when the caller writes no footer of their own. */
+export declare function defaultFooter(model: string): string;
+/** The pull request `preflight` resolved, when the report is posted to one. */
+export declare function pullRequestNumber(destinations: Destination[]): number | undefined;
+/** The model name you would recognise, without the provider namespace. */
+export declare function modelName(model: string): string;
+export interface Decoration extends MarkerFields {
+    header?: string;
+    footer?: string;
+}
+export interface MarkerFields {
+    /** Which conversation this comment belongs to, so parallel runs never mix. */
+    thread?: string;
+    /** The commit the review was written against, read by the next round. */
+    commit?: string;
+    /** Short session id. Omitted on an unsaved run. */
+    session?: string;
+}
+/** This thread's comments as they were before the run. */
+export interface ThreadState {
+    earlier: string[];
+}
+export type Destination = {
+    kind: "stdout";
+} | {
+    kind: "markdown";
+    path: string;
+} | {
+    kind: "json";
+    path?: string;
+} | {
+    kind: "gh";
+    pr?: number;
+};
+export interface RunEnvelope {
+    status: "pass" | "fail";
+    reason: string | null;
+    report: string | null;
+    reportPath: string | null;
+    model: string;
+    steps: number;
+    tokens: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+    sessionId: string | null;
+}

package/dist/src/pipeline/command-stage.d.ts

@@ -0,0 +1,12 @@
+import { Stage, type Item, type StageContext } from "./stage.js";
+import type { StageResult } from "./state.js";
+import type { Variables } from "./variables.js";
+/** A shell command. Exit 0 passes, anything else fails. Its output goes to `<id>.log` in its folder. */
+export declare class CommandStage extends Stage {
+    protected readonly result: {
+        field: "log";
+        extension: string;
+    };
+    files(): string[];
+    protected runItem(context: StageContext, item: Item, vars: Variables): Promise<StageResult>;
+}

package/dist/src/pipeline/crash-guard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * While an agent stage runs in this process, an error nobody caught (an
+ * extension, a tool) would kill the pipeline without a word in its state.
+ * The guard hands it to `onCrash`, which records the stage and exits.
+ */
+export declare class CrashGuard {
+    private readonly onCrash;
+    private readonly listener;
+    constructor(onCrash: (err: unknown) => void);
+    arm(): void;
+    disarm(): void;
+}

package/dist/src/pipeline/crash-guard.js

@@ -0,0 +1,21 @@
+/**
+ * While an agent stage runs in this process, an error nobody caught (an
+ * extension, a tool) would kill the pipeline without a word in its state.
+ * The guard hands it to `onCrash`, which records the stage and exits.
+ */
+export class CrashGuard {
+    onCrash;
+    listener = (err) => this.onCrash(err);
+    constructor(onCrash) {
+        this.onCrash = onCrash;
+    }
+    arm() {
+        process.on("uncaughtException", this.listener);
+        process.on("unhandledRejection", this.listener);
+    }
+    disarm() {
+        process.off("uncaughtException", this.listener);
+        process.off("unhandledRejection", this.listener);
+    }
+}
+//# sourceMappingURL=crash-guard.js.map

package/dist/src/pipeline/crash-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-guard.js","sourceRoot":"","sources":["../../../src/pipeline/crash-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAGQ;IAFZ,QAAQ,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhE,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEhE,GAAG;QACD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/src/pipeline/diagram.d.ts

@@ -0,0 +1,24 @@
+import type { PipelineSpec } from "./spec.js";
+import type { Stage } from "./stage.js";
+/**
+ * A pipeline as a Mermaid flowchart: stages in order, the files they hand
+ * each other, and the gates each one needs, coloured by the check.
+ */
+export declare class Diagram {
+    private readonly spec;
+    private readonly stages;
+    private readonly results;
+    private readonly lines;
+    private readonly gateIds;
+    constructor(spec: PipelineSpec, stages: Stage[], results: Map<string, boolean>);
+    toMarkdown(): string;
+    toMermaid(): string;
+    private flow;
+    /** An input from an earlier stage is a dotted edge; one nobody writes is a file node. */
+    private files;
+    private gates;
+    private gate;
+    private stageShape;
+    private node;
+    private label;
+}

package/dist/src/pipeline/gate.d.ts

@@ -0,0 +1,21 @@
+import type { Changes } from "../git.js";
+import type { GateSpec } from "./spec.js";
+import type { Variables } from "./variables.js";
+/** A named check. It passes only when every check it has passes. */
+export declare class Gate {
+    readonly name: string;
+    private readonly spec;
+    constructor(name: string, spec: GateSpec);
+    /** A gate the CI job adds with `--gate NAME:COMMAND`. */
+    static command(name: string, run: string): Gate;
+    get message(): string;
+    get readsChanges(): boolean;
+    passes(context: GateContext): Promise<boolean>;
+    private matchesChanges;
+    private succeeds;
+}
+export interface GateContext {
+    cwd: string;
+    vars: Variables;
+    changes: Changes;
+}

package/dist/src/pipeline/launcher.d.ts

@@ -0,0 +1,33 @@
+import type { Variables } from "./variables.js";
+export declare const KILL_GRACE_MS = 5000;
+/**
+ * Starts one stage process at a time, streams its output, and stops its whole
+ * process group on a timeout or Ctrl-C.
+ */
+export declare class Launcher {
+    private readonly cwd;
+    interrupted: boolean;
+    private current;
+    private task;
+    constructor(cwd: string);
+    watchInterrupt(): void;
+    /** An agent stage running in this process: Ctrl-C aborts it. */
+    track(task: AbortController): void;
+    untrack(): void;
+    /** A shell command when `args` is null, otherwise a program and its arguments. */
+    start(launch: Launch): Promise<Launched>;
+    private kill;
+}
+export interface Launch {
+    command: string;
+    args: string[] | null;
+    vars: Variables;
+    /** Where to copy the output, besides the console. */
+    log: string | null;
+    timeout?: number;
+}
+export interface Launched {
+    code: number;
+    timedOut: boolean;
+    interrupted: boolean;
+}

package/dist/src/pipeline/launcher.js

@@ -1,6 +1,6 @@
 import { spawn } from "node:child_process";
 import { createWriteStream } from "node:fs";
-const KILL_GRACE_MS = 5_000;
+export const KILL_GRACE_MS = 5_000;
 /**
  * Starts one stage process at a time, streams its output, and stops its whole
  * process group on a timeout or Ctrl-C.
@@ -9,6 +9,7 @@ export class Launcher {
     cwd;
     interrupted = false;
     current = null;
+    task = null;
     constructor(cwd) {
         this.cwd = cwd;
     }
@@ -17,8 +18,18 @@ export class Launcher {
             this.interrupted = true;
             if (this.current)
                 this.kill(this.current, "SIGINT");
+            this.task?.abort("interrupted");
         });
     }
+    /** An agent stage running in this process: Ctrl-C aborts it. */
+    track(task) {
+        this.task = task;
+        if (this.interrupted)
+            task.abort("interrupted");
+    }
+    untrack() {
+        this.task = null;
+    }
     /** A shell command when `args` is null, otherwise a program and its arguments. */
     start(launch) {
         return new Promise((done) => {
@@ -50,8 +61,10 @@ export class Launcher {
             const finish = (code) => {
                 clearTimeout(timer);
                 this.current = null;
-                file?.end();
-                done({ code, timedOut, interrupted: this.interrupted });
+                const result = { code, timedOut, interrupted: this.interrupted };
+                if (!file)
+                    return done(result);
+                file.end(() => done(result));
             };
             child.on("error", (err) => {
                 forward(Buffer.from(`${err.message}\n`));

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

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

package/dist/src/pipeline/log.d.ts

@@ -0,0 +1,29 @@
+import type { Changes } from "../git.js";
+import type { Overlay } from "./overlay.js";
+import type { StageRecord } from "./state.js";
+/** What a pipeline prints while it runs. All of it goes to stderr. */
+export declare class PipelineLog {
+    header(name: string, round: number, changes: Changes, dir: string): void;
+    valid(name: string, path: string): void;
+    /** One line per override: where it came from and the keys it changes. */
+    overlays(overlays: Overlay[]): void;
+    checked(failed: number): void;
+    skipped(reason: string): void;
+    interrupted(): void;
+    /** One line per stage: its mark, time, and status or a note. */
+    stage(record: StageRecord, detail?: string): void;
+    starting(name: string, item?: string): void;
+    /** An agent stage starting in this process. */
+    task(id: string, model: string | undefined, session: string | null, task: string): void;
+    /** A task that did not stop when asked: it runs on, its result is ignored. */
+    abandoned(id: string): void;
+    command(text: string): void;
+    gate(name: string, passed: boolean, message: string, mark?: string): void;
+    aiGate(problem: string | null): void;
+    /** A dry run's line for a stage. */
+    plan(id: string, mark: PlanMark, text: string): void;
+    note(message: string): void;
+}
+export declare const log: PipelineLog;
+type PlanMark = "runs" | "skipped" | "not-run";
+export {};

package/dist/src/pipeline/log.js

@@ -50,6 +50,15 @@ export class PipelineLog {
             line += `  ${item}`;
         this.note(c.dim(line));
     }
+    /** An agent stage starting in this process. */
+    task(id, model, session, task) {
+        this.note(`  ${c.dim("→")} ${id} ${c.dim("·")} ${model ?? "default model"} ${c.dim("·")} ${session ? `session ${session}` : "no session"}`);
+        this.note(c.dim(`    ${task.split("\n")[0]}`));
+    }
+    /** A task that did not stop when asked: it runs on, its result is ignored. */
+    abandoned(id) {
+        this.note(c.yellow(`  ⨯ ${id} did not stop, left running`));
+    }
     command(text) {
         this.note(c.dim(`  $ ${text}`));
     }

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

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

package/dist/src/pipeline/overlay.d.ts

@@ -0,0 +1,29 @@
+type Raw = Record<string, unknown>;
+/**
+ * Changes laid over a raw pipeline before it is validated. A plain key
+ * replaces, `append_` and `prepend_` add, `remove_` drops. Stages match by id,
+ * gates by name. PIPELINES.md documents every rule.
+ */
+export declare class Overlay {
+    readonly source: string;
+    readonly raw: Raw;
+    constructor(source: string, raw: Raw);
+    /** `--pipeline YAML`: keys of the pipeline itself. */
+    static pipeline(text: string): Overlay;
+    /** `--stage ID:YAML`: keys of one stage. */
+    static stage(value: string): Overlay;
+    /** The keys this overlay changes, for logs: `requirements.append_task`. */
+    keys(): string[];
+    apply(base: Raw): Raw;
+    private stages;
+    private gates;
+    private merge;
+    private field;
+    private fail;
+    private static read;
+    private static split;
+    private static join;
+    private static list;
+    private static isRecord;
+}
+export {};

package/dist/src/pipeline/pipeline-file.d.ts

@@ -0,0 +1,44 @@
+import { Overlay } from "./overlay.js";
+import type { PipelineSpec } from "./spec.js";
+/**
+ * A pipeline file: found by path or bundled name, then parsed and validated
+ * into a `PipelineSpec`. Every mistake is bad usage, found before a token is
+ * spent, and every message names the file.
+ */
+export declare class PipelineFile {
+    readonly path: string;
+    constructor(path: string);
+    /** A path when it looks like one, otherwise a bundled pipeline's name. */
+    static find(name: string): PipelineFile;
+    static bundled(): Array<{
+        name: string;
+        description: string;
+        target?: string;
+    }>;
+    text(): string;
+    read(overlays?: Overlay[]): PipelineSpec;
+    /** The spec with `extends` and every overlay applied, and the same as YAML, which needs neither. */
+    resolve(overlays?: Overlay[]): {
+        spec: PipelineSpec;
+        text: string;
+    };
+    /** Parse text as this file, so a copy keeps the file's name. */
+    parse(text: string): PipelineSpec;
+    private raw;
+    private validate;
+    private gate;
+    private changes;
+    private stage;
+    private checkReferences;
+    private checkFilters;
+    private unknownKeys;
+    private string;
+    private list;
+    private map;
+    private fail;
+    private static isRecord;
+    private static titleOf;
+    private static emojiOf;
+    private static isSlug;
+    private static isPath;
+}

package/dist/src/pipeline/pipeline.d.ts

@@ -0,0 +1,78 @@
+import { type TaskRunner } from "../run.js";
+/**
+ * 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 declare class Pipeline {
+    private readonly options;
+    private readonly cwd;
+    private readonly git;
+    private readonly launcher;
+    private readonly cli;
+    private readonly runTask;
+    private readonly overlays;
+    constructor(options: PipelineOptions);
+    static list(json?: boolean): number;
+    run(): Promise<number>;
+    /** Validates the file, then checks every gate it declares. Runs no stage. */
+    check(): Promise<number>;
+    private runStages;
+    /** The summary reads every stage and writes the one report that is posted. */
+    private summarize;
+    private context;
+    /** The process is in an unknown state after an uncaught error: save what ran, stop. */
+    private crashed;
+    private interrupted;
+    /** A retry finishes the round it started, so a file edited since cannot reorder the stages half-way through. */
+    private spec;
+    private gates;
+    /**
+     * Each stage gets a numbered folder, padded so they sort in order. An output may
+     * not take the stage's own file names, nor be one of its inputs: those are links
+     * to another stage's files.
+     */
+    private stages;
+    private variables;
+    /** Each gate once. A shallow clone cannot say what changed, and a silent skip would look like a quiet pull request. */
+    private checkGates;
+    /** Every input comes from an earlier stage, the runner, or the folder itself. */
+    private checkInputs;
+    private inputsSkipped;
+    /** The last stage before the reader that wrote the input, else the top of the folder. */
+    private locate;
+    private whyMissing;
+    private keptRecord;
+    /** The summary is an agent, so a pipeline with one needs a model. */
+    private needsAi;
+    private aiProblem;
+    private folder;
+    private dryRun;
+}
+export interface PipelineOptions {
+    name: string;
+    dir?: string;
+    dryRun?: boolean;
+    /** pipeline-check also writes a Mermaid diagram to the current folder. */
+    diagram?: boolean;
+    sets?: Record<string, string>;
+    /** Gate name to a shell check, from --gate. */
+    gates?: Record<string, string>;
+    /** YAML laid over the pipeline, from --pipeline. */
+    pipelineOverrides?: string[];
+    /** ID:YAML laid over one stage, from --stage. */
+    stageOverrides?: string[];
+    outputs?: string[];
+    thread?: string;
+    header?: string;
+    footer?: string;
+    noDefaultFooter?: boolean;
+    model?: string;
+    exitZero?: boolean;
+    json?: boolean;
+    /** The CLI a stage spawns under TESTEIYA_PIPELINE_SPAWN=1. Tests swap in a fake. */
+    cli?: string;
+    /** Runs an agent stage. Tests swap in a fake. */
+    runTask?: TaskRunner;
+    /** Throws when no model or key resolves. */
+    checkAi?: (model?: string) => Promise<void>;
+}

package/dist/src/pipeline/pipeline.js

@@ -5,7 +5,9 @@ import { fileURLToPath } from "node:url";
 import { chalkStderr as c } from "chalk";
 import { Git } from "../git.js";
 import { UsageError } from "../model.js";
+import { runTask } from "../run.js";
 import { CommandStage } from "./command-stage.js";
+import { CrashGuard } from "./crash-guard.js";
 import { Diagram } from "./diagram.js";
 import { Gate } from "./gate.js";
 import { Launcher } from "./launcher.js";
@@ -30,10 +32,12 @@ export class Pipeline {
     git = new Git(this.cwd);
     launcher = new Launcher(this.cwd);
     cli;
+    runTask;
     overlays;
     constructor(options) {
         this.options = options;
         this.cli = options.cli ?? fileURLToPath(new URL("../cli.js", import.meta.url));
+        this.runTask = options.runTask ?? runTask;
         // --pipeline first, so --stage can change a stage it adds.
         this.overlays = [...(options.pipelineOverrides ?? []).map(Overlay.pipeline), ...(options.stageOverrides ?? []).map(Overlay.stage)];
     }
@@ -250,12 +254,30 @@ export class Pipeline {
             vars: run.vars,
             launcher: this.launcher,
             cli: this.cli,
+            runTask: this.runTask,
+            guard: new CrashGuard((err) => this.crashed(run.state, err)),
             model: this.options.model,
             report,
             missing: (input) => this.whyMissing(input, run),
             locate: (input, reader) => this.locate(input, reader, run),
         };
     }
+    /** The process is in an unknown state after an uncaught error: save what ran, stop. */
+    crashed(state, err) {
+        let message = String(err);
+        if (err instanceof Error)
+            message = err.message;
+        for (const record of state.record.stages) {
+            if (record.status !== "running")
+                continue;
+            record.status = "broken";
+            record.reason = `crashed: ${message}`;
+            log.stage(record);
+        }
+        state.record.status = "broken";
+        state.save();
+        process.exit(1);
+    }
     interrupted(state) {
         state.record.status = "interrupted";
         for (const record of state.record.stages)