@akanjs/cli 3.0.0-alpha.1 → 3.0.0-alpha.100

package/{index-a00jg8x8.js → index-gtmz74tj.js}

@@ -1,33 +1,45 @@
 // @bun
 import {
-  workflowRunArtifactPath,
-  workflowSyncDir
-} from "./index-rzwcpcc3.js";
-import {
+  extractBlockVersion,
+  readDevkitVersion,
+  rootAllowedFiles,
+  rootAllowedDirs,
+  isScannedRootEntry,
   AppExecutor,
   LibExecutor
-} from "./index-hgna5rjy.js";
-import {
-  collectRecipeSources,
-  findInlineRecipeDuplicates,
-  scanRecipes
-} from "./index-xys926f2.js";
+} from "./index-qsq3q8fy.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
+import {
+  collectRecipeSources2,
+  scanRecipes2,
+  findInlineRecipeDuplicates2
+} from "./index-by5gpp8x.js";
+import {
+  workflowRunArtifactPath,
+  workflowSyncDir
+} from "./index-fc1bh0a7.js";
 
 // pkgs/@akanjs/devkit/akanContext.ts
 import { readdir } from "fs/promises";
 import path from "path";
 import { capitalize } from "akanjs/common";
-var resourceList = [
+var guidelineResourceUri = (name) => `akan://guidelines/${name}`;
+var staticResourceList = [
   { uri: "akan://docs/framework", name: "Akan framework guide", mimeType: "text/markdown" },
-  { uri: "akan://guidelines/framework", name: "Framework guideline", mimeType: "text/markdown" },
-  { uri: "akan://guidelines/modelSignal", name: "Model signal guideline", mimeType: "text/markdown" },
   { uri: "akan://workspace/summary", name: "Workspace summary", mimeType: "application/json" },
   { uri: "akan://workspace/apps", name: "Workspace apps", mimeType: "application/json" },
   { uri: "akan://workspace/modules", name: "Workspace modules", mimeType: "application/json" }
 ];
+var buildResourceList = (guidelineNames) => [
+  ...staticResourceList,
+  ...guidelineNames.map((name) => ({
+    uri: guidelineResourceUri(name),
+    name: `${name} guideline`,
+    mimeType: "text/markdown"
+  }))
+];
 var cursorMcpConfigPath = ".cursor/mcp.json";
 var claudeMcpConfigPath = ".mcp.json";
 var codexMcpConfigPath = ".codex/config.toml";
@@ -121,7 +133,9 @@ var validationCommands = [
   "akan typecheck <app-name>",
   "akan test <app-or-lib-or-pkg>",
   "akan build <app-name>",
-  "akan doctor --strict --format json"
+  "akan doctor --strict --format json",
+  "akan quality scan [--format json]",
+  "akan quality ssr [--format json]"
 ];
 var unknownGeneratedFilesFreshness = {
   status: "unknown",
@@ -150,33 +164,6 @@ var moduleShapeFiles = (module) => {
   ];
 };
 var constantFieldNames = (content) => [...content.matchAll(/\b([A-Za-z_$][\w$]*)\s*:\s*field\(/g)].map((match) => match[1]).filter(Boolean);
-var appRootAllowFiles = new Set([
-  "AGENTS.md",
-  "CLAUDE.md",
-  "akan.app.json",
-  "akan.config.ts",
-  "capacitor.config.ts",
-  "client.ts",
-  "main.ts",
-  "package.json",
-  "server.ts",
-  "tsconfig.json"
-]);
-var appRootAllowDirs = new Set([
-  ".akan",
-  "android",
-  "common",
-  "env",
-  "ios",
-  "lib",
-  "page",
-  "private",
-  "public",
-  "script",
-  "srvkit",
-  "ui",
-  "webkit"
-]);
 var safeReadDir = async (dirPath) => {
   try {
     return (await readdir(dirPath, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
@@ -389,6 +376,29 @@ class AkanContextAnalyzer {
       validationCommands
     };
   }
+  static async#agentGuideDrift(workspace) {
+    const installed = await readDevkitVersion();
+    if (!installed)
+      return null;
+    const content = await safeReadText(path.join(workspace.workspaceRoot, "AGENTS.md"));
+    if (content === null)
+      return null;
+    const stamped = extractBlockVersion(content);
+    if (stamped === installed)
+      return null;
+    const hint = "Re-render the AGENTS.md managed block from the installed framework release.";
+    if (!stamped)
+      return {
+        code: "agent-guide-unstamped",
+        message: `AGENTS.md carries no generated-version stamp, so its conventions may predate @akanjs/devkit ${installed}`,
+        hint
+      };
+    return {
+      code: "agent-guide-stale",
+      message: `AGENTS.md was generated by @akanjs/devkit ${stamped}, but ${installed} is installed`,
+      hint
+    };
+  }
   static async doctor(workspace, {
     strict = false,
     runIdOrPlan = null,
@@ -401,23 +411,37 @@ class AkanContextAnalyzer {
       repairAction("generated", "akan repair generated --app <app-or-lib>", "Refresh generated Akan files.", true),
       repairAction("format", "akan repair format --target <app-or-lib-or-pkg>", "Run the formatter/linter repair path.", true)
     ];
-    for (const app of context.apps) {
-      const appPath = path.join(workspace.workspaceRoot, app.path);
-      for (const entry of await safeReadDir(appPath)) {
-        const allowed = entry.isDirectory() ? appRootAllowDirs.has(entry.name) : appRootAllowFiles.has(entry.name);
+    for (const sys of [...context.apps, ...context.libs]) {
+      const sysPath = path.join(workspace.workspaceRoot, sys.path);
+      for (const entry of await safeReadDir(sysPath)) {
+        if (!isScannedRootEntry(sys.type, entry.name))
+          continue;
+        const allowed = entry.isDirectory() ? rootAllowedDirs[sys.type].has(entry.name) : rootAllowedFiles[sys.type].has(entry.name);
         if (!allowed) {
-          const action = repairAction("module-shape", `akan repair module-shape --app ${app.name}`, "Review app root shape and remove or move the unknown entry.", false);
+          const action = repairAction("module-shape", `akan repair module-shape --app ${sys.name}`, `Review ${sys.type} root shape and remove or move the unknown entry.`, false);
           diagnostics.push({
             severity: "error",
-            code: "app-root-unknown-entry",
-            path: `${app.path}/${entry.name}`,
-            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in app root: ${app.path}/${entry.name}`,
+            code: `${sys.type}-root-unknown-entry`,
+            path: `${sys.path}/${entry.name}`,
+            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in ${sys.type} root: ${sys.path}/${entry.name}`,
             repairActions: [action]
           });
           repairActions.push(action);
         }
       }
     }
+    const agentDrift = await AkanContextAnalyzer.#agentGuideDrift(workspace);
+    if (agentDrift) {
+      const action = repairAction("generated", "akan agent install agents-md", agentDrift.hint, true);
+      diagnostics.push({
+        severity: "warning",
+        code: agentDrift.code,
+        path: "AGENTS.md",
+        message: agentDrift.message,
+        repairActions: [action]
+      });
+      repairActions.push(action);
+    }
     for (const sys of [...context.apps, ...context.libs]) {
       for (const module of sys.modules) {
         if (!module.abstract.exists) {
@@ -469,10 +493,10 @@ class AkanContextAnalyzer {
       }
     }
     for (const sys of [...context.apps, ...context.libs]) {
-      const sources = await collectRecipeSources(path.join(workspace.workspaceRoot, sys.path, "ui"), "ui");
+      const sources = await collectRecipeSources2(path.join(workspace.workspaceRoot, sys.path, "ui"), "ui");
       if (sources.length === 0)
         continue;
-      const recipes = scanRecipes(sources);
+      const recipes = scanRecipes2(sources);
       const files = [];
       const glob = new Bun.Glob("**/*.tsx");
       for await (const abs of glob.scan({ cwd: path.join(workspace.workspaceRoot, sys.path), absolute: true })) {
@@ -483,7 +507,7 @@ class AkanContextAnalyzer {
           content: await Bun.file(abs).text().catch(() => "")
         });
       }
-      const duplicates = findInlineRecipeDuplicates(recipes, files);
+      const duplicates = findInlineRecipeDuplicates2(recipes, files);
       if (duplicates.length === 0)
         continue;
       const preview = duplicates.slice(0, 3).map((duplicate) => `${path.relative(workspace.workspaceRoot, duplicate.path)}:${duplicate.line}`).join(", ");
@@ -494,7 +518,7 @@ class AkanContextAnalyzer {
         message: `${sys.name}: ${duplicates.length} inline className(s) re-author a recipe fingerprint (${preview}${duplicates.length > 3 ? ", \u2026" : ""}) \u2014 consume the recipe instead.`
       });
     }
-    const scanNames = async (uiDirPath, basename) => new Set(scanRecipes(await collectRecipeSources(uiDirPath, "ui", basename)).map((info) => info.name));
+    const scanNames = async (uiDirPath, basename) => new Set(scanRecipes2(await collectRecipeSources2(uiDirPath, "ui", basename)).map((info) => info.name));
     const declaredByImport = new Map;
     declaredByImport.set("akanjs/ui", await scanNames(path.join(workspace.workspaceRoot, "pkgs/akanjs/ui"), "recipe"));
     for (const sys of [...context.apps, ...context.libs])
@@ -609,4 +633,4 @@ class AkanContextAnalyzer {
   }
 }
 
-export { resourceList, codexMcpConfigPath, akanMcpInstallTargets, akanMcpInstallConfigPaths, createAkanMcpServer, createAkanCodexMcpServerBlock, upsertCodexMcpServerBlock, renderDoctorText, AkanContextAnalyzer };
+export { buildResourceList, codexMcpConfigPath, akanMcpInstallTargets, akanMcpInstallConfigPaths, createAkanMcpServer, createAkanCodexMcpServerBlock, upsertCodexMcpServerBlock, renderDoctorText, AkanContextAnalyzer };

package/{index-tdbas9r0.js → index-h7yw2z9n.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
-  getDirname
-} from "./index-hgna5rjy.js";
+  getDirname2
+} from "./index-6wwzs1bc.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";
 import { input, select } from "@inquirer/prompts";
 class Prompter {
   static async#getGuidelineRoot() {
-    const dirname = getDirname(import.meta.url);
+    const dirname = getDirname2(import.meta.url);
     const candidates = [`${dirname}/guidelines`, `${dirname}/../cli/guidelines`];
     for (const candidate of candidates) {
       try {
@@ -19,7 +19,6 @@ class Prompter {
     return candidates[0];
   }
   static async selectGuideline() {
-    const guidelineRoot = await Prompter.#getGuidelineRoot();
     const guideNames = await Prompter.listGuidelines();
     return await select({
       message: "Select a guideline",
@@ -37,10 +36,11 @@ class Prompter {
     return JSON.parse(guideJson);
   }
   static async getInstruction(guideName) {
+    const guideNames = await Prompter.listGuidelines();
+    if (!guideNames.includes(guideName))
+      throw new Error(`Unknown guideline "${guideName}". Available: ${guideNames.join(", ")}`);
     const guidelineRoot = await Prompter.#getGuidelineRoot();
-    const filePath = `${guidelineRoot}/${guideName}/${guideName}.instruction.md`;
-    const content = await fsPromise.readFile(filePath, "utf-8");
-    return content;
+    return await fsPromise.readFile(`${guidelineRoot}/${guideName}/${guideName}.instruction.md`, "utf-8");
   }
   static async getUpdateRequest(guideName) {
     return await input({

package/{index-bjpxzr6s.js → index-hwkygn9s.js}

@@ -422,7 +422,7 @@ class HmrWatcher {
     this.#unreportedChanges += unreported;
     if (!this.#reportedCompensating) {
       this.#reportedCompensating = true;
-      this.#logger.info(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
+      this.#logger.verbose(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
     }
     this.#logger.verbose(`[hmr] mtime scan found ${unreported} change(s) fs.watch never reported (${this.#unreportedChanges} total)`);
   }
@@ -463,6 +463,7 @@ class HmrWatcher {
 
 // pkgs/@akanjs/devkit/frontendBuild/watchRootResolver.ts
 import fs2 from "fs";
+import { readFile } from "fs/promises";
 import path4 from "path";
 
 class WatchRootResolver {
@@ -472,6 +473,10 @@ class WatchRootResolver {
   }
   async resolve() {
     const tsconfig = await this.#app.getTsConfig();
+    const appDir = path4.resolve(this.#app.cwdPath);
+    const appsContainer = path4.dirname(appDir);
+    const libsContainer = path4.resolve(this.#app.workspace.workspaceRoot, "libs");
+    const libRoots = await this.#resolveLibRoots(libsContainer);
     const set = new Set;
     set.add(path4.resolve(`${this.#app.cwdPath}/page`));
     for (const targets of Object.values(tsconfig.compilerOptions.paths ?? {})) {
@@ -482,12 +487,55 @@ class WatchRootResolver {
           continue;
         const cleaned = target.replace(/\/?\*+.*$/, "").replace(/\/[^/]+\.[^/]+$/, "");
         const resolved = path4.resolve(this.#app.workspace.workspaceRoot, cleaned);
-        if (fs2.existsSync(resolved))
-          set.add(resolved);
+        if (resolved === libsContainer && libRoots) {
+          for (const root of libRoots)
+            set.add(root);
+          continue;
+        }
+        const root = resolved === appsContainer ? appDir : resolved;
+        if (fs2.existsSync(root))
+          set.add(root);
       }
     }
     return [...set];
   }
+  async#resolveLibRoots(libsContainer) {
+    const libDeps = await this.#resolveLibDeps(libsContainer);
+    if (!libDeps)
+      return null;
+    return libDeps.map((name) => path4.join(libsContainer, name)).filter((dir) => fs2.existsSync(dir));
+  }
+  async#resolveLibDeps(libsContainer) {
+    const scanInfo = this.#app.getScanInfo({ allowEmpty: true });
+    if (scanInfo?.type === "app")
+      return scanInfo.libDeps;
+    const direct = await WatchRootResolver.#readManifestLibDeps(path4.join(this.#app.cwdPath, "akan.app.json"));
+    if (!direct)
+      return null;
+    const closure = new Set;
+    const queue = [...direct];
+    while (queue.length > 0) {
+      const name = queue.shift();
+      if (!name || closure.has(name))
+        continue;
+      closure.add(name);
+      const nested = await WatchRootResolver.#readManifestLibDeps(path4.join(libsContainer, name, "akan.lib.json"));
+      if (!nested)
+        return null;
+      queue.push(...nested);
+    }
+    return [...closure];
+  }
+  static async#readManifestLibDeps(manifestPath) {
+    try {
+      const parsed = JSON.parse(await readFile(manifestPath, "utf8"));
+      if (!Array.isArray(parsed.libDeps))
+        return null;
+      return parsed.libDeps.filter((name) => typeof name === "string" && name.length > 0);
+    } catch {
+      return null;
+    }
+  }
 }
 
 export { HmrWatcher, WatchRootResolver };

package/{index-bbkek1bp.js → index-hyywke0f.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-znynzt5w.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-46tjzh6s.js → index-kcxmv48c.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
 
 // pkgs/@akanjs/devkit/dependencyScanner.ts
 import { builtinModules } from "module";
@@ -9,39 +9,41 @@ import * as path from "path";
 import ignore from "ignore";
 import ts from "typescript";
 var testFileRegex = /\.(?:test|spec)\.[cm]?[tj]sx?$/;
+var skipDirs = ["node_modules", "dist", "build", ".git", ".next", "public", "ios", "android", "__fixtures__"];
+var isSkippedPath = (filePath) => skipDirs.some((dir) => filePath.includes(`/${dir}/`) || filePath.startsWith(`${dir}/`));
 var builtinModuleSet = new Set([...builtinModules, ...builtinModules.map((mod) => `node:${mod}`)]);
 var stripShebang = (source) => source.replace(/^#!.*(?:\r?\n|$)/, "");
 
-class TypeScriptDependencyScanner {
+class TypeScriptDependencyScanner2 {
   #fileDependencies = new Map;
   #fileRuntimeDependencies = new Map;
   #fileTypeDependencies = new Map;
   #visitedFiles = new Set;
   #tsTranspiler = new Bun.Transpiler({ loader: "ts" });
   #tsxTranspiler = new Bun.Transpiler({ loader: "tsx" });
-  directory;
-  rootPackageJson;
-  ig;
-  workspaceRoot;
+  #directory;
+  #rootPackageJson;
+  #ig;
+  #workspaceRoot;
   constructor(directory, {
     workspaceRoot,
     rootPackageJson,
     gitignorePatterns = []
   }) {
-    this.directory = directory;
-    this.rootPackageJson = rootPackageJson;
-    this.ig = ignore().add(gitignorePatterns);
-    this.workspaceRoot = workspaceRoot;
+    this.#directory = directory;
+    this.#rootPackageJson = rootPackageJson;
+    this.#ig = ignore().add(gitignorePatterns);
+    this.#workspaceRoot = workspaceRoot;
   }
   async getMonorepoDependencies(projectName, { pkgs = [], libs = [] } = {}) {
-    const npmSet = new Set(Object.keys({ ...this.rootPackageJson.dependencies, ...this.rootPackageJson.devDependencies }));
+    const npmSet = new Set(Object.keys({ ...this.#rootPackageJson.dependencies, ...this.#rootPackageJson.devDependencies }));
     const pkgPathSet = new Set(pkgs);
     const libPathSet = new Set(libs.map((lib) => `@libs/${lib}`));
     await this.getDependencies();
     const [npmDepSet, pkgPathDepSet, libPathDepSet] = this.#getImportSetsFromDependencies([npmSet, pkgPathSet, libPathSet], this.#fileRuntimeDependencies);
     const [npmDevDepSet] = this.#getImportSetsFromDependencies([npmSet], this.#fileTypeDependencies);
     const pkgDeps = [...pkgPathDepSet];
-    const libDeps = [...libPathDepSet].map((path2) => path2.replace("@libs/", "")).filter((libName) => libName !== projectName);
+    const libDeps = [...libPathDepSet].map((path) => path.replace("@libs/", "")).filter((libName) => libName !== projectName);
     return {
       pkgDeps,
       libDeps,
@@ -52,11 +54,11 @@ class TypeScriptDependencyScanner {
   async getPackageBuildDependencies(projectName) {
     const runtimeDeps = new Set;
     const devDeps = new Set;
-    const sourceFiles = await this.#findTypeScriptFiles(this.directory, {
+    const sourceFiles = await this.#findTypeScriptFiles(this.#directory, {
       excludeBuildFiles: true,
       excludeTestFiles: true
     });
-    const cssFiles = await this.#findCssFiles(this.directory);
+    const cssFiles = await this.#findCssFiles(this.#directory);
     for (const filePath of sourceFiles) {
       const fileContent = await FileSys.readText(filePath);
       const { imports, typeImports } = this.#extractImports(fileContent, filePath);
@@ -67,7 +69,7 @@ class TypeScriptDependencyScanner {
       const fileContent = await FileSys.readText(filePath);
       this.#addNormalizedImports(runtimeDeps, this.#extractCssPluginImports(fileContent), projectName);
     }
-    const buildFilePath = path.join(this.directory, "build.ts");
+    const buildFilePath = path.join(this.#directory, "build.ts");
     if (await FileSys.fileExists(buildFilePath)) {
       const fileContent = await FileSys.readText(buildFilePath);
       const { imports, typeImports } = this.#extractImports(fileContent, buildFilePath);
@@ -75,7 +77,7 @@ class TypeScriptDependencyScanner {
     }
     for (const dep of runtimeDeps)
       devDeps.delete(dep);
-    const rootDeps = { ...this.rootPackageJson.dependencies, ...this.rootPackageJson.devDependencies };
+    const rootDeps = { ...this.#rootPackageJson.dependencies, ...this.#rootPackageJson.devDependencies };
     const missingDeps = [];
     for (const dep of [...runtimeDeps, ...devDeps]) {
       if (rootDeps[dep] || await this.#hasWorkspacePackage(dep))
@@ -89,7 +91,7 @@ class TypeScriptDependencyScanner {
     };
   }
   async#hasWorkspacePackage(dep) {
-    const packageJsonPath = path.join(this.workspaceRoot, "pkgs", dep, "package.json");
+    const packageJsonPath = path.join(this.#workspaceRoot, "pkgs", dep, "package.json");
     if (!await Bun.file(packageJsonPath).exists())
       return false;
     try {
@@ -132,9 +134,9 @@ class TypeScriptDependencyScanner {
     this.#fileRuntimeDependencies.clear();
     this.#fileTypeDependencies.clear();
     this.#visitedFiles.clear();
-    const files = await this.#findTypeScriptFiles(this.directory);
+    const files = await this.#findTypeScriptFiles(this.#directory);
     for (const file of files)
-      await this.#analyzeFile(file, this.directory);
+      await this.#analyzeFile(file, this.#directory);
     return this.#fileDependencies;
   }
   async#findTypeScriptFiles(directory, {
@@ -142,18 +144,17 @@ class TypeScriptDependencyScanner {
     excludeTestFiles = false
   } = {}) {
     const files = [];
-    const skipDirs = ["node_modules", "dist", "build", ".git", ".next", "public", "ios", "android"];
     const glob = new Bun.Glob("**/*.{ts,tsx}");
     for await (const filePath of glob.scan({ cwd: directory, onlyFiles: true })) {
-      if (skipDirs.some((dir) => filePath.includes(`/${dir}/`) || filePath.startsWith(`${dir}/`)))
+      if (isSkippedPath(filePath))
         continue;
       if (excludeBuildFiles && filePath === "build.ts")
         continue;
       if (excludeTestFiles && testFileRegex.test(filePath))
         continue;
       const fullPath = path.join(directory, filePath);
-      const relativePath = path.relative(this.workspaceRoot, fullPath);
-      if (this.ig.ignores(relativePath))
+      const relativePath = path.relative(this.#workspaceRoot, fullPath);
+      if (this.#ig.ignores(relativePath))
         continue;
       files.push(fullPath);
     }
@@ -161,14 +162,13 @@ class TypeScriptDependencyScanner {
   }
   async#findCssFiles(directory) {
     const files = [];
-    const skipDirs = ["node_modules", "dist", "build", ".git", ".next", "public", "ios", "android"];
     const glob = new Bun.Glob("**/*.css");
     for await (const filePath of glob.scan({ cwd: directory, onlyFiles: true })) {
-      if (skipDirs.some((dir) => filePath.includes(`/${dir}/`) || filePath.startsWith(`${dir}/`)))
+      if (isSkippedPath(filePath))
         continue;
       const fullPath = path.join(directory, filePath);
-      const relativePath = path.relative(this.workspaceRoot, fullPath);
-      if (this.ig.ignores(relativePath))
+      const relativePath = path.relative(this.#workspaceRoot, fullPath);
+      if (this.#ig.ignores(relativePath))
         continue;
       files.push(fullPath);
     }
@@ -289,7 +289,7 @@ class TypeScriptDependencyScanner {
       exec.workspace.getPackageJson(),
       exec.workspace.getGitignorePatterns()
     ]);
-    return new TypeScriptDependencyScanner(exec.cwdPath, {
+    return new TypeScriptDependencyScanner2(exec.cwdPath, {
       workspaceRoot: exec.workspace.cwdPath,
       tsconfig,
       rootPackageJson,
@@ -298,4 +298,4 @@ class TypeScriptDependencyScanner {
   }
 }
 
-export { TypeScriptDependencyScanner };
+export { TypeScriptDependencyScanner2 };

package/{index-xjd3rqzj.js → index-n68jx79w.js}

@@ -1,20 +1,11 @@
 // @bun
 // pkgs/@akanjs/devkit/frontendBuild/styleContract.ts
-var countBlocking = (v) => v.style.filter((s) => s.severity === "error").length + v.theme.length;
-var formatStyleContract = (v) => {
-  const lines = [];
-  for (const s of v.style) {
-    lines.push(`  [${s.severity}] ${s.rule}  ${s.path}:${s.line}`);
-    lines.push(`      ${s.snippet}`);
-    lines.push(`      \u2192 ${s.suggestion}`);
-  }
-  for (const t of v.theme) {
-    lines.push(`  [error] contrast  ${t.scope}  ${t.pair} = ${t.ratio}:1 (min ${t.threshold}:1)`);
-    lines.push(`      \u2192 ${t.suggestion}`);
-  }
-  return lines.join(`
+var countBlocking = (violations) => violations.theme.length;
+var formatStyleContract = (violations) => violations.theme.flatMap((theme) => [
+  `  [error] contrast  ${theme.scope}  ${theme.pair} = ${theme.ratio}:1 (min ${theme.threshold}:1)`,
+  `      \u2192 ${theme.suggestion}`
+]).join(`
 `);
-};
 
 // pkgs/@akanjs/devkit/frontendBuild/themeValidator.ts
 var PAIRS = [
@@ -66,7 +57,7 @@ class ThemeValidator {
         foreground: front,
         ratio: Math.round(ratio * 100) / 100,
         threshold,
-        suggestion: `${scope}\uC758 --${base}(${bg})\uC640 --${fg}(${front}) \uB300\uBE44\uAC00 ${ratio.toFixed(2)}:1 \uB85C \uCD5C\uC18C ${threshold}:1 \uBBF8\uB9CC\uC785\uB2C8\uB2E4. \uD55C\uCABD\uC744 \uB354 \uBC1D\uAC8C/\uC5B4\uB461\uAC8C \uC870\uC815\uD574 \uB300\uBE44\uB97C \uD655\uBCF4\uD558\uC138\uC694.`
+        suggestion: `In ${scope}, --${base} (${bg}) against --${fg} (${front}) is ${ratio.toFixed(2)}:1, under the ${threshold}:1 minimum. Lighten or darken one of them until it clears.`
       });
     }
     return violations;