@decantr/cli 3.5.3 → 3.5.5

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-KFGL6DVJ.js";
+import "./chunk-4O74E2PS.js";
 import "./chunk-SIDKK73N.js";
-import "./chunk-FE3N5MAO.js";
-import "./chunk-SUB3F5RO.js";
-import "./chunk-4WT6AVKO.js";
+import "./chunk-FIWVRMZN.js";
+import "./chunk-U62GGKUO.js";
+import "./chunk-24JR4ZNG.js";

package/dist/{chunk-4WT6AVKO.js → chunk-24JR4ZNG.js}

@@ -328,7 +328,7 @@ function scanAmbientContext(projectRoot) {
 
 // src/analyzers/routes.ts
 import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
-import { join as join2, relative as relative2 } from "path";
+import { extname as extname2, join as join2, relative as relative2 } from "path";
 var SKIP_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
 function shouldSkipDir2(name) {
   return name.startsWith("_") || name.startsWith(".") || SKIP_DIRS2.has(name);
@@ -458,6 +458,18 @@ function walkSvelteKitRoutes(dir, baseDir, segments) {
 var ROUTER_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
 var ROUTE_VARIABLE_NAMES = "(?:path|pathname|route|currentPath|currentRoute|locationPath|activePath)";
 var ROUTE_ASSET_EXTENSION_RE = /\.(?:avif|bmp|css|gif|ico|jpeg|jpg|js|json|map|mp4|pdf|png|svg|webp|woff2?)$/i;
+var JSX_ROUTE_PATH_RE = /<(?:Route|[A-Z][\w.]*Route)\b[^>]*\bpath\s*=\s*(?:"([^"]+)"|'([^']+)'|{\s*"([^"]+)"\s*}|{\s*'([^']+)'\s*}|{\s*`([^`]+)`\s*})/g;
+var OBJECT_ROUTE_PATH_RE = /\bpath\s*:\s*(?:"([^"]+)"|'([^']+)'|`([^`]+)`)/g;
+var STATIC_HTML_ENTRY_FILES = [
+  "index.html",
+  "docs/index.html",
+  "src/index.html",
+  "public/index.html",
+  "dist/index.html"
+];
+var STATIC_HTML_ROUTE_DIRS = ["demos", "examples"];
+var MAX_STATIC_HTML_ROUTES = 80;
+var MAX_STATIC_HTML_CANDIDATES = 1e3;
 function collectRouteCandidateFiles(dir, files, depth = 0) {
   if (depth > 5) return;
   let entries;
@@ -501,11 +513,13 @@ function scanReactRouter(projectRoot) {
     const relativePath = relative2(projectRoot, absolutePath);
     const pathMatches = /* @__PURE__ */ new Set();
     if (isReactRouterFile) {
-      for (const match of content.matchAll(/<Route\b[^>]*\bpath=["'`]([^"'`]+)["'`]/g)) {
-        pathMatches.add(match[1]);
+      for (const match of content.matchAll(JSX_ROUTE_PATH_RE)) {
+        const route = firstRouteLiteralMatch(match);
+        if (route) pathMatches.add(route);
       }
-      for (const match of content.matchAll(/\bpath\s*:\s*["'`]([^"'`]+)["'`]/g)) {
-        pathMatches.add(match[1]);
+      for (const match of content.matchAll(OBJECT_ROUTE_PATH_RE)) {
+        const route = firstRouteLiteralMatch(match);
+        if (route) pathMatches.add(route);
       }
     }
     for (const route of detectDeclarativeRouteSpecRoutes(content)) {
@@ -519,35 +533,110 @@ function scanReactRouter(projectRoot) {
       pathMatches.add("/");
     }
     for (const path of pathMatches) {
-      const routePath = normalizeDetectedRouteLiteral(path);
-      if (!routePath || routeMap.has(routePath)) continue;
-      routeMap.set(routePath, {
-        path: routePath,
-        file: relativePath,
-        hasLayout: false
-      });
+      for (const routePath of normalizeDetectedRouteLiterals(path)) {
+        if (routeMap.has(routePath)) continue;
+        routeMap.set(routePath, {
+          path: routePath,
+          file: relativePath,
+          hasLayout: false
+        });
+      }
     }
   }
   return [...routeMap.values()];
 }
-function normalizeDetectedRouteLiteral(value) {
-  const cleaned = value.trim().split(/[?#]/)[0];
-  if (!cleaned || cleaned === "/") return "/";
-  if (cleaned === "*" || cleaned === "**" || cleaned.startsWith("#")) return null;
-  if (!cleaned.startsWith("/") || cleaned.startsWith("//")) return null;
-  if (ROUTE_ASSET_EXTENSION_RE.test(cleaned)) return null;
-  return cleaned.replace(/\/+$/g, "") || "/";
+function firstRouteLiteralMatch(match) {
+  return match.slice(1).find((value) => typeof value === "string") ?? null;
+}
+function normalizeDetectedRouteLiterals(value) {
+  const withoutHash = value.trim().split("#")[0];
+  const cleaned = withoutHash.includes("?") && !withoutHash.endsWith(")?") ? withoutHash.split("?")[0] : withoutHash;
+  if (!cleaned || cleaned === "/") return ["/"];
+  if (cleaned === "*" || cleaned === "**" || cleaned.startsWith("#")) return [];
+  if (cleaned === "/*" || cleaned === "/**") return [];
+  if (!cleaned.startsWith("/") || cleaned.startsWith("//")) return [];
+  if (ROUTE_ASSET_EXTENSION_RE.test(cleaned)) return [];
+  const optionalGroup = cleaned.match(/^\/\(([^()]+)\)\?$/);
+  if (optionalGroup) {
+    return [
+      "/",
+      ...optionalGroup[1].split("|").map((segment) => segment.trim()).filter(Boolean).map((segment) => `/${segment}`)
+    ];
+  }
+  const withoutTrailingWildcard = cleaned.endsWith("*") && !cleaned.endsWith("/*") && !/:\w+\*$/.test(cleaned) ? cleaned.slice(0, -1) : cleaned;
+  const normalized2 = withoutTrailingWildcard.replace(/\/+$/g, "") || "/";
+  if (normalized2 === "/*" || normalized2 === "/**") return [];
+  return [normalized2];
 }
 function collectRouteLiterals(pattern, content, routes) {
   let count = 0;
   for (const match of content.matchAll(pattern)) {
-    const route = normalizeDetectedRouteLiteral(match[1] ?? "");
-    if (!route) continue;
-    routes.add(route);
-    count += 1;
+    for (const route of normalizeDetectedRouteLiterals(match[1] ?? "")) {
+      routes.add(route);
+      count += 1;
+    }
   }
   return count;
 }
+function htmlRouteFromFile(file) {
+  let withoutExt = file.slice(0, -extname2(file).length).replace(/\\/g, "/");
+  if (withoutExt.endsWith("/index")) withoutExt = withoutExt.slice(0, -"/index".length);
+  if (withoutExt === "index" || withoutExt === "docs" || withoutExt === "src" || withoutExt === "public" || withoutExt === "dist") {
+    return "/";
+  }
+  return `/${withoutExt.split("/").filter(Boolean).join("/")}` || "/";
+}
+function collectStaticHtmlFiles(dir, projectRoot, files, depth = 0) {
+  if (depth > 5 || files.length >= MAX_STATIC_HTML_CANDIDATES) return;
+  let entries;
+  try {
+    entries = readdirSync2(dir).sort();
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (files.length >= MAX_STATIC_HTML_CANDIDATES) return;
+    if (entry.startsWith(".") || entry === "node_modules") continue;
+    const fullPath = join2(dir, entry);
+    try {
+      const stat = statSync2(fullPath);
+      if (stat.isDirectory()) {
+        collectStaticHtmlFiles(fullPath, projectRoot, files, depth + 1);
+      } else if (stat.isFile() && /\.(?:html|htm)$/i.test(entry)) {
+        files.push(relative2(projectRoot, fullPath).replace(/\\/g, "/"));
+      }
+    } catch {
+    }
+  }
+}
+function staticHtmlFilePriority(file) {
+  const base = file.split("/").pop()?.toLowerCase();
+  if (base === "index.html" || base === "index.htm") return 0;
+  if (base === "default.html" || base === "default.htm") return 1;
+  return 2;
+}
+function scanStaticHtmlRoutes(projectRoot) {
+  const routes = /* @__PURE__ */ new Map();
+  for (const file of STATIC_HTML_ENTRY_FILES) {
+    if (!existsSync2(join2(projectRoot, file))) continue;
+    routes.set("/", { path: "/", file, hasLayout: false });
+    break;
+  }
+  for (const dir of STATIC_HTML_ROUTE_DIRS) {
+    const fullDir = join2(projectRoot, dir);
+    if (!existsSync2(fullDir)) continue;
+    const files = [];
+    collectStaticHtmlFiles(fullDir, projectRoot, files);
+    for (const file of files.sort(
+      (a, b) => staticHtmlFilePriority(a) - staticHtmlFilePriority(b) || a.localeCompare(b)
+    )) {
+      const routePath = htmlRouteFromFile(file);
+      if (routes.has(routePath)) continue;
+      routes.set(routePath, { path: routePath, file, hasLayout: false });
+    }
+  }
+  return [...routes.values()].slice(0, MAX_STATIC_HTML_ROUTES);
+}
 function detectPathnameBranchRoutes(content) {
   const routes = /* @__PURE__ */ new Set();
   const comparison = new RegExp(
@@ -719,6 +808,10 @@ function scanRoutes(projectRoot) {
   if (reactRouterRoutes.length > 0) {
     return { strategy: "react-router", routes: reactRouterRoutes };
   }
+  const staticHtmlRoutes = scanStaticHtmlRoutes(projectRoot);
+  if (staticHtmlRoutes.length > 0) {
+    return { strategy: "static-html", routes: staticHtmlRoutes };
+  }
   return { strategy: "none", routes: [] };
 }
 
@@ -1514,7 +1607,7 @@ function buildGuardRegistryContext(projectRoot = process.cwd()) {
 
 // src/lib/scan-interactions.ts
 import { existsSync as existsSync8, readdirSync as readdirSync6, readFileSync as readFileSync8, statSync as statSync4 } from "fs";
-import { extname as extname2, join as join8, relative as relative4 } from "path";
+import { extname as extname3, join as join8, relative as relative4 } from "path";
 import { verifyInteractionsInSource } from "@decantr/verifier";
 var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".jsx", ".ts", ".js", ".html", ".mdx"]);
 var SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
@@ -1566,7 +1659,7 @@ function walkSourceTree(rootDir) {
       const relativePath = relative4(rootDir, fullPath) || entry;
       if (s.isDirectory()) {
         walk2(fullPath);
-      } else if (s.isFile() && SCAN_EXTENSIONS.has(extname2(entry))) {
+      } else if (s.isFile() && SCAN_EXTENSIONS.has(extname3(entry))) {
         if (s.size > MAX_FILE_SIZE) continue;
         if (isNonUiInteractionSource(relativePath)) continue;
         try {

package/dist/{chunk-KFGL6DVJ.js → chunk-4O74E2PS.js}

@@ -22,7 +22,7 @@ import {
   listWorkspaceCandidates,
   listWorkspaceProjects,
   shouldFailWorkspaceHealth
-} from "./chunk-FE3N5MAO.js";
+} from "./chunk-FIWVRMZN.js";
 import {
   acceptBrownfieldLocalLaw,
   acceptStyleBridge,
@@ -52,7 +52,7 @@ import {
   writeBrownfieldCodifyProposal,
   writeHostedPatternMappingProposal,
   writeStyleBridgeProposal
-} from "./chunk-SUB3F5RO.js";
+} from "./chunk-U62GGKUO.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -69,7 +69,7 @@ import {
   sendCliCommandTelemetry,
   sendNewProjectCompletedTelemetry,
   writeDoctrineMap
-} from "./chunk-4WT6AVKO.js";
+} from "./chunk-24JR4ZNG.js";
 
 // src/index.ts
 import { existsSync as existsSync29, mkdirSync as mkdirSync16, readdirSync as readdirSync8, readFileSync as readFileSync22, writeFileSync as writeFileSync19 } from "fs";
@@ -2940,6 +2940,21 @@ var RULE_FILES = [
   ".github/copilot-instructions.md",
   ".windsurfrules"
 ];
+var STATIC_HTML_ENTRY_FILES = [
+  "index.html",
+  "docs/index.html",
+  "src/index.html",
+  "public/index.html",
+  "dist/index.html"
+];
+var STATIC_HTML_ROUTE_DIRS = ["demos", "examples"];
+function hasAnyFile(projectRoot, relPaths) {
+  return relPaths.some((relPath) => existsSync10(join12(projectRoot, relPath)));
+}
+function hasStaticHtmlSurface(projectRoot) {
+  if (hasAnyFile(projectRoot, STATIC_HTML_ENTRY_FILES)) return true;
+  return STATIC_HTML_ROUTE_DIRS.some((dir) => existsSync10(join12(projectRoot, dir, "index.html")));
+}
 function readPackageJson(dir) {
   const path = join12(dir, "package.json");
   if (!existsSync10(path)) return null;
@@ -3045,8 +3060,8 @@ function detectProject(projectRoot = process.cwd()) {
     } catch {
     }
   }
-  if (result.framework === "unknown" && !existsSync10(packageJsonPath)) {
-    if (existsSync10(join12(projectRoot, "index.html"))) {
+  if (result.framework === "unknown") {
+    if (hasStaticHtmlSurface(projectRoot)) {
       result.framework = "html";
     }
   }
@@ -4251,7 +4266,7 @@ function rel(root, path) {
   const value = relative4(root, path).replace(/\\/g, "/");
   return value || ".";
 }
-function hasAnyFile(dir, names) {
+function hasAnyFile2(dir, names) {
   for (const name of names) {
     const path = join17(dir, name);
     if (existsSync15(path)) return name;
@@ -4280,7 +4295,7 @@ function detectDesignAuthority(workspaceRoot, appRoot) {
   }
   for (const root of [appRoot, workspaceRoot]) {
     const label = root === appRoot ? "app" : "workspace";
-    const tailwind = hasAnyFile(root, [
+    const tailwind = hasAnyFile2(root, [
       "tailwind.config.js",
       "tailwind.config.ts",
       "tailwind.config.mjs",
@@ -6220,11 +6235,16 @@ function walkFiles(dir) {
   return files;
 }
 function trackedGeneratedFiles(projectRoot) {
-  return [
+  const files = [
     join24(projectRoot, "DECANTR.md"),
-    ...walkFiles(join24(projectRoot, ".decantr", "context")),
-    ...["global.css", "tokens.css", "treatments.css", "decantr-bridge.css"].map((file) => join24(projectRoot, "src", "styles", file)).filter((path) => existsSync22(path))
-  ].filter((path) => existsSync22(path));
+    ...walkFiles(join24(projectRoot, ".decantr", "context"))
+  ];
+  if (!isContractOnlyProject2(projectRoot)) {
+    files.push(
+      ...["global.css", "tokens.css", "treatments.css", "decantr-bridge.css"].map((file) => join24(projectRoot, "src", "styles", file)).filter((path) => existsSync22(path))
+    );
+  }
+  return files.filter((path) => existsSync22(path));
 }
 function snapshotGeneratedFiles(projectRoot) {
   const map = /* @__PURE__ */ new Map();
@@ -11073,7 +11093,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-RIOSZEJP.js");
+    const { cmdHealth } = await import("./health-RRIM7YAV.js");
     await cmdHealth(projectRoot, {
       browser: runBrowser,
       browserBaseUrl: baseUrl,
@@ -11147,7 +11167,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-PFUW4W65.js");
+    const { cmdWorkspace } = await import("./workspace-47XLOUGD.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -11180,7 +11200,7 @@ async function cmdVerifyWorkflow(args) {
   }
   let guardExitCode;
   if (brownfield) {
-    const { cmdHeal, collectCheckIssues } = await import("./heal-M6V2I6DB.js");
+    const { cmdHeal, collectCheckIssues } = await import("./heal-2FK63EQE.js");
     if (quietOutput) {
       const result = collectCheckIssues(workspaceInfo.appRoot, { brownfield: true });
       guardExitCode = result.issues.some((issue) => issue.type === "error") ? 1 : void 0;
@@ -11190,7 +11210,7 @@ async function cmdVerifyWorkflow(args) {
       process.exitCode = void 0;
     }
   }
-  const { cmdHealth, parseHealthArgs } = await import("./health-RIOSZEJP.js");
+  const { cmdHealth, parseHealthArgs } = await import("./health-RRIM7YAV.js");
   await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(healthArgs));
   if (localPatterns) {
     const validation = validateLocalLaw(workspaceInfo.appRoot);
@@ -12827,7 +12847,7 @@ async function main() {
           `${YELLOW13}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET17}`
         );
       }
-      const { cmdHeal } = await import("./heal-M6V2I6DB.js");
+      const { cmdHeal } = await import("./heal-2FK63EQE.js");
       const { flags } = parseLooseArgs(args);
       const workspaceInfo = resolveWorkflowProject(flags, "check");
       if (!workspaceInfo) break;
@@ -12852,7 +12872,7 @@ async function main() {
         const { flags } = parseLooseArgs(args);
         const workspaceInfo = resolveWorkflowProject(flags, "health");
         if (!workspaceInfo) break;
-        const { cmdHealth, parseHealthArgs } = await import("./health-RIOSZEJP.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-RRIM7YAV.js");
         await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(stripProjectArgs(args)));
       } catch (e) {
         console.error(error2(e.message));
@@ -12880,7 +12900,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-7JSGAGVX.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-RGXIJL3J.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error2(e.message));
@@ -12894,7 +12914,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-PFUW4W65.js");
+        const { cmdWorkspace } = await import("./workspace-47XLOUGD.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error2(e.message));

package/dist/{chunk-FE3N5MAO.js → chunk-FIWVRMZN.js}

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

package/dist/{chunk-SUB3F5RO.js → chunk-U62GGKUO.js}

@@ -3,7 +3,7 @@ import {
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-4WT6AVKO.js";
+} from "./chunk-24JR4ZNG.js";
 
 // src/commands/health.ts
 import { execFileSync as execFileSync2 } from "child_process";

package/dist/{heal-M6V2I6DB.js → heal-2FK63EQE.js}

@@ -1,7 +1,7 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-4WT6AVKO.js";
+} from "./chunk-24JR4ZNG.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-RIOSZEJP.js → health-RRIM7YAV.js}

@@ -13,8 +13,8 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-SUB3F5RO.js";
-import "./chunk-4WT6AVKO.js";
+} from "./chunk-U62GGKUO.js";
+import "./chunk-24JR4ZNG.js";
 export {
   cmdHealth,
   collectDesignTokenEvidence,

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-KFGL6DVJ.js";
+import "./chunk-4O74E2PS.js";
 import "./chunk-SIDKK73N.js";
-import "./chunk-FE3N5MAO.js";
-import "./chunk-SUB3F5RO.js";
-import "./chunk-4WT6AVKO.js";
+import "./chunk-FIWVRMZN.js";
+import "./chunk-U62GGKUO.js";
+import "./chunk-24JR4ZNG.js";

package/dist/{studio-7JSGAGVX.js → studio-RGXIJL3J.js}

@@ -1,13 +1,13 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-FE3N5MAO.js";
+} from "./chunk-FIWVRMZN.js";
 import {
   createProjectHealthReport
-} from "./chunk-SUB3F5RO.js";
+} from "./chunk-U62GGKUO.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-4WT6AVKO.js";
+} from "./chunk-24JR4ZNG.js";
 
 // src/commands/studio.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{workspace-PFUW4W65.js → workspace-47XLOUGD.js}

@@ -7,9 +7,9 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-FE3N5MAO.js";
-import "./chunk-SUB3F5RO.js";
-import "./chunk-4WT6AVKO.js";
+} from "./chunk-FIWVRMZN.js";
+import "./chunk-U62GGKUO.js";
+import "./chunk-24JR4ZNG.js";
 export {
   cmdWorkspace,
   createWorkspaceHealthReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "3.5.3",
+  "version": "3.5.5",
   "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/essence-spec": "3.4.0",
     "@decantr/core": "3.5.0",
-    "@decantr/verifier": "3.5.3",
+    "@decantr/essence-spec": "3.4.0",
     "@decantr/registry": "3.4.0",
-    "@decantr/telemetry": "3.4.0"
+    "@decantr/telemetry": "3.4.0",
+    "@decantr/verifier": "3.5.5"
   },
   "scripts": {
     "build": "tsup",