@ia-qa/pal 0.1.0 → 0.3.0

package/dist/setup.js

@@ -0,0 +1,210 @@
+"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.LOGIN_COMMAND = void 0;
+exports.configExists = configExists;
+exports.detectTests = detectTests;
+exports.runSetup = runSetup;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const self_healing_1 = require("@ia-qa/self-healing");
+exports.LOGIN_COMMAND = 'npx -p @ia-qa/self-healing ia-qa-heal login';
+const CRAWL_CAP = 50;
+const LOGIN_CHOICES = { '1': 'none', '2': 'browser', '3': 'session' };
+function configExists(dir) {
+    return fs.existsSync(path.join(dir, '.ia-qa', 'config.json'));
+}
+function withHome(pages) {
+    const hasHome = pages.some((p) => {
+        try {
+            return new URL(p.url, 'http://x').pathname === '/';
+        }
+        catch {
+            return false;
+        }
+    });
+    if (hasHome)
+        return pages;
+    const name = pages.some((p) => p.name === 'home') ? 'home-page' : 'home';
+    return [{ name, url: '/' }, ...pages];
+}
+function request(baseUrl, pages, login, session, tests, testCommand) {
+    const mode = login === 'none' ? 'none' : 'session';
+    return {
+        baseUrl,
+        pages,
+        login: { mode, ...(login === 'session' && session ? { sessionFile: session } : {}) },
+        ...(tests && tests.length > 0 ? { tests: { paths: tests, ...(testCommand ? { command: testCommand } : {}) } } : {}),
+    };
+}
+const TEST_DIRS = ['tests', 'e2e', 'test', 'cypress/e2e', 'specs'];
+const SPEC_FILE = /\.(spec|test|cy)\.[cm]?[jt]sx?$/;
+function hasSpecs(dir, depth = 0) {
+    if (depth > 3)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    return entries.some((e) => e.isFile() ? SPEC_FILE.test(e.name) : e.isDirectory() && e.name !== 'node_modules' && hasSpecs(path.join(dir, e.name), depth + 1));
+}
+/** Folders that look like an end-to-end suite. Proposed to a person, never assumed. */
+function detectTests(dir) {
+    const paths = TEST_DIRS.filter((d) => hasSpecs(path.join(dir, d)));
+    return { paths, command: paths.length > 0 ? (0, self_healing_1.detectTestCommand)(dir) : undefined };
+}
+async function runSetup(opts = {}) {
+    const dir = path.resolve(opts.dir ?? process.cwd());
+    const progress = opts.onProgress ?? ((line) => console.error(line));
+    const refuse = (problems, extra = {}) => ({ written: false, pages: [], problems, ...extra });
+    if (configExists(dir)) {
+        return refuse([`${path.join(dir, '.ia-qa', 'config.json')} already exists — setup never overwrites one. Run: ia-qa-pal tour`]);
+    }
+    let url = opts.url?.trim();
+    if (!url && opts.ask)
+        url = (await opts.ask('Where does the app live? (https://…) ')).trim();
+    if (!url)
+        return refuse(['The app address is missing: --url https://your-app.example']);
+    if (!(0, self_healing_1.isWebAddress)(url))
+        return refuse([`"${url}" is not a web address — it starts with http:// or https://.`]);
+    let login = opts.login;
+    if (!login && opts.ask) {
+        const answer = (await opts.ask('Does the app ask you to log in?\n' +
+            '  1  no\n' +
+            '  2  yes — I log in by hand in a browser (SSO, MFA, anything)\n' +
+            '  3  yes — my test suite already saves a Playwright storageState file\n' +
+            'Choice [1-3]: ')).trim();
+        login = LOGIN_CHOICES[answer];
+    }
+    if (!login)
+        return refuse(['How the app logs in is missing: --login none | browser | session']);
+    let session = opts.session?.trim();
+    if (login === 'session' && !session && opts.ask)
+        session = (await opts.ask('Path of that storageState file: ')).trim();
+    if (login === 'session' && !session)
+        return refuse(['--login session needs the file: --session path/to/storageState.json']);
+    const host = new URL(url).host;
+    progress(`🗺  Reading ${host}/sitemap.xml (and robots.txt) — a plain fetch, nothing else.`);
+    let pages = [];
+    let pagesFrom = 'home';
+    try {
+        const sitemap = await (0, self_healing_1.readSitemap)(url);
+        pages = sitemap.pages;
+        if (pages.length > 0) {
+            pagesFrom = 'sitemap';
+            progress(`   Found ${pages.length} page${pages.length === 1 ? '' : 's'}${sitemap.capped ? ' (the sitemap holds more — stopped at the cap)' : ''}.`);
+        }
+        else {
+            for (const line of sitemap.reason)
+                progress(`   ${line}`);
+        }
+    }
+    catch (err) {
+        progress(`   No sitemap: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (pages.length === 0) {
+        progress(`🕸  Following links from ${host} in a headless browser — same host, GET only, at most ${CRAWL_CAP} pages, action links skipped.`);
+        try {
+            (0, self_healing_1.setBaseDir)(dir);
+            const plan = (0, self_healing_1.planSetup)(request(url, [{ name: 'home', url: '/' }], login, session), dir);
+            const found = await (0, self_healing_1.crawlApp)(plan.config, { maxPages: CRAWL_CAP, ...(session ? { session: path.resolve(dir, session) } : {}) });
+            pages = found.map((c) => ({ name: c.name, url: c.url }));
+            if (pages.length > 0)
+                pagesFrom = 'crawl';
+            progress(`   Found ${pages.length} page${pages.length === 1 ? '' : 's'}.`);
+        }
+        catch (err) {
+            progress(`   Could not follow links: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    pages = withHome(pages);
+    let tests = opts.tests?.map((t) => t.trim()).filter(Boolean);
+    let testCommand = opts.testCommand?.trim();
+    if (!tests && opts.ask) {
+        const found = detectTests(dir);
+        if (found.paths.length > 0) {
+            const answer = (await opts.ask(`Found a test suite in ${found.paths.join(', ')}${found.command ? ` (run with: ${found.command})` : ''}. ` +
+                'Read it too — repairs to its selectors, and which pages it never visits? [Y/n] ')).trim().toLowerCase();
+            if (answer === '' || answer === 'y' || answer === 'yes') {
+                tests = found.paths;
+                testCommand = testCommand || found.command;
+            }
+        }
+    }
+    const body = request(url, pages, login, session, tests, testCommand);
+    const plan = (0, self_healing_1.planSetup)(body, dir);
+    const outcome = {
+        written: false,
+        baseUrl: url,
+        pages: plan.config.pages,
+        pagesFrom,
+        login,
+        ...(plan.config.testPaths ? { tests: plan.config.testPaths } : {}),
+        ...(plan.config.testPaths && plan.config.testCommand ? { testCommand: plan.config.testCommand } : {}),
+        problems: plan.problems,
+    };
+    if (plan.problems.length > 0)
+        return outcome;
+    const file = path.join(dir, '.ia-qa', 'config.json');
+    const names = plan.config.pages.map((p) => p.name);
+    progress('');
+    progress(`📄 This writes ${file}`);
+    progress(`   app      ${url}`);
+    progress(`   pages    ${names.length} from the ${pagesFrom === 'home' ? 'home page only' : pagesFrom}: ${names.slice(0, 8).join(', ')}${names.length > 8 ? `, +${names.length - 8} more` : ''}`);
+    progress(`   login    ${login === 'none' ? 'none' : login === 'browser' ? `by hand — ${exports.LOGIN_COMMAND} saves .ia-qa/session.json` : `storageState ${session}`}`);
+    progress(`   tests    ${plan.config.testPaths ? `${plan.config.testPaths.join(', ')}${plan.config.testCommand ? ` · run with: ${plan.config.testCommand}` : ''}` : 'none'}`);
+    progress('   Nothing else is written. No field holds a secret.');
+    if (!opts.yes) {
+        if (!opts.ask)
+            return { ...outcome, problems: ['Not written: confirm with --yes.'] };
+        const confirm = (await opts.ask('Write it? [y/N] ')).trim().toLowerCase();
+        if (confirm !== 'y' && confirm !== 'yes')
+            return { ...outcome, problems: ['Not written — nothing changed.'] };
+    }
+    const result = (0, self_healing_1.writeSetup)(body, dir);
+    if (!result.written)
+        return { ...outcome, problems: [result.error] };
+    const needsSession = login === 'browser' && !fs.existsSync(path.join(dir, '.ia-qa', 'session.json'));
+    return {
+        ...outcome,
+        written: true,
+        file: result.file,
+        next: needsSession ? exports.LOGIN_COMMAND : 'ia-qa-pal tour',
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/state.d.ts

@@ -1,4 +1,5 @@
 import type { Pace } from './plan';
+import type { SuiteRun } from './suite';
 /**
  * What a tour remembers between runs, and only what cannot be read back from the contracts:
  * which pages have explored depth is in each baseline file (`exploredDepth`), so it is never
@@ -14,6 +15,8 @@ export interface PalState {
     knownFindings: string[];
     /** Drift verdict of the latest regression tour — `--more` refuses to promote over a BLOCK. */
     lastVerdict?: 'PASS' | 'FIX' | 'BLOCK';
+    /** The latest `--suite` run: which pages the suite visited, and how it exited. */
+    suite?: SuiteRun;
 }
 export declare function statePath(): string;
 export declare function loadState(): PalState;

package/dist/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,8BAEC;AAED,8BAQC;AAED,8BAMC;AA1CD,uCAAyB;AACzB,2CAA6B;AAC7B,sDAAiD;AAoBjD,SAAgB,SAAS;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAA,yBAAU,GAAE,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,SAAS;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAa,CAAC;QAC5E,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;IACzI,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;IACrF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED,SAAgB,SAAS,CAAC,KAAe;IACvC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,8BAEC;AAED,8BAQC;AAED,8BAMC;AA7CD,uCAAyB;AACzB,2CAA6B;AAC7B,sDAAiD;AAuBjD,SAAgB,SAAS;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAA,yBAAU,GAAE,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,SAAS;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAa,CAAC;QAC5E,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;IACzI,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;IACrF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED,SAAgB,SAAS,CAAC,KAAe;IACvC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/suite.d.ts

@@ -0,0 +1,63 @@
+import type { IaQaConfig } from '@ia-qa/self-healing';
+/**
+ * Level 2: the test suite. Every answer here comes from `@ia-qa/self-healing` — the inventory
+ * `ingest` writes, the plan `fix --dry-run` computes, the names `audit` judges, the pages the
+ * capture hook records. This file only runs them in the right place and keeps what came back.
+ */
+export declare const APPLY_COMMAND = "npx -p @ia-qa/self-healing ia-qa-heal fix";
+export declare const CAPTURE_IMPORT = "import { test, expect } from '@ia-qa/self-healing/capture'";
+export interface SuiteInventory {
+    paths: string[];
+    missingPaths: string[];
+    filesScanned: number;
+    selectors: number;
+    names: number;
+}
+export interface RepairPlan {
+    files: Array<{
+        file: string;
+        replacements: Array<{
+            from: string;
+            to: string;
+            count: number;
+            lines: number[];
+        }>;
+    }>;
+    total: number;
+    /** Occurrences found and deliberately left alone, with why — never silently dropped. */
+    leftAlone: number;
+    command: string;
+}
+export interface SuiteAudit {
+    deadNames: Array<{
+        name: string;
+        sites: Array<{
+            file: string;
+            line: number;
+        }>;
+    }>;
+    judged: number;
+    notJudged: number;
+}
+export interface SuiteRun {
+    command: string;
+    exitCode: number;
+    /** Pages the suite really visited, as the capture hook recorded them. Null: nothing was recorded. */
+    visited: string[] | null;
+    at: string;
+}
+/** `ingest`: what the suite writes as locators. Written to `usage.json`, where map, diff and fix read it. */
+export declare function inventory(dir: string, config: IaQaConfig): SuiteInventory | null;
+/** `fix --dry-run` over baseline/ → mapping/: the rewrites it would apply. Nothing is written. */
+export declare function repairPlan(dir: string): Promise<RepairPlan | null>;
+/** `audit`: locator names the suite writes that nothing on the mapped pages carries. Advisory. */
+export declare function auditSuite(dir: string, config: IaQaConfig): SuiteAudit | null;
+/**
+ * Run the suite with the capture hook armed, and learn which pages it visits.
+ *
+ * The capture lands in `.ia-qa/pal/suite-run/`, never in `mapping/`: a capture taken during a
+ * test run reads a page differently from `map`, and mixing the two in one directory is the
+ * phantom drift `ia-qa-heal run` warns about. Only the list of visited pages is kept.
+ * The command is the one in config.json — never a string from a caller.
+ */
+export declare function runSuite(dir: string, config: IaQaConfig, onOutput: (chunk: string) => void): Promise<SuiteRun | null>;

package/dist/suite.js

@@ -0,0 +1,145 @@
+"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.CAPTURE_IMPORT = exports.APPLY_COMMAND = void 0;
+exports.inventory = inventory;
+exports.repairPlan = repairPlan;
+exports.auditSuite = auditSuite;
+exports.runSuite = runSuite;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const self_healing_1 = require("@ia-qa/self-healing");
+/**
+ * Level 2: the test suite. Every answer here comes from `@ia-qa/self-healing` — the inventory
+ * `ingest` writes, the plan `fix --dry-run` computes, the names `audit` judges, the pages the
+ * capture hook records. This file only runs them in the right place and keeps what came back.
+ */
+exports.APPLY_COMMAND = 'npx -p @ia-qa/self-healing ia-qa-heal fix';
+exports.CAPTURE_IMPORT = "import { test, expect } from '@ia-qa/self-healing/capture'";
+const rel = (dir, file) => path.relative(dir, file).replace(/\\/g, '/') || file;
+function withExitCode(fn) {
+    const before = process.exitCode;
+    process.exitCode = undefined;
+    return fn().finally(() => {
+        process.exitCode = before;
+    });
+}
+/** `ingest`: what the suite writes as locators. Written to `usage.json`, where map, diff and fix read it. */
+function inventory(dir, config) {
+    const declared = config.testPaths ?? [];
+    if (declared.length === 0)
+        return null;
+    const resolved = declared.map((p) => path.resolve(dir, p));
+    const missingPaths = declared.filter((_, i) => !fs.existsSync(resolved[i]));
+    const { usage } = (0, self_healing_1.ingestPaths)(resolved.filter((p) => fs.existsSync(p)), dir);
+    (0, self_healing_1.saveUsage)(usage, dir);
+    return {
+        paths: declared,
+        missingPaths,
+        filesScanned: usage.scanned,
+        selectors: Object.keys(usage.selectors).length,
+        names: Object.keys(usage.names ?? {}).length,
+    };
+}
+/** `fix --dry-run` over baseline/ → mapping/: the rewrites it would apply. Nothing is written. */
+async function repairPlan(dir) {
+    const result = await withExitCode(() => (0, self_healing_1.runFix)(['--dry-run']));
+    if (!result || !result.dryRun)
+        return null;
+    const files = result.edits
+        .filter((e) => e.replacements.length > 0)
+        .map((e) => ({
+        file: rel(dir, e.file),
+        replacements: e.replacements.map((r) => ({ from: r.from, to: r.to, count: r.count, lines: r.lines ?? [] })),
+    }));
+    return {
+        files,
+        total: result.totalReplacements,
+        leftAlone: result.edits.reduce((s, e) => s + (e.skipped ?? []).reduce((t, k) => t + k.count, 0), 0),
+        command: exports.APPLY_COMMAND,
+    };
+}
+/** `audit`: locator names the suite writes that nothing on the mapped pages carries. Advisory. */
+function auditSuite(dir, config) {
+    const outcome = (0, self_healing_1.auditProject)({ testPaths: (config.testPaths ?? []).map((p) => path.resolve(dir, p)) });
+    if (!outcome.ok)
+        return null;
+    return {
+        deadNames: outcome.report.deadLocators.map((d) => ({
+            name: d.name,
+            sites: d.sites.map((s) => ({ file: rel(dir, s.file), line: s.line })),
+        })),
+        judged: outcome.report.locatorsJudged,
+        notJudged: outcome.report.locatorsNotJudged,
+    };
+}
+/**
+ * Run the suite with the capture hook armed, and learn which pages it visits.
+ *
+ * The capture lands in `.ia-qa/pal/suite-run/`, never in `mapping/`: a capture taken during a
+ * test run reads a page differently from `map`, and mixing the two in one directory is the
+ * phantom drift `ia-qa-heal run` warns about. Only the list of visited pages is kept.
+ * The command is the one in config.json — never a string from a caller.
+ */
+async function runSuite(dir, config, onOutput) {
+    const command = config.testCommand;
+    if (!command)
+        return null;
+    const isolated = path.join(dir, '.ia-qa', 'pal', 'suite-run');
+    fs.rmSync(isolated, { recursive: true, force: true });
+    fs.mkdirSync(path.join(isolated, '.ia-qa'), { recursive: true });
+    fs.writeFileSync(path.join(isolated, '.ia-qa', 'config.json'), JSON.stringify(config, null, 2));
+    const exitCode = await new Promise((resolve) => {
+        const child = (0, child_process_1.spawn)(command, {
+            cwd: dir,
+            shell: true,
+            env: { ...process.env, IAQA_CAPTURE: '1', IAQA_CONFIG_DIR: isolated },
+        });
+        child.stdout.on('data', (d) => onOutput(d.toString()));
+        child.stderr.on('data', (d) => onOutput(d.toString()));
+        child.on('error', () => resolve(127));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+    let visited = null;
+    try {
+        visited = (0, self_healing_1.mergeCaptures)(isolated)?.pages ?? null;
+    }
+    finally {
+        fs.rmSync(isolated, { recursive: true, force: true });
+    }
+    return { command, exitCode, visited: visited ? [...visited].sort() : null, at: new Date().toISOString() };
+}
+//# sourceMappingURL=suite.js.map

package/dist/suite.js.map

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

package/dist/tour.d.ts

@@ -1,5 +1,7 @@
 import type { DirReport } from '@ia-qa/self-healing';
 import type { Estimate, CheckSplit } from './plan';
+import { CAPTURE_IMPORT } from './suite';
+import type { SuiteInventory, RepairPlan, SuiteRun } from './suite';
 export interface TourOptions {
     /** Project directory holding `.ia-qa/`. Default: the current directory. */
     dir?: string;
@@ -7,16 +9,26 @@ export interface TourOptions {
     batch?: number;
     /** Explore the next batch in depth instead of running a regression tour. */
     more?: boolean;
+    /** Run the test suite from config.json with the capture hook, to learn which pages it visits. */
+    suite?: boolean;
     session?: string;
     /** Where progress goes. Never stdout: stdout is the report. */
     onProgress?: (line: string) => void;
+    /** Machine-readable progress: which phase, how far. */
+    onEvent?: (event: TourEvent) => void;
+}
+export interface TourEvent {
+    phase: 'surface' | 'depth' | 'recapture' | 'check' | 'suite' | 'repairs' | 'done';
+    done?: number;
+    total?: number;
+    page?: string;
 }
 export interface TourResult {
     schema: 'ia-qa-pal/tour@1';
     mode: 'first' | 'regression' | 'explore';
     baseUrl: string;
-    /** 0 = public pages only, 1 = a session or a login is configured. */
-    level: 0 | 1;
+    /** 0 = public pages only, 1 = a session or a login is configured, 2 = the test suite is declared too. */
+    level: 0 | 1 | 2;
     pages: {
         configured: number;
         underContract: number;
@@ -44,14 +56,41 @@ export interface TourResult {
         }>;
         staleExcluded: string[];
         depthMismatch?: string;
+        /** Renamed labels the suite locates by name, and selectors of the suite that broke or now reach another element. */
+        suiteFindings?: {
+            names: number;
+            bindings: number;
+        };
+    };
+    check: null | Omit<CheckSplit, 'keys'>;
+    suite: null | {
+        inventory: SuiteInventory;
+        repairs: RepairPlan | null;
+        /** Locator names the suite writes that nothing mapped carries, first seen this tour. Advisory. */
+        newDeadNames: Array<{
+            name: string;
+            sites: Array<{
+                file: string;
+                line: number;
+            }>;
+        }>;
+        knownDeadNames: number;
+        /** The latest `--suite` run — this tour's, or an earlier one, with its date. */
+        run: SuiteRun | null;
+        ranThisTour: boolean;
+        /** Configured pages the suite did not visit in that run. Null: not measured. */
+        notVisited: string[] | null;
     };
-    check: null | (Omit<CheckSplit, 'keys'> & {
-        refused?: string;
-    });
     estimate: Estimate | null;
     /** Set when the tour declined to run, with the reason. */
     refused?: string;
+    /** The project has no config yet: what a setup needs, and the command that provides it. */
+    setupRequired?: {
+        missing: Array<'url' | 'login'>;
+        command: string;
+    };
     exitCode: 0 | 1 | 2;
     durationMs: number;
 }
 export declare function runTour(opts?: TourOptions): Promise<TourResult>;
+export { CAPTURE_IMPORT };