sela-core 0.1.0-alpha.39 → 0.1.0-alpha.41

package/dist/services/HealReportService.js

@@ -65,6 +65,7 @@ const crypto_1 = require("crypto");
 const atomicWrite_1 = require("../utils/atomicWrite");
 const logger_1 = require("../utils/logger");
 const ReportGenerator_1 = require("./ReportGenerator");
+const RegressionReclassifier_1 = require("./RegressionReclassifier");
 /**
  * Compute a stable, run-independent key for an event.
  * Based solely on immutable facts: normalized file path, line number, and original (broken) selector.
@@ -314,6 +315,13 @@ exports.REPORT_JSON_FILE = "sela-report.json";
  * Merge a regression verdict into the report at `targetDir` and rewrite
  * `sela-report.html` + `sela-report.json`. Returns the HTML path.
  * Throws when no base report exists (Job 2 must run after Job 1).
+ *
+ * When `regression.records` (the manifest) is supplied, each BYPASSED event is
+ * reclassified against its OWN blast-radius verdict (see
+ * {@link reclassifyBypassEvents}): a fix whose downstream tests all passed is
+ * promoted to HEALED, one whose tests broke is demoted to FAILED. Stats + ROI
+ * are recomputed from the reclassified stream so the donut, KPIs and filters
+ * reflect the post-regression truth — history is left untouched (Job 1 owns it).
  */
 function mergeRegressionIntoReport(targetDir, regression, opts = {}) {
     const jsonPath = opts.reportJsonPath ?? path.join(targetDir, exports.REPORT_JSON_FILE);
@@ -322,8 +330,20 @@ function mergeRegressionIntoReport(targetDir, regression, opts = {}) {
             `Run the primary suite (Job 1) before shadow-regression (Job 2).`);
     }
     const base = JSON.parse(fs.readFileSync(jsonPath, "utf8"));
+    let events = base.events;
+    let stats = base.stats;
+    let roi = base.roi;
+    if (regression.records && regression.records.length > 0) {
+        const { events: reclassified } = (0, RegressionReclassifier_1.reclassifyBypassEvents)(base.events, regression.records, regression.regressionTests);
+        events = reclassified;
+        stats = ReportGenerator_1.ReportGenerator.computeStats(events);
+        roi = ReportGenerator_1.ReportGenerator.computeRoiMetrics(events, base.historical_runs ?? [], stats);
+    }
     const merged = {
         ...base,
+        events,
+        stats,
+        roi,
         regressionState: regression.regressionState,
         regressionTests: regression.regressionTests,
     };
@@ -719,6 +739,12 @@ const REPORT_CSS = [
     ".fail-img-wrap{background:var(--bg1);border:1px solid var(--line);border-radius:var(--radius);overflow:hidden}",
     ".fail-img-wrap img{display:block;max-width:100%;height:auto}",
     ".fail-img-meta{padding:6px 11px;font-size:11px;color:var(--text3);font-family:var(--mono)}",
+    ".vd-pair{display:grid;grid-template-columns:1fr 1fr;gap:12px}",
+    ".vd-col{background:var(--bg1);border:1px solid var(--line);border-radius:var(--radius);overflow:hidden}",
+    ".vd-col img{display:block;width:100%;height:auto}",
+    ".vd-label{padding:6px 10px;font-size:11px;font-weight:600;color:var(--text2)}",
+    ".vd-ts{padding:0 10px 7px;font-size:10px;color:var(--text3);font-family:var(--mono)}",
+    ".vd-placeholder{padding:28px 16px;text-align:center;font-size:12px;color:var(--text3)}",
     ".prot-notice{padding:12px 14px;background:rgba(162,89,255,.07);border:1px solid rgba(162,89,255,.2);border-radius:var(--radius);font-size:12.5px;color:var(--text2);line-height:1.55}",
     ".prot-notice strong{color:var(--purple)}",
     ".bypass-banner{padding:13px 15px;background:rgba(255,184,77,.08);border:1px solid rgba(255,184,77,.32);border-radius:var(--radius);margin-bottom:14px}",
@@ -733,6 +759,13 @@ const REPORT_CSS = [
     ".row2{display:grid;grid-template-columns:1fr 1fr;gap:14px}",
     "@media(max-width:700px){.row2{grid-template-columns:1fr}}",
     ".muted-block{padding:12px 14px;background:var(--bg1);border:1px dashed var(--line);border-radius:var(--radius);font-size:12px;color:var(--text3)}",
+    ".brain-details{margin-top:14px;border:1px solid var(--line2);border-radius:var(--radius);overflow:hidden}",
+    ".brain-summary{display:flex;align-items:center;gap:8px;padding:10px 14px;cursor:pointer;font-size:13px;font-weight:600;color:var(--text2);background:var(--bg2);user-select:none;list-style:none}",
+    ".brain-summary::-webkit-details-marker{display:none}",
+    ".brain-summary .brain-arrow{font-size:10px;color:var(--text3);transition:transform .2s ease;display:inline-block}",
+    "details.brain-details[open] .brain-summary .brain-arrow{transform:rotate(90deg)}",
+    ".brain-body{padding:14px;display:flex;flex-direction:column;gap:16px;border-top:1px solid var(--line)}",
+    ".brain-section-title{font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.8px;color:var(--text3);margin-bottom:6px}",
     ".hist-row{display:grid;grid-template-columns:1fr repeat(5,80px);gap:0;font-size:12px}",
     ".hist-row .hc{padding:6px 10px;border-bottom:1px solid var(--line)}",
     ".hist-row.hdr .hc{color:var(--text3);font-size:10.5px;letter-spacing:.6px;text-transform:uppercase;background:var(--bg3)}",
@@ -816,6 +849,12 @@ const REPORT_CSS = [
     ".reg-trace{display:none;padding:10px 18px 14px;background:var(--bg0)}",
     ".reg-entry.reg-row-open .reg-trace{display:block}",
     ".reg-trace pre{font-family:var(--mono);font-size:11px;line-height:1.5;color:var(--text2);white-space:pre-wrap;word-break:break-word;margin:0}",
+    // ── Per-fix (scoped) blast-radius regression panel inside an event card
+    ".fixreg-count{margin-left:6px;font-family:var(--mono);font-size:11px;color:var(--text3);font-weight:400}",
+    ".fixreg-note{font-size:12.5px;line-height:1.55;padding:10px 13px;border-radius:var(--radius);margin-bottom:10px}",
+    ".fixreg-note.fixreg-ok{background:var(--green-dim);border:1px solid rgba(0,229,160,.32);color:var(--green)}",
+    ".fixreg-note.fixreg-bad{background:var(--red-dim);border:1px solid rgba(255,77,106,.32);color:var(--red)}",
+    ".fixreg-list{border:1px solid var(--line);border-radius:var(--radius);overflow:hidden}",
 ].join("\n");
 /* eslint-enable prettier/prettier */
 // ─────────────────────────────────────────────────────────────────────────────
@@ -1007,7 +1046,8 @@ const REPORT_JS = [
     "function confBadge(pct){",
     "  if(typeof pct!=='number'||!isFinite(pct))return'';",
     "  var cls=pct>=80?'conf-high':pct>=60?'conf-mid':'conf-low';",
-    "  return'<span class=\"conf-badge '+cls+'\">'+pct+'%</span>';",
+    "  var lbl=pct>=80?'High':pct>=60?'Medium':'Low';",
+    "  return'<span class=\"conf-badge '+cls+'\">'+lbl+' \xb7 '+pct+'%</span>';",
     "}",
     // PROTECTED events were BLOCKED - showing the AI's high confidence would be
     // a lie. Surface a strict Blocked pill instead; the honest consistency score
@@ -1025,8 +1065,10 @@ const REPORT_JS = [
     "      :'confidence too low ('+ev.aiConfidence+'/100)';",
     "    return'<div class=\"prot-notice\"><strong>Source code untouched.</strong> Sela blocked this auto-fix \u2014 '+blockMsg+'. This is a real regression surfacing in CI. Investigate <a href=\"'+vscodeLink(ev.sourceFile,ev.sourceLine)+'\">'+esc(ev.sourceFile)+':'+ev.sourceLine+'</a> manually.</div>';",
     "  }",
-    "  if(ev.kind==='FAILED')",
+    "  if(ev.kind==='FAILED'){",
+    "    if(ev.wasBypassed)return'<div class=\"muted-block\">This shared-locator heal was applied in memory for the regression run only \u2014 never written to disk. It is listed as Failed because its blast-radius regression did not pass (see the breakdown above).</div>';",
     "    return'<div class=\"muted-block\">No source code was modified. The AI could not propose a confident fix \u2014 all candidates resolved to 0 elements. Open the file directly to investigate.</div>';",
+    "  }",
     "  var isBypass=ev.kind==='BYPASSED';",
     "  var raw=isBypass?(ev.ghostDiff||''):(ev.gitUnifiedDiff||'');",
     "  var skipPfx=['diff ','index ','--- ','+++','new file','deleted','similarity','rename','Binary'];",
@@ -1179,8 +1221,52 @@ const REPORT_JS = [
     '    +\'<div class="fail-img-wrap"><img src="data:image/png;base64,\'+ev.failureScreenshotPng+\'" alt="Failure screenshot" loading="lazy"/>\'',
     "    +'<div class=\"fail-img-meta\">captured at test failure \xb7 base64-embedded</div></div></div>';",
     "}",
+    // ── Visual element diff (DNA baseline vs live capture)
+    "function renderVisualDiff(ev){",
+    "  if(ev.kind!=='HEALED'||!ev.visualDiff)return'';",
+    "  var vd=ev.visualDiff;",
+    "  function vdCol(label,ts,imgPath,placeholder){",
+    "    var meta=ts?'<div class=\"vd-ts\">'+esc(ts)+'</div>':'';",
+    "    var body=imgPath",
+    "      ?'<img src=\"'+esc(imgPath)+'\" alt=\"'+esc(label)+'\" loading=\"lazy\"/>'",
+    "      :'<div class=\"vd-placeholder\">'+esc(placeholder)+'</div>';",
+    "    return'<div class=\"vd-col\"><div class=\"vd-label\">'+esc(label)+'</div>'+body+meta+'</div>';",
+    "  }",
+    "  var leftImg=vd.dnaSnapshotPath||null;",
+    "  var leftLabel='DNA Baseline';",
+    "  var leftPlaceholder=leftImg===null?'First heal — no baseline yet':'';",
+    "  var rightImg=vd.elementFound&&vd.liveSnapshotPath?vd.liveSnapshotPath:null;",
+    "  var rightPlaceholder=vd.elementFound?'':'Element not found';",
+    "  var pair='<div class=\"vd-pair\">'",
+    "    +vdCol(leftLabel,vd.dnaSnapshotCapturedAt,leftImg,leftPlaceholder)",
+    "    +vdCol('Current (this fix)',vd.liveSnapshotCapturedAt,rightImg,rightPlaceholder)",
+    "    +'</div>';",
+    "  return'<div class=\"body-section\"><div class=\"bs-title\"><span class=\"bst-dot\"></span>Visual Element Comparison</div>'+pair+'</div>';",
+    "}",
+    // ── Per-fix scoped blast-radius regression (shadow-regression provenance)
+    // Rendered only on events reclassified by `sela shadow-regression`: a HEALED
+    // event promoted from a verified bypass, or a FAILED event demoted from a
+    // rejected one. This is a personal mini-Overview — exactly the tests in THIS
+    // fix's blast radius, which passed and which broke.
+    "function renderFixRegression(ev){",
+    "  if(!ev.regressionTests||!ev.regressionTests.length)return'';",
+    "  var st=ev.regressionState||'';",
+    "  var passN=ev.regressionTests.filter(function(t){return t.status==='PASSED';}).length;",
+    "  var failN=ev.regressionTests.filter(function(t){return t.status==='FAILED';}).length;",
+    "  var noteCls=st==='SUCCESS'?'fixreg-ok':'fixreg-bad';",
+    "  var note=ev.regressionNote?'<div class=\"fixreg-note '+noteCls+'\">'+esc(ev.regressionNote)+'</div>':'';",
+    "  var rows=ev.regressionTests.map(function(t){",
+    "    var file=esc(t.filePath||'');var name=esc(t.testName||'');",
+    "    if(t.status==='PASSED')return'<div class=\"reg-entry reg-pass\"><div class=\"reg-row\"><span class=\"reg-row-icon\">✓</span><span class=\"reg-row-name\">'+name+'</span><span class=\"reg-row-file\">'+file+'</span></div></div>';",
+    "    var err=t.error||{};var trace=(err.message||'')+(err.stack?'\\n\\n'+err.stack:'');",
+    "    return'<div class=\"reg-entry reg-fail\"><div class=\"reg-row\" onclick=\"this.parentElement.classList.toggle(\\'reg-row-open\\')\"><span class=\"reg-row-icon\">✕</span><span class=\"reg-row-name\">'+name+'</span><span class=\"reg-row-file\">'+file+'</span><svg class=\"reg-row-chev\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\"><polyline points=\"5 3 11 8 5 13\"/></svg></div><div class=\"reg-trace\"><pre>'+esc(trace)+'</pre></div></div>';",
+    "  }).join('');",
+    "  var title=st==='SUCCESS'?'Blast-Radius Regression — Passed':'Blast-Radius Regression — Failed';",
+    "  return'<div class=\"body-section\"><div class=\"bs-title\"><span class=\"bst-dot\"></span>'+esc(title)+'<span class=\"fixreg-count\">'+passN+' passed \xb7 '+failN+' failed</span></div>'+note+'<div class=\"fixreg-list\">'+rows+'</div></div>';",
+    "}",
     // ── Shared-locator runtime bypass (blast-radius protection)
     "var WARN_TRIANGLE='<svg class=\"warn-tri\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M8 1.5L15 14H1L8 1.5z\"/><line x1=\"8\" y1=\"6\" x2=\"8\" y2=\"9.5\"/><circle cx=\"8\" cy=\"11.6\" r=\"0.7\" fill=\"currentColor\" stroke=\"none\"/></svg>';",
+    "var LIGHTBULB='<svg class=\"lightbulb-icon\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M8 1a3.5 3.5 0 0 0-3.5 3.5c0 1.5.5 2.5 1 3.5v1.5h5v-1.5c.5-1 1-2 1-3.5A3.5 3.5 0 0 0 8 1z\"/><line x1=\"5\" y1=\"10.5\" x2=\"11\" y2=\"10.5\"/><path d=\"M6 12.5h4\"/><path d=\"M6.5 14h3\"/></svg>';",
     "function renderBypassBody(ev){",
     "  var link=vscodeLink(ev.sourceFile,ev.sourceLine);",
     "  var files=(ev.affectedFiles&&ev.affectedFiles.length)?'<div class=\"bb-files\">Affected: '+ev.affectedFiles.map(esc).join(', ')+'</div>':'';",
@@ -1197,15 +1283,15 @@ const REPORT_JS = [
     "    steps.push('Sela healed this run in memory but did NOT write to disk — the locator is shared by '+((ev.testFunctionCount||0)+' test(s).')+'');",
     "    steps.push('Review whether the shared declaration at '+esc(ev.variablePath||'')+' needs a structural refactor.');",
     "  }",
-    "  var row2='<div class=\"row2\" style=\"margin-top:16px\">'",
-    "    +'<div><div class=\"bs-title\"><span class=\"bst-dot\"></span>AI Reasoning \xb7 Chain of Thought</div>'+renderCoT(steps)+'</div>'",
-    "    +'<div><div class=\"bs-title\"><span class=\"bst-dot\"></span>Intent Auditor</div>'+renderAuditor(ev.auditor||null)+'</div>'",
-    "    +'</div>';",
+    "  var bypassBrainInner=''",
+    "    +'<div><div class=\"brain-section-title\">Chain of Thought</div>'+renderCoT(steps)+'</div>'",
+    "    +'<div><div class=\"brain-section-title\">Intent Audit</div>'+renderAuditor(ev.auditor||null)+'</div>';",
+    "  var bypassBrain='<details class=\"brain-details\"><summary class=\"brain-summary\"><span class=\"brain-arrow\">▶</span>'+LIGHTBULB+' AI Reasoning \xb7 Audit</summary><div class=\"brain-body\">'+bypassBrainInner+'</div></details>';",
     "  var actions='<div class=\"actions\">'",
     "    +'<a class=\"btn btn-primary\" href=\"'+link+'\">→ Open shared declaration in VS Code</a>'",
     "    +'</div>';",
     "  return banner",
-    "    +row2",
+    "    +bypassBrain",
     "    +renderVectors(ev)",
     "    +'<div class=\"body-section\"><div class=\"bs-title\"><span class=\"bst-dot\"></span>Speculative Heal (not written to disk)</div>'+renderDiff(ev)+'</div>'",
     "    +'<div class=\"body-section\"><div class=\"bs-title\"><span class=\"bst-dot\"></span>Visual DNA Evidence</div>'+renderDna(ev.dnaBefore||null,ev.dnaAfter||null)+'</div>'",
@@ -1230,7 +1316,7 @@ const REPORT_JS = [
     "  }",
     "  var link=vscodeLink(ev.sourceFile,ev.sourceLine);",
     "  var actions='';",
-    "  if(ev.kind==='HEALED'){",
+    "  if(ev.kind==='HEALED'&&!ev.wasBypassed){",
     "    actions='<div class=\"actions\">'",
     "      +'<button class=\"btn btn-primary\" data-action=\"keep\" data-id=\"'+ev.stableId+'\" onclick=\"handleAction(this,\\'keep\\',\\''+ev.stableId+'\\')\">\u2713 Keep changes</button>'",
     "      +'<button class=\"btn btn-danger\" onclick=\"handleAction(this,\\'rollback\\',\\''+ev.stableId+'\\')\">&#x21B6; Rollback</button>'",
@@ -1246,20 +1332,27 @@ const REPORT_JS = [
     "      +'<a class=\"btn btn-primary\" href=\"'+link+'\">\u2192 Open in VS Code</a>'",
     "      +'</div>';",
     "  }",
-    "  var alts=(ev.kind==='HEALED'&&ev.aiAlternatives&&ev.aiAlternatives.length)",
-    '    ?\'<div class="body-section"><div class="bs-title"><span class="bst-dot"></span>Alternative selectors considered</div><div class="alts">\'',
+    "  var brainInner=''",
+    "    +'<div><div class=\"brain-section-title\">Chain of Thought</div>'+renderCoT(steps)+'</div>'",
+    "    +'<div><div class=\"brain-section-title\">Intent Audit</div>'+renderAuditor(ev.auditor||null)+'</div>';",
+    "  if(ev.kind==='HEALED'&&ev.aiAlternatives&&ev.aiAlternatives.length){",
+    "    brainInner+='<div><div class=\"brain-section-title\">Alternatives Considered</div><div class=\"alts\">'",
     "      +ev.aiAlternatives.map(function(a){return'<div class=\"alt-row\"><span>'+esc(a)+'</span><button class=\"alt-copy\" onclick=\"copyText(\\''+esc(a)+'\\',this)\">Copy</button></div>';}).join('')",
-    "      +'</div></div>'",
-    "    :'';",
-    '  return\'<div class="row2" style="margin-top:16px">\'',
-    "    +'<div><div class=\"bs-title\"><span class=\"bst-dot\"></span>AI Reasoning \xb7 Chain of Thought</div>'+renderCoT(steps)+'</div>'",
-    "    +'<div><div class=\"bs-title\"><span class=\"bst-dot\"></span>Intent Auditor</div>'+renderAuditor(ev.auditor||null)+'</div>'",
-    "    +'</div>'",
+    "      +'</div></div>';",
+    "  }",
+    "  if(ev.dnaBefore){",
+    "    var _d=ev.dnaBefore;",
+    "    var _snip=(_d.tagName||'element')+(_d.role?' role=\"'+_d.role+'\"':'')+(_d.text?' \\''+String(_d.text).slice(0,60)+'\\'':'');",
+    "    brainInner+='<div><div class=\"brain-section-title\">Target DOM Snapshot</div><div class=\"muted-block\" style=\"font-family:var(--mono);font-size:12px\">'+esc(_snip)+'</div></div>';",
+    "  }",
+    "  var brain='<details class=\"brain-details\"><summary class=\"brain-summary\"><span class=\"brain-arrow\">▶</span>'+LIGHTBULB+' AI Reasoning & Audit</summary><div class=\"brain-body\">'+brainInner+'</div></details>';",
+    '  return\'<div class="body-section"><div class="bs-title"><span class="bst-dot"></span>Source Code Diff</div>\'+renderDiff(ev)+\'</div>\'',
+    "    +brain",
+    "    +renderFixRegression(ev)",
     "    +renderVectors(ev)",
-    '    +\'<div class="body-section"><div class="bs-title"><span class="bst-dot"></span>Source Code Diff</div>\'+renderDiff(ev)+\'</div>\'',
+    "    +renderVisualDiff(ev)",
     '    +\'<div class="body-section"><div class="bs-title"><span class="bst-dot"></span>Visual DNA Evidence</div>\'+renderDna(ev.dnaBefore||null,ev.dnaAfter||null)+\'</div>\'',
     "    +renderScreenshot(ev)",
-    "    +alts",
     "    +actions;",
     "}",
     // ── Event card

package/dist/services/IntentAuditor.d.ts

@@ -1,5 +1,6 @@
 import Anthropic from "@anthropic-ai/sdk";
 import { AncestorNode, AnchorInfo } from "../types";
+import type { LLMProvider } from "../providers/LLMProvider";
 export interface AuditRequest {
     dnaText: string;
     dnaRole?: string;
@@ -31,20 +32,21 @@ export interface AuditVerdict {
 /**
  * Constructor options for IntentAuditor.
  *
- * - `anthropic`: pre-built Anthropic client to use. Pass `null` explicitly
- *   to force the auditor into its disabled state (useful in tests that
- *   want to assert the SUSPICIOUS fallback path without touching env vars).
- *   Pass `undefined` (default) to fall back to env-based construction.
- * - `apiKey`: override the ANTHROPIC_API_KEY env var (DI-friendly).
- * - `model`: override the Haiku model id (lets tests pin the SDK call).
+ * - `provider`: pre-built LLMProvider (new path, used by SelaEngine via ProviderFactory).
+ *   Pass `null` explicitly to force disabled mode.
+ * - `anthropic`: pre-built Anthropic client (legacy path for existing tests).
+ *   Pass `null` explicitly to force disabled mode.
+ * - `apiKey`: override ANTHROPIC_API_KEY for the default env-based client.
+ * - `model`: override the Haiku model id.
  */
 export interface IntentAuditorOptions {
+    provider?: LLMProvider | null;
     anthropic?: Anthropic | null;
     apiKey?: string;
     model?: string;
 }
 export declare class IntentAuditor {
-    private anthropic;
+    private readonly provider;
     private readonly disabled;
     private readonly model;
     constructor(opts?: IntentAuditorOptions);

package/dist/services/IntentAuditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IntentAuditor.d.ts","sourceRoot":"","sources":["../../src/services/IntentAuditor.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAapD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;IACzE,yEAAyE;IACzE,cAAc,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAqDD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,GAAE,oBAAyB;IAiCrC,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAyH3D,sBAAsB,CACpB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,YAAY,EAAE,GACvB,MAAM;IAkBT,kBAAkB,CAChB,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACzC,WAAW,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACzC,MAAM;IAiBT,OAAO,CAAC,YAAY;CA8CrB"}
+{"version":3,"file":"IntentAuditor.d.ts","sourceRoot":"","sources":["../../src/services/IntentAuditor.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAY5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;IACzE,yEAAyE;IACzE,cAAc,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAqDD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,GAAE,oBAAyB;IAwCrC,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAqH3D,sBAAsB,CACpB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,YAAY,EAAE,GACvB,MAAM;IAkBT,kBAAkB,CAChB,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACzC,WAAW,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACzC,MAAM;IAiBT,OAAO,CAAC,YAAY;CA8CrB"}

package/dist/services/IntentAuditor.js

@@ -37,6 +37,7 @@ exports.IntentAuditor = void 0;
 const dotenv = __importStar(require("dotenv"));
 const SanitizingAnthropic_1 = require("./SanitizingAnthropic");
 const logger_1 = require("../utils/logger");
+const AnthropicProvider_1 = require("../providers/AnthropicProvider");
 const StructuralScoringUtils_1 = require("./confidence/StructuralScoringUtils");
 dotenv.config();
 // ═══════════════════════════════════════════════════════════════════
@@ -84,39 +85,45 @@ RESPONSE FORMAT (strict JSON, no other text):
 }`;
 const DEFAULT_AUDITOR_MODEL = "claude-haiku-4-5-20251001";
 class IntentAuditor {
-    anthropic;
+    provider;
     disabled;
     model;
     constructor(opts = {}) {
         this.model = opts.model ?? DEFAULT_AUDITOR_MODEL;
-        // Explicit `null` from the caller forces disabled mode - used by tests.
+        // New provider injection path (opts.provider is explicitly set).
+        if (opts.provider !== undefined) {
+            this.provider = opts.provider;
+            this.disabled = opts.provider === null;
+            return;
+        }
+        // Legacy: explicit `null` forces disabled mode (used by tests).
         if (opts.anthropic === null) {
-            this.anthropic = null;
+            this.provider = null;
             this.disabled = true;
             return;
         }
-        // Caller supplied a ready-to-use client → use it as-is.
+        // Legacy: caller supplied a ready-to-use Anthropic client.
         if (opts.anthropic !== undefined) {
-            this.anthropic = opts.anthropic;
+            this.provider = new AnthropicProvider_1.AnthropicProvider(this.model, opts.anthropic);
             this.disabled = false;
             return;
         }
-        // Otherwise fall back to env-based construction (legacy default).
+        // Default: env-based construction (backward compat).
         const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
         if (!apiKey) {
             logger_1.logger.warn("ANTHROPIC_API_KEY not set - auditor disabled, will return SUSPICIOUS for all audited heals");
-            this.anthropic = null;
+            this.provider = null;
             this.disabled = true;
         }
         else {
-            // Route through the PII/secrets sanitizer (T3): the auditor prompt
-            // embeds live element text, so it must be scrubbed before leaving too.
-            this.anthropic = (0, SanitizingAnthropic_1.createSanitizingAnthropic)({ apiKey });
+            // Route through the PII/secrets sanitizer (T3).
+            const sanitizedClient = (0, SanitizingAnthropic_1.createSanitizingAnthropic)({ apiKey });
+            this.provider = new AnthropicProvider_1.AnthropicProvider(this.model, sanitizedClient);
             this.disabled = false;
         }
     }
     async auditIntent(req) {
-        if (this.disabled || !this.anthropic) {
+        if (this.disabled || !this.provider) {
             return { ...FALLBACK_VERDICT };
         }
         const userMessage = [
@@ -129,14 +136,12 @@ class IntentAuditor {
             .filter(Boolean)
             .join("\n");
         try {
-            const response = await this.anthropic.messages.create({
-                model: this.model,
-                max_tokens: 256,
-                temperature: 0.1,
+            const raw = await this.provider.complete({
                 system: SYSTEM_PROMPT,
                 messages: [{ role: "user", content: userMessage }],
+                maxTokens: 256,
+                temperature: 0.1,
             });
-            const raw = response.content[0].type === "text" ? response.content[0].text : "";
             // parseVerdict returns the raw LLM verdict without the low-confidence
             // downgrade so that scoring adjustments below are applied first.
             const rawVerdict = this.parseVerdict(raw);

package/dist/services/LLMService.d.ts

@@ -1,5 +1,6 @@
 import Anthropic from "@anthropic-ai/sdk";
 import { FixRequest } from "../types";
+import type { LLMProvider } from "../providers/LLMProvider";
 export interface SelectorSegment {
     type: "frame" | "element";
     selector: string;
@@ -66,7 +67,7 @@ export type SmartChainSegment = {
     index: number;
 };
 export interface FixResponse {
-    status: "FIXED" | "NOT_FOUND";
+    status: "FIXED" | "NOT_FOUND" | "NO_HEAL";
     /**
      * LEGACY/PROXY: This selector is used for IMMEDIATE RETRY in the proxy.
      * CRITICAL: Must be as specific as the chainSegments to avoid Strict Mode errors.
@@ -86,23 +87,25 @@ export interface FixResponse {
     explanation: string;
     new_selector?: string | null;
     contentChange?: ContentChange;
+    /** Populated when status === "NO_HEAL": the LLM's reason for refusing to heal. */
+    reason?: string;
 }
 /**
  * Constructor options for LLMService.
  *
- * - `anthropic`: pre-built Anthropic client. Tests use this to inject a
- *   mock client without touching env vars or network.
- * - `apiKey`: override the env-based ANTHROPIC_API_KEY when constructing
- *   the default client.
- * - `model`: override the Sonnet model id (lets tests pin the SDK call).
+ * - `provider`: pre-built LLMProvider (new path, used by SelaEngine via ProviderFactory).
+ * - `anthropic`: pre-built Anthropic client (legacy path for existing tests).
+ * - `apiKey`: override ANTHROPIC_API_KEY for the default env-based client.
+ * - `model`: override the model id.
  */
 export interface LLMServiceOptions {
+    provider?: LLMProvider;
     anthropic?: Anthropic;
     apiKey?: string;
     model?: string;
 }
 export declare class LLMService {
-    private anthropic;
+    private readonly provider;
     private readonly model;
     constructor(opts?: LLMServiceOptions);
     private cleanJson;

package/dist/services/LLMService.d.ts.map

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

package/dist/services/LLMService.js

@@ -39,6 +39,7 @@ const SelaError_1 = require("../errors/SelaError");
 const SanitizingAnthropic_1 = require("./SanitizingAnthropic");
 const logger_1 = require("../utils/logger");
 const ConfigLoader_1 = require("../config/ConfigLoader");
+const AnthropicProvider_1 = require("../providers/AnthropicProvider");
 const Conventions_1 = require("../config/Conventions");
 dotenv.config();
 /**
@@ -178,6 +179,32 @@ NEVER omit this field. NEVER return it as a string, boolean, or null.
 Reports rendered downstream will show "n/a" when this field is missing - which
 is a clear failure signal to the developer reviewing the heal.
 
+### SCOPE BOUNDARY CHECK (evaluate BEFORE proposing any selector)
+Before returning a FIXED response, determine whether the failure is:
+  (A) SELECTOR DRIFT — the element exists in the DOM but its selector changed structurally
+      (class renamed, id updated, attribute value changed). → Proceed with FIXED.
+  (B) APP LOGIC / STATE MISMATCH — the element is ENTIRELY ABSENT because of a
+      functional bug, wrong routing, empty state, error page, or dynamic runtime variable.
+      → Return NO_HEAL immediately.
+
+Patterns that MUST trigger NO_HEAL:
+  1. The failing selector ends with a numeric suffix (e.g., "status-201", "item-3", "hi-200")
+     AND the DOM contains a similar selector with a different numeric suffix. The number
+     difference is likely a runtime state value (HTTP status code, counter, index), NOT a
+     CSS rename. Healing this would mask a backend regression.
+  2. The target element is completely absent AND the nearest DOM candidate has a fundamentally
+     different semantic role/action (e.g., original was a "Delete" action, candidate is "Save").
+  3. An error message, empty state placeholder, or loading spinner is the only visible content
+     — the application is in an unexpected state, not a selector-drift state.
+  4. The failing selector contains programmatic patterns (UUIDs, timestamps, sequential IDs)
+     that suggest the value is generated at runtime.
+
+NO_HEAL response format:
+{
+  "status": "NO_HEAL",
+  "reason": "<one sentence: why this is app logic, not selector drift>"
+}
+
 ### MANDATORY OUTPUT FORMAT
 Return ONLY valid JSON.
 
@@ -238,6 +265,12 @@ Example output D - Multiple typo corrections, each unambiguous (confidence 85-92
     { "type": "element", "selector": ".user-table >> .active-row >> internal:role=button[name=\"Submit\"i]" }
   ],
   "explanation": "Two typos corrected: '.user-tble' → '.user-table' (confirmed by DNA ancestry class) and button name 'Sumbit' → 'Submit' (confirmed by DNA text). Each fix is an unambiguous spelling correction. DNA text 'Submit' matches live DOM exactly. Semantic identity is certain."
+}
+
+Example output E - Application state mismatch, not selector drift (NO_HEAL):
+{
+  "status": "NO_HEAL",
+  "reason": "Selector 'hi-201' uses a numeric HTTP status suffix. DOM contains 'hi-200' with a different status number — this is a backend state bug, not selector drift."
 }`;
 // ─────────────────────────────────────────────────────────────────
 // HELPERS
@@ -324,12 +357,17 @@ function inferOriginalChainHint(selector) {
 }
 const DEFAULT_LLM_MODEL = "claude-sonnet-4-6";
 class LLMService {
-    anthropic;
+    provider;
     model;
     constructor(opts = {}) {
         this.model = opts.model ?? process.env.SELA_LLM_MODEL ?? DEFAULT_LLM_MODEL;
+        if (opts.provider) {
+            this.provider = opts.provider;
+            return;
+        }
         if (opts.anthropic) {
-            this.anthropic = opts.anthropic;
+            // Legacy path: wrap injected Anthropic client (used by tests).
+            this.provider = new AnthropicProvider_1.AnthropicProvider(this.model, opts.anthropic);
             return;
         }
         const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY ?? "";
@@ -337,12 +375,12 @@ class LLMService {
             throw new SelaError_1.SelaError({
                 subsystem: "LLMService",
                 code: SelaError_1.LLM_SERVICE_CODES.NO_API_KEY,
-                reason: "ANTHROPIC_API_KEY not found - pass an `anthropic` client or `apiKey` to LLMService(), or set the env var",
+                reason: "ANTHROPIC_API_KEY not found - pass a `provider` or `anthropic` client to LLMService(), or set the env var",
             });
         }
-        // Route the default client through the PII/secrets sanitizer (T3) so all
-        // outbound DOM/DNA context is scrubbed before leaving the process.
-        this.anthropic = (0, SanitizingAnthropic_1.createSanitizingAnthropic)({ apiKey });
+        // Route the default client through the PII/secrets sanitizer (T3).
+        const sanitizedClient = (0, SanitizingAnthropic_1.createSanitizingAnthropic)({ apiKey });
+        this.provider = new AnthropicProvider_1.AnthropicProvider(this.model, sanitizedClient);
     }
     cleanJson(text) {
         const cleaned = text.replace(/```json/g, "").replace(/```/g, "").trim();
@@ -520,20 +558,30 @@ ${task2}
 
 Return ONLY a raw JSON object - no markdown, no preamble.`;
         try {
-            const msg = await this.anthropic.messages.create({
-                model: this.model,
-                max_tokens: 1024,
+            const rawText = await this.provider.complete({
                 system: SYSTEM_PROMPT_TEXT +
                     buildConventionsBlock() +
                     "\nIMPORTANT: Respond ONLY with a raw JSON object.",
                 messages: [{ role: "user", content: userMessage }],
+                maxTokens: 1024,
             });
-            const rawText = msg.content[0].type === "text" ? msg.content[0].text : "";
             logger_1.logger.debug(`AI Raw Response: ${rawText}`);
             const jsonString = this.cleanJson(rawText);
             if (!jsonString)
                 throw new Error("AI did not return a valid JSON object");
             const parsed = JSON.parse(jsonString);
+            // ── NO_HEAL: LLM detected app logic failure — skip all processing ──
+            // Return immediately so SelaEngine can record a FailedEvent and surface
+            // the native Playwright error without any AST mutation attempt.
+            if (parsed.status === "NO_HEAL") {
+                logger_1.logger.warn(`[Sela] LLM NO_HEAL: ${parsed.reason ?? "application state mismatch"}`);
+                return {
+                    status: "NO_HEAL",
+                    reason: parsed.reason ?? "Application logic/state mismatch detected by LLM",
+                    segments: [],
+                    explanation: parsed.reason ?? "Application logic/state mismatch detected by LLM",
+                };
+            }
             // ── Normalise confidence: keep only finite numbers in [0,100] ─────
             // Anything else (undefined, NaN, null, string, out-of-range) collapses
             // to `undefined` so reports render "n/a" instead of synthesising 0.
@@ -611,6 +659,24 @@ Return ONLY a raw JSON object - no markdown, no preamble.`;
             if (!parsed.segments || !Array.isArray(parsed.segments)) {
                 throw new Error("AI response missing 'segments' array");
             }
+            // ── Static output contract ────────────────────────────────────────
+            // Sela only writes static selector strings to disk. If LLM returned
+            // a dynamic expression (template literal interpolation, assertion,
+            // arrow function, or JS string concatenation), treat as NOT_FOUND —
+            // never write executable code to test source.
+            //
+            // Patterns blocked:
+            //   ${...}         — template literal interpolation
+            //   expect(        — assertion leak
+            //   => {           — arrow function body
+            //   "str" + ident  — string concat with variable (e.g. "id-" + status)
+            //   ident + "str"  — string concat with variable (e.g. status + "-id")
+            const DYNAMIC_EXPR_RE = /\$\{[^}]+\}|expect\s*\(|=>\s*\{|['"`][^'"`]*['"`]\s*\+\s*[a-zA-Z_$]|\b[a-zA-Z_$]\w*\s*\+\s*['"`]/;
+            const hasDynamicOutput = parsed.segments.some((s) => typeof s.selector === "string" && DYNAMIC_EXPR_RE.test(s.selector));
+            if (hasDynamicOutput) {
+                logger_1.logger.warn("[Sela] Static output violation — LLM returned dynamic expression in selector. Blocking.");
+                throw new Error("ENG_DYNAMIC_OUTPUT_BLOCKED: selector contains dynamic expression");
+            }
             parsed.new_selector =
                 parsed.new_selector ??
                     parsed.segments.map((s) => s.selector).join(" >> ");

package/dist/services/PRAutomationService.d.ts

@@ -1,6 +1,7 @@
 import type { ResolvedPRAutomation, PRStrategy, BugAction } from "../config/SelaConfig";
 import type { HealedEvent, ProtectedEvent } from "./HealReportService";
 import { type WorkspaceSnapshotService } from "./WorkspaceSnapshotService";
+import type { IVCSProvider } from "./vcs/VCSProvider";
 export interface BranchInfo {
     branch: string | null;
     isPR: boolean;
@@ -45,8 +46,12 @@ export interface ExecutionResult {
  */
 export declare function execute(cfg: ResolvedPRAutomation, decision: StrategyDecision, heals: HealedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext, 
 /** Injectable for tests - defaults to the module singleton. */
-workspace?: WorkspaceSnapshotService): Promise<ExecutionResult>;
-export declare function handleBugDetected(action: BugAction, events: ProtectedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext): Promise<void>;
+workspace?: WorkspaceSnapshotService, 
+/** Injectable for tests - defaults to auto-detected platform provider. */
+provider?: IVCSProvider): Promise<ExecutionResult>;
+export declare function handleBugDetected(action: BugAction, events: ProtectedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext, 
+/** Injectable for tests - defaults to auto-detected platform provider. */
+provider?: IVCSProvider): Promise<void>;
 export interface CentralizedGitFlowOpts {
     cwd: string;
     healedEvents: HealedEvent[];

package/dist/services/PRAutomationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PRAutomationService.d.ts","sourceRoot":"","sources":["../../src/services/PRAutomationService.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,SAAS,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAAC;IAC9E;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAiFD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,UAAU,CA+EpE;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,WAAW,EAAE,GACnB,gBAAgB,CAgElB;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEzC;AA6FD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc;AACnB,+DAA+D;AAC/D,SAAS,GAAE,wBAAkD,GAC5D,OAAO,CAAC,eAAe,CAAC,CAkG1B;AAsTD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAgGf;AAMD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgDf"}
+{"version":3,"file":"PRAutomationService.d.ts","sourceRoot":"","sources":["../../src/services/PRAutomationService.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,SAAS,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQvE,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAAC;IAC9E;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAyDD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,UAAU,CAyFpE;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,WAAW,EAAE,GACnB,gBAAgB,CAgElB;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEzC;AA6FD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc;AACnB,+DAA+D;AAC/D,SAAS,GAAE,wBAAkD;AAC7D,0EAA0E;AAC1E,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,eAAe,CAAC,CAwG1B;AAgWD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc;AACnB,0EAA0E;AAC1E,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,IAAI,CAAC,CAwFf;AAMD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgDf"}