@ia-qa/self-healing 0.1.0

package/dist/cli/map.js

@@ -0,0 +1,118 @@
+"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.runMap = runMap;
+const path = __importStar(require("path"));
+const launcher_1 = require("../launcher");
+const config_1 = require("../config");
+const aom_1 = require("../aom");
+const markdown_1 = require("../markdown");
+/**
+ * `ia-qa-heal map [pageName]` — scraping & DOM compression engine.
+ *
+ * Loads `.ia-qa/config.json`, resolves credentials at runtime (env or AWS SSM,
+ * see `resolveSecret`), launches headless Chromium, logs in if configured,
+ * then visits each target page and writes a compressed accessibility mapping
+ * to `.ia-qa/mapping/<page-name>.json`.
+ */
+async function runMap(pageNameArg) {
+    const config = (0, config_1.loadConfig)();
+    const targets = pageNameArg
+        ? config.pages.filter((p) => p.name === pageNameArg)
+        : config.pages;
+    if (targets.length === 0) {
+        const known = config.pages.map((p) => p.name).join(', ') || '(none configured)';
+        throw new Error(`Unknown page "${pageNameArg}". Configured pages: ${known}`);
+    }
+    const { browser, using } = await (0, launcher_1.launchBrowser)();
+    console.log(`🌐 Using ${using}`);
+    const context = await browser.newContext();
+    const page = await context.newPage();
+    try {
+        if (config.auth) {
+            console.log('🔐 Logging in…');
+            await login(page, config);
+            console.log('   Logged in.');
+        }
+        for (const target of targets) {
+            const url = new URL(target.url, config.baseUrl).toString();
+            console.log(`🗺  Mapping "${target.name}" (${url})…`);
+            await page.goto(url, { waitUntil: 'networkidle', timeout: 30000 });
+            const elements = await (0, aom_1.extractInteractiveElements)(page);
+            const mapping = {
+                page: target.name,
+                url: target.url,
+                capturedAt: new Date().toISOString(),
+                elements,
+            };
+            const file = (0, aom_1.saveMapping)(mapping);
+            const md = (0, markdown_1.saveMarkdown)(mapping);
+            console.log(`   ✔ ${elements.length} interactive elements → ` +
+                `${path.relative(process.cwd(), file)} + ${path.relative(process.cwd(), md)}`);
+        }
+    }
+    finally {
+        await browser.close();
+    }
+}
+async function login(page, config) {
+    const auth = config.auth;
+    const usernameRef = config.secrets[auth.usernameSecret];
+    const passwordRef = config.secrets[auth.passwordSecret];
+    if (!usernameRef || !passwordRef) {
+        throw new Error(`auth.usernameSecret/"${auth.usernameSecret}" or auth.passwordSecret/"${auth.passwordSecret}" not found in config.secrets.`);
+    }
+    const [username, password] = await Promise.all([
+        (0, config_1.resolveSecret)(usernameRef),
+        (0, config_1.resolveSecret)(passwordRef),
+    ]);
+    await page.goto(new URL(auth.loginUrl, config.baseUrl).toString(), {
+        waitUntil: 'domcontentloaded',
+        timeout: 30000,
+    });
+    await page.fill(auth.usernameSelector, username);
+    await page.fill(auth.passwordSelector, password);
+    await page.click(auth.submitSelector);
+    await page.waitForLoadState('networkidle', { timeout: 30000 });
+    if (auth.successSelector) {
+        try {
+            await page.waitForSelector(auth.successSelector, { timeout: 10000 });
+        }
+        catch {
+            throw new Error(`Login likely failed: "${auth.successSelector}" not visible after submit. Check credentials and selectors.`);
+        }
+    }
+}
+//# sourceMappingURL=map.js.map

package/dist/cli/map.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Configuration & secret resolution for @ia-qa/self-healing.
+ *
+ * Security model: `.ia-qa/config.json` only ever contains *references* to
+ * secrets (an env var name, or an AWS SSM parameter name). Actual values are
+ * resolved at runtime — from `process.env` or from SSM Parameter Store using
+ * the developer's local AWS credential chain — and are never written to disk.
+ */
+export type SecretSource = 'env' | 'aws-ssm';
+export interface SecretRef {
+    source: SecretSource;
+    /** `env`: the environment variable name. `aws-ssm`: the parameter name (e.g. `/staging/app/password`). */
+    key: string;
+    /** AWS region — required when source is `aws-ssm`. */
+    region?: string;
+}
+export interface PageTarget {
+    /** Logical page name — becomes the mapping filename (`.ia-qa/mapping/<name>.json`). */
+    name: string;
+    /** Path or absolute URL, resolved against `baseUrl`. */
+    url: string;
+}
+export interface AuthConfig {
+    loginUrl: string;
+    usernameSelector: string;
+    passwordSelector: string;
+    submitSelector: string;
+    /** Keys into `config.secrets` used to fill the login form. */
+    usernameSecret: string;
+    passwordSecret: string;
+    /** Optional selector that must appear after login (sanity check). */
+    successSelector?: string;
+}
+export interface IaQaConfig {
+    framework: 'playwright';
+    baseUrl: string;
+    secrets: Record<string, SecretRef>;
+    auth?: AuthConfig;
+    pages: PageTarget[];
+}
+export declare const CONFIG_DIR = ".ia-qa";
+export declare const MAPPING_DIRNAME = "mapping";
+export declare function configPath(cwd?: string): string;
+export declare function mappingDir(cwd?: string): string;
+export declare function mappingPath(pageName: string, dir?: string): string;
+export declare function loadConfig(cwd?: string): IaQaConfig;
+export declare function saveConfig(config: IaQaConfig, cwd?: string): string;
+/**
+ * Resolve a secret reference to its actual value.
+ * - `env`: read from `process.env` (load your `.env` beforehand, e.g. via dotenv).
+ * - `aws-ssm`: `GetParameter` with decryption, using the local AWS credential
+ *   chain (env vars, `~/.aws/credentials`, SSO, instance profile…).
+ * The AWS SDK is imported lazily so env-only users don't need it at runtime.
+ */
+export declare function resolveSecret(ref: SecretRef): Promise<string>;

package/dist/config.js

@@ -0,0 +1,111 @@
+"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.MAPPING_DIRNAME = exports.CONFIG_DIR = void 0;
+exports.configPath = configPath;
+exports.mappingDir = mappingDir;
+exports.mappingPath = mappingPath;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.resolveSecret = resolveSecret;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.CONFIG_DIR = '.ia-qa';
+exports.MAPPING_DIRNAME = 'mapping';
+function configPath(cwd = process.cwd()) {
+    return path.join(cwd, exports.CONFIG_DIR, 'config.json');
+}
+function mappingDir(cwd = process.cwd()) {
+    return path.join(cwd, exports.CONFIG_DIR, exports.MAPPING_DIRNAME);
+}
+function mappingPath(pageName, dir = mappingDir()) {
+    const safe = pageName.replace(/[^a-zA-Z0-9._-]/g, '-');
+    return path.join(dir, `${safe}.json`);
+}
+function loadConfig(cwd = process.cwd()) {
+    const file = configPath(cwd);
+    if (!fs.existsSync(file)) {
+        throw new Error(`No ${exports.CONFIG_DIR}/config.json found in ${cwd}. Run \`ia-qa-heal init\` first.`);
+    }
+    const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (!raw.baseUrl || !Array.isArray(raw.pages)) {
+        throw new Error(`${file} is malformed: "baseUrl" and "pages" are required.`);
+    }
+    return raw;
+}
+function saveConfig(config, cwd = process.cwd()) {
+    const file = configPath(cwd);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.mkdirSync(mappingDir(cwd), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    return file;
+}
+/**
+ * Resolve a secret reference to its actual value.
+ * - `env`: read from `process.env` (load your `.env` beforehand, e.g. via dotenv).
+ * - `aws-ssm`: `GetParameter` with decryption, using the local AWS credential
+ *   chain (env vars, `~/.aws/credentials`, SSO, instance profile…).
+ * The AWS SDK is imported lazily so env-only users don't need it at runtime.
+ */
+async function resolveSecret(ref) {
+    if (!ref || !ref.key) {
+        throw new Error('Invalid secret reference: missing "key".');
+    }
+    if (ref.source === 'env') {
+        const value = process.env[ref.key];
+        if (!value) {
+            throw new Error(`Environment variable "${ref.key}" is not set. Add it to your .env or shell environment — never to config.json.`);
+        }
+        return value;
+    }
+    if (ref.source === 'aws-ssm') {
+        const { SSMClient, GetParameterCommand } = await Promise.resolve().then(() => __importStar(require('@aws-sdk/client-ssm')));
+        const client = new SSMClient(ref.region ? { region: ref.region } : {});
+        try {
+            const out = await client.send(new GetParameterCommand({ Name: ref.key, WithDecryption: true }));
+            const value = out.Parameter?.Value;
+            if (!value)
+                throw new Error('parameter exists but has no value');
+            return value;
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to read SSM parameter "${ref.key}"${ref.region ? ` (region ${ref.region})` : ''}: ${reason}. ` +
+                'Check your local AWS credentials and IAM permissions (ssm:GetParameter + kms:Decrypt for SecureString).');
+        }
+    }
+    throw new Error(`Unknown secret source "${ref.source}". Expected "env" or "aws-ssm".`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/fixEngine.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The deterministic codemod engine, shared by the CLI (`ia-qa-heal fix`) and the
+ * MCP server (`fix_tests` tool). Pure of any I/O presentation — it computes the
+ * rewrites, applies them to files, and returns a structured result. Callers do
+ * the reporting.
+ */
+export interface DiffRowLike {
+    status: string;
+    selector?: string;
+    healedSelector?: string;
+}
+export interface FileEdit {
+    file: string;
+    replacements: Array<{
+        from: string;
+        to: string;
+        count: number;
+    }>;
+}
+export interface FixResult {
+    rewrites: Array<{
+        from: string;
+        to: string;
+    }>;
+    filesScanned: number;
+    edits: FileEdit[];
+    totalReplacements: number;
+    dryRun: boolean;
+}
+/** Map of old→new selector, taken ONLY from the healable rows. */
+export declare function computeRewrites(rows: DiffRowLike[]): Map<string, string>;
+/**
+ * Apply `rewrites` to every file in `files`. Replaces a selector only where it
+ * appears as a quoted string literal (`'…'`/`"…"`/`` `…` ``), quote-safe for
+ * attribute selectors. When `dryRun` is true, computes counts without writing.
+ */
+export declare function applyRewrites(files: string[], rewrites: Map<string, string>, dryRun: boolean): FixResult;
+/**
+ * Replace `oldSel` with `newSel` only inside a matching pair of quotes.
+ * Quote-safe: if the source wraps the old selector in the same quote the new
+ * selector uses (attribute selectors contain `"`), re-wrap the replacement in a
+ * quote char not present in `newSel` so we never emit a broken string literal.
+ */
+export declare function replaceQuoted(text: string, oldSel: string, newSel: string): {
+    text: string;
+    count: number;
+};
+/** Expand file/dir paths to a de-duped list of code files (skips node_modules/.git). */
+export declare function collectFiles(paths: string[], onSkip?: (p: string) => void): string[];

package/dist/fixEngine.js

@@ -0,0 +1,154 @@
+"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.computeRewrites = computeRewrites;
+exports.applyRewrites = applyRewrites;
+exports.replaceQuoted = replaceQuoted;
+exports.collectFiles = collectFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Map of old→new selector, taken ONLY from the healable rows. */
+function computeRewrites(rows) {
+    const rewrites = new Map();
+    for (const r of rows) {
+        if (r.status === 'healable' && r.selector && r.healedSelector) {
+            rewrites.set(r.selector, r.healedSelector);
+        }
+    }
+    return rewrites;
+}
+/**
+ * Apply `rewrites` to every file in `files`. Replaces a selector only where it
+ * appears as a quoted string literal (`'…'`/`"…"`/`` `…` ``), quote-safe for
+ * attribute selectors. When `dryRun` is true, computes counts without writing.
+ */
+function applyRewrites(files, rewrites, dryRun) {
+    const edits = [];
+    let totalReplacements = 0;
+    if (rewrites.size > 0) {
+        for (const file of files) {
+            const original = fs.readFileSync(file, 'utf8');
+            let updated = original;
+            const replacements = [];
+            for (const [from, to] of rewrites) {
+                const res = replaceQuoted(updated, from, to);
+                if (res.count > 0) {
+                    updated = res.text;
+                    replacements.push({ from, to, count: res.count });
+                    totalReplacements += res.count;
+                }
+            }
+            if (updated !== original) {
+                if (!dryRun)
+                    fs.writeFileSync(file, updated, 'utf8');
+                edits.push({ file, replacements });
+            }
+        }
+    }
+    return {
+        rewrites: Array.from(rewrites, ([from, to]) => ({ from, to })),
+        filesScanned: files.length,
+        edits,
+        totalReplacements,
+        dryRun,
+    };
+}
+const QUOTES = ['"', "'", '`'];
+/**
+ * Replace `oldSel` with `newSel` only inside a matching pair of quotes.
+ * Quote-safe: if the source wraps the old selector in the same quote the new
+ * selector uses (attribute selectors contain `"`), re-wrap the replacement in a
+ * quote char not present in `newSel` so we never emit a broken string literal.
+ */
+function replaceQuoted(text, oldSel, newSel) {
+    let count = 0;
+    let out = text;
+    for (const q of QUOTES) {
+        const needle = q + oldSel + q;
+        if (out.indexOf(needle) === -1)
+            continue;
+        const wrap = newSel.indexOf(q) === -1 ? q : QUOTES.find((c) => newSel.indexOf(c) === -1);
+        if (!wrap)
+            continue;
+        const replacement = wrap + newSel + wrap;
+        const parts = out.split(needle);
+        count += parts.length - 1;
+        out = parts.join(replacement);
+    }
+    return { text: out, count };
+}
+const CODE_EXT = new Set([
+    '.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs',
+    '.py', '.java', '.cs', '.rb', '.php', '.go', '.kt', '.feature',
+]);
+/** Expand file/dir paths to a de-duped list of code files (skips node_modules/.git). */
+function collectFiles(paths, onSkip) {
+    const out = [];
+    const seen = new Set();
+    const add = (f) => {
+        const abs = path.resolve(f);
+        if (!seen.has(abs)) {
+            seen.add(abs);
+            out.push(abs);
+        }
+    };
+    for (const p of paths) {
+        let stat;
+        try {
+            stat = fs.statSync(p);
+        }
+        catch {
+            onSkip?.(p);
+            continue;
+        }
+        if (stat.isDirectory())
+            walkDir(p, add);
+        else
+            add(p);
+    }
+    return out;
+}
+function walkDir(dir, add) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name === '.git')
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            walkDir(full, add);
+        else if (CODE_EXT.has(path.extname(entry.name)))
+            add(full);
+    }
+}
+//# sourceMappingURL=fixEngine.js.map

package/dist/fixEngine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { aiClick, aiFill, llmResolverStub } from './playwright/healer';
+export type { HealerOptions } from './playwright/healer';
+export { extractInteractiveElements, loadMapping, saveMapping } from './aom';
+export type { MappedElement, PageMapping } from './aom';
+export { renderPageContract, saveMarkdown, markdownPath } from './markdown';
+export { mapUrl, pageNameFromUrl } from './mapUrl';
+export { launchBrowser } from './launcher';
+export type { BrowserChoice, LaunchedBrowser } from './launcher';
+export type { MapUrlOptions, MapUrlResult } from './mapUrl';
+export { computeRewrites, applyRewrites, collectFiles, replaceQuoted } from './fixEngine';
+export { loadConfig, resolveSecret } from './config';
+export type { IaQaConfig, SecretRef, PageTarget, AuthConfig } from './config';

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSecret = exports.loadConfig = exports.replaceQuoted = exports.collectFiles = exports.applyRewrites = exports.computeRewrites = exports.launchBrowser = exports.pageNameFromUrl = exports.mapUrl = exports.markdownPath = exports.saveMarkdown = exports.renderPageContract = exports.saveMapping = exports.loadMapping = exports.extractInteractiveElements = exports.llmResolverStub = exports.aiFill = exports.aiClick = void 0;
+var healer_1 = require("./playwright/healer");
+Object.defineProperty(exports, "aiClick", { enumerable: true, get: function () { return healer_1.aiClick; } });
+Object.defineProperty(exports, "aiFill", { enumerable: true, get: function () { return healer_1.aiFill; } });
+Object.defineProperty(exports, "llmResolverStub", { enumerable: true, get: function () { return healer_1.llmResolverStub; } });
+var aom_1 = require("./aom");
+Object.defineProperty(exports, "extractInteractiveElements", { enumerable: true, get: function () { return aom_1.extractInteractiveElements; } });
+Object.defineProperty(exports, "loadMapping", { enumerable: true, get: function () { return aom_1.loadMapping; } });
+Object.defineProperty(exports, "saveMapping", { enumerable: true, get: function () { return aom_1.saveMapping; } });
+var markdown_1 = require("./markdown");
+Object.defineProperty(exports, "renderPageContract", { enumerable: true, get: function () { return markdown_1.renderPageContract; } });
+Object.defineProperty(exports, "saveMarkdown", { enumerable: true, get: function () { return markdown_1.saveMarkdown; } });
+Object.defineProperty(exports, "markdownPath", { enumerable: true, get: function () { return markdown_1.markdownPath; } });
+var mapUrl_1 = require("./mapUrl");
+Object.defineProperty(exports, "mapUrl", { enumerable: true, get: function () { return mapUrl_1.mapUrl; } });
+Object.defineProperty(exports, "pageNameFromUrl", { enumerable: true, get: function () { return mapUrl_1.pageNameFromUrl; } });
+var launcher_1 = require("./launcher");
+Object.defineProperty(exports, "launchBrowser", { enumerable: true, get: function () { return launcher_1.launchBrowser; } });
+var fixEngine_1 = require("./fixEngine");
+Object.defineProperty(exports, "computeRewrites", { enumerable: true, get: function () { return fixEngine_1.computeRewrites; } });
+Object.defineProperty(exports, "applyRewrites", { enumerable: true, get: function () { return fixEngine_1.applyRewrites; } });
+Object.defineProperty(exports, "collectFiles", { enumerable: true, get: function () { return fixEngine_1.collectFiles; } });
+Object.defineProperty(exports, "replaceQuoted", { enumerable: true, get: function () { return fixEngine_1.replaceQuoted; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "resolveSecret", { enumerable: true, get: function () { return config_1.resolveSecret; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,8CAAuE;AAA9D,iGAAA,OAAO,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,yGAAA,eAAe,OAAA;AAEzC,6BAA6E;AAApE,iHAAA,0BAA0B,OAAA;AAAE,kGAAA,WAAW,OAAA;AAAE,kGAAA,WAAW,OAAA;AAE7D,uCAA4E;AAAnE,8GAAA,kBAAkB,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AACvD,mCAAmD;AAA1C,gGAAA,MAAM,OAAA;AAAE,yGAAA,eAAe,OAAA;AAChC,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AAGtB,yCAA0F;AAAjF,4GAAA,eAAe,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA;AACpE,mCAAqD;AAA5C,oGAAA,UAAU,OAAA;AAAE,uGAAA,aAAa,OAAA"}

package/dist/launcher.d.ts

@@ -0,0 +1,38 @@
+import { Browser } from 'playwright';
+/**
+ * Browser resolution — reuse whatever is already on the machine before asking
+ * anyone to download 150 MB.
+ *
+ * Two facts drive this:
+ *  1. Playwright's browser cache is **machine-wide and shared**
+ *     (`%LOCALAPPDATA%\ms-playwright` / `~/.cache/ms-playwright`). If the user
+ *     already has ANY Playwright install — their own tests, or the Playwright
+ *     MCP — the bundled Chromium is already there and we reuse it for free.
+ *     There is no "second Chromium" to avoid.
+ *  2. The real cost is **revision skew**: a different Playwright version pins a
+ *     different Chromium revision, which does trigger a fresh download. For that
+ *     case (and for locked-down machines that forbid the download), we let the
+ *     caller point at a browser that already exists.
+ *
+ * Resolution order:
+ *   1. explicit executable path  (`browserPath` / `$IAQA_BROWSER_PATH`)
+ *   2. explicit channel          (`browserChannel` / `$IAQA_BROWSER_CHANNEL`, e.g. `chrome`, `msedge`)
+ *   3. Playwright's bundled Chromium (shared cache — usually already present)
+ *   4. fallback: the system Google Chrome, then Microsoft Edge
+ * Only if all four fail do we error, with an actionable message.
+ *
+ * For DOM extraction the engine is irrelevant — Chrome, Edge and Chromium all
+ * produce the same contract — so reusing the system browser is safe here.
+ */
+export interface BrowserChoice {
+    /** Absolute path to a browser executable. Wins over everything. */
+    browserPath?: string;
+    /** Playwright channel: 'chrome' | 'msedge' | 'chrome-beta'… */
+    browserChannel?: string;
+}
+export interface LaunchedBrowser {
+    browser: Browser;
+    /** Human-readable description of what we actually launched. */
+    using: string;
+}
+export declare function launchBrowser(choice?: BrowserChoice): Promise<LaunchedBrowser>;

package/dist/launcher.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchBrowser = launchBrowser;
+const playwright_1 = require("playwright");
+async function launchBrowser(choice = {}) {
+    const execPath = choice.browserPath || process.env.IAQA_BROWSER_PATH;
+    const channel = choice.browserChannel || process.env.IAQA_BROWSER_CHANNEL;
+    if (execPath) {
+        const browser = await playwright_1.chromium.launch({ headless: true, executablePath: execPath });
+        return { browser, using: `browser at ${execPath}` };
+    }
+    if (channel) {
+        const browser = await playwright_1.chromium.launch({ headless: true, channel });
+        return { browser, using: `system browser (channel "${channel}")` };
+    }
+    try {
+        const browser = await playwright_1.chromium.launch({ headless: true });
+        return { browser, using: 'bundled Chromium (shared Playwright cache)' };
+    }
+    catch (bundledError) {
+        for (const fallback of ['chrome', 'msedge']) {
+            try {
+                const browser = await playwright_1.chromium.launch({ headless: true, channel: fallback });
+                return { browser, using: `system browser (channel "${fallback}") — bundled Chromium not installed` };
+            }
+            catch {
+                /* try the next one */
+            }
+        }
+        const reason = bundledError instanceof Error ? bundledError.message.split('\n')[0] : String(bundledError);
+        throw new Error(`No usable browser found. ${reason}\n` +
+            'Fix it with any one of these:\n' +
+            '  • install the bundled browser:  npx playwright install chromium\n' +
+            '  • reuse an installed browser:   set IAQA_BROWSER_CHANNEL=chrome (or msedge)\n' +
+            '  • point at an executable:       set IAQA_BROWSER_PATH=/path/to/chrome');
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":";;AAyCA,sCAmCC;AA5ED,2CAA+C;AAyCxC,KAAK,UAAU,aAAa,CAAC,SAAwB,EAAE;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAE1E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,QAAQ,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,OAAO,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,KAAK,MAAM,QAAQ,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,QAAQ,qCAAqC,EAAE,CAAC;YACvG,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1G,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,IAAI;YACpC,iCAAiC;YACjC,qEAAqE;YACrE,iFAAiF;YACjF,yEAAyE,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC"}