@decantr/cli 3.0.2 → 3.4.0

package/dist/{chunk-4NDOHCYY.js → chunk-XUHPMETF.js}

@@ -3,14 +3,14 @@ import {
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-7Z74ETDR.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 isAbsolute3, join as join5, relative as relative3, resolve as resolve2 } from "path";
+import { dirname as dirname3, isAbsolute as isAbsolute4, join as join5, relative as relative3, resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
 import {
   anchorFindingsToGraph,
@@ -114,8 +114,8 @@ function resolveWorkspaceInfo(cwd, projectArg) {
 
 // src/commands/graph.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname2, isAbsolute as isAbsolute2, join as join4, relative as relative2 } from "path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname2, isAbsolute as isAbsolute3, join as join4, relative as relative2 } from "path";
 import {
   buildContractCapsuleFromSnapshot,
   buildGraphImpactContext,
@@ -138,7 +138,7 @@ import {
 // src/local-law.ts
 import { execFileSync } from "child_process";
 import { existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync, writeFileSync } from "fs";
-import { basename, extname, join as join2, relative, sep } from "path";
+import { basename, extname, isAbsolute as isAbsolute2, join as join2, relative, resolve as resolve2, sep } from "path";
 import { isV4 } from "@decantr/essence-spec";
 var SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".astro",
@@ -827,12 +827,13 @@ function createLocalLawTaskSummary(projectRoot) {
 function changedFiles(projectRoot, since) {
   const changed = /* @__PURE__ */ new Set();
   try {
+    const gitRoot = gitTopLevel(projectRoot) ?? projectRoot;
     const commands = since ? [
-      ["diff", "--name-only", since, "--"],
-      ["diff", "--name-only", "--cached"]
+      ["diff", "--name-only", "--relative", since, "--"],
+      ["diff", "--name-only", "--relative", "--cached"]
     ] : [
-      ["diff", "--name-only"],
-      ["diff", "--name-only", "--cached"]
+      ["diff", "--name-only", "--relative"],
+      ["diff", "--name-only", "--relative", "--cached"]
     ];
     for (const args of commands) {
       const output = execFileSync("git", args, {
@@ -842,13 +843,38 @@ function changedFiles(projectRoot, since) {
       });
       for (const line of output.split(/\r?\n/)) {
         const file = line.trim();
-        if (file) changed.add(normalizePath(file));
+        const projectFile = changedFileForProject(projectRoot, gitRoot, file);
+        if (projectFile) changed.add(projectFile);
       }
     }
   } catch {
   }
   return [...changed].sort();
 }
+function gitTopLevel(projectRoot) {
+  try {
+    return execFileSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd: projectRoot,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+function changedFileForProject(projectRoot, gitRoot, file) {
+  if (!file) return null;
+  const absoluteProjectRoot = resolve2(projectRoot);
+  const candidateAbsoluteFiles = isAbsolute2(file) ? [file] : [join2(absoluteProjectRoot, file), join2(gitRoot, file)];
+  for (const absoluteFile of candidateAbsoluteFiles) {
+    const projectRelative = normalizePath(relative(absoluteProjectRoot, absoluteFile));
+    if (!projectRelative || projectRelative.startsWith("../") || projectRelative === "..") {
+      continue;
+    }
+    return projectRelative;
+  }
+  return null;
+}
 function routeImpacts(projectRoot, files) {
   const analysis = readJsonFile(
     join2(projectRoot, ".decantr", "analysis.json")
@@ -1235,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);
@@ -1246,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",
@@ -1286,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
@@ -1302,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
@@ -1318,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: [],
@@ -1331,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"]),
@@ -1344,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"]),
@@ -1427,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
@@ -1647,17 +1746,24 @@ function readGraphSnapshotSelection(artifacts, snapshotId) {
 }
 function projectRelativePath(projectRoot, path) {
   if (!path) return null;
-  const absolutePath = isAbsolute2(path) ? path : join4(projectRoot, path);
+  const absolutePath = isAbsolute3(path) ? path : join4(projectRoot, path);
   const relativePath = relative2(projectRoot, absolutePath).replace(/\\/g, "/");
-  if (!relativePath || relativePath.startsWith("..") || isAbsolute2(relativePath)) {
+  if (!relativePath || relativePath.startsWith("..") || isAbsolute3(relativePath)) {
     return null;
   }
   return relativePath;
 }
+function pathIsFile(path) {
+  try {
+    return statSync2(path).isFile();
+  } catch {
+    return false;
+  }
+}
 function existingProjectRelativePath(projectRoot, path) {
   const relativePath = projectRelativePath(projectRoot, path);
   if (!relativePath) return null;
-  return existsSync4(join4(projectRoot, relativePath)) ? relativePath : null;
+  return pathIsFile(join4(projectRoot, relativePath)) ? relativePath : null;
 }
 function stripJsonComments(value) {
   return value.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
@@ -1708,7 +1814,7 @@ function existingImportCandidate(projectRoot, candidate) {
     join4(relativeCandidate, "index.cts").replace(/\\/g, "/")
   ];
   for (const possible of candidates) {
-    if (existsSync4(join4(projectRoot, possible))) return possible;
+    if (pathIsFile(join4(projectRoot, possible))) return possible;
   }
   return null;
 }
@@ -1841,7 +1947,7 @@ function sourceArtifacts(projectRoot, componentReuseAudit = null) {
       const routeFile = projectRelativePath(projectRoot, route.file);
       if (!routeFile) continue;
       const routeFilePath = join4(projectRoot, routeFile);
-      if (!existsSync4(routeFilePath)) continue;
+      if (!pathIsFile(routeFilePath)) continue;
       sources.push({
         id: `src:${routeFile}`,
         kind: "route-source",
@@ -1860,7 +1966,7 @@ function sourceArtifacts(projectRoot, componentReuseAudit = null) {
     const componentFile = projectRelativePath(projectRoot, declaration.file);
     if (!componentFile) continue;
     const componentPath = join4(projectRoot, componentFile);
-    if (!existsSync4(componentPath)) continue;
+    if (!pathIsFile(componentPath)) continue;
     if (sources.some((source) => source.id === `src:${componentFile}`)) continue;
     sources.push({
       id: `src:${componentFile}`,
@@ -1879,7 +1985,7 @@ function sourceArtifacts(projectRoot, componentReuseAudit = null) {
     const importingFile = projectRelativePath(projectRoot, importReference.file);
     if (!importingFile) continue;
     const importingPath = join4(projectRoot, importingFile);
-    if (existsSync4(importingPath) && !sources.some((source) => source.id === `src:${importingFile}`)) {
+    if (pathIsFile(importingPath) && !sources.some((source) => source.id === `src:${importingFile}`)) {
       sources.push({
         id: `src:${importingFile}`,
         kind: "code-source",
@@ -1899,7 +2005,7 @@ function sourceArtifacts(projectRoot, componentReuseAudit = null) {
     );
     if (!importedFile) continue;
     const importedPath = join4(projectRoot, importedFile);
-    if (!existsSync4(importedPath)) continue;
+    if (!pathIsFile(importedPath)) continue;
     if (sources.some((source) => source.id === `src:${importedFile}`)) continue;
     sources.push({
       id: `src:${importedFile}`,
@@ -1928,7 +2034,7 @@ function sourceArtifacts(projectRoot, componentReuseAudit = null) {
     for (const route of visualManifest.routes ?? []) {
       if (!route.screenshot) continue;
       const screenshotPath = join4(projectRoot, route.screenshot);
-      if (!existsSync4(screenshotPath)) continue;
+      if (!pathIsFile(screenshotPath)) continue;
       sources.push({
         id: `src:${route.screenshot}`,
         kind: "visual-screenshot",
@@ -2596,7 +2702,7 @@ function augmentProjectGraph(snapshot, projectRoot, sources, componentReuseAudit
 function pathForDisplay(projectRoot, path, displayRoot) {
   if (!displayRoot) return path.replace(`${projectRoot}/`, "");
   const relativePath = relative2(displayRoot, path).replace(/\\/g, "/");
-  if (relativePath && !relativePath.startsWith("..") && !isAbsolute2(relativePath)) {
+  if (relativePath && !relativePath.startsWith("..") && !isAbsolute3(relativePath)) {
     return relativePath;
   }
   return path;
@@ -2836,7 +2942,7 @@ function graphSourceNodeIdForFile(projectRoot, snapshot, file) {
   })?.id ?? null;
 }
 function resolvePathFromCwd(path) {
-  return isAbsolute2(path) ? path : join4(process.cwd(), path);
+  return isAbsolute3(path) ? path : join4(process.cwd(), path);
 }
 function impactContextPayload(impactContext, selection) {
   if (!selection) return void 0;
@@ -3110,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)) {
@@ -3467,7 +3587,7 @@ function commandsForFinding(source) {
     case "runtime":
       return ["npm run build", "decantr health"];
     case "interaction":
-      return ["decantr check --strict", "decantr health"];
+      return ["decantr verify --brownfield --local-patterns", "decantr verify --evidence"];
     case "assertion":
       return ["decantr refresh", "decantr health --evidence"];
     case "browser":
@@ -3477,7 +3597,7 @@ function commandsForFinding(source) {
     case "style-bridge":
       return ["decantr codify --style-bridge", "decantr verify --evidence"];
     case "graph":
-      return ["decantr graph", "decantr health"];
+      return ["decantr graph", "decantr verify --evidence"];
     case "check":
       return ["decantr check", "decantr health"];
     default:
@@ -3531,7 +3651,7 @@ function commandContextForProject(projectRoot) {
     /\\/g,
     "/"
   );
-  const projectPath = relativeProjectPath && !relativeProjectPath.startsWith("..") && !isAbsolute3(relativeProjectPath) ? relativeProjectPath : null;
+  const projectPath = relativeProjectPath && !relativeProjectPath.startsWith("..") && !isAbsolute4(relativeProjectPath) ? relativeProjectPath : null;
   const projectFlag = projectPath ? ` --project ${projectPath}` : "";
   const essencePath = projectPath ? `${projectPath}/decantr.essence.json` : "decantr.essence.json";
   return {
@@ -3566,6 +3686,10 @@ function rewriteHealthCommand(command, context) {
     /^decantr graph\b/,
     `decantr graph --project ${context.projectPath}`
   );
+  rewritten = rewritten.replace(
+    /^decantr verify\b/,
+    `decantr verify --project ${context.projectPath}`
+  );
   rewritten = rewritten.replace(/^decantr audit\b/, context.verifyCommand);
   rewritten = rewritten.replace(/^decantr health\b/, context.verifyCommand);
   return rewritten;
@@ -3796,7 +3920,7 @@ function isDuplicateFinding(existing, finding) {
 }
 function resolveOptionalPath(projectRoot, path) {
   if (!path) return void 0;
-  return isAbsolute3(path) ? path : resolve2(projectRoot, path);
+  return isAbsolute4(path) ? path : resolve3(projectRoot, path);
 }
 function hasProjectPlaywright(projectRoot) {
   try {
@@ -3824,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();
 }
@@ -3845,7 +4267,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "playwright-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3867,7 +4289,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "base-url-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3890,7 +4312,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       baseId: "adapter-missing"
     });
     return {
-      finding,
+      findings: [finding],
       evidence: {
         enabled: true,
         status: "unavailable",
@@ -3902,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);
@@ -3923,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,
@@ -3936,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();
   }
@@ -3953,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",
@@ -4013,7 +4501,7 @@ function parseDecantrCssTokenNames(projectRoot) {
 function collectDesignTokenEvidence(projectRoot, designTokensPath) {
   const resolved = resolveOptionalPath(projectRoot, designTokensPath);
   if (!resolved) return void 0;
-  const sourceLabel = isAbsolute3(designTokensPath ?? "") ? "<design-tokens>" : designTokensPath ?? "<design-tokens>";
+  const sourceLabel = isAbsolute4(designTokensPath ?? "") ? "<design-tokens>" : designTokensPath ?? "<design-tokens>";
   if (!existsSync5(resolved)) {
     return {
       source: sourceLabel,
@@ -4361,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);
@@ -4524,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,
@@ -4609,7 +5101,7 @@ async function cmdHealth(projectRoot = process.cwd(), options = {}) {
     const format2 = resolveFormat(options);
     const payload2 = format2 === "json" ? formatDiagnosticCatalogJson() : format2 === "markdown" ? formatDiagnosticCatalogMarkdown() : formatDiagnosticCatalogText();
     if (options.output) {
-      const outputPath = isAbsolute3(options.output) ? options.output : join5(projectRoot, options.output);
+      const outputPath = isAbsolute4(options.output) ? options.output : join5(projectRoot, options.output);
       mkdirSync4(dirname3(outputPath), { recursive: true });
       writeFileSync4(outputPath, payload2, "utf-8");
       if (!options.ci) {
@@ -4664,7 +5156,7 @@ async function cmdHealth(projectRoot = process.cwd(), options = {}) {
 ` : format === "json" ? formatProjectHealthJson(report) : format === "markdown" ? formatProjectHealthMarkdown(report) : formatProjectHealthText(report);
   const payload = baselineComparison && !options.evidence && format === "text" ? `${basePayload}${formatBaselineComparisonText(baselineComparison)}` : basePayload;
   if (options.output) {
-    const outputPath = isAbsolute3(options.output) ? options.output : join5(projectRoot, options.output);
+    const outputPath = isAbsolute4(options.output) ? options.output : join5(projectRoot, options.output);
     mkdirSync4(dirname3(outputPath), { recursive: true });
     writeFileSync4(outputPath, payload, "utf-8");
     if (!options.ci) {