code-auditor-mcp 5.0.2 → 5.3.3

package/dist/mcpDiagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcpDiagnostics.js","sourceRoot":"","sources":["../src/mcpDiagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcpDiagnostics.js","sourceRoot":"","sources":["../src/mcpDiagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG;IACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AAE5C,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG;IACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG;IACrC,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;AAE3C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;AAC9D,IAAI,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;AAElD,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,WAAW;QAAE,OAAO;IACzB,+EAA+E;IAC/E,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,IAAI,GAAG,UAAU,CAAC;IACxB,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;QACvB,MAAM,IAAI,CAAC;QACX,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,KAAgC,EAChC,KAAa,EACb,OAAe,EACf,MAAgC;IAEhC,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,YAAY;QAAE,OAAO;IAC/C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzG,MAAM,IAAI,GAAG,IAAI,EAAE,UAAU,GAAG,qBAAqB,KAAK,MAAM,KAAK,KAAK,OAAO,GAAG,KAAK,EAAE,CAAC;IAC5F,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;SAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,0EAA0E;QAC1E,yEAAyE;QACzE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,cAAc,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAe,EAAE,MAAgC;IACzF,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe,EAAE,MAAgC;IAC1F,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,IAAe;IAC/C,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,IAAe;IAC/C,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/phase/candidates.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Directive H item 2 — the candidate-emission artifact writer.
+ *
+ * The migrated rules select candidate sites through `ctx.emitCandidate` and
+ * the runner carries them out on `result.metadata.candidates`. This module
+ * serializes them to the diagnostic artifact that the services/ audit route
+ * consumes: per rule, its disposition vocabulary (keys + descriptions read
+ * straight from the rule's `dispositions`, never a literal list here) and its
+ * candidate sites, each enriched with the source line text at the site's span.
+ *
+ * The source line is read here — from the CLI's local filesystem — because the
+ * consumer (the services/ Worker) is remote and cannot read the audited tree.
+ * Nothing in this module (or anywhere under `app/`) reaches a model: it only
+ * writes the deterministic pre-classification record.
+ */
+import type { AuditResult } from '../types.js';
+export interface CandidatesArtifactSite {
+    file: string;
+    span: {
+        line: number;
+        column?: number;
+    };
+    disposition: string;
+    /** The source line text at `span.line`, read from the audited file so the
+     *  remote audit route has the site's source without filesystem access. */
+    source: string;
+}
+export interface CandidatesArtifactRule {
+    ruleId: string;
+    /** The rule's disposition vocabulary, copied from the rule's own
+     *  `dispositions` — the audit builds its choice `criteria` keys from these. */
+    dispositions: Array<{
+        key: string;
+        description: string;
+    }>;
+    sites: CandidatesArtifactSite[];
+}
+export interface CandidatesArtifact {
+    schemaVersion: 1;
+    generatedAt: string;
+    rules: CandidatesArtifactRule[];
+}
+/**
+ * Build the candidates artifact from an audit result. Rules that declared
+ * `dispositions` but emitted no candidate sites are omitted (the artifact only
+ * carries sites the audit will sample). Candidate sites are grouped by rule id;
+ * ordering follows first-emission order.
+ *
+ * @param result - The completed audit result carrying `metadata.candidates`.
+ * @returns The serializable candidates artifact (schema version 1).
+ */
+export declare function buildCandidatesArtifact(result: AuditResult): Promise<CandidatesArtifact>;
+//# sourceMappingURL=candidates.d.ts.map

package/dist/phase/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../src/phase/candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB;8EAC0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;mFAC+E;IAC/E,YAAY,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAYD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAgC7B"}

package/dist/phase/candidates.js

@@ -0,0 +1,67 @@
+/**
+ * Directive H item 2 — the candidate-emission artifact writer.
+ *
+ * The migrated rules select candidate sites through `ctx.emitCandidate` and
+ * the runner carries them out on `result.metadata.candidates`. This module
+ * serializes them to the diagnostic artifact that the services/ audit route
+ * consumes: per rule, its disposition vocabulary (keys + descriptions read
+ * straight from the rule's `dispositions`, never a literal list here) and its
+ * candidate sites, each enriched with the source line text at the site's span.
+ *
+ * The source line is read here — from the CLI's local filesystem — because the
+ * consumer (the services/ Worker) is remote and cannot read the audited tree.
+ * Nothing in this module (or anywhere under `app/`) reaches a model: it only
+ * writes the deterministic pre-classification record.
+ */
+import { promises as fs } from 'fs';
+import { MIGRATED_RULES } from './rules/registry.js';
+async function readSourceLine(file, line) {
+    if (!Number.isInteger(line) || line < 1)
+        return '';
+    try {
+        const content = await fs.readFile(file, 'utf8');
+        return content.split('\n')[line - 1] ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Build the candidates artifact from an audit result. Rules that declared
+ * `dispositions` but emitted no candidate sites are omitted (the artifact only
+ * carries sites the audit will sample). Candidate sites are grouped by rule id;
+ * ordering follows first-emission order.
+ *
+ * @param result - The completed audit result carrying `metadata.candidates`.
+ * @returns The serializable candidates artifact (schema version 1).
+ */
+export async function buildCandidatesArtifact(result) {
+    const candidates = result.metadata.candidates ?? [];
+    const dispositionsByRule = new Map();
+    for (const rule of MIGRATED_RULES) {
+        if (rule.dispositions)
+            dispositionsByRule.set(rule.id, rule.dispositions);
+    }
+    const sitesByRule = new Map();
+    for (const c of candidates) {
+        const list = sitesByRule.get(c.ruleId) ?? [];
+        list.push(c);
+        sitesByRule.set(c.ruleId, list);
+    }
+    const rules = [];
+    for (const [ruleId, sites] of sitesByRule) {
+        const dispositions = dispositionsByRule.get(ruleId) ?? [];
+        rules.push({
+            ruleId,
+            dispositions: dispositions.map((d) => ({ key: d.key, description: d.description })),
+            sites: await Promise.all(sites.map(async (s) => ({
+                file: s.file,
+                span: s.span,
+                disposition: s.disposition,
+                source: await readSourceLine(s.file, s.span.line),
+            }))),
+        });
+    }
+    return { schemaVersion: 1, generatedAt: new Date().toISOString(), rules };
+}
+//# sourceMappingURL=candidates.js.map

package/dist/phase/candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../src/phase/candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA2BrD,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAmB;IAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkC,CAAC;IACrE,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,YAAY;YAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5E,CAAC;IAGD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC;YACT,MAAM;YACN,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACnF,KAAK,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,MAAM,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aAClD,CAAC,CAAC,CAAC;SACL,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;AAC5E,CAAC"}

package/dist/phase/colorMath.d.ts

@@ -8,12 +8,13 @@
  * pure, threshold-independent derivation from the raw declaration value, exactly
  * the "one level up from raw source text" computation a processor should own.
  *
- * These three functions are the conversion (`parseColorToRGB`, `rgbToLab`) plus
- * the ΔE76 distance over Lab (`labDistance`). The `color-values` corpus producer
+ * These four functions are the conversion (`parseColorToRGB`, `rgbToLab`) plus
+ * two colour-difference metrics over Lab: `labDistance` (CIE76, ΔE76) and
+ * `ciede2000` (CIE DE2000, ΔE00). The `color-values` corpus producer
  * (`producers.ts`) imports the conversion and stores the Lab triple in the fact;
- * the rule imports only `labDistance` — the comparison metric its clustering and
- * flagging decisions use — so it reads pre-computed Lab and never re-parses a
- * color. The rule decides; the processor computes.
+ * the rule imports only the distance it clusters with — the comparison metric its
+ * clustering and flagging decisions use — so it reads pre-computed Lab and never
+ * re-parses a color. The rule decides; the processor computes.
  */
 /** A CIELAB Lab triple (L, a, b), D65 reference white. */
 export type Lab = [number, number, number];
@@ -38,4 +39,16 @@ export declare function parseColorToRGB(raw: string): RGB | null;
  * @returns The ΔE76 color distance.
  */
 export declare function labDistance(a: Lab, b: Lab): number;
+/** ΔE00 — the CIEDE2000 color-difference between two Lab triples.
+ *
+ * The Sharma/Wu/Dalal (2005) formulation. CIEDE2000 corrects the two known
+ * CIE76 (ΔE76) failures — it is more perceptually uniform in the blue/saturated
+ * regions and handles chroma/hue asymmetries the plain Euclidean distance
+ * mis-ranks — at the cost of a nonlinear, hue- and chroma-weighted term.
+ *
+ * @param a The first Lab triple.
+ * @param b The second Lab triple.
+ * @returns The CIEDE2000 color distance (ΔE00).
+ */
+export declare function ciede2000(a: Lab, b: Lab): number;
 //# sourceMappingURL=colorMath.d.ts.map

package/dist/phase/colorMath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colorMath.d.ts","sourceRoot":"","sources":["../../src/phase/colorMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,+CAA+C;AAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAM3C;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAyB5C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CA6CvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAKlD"}
+{"version":3,"file":"colorMath.d.ts","sourceRoot":"","sources":["../../src/phase/colorMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,+CAA+C;AAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAM3C;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAyB5C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CA6CvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAKlD;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAyEhD"}

package/dist/phase/colorMath.js

@@ -8,12 +8,13 @@
  * pure, threshold-independent derivation from the raw declaration value, exactly
  * the "one level up from raw source text" computation a processor should own.
  *
- * These three functions are the conversion (`parseColorToRGB`, `rgbToLab`) plus
- * the ΔE76 distance over Lab (`labDistance`). The `color-values` corpus producer
+ * These four functions are the conversion (`parseColorToRGB`, `rgbToLab`) plus
+ * two colour-difference metrics over Lab: `labDistance` (CIE76, ΔE76) and
+ * `ciede2000` (CIE DE2000, ΔE00). The `color-values` corpus producer
  * (`producers.ts`) imports the conversion and stores the Lab triple in the fact;
- * the rule imports only `labDistance` — the comparison metric its clustering and
- * flagging decisions use — so it reads pre-computed Lab and never re-parses a
- * color. The rule decides; the processor computes.
+ * the rule imports only the distance it clusters with — the comparison metric its
+ * clustering and flagging decisions use — so it reads pre-computed Lab and never
+ * re-parses a color. The rule decides; the processor computes.
  */
 const COLOR_KEYWORDS = new Set([
     'transparent', 'currentcolor', 'inherit', 'initial', 'unset', 'none',
@@ -106,4 +107,86 @@ export function labDistance(a, b) {
     const db = a[2] - b[2];
     return Math.sqrt(dl * dl + da * da + db * db);
 }
+const DEG2RAD = Math.PI / 180;
+/** CIELAB hue angle in degrees, in [0, 360), from an (a*, b*) pair. */
+function hueAngle(ap, b) {
+    if (ap === 0 && b === 0)
+        return 0;
+    const h = Math.atan2(b, ap) / DEG2RAD;
+    return h < 0 ? h + 360 : h;
+}
+/** ΔE00 — the CIEDE2000 color-difference between two Lab triples.
+ *
+ * The Sharma/Wu/Dalal (2005) formulation. CIEDE2000 corrects the two known
+ * CIE76 (ΔE76) failures — it is more perceptually uniform in the blue/saturated
+ * regions and handles chroma/hue asymmetries the plain Euclidean distance
+ * mis-ranks — at the cost of a nonlinear, hue- and chroma-weighted term.
+ *
+ * @param a The first Lab triple.
+ * @param b The second Lab triple.
+ * @returns The CIEDE2000 color distance (ΔE00).
+ */
+export function ciede2000(a, b) {
+    const [L1, a1, b1] = a;
+    const [L2, a2, b2] = b;
+    const C1 = Math.sqrt(a1 * a1 + b1 * b1);
+    const C2 = Math.sqrt(a2 * a2 + b2 * b2);
+    const Cbar = (C1 + C2) / 2;
+    const Cbar7 = Cbar ** 7;
+    const G = 0.5 * (1 - Math.sqrt(Cbar7 / (Cbar7 + 25 ** 7)));
+    const a1p = a1 * (1 + G);
+    const a2p = a2 * (1 + G);
+    const C1p = Math.sqrt(a1p * a1p + b1 * b1);
+    const C2p = Math.sqrt(a2p * a2p + b2 * b2);
+    const h1p = hueAngle(a1p, b1);
+    const h2p = hueAngle(a2p, b2);
+    const dLp = L2 - L1;
+    const dCp = C2p - C1p;
+    let dhp;
+    if (C1p * C2p === 0) {
+        dhp = 0;
+    }
+    else if (Math.abs(h2p - h1p) <= 180) {
+        dhp = h2p - h1p;
+    }
+    else if (h2p - h1p > 180) {
+        dhp = h2p - h1p - 360;
+    }
+    else {
+        dhp = h2p - h1p + 360;
+    }
+    const dHp = 2 * Math.sqrt(C1p * C2p) * Math.sin((dhp / 2) * DEG2RAD);
+    const Lbarp = (L1 + L2) / 2;
+    const Cbarp = (C1p + C2p) / 2;
+    let hbarp;
+    if (C1p * C2p === 0) {
+        hbarp = h1p + h2p;
+    }
+    else if (Math.abs(h1p - h2p) <= 180) {
+        hbarp = (h1p + h2p) / 2;
+    }
+    else if (h1p + h2p < 360) {
+        hbarp = (h1p + h2p + 360) / 2;
+    }
+    else {
+        hbarp = (h1p + h2p - 360) / 2;
+    }
+    const T = 1
+        - 0.17 * Math.cos((hbarp - 30) * DEG2RAD)
+        + 0.24 * Math.cos((2 * hbarp) * DEG2RAD)
+        + 0.32 * Math.cos((3 * hbarp + 6) * DEG2RAD)
+        - 0.20 * Math.cos((4 * hbarp - 63) * DEG2RAD);
+    const dTheta = 30 * Math.exp(-(((hbarp - 275) / 25) ** 2));
+    const Cbarp7 = Cbarp ** 7;
+    const RC = 2 * Math.sqrt(Cbarp7 / (Cbarp7 + 25 ** 7));
+    const LbarpMinus50sq = (Lbarp - 50) * (Lbarp - 50);
+    const SL = 1 + (0.015 * LbarpMinus50sq) / Math.sqrt(20 + LbarpMinus50sq);
+    const SC = 1 + 0.045 * Cbarp;
+    const SH = 1 + 0.015 * Cbarp * T;
+    const RT = -Math.sin((2 * dTheta) * DEG2RAD) * RC;
+    const dLpSL = dLp / SL;
+    const dCpSC = dCp / SC;
+    const dHpSH = dHp / SH;
+    return Math.sqrt(dLpSL * dLpSL + dCpSC * dCpSC + dHpSH * dHpSH + RT * dCpSC * dHpSH);
+}
 //# sourceMappingURL=colorMath.js.map

package/dist/phase/colorMath.js.map

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

package/dist/phase/dataAccessCallsCandidates.js

@@ -22,6 +22,6 @@ import { extractDataAccessCallCandidates as extractAnalyzerCandidates } from '..
  *    producer dedups after re-folding admission)
  */
 export function extractDataAccessCallCandidates(file) {
-    return extractAnalyzerCandidates(file.ast, file.adapter, file.source);
+    return extractAnalyzerCandidates(file.ast, file.adapter, file.source, undefined, file.vendorSurfaces);
 }
 //# sourceMappingURL=dataAccessCallsCandidates.js.map

package/dist/phase/dataAccessCallsCandidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataAccessCallsCandidates.js","sourceRoot":"","sources":["../../src/phase/dataAccessCallsCandidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,+BAA+B,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAErI;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,OAAO,yBAAyB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"dataAccessCallsCandidates.js","sourceRoot":"","sources":["../../src/phase/dataAccessCallsCandidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,+BAA+B,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAErI;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,OAAO,yBAAyB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;AACxG,CAAC"}

package/dist/phase/goFunctionAnalysis.d.ts

@@ -2,8 +2,8 @@
  * Spec 68 §9 — the `error-bindings`, `concurrency-primitives` and
  * `channel-operations` producers.
  *
- * Re-homes the Go binary's non-SOLID function walks (`runErrorAnalysis`,
- * `runGoroutineAnalysis`, `runChannelAnalysis` in `analyzer-src/analyzer.go`) as
+ * Re-homes the former Go subprocess's non-SOLID function walks
+ * (`runErrorAnalysis`, `runGoroutineAnalysis`, `runChannelAnalysis`) as
  * plain-data facts. Each walks the tree-sitter Go AST for `function_declaration`
  * / `method_declaration` nodes and projects the inputs the rule's verdict reads:
  *

package/dist/phase/goFunctionAnalysis.js

@@ -2,8 +2,8 @@
  * Spec 68 §9 — the `error-bindings`, `concurrency-primitives` and
  * `channel-operations` producers.
  *
- * Re-homes the Go binary's non-SOLID function walks (`runErrorAnalysis`,
- * `runGoroutineAnalysis`, `runChannelAnalysis` in `analyzer-src/analyzer.go`) as
+ * Re-homes the former Go subprocess's non-SOLID function walks
+ * (`runErrorAnalysis`, `runGoroutineAnalysis`, `runChannelAnalysis`) as
  * plain-data facts. Each walks the tree-sitter Go AST for `function_declaration`
  * / `method_declaration` nodes and projects the inputs the rule's verdict reads:
  *

package/dist/phase/goFunctions.d.ts

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the `go-functions` producer.
  *
- * Re-homes the Go binary's function extraction (the `Function` payload in
- * `analyzer-src/parser.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's function extraction (the `Function`
+ * payload) as a plain-data fact. It walks the tree-sitter Go
  * AST for `function_declaration` / `method_declaration` nodes and projects the
  * metrics the two size/behaviour rules threshold on:
  *

package/dist/phase/goFunctions.js

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the `go-functions` producer.
  *
- * Re-homes the Go binary's function extraction (the `Function` payload in
- * `analyzer-src/parser.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's function extraction (the `Function`
+ * payload) as a plain-data fact. It walks the tree-sitter Go
  * AST for `function_declaration` / `method_declaration` nodes and projects the
  * metrics the two size/behaviour rules threshold on:
  *

package/dist/phase/goImports.d.ts

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the Go `imports` producer.
  *
- * Re-homes the Go binary's import extraction (`runImportAnalysis` in
- * `analyzer-src/analyzer.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's import extraction (`runImportAnalysis`) as
+ * a plain-data fact. It walks the tree-sitter Go
  * AST for `import_spec` nodes and projects each one's source path and local
  * name:
  *

package/dist/phase/goImports.js

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the Go `imports` producer.
  *
- * Re-homes the Go binary's import extraction (`runImportAnalysis` in
- * `analyzer-src/analyzer.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's import extraction (`runImportAnalysis`) as
+ * a plain-data fact. It walks the tree-sitter Go
  * AST for `import_spec` nodes and projects each one's source path and local
  * name:
  *

package/dist/phase/goSwitches.d.ts

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the `go-switches` producer.
  *
- * Re-homes the Go binary's switch-size extraction (the `analyzeSwitchSize` walk
- * in `analyzer-src/solid.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's switch-size extraction (the
+ * `analyzeSwitchSize` walk) as a plain-data fact. It walks the tree-sitter Go
  * AST for `expression_switch_statement` / `type_switch_statement` nodes and
  * projects each one's case-clause count:
  *

package/dist/phase/goSwitches.js

@@ -1,8 +1,8 @@
 /**
  * Spec 68 §9 — the `go-switches` producer.
  *
- * Re-homes the Go binary's switch-size extraction (the `analyzeSwitchSize` walk
- * in `analyzer-src/solid.go`) as a plain-data fact. It walks the tree-sitter Go
+ * Re-homes the former Go subprocess's switch-size extraction (the
+ * `analyzeSwitchSize` walk) as a plain-data fact. It walks the tree-sitter Go
  * AST for `expression_switch_statement` / `type_switch_statement` nodes and
  * projects each one's case-clause count:
  *

package/dist/phase/imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/phase/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,CAQ1D"}
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/phase/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,CAS1D"}

package/dist/phase/imports.js

@@ -20,6 +20,7 @@ export function extractImports(file) {
         source: imp.source,
         line: imp.location.start.line,
         column: imp.location.start.column,
+        isTypeOnly: imp.isTypeOnly,
     }));
 }
 //# sourceMappingURL=imports.js.map

package/dist/phase/imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/phase/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;QAC7B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/phase/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;QAC7B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM;QACjC,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/phase/loopQueryCandidates.js

@@ -23,6 +23,6 @@ import { extractLoopQueryRawCandidates as extractAnalyzerCandidates } from '../a
  *    the corpus producer re-folds both after re-folding the handle verdict)
  */
 export function extractLoopQueryRawCandidates(file) {
-    return extractAnalyzerCandidates(file.ast, file.adapter, file.source);
+    return extractAnalyzerCandidates(file.ast, file.adapter, file.source, undefined, file.vendorSurfaces);
 }
 //# sourceMappingURL=loopQueryCandidates.js.map

package/dist/phase/loopQueryCandidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"loopQueryCandidates.js","sourceRoot":"","sources":["../../src/phase/loopQueryCandidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,6BAA6B,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAEnI;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,OAAO,yBAAyB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"loopQueryCandidates.js","sourceRoot":"","sources":["../../src/phase/loopQueryCandidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,6BAA6B,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAEnI;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,OAAO,yBAAyB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;AACxG,CAAC"}

package/dist/phase/oracles.d.ts

@@ -145,7 +145,21 @@ export declare const countTypeDeclarations: (file: ParsedFile) => number;
  * @param file - The parsed file to count package-scope bindings for.
  * @returns The number of package-scope bindings `buildGoFileBindings` would emit. */
 export declare function countGoPackageBindings(file: ParsedFile): number;
+/**
+ * Upper-bound oracle: count ORM-builder (`pgTable`/`mysqlTable`/`sqliteTable`)
+ * call sites off the source text — a superset of the producer's emitted bindings.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of ORM-builder call sites.
+ */
 export declare function countSchemaObjects(file: ParsedFile): number;
+/**
+ * Upper-bound oracle: count DDL op-producing statement headers (CREATE/DROP TABLE
+ * and `ALTER TABLE … RENAME TO`) — a superset of the producer's emitted ops.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of DDL op headers.
+ */
 export declare function countDdlOps(file: ParsedFile): number;
 /** style-declarations (css/scss) — count `declaration` nodes off the CSS AST.
  *  An upper bound, not exact: the producer projects only declarations inside a
@@ -178,7 +192,21 @@ export declare const countDataAccessCalls: (file: ParsedFile) => number;
  *  whose body issues a DB call; this counts every loop. Residual = loops whose
  *  body holds no DB call. */
 export declare const countLoopQueries: (file: ParsedFile) => number;
+/**
+ * Upper-bound oracle: count `query(`/`execute(` call sites off the source text —
+ * a superset of the producer's dangerous-SQL candidates.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of dynamic-SQL call sites.
+ */
 export declare function countDynamicSql(file: ParsedFile): number;
+/**
+ * Upper-bound oracle: count member-call sites plus SQL keyword occurrences — two
+ * coarse supersets of the producer's located query-site scan.
+ *
+ * @param file The parsed file to count over.
+ * @returns The member-call count plus the SQL-keyword occurrence count.
+ */
 export declare function countQuerySites(file: ParsedFile): number;
 /** schema-usage — count `call_expression` + `string` + `template_string` nodes.
  *  Every table reference is carried in a string literal, a tagged template, or a

package/dist/phase/oracles.d.ts.map

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

package/dist/phase/oracles.js

@@ -334,6 +334,13 @@ export function countGoPackageBindings(file) {
  *  re-running the producer's own `ORM_OBJECT_RE` (which would prove 1 = 1 and
  *  measure nothing). */
 const ORM_BUILDER_CALL_RE = /\b(?:pgTable|mysqlTable|sqliteTable)\s*\(/g;
+/**
+ * Upper-bound oracle: count ORM-builder (`pgTable`/`mysqlTable`/`sqliteTable`)
+ * call sites off the source text — a superset of the producer's emitted bindings.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of ORM-builder call sites.
+ */
 export function countSchemaObjects(file) {
     return [...file.source.matchAll(ORM_BUILDER_CALL_RE)].length;
 }
@@ -350,6 +357,13 @@ export function countSchemaObjects(file) {
  *  table-rename form; `RENAME COLUMN` is a column change and is excluded by the
  *  same `RENAME TO` guard.) */
 const DDL_HEADER_RE = /\b(?:CREATE|DROP)\s+(?:VIRTUAL\s+)?TABLE\b|\bALTER\s+TABLE\b[^;]*?\bRENAME\s+TO\b/gi;
+/**
+ * Upper-bound oracle: count DDL op-producing statement headers (CREATE/DROP TABLE
+ * and `ALTER TABLE … RENAME TO`) — a superset of the producer's emitted ops.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of DDL op headers.
+ */
 export function countDdlOps(file) {
     return [...file.source.matchAll(DDL_HEADER_RE)].length;
 }
@@ -409,6 +423,13 @@ export const countLoopQueries = countNodeTypes([
  *  dangerous candidate is a `query(`/`execute(` call, so this upper-bounds the
  *  candidate count. Residual = safe/parameterized query/execute calls. */
 const DYNAMIC_SQL_CALL_RE = /\b(?:query|execute)\s*\(/g;
+/**
+ * Upper-bound oracle: count `query(`/`execute(` call sites off the source text —
+ * a superset of the producer's dangerous-SQL candidates.
+ *
+ * @param file The parsed file to count over.
+ * @returns The number of dynamic-SQL call sites.
+ */
 export function countDynamicSql(file) {
     return [...file.source.matchAll(DYNAMIC_SQL_CALL_RE)].length;
 }
@@ -420,6 +441,13 @@ export function countDynamicSql(file) {
  *  Residual = non-DB member calls + SQL keywords inside recognized call bodies
  *  (which the producer strips) + the DB-context gate the producer applies. */
 const ALL_MEMBER_CALLS_RE = /\.\w+\s*\(/g;
+/**
+ * Upper-bound oracle: count member-call sites plus SQL keyword occurrences — two
+ * coarse supersets of the producer's located query-site scan.
+ *
+ * @param file The parsed file to count over.
+ * @returns The member-call count plus the SQL-keyword occurrence count.
+ */
 export function countQuerySites(file) {
     const calls = (file.source.match(ALL_MEMBER_CALLS_RE) || []).length;
     return calls + countSqlKeywordOccurrences(file.source);