@decantr/cli 3.1.0 → 3.4.0

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-WSL6ZSTZ.js";
+import "./chunk-ZBGL7RID.js";
 import "./chunk-SIDKK73N.js";
-import "./chunk-TXNLMAN5.js";
-import "./chunk-BY6S6IWG.js";
-import "./chunk-GPN2THFD.js";
+import "./chunk-EL4KSW7E.js";
+import "./chunk-XUHPMETF.js";
+import "./chunk-XINHWP4T.js";

package/dist/{chunk-TXNLMAN5.js → chunk-EL4KSW7E.js}

@@ -1,7 +1,7 @@
 import {
   createProjectHealthReport,
   listWorkspaceAppCandidates
-} from "./chunk-BY6S6IWG.js";
+} from "./chunk-XUHPMETF.js";
 
 // src/commands/workspace.ts
 import { execFileSync } from "child_process";

package/dist/{chunk-GPN2THFD.js → chunk-XINHWP4T.js}

@@ -737,8 +737,8 @@ function extractCSSVariables(content) {
   const colors = {};
   const variables = [];
   const varRegex = /--([\w-]+)\s*:\s*([^;]+)/g;
-  let match;
-  while ((match = varRegex.exec(content)) !== null) {
+  let match = varRegex.exec(content);
+  while (match !== null) {
     const name = match[1];
     const value = match[2].trim();
     variables.push(`--${name}`);
@@ -758,6 +758,24 @@ function extractCSSVariables(content) {
     if (value.startsWith("#") || value.startsWith("rgb") || value.startsWith("hsl") || colorPatterns.some((p) => name.includes(p))) {
       colors[name] = value;
     }
+    match = varRegex.exec(content);
+  }
+  return { colors, variables };
+}
+function extractTailwindThemeTokens(content) {
+  const colors = {};
+  const variables = [];
+  for (const match of content.matchAll(
+    /\b([a-zA-Z][\w-]*)\s*:\s*['"`](#[0-9a-fA-F]{3,8}|rgba?\([^)]+\)|hsla?\([^)]+\)|oklch\([^)]+\)|var\(--[^)]+\))['"`]/g
+  )) {
+    const name = match[1];
+    const value = match[2];
+    if (/color|bg|background|surface|text|foreground|border|primary|secondary|accent|muted|danger|error|success|warning/i.test(
+      name
+    ) || /^#|^(?:rgba?|hsla?|oklch)\(/i.test(value) || /^var\(--/i.test(value)) {
+      colors[name] = value;
+      variables.push(`theme.colors.${name}`);
+    }
   }
   return { colors, variables };
 }
@@ -919,6 +937,16 @@ function scanStyling(projectRoot) {
     colors = { ...colors, ...extracted.colors };
     cssVariables.push(...extracted.variables);
   }
+  for (const cfg of TAILWIND_CONFIGS) {
+    const configPath = join3(projectRoot, cfg);
+    if (!existsSync3(configPath)) continue;
+    try {
+      const extracted = extractTailwindThemeTokens(readFileSync3(configPath, "utf-8"));
+      colors = { ...colors, ...extracted.colors };
+      cssVariables.push(...extracted.variables);
+    } catch {
+    }
+  }
   cssVariables = [...new Set(cssVariables)];
   const darkMode = detectDarkMode(projectRoot, cssContents);
   if (approach === "unknown" && cssContents.length > 0) {

package/dist/{chunk-BY6S6IWG.js → chunk-XUHPMETF.js}

@@ -3,12 +3,12 @@ import {
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-GPN2THFD.js";
+} from "./chunk-XINHWP4T.js";
 
 // src/commands/health.ts
 import { execFileSync as execFileSync2 } from "child_process";
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, realpathSync, writeFileSync as writeFileSync4 } from "fs";
 import { createRequire } from "module";
 import { dirname as dirname3, isAbsolute as isAbsolute4, join as join5, relative as relative3, resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
@@ -1261,6 +1261,19 @@ function colorTokenNames(styling) {
   }
   return [...names].slice(0, 40);
 }
+function firstCssVariable(styling, terms) {
+  return styling.cssVariables.find((name) => terms.test(name)) ?? null;
+}
+function firstClassHint(projectRoot, ids) {
+  return classHintsForPattern(projectRoot, ids)[0] ?? null;
+}
+function nativeRefForMapping(input) {
+  const cssVariable = firstCssVariable(input.styling, input.tokenTerms);
+  if (cssVariable) return { kind: "css-var", ref: cssVariable };
+  const classHint = firstClassHint(input.projectRoot, input.patternIds);
+  if (classHint) return { kind: "class", ref: classHint };
+  return { kind: "class", ref: input.fallbackClass };
+}
 function createStyleBridgeProposal(input) {
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const theme = readThemeInventory(input.projectRoot);
@@ -1272,7 +1285,7 @@ function createStyleBridgeProposal(input) {
   const themeModes = theme.modes.length > 0 ? theme.modes : darkModeDetected ? ["base", "dark"] : ["base"];
   const themeVariantIds = theme.variantIds.length > 0 ? theme.variantIds : themeModes.filter((mode) => mode !== "base");
   return {
-    version: 1,
+    version: 2,
     status: "proposal",
     generatedAt,
     source: "decantr codify --style-bridge",
@@ -1312,6 +1325,17 @@ function createStyleBridgeProposal(input) {
         label: "Surfaces and cards",
         decantrIntent: "surface background, card treatment, border, radius, depth, and hover state",
         projectAuthority: "Use the app card/surface primitives, tokens, and accepted local law.",
+        native: nativeRefForMapping({
+          projectRoot: input.projectRoot,
+          styling: input.styling,
+          patternIds: ["surface-card"],
+          tokenTerms: /surface|card|panel|bg|background|border|shadow|radius/i,
+          fallbackClass: "surface-card"
+        }),
+        essence: { kind: "treatment", ref: "surface" },
+        confidence: 0.7,
+        source: "inferred",
+        property: "surface",
         tokenHints: tokenHints(
           input.styling,
           /surface|card|panel|bg|background|border|shadow|radius/i
@@ -1328,6 +1352,17 @@ function createStyleBridgeProposal(input) {
         label: "Actions and buttons",
         decantrIntent: "primary, secondary, tertiary, destructive, icon-only, loading, and disabled action states",
         projectAuthority: "Use the app button/action primitives and local variant names.",
+        native: nativeRefForMapping({
+          projectRoot: input.projectRoot,
+          styling: input.styling,
+          patternIds: ["button"],
+          tokenTerms: /primary|secondary|accent|danger|error|destructive|focus/i,
+          fallbackClass: "button"
+        }),
+        essence: { kind: "treatment", ref: "action" },
+        confidence: 0.72,
+        source: "inferred",
+        property: "color",
         tokenHints: tokenHints(
           input.styling,
           /primary|secondary|accent|danger|error|destructive|focus/i
@@ -1344,6 +1379,17 @@ function createStyleBridgeProposal(input) {
         label: "Focus and accessibility",
         decantrIntent: "visible focus, keyboard clarity, contrast, and reduced-motion safety",
         projectAuthority: "Use the app accessibility classes, focus tokens, and framework conventions.",
+        native: nativeRefForMapping({
+          projectRoot: input.projectRoot,
+          styling: input.styling,
+          patternIds: [],
+          tokenTerms: /focus|ring|outline|contrast|motion|duration/i,
+          fallbackClass: "focus-visible"
+        }),
+        essence: { kind: "behavior", ref: "focus-accessibility" },
+        confidence: 0.66,
+        source: "inferred",
+        property: "focus",
         tokenHints: tokenHints(input.styling, /focus|ring|outline|contrast|motion|duration/i),
         classHints: [],
         sourceEvidence: [],
@@ -1357,6 +1403,17 @@ function createStyleBridgeProposal(input) {
         label: "Layout density and spacing",
         decantrIntent: "route gutters, section gaps, component padding, density, and responsive rhythm",
         projectAuthority: "Use existing layout wrappers, shell primitives, and spacing tokens/classes.",
+        native: nativeRefForMapping({
+          projectRoot: input.projectRoot,
+          styling: input.styling,
+          patternIds: ["page-shell"],
+          tokenTerms: /space|spacing|gap|gutter|container|radius/i,
+          fallbackClass: "page-shell"
+        }),
+        essence: { kind: "layout", ref: "density-spacing" },
+        confidence: 0.68,
+        source: "inferred",
+        property: "spacing",
         tokenHints: tokenHints(input.styling, /space|spacing|gap|gutter|container|radius/i),
         classHints: classHintsForPattern(input.projectRoot, ["page-shell"]),
         sourceEvidence: sourceEvidence(input.projectRoot, ["page-shell"]),
@@ -1370,6 +1427,17 @@ function createStyleBridgeProposal(input) {
         label: "Theme variants",
         decantrIntent: "light, dark, brand, tenant, seasonal, and density variants",
         projectAuthority: "Use the app theme provider, data attributes, CSS variables, or Tailwind mode strategy.",
+        native: nativeRefForMapping({
+          projectRoot: input.projectRoot,
+          styling: input.styling,
+          patternIds: ["theme-variant"],
+          tokenTerms: /theme|dark|light|brand|tenant|mode|color/i,
+          fallbackClass: "theme-variant"
+        }),
+        essence: { kind: "token", ref: "theme-variant" },
+        confidence: 0.64,
+        source: "inferred",
+        property: "theme",
         tokenHints: tokenHints(input.styling, /theme|dark|light|brand|tenant|mode|color/i),
         classHints: classHintsForPattern(input.projectRoot, ["theme-variant"]),
         sourceEvidence: sourceEvidence(input.projectRoot, ["theme-variant"]),
@@ -1453,6 +1521,11 @@ function styleBridgeMatches(projectRoot, query) {
       mapping.label,
       mapping.decantrIntent,
       mapping.projectAuthority,
+      mapping.native?.ref,
+      mapping.native?.kind,
+      mapping.essence?.ref,
+      mapping.essence?.kind,
+      mapping.property,
       ...mapping.tokenHints,
       ...mapping.classHints,
       ...mapping.guardrails
@@ -3143,6 +3216,20 @@ var DEFAULT_HEALTH_CI_REPORT_PATH = "decantr-health.md";
 var DEFAULT_HEALTH_CI_JSON_PATH = "decantr-health.json";
 var DEFAULT_HEALTH_CI_CLI_VERSION = "latest";
 var __dirname = dirname3(fileURLToPath(import.meta.url));
+var HEALTH_BROWSER_RUNTIME_DIAGNOSTICS = [
+  {
+    rule: "browser-runtime-probes-failed",
+    code: "RUNTIME010",
+    repairId: "repair-browser-runtime-probes",
+    family: "RUNTIME"
+  },
+  {
+    rule: "browser-axe-violations",
+    code: "A11Y020",
+    repairId: "fix-rendered-accessibility",
+    family: "A11Y"
+  }
+];
 function readProjectMetadata(projectRoot) {
   const projectJsonPath = join5(projectRoot, ".decantr", "project.json");
   if (!existsSync5(projectJsonPath)) {
@@ -3861,6 +3948,304 @@ function loadProjectPlaywright(projectRoot) {
   }
   return null;
 }
+var KNOWN_INTERACTION_STYLE_CLASSES = [
+  "d-enter-fade",
+  "d-enter-slide-up",
+  "d-enter-scale",
+  "d-stagger-children",
+  "d-pulse",
+  "d-pulse-ring",
+  "d-shimmer",
+  "d-float",
+  "d-glow-hover",
+  "d-lift-hover",
+  "d-scale-hover",
+  "d-ripple"
+];
+function compactBrowserEvidence(value) {
+  return value.replace(/\s+/g, " ").trim().slice(0, 240);
+}
+function browserErrorMessage(error) {
+  return compactBrowserEvidence(error instanceof Error ? error.message : String(error));
+}
+function isPathInside(parentPath, childPath) {
+  const parentRealPath = realpathSync(parentPath);
+  const childRealPath = realpathSync(childPath);
+  const relativePath = relative3(parentRealPath, childRealPath);
+  return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute4(relativePath);
+}
+function loadProjectAxeCore(projectRoot) {
+  try {
+    const requireFromProject = createRequire(join5(projectRoot, "package.json"));
+    const resolved = requireFromProject.resolve("axe-core");
+    const workspaceRoot = resolveWorkspaceInfo(projectRoot).workspaceRoot;
+    const resolvedInProject = [projectRoot, workspaceRoot].some(
+      (root) => isPathInside(root, resolved)
+    );
+    if (!resolvedInProject) return null;
+    const loaded = requireFromProject("axe-core");
+    return typeof loaded.source === "string" && loaded.source.length > 0 ? { source: loaded.source } : null;
+  } catch {
+    return null;
+  }
+}
+function consoleErrorMessage(message) {
+  try {
+    const type = typeof message.type === "function" ? message.type() : "error";
+    if (type !== "error") return null;
+    const text = typeof message.text === "function" ? message.text() : "Console error";
+    return compactBrowserEvidence(text || "Console error");
+  } catch {
+    return "Console error event could not be read.";
+  }
+}
+function consoleProbe(messages) {
+  return {
+    status: messages.length > 0 ? "failed" : "passed",
+    count: messages.length,
+    messages: messages.slice(0, 5)
+  };
+}
+function fallbackRuntimeDomSnapshot(reason) {
+  return {
+    routeRendered: {
+      status: "failed",
+      readyState: null,
+      url: null,
+      title: null,
+      bodyPresent: false,
+      appRootPresent: false,
+      bodyChildCount: 0,
+      reason
+    },
+    nonblankDom: {
+      status: "failed",
+      textLength: 0,
+      meaningfulElementCount: 0,
+      mediaElementCount: 0,
+      controlElementCount: 0,
+      reason
+    },
+    interactionStyles: {
+      status: "skipped",
+      checked: 0,
+      matchedClasses: [],
+      animatedOrTransitioned: 0,
+      missing: [],
+      reason
+    }
+  };
+}
+async function collectRuntimeDomSnapshot(page) {
+  try {
+    return await page.evaluate((knownInteractionClasses) => {
+      const global = globalThis;
+      const document = global.document;
+      const body = document?.body;
+      const readyState = typeof document?.readyState === "string" ? document.readyState : null;
+      const title = typeof document?.title === "string" ? document.title : null;
+      const url = typeof global.location?.href === "string" ? global.location.href : null;
+      const querySelector = typeof document?.querySelector === "function" ? document.querySelector : null;
+      const querySelectorAll = typeof document?.querySelectorAll === "function" ? document.querySelectorAll : null;
+      const bodyChildCount = typeof body?.childElementCount === "number" ? body.childElementCount : 0;
+      const appRootPresent = Boolean(
+        querySelector?.('[data-decantr-root], #root, #app, main, [role="main"], body > *')
+      );
+      const routeRendered = Boolean(body) && readyState !== "loading" && (appRootPresent || bodyChildCount > 0);
+      const rawElements = querySelectorAll ? querySelectorAll("body *") : [];
+      const elements = Array.from(rawElements);
+      const text = String(body?.innerText ?? body?.textContent ?? "").replace(/\s+/g, " ").trim();
+      const mediaTags = /* @__PURE__ */ new Set(["IMG", "SVG", "CANVAS", "VIDEO", "PICTURE"]);
+      const controlTags = /* @__PURE__ */ new Set(["A", "BUTTON", "INPUT", "SELECT", "TEXTAREA", "SUMMARY"]);
+      const elementTag = (element) => typeof element.tagName === "string" ? element.tagName.toUpperCase() : "";
+      const elementText = (element) => String(element.textContent ?? "").replace(/\s+/g, " ").trim();
+      const elementAttribute = (element, name) => typeof element.getAttribute === "function" ? String(element.getAttribute(name) ?? "").trim() : "";
+      const mediaElementCount = elements.filter(
+        (element) => mediaTags.has(elementTag(element))
+      ).length;
+      const controlElementCount = elements.filter(
+        (element) => controlTags.has(elementTag(element))
+      ).length;
+      const meaningfulElementCount = elements.filter((element) => {
+        const tag = elementTag(element);
+        return elementText(element).length > 0 || mediaTags.has(tag) || controlTags.has(tag) || elementAttribute(element, "aria-label").length > 0 || elementAttribute(element, "alt").length > 0 || elementAttribute(element, "title").length > 0;
+      }).length;
+      const nonblank = text.length > 0 || meaningfulElementCount > 0 || mediaElementCount > 0 || controlElementCount > 0;
+      const durationHasTime = (value) => String(value ?? "").split(",").some((part) => {
+        const trimmed = part.trim();
+        if (!trimmed) return false;
+        if (trimmed.endsWith("ms")) return Number.parseFloat(trimmed) > 0;
+        if (trimmed.endsWith("s")) return Number.parseFloat(trimmed) > 0;
+        return Number.parseFloat(trimmed) > 0;
+      });
+      const classListContains = (element, className) => {
+        const classList = element.classList;
+        if (typeof classList?.contains === "function") return classList.contains(className);
+        return String(element.className ?? "").split(/\s+/).includes(className);
+      };
+      const styleTargets = elements.map((element) => ({
+        element,
+        classes: knownInteractionClasses.filter(
+          (className) => classListContains(element, className)
+        )
+      })).filter((entry) => entry.classes.length > 0);
+      const matchedClasses = [...new Set(styleTargets.flatMap((entry) => entry.classes))].sort();
+      const missing = /* @__PURE__ */ new Set();
+      let animatedOrTransitioned = 0;
+      for (const entry of styleTargets) {
+        const computed = typeof global.getComputedStyle === "function" ? global.getComputedStyle(entry.element) : {};
+        const animationName = String(computed.animationName ?? "none");
+        const transitionProperty = String(computed.transitionProperty ?? "none");
+        const hasAnimation = animationName !== "none" && durationHasTime(computed.animationDuration);
+        const hasTransition = transitionProperty !== "none" && durationHasTime(computed.transitionDuration);
+        if (hasAnimation || hasTransition) {
+          animatedOrTransitioned += 1;
+        } else {
+          for (const className of entry.classes) missing.add(className);
+        }
+      }
+      const interactionStatus = styleTargets.length === 0 ? "skipped" : missing.size === 0 ? "passed" : "failed";
+      return {
+        routeRendered: {
+          status: routeRendered ? "passed" : "failed",
+          readyState,
+          url,
+          title,
+          bodyPresent: Boolean(body),
+          appRootPresent,
+          bodyChildCount,
+          ...routeRendered ? {} : { reason: "No rendered app root or body content was detected after navigation." }
+        },
+        nonblankDom: {
+          status: nonblank ? "passed" : "failed",
+          textLength: text.length,
+          meaningfulElementCount,
+          mediaElementCount,
+          controlElementCount,
+          ...nonblank ? {} : {
+            reason: "DOM rendered, but no meaningful text, media, controls, or labels were detected."
+          }
+        },
+        interactionStyles: {
+          status: interactionStatus,
+          checked: styleTargets.length,
+          matchedClasses,
+          animatedOrTransitioned,
+          missing: [...missing].slice(0, 8),
+          ...styleTargets.length === 0 ? { reason: "No known Decantr interaction classes were present on this route." } : {}
+        }
+      };
+    }, KNOWN_INTERACTION_STYLE_CLASSES);
+  } catch (error) {
+    return fallbackRuntimeDomSnapshot(`Runtime DOM probe failed: ${browserErrorMessage(error)}`);
+  }
+}
+function skippedAccessibilityProbe(reason) {
+  return {
+    status: "skipped",
+    engine: "axe-core",
+    violations: 0,
+    incomplete: 0,
+    messages: [],
+    reason
+  };
+}
+async function collectAccessibilityProbe(page, axeCore) {
+  if (!axeCore) return skippedAccessibilityProbe("axe-core is not installed in this project.");
+  if (!page.addScriptTag) {
+    return skippedAccessibilityProbe("The local Playwright adapter does not expose addScriptTag.");
+  }
+  try {
+    await page.addScriptTag({ content: axeCore.source });
+    const result = await page.evaluate(() => {
+      const global = globalThis;
+      if (!global.axe?.run) return { error: "axe-core did not expose window.axe.run." };
+      return global.axe.run(global.document, { resultTypes: ["violations"] }).then((axeResult) => ({
+        violations: (axeResult.violations ?? []).map((violation) => ({
+          id: violation.id,
+          impact: violation.impact,
+          help: violation.help,
+          description: violation.description,
+          targets: (violation.nodes ?? []).flatMap((node) => node.target ?? []).slice(0, 3)
+        })),
+        incomplete: axeResult.incomplete?.length ?? 0
+      }));
+    });
+    if (result.error) {
+      return {
+        status: "failed",
+        engine: "axe-core",
+        violations: 0,
+        incomplete: 0,
+        messages: [result.error],
+        reason: result.error
+      };
+    }
+    const violations = result.violations ?? [];
+    const messages = violations.slice(0, 5).map((violation) => {
+      const label = violation.id ?? "axe-violation";
+      const detail = violation.help ?? violation.description ?? "Accessibility violation";
+      const impact = violation.impact ? ` (${violation.impact})` : "";
+      const targets = violation.targets && violation.targets.length > 0 ? ` [${violation.targets.join(", ")}]` : "";
+      return compactBrowserEvidence(`${label}${impact}: ${detail}${targets}`);
+    });
+    return {
+      status: violations.length > 0 ? "failed" : "passed",
+      engine: "axe-core",
+      violations: violations.length,
+      incomplete: result.incomplete ?? 0,
+      messages
+    };
+  } catch (error) {
+    const message = `Axe probe failed: ${browserErrorMessage(error)}`;
+    return {
+      status: "failed",
+      engine: "axe-core",
+      violations: 0,
+      incomplete: 0,
+      messages: [message],
+      reason: message
+    };
+  }
+}
+function browserRuntimeFailureMessages(route, runtime) {
+  const messages = [];
+  if (runtime.routeRendered.status === "failed") {
+    messages.push(
+      `${route}: route-rendered probe failed (${runtime.routeRendered.reason ?? "no rendered app root detected"})`
+    );
+  }
+  if (runtime.nonblankDom.status === "failed") {
+    messages.push(
+      `${route}: nonblank DOM probe failed (${runtime.nonblankDom.reason ?? "blank DOM detected"})`
+    );
+  }
+  if (runtime.consoleErrors.count > 0) {
+    messages.push(
+      `${route}: console errors (${runtime.consoleErrors.count}) ${runtime.consoleErrors.messages.join(" | ")}`
+    );
+  }
+  if (runtime.pageErrors.count > 0) {
+    messages.push(
+      `${route}: page errors (${runtime.pageErrors.count}) ${runtime.pageErrors.messages.join(" | ")}`
+    );
+  }
+  if (runtime.interactionStyles.status === "failed") {
+    messages.push(
+      `${route}: interaction style probe found known classes without computed animation/transition (${runtime.interactionStyles.missing.join(", ")})`
+    );
+  }
+  return messages.map(compactBrowserEvidence);
+}
+function browserAccessibilityFailureMessages(route, runtime) {
+  if (runtime.accessibility.status !== "failed") return [];
+  const detail = runtime.accessibility.messages.length > 0 ? runtime.accessibility.messages.join(" | ") : runtime.accessibility.reason ?? "axe-core reported accessibility failures";
+  return [
+    compactBrowserEvidence(
+      `${route}: axe-core violations (${runtime.accessibility.violations}) ${detail}`
+    )
+  ];
+}
 function browserRouteUrl(baseUrl, route) {
   return new URL(route || "/", baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`).toString();
 }
@@ -3882,7 +4267,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "playwright-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3904,7 +4289,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "base-url-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3927,7 +4312,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "adapter-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3939,19 +4324,41 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
   }
   const routes = (declaredRoutes.length > 0 ? declaredRoutes : ["/"]).slice(0, 12);
   const screenshots = [];
-  const browserFindings = [];
+  const routeFailures = [];
+  const runtimeFailures = [];
+  const accessibilityFailures = [];
   const visualRoutes = [];
   const screenshotDir = join5(projectRoot, ".decantr", "evidence", "screenshots");
   mkdirSync4(screenshotDir, { recursive: true });
+  const axeCore = loadProjectAxeCore(projectRoot);
   let browser = null;
   try {
     browser = await playwright.chromium.launch({ headless: true });
-    const page = await browser.newPage();
     for (const route of routes) {
       const url = browserRouteUrl(options.browserBaseUrl, route);
       const relativePath = browserScreenshotRelativePath(route);
+      let page = null;
+      const consoleErrors = [];
+      const pageErrors = [];
       try {
+        page = await browser.newPage();
+        page.on?.("console", (message) => {
+          const errorMessage = consoleErrorMessage(message);
+          if (errorMessage) consoleErrors.push(errorMessage);
+        });
+        page.on?.("pageerror", (error) => {
+          pageErrors.push(browserErrorMessage(error));
+        });
         await page.goto(url, { waitUntil: "networkidle", timeout: 15e3 });
+        const domSnapshot = await collectRuntimeDomSnapshot(page);
+        const runtime = {
+          ...domSnapshot,
+          consoleErrors: consoleProbe(consoleErrors),
+          pageErrors: consoleProbe(pageErrors),
+          accessibility: await collectAccessibilityProbe(page, axeCore)
+        };
+        runtimeFailures.push(...browserRuntimeFailureMessages(route, runtime));
+        accessibilityFailures.push(...browserAccessibilityFailureMessages(route, runtime));
         const absoluteScreenshotPath = join5(projectRoot, relativePath);
         await page.screenshot({ path: absoluteScreenshotPath, fullPage: true });
         screenshots.push(relativePath);
@@ -3960,11 +4367,12 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
           url,
           screenshot: relativePath,
           screenshotHash: hashFile2(absoluteScreenshotPath),
-          status: "captured"
+          status: "captured",
+          runtime
         });
       } catch (error) {
         const message = error.message;
-        browserFindings.push(`${route}: ${message}`);
+        routeFailures.push(`${route}: ${message}`);
         visualRoutes.push({
           route,
           url,
@@ -3973,10 +4381,15 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
           status: "failed",
           error: message
         });
+      } finally {
+        try {
+          await page?.close?.();
+        } catch {
+        }
       }
     }
   } catch (error) {
-    browserFindings.push(error.message);
+    routeFailures.push(error.message);
   } finally {
     if (browser) await browser.close();
   }
@@ -3990,30 +4403,68 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
   const visualManifestPath = join5(projectRoot, ".decantr", "evidence", "visual-manifest.json");
   mkdirSync4(dirname3(visualManifestPath), { recursive: true });
   writeFileSync4(visualManifestPath, JSON.stringify(visualManifest, null, 2) + "\n", "utf-8");
-  if (browserFindings.length > 0) {
-    const finding = createHealthFinding({
-      source: "browser",
-      category: "Browser Verification",
-      severity: options.requireBrowser ? "error" : "warn",
-      message: "Browser verification could not render every declared route.",
-      evidence: browserFindings.slice(0, 5),
-      rule: "browser-route-verification-failed",
-      suggestedFix: "Start the app at the provided base URL, fix route render errors, and rerun `decantr health --browser --evidence`.",
-      baseId: "route-verification-failed"
-    });
+  const findings = [];
+  if (routeFailures.length > 0) {
+    findings.push(
+      createHealthFinding({
+        source: "browser",
+        category: "Browser Verification",
+        severity: options.requireBrowser ? "error" : "warn",
+        message: "Browser verification could not render every declared route.",
+        evidence: routeFailures.slice(0, 5),
+        rule: "browser-route-verification-failed",
+        suggestedFix: "Start the app at the provided base URL, fix route render errors, and rerun `decantr health --browser --evidence`.",
+        baseId: "route-verification-failed"
+      })
+    );
+  }
+  if (runtimeFailures.length > 0) {
+    findings.push(
+      createHealthFinding({
+        source: "browser",
+        category: "Browser Runtime",
+        severity: options.requireBrowser ? "error" : "warn",
+        message: "Browser runtime probes failed for one or more rendered routes.",
+        evidence: runtimeFailures.slice(0, 5),
+        rule: "browser-runtime-probes-failed",
+        suggestedFix: "Inspect console/page errors and rendered DOM state, repair the route runtime behavior, and rerun `decantr health --browser --evidence`.",
+        code: "RUNTIME010",
+        repair: { id: "repair-browser-runtime-probes" },
+        baseId: "runtime-probes-failed"
+      })
+    );
+  }
+  if (accessibilityFailures.length > 0) {
+    findings.push(
+      createHealthFinding({
+        source: "browser",
+        category: "Browser Accessibility",
+        severity: options.requireBrowser ? "error" : "warn",
+        message: "Axe reported accessibility violations in rendered browser evidence.",
+        evidence: accessibilityFailures.slice(0, 5),
+        rule: "browser-axe-violations",
+        suggestedFix: "Repair the rendered accessibility violations and rerun `decantr health --browser --evidence`.",
+        code: "A11Y020",
+        repair: { id: "fix-rendered-accessibility" },
+        baseId: "axe-violations"
+      })
+    );
+  }
+  if (findings.length > 0) {
+    const evidenceFindings = [...routeFailures, ...runtimeFailures, ...accessibilityFailures];
     return {
-      finding,
+      findings,
       evidence: {
         enabled: true,
         status: "failed",
         baseUrl: options.browserBaseUrl,
         screenshots,
-        findings: browserFindings
+        findings: evidenceFindings
       }
     };
   }
   return {
-    finding: null,
+    findings: [],
     evidence: {
       enabled: true,
       status: "passed",
@@ -4398,8 +4849,8 @@ async function createProjectHealthReport(projectRoot = process.cwd(), options =
     options,
     declaredRoutes
   );
-  if (browserVerification?.finding && !isDuplicateFinding(seen, browserVerification.finding)) {
-    findings.push(browserVerification.finding);
+  for (const browserFinding of browserVerification?.findings ?? []) {
+    if (!isDuplicateFinding(seen, browserFinding)) findings.push(browserFinding);
   }
   const anchoredFindings = anchorProjectHealthFindings(projectRoot, findings);
   const scopedFindings = scopeHealthFindingsToProject(projectRoot, anchoredFindings);
@@ -4561,8 +5012,12 @@ function formatProjectHealthJson(report) {
 `;
 }
 function diagnosticCatalogPayload() {
+  const diagnosticsByRule = /* @__PURE__ */ new Map();
+  for (const entry of [...KNOWN_VERIFICATION_DIAGNOSTICS, ...HEALTH_BROWSER_RUNTIME_DIAGNOSTICS]) {
+    diagnosticsByRule.set(entry.rule, entry);
+  }
   return {
-    diagnostics: KNOWN_VERIFICATION_DIAGNOSTICS.map((entry) => ({
+    diagnostics: [...diagnosticsByRule.values()].map((entry) => ({
       code: entry.code,
       family: entry.family,
       rule: entry.rule,

package/dist/{chunk-WSL6ZSTZ.js → chunk-ZBGL7RID.js}

@@ -22,7 +22,7 @@ import {
   listWorkspaceCandidates,
   listWorkspaceProjects,
   shouldFailWorkspaceHealth
-} from "./chunk-TXNLMAN5.js";
+} from "./chunk-EL4KSW7E.js";
 import {
   acceptBrownfieldLocalLaw,
   acceptStyleBridge,
@@ -52,7 +52,7 @@ import {
   writeBrownfieldCodifyProposal,
   writeHostedPatternMappingProposal,
   writeStyleBridgeProposal
-} from "./chunk-BY6S6IWG.js";
+} from "./chunk-XUHPMETF.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -69,7 +69,7 @@ import {
   sendCliCommandTelemetry,
   sendNewProjectCompletedTelemetry,
   writeDoctrineMap
-} from "./chunk-GPN2THFD.js";
+} from "./chunk-XINHWP4T.js";
 
 // src/index.ts
 import { existsSync as existsSync28, mkdirSync as mkdirSync15, readdirSync as readdirSync8, readFileSync as readFileSync21, writeFileSync as writeFileSync18 } from "fs";
@@ -10859,7 +10859,7 @@ async function cmdAdoptWorkflow(args) {
   await cmdGraph(projectRoot, { displayRoot: process.cwd() });
   if (process.exitCode && process.exitCode !== 0) return;
   if (runVerify) {
-    const { cmdHealth } = await import("./health-IOTIZT7Z.js");
+    const { cmdHealth } = await import("./health-H2256NIM.js");
     await cmdHealth(projectRoot, {
       browser: runBrowser,
       browserBaseUrl: baseUrl,
@@ -10930,7 +10930,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-72SJI3MW.js");
+    const { cmdWorkspace } = await import("./workspace-SR6ZGG2E.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -10963,7 +10963,7 @@ async function cmdVerifyWorkflow(args) {
   }
   let guardExitCode;
   if (brownfield) {
-    const { cmdHeal, collectCheckIssues } = await import("./heal-2DKBFWB6.js");
+    const { cmdHeal, collectCheckIssues } = await import("./heal-ZY4BX5HU.js");
     if (quietOutput) {
       const result = collectCheckIssues(workspaceInfo.appRoot, { brownfield: true });
       guardExitCode = result.issues.some((issue) => issue.type === "error") ? 1 : void 0;
@@ -10973,7 +10973,7 @@ async function cmdVerifyWorkflow(args) {
       process.exitCode = void 0;
     }
   }
-  const { cmdHealth, parseHealthArgs } = await import("./health-IOTIZT7Z.js");
+  const { cmdHealth, parseHealthArgs } = await import("./health-H2256NIM.js");
   await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(healthArgs));
   if (localPatterns) {
     const validation = validateLocalLaw(workspaceInfo.appRoot);
@@ -12476,7 +12476,7 @@ async function main() {
           `${YELLOW12}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET16}`
         );
       }
-      const { cmdHeal } = await import("./heal-2DKBFWB6.js");
+      const { cmdHeal } = await import("./heal-ZY4BX5HU.js");
       const { flags } = parseLooseArgs(args);
       const workspaceInfo = resolveWorkflowProject(flags, "check");
       if (!workspaceInfo) break;
@@ -12501,7 +12501,7 @@ async function main() {
         const { flags } = parseLooseArgs(args);
         const workspaceInfo = resolveWorkflowProject(flags, "health");
         if (!workspaceInfo) break;
-        const { cmdHealth, parseHealthArgs } = await import("./health-IOTIZT7Z.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-H2256NIM.js");
         await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(stripProjectArgs(args)));
       } catch (e) {
         console.error(error2(e.message));
@@ -12529,7 +12529,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-DLWUMCC3.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-UKSCSRX7.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error2(e.message));
@@ -12543,7 +12543,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-72SJI3MW.js");
+        const { cmdWorkspace } = await import("./workspace-SR6ZGG2E.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error2(e.message));

package/dist/{heal-2DKBFWB6.js → heal-ZY4BX5HU.js}

@@ -1,7 +1,7 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-GPN2THFD.js";
+} from "./chunk-XINHWP4T.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-IOTIZT7Z.js → health-H2256NIM.js}

@@ -13,8 +13,8 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-BY6S6IWG.js";
-import "./chunk-GPN2THFD.js";
+} from "./chunk-XUHPMETF.js";
+import "./chunk-XINHWP4T.js";
 export {
   cmdHealth,
   collectDesignTokenEvidence,

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-WSL6ZSTZ.js";
+import "./chunk-ZBGL7RID.js";
 import "./chunk-SIDKK73N.js";
-import "./chunk-TXNLMAN5.js";
-import "./chunk-BY6S6IWG.js";
-import "./chunk-GPN2THFD.js";
+import "./chunk-EL4KSW7E.js";
+import "./chunk-XUHPMETF.js";
+import "./chunk-XINHWP4T.js";

package/dist/{studio-DLWUMCC3.js → studio-UKSCSRX7.js}

@@ -1,13 +1,13 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-TXNLMAN5.js";
+} from "./chunk-EL4KSW7E.js";
 import {
   createProjectHealthReport
-} from "./chunk-BY6S6IWG.js";
+} from "./chunk-XUHPMETF.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-GPN2THFD.js";
+} from "./chunk-XINHWP4T.js";
 
 // src/commands/studio.ts
 import { readFileSync } from "fs";

package/dist/{workspace-72SJI3MW.js → workspace-SR6ZGG2E.js}

@@ -7,9 +7,9 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-TXNLMAN5.js";
-import "./chunk-BY6S6IWG.js";
-import "./chunk-GPN2THFD.js";
+} from "./chunk-EL4KSW7E.js";
+import "./chunk-XUHPMETF.js";
+import "./chunk-XINHWP4T.js";
 export {
   cmdWorkspace,
   createWorkspaceHealthReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "3.1.0",
+  "version": "3.4.0",
   "description": "Decantr CLI - adopt, verify, graph, and govern frontend codebases touched by AI agents",
   "keywords": [
     "decantr",
@@ -49,11 +49,11 @@
   },
   "dependencies": {
     "ajv": "^8.20.0",
-    "@decantr/core": "3.1.0",
-    "@decantr/registry": "3.1.0",
-    "@decantr/essence-spec": "3.1.0",
-    "@decantr/telemetry": "3.1.0",
-    "@decantr/verifier": "3.1.0"
+    "@decantr/core": "3.4.0",
+    "@decantr/telemetry": "3.4.0",
+    "@decantr/registry": "3.4.0",
+    "@decantr/verifier": "3.4.0",
+    "@decantr/essence-spec": "3.4.0"
   },
   "scripts": {
     "build": "tsup",