@ia-qa/self-healing 0.1.0

package/dist/cli/diff.js

@@ -0,0 +1,143 @@
+"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.runDiff = runDiff;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const match_1 = require("../browser/match");
+/**
+ * `ia-qa-heal diff <baseline.json> <current.json>` — CI-gate verdict.
+ *
+ * Reads two mappings (produced by `ia-qa-heal map` or the browser snippet on
+ * ia-qa.com) and reports which selectors survived, which the runtime healer
+ * would recover, and which will hard-fail. Same engine as the web tool.
+ *
+ * Exit codes (so a pipeline can gate on it):
+ *   0 — PASS, or FIX without `--strict`
+ *   1 — BLOCK (a selector broke with no semantic match), or FIX with `--strict`
+ *   2 — bad usage / unreadable input
+ */
+async function runDiff(args) {
+    const strict = args.includes('--strict');
+    const json = args.includes('--json');
+    const files = args.filter((a) => !a.startsWith('--'));
+    if (files.length !== 2) {
+        console.error('Usage: ia-qa-heal diff <baseline.json> <current.json> [--strict] [--json]');
+        process.exitCode = 2;
+        return;
+    }
+    const [baseline, current] = files.map((f) => readMapping(f));
+    const report = (0, match_1.diffMappings)(baseline, current);
+    if (json) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        printHuman(report, files);
+    }
+    const failing = report.verdict === 'BLOCK' || (strict && report.verdict === 'FIX');
+    process.exitCode = failing ? 1 : 0;
+}
+function readMapping(file) {
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        console.error(`❌ Cannot read "${file}".`);
+        process.exit(2);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        console.error(`❌ "${file}" is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(2);
+    }
+    if (!parsed || !Array.isArray(parsed.elements)) {
+        console.error(`❌ "${file}" has no "elements" array — is it a mapping file?`);
+        process.exit(2);
+    }
+    return parsed;
+}
+function printHuman(report, files) {
+    const { verdict, counts, rows, added } = report;
+    const icon = verdict === 'PASS' ? '✅' : verdict === 'FIX' ? '🔧' : '⛔';
+    console.log(`\n${icon}  ${verdict}`);
+    console.log(`   ${path.basename(files[0])} → ${path.basename(files[1])}  ·  ` +
+        `${counts.ok} ok · ${counts.renamed} renamed · ${counts.healable} healable · ` +
+        `${counts.ambiguous} ambiguous · ${counts.lost} lost · ${counts.added} new\n`);
+    const drift = rows.filter((r) => r.status !== 'ok');
+    for (const r of drift) {
+        if (r.status === 'healable') {
+            const how = r.matchType === 'exact' ? 'exact name' : `fuzzy ${Math.round((r.score ?? 0) * 100)}%`;
+            const by = r.disambiguatedBy === 'context' ? `, by context "${r.context}"` : '';
+            console.log(`   🔧 healable   ${label(r)}\n               ${r.selector}  →  ${r.healedSelector}  (${how}${by})`);
+        }
+        else if (r.status === 'renamed') {
+            console.log(`   ✏️  renamed    ${label(r)}\n               name "${r.name}" → "${r.newName}"  ·  selector still valid: ${r.selector}`);
+        }
+        else if (r.status === 'ambiguous') {
+            console.log(`   ❓ ambiguous  ${label(r)}\n               ${r.selector}  →  ${r.candidateCount} equally-good matches, context "${r.context || ''}" won't disambiguate — human decides`);
+        }
+        else {
+            console.log(`   ⛔ lost       ${label(r)}\n               ${r.selector}  →  (no match)`);
+        }
+    }
+    for (const r of added) {
+        console.log(`   ➕ new        ${label(r)}\n               ${r.selector}`);
+    }
+    console.log('');
+    if (counts.lost > 0) {
+        console.log('   ⛔ Lost selectors have no match — self-healing cannot recover them; a human must fix or delete the test.');
+    }
+    if (counts.ambiguous > 0) {
+        console.log('   ❓ Ambiguous selectors match several elements — healing would be a guess; a human decides (or add a data-testid).');
+    }
+    if (counts.healable > 0) {
+        console.log('   🔧 Healable selectors have a deterministic old→new rewrite — apply with `ia-qa-heal fix`.');
+    }
+    if (counts.renamed > 0) {
+        console.log('   ✏️  Renamed elements still pass (selector valid) but the label changed — check it is intended, not a regression.');
+    }
+    if (verdict === 'PASS' && counts.renamed === 0) {
+        console.log('   ✅ No drift — your suite is safe to run.');
+    }
+    console.log('');
+}
+function label(r) {
+    return `${r.role} "${r.name || '(no name)'}"`;
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/diff.js.map

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

package/dist/cli/fix.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `ia-qa-heal fix <before.json> <after.json> <test-paths…> [--dry-run]`
+ *
+ * The deterministic half of self-healing. Diffs two mappings, takes ONLY the
+ * `healable` rows (selector broke, role + name + context still identify exactly
+ * one element → unambiguous old→new selector), and rewrites those selectors in
+ * your test files — only where they appear as a quoted string literal, so a
+ * substring like `button#login` never corrupts `button#login-btn`.
+ *
+ * It **prepares the ground, the human decides**: it edits the working tree and
+ * never commits. LOST / AMBIGUOUS / RENAMED are printed but never touched.
+ * Presentation only — the engine lives in `../fixEngine` and is shared with the
+ * MCP server's `fix_tests` tool.
+ *
+ * Exit codes: 0 on a successful run (even with 0 rewrites); 2 = bad input.
+ */
+export declare function runFix(args: string[]): Promise<void>;

package/dist/cli/fix.js

@@ -0,0 +1,144 @@
+"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.runFix = runFix;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const match_1 = require("../browser/match");
+const fixEngine_1 = require("../fixEngine");
+/**
+ * `ia-qa-heal fix <before.json> <after.json> <test-paths…> [--dry-run]`
+ *
+ * The deterministic half of self-healing. Diffs two mappings, takes ONLY the
+ * `healable` rows (selector broke, role + name + context still identify exactly
+ * one element → unambiguous old→new selector), and rewrites those selectors in
+ * your test files — only where they appear as a quoted string literal, so a
+ * substring like `button#login` never corrupts `button#login-btn`.
+ *
+ * It **prepares the ground, the human decides**: it edits the working tree and
+ * never commits. LOST / AMBIGUOUS / RENAMED are printed but never touched.
+ * Presentation only — the engine lives in `../fixEngine` and is shared with the
+ * MCP server's `fix_tests` tool.
+ *
+ * Exit codes: 0 on a successful run (even with 0 rewrites); 2 = bad input.
+ */
+async function runFix(args) {
+    const dryRun = args.includes('--dry-run');
+    const rest = args.filter((a) => !a.startsWith('--'));
+    const [beforeFile, afterFile, ...testPaths] = rest;
+    if (!beforeFile || !afterFile || testPaths.length === 0) {
+        console.error('Usage: ia-qa-heal fix <before.json> <after.json> <test-file-or-dir…> [--dry-run]');
+        process.exitCode = 2;
+        return;
+    }
+    const before = readMapping(beforeFile);
+    const after = readMapping(afterFile);
+    const report = (0, match_1.diffMappings)(before, after);
+    const rewrites = (0, fixEngine_1.computeRewrites)(report.rows);
+    const files = (0, fixEngine_1.collectFiles)(testPaths, (p) => console.error(`⚠ Skipping "${p}" — not found.`));
+    if (files.length === 0) {
+        console.error(`No test files found under: ${testPaths.join(', ')}`);
+        process.exitCode = 2;
+        return;
+    }
+    console.log(`\n🔧 ia-qa-heal fix — deterministic selector rewrite${dryRun ? ' (dry run)' : ''}`);
+    console.log(`   ${rewrites.size} healable rewrite${rewrites.size === 1 ? '' : 's'} · ${files.length} file${files.length === 1 ? '' : 's'} scanned\n`);
+    const result = (0, fixEngine_1.applyRewrites)(files, rewrites, dryRun);
+    if (rewrites.size === 0) {
+        console.log('   No healable rewrites in this diff — nothing to apply.');
+    }
+    else if (result.edits.length === 0) {
+        console.log('   No test file referenced any of the healable selectors — nothing to rewrite.');
+    }
+    else {
+        for (const edit of result.edits) {
+            console.log(`   ${dryRun ? 'would edit' : '✎ edited'}  ${path.relative(process.cwd(), edit.file)}`);
+            for (const r of edit.replacements)
+                console.log(`               ${r.count}× ${r.from} → ${r.to}`);
+        }
+    }
+    printNeedsHuman(report);
+    console.log(`\n   ${dryRun ? 'Would apply' : 'Applied'} ${result.totalReplacements} replacement${result.totalReplacements === 1 ? '' : 's'} in ${result.edits.length} file${result.edits.length === 1 ? '' : 's'}.` +
+        (dryRun ? ' (dry run — nothing written.)' : ''));
+    if (!dryRun && result.totalReplacements > 0) {
+        console.log('   Review with `git diff`, then commit and push if it looks right. Nothing was committed.\n');
+    }
+    else {
+        console.log('');
+    }
+    process.exitCode = 0;
+}
+function printNeedsHuman(report) {
+    const flagged = report.rows.filter((r) => r.status === 'lost' || r.status === 'ambiguous' || r.status === 'renamed');
+    if (flagged.length === 0)
+        return;
+    console.log('\n   Not applied — needs your judgment:');
+    for (const r of flagged) {
+        const who = `${r.role} "${r.name || '(no name)'}"`;
+        if (r.status === 'lost') {
+            console.log(`   ⛔ lost       ${who}  ·  ${r.selector} has no match — fix or delete the test by hand.`);
+        }
+        else if (r.status === 'ambiguous') {
+            console.log(`   ❓ ambiguous  ${who}  ·  ${r.candidateCount} equal matches — pick one, or add a data-testid.`);
+        }
+        else {
+            console.log(`   ✏️  renamed    ${who}  ·  name → "${r.newName}" — selector still valid; confirm it's intended.`);
+        }
+    }
+}
+function readMapping(file) {
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        console.error(`❌ Cannot read "${file}".`);
+        process.exit(2);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        console.error(`❌ "${file}" is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(2);
+    }
+    if (!parsed || !Array.isArray(parsed.elements)) {
+        console.error(`❌ "${file}" has no "elements" array — is it a mapping file?`);
+        process.exit(2);
+    }
+    return parsed;
+}
+//# sourceMappingURL=fix.js.map

package/dist/cli/fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.js","sourceRoot":"","sources":["../../src/cli/fix.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,wBAuDC;AA7ED,uCAAyB;AACzB,2CAA6B;AAE7B,4CAAgD;AAChD,4CAA4E;AAE5E;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IAEnD,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,KAAK,CACX,kFAAkF,CACnF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAA,2BAAe,EAAC,MAAM,CAAC,IAAiB,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAG,IAAA,wBAAY,EAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,8BAA8B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uDAAuD,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,OAAO,CAAC,GAAG,CACT,MAAM,QAAQ,CAAC,IAAI,oBAAoB,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,CACzI,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,yBAAa,EAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEtD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IAC1E,CAAC;SAAM,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAChG,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAED,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,CAAC,GAAG,CACT,QAAQ,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,iBAAiB,eAAe,MAAM,CAAC,iBAAiB,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QACrM,CAAC,MAAM,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,CAAC,CAClD,CAAC;IACF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,6FAA6F,CAAC,CAAC;IAC7G,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;AAaD,SAAS,eAAe,CAAC,MAA2B;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACjF,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,QAAQ,CAAC,CAAC,QAAQ,iDAAiD,CAAC,CAAC;QACzG,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,QAAQ,CAAC,CAAC,cAAc,kDAAkD,CAAC,CAAC;QAChH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,gBAAgB,CAAC,CAAC,OAAO,kDAAkD,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IAC1C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,mDAAmD,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const init_1 = require("./init");
+const map_1 = require("./map");
+const diff_1 = require("./diff");
+const fix_1 = require("./fix");
+const HELP = `ia-qa-heal — self-healing E2E toolkit (MVP)
+
+Usage:
+  ia-qa-heal init                          Interactive setup wizard (writes .ia-qa/config.json)
+  ia-qa-heal map [page]                    Map configured pages → .ia-qa/mapping/<page>.json + .md
+  ia-qa-heal diff <before> <after>         Diff two mappings → PASS/FIX/BLOCK verdict (CI gate)
+                                             --strict  fail on FIX too   --json  machine-readable output
+  ia-qa-heal fix <before> <after> <tests…> Apply the deterministic healable rewrites to your test files
+                                             --dry-run  show the plan without writing. Never commits.
+  ia-qa-heal help                          Show this help
+`;
+async function main() {
+    const [, , command, ...rest] = process.argv;
+    const arg = rest[0];
+    switch (command) {
+        case 'init':
+            await (0, init_1.runInit)();
+            break;
+        case 'map':
+            await (0, map_1.runMap)(arg);
+            break;
+        case 'diff':
+            await (0, diff_1.runDiff)(rest);
+            break;
+        case 'fix':
+            await (0, fix_1.runFix)(rest);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            console.log(HELP);
+            break;
+        default:
+            console.error(`Unknown command "${command}".\n\n${HELP}`);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(`\n❌ ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,iCAAiC;AACjC,+BAA+B;AAC/B,iCAAiC;AACjC,+BAA+B;AAE/B,MAAM,IAAI,GAAG;;;;;;;;;;CAUZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,GAAE,CAAC;YAChB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,IAAA,YAAM,EAAC,GAAG,CAAC,CAAC;YAClB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACpB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,IAAA,YAAM,EAAC,IAAI,CAAC,CAAC;YACnB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,SAAS,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `ia-qa-heal init` — interactive wizard.
+ *
+ * Guides the user through target framework, secret storage (local .env or AWS
+ * SSM Parameter Store), optional login flow, and the pages to map. Writes
+ * `.ia-qa/config.json` containing only secret *references* — never a value.
+ */
+export declare function runInit(): Promise<void>;

package/dist/cli/init.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const prompts_1 = __importDefault(require("prompts"));
+const config_1 = require("../config");
+/**
+ * `ia-qa-heal init` — interactive wizard.
+ *
+ * Guides the user through target framework, secret storage (local .env or AWS
+ * SSM Parameter Store), optional login flow, and the pages to map. Writes
+ * `.ia-qa/config.json` containing only secret *references* — never a value.
+ */
+async function runInit() {
+    console.log('\n🔧 ia-qa self-healing — project setup\n');
+    const onCancel = () => {
+        console.error('\nSetup aborted — nothing was written.');
+        process.exit(1);
+    };
+    const base = await (0, prompts_1.default)([
+        {
+            type: 'select',
+            name: 'framework',
+            message: 'Target test framework',
+            choices: [{ title: 'Playwright', value: 'playwright' }],
+            initial: 0,
+        },
+        {
+            type: 'text',
+            name: 'baseUrl',
+            message: 'Base URL of the application under test',
+            initial: 'https://staging.example.com',
+            validate: (v) => {
+                try {
+                    new URL(v);
+                    return true;
+                }
+                catch {
+                    return 'Enter a full URL, e.g. https://staging.example.com';
+                }
+            },
+        },
+        {
+            type: 'confirm',
+            name: 'needsAuth',
+            message: 'Does the app require a login step before mapping?',
+            initial: true,
+        },
+    ], { onCancel });
+    const secrets = {};
+    let auth;
+    if (base.needsAuth) {
+        const store = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'source',
+            message: 'Where are the test credentials stored?',
+            choices: [
+                { title: 'Local .env file (read from process.env at runtime)', value: 'env' },
+                { title: 'AWS SSM Parameter Store (fetched via your local AWS credentials)', value: 'aws-ssm' },
+            ],
+        }, { onCancel });
+        const source = store.source;
+        if (source === 'env') {
+            const env = await (0, prompts_1.default)([
+                {
+                    type: 'text',
+                    name: 'usernameKey',
+                    message: 'Env var holding the username',
+                    initial: 'E2E_USERNAME',
+                },
+                {
+                    type: 'text',
+                    name: 'passwordKey',
+                    message: 'Env var holding the password',
+                    initial: 'E2E_PASSWORD',
+                },
+            ], { onCancel });
+            secrets.username = { source, key: env.usernameKey };
+            secrets.password = { source, key: env.passwordKey };
+        }
+        else {
+            const ssm = await (0, prompts_1.default)([
+                {
+                    type: 'text',
+                    name: 'usernameParam',
+                    message: 'SSM parameter name for the username',
+                    initial: '/staging/app/username',
+                },
+                {
+                    type: 'text',
+                    name: 'passwordParam',
+                    message: 'SSM parameter name for the password (SecureString recommended)',
+                    initial: '/staging/app/password',
+                },
+                {
+                    type: 'text',
+                    name: 'region',
+                    message: 'AWS region',
+                    initial: 'eu-west-3',
+                },
+            ], { onCancel });
+            secrets.username = { source, key: ssm.usernameParam, region: ssm.region };
+            secrets.password = { source, key: ssm.passwordParam, region: ssm.region };
+        }
+        const form = await (0, prompts_1.default)([
+            { type: 'text', name: 'loginUrl', message: 'Login page path', initial: '/login' },
+            {
+                type: 'text',
+                name: 'usernameSelector',
+                message: 'Username/email input selector',
+                initial: 'input[name="email"]',
+            },
+            {
+                type: 'text',
+                name: 'passwordSelector',
+                message: 'Password input selector',
+                initial: 'input[type="password"]',
+            },
+            {
+                type: 'text',
+                name: 'submitSelector',
+                message: 'Submit button selector',
+                initial: 'button[type="submit"]',
+            },
+            {
+                type: 'text',
+                name: 'successSelector',
+                message: 'Selector visible once logged in (optional, blank to skip)',
+                initial: '',
+            },
+        ], { onCancel });
+        auth = {
+            loginUrl: form.loginUrl,
+            usernameSelector: form.usernameSelector,
+            passwordSelector: form.passwordSelector,
+            submitSelector: form.submitSelector,
+            usernameSecret: 'username',
+            passwordSecret: 'password',
+            ...(form.successSelector ? { successSelector: form.successSelector } : {}),
+        };
+    }
+    const pagesAnswer = await (0, prompts_1.default)({
+        type: 'text',
+        name: 'pagesRaw',
+        message: 'Pages to map — comma-separated "name=path" pairs',
+        initial: 'home=/',
+        validate: (v) => parsePages(v).length > 0 || 'Expected format: home=/,dashboard=/dashboard',
+    }, { onCancel });
+    const pages = parsePages(pagesAnswer.pagesRaw);
+    const config = {
+        framework: base.framework,
+        baseUrl: base.baseUrl,
+        secrets,
+        ...(auth ? { auth } : {}),
+        pages,
+    };
+    const file = (0, config_1.saveConfig)(config);
+    console.log(`\n✅ Wrote ${file}`);
+    console.log(`   Secrets are stored as references only — values stay in ${auth ? describeStore(secrets) : 'your environment'}.`);
+    console.log('\nNext steps:');
+    console.log('  1. ia-qa-heal map            # map every configured page');
+    console.log('  2. import { aiClick } from "@ia-qa/self-healing" in your Playwright tests\n');
+}
+function parsePages(raw) {
+    return raw
+        .split(',')
+        .map((pair) => pair.trim())
+        .filter(Boolean)
+        .map((pair) => {
+        const eq = pair.indexOf('=');
+        if (eq <= 0)
+            return null;
+        const name = pair.slice(0, eq).trim();
+        const url = pair.slice(eq + 1).trim();
+        return name && url ? { name, url } : null;
+    })
+        .filter((p) => p !== null);
+}
+function describeStore(secrets) {
+    const first = Object.values(secrets)[0];
+    return first?.source === 'aws-ssm' ? 'AWS SSM Parameter Store' : `your local .env (${config_1.CONFIG_DIR} never holds values)`;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/map.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `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`.
+ */
+export declare function runMap(pageNameArg?: string): Promise<void>;