@akanjs/cli 3.0.0-alpha.5 → 3.0.0-alpha.6

package/.build-stamp

@@ -1 +1 @@
-a0eaadfb9b58c3aa21817d33fb8bc0ad7889c719fb293715682a39a426dc01b9
+474303da5b9e0b19ac13326096bbf0527aa6a2ed71915d1eb65c33af084338b4

package/{application.command-cgmy00gd.js → application.command-cezdnvtq.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-nx1vbtsc.js";
+} from "./index-r7nqv8qj.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";

package/{applicationBuildRunner-n1svrwgt.js → applicationBuildRunner-ha3y8ew8.js}

@@ -4,7 +4,7 @@ import {
   CsrArtifactBuilder,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-0fj4yg7k.js";
+} from "./index-qb61h0k7.js";
 import"./index-xjd3rqzj.js";
 import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";

package/buildBatch.proc.js

@@ -5,7 +5,7 @@ import {
   FontOptimizer,
   PagesBundleBuilder,
   SsrBaseArtifactBuilder
-} from "./index-0fj4yg7k.js";
+} from "./index-qb61h0k7.js";
 import"./index-xjd3rqzj.js";
 import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";

package/{capacitorApp-yyw35vg4.js → capacitorApp-jaksw4cy.js}

@@ -11,6 +11,7 @@ import {
   formatAndroidReleaseSigningError,
   formatIosRunFailureMessage,
   getAdbDeviceStateIssues,
+  getAndroidLocalServerHost,
   getMissingAndroidReleaseSigningKeys,
   isPlaceholderAppId,
   materializeCapacitorConfig,
@@ -24,7 +25,7 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-mterpj70.js";
+} from "./index-hk9rbcsz.js";
 import"./index-76rn3g2c.js";
 import"./index-47qxw1tz.js";
 import"./index-mxvakhsm.js";
@@ -44,6 +45,7 @@ export {
   materializeCapacitorConfig,
   isPlaceholderAppId,
   getMissingAndroidReleaseSigningKeys,
+  getAndroidLocalServerHost,
   getAdbDeviceStateIssues,
   formatIosRunFailureMessage,
   formatAndroidReleaseSigningError,

package/{cloud.command-1m7hfdpk.js → cloud.command-6xvsd487.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   CloudScript
-} from "./index-mn96y1nk.js";
-import"./index-p6txr1ss.js";
+} from "./index-zr2wvx69.js";
+import"./index-zbx0jheb.js";
 import"./index-meh7mmz9.js";
 import {
   GlobalConfig
 } from "./index-0cj2zxbm.js";
-import"./index-nx1vbtsc.js";
+import"./index-r7nqv8qj.js";
 import"./index-76rn3g2c.js";
 import"./index-exhpp31y.js";
 import {

package/{context.command-b5heat2a.js → context.command-ajn1b683.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ContextScript
-} from "./index-p69fcwe1.js";
+} from "./index-vkqxw0ek.js";
 import"./index-6npsfpxr.js";
 import"./index-c94nq3c1.js";
 import"./index-pfrt7qwh.js";
@@ -9,7 +9,7 @@ import"./index-60a3jfcz.js";
 import"./index-hrwzz2wf.js";
 import"./index-wrrb8rxk.js";
 import"./index-ss469dec.js";
-import"./index-mterpj70.js";
+import"./index-hk9rbcsz.js";
 import"./index-0cj2zxbm.js";
 import"./index-jn9vfpwz.js";
 import"./index-m4kpmmtj.js";

package/{index-mterpj70.js → index-hk9rbcsz.js}

@@ -514,6 +514,10 @@ function getAdbDeviceStateIssues(output) {
     return [];
   });
 }
+function getAndroidLocalServerHost(adbDevicesOutput, fallbackHost) {
+  const onlineDeviceIds = adbDevicesOutput?.split(/\r?\n/).map((line) => line.trim().split(/\s+/)).filter(([id, state]) => id && state === "device").map(([id]) => id) ?? [];
+  return onlineDeviceIds.length === 1 && onlineDeviceIds[0]?.startsWith("emulator-") ? "10.0.2.2" : fallbackHost;
+}
 var ANDROID_MIN_SDK_VERSION = 26;
 function raiseGradleMinSdkVersion(content, floor = ANDROID_MIN_SDK_VERSION) {
   const match = content.match(/minSdkVersion\s*=\s*(\d+)/);
@@ -691,7 +695,7 @@ class CapacitorApp {
   async save() {
     await this.project.commit();
   }
-  async#prepareIos({ operation, env, regenerate = false }) {
+  async#prepareIos({ operation, env, regenerate = false, iosRunTargetKind }) {
     await this.init({ platform: "ios", operation, env, regenerate });
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("ios");
@@ -700,9 +704,10 @@ class CapacitorApp {
     await this.#applyDeepLinks("ios", { operation, env });
     await this.#flushIosEntitlements();
     await this.project.commit();
+    await this.#setCodeSignEntitlementsInIosIfExists("App/App.entitlements");
     await this.#generateAssets({ operation, env });
     this.app.verbose(`syncing iOS`);
-    await this.#spawnMobile("npx", ["cap", "sync", "ios"], { operation, env });
+    await this.#spawnMobile("npx", ["cap", "sync", "ios"], { operation, env }, { iosRunTargetKind });
     this.app.verbose(`sync completed.`);
   }
   async buildIos({ env = "debug", regenerate = false } = {}) {
@@ -721,10 +726,10 @@ class CapacitorApp {
   async runIos({ operation, env, regenerate = false, noAllowProvisioningUpdates = false, iosDeviceId }) {
     if (operation === "release")
       await this.prepareWww();
-    await this.#prepareIos({ operation, env, regenerate });
     const runTarget = await this.#selectIosRunTarget(iosDeviceId);
+    await this.#prepareIos({ operation, env, regenerate, iosRunTargetKind: runTarget.kind });
     if (runTarget.kind === "simulator") {
-      await this.#spawnMobile("npx", ["cap", "run", "ios", "--target", runTarget.id], { operation, env }, { stdio: "inherit" });
+      await this.#spawnMobile("npx", ["cap", "run", "ios", "--target", runTarget.id, "--no-sync"], { operation, env }, { stdio: "inherit", platform: "ios", iosRunTargetKind: runTarget.kind });
       return;
     }
     await this.#runIosPhysicalDevice({ operation, env, runTarget, noAllowProvisioningUpdates });
@@ -800,7 +805,7 @@ ${textError instanceof Error ? textError.message : ""}`);
     noAllowProvisioningUpdates
   }) {
     const mobileEnv = sanitizeIosNativeRunEnv(await this.#commandEnv(operation, env));
-    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    const configContent = await this.#writeCapacitorConfig({ operation, platform: "ios", iosRunTargetKind: runTarget.kind }, mobileEnv);
     await this.#writeRootCapacitorConfig(configContent);
     const scheme = this.#iosScheme();
     const command = buildIosNativeRunCommand({
@@ -857,6 +862,7 @@ ${error.message}`;
     await this.#applyAndroidMinSdkVersion();
     await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("android", { operation, env });
+    await this.#disableNativeKeyboardResizeInAndroid();
     await this.project.commit();
     await this.#generateAssets({ operation, env });
     await this.#ensureAndroidAssetsDir();
@@ -916,6 +922,23 @@ ${error.message}`;
   async openAndroid() {
     await this.#spawnMobile("npx", ["cap", "open", "android"], { operation: "local", env: "local" });
   }
+  async#disableNativeKeyboardResizeInAndroid() {
+    const manifestPath = path.join(this.app.cwdPath, this.androidRootPath, "app/src/main/AndroidManifest.xml");
+    let manifest = await readFile(manifestPath, "utf8");
+    let changed = false;
+    manifest = manifest.replace(/<activity\b[^>]*android:name="\.MainActivity"[^>]*>/, (activityTag) => {
+      if (activityTag.includes("android:windowSoftInputMode=")) {
+        const nextTag = activityTag.replace(/android:windowSoftInputMode="[^"]*"/, 'android:windowSoftInputMode="adjustNothing"');
+        changed ||= nextTag !== activityTag;
+        return nextTag;
+      }
+      changed = true;
+      return activityTag.replace(/>$/, `
+            android:windowSoftInputMode="adjustNothing">`);
+    });
+    if (changed)
+      await writeFile(manifestPath, manifest);
+  }
   async#ensureAndroidAssetsDir() {
     await mkdir(path.join(this.app.cwdPath, this.androidAssetsPath), { recursive: true });
   }
@@ -1005,12 +1028,16 @@ ${error.message}`;
     return html.replace(/<\/head\s*>/i, `${script}
 </head>`);
   }
-  async#writeCapacitorConfig({ operation }, commandEnv) {
+  async#writeCapacitorConfig({
+    operation,
+    platform,
+    iosRunTargetKind
+  }, commandEnv) {
     await mkdir(this.targetRoot, { recursive: true });
     let localIp;
     if (operation === "local") {
       const override = commandEnv.AKAN_PUBLIC_CLIENT_HOST ?? process.env.AKAN_PUBLIC_CLIENT_HOST;
-      const resolution = selectLocalDevHost(os.networkInterfaces(), { override });
+      const resolution = await this.#resolveLocalDevHost({ override, platform, iosRunTargetKind });
       localIp = resolution.host;
       this.#logDevHostResolution(resolution, commandEnv);
     }
@@ -1024,9 +1051,29 @@ ${error.message}`;
     await Bun.write(path.join(this.targetRoot, "capacitor.config.json"), content);
     return content;
   }
+  async#resolveLocalDevHost({
+    override,
+    platform,
+    iosRunTargetKind
+  }) {
+    const resolution = selectLocalDevHost(os.networkInterfaces(), { override });
+    if (resolution.source === "override")
+      return resolution;
+    if (platform === "ios" && iosRunTargetKind === "simulator")
+      return { ...resolution, host: "localhost", source: "platform" };
+    if (platform === "android") {
+      try {
+        const host = getAndroidLocalServerHost(await this.#spawn("adb", ["devices"]), resolution.host);
+        return host === resolution.host ? resolution : { ...resolution, host, source: "platform" };
+      } catch {
+        return resolution;
+      }
+    }
+    return resolution;
+  }
   #logDevHostResolution(resolution, commandEnv) {
     this.app.log(`Mobile live-reload server: ${this.#localCsrUrl(resolution.host, commandEnv)}`);
-    if (resolution.source === "override")
+    if (resolution.source === "override" || resolution.source === "platform")
       return;
     const suspicious = resolution.host === "127.0.0.1" || resolution.host.startsWith("169.254.");
     const alternatives = resolution.candidates.filter((candidate) => candidate.address !== resolution.host);
@@ -1226,18 +1273,26 @@ ${error.message}`;
     return await this.app.spawn(command, args, { cwd: this.app.cwdPath, ...options });
   }
   async#spawnMobile(command, args = [], { operation, env }, options = {}) {
+    const { iosRunTargetKind, platform, ...spawnOptions } = options;
     const mobileEnv = { ...await this.#commandEnv(operation, env), ...options.env };
-    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    const configContent = await this.#writeCapacitorConfig({ operation, platform: platform ?? this.#inferMobilePlatform(args), iosRunTargetKind }, mobileEnv);
     await this.#writeRootCapacitorConfig(configContent);
     try {
       return await this.#spawn(command, args, {
-        ...options,
+        ...spawnOptions,
         env: mobileEnv
       });
     } finally {
       await this.#clearRootCapacitorConfigs();
     }
   }
+  #inferMobilePlatform(args) {
+    if (args.includes("android"))
+      return "android";
+    if (args.includes("ios"))
+      return "ios";
+    return;
+  }
   async addCamera() {
     await this.#setPermissionInIos({
       cameraUsageDescription: "$(PRODUCT_NAME) requires access to the camera to take photos.",
@@ -1339,17 +1394,31 @@ ${error.message}`;
       while (end < lines.length && !/^\s*\};\s*$/.test(lines[end] ?? ""))
         end++;
       const settings = lines.slice(start, end + 1);
-      if (settings.some((setting) => setting.includes("CODE_SIGN_ENTITLEMENTS")))
-        continue;
+      const configName = lines.slice(end + 1, end + 8).find((setting) => setting.includes("name = ")) ?? "";
       const indent = line.match(/^\s*/)?.[0] ?? "";
-      lines.splice(index, 0, `${indent}CODE_SIGN_ENTITLEMENTS = ${entitlementsRelPath};`);
-      index++;
-      changed = true;
+      const insertSettings = [];
+      if (!settings.some((setting) => setting.includes("CODE_SIGN_ENTITLEMENTS"))) {
+        insertSettings.push(`${indent}CODE_SIGN_ENTITLEMENTS = ${entitlementsRelPath};`);
+      }
+      if (configName.includes("name = Debug;") && !settings.some((setting) => setting.includes("CODE_SIGN_ALLOW_ENTITLEMENTS_MODIFICATION"))) {
+        insertSettings.push(`${indent}CODE_SIGN_ALLOW_ENTITLEMENTS_MODIFICATION = YES;`);
+      }
+      if (insertSettings.length > 0) {
+        lines.splice(index, 0, ...insertSettings);
+        index += insertSettings.length;
+        changed = true;
+      }
     }
     if (changed)
       await writeFile(pbxprojPath, lines.join(`
 `));
   }
+  async#setCodeSignEntitlementsInIosIfExists(entitlementsRelPath) {
+    const entitlementsPath = path.join(this.app.cwdPath, this.iosProjectPath, entitlementsRelPath);
+    if (!await Bun.file(entitlementsPath).exists())
+      return;
+    await this.#setCodeSignEntitlementsInIos(entitlementsRelPath);
+  }
   async#setUrlSchemesInAndroid(schemes) {
     const manifestPath = path.join(this.app.cwdPath, this.androidRootPath, "app/src/main/AndroidManifest.xml");
     let manifest = await readFile(manifestPath, "utf8");
@@ -1444,4 +1513,4 @@ ${filter}$1`);
   }
 }
 
-export { SWIFTUICORE_MIN_IOS_MAJOR, rootCapacitorConfigFilenames, rootCapacitorConfigPaths, clearRootCapacitorConfigs, writeRootCapacitorConfig, selectLocalDevHost, parseIosRuntimeMajor, sortIosRunTargets, parseDevicectlDevices, parseSimctlDevices, buildIosNativeRunCommand, classifyIosRunFailure, formatIosRunFailureMessage, sanitizeIosNativeRunEnv, PLACEHOLDER_APP_IDS, isPlaceholderAppId, getMissingAndroidReleaseSigningKeys, formatAndroidReleaseSigningError, getAdbDeviceStateIssues, ANDROID_MIN_SDK_VERSION, raiseGradleMinSdkVersion, assertJsonSerializable, materializeCapacitorConfig, CapacitorApp };
+export { SWIFTUICORE_MIN_IOS_MAJOR, rootCapacitorConfigFilenames, rootCapacitorConfigPaths, clearRootCapacitorConfigs, writeRootCapacitorConfig, selectLocalDevHost, parseIosRuntimeMajor, sortIosRunTargets, parseDevicectlDevices, parseSimctlDevices, buildIosNativeRunCommand, classifyIosRunFailure, formatIosRunFailureMessage, sanitizeIosNativeRunEnv, PLACEHOLDER_APP_IDS, isPlaceholderAppId, getMissingAndroidReleaseSigningKeys, formatAndroidReleaseSigningError, getAdbDeviceStateIssues, getAndroidLocalServerHost, ANDROID_MIN_SDK_VERSION, raiseGradleMinSdkVersion, assertJsonSerializable, materializeCapacitorConfig, CapacitorApp };

package/{index-0fj4yg7k.js → index-qb61h0k7.js}

@@ -810,10 +810,10 @@ import { compile } from "tailwindcss";
 
 // pkgs/@akanjs/devkit/frontendBuild/cssCandidateCache.ts
 import { stat } from "fs/promises";
-var CANDIDATE_RE = /-?[\w@][\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
+var CANDIDATE_RE = /-?(?:[\w@]|\[[^\]\s]+\])[\w:/.-]*(?:\[[^\]\s]+\][\w:/.-]*)*/g;
 
 class CssCandidateCache {
-  static #version = 1;
+  static #version = 3;
   #path;
   #entries = new Map;
   #dirty = false;

package/{index-nx1vbtsc.js → index-r7nqv8qj.js}

@@ -1898,9 +1898,9 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-n1svrwgt.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-ha3y8ew8.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-yyw35vg4.js")).CapacitorApp;
+var loadCapacitorApp = async () => (await import("./capacitorApp-jaksw4cy.js")).CapacitorApp;
 var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 

package/{index-p69fcwe1.js → index-vkqxw0ek.js}

@@ -16,7 +16,7 @@ import {
 } from "./index-wrrb8rxk.js";
 import {
   isPlaceholderAppId
-} from "./index-mterpj70.js";
+} from "./index-hk9rbcsz.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,

package/{index-p6txr1ss.js → index-zbx0jheb.js}

@@ -7,7 +7,7 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   openBrowser
-} from "./index-nx1vbtsc.js";
+} from "./index-r7nqv8qj.js";
 import {
   runner
 } from "./index-jkynkyfk.js";

package/{index-mn96y1nk.js → index-zr2wvx69.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CloudRunner
-} from "./index-p6txr1ss.js";
+} from "./index-zbx0jheb.js";
 import {
   PackageScript
 } from "./index-meh7mmz9.js";
@@ -12,7 +12,7 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-nx1vbtsc.js";
+} from "./index-r7nqv8qj.js";
 import {
   script
 } from "./index-jkynkyfk.js";

package/index.js

@@ -17,16 +17,16 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-3q1d6kk4.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-3ydyy991.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-b0fcx3r2.js")).AgentCommand,
-  application: async () => (await import("./application.command-cgmy00gd.js")).ApplicationCommand,
+  application: async () => (await import("./application.command-cezdnvtq.js")).ApplicationCommand,
   library: async () => (await import("./library.command-aa1g8nsa.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-kshva1ck.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-jha3sn50.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-9qv6vr9s.js")).PackageCommand,
   module: async () => (await import("./module.command-b1zzgqde.js")).ModuleCommand,
   page: async () => (await import("./page.command-k16pw244.js")).PageCommand,
-  context: async () => (await import("./context.command-b5heat2a.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-1m7hfdpk.js")).CloudCommand,
+  context: async () => (await import("./context.command-ajn1b683.js")).ContextCommand,
+  cloud: async () => (await import("./cloud.command-6xvsd487.js")).CloudCommand,
   guideline: async () => (await import("./guideline.command-9ew6aqhm.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-hs3nwzv1.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-s60dn1ae.js")).PrimitiveCommand,

package/{localRegistry.command-kshva1ck.js → localRegistry.command-jha3sn50.js}

@@ -2,14 +2,14 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-p6txr1ss.js";
+} from "./index-zbx0jheb.js";
 import {
   PackageScript
 } from "./index-meh7mmz9.js";
 import"./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-nx1vbtsc.js";
+} from "./index-r7nqv8qj.js";
 import"./index-76rn3g2c.js";
 import"./index-exhpp31y.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.5",
+  "version": "3.0.0-alpha.6",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "3.0.0-alpha.5",
+    "akanjs": "3.0.0-alpha.6",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/templates/workspaceRoot/AGENTS.md.template

@@ -262,7 +262,8 @@ final fallback when no CLI command covers the change.
 | Use `console.log()` | Biome lint forbids `console.log`. Only `console.error`, `console.info`, `console.warn` are allowed. | Use one of the three allowed console methods, or `this.logger.*` / `new Logger("ClassName")` on the server |
 | Write a `//!` marker in `ui/`, `webkit/`, `common/`, `page/**/*.tsx`, `*.constant.ts`, `*.store.ts`, or a module component file | `no-bang-comment-in-client.grit` bans it. Bun classifies `//!` and `/*!` as legal comments and keeps them through minification, so the note ships to every visitor. | `// FIXME:` in browser-reachable code; `//!` stays legal in server, `srvkit/`, and CLI files |
 | `throw new Error("...")` | `no-throw-raw-error.grit` bans raw errors outside tests, `*.constant.ts`, and `common/`. Raw errors carry no dictionary key, so they cannot be localized or toasted. | `throw new Err("task.error.<key>")` plus an `[en, ko]` entry in the module dictionary's `.error({})` |
-| Hand-order Tailwind classes, or reorder them to "fix" a diff | `useSortedClasses` is an error and also sorts the string arguments to `clsx()` and `cva()`. Sorter output like `font-bold text-2xl` looks wrong but is correct. | Write classes in any order and let `akan lint` sort them |
+| Hand-order Tailwind classes, or reorder them to "fix" a diff | `useSortedClasses` is an error and also sorts the string arguments to `cn()`. Sorter output like `font-bold text-2xl` looks wrong but is correct. | Write classes in any order and let `akan lint` sort them |
+| A colour outside the semantic vocabulary — `bg-red-500`, `bg-[#3b82f6]`, `btn-primary`, `text-base-content`, `style={{ color: "#fff" }}` | The theme closes the vocabulary, so these produce **no CSS at all** — the element renders unstyled, and without the lint rules there is no error and no warning either. Raw-palette, arbitrary-colour, daisyUI-legacy and inline-colour rules all catch this. | Semantic tokens: `bg-primary`, `text-foreground/70`, `border-border`. A genuinely fixed colour takes a `// biome-ignore lint/plugin: <reason>` |
 | `import` a third-party package inside a page, a barrel, or a module file | `no-import-external-library.grit` covers `page/**`, all barrels, and every `*.{constant,dictionary,document,service,signal,store}.ts` and `*.{Template,Unit,Util,View,Zone}.tsx`. | Re-export the symbol from a one-line shim in `base/`, `webkit/`, or `ui/` first, then import that |
 | Import server APIs (`fs`, `Bun`, `process.env`) in `ui/`, `webkit/`, or `common/` | Server-only imports in client code cause build failures. | Keep server dependencies in `lib/`, `srvkit/`, or `private/` only |
 | Skip running `akan sync` after deleting a file | Deleted files remain referenced in barrel exports, causing import errors everywhere. | Run `akan sync <name>` after every file add, remove, or rename |
@@ -421,11 +422,14 @@ is convention that keeps hand-written code reading like generated code.
   `.Template.tsx` files contain zero `useState`: forms are store-driven with `Field.*`, `value={taskForm.x}`, and
   `onChange={st.do.setXOnTask}` passed by reference.
 - Read with `st.use.*` and write with `st.do.*`. Client components do not call `fetch.*`.
-- Static class strings stay plain strings. Use `clsx` only for a conditional or to merge an incoming `className`,
-  and merge the caller last: `clsx("base", conditional, className)`. `clsx` comes from `akanjs/client`. No
-  `twMerge`, no `cn()`.
-- Use daisyUI semantic tokens with opacity modifiers (`text-base-content/60`, `bg-base-100/70`). Never `dark:` —
-  theming is the daisyUI theme block in `page/*/styles.css`.
+- Reach for a recipe before writing a look by hand: `buttonRecipe`, `badgeRecipe` and `inputRecipe` from
+  `akanjs/ui` carry the button, badge and field surfaces. Call them as `buttonRecipe(variants?, className?)` —
+  the second argument merges internally and takes an array, so never wrap it in `cn()`.
+- Static class strings stay plain strings. Reach for `cn` only for a conditional or to merge an incoming
+  `className`, and merge the caller last: `cn("base", conditional, className)`. `cn` comes from `akanjs/client`
+  and is the only class-combining function — no `clsx`, no raw `twMerge`.
+- Use semantic tokens with opacity modifiers (`text-foreground/60`, `bg-background/70`, `border-border`). Never
+  `dark:` — theming is the token block in `page/*/styles.css`, where each token has a `-foreground` pair.
 - Hoist enum→class lookups to a module-scope `as const` map typed `{ [key in cnst.TaskStatus["value"]]: string }`,
   not `Record<...>`.
 

package/templates/workspaceRoot/biome.json.template

@@ -232,6 +232,25 @@
         "**/*.Zone.tsx"
       ],
       "plugins": ["./node_modules/@akanjs/devkit/lint/no-import-external-library.grit"]
+    },
+    {
+      "includes": [
+        "apps/**/*.ts",
+        "apps/**/*.tsx",
+        "libs/**/*.ts",
+        "libs/**/*.tsx",
+        "!**/*.test.ts",
+        "!**/*.test.tsx",
+        "!**/*.spec.ts",
+        "!**/*.spec.tsx"
+      ],
+      "plugins": [
+        "./node_modules/@akanjs/devkit/lint/no-raw-palette-class.grit",
+        "./node_modules/@akanjs/devkit/lint/no-arbitrary-color.grit",
+        "./node_modules/@akanjs/devkit/lint/no-daisyui-legacy-class.grit",
+        "./node_modules/@akanjs/devkit/lint/no-inline-color.grit",
+        "./node_modules/@akanjs/devkit/lint/no-interpolated-arbitrary-class.grit"
+      ]
     }
   ]
 }

package/templates/workspaceRoot/docs/AI-DEVELOPMENT.md.template

@@ -49,8 +49,11 @@ See `docs/GENERATED.md` for the generated file list.
 
 `AGENTS.md` holds the full style guide. The rules agents break most often:
 
-- **Never hand-order Tailwind classes** — the linter sorts them, including inside `clsx()`, and its output looks
+- **Never hand-order Tailwind classes** — the linter sorts them, including inside `cn()`, and its output looks
   unnatural on purpose.
+- **Never use a colour outside the semantic vocabulary** — `bg-red-500`, `bg-[#3b82f6]` and `text-base-content`
+  compile to no CSS at all, so the element renders unstyled with no error. Use `bg-primary`, `text-foreground/70`
+  and the other tokens defined in `page/*/styles.css`.
 - **Never `throw new Error`** — throw `new Err("<module>.error.<key>")` with an `[en, ko]` entry in the module
   dictionary. `common/` cannot import `Err`, so keep throwing code out of it.
 - **Never import a third-party package** from a page, a barrel, or a module file. Re-export it through a one-line

package/{workspace.command-3q1d6kk4.js → workspace.command-3ydyy991.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ContextScript
-} from "./index-p69fcwe1.js";
+} from "./index-vkqxw0ek.js";
 import"./index-6npsfpxr.js";
 import"./index-c94nq3c1.js";
 import"./index-pfrt7qwh.js";
@@ -9,17 +9,17 @@ import"./index-60a3jfcz.js";
 import"./index-hrwzz2wf.js";
 import {
   CloudScript
-} from "./index-mn96y1nk.js";
+} from "./index-zr2wvx69.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-p6txr1ss.js";
+} from "./index-zbx0jheb.js";
 import {
   PackageScript
 } from "./index-meh7mmz9.js";
 import"./index-wrrb8rxk.js";
 import"./index-ss469dec.js";
-import"./index-mterpj70.js";
+import"./index-hk9rbcsz.js";
 import {
   GlobalConfig
 } from "./index-0cj2zxbm.js";
@@ -31,7 +31,7 @@ import"./index-m4kpmmtj.js";
 import"./index-qp089jp0.js";
 import {
   ApplicationScript
-} from "./index-nx1vbtsc.js";
+} from "./index-r7nqv8qj.js";
 import"./index-76rn3g2c.js";
 import {
   LibraryScript