@ia-qa/pal 0.1.0 → 0.3.0

package/dist/cli/index.js

@@ -1,8 +1,44 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-const tour_1 = require("../tour");
+const readline = __importStar(require("readline/promises"));
+const path = __importStar(require("path"));
 const report_1 = require("../report");
+const setup_1 = require("../setup");
+const run_1 = require("../run");
 const VERSION = require('../../package.json').version;
 const HELP = `ia-qa-pal — a QA pal next to your team
 
@@ -13,23 +49,51 @@ Runs entirely on your machine with a local browser. No LLM, nothing uploaded.
 [FOR AI AGENTS] You are driving this for a human. Read the whole report, the
 "Not seen" section included: a clean tour over part of an app is not a clean
 app, and you must say which part was not seen. A first tour establishes the
-baseline — never report it as a pass. Never run \`ia-qa-heal login\`: it waits
-for a human at a browser; ask them to run it.
+baseline — never report it as a pass. Set a project up with flags only
+(\`setup --url … --login … --yes\`), with answers the human gave you — never
+guessed. Never run \`ia-qa-heal login\`: it waits for a human at a browser; ask
+them. Never apply the repairs a tour proposes without the human's review.
 
 Usage:
   ia-qa-pal tour                 First run: every page on the surface, the first
                                  batch in depth, checks, baseline.
                                  Next runs: re-capture, compare, check.
+                                 With a test suite declared: its selectors are
+                                 read, repairs are proposed (never applied).
+                                 No config yet: asks the setup questions first
+                                 (in a terminal), otherwise says what is missing.
     --more                       explore the next batch in depth instead
+    --suite                      also run the testCommand from config.json once,
+                                 with the capture hook, to learn which pages
+                                 the suite never visits
+    --background                 start the tour detached and return at once;
+                                 follow it with \`ia-qa-pal status\`
     --batch <n>                  pages per depth batch (default 10)
     --json                       the report as one JSON document on stdout
     --session <file>             a Playwright storageState to reuse
     --config <dir>               project holding .ia-qa/ (default: here)
 
-Exit codes: 0 nothing to decide · 1 something broke or needs a decision ·
-2 could not answer (no config, nothing mapped, refused).
+  ia-qa-pal status               The tour running now (phase, progress) or the
+                                 last one (its report).
+    --json                       as one JSON document
+    --config <dir>               project folder (default: here)
+
+  ia-qa-pal setup                Write .ia-qa/config.json: the app address, how it
+                                 logs in, its pages (from sitemap.xml, else by
+                                 following its links), and your test suite.
+                                 Never overwrites a config.
+    --url <https://…>            the app
+    --login none|browser|session none; by hand in a browser (then run
+                                 ${setup_1.LOGIN_COMMAND});
+                                 or a storageState your suite already writes
+    --session <file>             that storageState (with --login session)
+    --tests <dir>[,<dir>…]       folders of your end-to-end suite
+    --test-command "<cmd>"       the command that runs it (else detected)
+    --yes                        write without asking
+    --config <dir>               project folder (default: here)
 
-Needs a .ia-qa/config.json with a baseUrl and pages: ia-qa-heal init.
+Exit codes: 0 nothing to decide · 1 something broke or needs a decision ·
+2 could not answer (not set up, nothing mapped, refused, already running).
 `;
 function valueOf(args, flag) {
     const i = args.indexOf(flag);
@@ -40,6 +104,61 @@ function valueOf(args, flag) {
         throw new Error(`${flag} needs a value.`);
     return v;
 }
+const interactive = () => !!process.stdin.isTTY && !!process.stderr.isTTY && !process.env.CI;
+async function withPrompt(fn) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await fn((q) => rl.question(q));
+    }
+    finally {
+        rl.close();
+    }
+}
+function loginFlag(args) {
+    const v = valueOf(args, '--login');
+    if (v === undefined)
+        return undefined;
+    if (v !== 'none' && v !== 'browser' && v !== 'session')
+        throw new Error('--login takes none, browser or session.');
+    return v;
+}
+function printSetup(outcome, json) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify({ schema: 'ia-qa-pal/setup@1', ...outcome }, null, 2)}\n`);
+        return;
+    }
+    if (!outcome.written) {
+        for (const p of outcome.problems)
+            process.stderr.write(`❌ ${p}\n`);
+        return;
+    }
+    process.stderr.write(`\n✅ Written: ${outcome.file}\n`);
+    if (outcome.next === setup_1.LOGIN_COMMAND) {
+        process.stderr.write(`\nNext, by a person at a browser (an agent cannot do this):\n  ${setup_1.LOGIN_COMMAND}\nthen:\n  ia-qa-pal tour\n`);
+        if (outcome.pagesFrom !== 'sitemap') {
+            process.stderr.write('\nThe pages were found without logging in. Once logged in, list the ones behind the login:\n' +
+                '  npx -p @ia-qa/self-healing ia-qa-heal discover --crawl --apply\n');
+        }
+    }
+    else {
+        process.stderr.write(`\nNext:\n  ia-qa-pal tour\n`);
+    }
+}
+function renderStatus(run, dir) {
+    if (!run)
+        return 'No tour has run on this project yet. Start one: ia-qa-pal tour\n';
+    if (run.status === 'running') {
+        const p = run.progress;
+        const where = p ? `${p.phase}${p.total ? ` ${p.done ?? 0}/${p.total}` : ''}${p.page ? ` · ${p.page}` : ''}` : 'starting';
+        return `⏳ A tour is running (pid ${run.pid}, since ${run.startedAt}) — ${where}\n   log: ${(0, run_1.logFile)(dir)}\n`;
+    }
+    if (run.status === 'interrupted') {
+        return `⚠ The last tour stopped before finishing (pid ${run.pid}, started ${run.startedAt}, last seen ${run.updatedAt}). Nothing it did after that is reported. Run it again: ia-qa-pal tour\n`;
+    }
+    if (run.status === 'failed')
+        return `❌ The last tour failed (${run.finishedAt}): ${run.error}\n`;
+    return `Last tour finished ${run.finishedAt}.\n\n${run.report ? (0, report_1.renderReport)(run.report) : ''}`;
+}
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0];
@@ -51,32 +170,74 @@ async function main() {
         process.stdout.write(`${VERSION}\n`);
         return;
     }
-    if (command !== 'tour') {
-        process.stderr.write(`Unknown command "${command}". Run ia-qa-pal help.\n`);
-        process.exitCode = 2;
-        return;
-    }
     const json = args.includes('--json');
     try {
+        const dir = path.resolve(valueOf(args, '--config') ?? process.cwd());
+        if (command === 'setup') {
+            const tests = valueOf(args, '--tests');
+            const options = {
+                dir,
+                url: valueOf(args, '--url'),
+                login: loginFlag(args),
+                session: valueOf(args, '--session'),
+                tests: tests ? tests.split(',') : undefined,
+                testCommand: valueOf(args, '--test-command'),
+                yes: args.includes('--yes'),
+            };
+            const outcome = interactive() && !json ? await withPrompt((ask) => (0, setup_1.runSetup)({ ...options, ask })) : await (0, setup_1.runSetup)(options);
+            printSetup(outcome, json);
+            process.exitCode = outcome.written ? 0 : 2;
+            return;
+        }
+        if (command === 'status') {
+            const run = (0, run_1.readRun)(dir);
+            process.stdout.write(json ? `${JSON.stringify({ schema: 'ia-qa-pal/status@1', run }, null, 2)}\n` : renderStatus(run, dir));
+            process.exitCode = run?.status === 'done' ? run.exitCode ?? 0 : run ? 0 : 2;
+            return;
+        }
+        if (command !== 'tour') {
+            process.stderr.write(`Unknown command "${command}". Run ia-qa-pal help.\n`);
+            process.exitCode = 2;
+            return;
+        }
         const batchRaw = valueOf(args, '--batch');
         const batch = batchRaw === undefined ? undefined : Number(batchRaw);
         if (batch !== undefined && (!Number.isInteger(batch) || batch < 1))
             throw new Error('--batch needs a positive whole number.');
-        const result = await (0, tour_1.runTour)({
-            dir: valueOf(args, '--config'),
-            batch,
-            more: args.includes('--more'),
-            session: valueOf(args, '--session'),
-        });
+        const tourOptions = { more: args.includes('--more'), suite: args.includes('--suite'), batch, session: valueOf(args, '--session') };
+        if (args.includes('--background')) {
+            const started = (0, run_1.startBackground)(dir, tourOptions);
+            if (json)
+                process.stdout.write(`${JSON.stringify({ schema: 'ia-qa-pal/background@1', ...started }, null, 2)}\n`);
+            else if (started.started)
+                process.stderr.write(`⏳ Tour started in the background (pid ${started.pid}). Follow it: ia-qa-pal status\n   log: ${started.log}\n`);
+            else
+                process.stderr.write(`❌ ${started.reason}\n`);
+            process.exitCode = started.started ? 0 : 2;
+            return;
+        }
+        if (!(0, setup_1.configExists)(dir) && interactive() && !json) {
+            process.stderr.write('This project is not set up yet — a few questions first.\n\n');
+            const outcome = await withPrompt((ask) => (0, setup_1.runSetup)({ dir, session: tourOptions.session, ask }));
+            printSetup(outcome, false);
+            if (!outcome.written || outcome.next !== 'ia-qa-pal tour') {
+                process.exitCode = outcome.written ? 0 : 2;
+                return;
+            }
+            process.stderr.write('\n');
+        }
+        const result = await (0, run_1.trackedTour)({ dir, ...tourOptions });
         process.stdout.write(json ? `${JSON.stringify(result, null, 2)}\n` : (0, report_1.renderReport)(result));
         process.exitCode = result.exitCode;
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        if (json)
-            process.stdout.write(`${JSON.stringify({ schema: 'ia-qa-pal/tour@1', error: message, exitCode: 2 }, null, 2)}\n`);
-        else
+        if (json) {
+            process.stdout.write(`${JSON.stringify({ error: message, ...(err instanceof run_1.TourAlreadyRunning ? { running: err.run } : {}), exitCode: 2 }, null, 2)}\n`);
+        }
+        else {
             process.stderr.write(`❌ ${message}\n`);
+        }
         process.exitCode = 2;
     }
 }

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 export { runTour } from './tour';
-export type { TourOptions, TourResult } from './tour';
+export type { TourOptions, TourResult, TourEvent } from './tour';
+export { trackedTour, startBackground, readRun, activeRun, TourAlreadyRunning } from './run';
+export type { RunRecord, RunView, BackgroundStart } from './run';
+export type { SuiteInventory, RepairPlan, SuiteAudit, SuiteRun } from './suite';
 export { renderReport } from './report';
+export { runSetup, LOGIN_COMMAND } from './setup';
+export type { SetupOptions, SetupOutcome, PalLogin } from './setup';
 export { selectBatch, needingDepth, estimate, splitFindings, exitCodeFor, DEFAULT_BATCH } from './plan';
 export type { Estimate, Pace, CheckSplit } from './plan';

package/dist/index.js

@@ -1,10 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_BATCH = exports.exitCodeFor = exports.splitFindings = exports.estimate = exports.needingDepth = exports.selectBatch = exports.renderReport = exports.runTour = void 0;
+exports.DEFAULT_BATCH = exports.exitCodeFor = exports.splitFindings = exports.estimate = exports.needingDepth = exports.selectBatch = exports.LOGIN_COMMAND = exports.runSetup = exports.renderReport = exports.TourAlreadyRunning = exports.activeRun = exports.readRun = exports.startBackground = exports.trackedTour = exports.runTour = void 0;
 var tour_1 = require("./tour");
 Object.defineProperty(exports, "runTour", { enumerable: true, get: function () { return tour_1.runTour; } });
+var run_1 = require("./run");
+Object.defineProperty(exports, "trackedTour", { enumerable: true, get: function () { return run_1.trackedTour; } });
+Object.defineProperty(exports, "startBackground", { enumerable: true, get: function () { return run_1.startBackground; } });
+Object.defineProperty(exports, "readRun", { enumerable: true, get: function () { return run_1.readRun; } });
+Object.defineProperty(exports, "activeRun", { enumerable: true, get: function () { return run_1.activeRun; } });
+Object.defineProperty(exports, "TourAlreadyRunning", { enumerable: true, get: function () { return run_1.TourAlreadyRunning; } });
 var report_1 = require("./report");
 Object.defineProperty(exports, "renderReport", { enumerable: true, get: function () { return report_1.renderReport; } });
+var setup_1 = require("./setup");
+Object.defineProperty(exports, "runSetup", { enumerable: true, get: function () { return setup_1.runSetup; } });
+Object.defineProperty(exports, "LOGIN_COMMAND", { enumerable: true, get: function () { return setup_1.LOGIN_COMMAND; } });
 var plan_1 = require("./plan");
 Object.defineProperty(exports, "selectBatch", { enumerable: true, get: function () { return plan_1.selectBatch; } });
 Object.defineProperty(exports, "needingDepth", { enumerable: true, get: function () { return plan_1.needingDepth; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAEhB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,+BAAwG;AAA/F,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAAE,gGAAA,QAAQ,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,qGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAEhB,6BAA6F;AAApF,kGAAA,WAAW,OAAA;AAAE,sGAAA,eAAe,OAAA;AAAE,8FAAA,OAAO,OAAA;AAAE,gGAAA,SAAS,OAAA;AAAE,yGAAA,kBAAkB,OAAA;AAG7E,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,iCAAkD;AAAzC,iGAAA,QAAQ,OAAA;AAAE,sGAAA,aAAa,OAAA;AAEhC,+BAAwG;AAA/F,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAAE,gGAAA,QAAQ,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,qGAAA,aAAa,OAAA"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+export declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            project_dir: {
+                type: string;
+                description: string;
+            };
+            url?: undefined;
+            login?: undefined;
+            session_file?: undefined;
+            tests?: undefined;
+            more?: undefined;
+            suite?: undefined;
+            batch?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            login: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            session_file: {
+                type: string;
+                description: string;
+            };
+            tests: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            project_dir: {
+                type: string;
+                description: string;
+            };
+            more?: undefined;
+            suite?: undefined;
+            batch?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            more: {
+                type: string;
+                description: string;
+            };
+            suite: {
+                type: string;
+                description: string;
+            };
+            batch: {
+                type: string;
+                description: string;
+            };
+            project_dir: {
+                type: string;
+                description: string;
+            };
+            url?: undefined;
+            login?: undefined;
+            session_file?: undefined;
+            tests?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export declare function projectDir(given: unknown, root?: string): string;
+export declare function callTool(name: string, args: Record<string, any>, root?: string): Promise<unknown>;

package/dist/mcp/server.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS = void 0;
+exports.projectDir = projectDir;
+exports.callTool = callTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const setup_1 = require("../setup");
+const run_1 = require("../run");
+const report_1 = require("../report");
+/**
+ * @ia-qa/pal — local stdio MCP server.
+ *
+ * Dependency-free JSON-RPC 2.0 over stdio, the same shape as `@ia-qa/self-healing` and
+ * `@ia-qa/qa-discovery`. It exposes what the CLI exposes, so a person and an agent get one
+ * contract. Three restraints are load-bearing:
+ *
+ * - **A tour never blocks the call.** `pal_tour` starts it in the background and returns at
+ *   once; `pal_status` reads progress and, when done, the report. A tour takes minutes, and a
+ *   client that times out mid-call would leave the agent believing nothing ran.
+ * - **No tool takes a command.** The test command comes from config.json, written by a person.
+ *   An agent steered by content it read cannot make this server run something else.
+ * - **No login tool.** `ia-qa-heal login` waits for a person at a browser.
+ *
+ * stdout carries the protocol only; all logs go to stderr.
+ */
+const PROTOCOL_VERSION = '2024-11-05';
+const SERVER_INFO = { name: 'ia-qa-pal', version: require('../../package.json').version };
+const CLI_ENTRY = path.join(__dirname, '..', 'cli', 'index.js');
+const PROJECT_DIR = {
+    type: 'string',
+    description: 'Project folder holding .ia-qa/, relative to where this server runs. Default: the server’s own folder.',
+};
+exports.TOOLS = [
+    {
+        name: 'pal_project',
+        description: 'Where this project stands with ia-qa-pal: whether it is set up, its level (0 public pages, 1 with a login, 2 with its test suite), how many pages are configured, whether a baseline exists, and whether a tour is running. Read-only. Call it first.',
+        inputSchema: { type: 'object', properties: { project_dir: PROJECT_DIR } },
+    },
+    {
+        name: 'pal_setup',
+        description: 'Write .ia-qa/config.json for a project that has none: the app address, how it logs in, its pages (read from sitemap.xml, else by following its links — same host, GET only, at most 50 pages), and optionally the folders of its end-to-end suite. Never overwrites an existing config. Call it ONLY with answers the human gave you — ask them where the app lives and how it logs in; never guess. Login "browser" means the human must then run `' +
+            setup_1.LOGIN_COMMAND +
+            '` themselves: you cannot, it waits for a person at a browser. The command that runs the suite is detected from package.json or set by the human with the CLI — this tool never takes one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'The app, https://…' },
+                login: { type: 'string', enum: ['none', 'browser', 'session'], description: 'none; browser (the human logs in by hand); session (a Playwright storageState the suite already writes).' },
+                session_file: { type: 'string', description: 'With login "session": path of that storageState file, inside the project. Only its path is written.' },
+                tests: { type: 'array', items: { type: 'string' }, description: 'Folders of the end-to-end suite, relative to the project.' },
+                project_dir: PROJECT_DIR,
+            },
+            required: ['url', 'login'],
+        },
+    },
+    {
+        name: 'pal_tour',
+        description: 'Start a tour in the background and return at once — it takes minutes. First tour: every page on the surface, a batch explored in depth (menus, tabs, dialogs; every non-GET request blocked), checks, baseline. Later tours: re-capture, compare with the baseline, check; with a test suite declared, repairs to its selectors are proposed and never applied. Only one tour runs per project. Follow it with pal_status. Report the whole result to the human, including "Not seen": a first tour is a baseline, never a pass.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                more: { type: 'boolean', description: 'Explore the next batch in depth instead of a regression tour. Refused after a BLOCK.' },
+                suite: { type: 'boolean', description: 'Also run the test command from config.json once, with the capture hook, to learn which pages the suite never visits. It runs the human’s own suite on this machine — ask before setting it.' },
+                batch: { type: 'integer', description: 'Pages per depth batch (default 10).' },
+                project_dir: PROJECT_DIR,
+            },
+        },
+    },
+    {
+        name: 'pal_status',
+        description: 'The tour running now — phase and progress — or the last one: its full report once done, as JSON and as the text a human reads. A tour whose process died before finishing is reported as interrupted, never as running. Read-only.',
+        inputSchema: { type: 'object', properties: { project_dir: PROJECT_DIR } },
+    },
+];
+function projectDir(given, root = process.cwd()) {
+    const candidate = typeof given === 'string' && given.trim() ? given.trim() : '.';
+    const resolved = path.resolve(root, candidate);
+    const rootWithSep = root.endsWith(path.sep) ? root : root + path.sep;
+    if (resolved !== root && !resolved.startsWith(rootWithSep)) {
+        throw new Error(`project_dir "${candidate}" resolves outside "${root}". Refusing: an MCP call may be steered by content the agent read.`);
+    }
+    return resolved;
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function callTool(name, args, root = process.cwd()) {
+    const dir = projectDir(args.project_dir, root);
+    const config = readJson(path.join(dir, '.ia-qa', 'config.json'));
+    if (name === 'pal_project') {
+        const baseline = path.join(dir, '.ia-qa', 'baseline');
+        const run = (0, run_1.readRun)(dir);
+        return {
+            setUp: !!config,
+            ...(config
+                ? {
+                    baseUrl: config.baseUrl,
+                    pages: (config.pages ?? []).length,
+                    level: (config.testPaths ?? []).length > 0 ? 2 : config.session || config.auth || fs.existsSync(path.join(dir, '.ia-qa', 'session.json')) ? 1 : 0,
+                    testPaths: config.testPaths ?? [],
+                    testCommand: config.testCommand ?? null,
+                    baseline: fs.existsSync(baseline) && fs.readdirSync(baseline).some((f) => f.endsWith('.json')),
+                }
+                : { next: 'Ask the human where the app lives and how it logs in, then call pal_setup with their answers.' }),
+            tour: run ? { status: run.status, startedAt: run.startedAt, finishedAt: run.finishedAt ?? null } : null,
+        };
+    }
+    if (name === 'pal_setup') {
+        const login = args.login;
+        if (!['none', 'browser', 'session'].includes(login))
+            throw new Error('login must be none, browser or session.');
+        const session = typeof args.session_file === 'string' && args.session_file ? path.relative(dir, projectDir(args.session_file, dir)) : undefined;
+        const tests = Array.isArray(args.tests) ? args.tests.map(String) : undefined;
+        const lines = [];
+        const outcome = await (0, setup_1.runSetup)({ dir, url: String(args.url ?? ''), login, session, tests, yes: true, onProgress: (l) => lines.push(l) });
+        return { ...outcome, progress: lines };
+    }
+    if (name === 'pal_tour') {
+        const batch = Number.isInteger(args.batch) && args.batch > 0 ? args.batch : undefined;
+        const started = (0, run_1.startBackground)(dir, { more: !!args.more, suite: !!args.suite, batch }, CLI_ENTRY);
+        return started.started
+            ? { ...started, next: 'Call pal_status to follow it. A tour takes minutes.' }
+            : { ...started, ...(!config ? { next: 'Not set up: ask the human where the app lives and how it logs in, then call pal_setup.' } : {}) };
+    }
+    if (name === 'pal_status') {
+        const run = (0, run_1.readRun)(dir);
+        if (!run)
+            return { run: null, text: 'No tour has run on this project yet. Call pal_tour.' };
+        const text = run.status === 'done' && run.report ? (0, report_1.renderReport)(run.report) : undefined;
+        return { run, log: (0, run_1.logFile)(dir), ...(text ? { text } : {}) };
+    }
+    throw new Error(`Unknown tool "${name}". Call tools/list to see available tools.`);
+}
+function send(message) {
+    process.stdout.write(JSON.stringify(message) + '\n');
+}
+async function handle(req) {
+    const { id, method, params } = req;
+    const isNotification = id === undefined || id === null;
+    try {
+        if (method === 'initialize') {
+            send({ jsonrpc: '2.0', id, result: { protocolVersion: params?.protocolVersion || PROTOCOL_VERSION, capabilities: { tools: {} }, serverInfo: SERVER_INFO } });
+            return;
+        }
+        if (method === 'notifications/initialized' || method === 'initialized')
+            return;
+        if (method === 'ping') {
+            send({ jsonrpc: '2.0', id, result: {} });
+            return;
+        }
+        if (method === 'tools/list') {
+            send({ jsonrpc: '2.0', id, result: { tools: exports.TOOLS } });
+            return;
+        }
+        if (method === 'tools/call') {
+            try {
+                const result = await callTool(params?.name, params?.arguments || {});
+                send({ jsonrpc: '2.0', id, result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] } });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                send({ jsonrpc: '2.0', id, result: { content: [{ type: 'text', text: `Error: ${message}` }], isError: true } });
+            }
+            return;
+        }
+        if (!isNotification)
+            send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${method}` } });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!isNotification)
+            send({ jsonrpc: '2.0', id, error: { code: -32603, message } });
+        else
+            process.stderr.write(`[ia-qa-pal] error handling ${method}: ${message}\n`);
+    }
+}
+function main() {
+    if (process.argv.includes('--version') || process.argv.includes('-v')) {
+        process.stdout.write(SERVER_INFO.version + '\n');
+        process.exit(0);
+    }
+    // The setup verbs print; stdout is the protocol.
+    console.log = console.info = console.warn = (...a) => console.error(...a);
+    process.stderr.write('[ia-qa-pal] MCP server ready (stdio)\n');
+    let buffer = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+        buffer += chunk;
+        let nl;
+        while ((nl = buffer.indexOf('\n')) !== -1) {
+            const line = buffer.slice(0, nl).trim();
+            buffer = buffer.slice(nl + 1);
+            if (!line)
+                continue;
+            let req;
+            try {
+                req = JSON.parse(line);
+            }
+            catch {
+                process.stderr.write(`[ia-qa-pal] non-JSON line ignored: ${line.slice(0, 80)}\n`);
+                continue;
+            }
+            void handle(req);
+        }
+    });
+    process.stdin.on('end', () => process.exit(0));
+}
+if (require.main === module)
+    main();
+//# sourceMappingURL=server.js.map