testeiya 0.10.0 → 0.10.2

package/dist/src/langfuse.d.ts

@@ -0,0 +1,67 @@
+/** Langfuse keys, or null when this run is not traced. */
+export declare function langfuseConfig(env?: NodeJS.ProcessEnv): LangfuseConfig | null;
+/**
+ * Spans held in memory, shipped as one OTLP request. Langfuse reads OTLP over
+ * plain JSON, so a trace costs no dependency: an install of this CLI carries no
+ * OpenTelemetry SDK for a feature most runs never turn on.
+ */
+export declare function createTracer(config: LangfuseConfig): Tracer;
+export declare function otlpPayload(spans: OtlpSpan[]): OtlpPayload;
+export declare function spanAttributes(name: string, fields: SpanFields, root: boolean): OtlpAttribute[];
+export interface LangfuseConfig {
+    publicKey: string;
+    secretKey: string;
+    baseUrl: string;
+}
+export interface Tracer {
+    /** Opens a trace of its own. Everything below it hangs off this span. */
+    trace(name: string, fields: SpanFields): Span;
+    flush(): Promise<void>;
+}
+export interface Span {
+    child(name: string, fields: SpanFields): Span;
+    update(fields: SpanFields): void;
+    end(fields?: SpanFields): void;
+}
+export interface SpanFields {
+    type?: "agent" | "generation" | "tool" | "span";
+    input?: unknown;
+    output?: unknown;
+    model?: string;
+    usage?: Record<string, number>;
+    cost?: Record<string, number>;
+    metadata?: Record<string, unknown>;
+    level?: "DEFAULT" | "WARNING" | "ERROR";
+    tags?: string[];
+    sessionId?: string;
+}
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OtlpAttribute[];
+    status: Record<string, never>;
+}
+export interface OtlpAttribute {
+    key: string;
+    value: {
+        stringValue: string;
+    };
+}
+export interface OtlpPayload {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OtlpAttribute[];
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+            };
+            spans: OtlpSpan[];
+        }>;
+    }>;
+}

package/dist/src/mcp.d.ts

@@ -0,0 +1,19 @@
+import type { LoadedMcpConfig } from "@earendil-works/pi-coding-agent";
+import type { TmsAccess } from "../prompt/testomat.io.js";
+export declare const SERVER = "testomatio";
+/**
+ * The Testomat.io MCP server needs a project id as well as a token — a token on
+ * its own does not identify a project to it. Without one the agent still reaches
+ * the project through `check-tests` and REST, which need only the token, so the
+ * prompt says exactly that instead of naming tools that are not there.
+ */
+export declare function tmsAccess(): TmsAccess;
+export declare function hasTestomatio(): boolean;
+export declare function hasMcp(): boolean;
+export declare function mcpServerScript(): string;
+/**
+ * The one server pi's MCP extension connects, built from the environment.
+ * Replaces pi's own config loading, so a CI clone cannot point the agent at an
+ * MCP server of its own through `.pi/mcp.json`.
+ */
+export declare function mcpConfig(): LoadedMcpConfig;

package/dist/src/model.d.ts

@@ -0,0 +1,20 @@
+import type { ModelRuntime } from "@earendil-works/pi-coding-agent";
+import type { SavedModel } from "./sessions.js";
+/** Provider key env vars the CLI picks up from the environment. */
+export declare const PROVIDER_KEYS: Array<{
+    provider: string;
+    env: string;
+}>;
+/** Bad usage — the caller prints the message and exits 2, never prompting. */
+export declare class UsageError extends Error {
+}
+/**
+ * --model, then TESTEIYA_MODEL, then the model a resumed session was running.
+ * CI often has no model configured, so TESTEIYA_MODEL is the channel there. The
+ * desktop app's `~/.testeiya/config.json` is not consulted — a CI run must not
+ * depend on a choice made in someone's GUI. Anything unresolvable throws, so a
+ * run never falls through to a prompt.
+ */
+export declare function resolveModel(runtime: ModelRuntime, explicit?: string, saved?: SavedModel | null): import("@earendil-works/pi-ai").Model<import("@earendil-works/pi-ai").Api>;
+/** Hand the runtime whichever provider keys the environment resolved. */
+export declare function applyEnvKeys(runtime: ModelRuntime): Promise<void>;

package/dist/src/model.js

@@ -4,6 +4,8 @@ export const PROVIDER_KEYS = [
     { provider: "anthropic", env: "ANTHROPIC_API_KEY" },
     { provider: "openai", env: "OPENAI_API_KEY" },
     { provider: "google", env: "GEMINI_API_KEY" },
+    { provider: "cloudflare-ai-gateway", env: "CLOUDFLARE_API_KEY" },
+    { provider: "cloudflare-workers-ai", env: "CLOUDFLARE_API_KEY" },
 ];
 /** Bad usage — the caller prints the message and exits 2, never prompting. */
 export class UsageError extends Error {

package/dist/src/model.js.map

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

package/dist/src/models.d.ts

@@ -0,0 +1 @@
+export declare function runModels(pattern: string | undefined, json?: boolean): Promise<number>;

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-file.js

@@ -9,9 +9,10 @@ import { Variables } from "./variables.js";
 const BUNDLED_DIR = join(PACKAGE_ROOT, "pipelines");
 /** `pipeline.json` and the summary's own files live beside the stages' files. */
 const RESERVED_IDS = ["pipeline", "summary"];
-const TOP_KEYS = ["name", "description", "summary", "env", "gates", "when", "stages"];
+const TOP_KEYS = ["name", "description", "target", "summary", "env", "gates", "when", "stages"];
 const GATE_KEYS = ["env", "file", "run", "changes", "message"];
 const CHANGES_KEYS = ["paths", "ignore", "min_files"];
+const STAGE_EMOJIS = ["🔹", "🔸", "🧪", "🔍", "🛠️", "📋", "🚀", "🧭", "📦", "🧩", "🎯", "⚙️"];
 const STAGE_KEYS = ["id", "title", "emoji", "task", "run", "session", "inputs", "outputs", "when", "stopOn", "timeout", "each_line", "each_file"];
 /**
  * A pipeline file: found by path or bundled name, then parsed and validated
@@ -41,7 +42,7 @@ export class PipelineFile {
         const files = readdirSync(BUNDLED_DIR).filter((file) => file.endsWith(".yml")).sort();
         return files.map((file) => {
             const spec = new PipelineFile(join(BUNDLED_DIR, file)).read();
-            return { name: basename(file, ".yml"), description: spec.description };
+            return { name: basename(file, ".yml"), description: spec.description, target: spec.target };
         });
     }
     text() {
@@ -102,6 +103,7 @@ export class PipelineFile {
         const spec = {
             name: this.string(raw.name, "name") ?? basename(this.path).replace(/\.ya?ml$/, ""),
             description: this.string(raw.description, "description") ?? "",
+            target: this.string(raw.target, "target"),
             summary: this.string(raw.summary, "summary"),
             env: this.map(raw.env, "env"),
             gates,
@@ -166,12 +168,8 @@ export class PipelineFile {
         if (value.each_line !== undefined && value.each_file !== undefined) {
             this.fail(`${where} can loop over each_line or each_file, not both`);
         }
-        const title = this.string(value.title, `${where} title`);
-        if (!title)
-            this.fail(`${where} needs a title`);
-        const emoji = this.string(value.emoji, `${where} emoji`);
-        if (!emoji)
-            this.fail(`${where} needs an emoji`);
+        const title = this.string(value.title, `${where} title`) || PipelineFile.titleOf(id);
+        const emoji = this.string(value.emoji, `${where} emoji`) || PipelineFile.emojiOf(id);
         const stage = {
             id,
             title,
@@ -292,6 +290,16 @@ export class PipelineFile {
     static isRecord(value) {
         return typeof value === "object" && value !== null && !Array.isArray(value);
     }
+    // `browser-testing` reads as "Browser testing".
+    static titleOf(id) {
+        const words = id.split("-").join(" ");
+        return words.charAt(0).toUpperCase() + words.slice(1);
+    }
+    // Picked from the id, so a stage keeps its emoji across runs.
+    static emojiOf(id) {
+        const sum = [...id].reduce((total, char) => total + char.charCodeAt(0), 0);
+        return STAGE_EMOJIS[sum % STAGE_EMOJIS.length];
+    }
     static isSlug(value) {
         if (!value || value.startsWith("-") || value.endsWith("-") || value.includes("--"))
             return false;