testeiya 0.10.1 → 0.10.2

package/README.md

@@ -168,16 +168,6 @@ testeiya task "Run explorbot against https://staging.example.com, max 10 tests,
   --output explorbot-report.md
 ```
 
-### Repair failing tests after a red build
-
-On a failed CodeceptJS run, the `ci-fix-tests` skill attempts safe fixes only —
-locator drift, missing waits — reruns just the failing scenarios, rolls back any
-edit that did not help, and always writes `output/ci-fix.md` for the next job:
-
-```bash
-testeiya task "Fix the failed CodeceptJS tests using ci-fix-tests. No refactors."
-```
-
 ### Audit the test suite on a schedule
 
 Nightly, the agent walks the Testomat.io project and reports gaps — suites with
@@ -730,21 +720,19 @@ testeiya skills playwright  # filter by name, category or description
 testeiya skills --json      # [{name, group, description}]
 ```
 
-Categories today: QA process, test management, test automation, Explorbot,
-Playwright, CodeceptJS.
+Categories today: requirements, test management, test automation, QA process,
+Explorbot. One per plugin of
+[testomatio/skills](https://github.com/testomatio/skills).
 
-Sources are declared in `skills/skills.yaml` and pinned in
-`skills/skills.lock.json`. The vendored folders are deliberately not committed —
-they belong to their authors, under their own licences. A clone has the manifest
-and nothing else; `node scripts/vendor-skills.js` fills the tree. Every release
-runs it, so the published `testeiya` package ships each skill as current on
-release day.
+The skills are not committed here. `node scripts/vendor-skills.js` clones
+testomatio/skills and copies them into `skills/`. Every release runs it, so the
+published `testeiya` package ships each skill as current on release day.
 
 `skillsOverride` in `src/session.ts` keeps only what is found under that tree,
 so an arbitrary clone cannot hand the model its own skills. To add yours, point
 `additionalSkillPaths` at your folder. [EXTENDING.md](EXTENDING.md) covers both hooks.
 
-To propose a new source, add its line to `skills/skills.yaml`. See [CONTRIBUTING.md](CONTRIBUTING.md).
+To change a skill, send a pull request to [testomatio/skills](https://github.com/testomatio/skills).
 
 ## Building your own agent
 

package/dist/prompt/clis.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where a tracker question goes when a CLI is on PATH next to the MCP server.
+ * Never names a binary this machine lacks.
+ */
+export declare function cliRouting(): string;
+/** The CLIs Testeiya knows, as the connections list names them. */
+export declare function pathClis(): string[];

package/dist/prompt/pipeline-report.d.ts

@@ -0,0 +1 @@
+export declare const pipelineReport: string;

package/dist/prompt/report.d.ts

@@ -0,0 +1,10 @@
+export declare const verdict: string;
+export declare function report(options: ReportOptions): string[];
+export declare function finalReport(path: string): string;
+export declare const briefAnswer: string;
+export interface ReportOptions {
+    /** Absolute path the agent must write its final report to (`--output`). */
+    outputFile?: string;
+    /** Answer a question instead of doing a task and reporting (`testeiya ask`). */
+    brief?: boolean;
+}

package/dist/prompt/system-prompt.d.ts

@@ -0,0 +1,22 @@
+import { type ReportOptions } from "./report.js";
+import { type TestomatioOptions } from "./testomat.io.js";
+import { type ThreadOptions } from "./thread.js";
+/**
+ * The system prompt of the `testeiya` command: a one-shot worker fired by a
+ * trigger. The prompt is the text below, top to bottom. What varies per run is
+ * filled in at the bottom of this file: how Testomat.io is reached, the
+ * sections a run adds (a comment thread), and the answer contract.
+ */
+export declare function buildSystemPrompt(options: SystemPromptOptions): string;
+export type { TmsAccess } from "./testomat.io.js";
+export interface SystemPromptOptions extends TestomatioOptions, ThreadOptions, ReportOptions {
+    cwd?: string;
+    /** CLI tools on PATH and signed in (e.g. `gh`, `acli`). */
+    connectedClis?: string[];
+    /** MCP servers connected for this run. */
+    connectedMcps?: string[];
+    /** Whole sections this run adds, such as the comment-thread rules. */
+    sections?: string[];
+    /** False when the pulled manual tests folder is switched off, so no rule points at it. */
+    manualTestsHint?: boolean;
+}

package/dist/prompt/testomat.io.d.ts

@@ -0,0 +1,19 @@
+/**
+ * How the agent works on the Testomat.io project. The rules are the same in
+ * every run; only the way to reach the dynamic data differs, so `tms` picks
+ * that one line.
+ */
+export declare function testomatio(options: TestomatioOptions): string;
+/**
+ * `mcp-tools`: one tool per entity, named `mcp__testomatio__<tool>`. `cli-only`: no
+ * tools at all; `check-tests` and REST through the shell. `mcp-direct`: one tool
+ * per entity, prefixed `testomatio-<slug>`; the desktop app's one-shot mode.
+ */
+export type TmsAccess = "mcp-direct" | "mcp-tools" | "cli-only";
+export interface TestomatioOptions {
+    /** How the agent reaches Testomat.io in this run. */
+    tms: TmsAccess;
+    /** A Testomat.io token is in the environment. */
+    connected?: boolean;
+    backendUrl?: string;
+}

package/dist/prompt/thread.d.ts

@@ -0,0 +1,73 @@
+/**
+ * What this run continues, said as the three states a run can be in. A thread
+ * round knows its history from the checkpoint: "Since your last round" is in
+ * the task when there is one, so the prompt only names the state and the
+ * reading order. A first thread round and a standalone run share the rule that
+ * there is nothing to catch up on; the thread one adds that the thread starts
+ * with this answer.
+ */
+export declare function thread(options: ThreadOptions): string;
+export type ThreadMode = "first" | "continuing";
+export interface ThreadOptions {
+    /**
+     * Where this run sits in its thread. `continuing` is a later round with
+     * history to catch up on; `first` opens a thread; undefined is a standalone
+     * run with no thread at all.
+     */
+    threadMode?: ThreadMode;
+}
+/**
+ * How a host collapses a comment. The round is the same everywhere, so a host
+ * adds one line of mechanism, never a round of its own.
+ *
+ * The host comes from the environment, never from the remote: a remote says
+ * where the code lives, CI variables say we have a thread to answer in.
+ */
+declare const HOSTS: {
+    github: {
+        env: string[];
+        collapse: string;
+    };
+    gitlab: {
+        env: string[];
+        collapse: string;
+    };
+    bitbucket: {
+        env: string[];
+        collapse: string;
+    };
+    generic: {
+        env: never[];
+        collapse: string;
+    };
+};
+/**
+ * Which host this job belongs to. `generic` when it is CI and nothing claims it,
+ * nothing at all when it is not CI — a developer's own checkout has no thread.
+ */
+export declare function threadHost(env: Environment): ThreadHost | null;
+/** What a comment of this thread opens with, and so what identifies it. */
+export declare function threadMarker(thread: string): string;
+export declare function commentThread(options: CommentThreadOptions): string;
+export type ThreadHost = keyof typeof HOSTS;
+type Environment = Record<string, string | undefined>;
+export interface CommentThreadOptions extends ThreadOptions {
+    host: ThreadHost;
+    /** Which conversation this run is, so parallel runs never touch each other. */
+    thread: string;
+    /**
+     * The exact marker line a comment opens with. Built by the CLI so a comment
+     * the agent posts itself is stamped the same way as one the CLI delivers —
+     * the next round finds both by the same prefix.
+     */
+    marker: string;
+    /** The report file, so the comment body is the report and not a remark. */
+    reportFile?: string;
+    /** The heading the CLI would have opened the report with, if any. */
+    header?: string;
+    /** The line the CLI would have signed the report with, if any. */
+    footer?: string;
+    /** True when the command posts the answer and collapses the older ones. */
+    delivered?: boolean;
+}
+export {};

package/dist/src/args.d.ts

@@ -0,0 +1,39 @@
+export declare const WELCOME = "\n  Testeiya, an AI testing agent.\n\n  testeiya task \"analyze this pr and find inconsistencies\"\n  testeiya ask \"is this feature ready\"\n  testeiya pipeline web-testing\n\n  testeiya doctor    check your setup\n  testeiya --help    options and environment\n  testeiya help      the full guide\n";
+export declare const USAGE = "testeiya, an AI testing agent\n\nUsage:\n  testeiya task \"<task>\"      run one task and write a report\n  testeiya ask \"<question>\"   answer a question\n  testeiya pipeline <name>    run a multi-stage pipeline, or list them with no name\n  testeiya pipeline-check <name>  check a pipeline file and its gates, run nothing\n  testeiya doctor             check what a run would resolve\n  testeiya models [pattern]   list the models your key can reach\n  testeiya skills [pattern]   list the skills bundled with this package\n  testeiya sessions           list saved sessions for this folder\n\nOptions:\n  -o, --output <dest>        report destination, repeatable: file.md, file.json, gh:pr-comment\n      --model <id>           provider/model to run\n      --project <id>         Testomat.io project id\n      --followup <text>      the user's reply, added to the task as a new message\n      --thread <name>        which conversation this is, for posted comments\n  -c, --continue             continue the last session in this folder\n      --resume <id>          continue that session\n      --session <label>      continue the session with that name, or start it\n      --session-file <path>  keep the session in that file, for CI caches\n      --name <label>         name the session\n      --no-session           do not save the session\n      --exit-zero            a negative verdict exits 0\n      --header <text>        line added above the report\n      --footer <text>        line added under the report\n      --no-default-footer    do not sign the report\n      --no-thread            keep out of the comment thread: post nothing, read no comments\n      --json                 machine-readable output\n      --probe                doctor only: test the key with one request\n\nPipeline options:\n      --dir <path>           the pipeline folder; keep it between runs for rounds\n      --dry-run              show gates and stages, spend no tokens\n      --set KEY=VALUE        set a variable for every stage, repeatable\n      --gate NAME:COMMAND    skip the whole run unless COMMAND exits 0, repeatable\n      --stage ID:YAML        change one stage, e.g. 'plan:append_task: Be brief.'\n      --pipeline YAML        change the pipeline, e.g. 'append_summary: Be brief.'\n  -h, --help                 show this\n  -v, --version              show version\n\nEnvironment:\n  TESTEIYA_MODEL              model to run, e.g. openrouter/anthropic/claude-sonnet-5\n  TESTEIYA_FOLLOW_UP          the user's reply, same as --followup\n  TESTEIYA_THREAD             which conversation this is, same as --thread\n  TESTEIYA_SESSION_FILE       where to keep the session, same as --session-file\n  TESTEIYA_NO_DEFAULT_FOOTER  do not sign the report\n  OPENROUTER_API_KEY          provider key, also ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY\n  TESTOMATIO                  Testomat.io project API key\n  TESTOMATIO_PROJECT_ID       Testomat.io project id, same as --project\n  TESTOMATIO_URL              Testomat.io base url, for self-hosted\n\nRun \"testeiya help\" for the full guide.";
+export declare const HELP = "testeiya, an AI testing agent\n\nUsage:\n  testeiya task \"<task>\"      run one task and write a report\n  testeiya ask \"<question>\"   answer a question\n  testeiya pipeline <name>    run a multi-stage pipeline, or list them with no name\n  testeiya pipeline-check <name>  check a pipeline file and its gates, run nothing\n  testeiya doctor             check what a run would resolve\n  testeiya models [pattern]   list the models your key can reach\n  testeiya skills [pattern]   list the skills bundled with this package\n  testeiya sessions           list saved sessions for this folder\n\nOptions:\n  -o, --output <dest>        report destination, repeatable: file.md, file.json, gh:pr-comment\n      --model <id>           provider/model to run\n      --project <id>         Testomat.io project id\n      --followup <text>      the user's reply, added to the task as a new message\n      --thread <name>        which conversation this is, for posted comments\n  -c, --continue             continue the last session in this folder\n      --resume <id>          continue that session\n      --session <label>      continue the session with that name, or start it\n      --session-file <path>  keep the session in that file, for CI caches\n      --name <label>         name the session\n      --no-session           do not save the session\n      --exit-zero            a negative verdict exits 0\n      --header <text>        line added above the report\n      --footer <text>        line added under the report\n      --no-default-footer    do not sign the report\n      --no-thread            keep out of the comment thread: post nothing, read no comments\n      --json                 machine-readable output\n      --probe                doctor only: test the key with one request\n\nPipeline options:\n      --dir <path>           the pipeline folder; keep it between runs for rounds\n      --dry-run              show gates and stages, spend no tokens\n      --set KEY=VALUE        set a variable for every stage, repeatable\n      --gate NAME:COMMAND    skip the whole run unless COMMAND exits 0, repeatable\n      --stage ID:YAML        change one stage, e.g. 'plan:append_task: Be brief.'\n      --pipeline YAML        change the pipeline, e.g. 'append_summary: Be brief.'\n  -h, --help                 show this\n  -v, --version              show version\n\nEnvironment:\n  TESTEIYA_MODEL              model to run, e.g. openrouter/anthropic/claude-sonnet-5\n  TESTEIYA_FOLLOW_UP          the user's reply, same as --followup\n  TESTEIYA_THREAD             which conversation this is, same as --thread\n  TESTEIYA_SESSION_FILE       where to keep the session, same as --session-file\n  TESTEIYA_NO_DEFAULT_FOOTER  do not sign the report\n  OPENROUTER_API_KEY          provider key, also ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY\n  TESTOMATIO                  Testomat.io project API key\n  TESTOMATIO_PROJECT_ID       Testomat.io project id, same as --project\n  TESTOMATIO_URL              Testomat.io base url, for self-hosted\n\nRun \"testeiya help\" for the full guide.\n\nRunning a task\n\n  The agent runs one task and exits. There is no interactive mode. Progress and\n  errors go to stderr, so a run drops into CI as-is.\n\n  A task can also come from stdin:  cat task.md | testeiya task\n  A task starting with \"-\" must follow \"--\":  testeiya task -- \"-weird task\"\n\n  Exit codes: 0 pass, 1 failed run or negative verdict, 2 bad usage, 130 interrupted.\n\n  --exit-zero keeps a negative verdict from failing the command: a broken run\n  still exits 1 and bad usage still exits 2. The verdict is still in the report\n  and in the run envelope, so a pipeline can gate on it when it wants to.\n\nWhere the report goes\n\n  --output names a destination and can repeat. Without one the report goes to\n  stdout. --json prints the run envelope to stdout instead.\n\n  report.md       the agent writes the report there\n  run.json        the run envelope: verdict, reason, report, tokens, session id\n  gh:pr-comment   posted on this branch's pull request, through the GitHub CLI\n  gh:pr#123       posted on that pull request\n\n  --footer adds a line under the report and --header adds one above. Both go\n  wherever the report goes: stdout, the file, the posted comment. Use --footer\n  to say how to answer a comment, e.g. --footer \"> Reply with /testeiya\".\n\n  The report is signed, unless you write your own footer:\n\n    *\uD83E\uDDDA\uD83C\uDFFB\u200D\u2640\uFE0F Provided by [Testeiya QA Agent](https://testomat.ai/testeiya) & <model>*\n\n  A posted comment also opens with the Testeiya logo and heading, unless you\n  write your own --header.\n\n  --no-default-footer drops the signature and the heading, so does\n  TESTEIYA_NO_DEFAULT_FOOTER.\n\n  Every destination is checked before the run starts, so a missing gh costs no\n  tokens.\n\nComment threads\n\n  In a thread the agent looks after its own comments instead of piling them up.\n  A thread is any subject it posts into: a pull request, a merge request, an\n  issue. Every comment it writes opens with an invisible marker naming the\n  conversation and the commit it answered, so the next round finds its earlier\n  work even when nothing was cached.\n\n  Each round writes the complete current answer and makes the earlier ones\n  recede. GitHub folds them, Bitbucket resolves them, GitLab keeps one note and\n  rewrites it. Nothing is ever deleted. The host comes from the CI job, so a\n  local run is never in a thread.\n\n  --thread <name> says which conversation this is. Run two jobs on one pull\n  request, say one grilling it and one writing test cases, and give each its own\n  name so neither touches the other's comments. The default is \"default\".\n\n    testeiya task \"Review this pull request\" --thread qa-review -o gh:pr-comment\n\nModels and keys\n\n  There is no default model. Pass --model or set TESTEIYA_MODEL. A resumed run\n  reuses its session's model. \"testeiya models\" lists what your key can reach.\n\n  The provider key comes from the environment, from ~/.testeiya/.env, or from\n  ~/.testeiya/auth.json. The desktop app reads ~/.testeiya/.env too, so a key\n  there works in both.\n\nAnswering a reply\n\n  --followup carries what the user said back to the agent. The task stays the\n  standing instruction and the reply is added under it as a new user message,\n  so one command serves both the first round and every answer after it.\n\n  Set TESTEIYA_FOLLOW_UP instead when the text is a comment body: an empty\n  value is ignored, so the same job runs unchanged when nobody replied.\n\n    TESTEIYA_FOLLOW_UP=\"${{ github.event.comment.body || '' }}\" \\\n      testeiya task \"Review this pull request\" --session pr-42 -o gh:pr-comment\n\n  Pair it with --session <label> and the agent answers with its earlier work in\n  front of it. Without a session the reply is still delivered, just without the\n  thread behind it.\n\nSessions\n\n  Runs are saved under ~/.testeiya, so a follow-up picks up where the last one\n  stopped. -c continues the last session in this folder, --resume <id> picks\n  another, --name labels one, and --no-session saves nothing.\n\n  --session <label> is for a job that runs again and again on the same machine:\n  it continues the session with that name, and starts it the first time. Give\n  each thread its own label and they never mix.\n\n  --session-file <path> is the one for CI. The whole session is that one file,\n  so a runner that keeps nothing carries it between rounds as a cache or an\n  artifact. It is written the first time and continued after that, with no\n  \"does it exist yet\" branch. Keep it out of the working tree, or ignore it\n  there, so the agent does not read its own transcript back as a file.\n\n    testeiya task \"Review this pull request\" --session-file .cache/pr-42.jsonl\n\n  A saved session also records the commit it ran on, its branch and origin, and\n  the pull request it posted to. When the next round opens it on a newer commit,\n  the agent is told the range it has not read and reads that first. On a pull\n  request it is also told to read the comments added since. A round that broke\n  records nothing, so the one after it still catches up from where work stopped.\n  That history rides inside the session, so restoring it is all a round needs.\n  The checkout still needs enough history to reach the commit it stopped on.\n\nSkills\n\n  The package ships the skills the agent reads, and only those: skills found in\n  the folder it runs in are ignored, so a checkout cannot hand it its own.\n  \"testeiya skills\" lists them. Name one in the task with a slash and it is\n  loaded before the run, e.g. \"/qa-thinking\". A name we do not ship is left\n  alone, so a stray \"/word\" in the task is just a word.\n\nPipelines\n\n  A pipeline is several stages in one YAML file: agent tasks and shell commands,\n  run in order, passing files through one folder. \"testeiya pipeline\" lists the\n  bundled ones; pass a path to run your own.\n\n    testeiya pipeline web-testing -o gh:pr-comment\n    testeiya pipeline .github/testeiya/regression.yml --set TEST_COMMAND=\"npx playwright test\"\n\n  --gate adds a check from the CI job, e.g. --gate 'pr:test -n \"$PR_NUMBER\"'.\n  When it fails the whole run is skipped and exits 0.\n\n  --stage and --pipeline change a pipeline without copying it. Their value is\n  YAML: a plain key replaces, append_ and prepend_ add, remove_ drops.\n\n    testeiya pipeline issue-test-cases --stage 'requirements:append_task: Never assume credentials.'\n    testeiya pipeline web-testing --stage 'explore:{timeout: 45m, append_when: [staging]}'\n\n  A file of your own can start with \"extends: <name>\" and hold only the changes.\n\n  A stage whose gate fails is skipped with the gate's message. A final summary\n  reads every stage and is the only thing posted. Keep --dir between runs, as a\n  CI cache per pull request, and a re-run on the same commit retries from the\n  stage that stopped, while a new commit starts a round that updates the last one.\n  --dry-run shows the plan and spends nothing. \"testeiya pipeline-check\" checks\n  the file and every gate it declares, and prints the message of each gate that\n  does not pass. It exits 1 when one does not, 2 when the file is invalid.\n  --diagram also writes <name>.diagram.md: a Mermaid chart of the stages, the\n  files they pass on, and the gates, coloured by the check.\n\nTestomat.io\n\n  Set TESTOMATIO to a project API key and the agent reads and writes that\n  project's tests, suites, runs and plans through check-tests and the REST API.\n  Add the project id, with --project or TESTOMATIO_PROJECT_ID, and it also gets\n  the Testomat.io tools. The MCP server needs the id: a token alone does not say\n  which project to talk to.";
+export declare const COMMANDS: readonly ["task", "ask", "pipeline", "pipeline-check", "models", "skills", "doctor", "sessions", "help"];
+export declare function parseCliArgs(argv: string[]): CliArgs;
+export type Command = (typeof COMMANDS)[number];
+export interface CliArgs {
+    command?: Command | "welcome" | "usage" | "version";
+    prompt?: string;
+    pattern?: string;
+    outputs?: string[];
+    json?: boolean;
+    probe?: boolean;
+    model?: string;
+    project?: string;
+    followUp?: string;
+    thread?: string;
+    continueLast?: boolean;
+    resume?: string;
+    session?: string;
+    sessionFile?: string;
+    name?: string;
+    noSession?: boolean;
+    exitZero?: boolean;
+    header?: string;
+    footer?: string;
+    noDefaultFooter?: boolean;
+    noThread?: boolean;
+    pipeline?: string;
+    dir?: string;
+    dryRun?: boolean;
+    diagram?: boolean;
+    sets?: Record<string, string>;
+    gates?: Record<string, string>;
+    pipelineOverrides?: string[];
+    stageOverrides?: string[];
+    /** Set when argv was malformed; the caller prints the message and exits 2. */
+    error?: string;
+}

package/dist/src/attribution-extension.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/** Credit Testeiya, not pi, wherever a provider records who is calling. */
+export default function attributionExtension(pi: ExtensionAPI): void;

package/dist/src/checkpoint.d.ts

@@ -0,0 +1,30 @@
+import type { SessionManager } from "@earendil-works/pi-coding-agent";
+import type { Repo } from "./git.js";
+/**
+ * Where the checkout stood when a round finished. A resumed session carries the
+ * conversation but not the world it happened in: CI hands the next round a new
+ * commit and a thread of comments the transcript has never seen, and an agent
+ * that does not know that answers about code nobody is looking at any more.
+ */
+export declare function readCheckpoint(repo: Repo, pr?: number): Checkpoint | null;
+/** The checkpoint the last round left behind, if this session has one. */
+export declare function lastCheckpoint(manager: SessionManager): Checkpoint | null;
+/**
+ * Written only when the round produced something, so a broken run leaves the
+ * older commit standing and the next one still reads everything since.
+ */
+export declare function saveCheckpoint(manager: SessionManager, checkpoint: Checkpoint): void;
+/**
+ * What the agent has to catch up on, as a procedure it can run. Nothing moved
+ * means nothing is said — an unchanged checkout on a fresh comment still gets
+ * the pull request line, which is the whole point of a comment round.
+ */
+export declare function describeUpdate(previous: Checkpoint | null, current: Checkpoint | null): string | null;
+export interface Checkpoint {
+    commit: string;
+    /** ISO timestamp of the round that wrote it — the cut-off for "new comments". */
+    at: string;
+    branch?: string;
+    remote?: string;
+    pr?: number;
+}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
+import { chalkStderr as c } from "chalk";
 import { HELP, parseCliArgs, USAGE, WELCOME } from "./args.js";
 import { runDoctor } from "./doctor.js";
 import { loadEnvFiles, VERSION } from "./env.js";
 import { resolveModel, UsageError } from "./model.js";
 import { runModels } from "./models.js";
 import { runSkills } from "./skills.js";
-import { parseDestinations, preflight } from "./output.js";
 import { Pipeline } from "./pipeline/pipeline.js";
-import { runPrint } from "./run.js";
+import { runTask } from "./run.js";
 import { createRuntime } from "./session.js";
-import { openSessionManager, runSessions } from "./sessions.js";
+import { runSessions } from "./sessions.js";
 main(process.argv.slice(2)).catch((err) => {
     process.stderr.write(`${err?.message ?? err}\n`);
     process.exit(1);
@@ -72,42 +72,37 @@ async function task(args) {
         process.stderr.write(`  ${args.command} needs something to work on\n\n${USAGE}\n`);
         process.exit(2);
     }
-    const destinations = parseDestinations(args.outputs ?? [], args.json);
-    if (typeof destinations === "string")
-        throw new UsageError(destinations);
-    // Everything a destination needs is checked before a single token is spent.
-    const unreachable = await preflight(destinations);
-    if (unreachable)
-        throw new UsageError(unreachable);
-    // A job-level TESTEIYA_SESSION_FILE must not quietly redirect a run that named
-    // its own session on the command line.
-    if (!args.session && !args.resume && !args.continueLast) {
-        args.sessionFile ??= process.env.TESTEIYA_SESSION_FILE;
-    }
-    const sessionManager = await openSessionManager(process.cwd(), args);
-    if (typeof sessionManager === "string")
-        throw new UsageError(sessionManager);
-    if (args.name)
-        sessionManager.appendSessionInfo(args.name);
-    let sessionId = null;
-    if (!args.noSession)
-        sessionId = sessionManager.getSessionId();
-    const brief = args.command === "ask";
-    return runPrint({
+    const controller = new AbortController();
+    process.on("SIGINT", () => {
+        process.stderr.write(`${c.yellow("\n  ⨯ interrupted")}\n`);
+        controller.abort("interrupted");
+    });
+    const { envelope, code, undelivered } = await runTask({
         prompt,
         followUp,
-        destinations,
-        sessionManager,
-        sessionId,
-        brief,
-        thread: args.thread ?? process.env.TESTEIYA_THREAD,
+        outputs: args.outputs ?? [],
+        json: args.json,
+        brief: args.command === "ask",
+        continueLast: args.continueLast,
+        resume: args.resume,
+        session: args.session,
+        sessionFile: args.sessionFile,
+        noSession: args.noSession,
+        name: args.name,
         model: args.model,
-        exitZero: args.exitZero,
+        thread: args.thread,
         header: args.header,
         footer: args.footer,
         noDefaultFooter: args.noDefaultFooter,
         noThread: args.noThread,
-    });
+        exitZero: args.exitZero,
+    }, { signal: controller.signal });
+    // The report is worth more than the destination: never lose it.
+    if (undelivered && envelope.report)
+        process.stdout.write(envelope.report);
+    if (controller.signal.aborted)
+        return 130;
+    return code;
 }
 async function pipeline(args) {
     if (!args.pipeline)

package/dist/src/cli.js.map

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

package/dist/src/doctor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Everything a run resolves silently: which key file won, whether skills loaded,
+ * whether MCP is on. Reads config only — `--probe` is the one check that spends.
+ */
+export declare function runDoctor(options: DoctorOptions): Promise<number>;
+export interface DoctorOptions {
+    envSources: Map<string, string>;
+    json?: boolean;
+    probe?: boolean;
+    model?: string;
+}

package/dist/src/env.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Testeiya's state directory, shared with the desktop app: a provider key saved
+ * in its Settings dialog works here with no extra step.
+ */
+export declare const TESTEIYA_HOME: string;
+/**
+ * This package's root, found by walking up to package.json — `dist/src` when
+ * built, `src` when run from source. Bundled files resolve from here.
+ */
+export declare const PACKAGE_ROOT: string;
+/** This package's version, read from the same package.json. */
+export declare const VERSION: string;
+/**
+ * Where pi keeps its own state for this CLI. Deliberately not `~/.pi` — running
+ * `npx testeiya` must not write into a user's own pi installation.
+ */
+export declare const PI_STATE_DIR: string;
+/**
+ * Fill gaps in process.env from `~/.testeiya/.env`, then from any `.env` found
+ * walking up from the working directory — so running in a repo picks up that
+ * repo's key. Exported variables always win; this only fills gaps.
+ *
+ * The walk starts at cwd, never at this file: an installed package sits under
+ * some node_modules whose ancestors are none of the agent's business, and
+ * silently adopting a key from there is a surprise, not a convenience.
+ *
+ * Returns the file each variable came from, which is what `doctor` reports.
+ */
+export declare function loadEnvFiles(): Map<string, string>;
+export declare function parseEnv(content: string): Record<string, string>;

package/dist/src/exec.d.ts

@@ -0,0 +1,11 @@
+/** Run a command and collect it. Never throws: a missing binary is code 127. */
+export declare function run(command: string, args: string[], options?: RunOptions): Promise<Executed>;
+export interface RunOptions {
+    cwd?: string;
+    stdin?: string;
+}
+export interface Executed {
+    code: number;
+    stdout: string;
+    stderr: string;
+}

package/dist/src/git.d.ts

@@ -0,0 +1,41 @@
+/** The git questions the CLI asks about its checkout. */
+export declare class Git {
+    private readonly cwd;
+    constructor(cwd: string);
+    headCommit(): Promise<string | null>;
+    /** The PR source branch in CI, or the checked-out branch locally. */
+    branch(env?: Env): Promise<string | null>;
+    /**
+     * Where the checkout stands, read once. The marker stamps the commit on a
+     * comment, the pull request section picks its host from the remote, and the
+     * checkpoint keeps both for the next round — one set of git calls for all three.
+     */
+    repo(): Promise<Repo>;
+    /**
+     * The files this change touched. A later round counts from the commit the last
+     * round ran on; the first round, or a `since` the checkout cannot reach (a
+     * force-push), counts from the merge base with the target branch.
+     */
+    changes(since: string | null, env: Env): Promise<Changes>;
+    /** The target branch, as the CI names it. */
+    private baseBranch;
+    private diff;
+    private reachable;
+    /** Trimmed stdout, or null when git fails or says nothing. */
+    private read;
+    private git;
+}
+type Env = Record<string, string | undefined>;
+export interface Repo {
+    commit: string | null;
+    branch: string | null;
+    remote: string | null;
+}
+export interface Changes {
+    /** Null when git could not say. */
+    files: string[] | null;
+    /** The commit or branch they were counted from. */
+    from: string;
+    error?: string;
+}
+export {};

package/dist/src/langfuse-extension.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * The run as a Langfuse trace: one agent observation per prompt, a generation
+ * per LLM call with tokens and cost, a tool observation per tool call. Off
+ * unless LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY are both set.
+ */
+export default function langfuseExtension(pi: ExtensionAPI): void;

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/models.d.ts

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