@akanjs/cli 3.0.0-alpha.11 → 3.0.0-alpha.111

package/{index-0cj2zxbm.js → index-kn1h7p1x.js}

@@ -1,13 +1,13 @@
 // @bun
-import {
-  Spinner
-} from "./index-mxvakhsm.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
+import {
+  Spinner
+} from "./index-2tv3fdx4.js";
 
 // pkgs/@akanjs/devkit/cloud/globalConfig.ts
-import { mkdir } from "fs/promises";
+import { chmod, mkdir } from "fs/promises";
 import dayjs from "dayjs";
 
 // pkgs/@akanjs/devkit/cloud/constants.ts
@@ -34,8 +34,9 @@ class GlobalConfig {
     };
   }
   static async#setAkanGlobalConfig(akanConfig) {
-    await mkdir(basePath, { recursive: true });
+    await mkdir(basePath, { recursive: true, mode: 448 });
     await Bun.write(configPath, JSON.stringify(akanConfig, null, 2));
+    await chmod(configPath, 384);
   }
   static async getHostConfig(host = GlobalConfig.akanCloudHost) {
     const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
@@ -240,7 +241,7 @@ import { ChatOpenAI } from "@langchain/openai";
 import { Logger } from "akanjs/common";
 import chalk from "chalk";
 var MAX_ASK_TRY = 300;
-var deepSeekLlmModels = ["deepseek-chat", "deepseek-reasoner"];
+var deepSeekLlmModels = ["deepseek-v4-flash", "deepseek-v4-pro"];
 var openAiLlmModels = ["gpt-5.5"];
 var supportedLlmModels = [...deepSeekLlmModels, ...openAiLlmModels];
 var isOpenAiLlmModel = (model) => openAiLlmModels.includes(model);
@@ -275,10 +276,10 @@ class AiSession {
   static #chat = null;
   static async init({ temperature = 0, useExisting = true } = {}) {
     if (useExisting) {
-      const llmConfig2 = await AiSession.getLlmConfig();
-      if (llmConfig2) {
-        AiSession.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
-        Logger.rawLog(chalk.dim(`\uD83E\uDD16akan editor uses existing LLM config (${llmConfig2.model})`));
+      const llmConfig = await AiSession.getLlmConfig();
+      if (llmConfig) {
+        AiSession.#setChatModel(llmConfig.model, llmConfig.apiKey);
+        Logger.rawLog(chalk.dim(`\uD83E\uDD16akan editor uses existing LLM config (${llmConfig.model})`));
         return AiSession;
       }
     } else

package/{index-e4b2ae6b.js → index-ktb5njgy.js}

@@ -1,38 +1,45 @@
 // @bun
 import {
-  workflowRunArtifactPath,
-  workflowSyncDir
-} from "./index-kcsa1zff.js";
-import {
-  AppExecutor,
-  LibExecutor,
-  appRootAllowedDirs,
-  appRootAllowedFiles,
   extractBlockVersion,
-  isScannedAppRootEntry,
-  readDevkitVersion
-} from "./index-yzsxc30b.js";
-import {
-  collectRecipeSources,
-  findInlineRecipeDuplicates,
-  scanRecipes
-} from "./index-xys926f2.js";
+  readDevkitVersion,
+  rootAllowedFiles,
+  rootAllowedDirs,
+  isScannedRootEntry,
+  AppExecutor,
+  LibExecutor
+} from "./index-2tv3fdx4.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
+import {
+  collectRecipeSources2,
+  scanRecipes2,
+  findInlineRecipeDuplicates2
+} from "./index-by5gpp8x.js";
+import {
+  workflowRunArtifactPath,
+  workflowSyncDir
+} from "./index-gyd220p2.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";
@@ -404,19 +411,19 @@ 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)) {
-        if (!isScannedAppRootEntry(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() ? appRootAllowedDirs.has(entry.name) : appRootAllowedFiles.has(entry.name);
+        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);
@@ -486,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 })) {
@@ -500,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(", ");
@@ -511,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])
@@ -626,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-etwh7sd3.js → index-mak3cd28.js}

@@ -1,21 +1,18 @@
 // @bun
 import {
-  AppExecutor,
+  FileSys
+} from "./index-q0y2jq9j.js";
+import {
   Executor,
+  WorkspaceExecutor,
+  AppExecutor,
   LibExecutor,
-  ModuleExecutor,
   PkgExecutor,
-  WorkspaceExecutor
-} from "./index-yzsxc30b.js";
-import {
-  getDirname
-} from "./index-1577bej2.js";
-import {
-  FileSys
-} from "./index-67546d0j.js";
+  ModuleExecutor
+} from "./index-2tv3fdx4.js";
 import {
-  __require
-} from "./index-r24hmh0q.js";
+  getDirname2
+} from "./index-6wwzs1bc.js";
 
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
 var COMMAND_META = Symbol("akan.command.meta");
@@ -54,6 +51,7 @@ var normalizePrimitiveArgType = (type) => {
   throw new Error(`Invalid primitive argument type: ${type}`);
 };
 var App = createInternalArgToken("App");
+var Apps = createInternalArgToken("Apps");
 var Lib = createInternalArgToken("Lib");
 var Sys = createInternalArgToken("Sys");
 var Exec = createInternalArgToken("Exec");
@@ -62,11 +60,29 @@ var Module = createInternalArgToken("Module");
 var Workspace = createInternalArgToken("Workspace");
 
 // pkgs/@akanjs/devkit/commandDecorators/command.ts
-import path from "path";
+import path2 from "path";
 import { Logger } from "akanjs/common";
 import chalk2 from "chalk";
 import { program } from "commander";
 
+// pkgs/@akanjs/devkit/appSelectionMemory.ts
+import path from "path";
+class AppSelectionMemory {
+  static pathIn(workspaceRoot) {
+    return path.join(workspaceRoot, "local", ".akan", "lastStart.json");
+  }
+  static async read(workspaceRoot) {
+    const stored = await Bun.file(AppSelectionMemory.pathIn(workspaceRoot)).json().catch(() => null);
+    const apps = stored?.apps;
+    return Array.isArray(apps) ? apps.filter((name) => typeof name === "string") : [];
+  }
+  static async write(workspaceRoot, apps) {
+    await FileSys.writeJson(AppSelectionMemory.pathIn(workspaceRoot), { apps }).catch(() => {
+      return;
+    });
+  }
+}
+
 // pkgs/@akanjs/devkit/commandDecorators/dependencyBuilder.ts
 var capitalize = (value) => value.slice(0, 1).toUpperCase() + value.slice(1);
 var createDependencyKey = (refName, kind) => `${refName}${capitalize(kind)}`;
@@ -264,6 +280,8 @@ var formatCommandHelp = (command, key) => {
       return "";
     if (arg.type === "Module")
       return "[sys:module]";
+    if (arg.type === "Apps")
+      return "[apps...]";
     if (arg.type === "Argument") {
       return `[${camelToKebabCase2(arg.name)}]`;
     }
@@ -290,6 +308,9 @@ var formatCommandHelp = (command, key) => {
       } else if (arg.type === "Module") {
         argName = "sys:module";
         argDesc = "Module in format: app-name:module-name or lib-name:module-name";
+      } else if (arg.type === "Apps") {
+        argName = "apps...";
+        argDesc = "App names, space- or comma-separated, or all. Omit to pick them interactively";
       } else {
         argName = arg.type.toLowerCase();
         argDesc = `${arg.type} name in this workspace`;
@@ -383,6 +404,17 @@ var prompts = async () => await import("@inquirer/prompts");
 var select = (config, context) => prompts().then((m) => m.select(config, context));
 var confirm = (config, context) => prompts().then((m) => m.confirm(config, context));
 var input = (config, context) => prompts().then((m) => m.input(config, context));
+var checkbox = (config, context) => prompts().then((m) => m.checkbox(config, context));
+var assertEnumChoice = (argMeta, value) => {
+  const enumChoices = argMeta.argsOption.enum;
+  if (!enumChoices || typeof enumChoices === "function")
+    return;
+  const choices = normalizeEnumChoices(enumChoices);
+  if (choices.some((choice) => String(choice.value) === String(value)))
+    return;
+  const label = argMeta.type === "Option" ? `option '--${camelToKebabCase3(argMeta.name)}'` : `argument '${argMeta.name}'`;
+  throw new Error(`${label} argument '${String(value)}' is invalid. Allowed choices are ${choices.map((choice) => choice.name).join(", ")}.`);
+};
 var resolveEnumChoices = async (argMeta, context) => {
   const enumChoices = argMeta.argsOption.enum;
   if (!enumChoices)
@@ -396,9 +428,10 @@ var getOptionValue = async (argMeta, opt, context) => {
     name,
     argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, example, ask }
   } = argMeta;
-  if (opt[argMeta.name] !== undefined)
+  if (opt[argMeta.name] !== undefined) {
+    assertEnumChoice(argMeta, opt[argMeta.name]);
     return convertArgValue(opt[argMeta.name], type ?? "string");
-  else if (defaultValue !== undefined)
+  } else if (defaultValue !== undefined)
     return defaultValue;
   if (enumChoices) {
     const choices = normalizeEnumChoices(await resolveEnumChoices(argMeta, context) ?? []);
@@ -424,9 +457,10 @@ var getArgumentValue = async (argMeta, value) => {
     name,
     argsOption: { default: defaultValue, type, desc, nullable, example, ask }
   } = argMeta;
-  if (value !== undefined)
+  if (value !== undefined) {
+    assertEnumChoice(argMeta, value);
     return convertArgValue(value, type ?? "string");
-  else if (defaultValue !== undefined)
+  } else if (defaultValue !== undefined)
     return defaultValue;
   else if (nullable)
     return null;
@@ -465,6 +499,31 @@ var assertCurrentDirectoryIsWorkspaceRoot = async () => {
   ].join(`
 `));
 };
+var parseAppNameList = (value) => (Array.isArray(value) ? value : value === undefined ? [] : [value]).flatMap((entry) => entry.split(",")).map((entry) => entry.trim()).filter(Boolean);
+var getAppsArgumentValue = async (value, workspace) => {
+  const appNames = await workspace.getApps();
+  if (appNames.length === 0)
+    throw new Error("No apps found in this workspace (apps/<appName>/akan.config.ts)");
+  const requested = parseAppNameList(value);
+  if (requested.includes("all"))
+    return appNames.map((name) => AppExecutor.from(workspace, name));
+  if (requested.length) {
+    const unknown = requested.filter((name) => !appNames.includes(name));
+    if (unknown.length)
+      throw new Error(`Unknown app${unknown.length > 1 ? "s" : ""}: ${unknown.join(", ")}. Available: ${appNames.join(", ")}, all`);
+    return [...new Set(requested)].map((name) => AppExecutor.from(workspace, name));
+  }
+  if (appNames.length === 1 && appNames[0])
+    return [AppExecutor.from(workspace, appNames[0])];
+  const remembered = new Set(await AppSelectionMemory.read(workspace.workspaceRoot));
+  const picked = await checkbox({
+    message: "Select the apps to run (space to toggle, enter to confirm)",
+    choices: appNames.map((name) => ({ name, value: name, checked: remembered.has(name) })),
+    required: true
+  });
+  await AppSelectionMemory.write(workspace.workspaceRoot, picked);
+  return picked.map((name) => AppExecutor.from(workspace, name));
+};
 var getInternalArgumentValue = async (argMeta, value, workspace) => {
   if (argMeta.type === "Workspace")
     return workspace;
@@ -528,36 +587,36 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     return PkgExecutor.from(workspace, pkgName);
   } else if (sysType === "module") {
     if (value) {
-      const [sysName, moduleName2] = value.split(":");
-      if (!sysName || !moduleName2)
+      const [sysName, moduleName] = value.split(":");
+      if (!sysName || !moduleName)
         throw new Error(`Invalid module name: ${value}`);
       if (appNames.includes(sysName)) {
         const app = AppExecutor.from(workspace, sysName);
-        const modules2 = await app.getModules();
-        if (modules2.includes(moduleName2))
-          return ModuleExecutor.from(app, moduleName2);
+        const modules = await app.getModules();
+        if (modules.includes(moduleName))
+          return ModuleExecutor.from(app, moduleName);
         else
-          throw new Error(`Invalid module name: ${moduleName2}`);
+          throw new Error(`Invalid module name: ${moduleName}`);
       } else if (libNames.includes(sysName)) {
         const lib = LibExecutor.from(workspace, sysName);
-        const modules2 = await lib.getModules();
-        if (modules2.includes(moduleName2))
-          return ModuleExecutor.from(lib, moduleName2);
+        const modules = await lib.getModules();
+        if (modules.includes(moduleName))
+          return ModuleExecutor.from(lib, moduleName);
       } else
         throw new Error(`Invalid system name: ${sysName}`);
     }
     const { type, name } = await select({
       message: `select the App or Lib name`,
       choices: [
-        ...appNames.map((name2) => ({ name: name2, value: { type: "app", name: name2 } })),
-        ...libNames.map((name2) => ({ name: name2, value: { type: "lib", name: name2 } }))
+        ...appNames.map((name) => ({ name, value: { type: "app", name } })),
+        ...libNames.map((name) => ({ name, value: { type: "lib", name } }))
       ]
     });
     const executor = type === "app" ? AppExecutor.from(workspace, name) : LibExecutor.from(workspace, name);
     const modules = await executor.getModules();
     const moduleName = await select({
       message: `Select the module name`,
-      choices: modules.map((name2) => ({ name: `${executor.name}:${name2}`, value: name2 }))
+      choices: modules.map((name) => ({ name: `${executor.name}:${name}`, value: name }))
     });
     return ModuleExecutor.from(executor, moduleName);
   } else
@@ -568,8 +627,8 @@ var runCommands = async (...commands) => {
     printCliError(error);
     process.exit(1);
   });
-  const __dirname2 = getDirname(import.meta.url);
-  const packageJsonCandidates = [`${path.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
+  const __dirname2 = getDirname2(import.meta.url);
+  const packageJsonCandidates = [`${path2.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
   let cliPackageJson = null;
   for (const packageJsonPath of packageJsonCandidates) {
     if (!await FileSys.fileExists(packageJsonPath))
@@ -616,6 +675,8 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
             continue;
           else if (argMeta.type === "Module") {
             programCommand = programCommand.argument(`[sys-name:module-name]`, `${argMeta.type} in this workspace (apps|libs)/<sys-name>/lib/<module-name>`);
+          } else if (argMeta.type === "Apps") {
+            programCommand = programCommand.argument(`[apps...]`, `apps in this workspace apps/<appName>, or all (space- or comma-separated; omit to pick interactively)`);
           } else {
             const sysType = argMeta.type.toLowerCase();
             programCommand = programCommand.argument(`[${sysType}]`, `${sysType} in this workspace ${sysType}s/<${sysType}Name>`);
@@ -640,10 +701,17 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
               commandArgs[argMeta.idx] = await getOptionValue(argMeta, opt, commandContext);
             else if (argMeta.type === "Argument")
               commandArgs[argMeta.idx] = await getArgumentValue(argMeta, cmdArgs[argMeta.idx]);
+            else if (argMeta.type === "Apps")
+              commandArgs[argMeta.idx] = await getAppsArgumentValue(cmdArgs[argMeta.idx], workspace);
             else
               commandArgs[argMeta.idx] = await getInternalArgumentValue(argMeta, cmdArgs[argMeta.idx], workspace);
             if (commandArgs[argMeta.idx] instanceof AppExecutor)
               process.env.AKAN_PUBLIC_APP_NAME = commandArgs[argMeta.idx].name;
+            else if (Array.isArray(commandArgs[argMeta.idx])) {
+              const apps = commandArgs[argMeta.idx];
+              if (apps.length === 1 && apps[0])
+                process.env.AKAN_PUBLIC_APP_NAME = apps[0].name;
+            }
             assignCommandContext(commandContext, argMeta, commandArgs[argMeta.idx]);
             if (opt.verbose)
               Executor.setVerbose(true);
@@ -763,4 +831,4 @@ function command(refName, depsOrBuilder, builder) {
   }
   return CommandBase;
 }
-export { getTargetMetas, getTargetCommandNames, App, Lib, Sys, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, runCommands, command };
+export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, runCommands, command };

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;

package/{index-z1s5f4e0.js → index-ne2qy0nk.js}

@@ -1,28 +1,29 @@
 // @bun
-import {
-  AkanContextAnalyzer
-} from "./index-e4b2ae6b.js";
-import {
-  Prompter
-} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-etwh7sd3.js";
+} from "./index-mak3cd28.js";
 import {
-  AGENT_BLOCK_END,
   AGENT_BLOCK_START,
-  AppExecutor,
-  LibExecutor,
+  AGENT_BLOCK_END,
+  stampBlockVersion,
   readDevkitVersion,
+  upsertAgentBlock,
   renderRecipeEntries,
-  stampBlockVersion,
-  upsertAgentBlock
-} from "./index-yzsxc30b.js";
+  CLAUDE_COMMENT_RULE,
+  AppExecutor,
+  LibExecutor
+} from "./index-2tv3fdx4.js";
 import {
-  collectRecipeSources,
-  scanRecipes
-} from "./index-xys926f2.js";
+  collectRecipeSources2,
+  scanRecipes2
+} from "./index-by5gpp8x.js";
+import {
+  AkanContextAnalyzer
+} from "./index-ktb5njgy.js";
+import {
+  Prompter
+} from "./index-h7yw2z9n.js";
 
 // pkgs/@akanjs/cli/agent/agent.script.ts
 import { Logger as Logger2 } from "akanjs/common";
@@ -76,8 +77,8 @@ Keep a sample only while you are still learning its pattern; delete it once your
 `;
 };
 var renderRecipeIndex = async (workspace) => {
-  const sources = await collectRecipeSources(`${workspace.workspaceRoot}/pkgs/akanjs/ui`, "akanjs/ui", "recipe");
-  const recipes = scanRecipes(sources);
+  const sources = await collectRecipeSources2(`${workspace.workspaceRoot}/pkgs/akanjs/ui`, "akanjs/ui", "recipe");
+  const recipes = scanRecipes2(sources);
   const scopeIndexPointer = `App and lib recipes are **not** listed here. Each app/lib carries its own generated index \u2014
 \`apps/<app>/AGENTS.md\` / \`libs/<lib>/AGENTS.md\` (\`## Recipes In Scope\`) \u2014 regenerated by \`akan sync\` and
 verified by \`akan lint\`. When working inside an app or lib, consult that file before consuming or authoring a look.`;
@@ -89,15 +90,14 @@ ${scopeIndexPointer}
 `;
   return `## Recipes
 
-Framework UI recipes (Tailwind-variant look factories), importable from every app and lib. Consume by exact name \u2014
-\`import { <name> } from "akanjs/ui"\`, then \`<name>(variants?, className?)\`. The second arg merges internally and
-takes **an array too**, so never wrap it in \`cn()\`: \`<name>({}, ["h-full", isWide && "w-full", className])\`.
-Do not guess recipe names, import paths, or variant values; the list below carries
-the full contract (\`*\` marks the default, \`key?\` is a boolean flag), so there is no need to open the recipe file to
-consume one. tsc still reports variant mistakes. **Before inlining a repeated surface (card, box,
-tile, \u2026): reuse a recipe, or add one as \`apps/<app>/ui/Recipe/<name>.ts\` (one recipe per file, re-exported from
-that folder's \`index.ts\`) \u2014 never re-implement the same look inline in several places, and never author a
-near-duplicate.** Full authoring/consumption policy: the \`recipeRule\` guideline.
+Framework UI recipes (Tailwind-variant look factories), importable from every app and lib: \`import { <name> } from
+"akanjs/ui"\`, then \`<name>(variants?, className?)\`. The second arg merges internally and takes **an array too**, so
+never wrap it in \`cn()\`: \`<name>({}, ["h-full", isWide && "w-full", className])\`. The list below is the full
+contract (\`*\` marks the default, \`key?\` is a boolean flag) \u2014 do not guess a name, path, or variant value, and do
+not open the recipe file to consume one. **Before inlining a repeated surface (card, box, tile, \u2026): reuse a recipe,
+or add one as \`apps/<app>/ui/Recipe/<name>.ts\`, one per file, re-exported from that folder's \`index.ts\` \u2014 never
+re-implement the same look inline in several places, and never author a near-duplicate.** Full policy: the
+\`recipeRule\` guideline.
 
 ${renderRecipeEntries(recipes)}
 
@@ -147,15 +147,12 @@ If generated output is stale or broken, update the owning source file and run \`
 
 ${recipeIndex}## MCP Workflow Policy
 
-- Prefer Akan MCP workflows before direct source edits.
-- Direct source edits are denied when an allowlisted Akan workflow or repair tool can perform the change.
-- Use \`akan mcp --mode plan\` to inspect \`list_workflows\`, \`explain_workflow\`, and \`plan_workflow\`.
-- If \`plan_workflow\` returns \`planPath\` or \`next.tool=apply_workflow\`, call \`apply_workflow({ planPath })\` before editing source files directly.
-- Use \`akan mcp --mode apply\` only for allowlisted \`apply_workflow\`, \`run_validation\`, and repair tools.
-- After \`apply_workflow\`, run \`run_validation\` with \`validationTarget\` when present; otherwise use \`applyReportPath\`.
-- If no workflow exists, or apply reports unsupported/no-op/failed diagnostics that require manual action, keep edits scoped to owning source files and never patch generated files directly.
-- For compound requests, split the request into workflows and apply each \`planPath\` in order, such as \`create-module\` followed by \`add-field\`.
-- **CLI-only fallback (MCP not connected):** \`akan mcp\` starts a stdio MCP server, so the \`list_workflows\`/\`plan_workflow\`/\`apply_workflow\` tools exist only when your agent is wired to it as an MCP client. When they are unavailable, the CLI is a first-class equivalent: \`akan workflow list\` / \`explain <name>\` / \`plan <name> ... --format json --out <planPath>\` / \`apply <planPath> --format json\`, \`akan doctor --strict --format json\` for validation, and \`akan repair generated|imports|module-shape --app <app> --format json\` for repairs. Scaffolding primitives (\`create-module\`/\`create-scalar\`/\`create-service\` take the target app/lib as a POSITIONAL arg; \`add-field\`/\`add-enum-field\` use \`--app\`/\`--module\` flags) call the same code the workflows do.
+- **Prefer an Akan workflow to a direct source edit.** A direct edit is denied when an allowlisted workflow or repair tool can make the change.
+- Inspect with \`akan mcp --mode plan\` (\`list_workflows\`, \`explain_workflow\`, \`plan_workflow\`); apply with \`akan mcp --mode apply\`, which allowlists \`apply_workflow\`, \`run_validation\`, and the repair tools.
+- If \`plan_workflow\` returns \`planPath\` or \`next.tool=apply_workflow\`, call \`apply_workflow({ planPath })\` before editing source. Then run \`run_validation\` with \`validationTarget\` when present, otherwise \`applyReportPath\`.
+- Split a compound request into workflows and apply each \`planPath\` in order, such as \`create-module\` followed by \`add-field\`.
+- When no workflow exists, or apply reports unsupported/no-op/failed diagnostics needing manual action, keep edits scoped to owning source files and never patch generated files directly.
+- **MCP not connected?** The CLI is a first-class equivalent \u2014 \`akan workflow list\` / \`explain\` / \`plan\` / \`apply\`, \`akan doctor\`, \`akan repair\`. See the onboarding guide's CLI-only fallback for the exact flags.
 
 ## Validation
 
@@ -199,6 +196,8 @@ var renderClaudeMd = async (workspace) => {
   return `# ${context.repoName} \u2014 Claude Code Guide
 
 @AGENTS.md
+
+${CLAUDE_COMMENT_RULE}
 `;
 };
 var renderCursorRule = () => `---
@@ -246,7 +245,7 @@ class AgentRunner extends runner("agent") {
         written.push(`${exec.type}s/${exec.name}/AGENTS.md`);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        Logger.rawLog(`Skipped ${exec.type}s/${exec.name}/AGENTS.md (${message})`, undefined, "warn");
+        Logger.rawLog(`Skipped ${exec.type}s/${exec.name}/AGENTS.md (${message})`, undefined, "error");
       }
     };
     for (const name of libNames)

package/{index-65aeh789.js → index-pnqbkf5p.js}

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

package/{index-67546d0j.js → index-q0y2jq9j.js}

@@ -1,6 +1,6 @@
 // @bun
 // pkgs/@akanjs/devkit/fileSys.ts
-import { lstat, stat } from "fs/promises";
+import { lstat, rename, rm, stat } from "fs/promises";
 import { Logger } from "akanjs/common";
 
 class FileSys {
@@ -9,7 +9,7 @@ class FileSys {
     return await Bun.file(path).exists();
   }
   static async dirExists(path) {
-    return await stat(path).then((stat2) => stat2.isDirectory()).catch(() => false);
+    return await stat(path).then((stat) => stat.isDirectory()).catch(() => false);
   }
   static async exists(path) {
     return await stat(path).then(() => true).catch(() => false);
@@ -34,6 +34,18 @@ class FileSys {
   static async writeText(path, content) {
     return await Bun.file(path).write(content);
   }
+  static async writeTextAtomic(filePath, content) {
+    const temp = `${filePath}.${process.pid}.${Date.now().toString(36)}.tmp`;
+    try {
+      await Bun.write(temp, content);
+      await rename(temp, filePath);
+    } catch (error) {
+      await rm(temp, { force: true }).catch(() => {
+        return;
+      });
+      throw error;
+    }
+  }
   static async writeJson(path, content) {
     return await Bun.file(path).write(`${JSON.stringify(content, null, 2)}
 `);