@akanjs/cli 3.0.0-alpha.8 → 3.0.0-alpha.81

package/{workspace.command-wa10mfd9.js → workspace.command-4ztb4fdh.js}

@@ -1,87 +1,84 @@
 // @bun
 import {
-  ContextScript
-} from "./index-w6wbb612.js";
-import"./index-ztpw544k.js";
-import"./index-5pmx7bkg.js";
-import"./index-bz2sfzzt.js";
-import"./index-vtj3zps1.js";
-import"./index-4hek879p.js";
+  FileSys
+} from "./index-ayy5ecax.js";
 import {
-  CloudScript
-} from "./index-js368gk9.js";
+  GlobalConfig
+} from "./index-wet2ytnr.js";
 import {
-  getLatestPackageVersion,
-  getNpmRegistryUrl
-} from "./index-p3f4q532.js";
+  Exec,
+  Workspace,
+  runner,
+  script,
+  command
+} from "./index-ft1sfjz0.js";
 import {
-  PackageScript
-} from "./index-azv0xjb5.js";
-import"./index-gmy45vz2.js";
-import"./index-ss469dec.js";
-import"./index-xhgtkekh.js";
+  extractAgentBlock,
+  collectScopeRecipeSources,
+  renderScopeAgentBlock,
+  WorkspaceExecutor,
+  SysExecutor,
+  AppExecutor,
+  LibExecutor,
+  PkgExecutor
+} from "./index-k1n0h7dk.js";
+import"./index-6wwzs1bc.js";
 import {
-  GlobalConfig
-} from "./index-0cj2zxbm.js";
+  countBlocking,
+  formatStyleContract,
+  ThemeValidator
+} from "./index-n68jx79w.js";
+import {
+  collectRecipeSources2,
+  scanRecipes2
+} from "./index-by5gpp8x.js";
+import"./index-saheq2bs.js";
+import"./index-5y7qba1c.js";
+import"./index-h7yw2z9n.js";
 import {
   AgentScript
-} from "./index-gex7c8kd.js";
-import"./index-mssqn2sq.js";
-import"./index-2c3e2xh8.js";
-import"./index-7myvn0f0.js";
+} from "./index-5n0hf8r9.js";
 import {
   ApplicationScript
-} from "./index-5dw57f0d.js";
-import"./index-76rn3g2c.js";
+} from "./index-m7e0f1sy.js";
 import {
   LibraryScript
-} from "./index-a1e0j63x.js";
+} from "./index-xxe90kqy.js";
+import"./index-ctphds8v.js";
+import"./index-mfm35dhh.js";
 import {
-  Exec,
-  Workspace,
-  command,
-  runner,
-  script
-} from "./index-6rhabeev.js";
-import"./index-fgc8r6dj.js";
+  PackageScript
+} from "./index-a8h184wr.js";
 import {
-  ThemeValidator,
-  countBlocking,
-  formatStyleContract
-} from "./index-xjd3rqzj.js";
-import"./index-bjpxzr6s.js";
+  getNpmRegistryUrl,
+  getLatestPackageVersion
+} from "./index-1tgp56ke.js";
 import {
-  AppExecutor,
-  LibExecutor,
-  PkgExecutor,
-  SysExecutor,
-  WorkspaceExecutor,
-  collectScopeRecipeSources,
-  extractAgentBlock,
-  renderScopeAgentBlock
-} from "./index-vg0sj9nc.js";
-import"./index-mxvakhsm.js";
-import {
-  collectRecipeSources,
-  scanRecipes
-} from "./index-xys926f2.js";
-import"./index-46tjzh6s.js";
+  CloudScript
+} from "./index-ypvdw8nr.js";
 import {
-  FileSys
-} from "./index-67546d0j.js";
-import"./index-r24hmh0q.js";
-
-// pkgs/@akanjs/cli/workspace/workspace.script.ts
-import path2 from "path";
-import { Logger } from "akanjs/common";
+  ContextScript
+} from "./index-dq6wq1tv.js";
+import"./index-b2nt0w0k.js";
+import"./index-qcracvc9.js";
+import"./index-j9vnq8tr.js";
+import"./index-k86zc21w.js";
+import"./index-1kzsn94d.js";
+import"./index-cd5x18qh.js";
+import"./index-v0s24t8j.js";
+import"./index-m9c7k0gm.js";
 
 // pkgs/@akanjs/cli/workspace/workspace.runner.ts
 import path from "path";
+
+// pkgs/@akanjs/devkit/biomeBase.ts
+var biomeVersion = "2.5.8";
+
+// pkgs/@akanjs/cli/workspace/workspace.runner.ts
 var defaultWorkspacePeerDependencies = new Set([
   "@react-spring/web",
   "@use-gesture/react",
   "chance",
-  "croner",
   "react",
   "react-dom",
   "react-icons",
@@ -93,6 +90,7 @@ var defaultWorkspacePeerDependencies = new Set([
   "tailwindcss",
   "typescript"
 ]);
+var defaultMaxDiagnostics = 200;
 
 class WorkspaceRunner extends runner("workspace") {
   async generateAgentRules(workspace, { overwrite = false, cursorRules = true } = {}) {
@@ -113,17 +111,14 @@ class WorkspaceRunner extends runner("workspace") {
       dict,
       overwrite
     }));
-    if (!cursorRules)
-      return created;
-    return [
-      ...created,
-      ...await workspace.applyTemplate({
+    if (cursorRules)
+      created.push(...await workspace.applyTemplate({
         basePath: ".cursor/rules",
         template: "workspaceRoot/.cursor/rules/akan.mdc.template",
         dict,
         overwrite
-      })
-    ];
+      }));
+    return created;
   }
   async createWorkspace(repoName, appName, {
     dirname = ".",
@@ -137,10 +132,7 @@ class WorkspaceRunner extends runner("workspace") {
     const normalizedRegistryUrl = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
     const workspace = WorkspaceExecutor.fromRoot({ workspaceRoot, repoName });
     const templateSpinner = workspace.spinning(`Creating workspace template files in ${dirname}/${repoName}...`);
-    const [latestBiomeVersion, latestTypesBunVersion] = await Promise.all([
-      getLatestPackageVersion("@biomejs/biome", "latest", normalizedRegistryUrl),
-      getLatestPackageVersion("@types/bun", "latest", normalizedRegistryUrl)
-    ]);
+    const latestTypesBunVersion = await getLatestPackageVersion("@types/bun", "latest", normalizedRegistryUrl);
     await workspace.applyTemplate({
       basePath: ".",
       template: "workspaceRoot",
@@ -164,7 +156,7 @@ class WorkspaceRunner extends runner("workspace") {
       },
       devDependencies: {
         ...rootPackageJson.devDependencies,
-        "@biomejs/biome": latestBiomeVersion,
+        "@biomejs/biome": biomeVersion,
         "@types/bun": latestTypesBunVersion,
         "@akanjs/devkit": akanVersion,
         ...typescript ? { typescript } : {}
@@ -236,24 +228,35 @@ class WorkspaceRunner extends runner("workspace") {
     }
     throw new Error(`[workspace] failed to locate akanjs package.json from ${import.meta.dir}`);
   }
-  async lint(exec, workspace, { fix = true } = {}) {
+  async lint(exec, workspace, { fix = true, maxDiagnostics = defaultMaxDiagnostics } = {}) {
+    const configPath = await WorkspaceRunner.resolveBiomeConfigPath(workspace);
     await workspace.spawn("./node_modules/.bin/biome", [
       "check",
       ...fix ? ["--write"] : [],
       "--no-errors-on-unmatched",
+      `--max-diagnostics=${maxDiagnostics > 0 ? maxDiagnostics : "none"}`,
+      ...configPath ? ["--config-path", configPath] : [],
       exec.cwdPath
     ]);
     await this.#enforceStyleContract(exec);
     await this.#enforceRecipeGate(exec);
     await this.#enforceAgentsIndex(exec);
   }
+  static async resolveBiomeConfigPath(workspace) {
+    for (const fileName of ["biome.json", "biome.jsonc"]) {
+      const configPath = path.join(workspace.workspaceRoot, fileName);
+      if (await Bun.file(configPath).exists())
+        return configPath;
+    }
+    return null;
+  }
   async#enforceAgentsIndex(exec) {
     if (!(exec instanceof SysExecutor))
       return;
     const scope = { type: exec.type, name: exec.name };
     const scanInfo = await exec.scan({ write: false });
     const sources = await collectScopeRecipeSources(exec.workspace.workspaceRoot, scope, scanInfo.getScanResult().libDeps);
-    const expected = renderScopeAgentBlock(scope, scanRecipes(sources));
+    const expected = renderScopeAgentBlock(scope, scanRecipes2(sources));
     const existing = await exec.exists("AGENTS.md") ? await exec.readFile("AGENTS.md") : null;
     const actual = existing ? extractAgentBlock(existing) : null;
     if (actual === expected.trim())
@@ -266,12 +269,12 @@ class WorkspaceRunner extends runner("workspace") {
       return;
     const uiDir = path.join(cwdPath, "ui");
     const sources = [
-      ...await collectRecipeSources(uiDir, "ui/Recipe"),
-      ...await collectRecipeSources(uiDir, "ui/recipe", "recipe")
+      ...await collectRecipeSources2(uiDir, "ui/Recipe"),
+      ...await collectRecipeSources2(uiDir, "ui/recipe", "recipe")
     ];
     if (sources.length === 0)
       return;
-    const offenders = scanRecipes(sources).filter((recipe) => !Object.values(recipe.variants).some((values) => values.length >= 2 || values.length === 1 && values[0] === "true"));
+    const offenders = scanRecipes2(sources).filter((recipe) => !Object.values(recipe.variants).some((values) => values.length >= 2 || values.length === 1 && values[0] === "true"));
     if (offenders.length === 0)
       return;
     throw new Error(`[recipeGate] variant-less recipe(s): ${offenders.map((recipe) => recipe.name).join(", ")}
@@ -282,15 +285,18 @@ class WorkspaceRunner extends runner("workspace") {
     if (!cwdPath)
       return;
     const stylesCssPath = path.join(cwdPath, "page", "styles.css");
-    const theme = await Bun.file(stylesCssPath).exists() ? new ThemeValidator().validate(await Bun.file(stylesCssPath).text()) : [];
-    const violations = { style: [], theme };
+    if (!await Bun.file(stylesCssPath).exists())
+      return;
+    const violations = {
+      theme: new ThemeValidator().validate(await Bun.file(stylesCssPath).text())
+    };
     const blocking = countBlocking(violations);
     if (blocking === 0)
       return;
     throw new Error(`[themeValidator] ${blocking} blocking contrast violation(s):
 ${formatStyleContract(violations)}
 
-` + "\uD14C\uB9C8 \uD1A0\uD070 \uAC12\uC758 \uC804\uACBD/\uBC30\uACBD \uCF58\uD2B8\uB77C\uC2A4\uD2B8\uB97C WCAG \uAE30\uC900 \uC774\uC0C1\uC73C\uB85C \uC870\uC815\uD558\uC138\uC694.");
+` + "Raise the foreground/background contrast of these theme token values to the WCAG threshold.");
   }
   async writeTopLevelEnv(workspace, devProjectId) {
     await workspace.writeFile(".env", `AKAN_WORKSPACE_ID=${devProjectId}
@@ -314,6 +320,8 @@ AKAN_PUBLIC_LOG_LEVEL=debug
 }
 
 // pkgs/@akanjs/cli/workspace/workspace.script.ts
+import path2 from "path";
+import { Logger } from "akanjs/common";
 class WorkspaceScript extends script("workspace", [
   WorkspaceRunner,
   ApplicationScript,
@@ -372,30 +380,33 @@ class WorkspaceScript extends script("workspace", [
   async generateAgentRules(workspace, { overwrite = false, cursorRules = true } = {}) {
     const spinner = workspace.spinning("Generating agent rules...");
     const files = await this.workspaceRunner.generateAgentRules(workspace, { overwrite, cursorRules });
+    if (files.some((file) => file.filePath.endsWith("AGENTS.md")))
+      await this.agentScript.agent(workspace, "install", "agents-md", { force: overwrite });
     spinner.succeed(`Agent rules ready (${files.length} file${files.length === 1 ? "" : "s"})`);
   }
-  async lint(exec, workspace, { fix = true } = {}) {
+  async lint(exec, workspace, { fix = true, maxDiagnostics } = {}) {
     if (exec instanceof AppExecutor)
       await this.applicationScript.sync(exec);
     else if (exec instanceof LibExecutor)
       await this.libraryScript.syncLibrary(exec);
     const spinner = workspace.spinning(`Linting${fix ? " with fix" : ""}...`);
     try {
-      await this.workspaceRunner.lint(exec, workspace, { fix });
+      await this.workspaceRunner.lint(exec, workspace, { fix, maxDiagnostics });
       spinner.succeed("Lint completed with no errors");
     } catch (error) {
       spinner.fail("Lint failed with errors");
       throw error;
     }
   }
-  async lintAll(workspace, { fix = true } = {}) {
+  async lintAll(workspace, { fix = true, maxDiagnostics } = {}) {
     const [appNames, libNames, pkgNames] = await workspace.getExecs();
+    const options = { fix, maxDiagnostics };
     await Promise.all(appNames.map((appName) => this.applicationScript.sync(AppExecutor.from(workspace, appName))));
     await Promise.all(libNames.map((libName) => this.libraryScript.syncLibrary(LibExecutor.from(workspace, libName))));
     await Promise.all([
-      ...appNames.map((appName) => this.workspaceRunner.lint(AppExecutor.from(workspace, appName), workspace, { fix })),
-      ...libNames.map((libName) => this.workspaceRunner.lint(LibExecutor.from(workspace, libName), workspace, { fix })),
-      ...pkgNames.filter((pkgName) => pkgName !== "contract").map((pkgName) => this.workspaceRunner.lint(PkgExecutor.from(workspace, pkgName), workspace, { fix }))
+      ...appNames.map((appName) => this.workspaceRunner.lint(AppExecutor.from(workspace, appName), workspace, options)),
+      ...libNames.map((libName) => this.workspaceRunner.lint(LibExecutor.from(workspace, libName), workspace, options)),
+      ...pkgNames.filter((pkgName) => pkgName !== "contract").map((pkgName) => this.workspaceRunner.lint(PkgExecutor.from(workspace, pkgName), workspace, options))
     ]);
   }
   async syncAll(workspace) {
@@ -477,11 +488,17 @@ class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public
   }).option("overwrite", Boolean, { desc: "Overwrite existing agent rule files", default: false }).option("cursorRules", Boolean, { desc: "Generate .cursor/rules/akan.mdc", default: true }).with(Workspace).exec(async function(overwrite, cursorRules, workspace) {
     await this.workspaceScript.generateAgentRules(workspace, { overwrite, cursorRules });
   }),
-  lint: target({ desc: "Lint and fix code in a specific app/lib/pkg" }).with(Exec).option("fix", Boolean, { default: true }).with(Workspace).exec(async function(exec, fix, workspace) {
-    await this.workspaceScript.lint(exec, workspace, { fix });
+  lint: target({ desc: "Lint and fix code in a specific app/lib/pkg" }).with(Exec).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, {
+    desc: "How many diagnostics Biome prints before truncating (0 for no limit)",
+    default: defaultMaxDiagnostics
+  }).with(Workspace).exec(async function(exec, fix, maxDiagnostics, workspace) {
+    await this.workspaceScript.lint(exec, workspace, { fix, maxDiagnostics });
   }),
-  lintAll: target({ desc: "Lint and fix code in all apps and libraries" }).option("fix", Boolean, { default: true }).with(Workspace).exec(async function(fix, workspace) {
-    await this.workspaceScript.lintAll(workspace, { fix });
+  lintAll: target({ desc: "Lint and fix code in all apps and libraries" }).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, {
+    desc: "How many diagnostics Biome prints before truncating (0 for no limit)",
+    default: defaultMaxDiagnostics
+  }).with(Workspace).exec(async function(fix, maxDiagnostics, workspace) {
+    await this.workspaceScript.lintAll(workspace, { fix, maxDiagnostics });
   }),
   syncAll: target({ desc: "Sync dependencies and configuration for all apps and libraries" }).with(Workspace).exec(async function(workspace) {
     await this.workspaceScript.syncAll(workspace);

package/capacitorApp-p0z5yab2.js

@@ -1,60 +0,0 @@
-// @bun
-import {
-  ANDROID_MIN_SDK_VERSION,
-  CapacitorApp,
-  PLACEHOLDER_APP_IDS,
-  SWIFTUICORE_MIN_IOS_MAJOR,
-  assertJsonSerializable,
-  buildIosNativeRunCommand,
-  classifyIosRunFailure,
-  clearRootCapacitorConfigs,
-  formatAndroidReleaseSigningError,
-  formatIosRunFailureMessage,
-  getAdbDeviceStateIssues,
-  getAndroidLocalServerHost,
-  getMissingAndroidReleaseSigningKeys,
-  isPlaceholderAppId,
-  materializeCapacitorConfig,
-  parseDevicectlDevices,
-  parseIosRuntimeMajor,
-  parseSimctlDevices,
-  raiseGradleMinSdkVersion,
-  rootCapacitorConfigFilenames,
-  rootCapacitorConfigPaths,
-  sanitizeIosNativeRunEnv,
-  selectLocalDevHost,
-  sortIosRunTargets,
-  writeRootCapacitorConfig
-} from "./index-xhgtkekh.js";
-import"./index-76rn3g2c.js";
-import"./index-vg0sj9nc.js";
-import"./index-mxvakhsm.js";
-import"./index-67546d0j.js";
-import"./index-r24hmh0q.js";
-export {
-  writeRootCapacitorConfig,
-  sortIosRunTargets,
-  selectLocalDevHost,
-  sanitizeIosNativeRunEnv,
-  rootCapacitorConfigPaths,
-  rootCapacitorConfigFilenames,
-  raiseGradleMinSdkVersion,
-  parseSimctlDevices,
-  parseIosRuntimeMajor,
-  parseDevicectlDevices,
-  materializeCapacitorConfig,
-  isPlaceholderAppId,
-  getMissingAndroidReleaseSigningKeys,
-  getAndroidLocalServerHost,
-  getAdbDeviceStateIssues,
-  formatIosRunFailureMessage,
-  formatAndroidReleaseSigningError,
-  clearRootCapacitorConfigs,
-  classifyIosRunFailure,
-  buildIosNativeRunCommand,
-  assertJsonSerializable,
-  SWIFTUICORE_MIN_IOS_MAJOR,
-  PLACEHOLDER_APP_IDS,
-  CapacitorApp,
-  ANDROID_MIN_SDK_VERSION
-};

package/dependencyScanner-f6grrep3.js

@@ -1,9 +0,0 @@
-// @bun
-import {
-  TypeScriptDependencyScanner
-} from "./index-46tjzh6s.js";
-import"./index-67546d0j.js";
-import"./index-r24hmh0q.js";
-export {
-  TypeScriptDependencyScanner
-};

package/index-mxvakhsm.js

@@ -1,66 +0,0 @@
-// @bun
-// pkgs/@akanjs/devkit/spinner.ts
-import ora from "ora";
-
-class Spinner {
-  static padding = 12;
-  static oraOptions = { discardStdin: false };
-  static canAnimate(stream = process.stderr) {
-    return !stream.isTTY || stream.columns > 0;
-  }
-  spinner;
-  stopWatch = null;
-  startAt = new Date;
-  prefix;
-  message;
-  enableSpin;
-  constructor(message, { prefix = "", indent = 0, enableSpin = true } = {}) {
-    Spinner.padding = Math.max(Spinner.padding, prefix.length);
-    this.prefix = prefix;
-    this.message = message;
-    this.spinner = ora({ ...Spinner.oraOptions, text: message });
-    this.spinner.prefixText = prefix.padStart(Spinner.padding, " ");
-    this.spinner.indent = indent;
-    this.enableSpin = enableSpin && Spinner.canAnimate();
-  }
-  start() {
-    this.startAt = new Date;
-    if (this.enableSpin) {
-      this.spinner.start();
-      this.stopWatch = setInterval(() => {
-        this.spinner.prefixText = this.prefix.padStart(Spinner.padding, " ");
-        this.spinner.text = `${this.message} (${this.#getElapsedTimeStr({ floor: true })})`;
-      }, 1000);
-    } else
-      this.spinner.info();
-    return this;
-  }
-  succeed(message) {
-    this.spinner.succeed(`${message} (${this.#getElapsedTimeStr()})`);
-    this.#reset();
-  }
-  fail(message) {
-    this.spinner.fail(`${message} (${this.#getElapsedTimeStr()})`);
-    this.#reset();
-  }
-  isSpinning() {
-    return this.spinner.isSpinning;
-  }
-  #reset() {
-    if (this.stopWatch)
-      clearInterval(this.stopWatch);
-    this.stopWatch = null;
-  }
-  #getElapsedTimeStr({ floor = false } = {}) {
-    const ms = Date.now() - this.startAt.getTime();
-    if (ms < 1000)
-      return `${ms}ms`;
-    const s = Math.floor(ms / 1000);
-    if (s < 60)
-      return `${floor ? Math.floor(ms / 1000) : Math.floor(ms / 100) / 10}s`;
-    const m = Math.floor(s / 60);
-    return `${m}m ${s % 60}s`;
-  }
-}
-
-export { Spinner };

package/index-r24hmh0q.js

@@ -1,4 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-export { __require };

package/recipeScanner-tghkzrrt.js

@@ -1,12 +0,0 @@
-// @bun
-import {
-  collectRecipeSources,
-  findInlineRecipeDuplicates,
-  scanRecipes
-} from "./index-xys926f2.js";
-import"./index-r24hmh0q.js";
-export {
-  scanRecipes,
-  findInlineRecipeDuplicates,
-  collectRecipeSources
-};

package/templates/workspaceRoot/.cursor/rules/akan-page-routing.mdc.template

@@ -1,43 +0,0 @@
----
-description: Akan page routing conventions
-globs: apps/**/page/**/*.{ts,tsx,js,jsx}
-alwaysApply: false
----
-
-# Akan Page Routing
-
-- `apps/<app>/page` may contain route modules only. Do not add helper logic or component-only files there.
-- Route source files under `page/` must use `.tsx`. Do not add `logic.ts`, `.js`, or `.jsx` files under `page/`.
-- Route pages use `_index.tsx`; layouts use `_layout.tsx`.
-- Reserved `_*.tsx` route filenames are limited to `_index.tsx` and `_layout.tsx`; do not add files like `_Component.tsx` or `_helper.tsx`.
-- Page filenames must not start with an uppercase letter. Move helper components like `Component.tsx` to app `ui`, `common`, or `lib` instead.
-- Dynamic segments use `[id]`; route groups use directories like `(user)`, `(public)`, `(tab)`, or `(detail)`.
-- Page modules should usually export `default`, `pageConfig`, `head`, `generateHead`, or `Loading`.
-- Prefer `export default function Page` or `export default async function Page` for page components.
-- Before changing route behavior, check nearby routes for the expected pattern.
-
-## Page Body Shape
-
-```tsx
-interface PageProps {
-  params: { taskId: string };
-}
-
-export default async function Page({ params }: PageProps) {
-  const { l } = usePage();
-  getSelf({ unauthorize: "/signin" });
-  const { taskId } = params;
-  const [{ task }] = await Promise.all([fetch.viewTask(taskId)]);
-  return <Task.View.General task={task} />;
-}
-
-export const pageConfig = { transition: "stack" } satisfies PageConfig;
-```
-
-- There is no `loader=` / `render=` page prop. Pages are `export default async function Page`.
-- Declare `interface PageProps { params: {...}; searchParams?: {...} }` immediately above the default export.
-- Body order: `usePage()`, auth, destructure params, fetch, return.
-- Run independent fetches through `Promise.all`, even when there is only one.
-- Gate auth at `_layout.tsx`; repeating `getSelf({ unauthorize: "/signin" })` in the page is fine and common.
-- Keep `async` even when nothing is awaited — it marks a real server page.
-- No `useState`, no `useEffect`, and no comments in page files.

package/templates/workspaceRoot/.cursor/rules/akan-sync-conventions.mdc.template

@@ -1,34 +0,0 @@
----
-description: sync-enforced Akan app/lib layout and generated index conventions
-globs: apps/**/*,libs/**/*
-alwaysApply: false
----
-
-# Akan Sync Conventions
-
-- `apps/<appName>` root may only contain these files: `AGENTS.md`, `CLAUDE.md`, `akan.app.json`, `akan.config.ts`, `capacitor.config.ts`, `client.ts`, `main.ts`, `package.json`, `server.ts`, `tsconfig.json`.
-- `apps/<appName>` root may only contain these folders: `.akan`, `android`, `common`, `env`, `ios`, `lib`, `mobile`, `page`, `plugin`, `private`, `public`, `script`, `secrets`, `srvkit`, `ui`, `webkit`.
-- `akan sync` maintains a scoped agent guide per app/lib (`apps/<app>/AGENTS.md` / `libs/<lib>/AGENTS.md`); the `akan:agent` block in it is generated, content outside the markers is hand-editable, and `akan lint` fails when the block is stale.
-- Do not add `apps/*/base`; place shared app utilities under `apps/*/common`.
-- `apps/*/lib` and `libs/*/lib` root files are limited to generated/support files: `cnst.ts`, `db.ts`, `dict.ts`, `option.ts`, `sig.ts`, `srv.ts`, `st.ts`, `useClient.ts`, `useServer.ts`.
-- Domain module folders are `lib/<model>` for database modules, `lib/_<service>` for service modules, and `lib/__scalar/<scalar>` for scalar modules.
-- Database module UI files are limited to `<Model>.Template.tsx`, `<Model>.Unit.tsx`, `<Model>.Util.tsx`, `<Model>.View.tsx`, and `<Model>.Zone.tsx`.
-- Service module UI files are limited to `<Service>.Util.tsx` and `<Service>.Zone.tsx`.
-- Scalar module UI files are limited to `<Scalar>.Template.tsx` and `<Scalar>.Unit.tsx`.
-- Module `*.test.ts`, `*.test.tsx`, `*.spec.ts`, and `*.spec.tsx` files are allowed.
-- `ui/index.ts`, `webkit/index.ts`, `srvkit/index.ts`, `common/index.ts`, and module `lib/**/index.ts` files are generated by `akan sync`; do not hand-edit or track them.
-- Generated facet indexes export only 1-depth files/folders with `export * from "./name";`.
-
-## Layer Placement
-
-| Folder | Admission test | Naming |
-|---|---|---|
-| `common/` | pure, isomorphic, zero-dependency; may import only sibling `common/*` and `akanjs/base`. Cannot import `Err`, so keep throwing code out of it. | camelCase file, filename equals the single export |
-| `webkit/` | touches `window` / `navigator` / Capacitor, or is a React hook | `use<Thing>.tsx` — `.tsx` even with no JSX |
-| `srvkit/` | touches `node:*`, `Bun`, `process.env`, a secret, or a server SDK | camelCase file, PascalCase class |
-| `ui/` | renders JSX and is not bound to one model | PascalCase component, camelCase sidecar (`swipeCard.util.ts`) |
-
-- Hooks return a named object of async closures, never a tuple.
-- Only layer-root `index.ts` barrels are generated. A `ui/<Folder>/index.tsx` that builds a namespace is hand-written source; the distinguishing test is that a generated barrel contains nothing but `export * from "./X";` lines.
-- `ui/<Folder>/index_.tsx` (trailing underscore) is the `"use client"` + `lazy()` boundary, with a server-safe `index.tsx` beside it. Collapsing the pair into one file breaks RSC.
-- Never add a sibling helper file inside `lib/<model>/`; helpers belong in one of the folders above.

package/templates/workspaceRoot/.cursor/rules/application-test-commands.mdc.template

@@ -1,16 +0,0 @@
----
-description: Application test commands after source changes
-alwaysApply: true
----
-
-# Application Test Commands
-
-- After changing application source code, test the app with `bun run akan start <appName>`.
-- Test production build generation with `bun run akan build <appName>`.
-- To test a built artifact locally, run it from the generated app directory with the required Akan runtime environment variables.
-
-```bash
-cd dist/apps/<appName> && USE_AKANJS_PKGS=true AKAN_PUBLIC_REPO_NAME=akansoft AKAN_PUBLIC_SERVE_DOMAIN="akanjs.com" AKAN_PUBLIC_APP_NAME=seon AKAN_PUBLIC_ENV=local AKAN_PUBLIC_OPERATION_MODE=local SERVER_MODE=federation AKAN_PUBLIC_BASE_PATHS=operator,office,homepage bun main.js
-```
-
-- Adjust `<appName>`, `AKAN_PUBLIC_APP_NAME`, and `AKAN_PUBLIC_BASE_PATHS` to match the app being tested.

package/templates/workspaceRoot/.cursor/rules/change-scope.mdc.template

@@ -1,12 +0,0 @@
----
-description: Keep edits scoped and avoid unrelated churn
-alwaysApply: true
----
-
-# Change Scope
-
-- Keep edits scoped to the requested task and the directly related files.
-- Do not reformat unrelated files or rewrite nearby code just for style.
-- Do not revert or overwrite unrelated user changes in a dirty working tree.
-- Prefer established nearby patterns over introducing a new abstraction.
-- Add new abstractions only when they remove real duplication or match an existing project pattern.

package/templates/workspaceRoot/.cursor/rules/client-server-boundaries.mdc.template

@@ -1,18 +0,0 @@
----
-description: Client/server boundary conventions for Akan apps
-globs: apps/**/*.{ts,tsx},libs/**/*.{ts,tsx},pkgs/akanjs/**/*.{ts,tsx}
-alwaysApply: false
----
-
-# Client Server Boundaries
-
-- Use `"use client";` at the top of client component files.
-- Be careful when importing client-only code from page or layout modules.
-- Keep page props serializable unless the existing route pattern clearly allows otherwise.
-- Let server page/layout files own route-level concerns: `usePage`, headers, static layout, and `akanjs/ui` `Tab` composition.
-- Keep interactive loading, submit/import actions, local form inputs, and `router.push` inside client `Util`, `Template`, or `Zone` components.
-- Prefer server-rendered `Tab` shells for static mode selection; put one client component inside each `Tab.Panel` instead of managing the selected mode with extra `useState`.
-- In domain UI the boundary is mechanical, not a judgment call: `Template`, `Zone`, and `Util` are always client components with `"use client"` on line 1; `Unit` and `View` are always server components and never carry the directive. `usePage()` is still legal in server files.
-- Preserve established domain file roles such as `.document.ts`, `.service.ts`, `.store.ts`, `.constant.ts`, and `.client.ts`.
-- When unsure, inspect nearby files in the same app or package before introducing a new boundary pattern.
-- The boundary is only half the rule: how *little* ends up on the client is the other half. See `ssr-first.mdc`.

package/templates/workspaceRoot/.cursor/rules/coding-comments.mdc.template

@@ -1,25 +0,0 @@
----
-description: Do not narrate code; document only what the code cannot say
-alwaysApply: true
----
-
-# Comments
-
-Do not narrate code. Do document the thing the code cannot say. Both halves are the rule.
-
-- Never add a comment that restates the identifier, the signature, or the control flow.
-- Prefer clear names and structure so ordinary logic needs no explanation.
-- Do not add JSDoc, section banners, or "why/how" comments for ordinary logic.
-- Comment density tracks the layer, not the author: pages carry none, product `lib/` and `ui/` code stays under 1 %, and `srvkit/` adapters and `guards.ts` carry as much as the external constraints require.
-- A comment is warranted for: a vendor spec or protocol quirk; an infrastructure constraint; a third-party library gotcha; security reasoning; why a rule that looks arbitrary is correct; a math derivation; a domain field's business meaning; a state transition above a document chain method; why an obvious alternative was rejected.
-- In-code markers:
-  1. `TODO` — unfinished work that must be tracked in-code
-  2. `FIXME` — known broken or incorrect behavior that must be fixed
-  3. `XXX` — dangerous / surprising hazard that a reader must not miss
-  4. `//!` — disabled or must-fix code
-  5. `//?` — an explanatory aside
-  6. `//*` — a design note
-  7. Deletion caution — warn why removing a line or block would break something non-obvious
-- Keep allowed comments one short line when possible.
-- Every suppression carries a reason: `// biome-ignore lint/<rule>: <why>`. Never a bare disable block.
-- Match nearby file style: if the surrounding code has few comments, keep it that way.