@mozole/cli 1.4.3 → 2.0.0-b

package/dist/commands/verify.js

@@ -1,75 +1,158 @@
-import { findProjectRoot, readConfig } from "../config/project.js";
-import { projectFingerprint } from "../governor/fingerprint.js";
-import { readGovernorState, writeGovernorState } from "../governor/state.js";
-import { TaskProgress } from "../progress.js";
-import { updateTelemetry } from "../telemetry/store.js";
-import { runVerification } from "../verify/runner.js";
-export async function verifyCommand(cwd, output = console, options = {}) {
-    const progress = new TaskProgress({
-        total: 5,
-        title: "Verify",
-        verbose: options.verbose,
-        output,
-        onUpdate: options.onProgress,
-    });
-    const controller = new AbortController();
-    const abort = () => controller.abort();
-    process.once("SIGINT", abort);
-    process.once("SIGTERM", abort);
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import pc from "picocolors";
+import { scanProjectForAiTraces } from "../utils/ai-trace.js";
+import { findProjectRoot } from "../utils/fs.js";
+import { run } from "../utils/process.js";
+import { testCommand } from "./test.js";
+export async function verifyCommand(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const projectRoot = (await findProjectRoot(cwd)) ?? cwd;
+    console.log(pc.cyan(`\n🛡️  Running Mozole Deterministic Verification in ${pc.bold(projectRoot)}`));
+    console.log(pc.gray("═".repeat(65)));
+    const stages = [];
+    // Stage 1: Synthetic Trace Scanner
+    console.log(pc.bold("\n1. Scanning for synthetic attribution markers and bot trailers..."));
     try {
-        progress.step("Preparing verification");
-        const root = await findProjectRoot(cwd);
-        const config = await readConfig(root);
-        const fingerprint = config.governor?.enabled
-            ? await projectFingerprint(root, config, "verification")
-            : "";
-        const state = config.governor?.enabled
-            ? await readGovernorState(root)
-            : undefined;
-        if (config.governor?.enabled &&
-            !options.force &&
-            state?.verification?.fingerprint === fingerprint) {
-            progress.done();
-            const message = "VERIFY CURRENT\n\nNo relevant changes since the last successful verification." +
-                (config.mode === "scaffold"
-                    ? "\n\nSCAFFOLD MODE\nCCE, governor, telemetry, and agent instructions are intentionally absent."
-                    : "");
-            output.log(message);
-            if (config.telemetry?.enabled)
-                await updateTelemetry(root, (telemetry) => {
-                    telemetry.verification.avoidedRuns++;
-                    telemetry.governor.modelFacingDiagnosticChars += message.length;
-                });
-            return 0;
+        const traces = await scanProjectForAiTraces(projectRoot);
+        if (traces.length > 0) {
+            stages.push({
+                name: "Synthetic Trace Scanner",
+                success: false,
+                message: `Detected ${traces.length} synthetic attribution marker(s).`,
+                evidence: traces.map((t) => `  ${t.file}:${t.line} -> "${t.match}"`).join("\n"),
+            });
+            console.log(pc.red("  ✗ Prohibited synthetic markers found:"));
+            for (const t of traces) {
+                console.log(pc.red(`    - ${t.file}:${t.line} (${t.match})`));
+            }
         }
-        const result = await runVerification(root, config, controller.signal, (checkName, idx, total) => {
-            progress.update(idx, `Running check: ${checkName}`);
-            progress.logVerbose(`Running ${checkName} (${idx}/${total})`);
+        else {
+            stages.push({ name: "Synthetic Trace Scanner", success: true });
+            console.log(pc.green("  ✓ Zero synthetic traces or bot trailers detected."));
+        }
+    }
+    catch (err) {
+        stages.push({
+            name: "Synthetic Trace Scanner",
+            success: false,
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+    // Stage 2: Biome Lint & Format Check
+    console.log(pc.bold("\n2. Running Biome linter and formatter..."));
+    try {
+        const biomeRes = await run(process.execPath, [path.join(projectRoot, "node_modules/@biomejs/biome/bin/biome"), "check", "src"], { cwd: projectRoot });
+        if (biomeRes.exitCode === 0) {
+            stages.push({ name: "Biome Code Standards", success: true });
+            console.log(pc.green("  ✓ Biome lint and formatting clean."));
+        }
+        else {
+            stages.push({
+                name: "Biome Code Standards",
+                success: false,
+                evidence: biomeRes.stderr + biomeRes.stdout,
+            });
+            console.log(pc.red("  ✗ Biome reported lint or formatting violations."));
+        }
+    }
+    catch (err) {
+        // Environmental check
+        stages.push({
+            name: "Biome Code Standards",
+            success: false,
+            message: `Biome execution failed: ${err instanceof Error ? err.message : String(err)}`,
         });
-        progress.done();
-        (result.passed ? output.log : output.error)(result.output);
-        if (state && result.passed) {
-            state.verification = {
-                fingerprint: await projectFingerprint(root, config, "verification"),
-                passedAt: new Date().toISOString(),
-                checks: result.results.map((check) => check.name),
-            };
-            await writeGovernorState(root, state);
+    }
+    // Stage 3: TypeScript Compilation & Typecheck
+    console.log(pc.bold("\n3. Running TypeScript typecheck..."));
+    try {
+        const pkg = JSON.parse(await readFile(path.join(projectRoot, "package.json"), "utf8"));
+        const tscRes = pkg.scripts?.typecheck
+            ? await run("npm", ["run", "typecheck"], { cwd: projectRoot })
+            : await run(process.execPath, [path.join(projectRoot, "node_modules/typescript/bin/tsc"), "--noEmit"], { cwd: projectRoot });
+        if (tscRes.exitCode === 0) {
+            stages.push({ name: "TypeScript Typecheck", success: true });
+            console.log(pc.green("  ✓ TypeScript compiled with zero type errors."));
         }
-        else if (state && state.verification?.fingerprint === fingerprint) {
-            delete state.verification;
-            await writeGovernorState(root, state);
+        else {
+            stages.push({
+                name: "TypeScript Typecheck",
+                success: false,
+                evidence: tscRes.stderr + tscRes.stdout,
+            });
+            console.log(pc.red("  ✗ TypeScript compilation reported type errors."));
         }
-        return result.passed ? 0 : 1;
     }
-    catch (error) {
-        progress.done();
-        output.error(`VERIFY FAIL\n\n${error instanceof Error ? error.message : String(error)}`);
-        return controller.signal.aborted ? 130 : 2;
+    catch (err) {
+        stages.push({
+            name: "TypeScript Typecheck",
+            success: false,
+            message: `TypeScript execution failed: ${err instanceof Error ? err.message : String(err)}`,
+        });
     }
-    finally {
-        process.removeListener("SIGINT", abort);
-        process.removeListener("SIGTERM", abort);
+    if (!options.skipBuild) {
+        console.log(pc.bold("\n4. Building production output..."));
+        try {
+            const build = await run("npm", ["run", "build"], { cwd: projectRoot });
+            stages.push({
+                name: "Production Build",
+                success: build.exitCode === 0,
+                evidence: build.stdout + build.stderr,
+            });
+        }
+        catch (error) {
+            stages.push({ name: "Production Build", success: false, message: String(error) });
+        }
+    }
+    console.log(pc.bold("\n5. Running Mozole Design Contract & A11y Audit..."));
+    try {
+        await testCommand({ cwd: projectRoot, type: "all" });
+        stages.push({ name: "Design Contract & A11y Audit", success: true });
+    }
+    catch (err) {
+        stages.push({
+            name: "Design Contract & A11y Audit",
+            success: false,
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+    // Stage 6: Live Headless DOM Geometry & Trace Probe (if requested)
+    if (options.withProbe) {
+        console.log(pc.bold("\n6. Running Live Headless DOM Geometry & Trace Probe..."));
+        try {
+            await testCommand({ cwd: projectRoot, type: "probe" });
+            stages.push({ name: "Live DOM Geometry Probe", success: true });
+        }
+        catch (err) {
+            stages.push({
+                name: "Live DOM Geometry Probe",
+                success: false,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Summary Report
+    console.log(pc.gray(`\n${"═".repeat(65)}`));
+    const failedStages = stages.filter((s) => !s.success);
+    const allPassed = failedStages.length === 0;
+    if (allPassed) {
+        console.log(pc.green(pc.bold("\n🎉 All Mozole verification checks PASSED! Ready for deployment/commit.\n")));
+    }
+    else {
+        console.log(pc.red(pc.bold(`\n❌ Verification FAILED (${failedStages.length}/${stages.length} stages failed):\n`)));
+        for (const f of failedStages) {
+            console.log(pc.red(`  ✗ Stage: ${f.name}`));
+            if (f.message)
+                console.log(pc.red(`    Message: ${f.message}`));
+            if (f.evidence) {
+                console.log(pc.dim("    Evidence:"));
+                const sample = f.evidence.split("\n").slice(0, 10).join("\n");
+                console.log(pc.dim(sample));
+            }
+        }
+        console.log();
     }
+    return allPassed;
 }
 //# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,MAAM,GAAW,OAAO,EACxB,OAAO,GAIH,EAAE;IAEN,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC;QAChC,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM;QACN,QAAQ,EAAE,OAAO,CAAC,UAAU;KAC7B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO;YAC1C,CAAC,CAAC,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC;YACxD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO;YACpC,CAAC,CAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC;YAC/B,CAAC,CAAC,SAAS,CAAC;QACd,IACE,MAAM,CAAC,QAAQ,EAAE,OAAO;YACxB,CAAC,OAAO,CAAC,KAAK;YACd,KAAK,EAAE,YAAY,EAAE,WAAW,KAAK,WAAW,EAChD,CAAC;YACD,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,OAAO,GACX,+EAA+E;gBAC/E,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;oBACzB,CAAC,CAAC,+FAA+F;oBACjG,CAAC,CAAC,EAAE,CAAC,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO;gBAC3B,MAAM,eAAe,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxC,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;oBACrC,SAAS,CAAC,QAAQ,CAAC,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;gBAClE,CAAC,CAAC,CAAC;YACL,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,IAAI,EACJ,MAAM,EACN,UAAU,CAAC,MAAM,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACxB,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,kBAAkB,SAAS,EAAE,CAAC,CAAC;YACpD,QAAQ,CAAC,UAAU,CAAC,WAAW,SAAS,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC;QAChE,CAAC,CACF,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,YAAY,GAAG;gBACnB,WAAW,EAAE,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC;gBACnE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAClD,CAAC;YACF,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,KAAK,IAAI,KAAK,CAAC,YAAY,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC,YAAY,CAAC;YAC1B,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CACV,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3E,CAAC;QACF,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"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"}

package/dist/qa/a11y.d.ts

@@ -0,0 +1,24 @@
+export type A11ySeverity = "error" | "warn";
+export interface A11yFinding {
+    file: string;
+    line: number;
+    rule: string;
+    severity: A11ySeverity;
+    element: string;
+    message: string;
+}
+export interface A11yAuditResult {
+    errors: A11yFinding[];
+    warnings: A11yFinding[];
+    totalIssues: number;
+}
+export interface HtmlSource {
+    file: string;
+    html: string;
+}
+/**
+ * Static accessibility and semantic landmark audit.
+ * Enforces WCAG 2.1 AA landmark hierarchy, keyboard landmarks, and accessible forms.
+ */
+export declare function auditHtmlA11y(sources: HtmlSource[]): A11yAuditResult;
+//# sourceMappingURL=a11y.d.ts.map

package/dist/qa/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/qa/a11y.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe,CA+KpE"}

package/dist/qa/a11y.js

@@ -0,0 +1,124 @@
+function lineOf(source, index) {
+    return source.slice(0, index).split("\n").length;
+}
+function isDecorativeImage(tag) {
+    return /\balt\s*=\s*["']\s*["']/i.test(tag) || /\baria-hidden\s*=\s*["']true["']/i.test(tag);
+}
+/**
+ * Static accessibility and semantic landmark audit.
+ * Enforces WCAG 2.1 AA landmark hierarchy, keyboard landmarks, and accessible forms.
+ */
+export function auditHtmlA11y(sources) {
+    const errors = [];
+    const warnings = [];
+    for (const { file, html: source } of sources) {
+        // Ignore inert markup in comments and raw-text elements while preserving line numbers.
+        const html = source.replace(/<!--[\s\S]*?-->|<(script|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, (match) => match.replace(/[^\n]/g, " "));
+        const addError = (rule, element, message, line = 1) => {
+            errors.push({ file, line, rule, severity: "error", element, message });
+        };
+        const addWarn = (rule, element, message, line = 1) => {
+            warnings.push({ file, line, rule, severity: "warn", element, message });
+        };
+        // 1. html lang attribute (for full pages)
+        if (/<html\b/i.test(html)) {
+            if (!/<html\s[^>]*\blang\s*=\s*["'][a-z]{2}(?:-[A-Za-z]{2,4})?["']/i.test(html)) {
+                addError("html-lang", "<html>", "Missing or invalid lang attribute on <html> element.");
+            }
+        }
+        // 2. Headings & Landmarks (exempt empty SPA root shells)
+        const isSpaShell = /<div\s+id=["']root["']\s*>\s*<\/div>/i.test(html);
+        const h1s = Array.from(html.matchAll(/<h1\b[^>]*>/gi));
+        if (/<body\b|<main\b/i.test(html) && !isSpaShell) {
+            if (h1s.length === 0) {
+                addError("single-h1", "<h1>", "Page missing top-level <h1> landmark heading.");
+            }
+            else if (h1s.length > 1) {
+                addError("single-h1", "<h1>", `Page contains ${h1s.length} <h1> headings; exactly one landmark heading expected.`, lineOf(html, h1s[1].index ?? 0));
+            }
+        }
+        // 3. Main landmark
+        const mains = Array.from(html.matchAll(/<main\b[^>]*>/gi));
+        if (/<body\b/i.test(html) && !isSpaShell) {
+            if (mains.length === 0) {
+                addError("main-landmark", "<main>", "Page missing <main> primary content landmark.");
+            }
+            else if (mains.length > 1) {
+                addError("main-landmark", "<main>", `Page contains ${mains.length} <main> landmarks; exactly one expected.`, lineOf(html, mains[1].index ?? 0));
+            }
+            // 4. Skip-to-content link
+            const mainMatch = mains[0]?.[0];
+            const mainId = mainMatch?.match(/\bid\s*=\s*["']([^"']+)["']/i)?.[1];
+            const skipLinkMatch = Array.from(html.matchAll(/<a\b[^>]*>/gi)).find((match) => /\sclass\s*=\s*["'][^"']*\bskip-link\b[^"']*["']/i.test(match[0]));
+            if (mains.length === 1 && !skipLinkMatch) {
+                addWarn("skip-link", "<a class='skip-link'>", "Page lacks an accessible skip-to-content keyboard link before primary navigation.");
+            }
+            else if (skipLinkMatch && mainId) {
+                const skipHref = skipLinkMatch[0].match(/\shref\s*=\s*["']#([^"']+)["']/i)?.[1];
+                if (skipHref !== mainId) {
+                    addError("skip-link-target", "<a class='skip-link'>", `Skip link target '#${skipHref}' does not match <main> ID '#${mainId}'.`);
+                }
+            }
+        }
+        // 5. Unique IDs
+        const idMatches = Array.from(html.matchAll(/<[^>]+>/g)).flatMap((tag) => Array.from(tag[0].matchAll(/\sid\s*=\s*["']([^"']+)["']/gi)));
+        const seenIds = new Set();
+        const dupIds = new Set();
+        for (const match of idMatches) {
+            const id = match[1];
+            if (seenIds.has(id)) {
+                dupIds.add(id);
+            }
+            seenIds.add(id);
+        }
+        for (const dup of dupIds) {
+            addError("unique-id", `#${dup}`, `Duplicate element ID '#${dup}' violates DOM uniqueness and a11y label associations.`);
+        }
+        // 6. Image alt text
+        const imgMatches = Array.from(html.matchAll(/<img\b[^>]*>/gi));
+        for (const match of imgMatches) {
+            const tag = match[0];
+            const line = lineOf(html, match.index ?? 0);
+            if (!/\balt\s*=/i.test(tag)) {
+                addError("img-alt", tag.slice(0, 60), "Image missing alt attribute. Provide descriptive alt text or empty alt='' for decorative graphics.", line);
+            }
+            else if (!isDecorativeImage(tag)) {
+                const altText = tag.match(/\balt\s*=\s*["']([^"']*)["']/i)?.[1] ?? "";
+                if (/^(?:image|photo|picture|görsel|resim|fotoğraf)$/i.test(altText.trim())) {
+                    addWarn("img-alt-quality", tag.slice(0, 60), `Uninformative alt text '${altText}'. Describe the image content or set alt='' if decorative.`, line);
+                }
+            }
+        }
+        // 7. Button type attribute
+        const buttonMatches = Array.from(html.matchAll(/<button\b[^>]*>/gi));
+        for (const match of buttonMatches) {
+            const tag = match[0];
+            const line = lineOf(html, match.index ?? 0);
+            if (!/\btype\s*=\s*["'](?:button|submit|reset)["']/i.test(tag)) {
+                addWarn("button-type", tag.slice(0, 60), "Button missing explicit type attribute ('button', 'submit', or 'reset'). Default is submit.", line);
+            }
+        }
+        // 8. New tab links target='_blank' rel='noopener'
+        const blankLinks = Array.from(html.matchAll(/<a\b[^>]*\btarget\s*=\s*["']_blank["'][^>]*>/gi));
+        for (const match of blankLinks) {
+            const tag = match[0];
+            const line = lineOf(html, match.index ?? 0);
+            if (!/\brel\s*=\s*["'][^"']*\b(?:noopener|noreferrer)\b[^"']*["']/i.test(tag)) {
+                addError("link-rel-noopener", tag.slice(0, 60), "Target='_blank' link missing rel='noopener' or rel='noreferrer'.", line);
+            }
+        }
+        // 9. Inline styles ban (enforcing atomic primitives)
+        const inlineStyles = Array.from(html.matchAll(/\bstyle\s*=\s*["'][^"']*["']/gi));
+        for (const match of inlineStyles) {
+            const tag = match[0];
+            const line = lineOf(html, match.index ?? 0);
+            addError("no-inline-style", tag.slice(0, 60), "Inline style attribute bypasses design token system and atomic primitives.", line);
+        }
+    }
+    return {
+        errors,
+        warnings,
+        totalIssues: errors.length + warnings.length,
+    };
+}
+//# sourceMappingURL=a11y.js.map

package/dist/qa/a11y.js.map

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

package/dist/qa/breakpoints.d.ts

@@ -0,0 +1,16 @@
+export interface ViewportDefinition {
+    name: string;
+    width: number;
+    height: number;
+}
+export declare const STANDARD_VIEWPORTS: ViewportDefinition[];
+/**
+ * Extracts breakpoint boundary widths from CSS sources.
+ * For every detected min-width or max-width query, generates width - 1, width, and width + 1,
+ * ensuring boundary conditions never cause accidental horizontal overflow or control collisions.
+ */
+export declare function extractBreakpointBoundaries(cssSources: string[], options?: {
+    minWidth?: number;
+    maxWidth?: number;
+}): number[];
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/qa/breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","sourceRoot":"","sources":["../../src/qa/breakpoints.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,EASlD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,EAAE,CAmCV"}

package/dist/qa/breakpoints.js

@@ -0,0 +1,45 @@
+import postcss from "postcss";
+export const STANDARD_VIEWPORTS = [
+    { name: "mobile-min", width: 320, height: 800 },
+    { name: "mobile-small", width: 375, height: 812 },
+    { name: "mobile-standard", width: 390, height: 844 },
+    { name: "tablet-portrait", width: 768, height: 1024 },
+    { name: "tablet-landscape", width: 1024, height: 768 },
+    { name: "desktop-compact", width: 1280, height: 800 },
+    { name: "desktop-standard", width: 1440, height: 900 },
+    { name: "desktop-wide", width: 1920, height: 1080 },
+];
+/**
+ * Extracts breakpoint boundary widths from CSS sources.
+ * For every detected min-width or max-width query, generates width - 1, width, and width + 1,
+ * ensuring boundary conditions never cause accidental horizontal overflow or control collisions.
+ */
+export function extractBreakpointBoundaries(cssSources, options) {
+    const min = options?.minWidth ?? 320;
+    const max = options?.maxWidth ?? 2560;
+    const boundaries = new Set(STANDARD_VIEWPORTS.map((viewport) => viewport.width).filter((width) => width >= min && width <= max));
+    for (const css of cssSources) {
+        try {
+            const root = postcss.parse(css);
+            root.walkAtRules("media", (rule) => {
+                const matches = rule.params.matchAll(/(?:(?:min|max)-width\s*:|\bwidth\s*(?:<=?|>=?|=))\s*(\d+(?:\.\d+)?)(px|rem|em)\b|(\d+(?:\.\d+)?)(px|rem|em)\s*(?:<=?|>=?)\s*(?=width\b)/gi);
+                for (const match of matches) {
+                    const rawVal = Number.parseFloat(match[1] ?? match[3]);
+                    const unit = (match[2] ?? match[4]).toLowerCase();
+                    const point = Math.round(rawVal * (unit === "px" ? 1 : 16));
+                    for (const delta of [-1, 0, 1]) {
+                        const candidate = point + delta;
+                        if (candidate >= min && candidate <= max) {
+                            boundaries.add(candidate);
+                        }
+                    }
+                }
+            });
+        }
+        catch {
+            // Ignore unparseable CSS chunks
+        }
+    }
+    return Array.from(boundaries).sort((a, b) => a - b);
+}
+//# sourceMappingURL=breakpoints.js.map

package/dist/qa/breakpoints.js.map

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

package/dist/qa/contract.d.ts

@@ -0,0 +1,21 @@
+export type FindingSeverity = "error" | "warn";
+export interface ContractFinding {
+    file: string;
+    line: number;
+    selector: string;
+    rule: string;
+    severity: FindingSeverity;
+    value: string;
+    message: string;
+}
+export interface ContractAuditResult {
+    errors: ContractFinding[];
+    warnings: ContractFinding[];
+    totalViolations: number;
+}
+export interface CssSource {
+    file: string;
+    css: string;
+}
+export declare function auditCssContracts(sources: CssSource[]): ContractAuditResult;
+//# sourceMappingURL=contract.d.ts.map

package/dist/qa/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/qa/contract.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,mBAAmB,CA2J3E"}