testeiya 0.10.0 → 0.10.2

package/PIPELINES.md

@@ -15,6 +15,7 @@ how to use pipelines in CI.
 ```yaml
 name: regression
 description: Run the tests a change can break, then explain the failures.
+target: pr
 
 summary: |
   Lead with failures this change caused. Flaky tests go last.
@@ -67,6 +68,7 @@ stages:
 | `extends` | no | A bundled pipeline or a `.yml` path to start from. See [Overrides](#overrides) |
 | `name` | no | Shown in logs and `pipeline.json`. Default: the file name |
 | `description` | no | One line, shown by `testeiya pipeline` |
+| `target` | no | What starts it: `issue`, `pr`, `daily-cron`, `weekly-cron`, or your own word. `testeiya pipeline` groups by it |
 | `summary` | no | Extra instructions for the final summary |
 | `env` | no | Variables for every stage. Values expand `${NAME}` |
 | `gates` | no | Named checks, defined once. See [Gates](#gates) |
@@ -209,6 +211,7 @@ Every key is optional. All given must hold, and at least one file must count.
 | `STAGE_DIR` | absolute path of the stage's own folder |
 | `PIPELINE_NAME` | the pipeline's name |
 | `PIPELINE_ROUND` | 1, 2, … |
+| `GIT_BRANCH` | `GITHUB_HEAD_REF`, `CI_MERGE_REQUEST_SOURCE_BRANCH_NAME` or `BITBUCKET_BRANCH`, then the checked-out Git branch; empty for a detached local HEAD |
 | `ITEM` | in a loop: the line, or the file's path |
 | `ITEM_NAME` | in an `each_file` loop: the file name without its extension |
 | `PIPELINE_RESUME` | `1` when a command stage is retried |

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
@@ -219,6 +209,7 @@ path.
 ```yaml
 name: web-testing
 description: Review a pull request, test it in a browser, explain what broke.
+target: pr
 
 gates:
   staging:
@@ -252,7 +243,8 @@ stages:
 ```
 
 - A stage is a `task` for the agent or a `run` shell command. Its `title` and
-  `emoji` head its section in the final report, `### 🔍 Review`.
+  `emoji` head its section in the final report, `### 🔍 Review`. Both are
+  optional: the title defaults to the id, the emoji is picked for you.
 - Each stage keeps its files in a numbered folder, `1-review/`, `2-explore/`, …,
   so a run reads in order. An agent stage writes `<id>.md` and `<id>.json`, a
   command writes `<id>.log`. `outputs` name the rest. `inputs` are linked into
@@ -728,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/system-prompt.js

@@ -14,7 +14,7 @@ export function buildSystemPrompt(options) {
     const date = new Date().toISOString().split("T")[0];
     const clis = options.connectedClis?.join(", ") || "none connected yet";
     const mcps = options.connectedMcps?.join(", ") || "none connected yet";
-    let manualTestsHint = " Pulled manual tests usually live in `.testeiya/manual-tests/`; check there before declaring the project has no manual tests.";
+    let manualTestsHint = " Pulled manual tests usually live in `.testeiya/test-cases/`; check there before declaring the project has no manual tests.";
     if (options.manualTestsHint === false)
         manualTestsHint = "";
     const prompt = dedent `

package/dist/prompt/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../prompt/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;IACvE,IAAI,eAAe,GAAG,+HAA+H,CAAC;IACtJ,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK;QAAE,eAAe,GAAG,EAAE,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,CAAA;;;;;;;;;;;EAWrB,MAAM,CAAC,OAAO,CAAC;;;;;;;;;;EAUf,OAAO;;;;sBAIa,GAAG;;;;;;yYAMgX,eAAe;;;;;;gBAMxY,IAAI;;;;;;;;EAQlB,UAAU,EAAE;;;;uBAIS,IAAI;yBACF,IAAI;;;;;CAK5B,CAAC;IAEA,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpG,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../prompt/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;IACvE,IAAI,eAAe,GAAG,6HAA6H,CAAC;IACpJ,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK;QAAE,eAAe,GAAG,EAAE,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,CAAA;;;;;;;;;;;EAWrB,MAAM,CAAC,OAAO,CAAC;;;;;;;;;;EAUf,OAAO;;;;sBAIa,GAAG;;;;;;yYAMgX,eAAe;;;;;;gBAMxY,IAAI;;;;;;;;EAQlB,UAAU,EAAE;;;;uBAIS,IAAI;yBACF,IAAI;;;;;CAK5B,CAAC;IAEA,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpG,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

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/git.js

@@ -8,6 +8,16 @@ export class Git {
     headCommit() {
         return this.read("rev-parse", "HEAD");
     }
+    /** The PR source branch in CI, or the checked-out branch locally. */
+    async branch(env = process.env) {
+        if (env.GITHUB_HEAD_REF)
+            return env.GITHUB_HEAD_REF;
+        if (env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME)
+            return env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME;
+        if (env.BITBUCKET_BRANCH)
+            return env.BITBUCKET_BRANCH;
+        return this.read("branch", "--show-current");
+    }
     /**
      * 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

package/dist/src/git.js.map

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

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;