testeiya 0.3.9 → 0.3.14

package/dist/src/args.js

@@ -1,72 +1,224 @@
 import { parseArgs } from "node:util";
-export const USAGE = `testeiya — AI testing agent
+export const WELCOME = `
+  Testeiya, an AI testing agent.
+
+  testeiya task "analyze this pr and find inconsistencies"
+  testeiya ask "is this feature ready"
+
+  testeiya doctor    check your setup
+  testeiya --help    options and environment
+  testeiya help      the full guide
+`;
+export const USAGE = `testeiya, an AI testing agent
 
 Usage:
-  testeiya "<task>" --model <provider>/<id> [--output <file>]
-  cat task.md | testeiya [--output <file>]
+  testeiya task "<task>"      run one task and write a report
+  testeiya ask "<question>"   answer a question
+  testeiya doctor             check what a run would resolve
+  testeiya models [pattern]   list the models your key can reach
+  testeiya skills [pattern]   list the skills bundled with this package
+  testeiya sessions           list saved sessions for this folder
 
 Options:
-  -o, --output <file.md>   file the agent must write its report to
-  -p, --print <task>       same as passing the task positionally
-      --model <id>         provider/model to use, e.g. openrouter/anthropic/claude-sonnet-5
-      --project <id>       Testomat.io project id (same as TESTOMATIO_PROJECT_ID)
-  -h, --help               show this help
+  -o, --output <dest>      report destination, repeatable: file.md, file.json, gh:pr-comment
+      --model <id>         provider/model to run
+      --project <id>       Testomat.io project id
+  -c, --continue           continue the last session in this folder
+      --resume <id>        continue that session
+      --session <label>    continue the session with that name, or start it
+      --name <label>       name the session
+      --no-session         do not save the session
+      --exit-zero          a negative verdict exits 0
+      --header <text>      line added above the report
+      --footer <text>      line added under the report
+      --no-default-footer  do not sign the report
+      --json               machine-readable output
+      --probe              doctor only: test the key with one request
+  -h, --help               show this
   -v, --version            show version
 
-Runs show progress and errors on stderr; the result is the report file.
-Without --output the agent's final answer is printed to stdout instead.
+Environment:
+  TESTEIYA_MODEL              model to run, e.g. openrouter/anthropic/claude-sonnet-5
+  TESTEIYA_NO_DEFAULT_FOOTER  do not sign the report
+  OPENROUTER_API_KEY          provider key, also ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY
+  TESTOMATIO                  Testomat.io project API key
+  TESTOMATIO_PROJECT_ID       Testomat.io project id, same as --project
+  TESTOMATIO_URL              Testomat.io base url, for self-hosted
+
+Run "testeiya help" for the full guide.`;
+export const HELP = `${USAGE}
+
+Running a task
+
+  The agent runs one task and exits. There is no interactive mode. Progress and
+  errors go to stderr, so a run drops into CI as-is.
+
+  A task can also come from stdin:  cat task.md | testeiya task
+  A task starting with "-" must follow "--":  testeiya task -- "-weird task"
+
+  Exit codes: 0 pass, 1 failed run or negative verdict, 2 bad usage, 130 interrupted.
+
+  --exit-zero keeps a negative verdict from failing the command: a broken run
+  still exits 1 and bad usage still exits 2. The verdict is still in the report
+  and in the run envelope, so a pipeline can gate on it when it wants to.
+
+Where the report goes
+
+  --output names a destination and can repeat. Without one the report goes to
+  stdout. --json prints the run envelope to stdout instead.
+
+  report.md       the agent writes the report there
+  run.json        the run envelope: verdict, reason, report, tokens, session id
+  gh:pr-comment   posted on this branch's pull request, through the GitHub CLI
+  gh:pr#123       posted on that pull request
+
+  --footer adds a line under the report and --header adds one above. Both go
+  wherever the report goes: stdout, the file, the posted comment. Use --footer
+  to say how to answer a comment, e.g. --footer "> Reply with /testeiya".
+
+  The report is signed, unless you write your own footer:
 
-There is no default model: pass --model or set TESTEIYA_MODEL, or the run exits 2.
-The provider API key comes from the environment, ~/.testeiya/.env, or
-~/.testeiya/auth.json.
+    *🧚🏻‍♀️ Provided by [Testeiya QA Agent](https://testomat.ai/testeiya) & <model>*
 
-Set TESTOMATIO to a project API key to work with that Testomat.io project. Add
-the project id (--project or TESTOMATIO_PROJECT_ID) and the agent also gets the
-Testomat.io tools; with the token alone it uses check-tests and the REST API.
+  --no-default-footer drops the signature, so does TESTEIYA_NO_DEFAULT_FOOTER.
 
-A task starting with "-" must follow "--":  testeiya -- "-weird task"
+  Every destination is checked before the run starts, so a missing gh costs no
+  tokens.
 
-Exit codes: 0 pass · 1 failed run or verdict · 2 bad usage · 130 interrupted.`;
+Models and keys
+
+  There is no default model. Pass --model or set TESTEIYA_MODEL. A resumed run
+  reuses its session's model. "testeiya models" lists what your key can reach.
+
+  The provider key comes from the environment, from ~/.testeiya/.env, or from
+  ~/.testeiya/auth.json, which is the file the desktop app's Settings dialog
+  writes.
+
+Sessions
+
+  Runs are saved under ~/.testeiya, so a follow-up picks up where the last one
+  stopped. -c continues the last session in this folder, --resume <id> picks
+  another, --name labels one, and --no-session saves nothing.
+
+  --session <label> is the one for a job that runs again and again: it continues
+  the session with that name, and starts it the first time. Give each thread its
+  own label and they never mix.
+
+Skills
+
+  The package ships the skills the agent reads, and only those: skills found in
+  the folder it runs in are ignored, so a checkout cannot hand it its own.
+  "testeiya skills" lists them. Name one in the task with a slash and it is
+  loaded before the run, e.g. "/qa-thinking". A name we do not ship is left
+  alone, so a stray "/word" in the task is just a word.
+
+Testomat.io
+
+  Set TESTOMATIO to a project API key and the agent reads and writes that
+  project's tests, suites, runs and plans through check-tests and the REST API.
+  Add the project id, with --project or TESTOMATIO_PROJECT_ID, and it also gets
+  the Testomat.io tools. The MCP server needs the id: a token alone does not say
+  which project to talk to.`;
+export const COMMANDS = ["task", "ask", "models", "skills", "doctor", "sessions", "help"];
 export function parseCliArgs(argv) {
+    const first = argv[0];
+    if (!first)
+        return { command: "welcome" };
+    if (first === "-h" || first === "--help")
+        return { command: "usage" };
+    if (first === "-v" || first === "--version")
+        return { command: "version" };
+    if (!isCommand(first))
+        return { error: unknownCommand(first) };
+    if (first === "help")
+        return { command: "help" };
+    const options = OPTIONS[first];
     let parsed;
     try {
-        parsed = parseArgs({
-            args: argv,
-            options: {
-                output: { type: "string", short: "o" },
-                print: { type: "string", short: "p" },
-                model: { type: "string" },
-                project: { type: "string" },
-                help: { type: "boolean", short: "h" },
-                version: { type: "boolean", short: "v" },
-            },
-            allowPositionals: true,
-            strict: true,
-        });
+        parsed = parseArgs({ args: argv.slice(1), options, allowPositionals: true, strict: true });
     }
     catch (err) {
         if (err instanceof Error)
             return { error: err.message };
         return { error: String(err) };
     }
-    const { values, positionals } = parsed;
+    const values = parsed.values;
     if (values.help)
-        return { help: true };
-    if (values.version)
-        return { version: true };
-    const parts = [...positionals];
-    if (values.print)
-        parts.unshift(values.print);
-    const prompt = parts.join(" ").trim();
-    const args = {};
-    if (prompt)
-        args.prompt = prompt;
-    if (values.output)
-        args.output = values.output;
-    if (values.model)
+        return { command: "usage" };
+    const args = { command: first };
+    const text = parsed.positionals.join(" ").trim();
+    if ((first === "task" || first === "ask") && text)
+        args.prompt = text;
+    if ((first === "models" || first === "skills") && text)
+        args.pattern = text;
+    if (Array.isArray(values.output))
+        args.outputs = values.output;
+    if (values.json)
+        args.json = true;
+    if (values.probe)
+        args.probe = true;
+    if (typeof values.model === "string")
         args.model = values.model;
-    if (values.project)
+    if (typeof values.project === "string")
         args.project = values.project;
+    if (values.continue)
+        args.continueLast = true;
+    if (typeof values.resume === "string")
+        args.resume = values.resume;
+    if (typeof values.session === "string")
+        args.session = values.session;
+    if (typeof values.name === "string")
+        args.name = values.name;
+    if (values["no-session"])
+        args.noSession = true;
+    if (values["exit-zero"])
+        args.exitZero = true;
+    if (typeof values.header === "string")
+        args.header = values.header;
+    if (typeof values.footer === "string")
+        args.footer = values.footer;
+    if (values["no-default-footer"])
+        args.noDefaultFooter = true;
+    if (args.session && (args.continueLast || args.resume || args.name || args.noSession)) {
+        return { error: "--session already names and continues a session" };
+    }
     return args;
 }
+const HELP_FLAG = { type: "boolean", short: "h" };
+const JSON_FLAG = { type: "boolean" };
+const RUN_OPTIONS = {
+    output: { type: "string", short: "o", multiple: true },
+    json: JSON_FLAG,
+    model: { type: "string" },
+    project: { type: "string" },
+    continue: { type: "boolean", short: "c" },
+    resume: { type: "string" },
+    session: { type: "string" },
+    name: { type: "string" },
+    "no-session": { type: "boolean" },
+    "exit-zero": { type: "boolean" },
+    header: { type: "string" },
+    footer: { type: "string" },
+    "no-default-footer": { type: "boolean" },
+    help: HELP_FLAG,
+};
+const OPTIONS = {
+    task: RUN_OPTIONS,
+    ask: RUN_OPTIONS,
+    models: { json: JSON_FLAG, help: HELP_FLAG },
+    skills: { json: JSON_FLAG, help: HELP_FLAG },
+    doctor: { json: JSON_FLAG, probe: { type: "boolean" }, model: { type: "string" }, help: HELP_FLAG },
+    sessions: { json: JSON_FLAG, help: HELP_FLAG },
+    help: {},
+};
+function isCommand(value) {
+    return COMMANDS.includes(value);
+}
+// The task used to be the first positional, so a bare prompt is the mistake to
+// expect. Name the fix rather than printing the whole usage at them.
+function unknownCommand(value) {
+    if (value.startsWith("-"))
+        return `unknown option "${value}"`;
+    return `unknown command "${value}" — did you mean:  testeiya task "${value}"`;
+}
 //# sourceMappingURL=args.js.map

package/dist/src/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;8EA2ByD,CAAC;AAE/E,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;gBACtC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;gBACrC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;aACzC;YACD,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvC,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEtC,MAAM,IAAI,GAAY,EAAE,CAAC;IACzB,IAAI,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,MAAM,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO;QAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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"}

package/dist/src/cli.js

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { parseCliArgs, USAGE } from "./args.js";
-import { loadEnvFiles } from "./env.js";
+import { HELP, parseCliArgs, USAGE, WELCOME } from "./args.js";
+import { runDoctor } from "./doctor.js";
+import { loadEnvFiles, VERSION } from "./env.js";
 import { UsageError } from "./model.js";
+import { runModels } from "./models.js";
+import { runSkills } from "./skills.js";
+import { parseDestinations, preflight } from "./output.js";
 import { runPrint } from "./run.js";
+import { openSessionManager, runSessions } from "./sessions.js";
 main(process.argv.slice(2)).catch((err) => {
     process.stderr.write(`${err?.message ?? err}\n`);
     process.exit(1);
@@ -16,28 +19,38 @@ async function main(argv) {
         process.stderr.write(`${args.error}\n\n${USAGE}\n`);
         process.exit(2);
     }
-    if (args.help) {
+    if (args.command === "welcome") {
+        process.stdout.write(`${WELCOME}\n`);
+        return;
+    }
+    if (args.command === "usage") {
         process.stdout.write(`${USAGE}\n`);
         return;
     }
-    if (args.version) {
-        process.stdout.write(`${version()}\n`);
+    if (args.command === "help") {
+        process.stdout.write(`${HELP}\n`);
+        return;
+    }
+    if (args.command === "version") {
+        process.stdout.write(`${VERSION}\n`);
         return;
     }
-    loadEnvFiles();
+    const envSources = loadEnvFiles();
     // --project is a spelling of the env var the MCP server needs, so the rest of
     // the CLI only ever reads the environment.
     if (args.project)
         process.env.TESTOMATIO_PROJECT_ID = args.project;
-    // No task and nothing piped in: there is no interactive mode, so this is a
-    // usage error rather than a prompt.
-    const prompt = args.prompt ?? (await readStdin());
-    if (!prompt.trim()) {
-        process.stderr.write(`${USAGE}\n`);
-        process.exit(2);
-    }
     try {
-        process.exit(await runPrint({ prompt, outputFile: args.output, model: args.model }));
+        if (args.command === "models")
+            process.exit(await runModels(args.pattern, args.json));
+        if (args.command === "skills")
+            process.exit(await runSkills(args.pattern, args.json));
+        if (args.command === "doctor") {
+            process.exit(await runDoctor({ envSources, json: args.json, probe: args.probe, model: args.model }));
+        }
+        if (args.command === "sessions")
+            process.exit(await runSessions(process.cwd(), args.json));
+        process.exit(await task(args));
     }
     catch (err) {
         if (!(err instanceof UsageError))
@@ -46,6 +59,41 @@ async function main(argv) {
         process.exit(2);
     }
 }
+async function task(args) {
+    const prompt = args.prompt ?? (await readStdin());
+    if (!prompt.trim()) {
+        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);
+    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({
+        prompt,
+        destinations,
+        sessionManager,
+        sessionId,
+        brief,
+        model: args.model,
+        exitZero: args.exitZero,
+        header: args.header,
+        footer: args.footer,
+        noDefaultFooter: args.noDefaultFooter,
+    });
+}
 async function readStdin() {
     if (process.stdin.isTTY)
         return "";
@@ -54,8 +102,4 @@ async function readStdin() {
         chunks.push(chunk);
     return Buffer.concat(chunks).toString("utf8");
 }
-function version() {
-    const pkg = JSON.parse(readFileSync(join(import.meta.dirname, "..", "..", "package.json"), "utf8"));
-    return pkg.version;
-}
 //# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC;IAE3B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,OAAO,KAAK,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,YAAY,EAAE,CAAC;IACf,8EAA8E;IAC9E,2CAA2C;IAC3C,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC;IAEnE,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,YAAY,UAAU,CAAC;YAAE,MAAM,GAAG,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAC5E,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/doctor.js

@@ -0,0 +1,171 @@
+import { existsSync } from "node:fs";
+import { relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { TESTEIYA_HOME } from "./env.js";
+import { hasMcp, hasTestomatio, metadataCachePath, vendorBundle } from "./mcp.js";
+import { PROVIDER_KEYS, resolveModel, UsageError } from "./model.js";
+import { loadBundledSkills } from "./skills.js";
+import { BUNDLED_SKILLS_DIR, createRuntime } from "./session.js";
+const MIN_NODE = [22, 19];
+/**
+ * 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 async function runDoctor(options) {
+    const checks = [nodeCheck(), homeCheck()];
+    const runtime = await createRuntime();
+    checks.push(keyCheck(runtime, options.envSources));
+    const model = modelCheck(runtime, options.model);
+    checks.push(model.check);
+    const skills = await skillsChecks();
+    checks.push(...skills.checks);
+    checks.push(testomatioCheck(), mcpCacheCheck());
+    if (options.probe)
+        checks.push(await probeCheck(runtime, model.resolved));
+    if (options.json) {
+        const report = {
+            checks: checks.filter((check) => check.status !== "list"),
+            skills: skills.groups,
+        };
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return worst(checks) === "fail" ? 1 : 0;
+    }
+    process.stdout.write("\n");
+    for (const check of checks) {
+        process.stdout.write(`  ${MARK[check.status]} ${check.name.padEnd(12)} ${check.detail}\n`);
+    }
+    process.stdout.write("\n");
+    return worst(checks) === "fail" ? 1 : 0;
+}
+function nodeCheck() {
+    const version = process.versions.node;
+    const [major = 0, minor = 0] = version.split(".").map(Number);
+    if (major > MIN_NODE[0] || (major === MIN_NODE[0] && minor >= MIN_NODE[1])) {
+        return { name: "node", status: "ok", detail: `v${version}` };
+    }
+    return { name: "node", status: "fail", detail: `v${version}, needs v22.19 or newer` };
+}
+function homeCheck() {
+    if (!existsSync(TESTEIYA_HOME)) {
+        return { name: "home", status: "warn", detail: `${TESTEIYA_HOME} (not created yet)` };
+    }
+    return { name: "home", status: "ok", detail: TESTEIYA_HOME };
+}
+// The key can come from four places and nothing else ever says which one won.
+function keyCheck(runtime, sources) {
+    const found = [];
+    for (const { provider, env } of PROVIDER_KEYS) {
+        if (process.env[env]) {
+            found.push(`${provider} from ${sources.get(env) ?? "environment"}`);
+            continue;
+        }
+        if (runtime.hasConfiguredAuth(provider))
+            found.push(`${provider} from auth.json`);
+    }
+    if (found.length === 0) {
+        return { name: "key", status: "fail", detail: "none — set OPENROUTER_API_KEY or similar" };
+    }
+    return { name: "key", status: "ok", detail: found.join(", ") };
+}
+function modelCheck(runtime, explicit) {
+    try {
+        const model = resolveModel(runtime, explicit);
+        return {
+            check: { name: "model", status: "ok", detail: `${model.provider}/${model.id}` },
+            resolved: model,
+        };
+    }
+    catch (err) {
+        const detail = err instanceof UsageError ? err.message : String(err);
+        return { check: { name: "model", status: "warn", detail } };
+    }
+}
+async function skillsChecks() {
+    const { count, groups, diagnostics } = await loadBundledSkills();
+    const checks = [];
+    if (count === 0) {
+        checks.push({ name: "skills", status: "warn", detail: "none loaded" });
+    }
+    if (count > 0) {
+        checks.push({ name: "skills", status: "ok", detail: `${count} loaded` });
+        for (const { group, skills } of groups) {
+            const names = skills.map((skill) => skill.name);
+            checks.push({ name: "", status: "list", detail: `${group.padEnd(28)} ${summarize(names)}` });
+        }
+    }
+    // Collisions and parse errors were dropped on the floor before this command.
+    for (const diagnostic of diagnostics) {
+        const status = diagnostic.type === "error" ? "fail" : "warn";
+        let detail = diagnostic.message;
+        if (diagnostic.path)
+            detail = `${detail} — ${shorten(diagnostic.path)}`;
+        checks.push({ name: "skills", status, detail });
+    }
+    const listed = groups.map(({ group, skills }) => ({
+        group,
+        skills: skills.map((skill) => skill.name),
+    }));
+    return { checks, groups: listed };
+}
+function shorten(path) {
+    const inBundle = relative(BUNDLED_SKILLS_DIR, path);
+    if (inBundle.startsWith(".."))
+        return path;
+    return inBundle;
+}
+// The full list is `testeiya skills`; this line only proves the right set loaded.
+function summarize(names) {
+    if (names.length <= 6)
+        return names.join(", ");
+    return `${names.slice(0, 6).join(", ")}, +${names.length - 6}`;
+}
+function testomatioCheck() {
+    if (!hasTestomatio()) {
+        return { name: "testomatio", status: "warn", detail: "no TESTOMATIO token, not connected" };
+    }
+    if (!hasMcp()) {
+        return {
+            name: "testomatio",
+            status: "warn",
+            detail: "token set, no project id — check-tests and REST only",
+        };
+    }
+    return { name: "testomatio", status: "ok", detail: "token and project id, MCP tools on" };
+}
+function mcpCacheCheck() {
+    if (!hasMcp())
+        return { name: "mcp", status: "ok", detail: "off" };
+    const bundle = fileURLToPath(vendorBundle());
+    if (!existsSync(bundle)) {
+        return { name: "mcp", status: "fail", detail: "vendor bundle missing — run npm run build" };
+    }
+    if (!existsSync(metadataCachePath())) {
+        return { name: "mcp", status: "warn", detail: "tool cache empty, first run is proxy-only" };
+    }
+    return { name: "mcp", status: "ok", detail: "direct tools and proxy" };
+}
+async function probeCheck(runtime, model) {
+    if (!model)
+        return { name: "probe", status: "warn", detail: "skipped, no model to probe" };
+    const message = await runtime
+        .completeSimple(model, { messages: [{ role: "user", content: "ping", timestamp: Date.now() }] })
+        .catch((err) => ({ stopReason: "error", errorMessage: String(err) }));
+    if (message.stopReason === "error") {
+        return { name: "probe", status: "fail", detail: message.errorMessage ?? "request failed" };
+    }
+    return { name: "probe", status: "ok", detail: "the key works" };
+}
+function worst(checks) {
+    if (checks.some((check) => check.status === "fail"))
+        return "fail";
+    if (checks.some((check) => check.status === "warn"))
+        return "warn";
+    return "ok";
+}
+const MARK = {
+    ok: "✓",
+    warn: "!",
+    fail: "✗",
+    list: " ",
+};
+//# sourceMappingURL=doctor.js.map

package/dist/src/doctor.js.map

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