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

package/templates/workspaceRoot/CLAUDE.md.template

@@ -1,3 +1,22 @@
 # <%= repoName %> — Claude Code Guide
 
 @AGENTS.md
+
+## Comments — Overrides Your Default
+
+Write **no comments** unless the comment passes the test below. This is the rule agents break most often here, so it
+is repeated outside the guide: a diff that adds a comment the test rejects is a diff to redo.
+
+Before typing `//`, `/*`, or a doc block, ask — **does this sentence carry a fact that is nowhere in the code?**
+
+- Restates the identifier, the signature, or the line under it → delete it.
+- Labels a section (`// helpers`, `// state`) or narrates a step (`// fetch the user`, `// then save`) → delete it.
+- JSDoc on an ordinary function, or a why/how preamble on ordinary logic → delete it.
+- Explains the edit you just made, for whoever reads the diff → say it in your reply, not in the file.
+- Names a vendor or protocol quirk, an infrastructure constraint, a library gotcha, security reasoning, a math
+  derivation, a domain field's business meaning, a state transition, or why an obvious alternative was rejected →
+  keep it, one line.
+
+That keep-list is exact — `Comments` in the guide is the full version. "It aids readability" and "this logic is
+subtle" are not on it: rename or split the code instead. When you edit an existing file, match its density; if the
+surrounding code carries none, your diff carries none.

package/templates/workspaceRoot/biome.json.template

@@ -1,261 +1,21 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.5.2/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
+  "$schema": "https://biomejs.dev/schemas/2.5.8/schema.json",
+  "extends": ["@akanjs/devkit/biome.base.json"],
   "files": {
     "includes": [
       "**/*.ts",
       "**/*.tsx",
       "**/*.json",
       "**/*.jsonc",
-      "!**/env.client.local.ts",
-      "!**/env.client.debug.ts",
-      "!**/env.client.develop.ts",
-      "!**/env.client.main.ts",
-      "!**/env.client.testing.ts",
-      "!**/env.server.local.ts",
-      "!**/env.server.develop.ts",
-      "!**/env.server.main.ts",
-      "!**/env.server.testing.ts",
-      "!**/env.server.type.ts",
-      "!apps/*/lib/cnst.ts",
-      "!apps/*/lib/dict.ts",
-      "!apps/*/lib/db.ts",
-      "!apps/*/lib/srv.ts",
-      "!apps/*/lib/st.ts",
-      "!apps/*/lib/sig.ts",
-      "!apps/*/lib/useClient.ts",
-      "!apps/*/lib/useServer.ts",
-      "!apps/*/client.ts",
-      "!apps/*/server.ts",
-      "!apps/*/lib/*/index.tsx",
-      "!libs/*/lib/cnst.ts",
-      "!libs/*/lib/dict.ts",
-      "!libs/*/lib/db.ts",
-      "!libs/*/lib/srv.ts",
-      "!libs/*/lib/st.ts",
-      "!libs/*/lib/sig.ts",
-      "!libs/*/lib/useClient.ts",
-      "!libs/*/lib/useServer.ts",
-      "!libs/*/client.ts",
-      "!libs/*/server.ts",
-      "!libs/*/index.ts",
-      "!libs/*/lib/*/index.tsx",
       "!infra/master/createRecords.ts",
       "!pkgs/contract/env.ts",
       "!!**/node_modules",
       "!!**/dist",
       "!!**/.akan",
+      "!!**/.claude",
       "!!**/dump",
       "!!**/local",
       "!!**/ios/DerivedData"
     ]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 120
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "preset": "recommended",
-      "suspicious": {
-        "noConsole": {
-          "level": "error",
-          "options": {
-            "allow": ["assert", "error", "info", "warn"]
-          }
-        },
-        "noArrayIndexKey": "off",
-        "noShadowRestrictedNames": "off",
-        "noUnnecessaryConditions": {
-          "level": "error"
-        }
-      },
-      "correctness": {
-        "noUnusedFunctionParameters": "off",
-        "noUnusedImports": {
-          "level": "error",
-          "fix": "safe"
-        },
-        "useParseIntRadix": "off",
-        "useExhaustiveDependencies": "off",
-        "useHookAtTopLevel": "off"
-      },
-      "nursery": {
-        "useSortedClasses": {
-          "level": "error",
-          "fix": "safe",
-          "options": {
-            "attributes": ["classList"],
-            "functions": ["clsx", "cn"]
-          }
-        }
-      },
-      "a11y": "off",
-      "complexity": {
-        "noStaticOnlyClass": "off"
-      },
-      "style": {
-        "useTemplate": {
-          "level": "warn",
-          "fix": "safe"
-        }
-      }
-    },
-    "domains": {
-      "project": "recommended",
-      "react": "recommended",
-      "test": "recommended",
-      "types": "all"
-    }
-  },
-  "javascript": {
-    "parser": {
-      "unsafeParameterDecoratorsEnabled": true
-    },
-    "formatter": {
-      "quoteStyle": "double"
-    }
-  },
-  "assist": {
-    "enabled": true,
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  },
-  "overrides": [
-    {
-      "includes": [
-        "apps/**/*.ts",
-        "apps/**/*.tsx",
-        "libs/**/*.ts",
-        "libs/**/*.tsx",
-        "!**/*.test.ts",
-        "!**/*.test.tsx",
-        "!**/*.spec.ts",
-        "!**/*.spec.tsx",
-        "!**/*.constant.ts",
-        "!**/common/**",
-        "!apps/akan/env/**"
-      ],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-throw-raw-error.grit"]
-    },
-    {
-      "includes": ["**/page/**/*.ts", "**/page/**/*.tsx", "**/*.Unit.tsx", "**/*.View.tsx"],
-      "plugins": [
-        "./node_modules/@akanjs/devkit/lint/no-import-client-functions.grit",
-        "./node_modules/@akanjs/devkit/lint/no-use-client-in-server.grit"
-      ]
-    },
-    {
-      "includes": ["**/page/**/*.ts", "**/page/**/*.tsx"],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/non-scalar-props-restricted.grit"]
-    },
-    {
-      "includes": ["**/*.constant.ts", "**/*.document.ts", "**/*.service.ts", "**/*.store.ts"],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-js-private-class-method.grit"]
-    },
-    {
-      "includes": ["**/*.store.ts"],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-return-in-store-action.grit"]
-    },
-    {
-      "includes": ["**/*.signal.ts"],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-redeclare-predefined-endpoint.grit"]
-    },
-    {
-      "includes": [
-        "**/ui/**/*.ts",
-        "**/ui/**/*.tsx",
-        "**/webkit/**/*.ts",
-        "**/webkit/**/*.tsx",
-        "**/common/**/*.ts",
-        "**/page/**/*.tsx",
-        "**/*.constant.ts",
-        "**/*.store.ts",
-        "**/*.Template.tsx",
-        "**/*.Unit.tsx",
-        "**/*.Util.tsx",
-        "**/*.View.tsx",
-        "**/*.Zone.tsx",
-        "!**/*.test.ts",
-        "!**/*.test.tsx",
-        "!**/*.spec.ts",
-        "!**/*.spec.tsx"
-      ],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-bang-comment-in-client.grit"]
-    },
-    {
-      "includes": [
-        "**/*.constant.ts",
-        "**/*.dictionary.ts",
-        "**/*.document.ts",
-        "**/*.service.ts",
-        "**/*.signal.ts",
-        "**/*.store.ts",
-        "**/*.Template.tsx",
-        "**/*.Unit.tsx",
-        "**/*.Util.tsx",
-        "**/*.View.tsx",
-        "**/*.Zone.tsx"
-      ],
-      "plugins": ["./node_modules/@akanjs/devkit/lint/no-deep-internal-import.grit"]
-    },
-    {
-      "includes": [
-        "**/page/**/*.ts",
-        "**/page/**/*.tsx",
-        "**/index.ts",
-        "**/index.tsx",
-        "**/cnst.ts",
-        "**/db.ts",
-        "**/dict.ts",
-        "**/option.ts",
-        "**/sig.ts",
-        "**/srv.ts",
-        "**/st.ts",
-        "**/*.constant.ts",
-        "**/*.dictionary.ts",
-        "**/*.document.ts",
-        "**/*.service.ts",
-        "**/*.signal.ts",
-        "**/*.signal.test.ts",
-        "**/*.service.test.ts",
-        "**/*.store.ts",
-        "**/*.Template.tsx",
-        "**/*.Unit.tsx",
-        "**/*.Util.tsx",
-        "**/*.View.tsx",
-        "**/*.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

@@ -47,25 +47,21 @@ See `docs/GENERATED.md` for the generated file list.
 
 ## House Style
 
-`AGENTS.md` holds the full style guide. The rules agents break most often:
+`AGENTS.md` holds the full style guide, and `akan lint` enforces most of it. The four rules that surprise people,
+because the failure is silent rather than an error:
 
 - **Never hand-order Tailwind classes** — the linter sorts them, including inside `cn()`, and its output looks
-  unnatural on purpose.
+  unnatural on purpose. Do not reorder it back.
 - **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
-  shim in `base/`, `webkit/`, or `ui/` first.
-- `#private` is lint-banned in `*.constant.ts`, `*.document.ts`, `*.service.ts`, and `*.store.ts` only; it stays
-  the house style under `srvkit/`.
-- Components are `export const X = ({ … }: XProps) => { … }` with `interface XProps` directly above and
-  `className?: string` first. No `React.FC`, no non-null assertions, no `as any`.
-- `cond ? <X/> : null`, never `{cond && <X/>}` — the latter renders the string `"false"` in a className context.
-- Put display and predicate logic on the `Light<Model>` constant class; keep document chain methods
-  validate → mutate → `return this` without `save()`; keep services to load → chain → save.
-- Do not narrate code in comments. Do document vendor quirks, infrastructure constraints, and security reasoning.
+- **`cond ? <X/> : null`, never `{cond && <X/>}`** — the latter renders the string `"false"` in a className context.
+- **Never wrap a form setter in a pass-through arrow** — `onChange={st.do.setXOnY}` publishes the field to agents
+  and E2E selectors; `onChange={(v) => st.do.setXOnY(v)}` runs identically and publishes nothing.
+
+Two more that are hard errors: **never `throw new Error`** (throw `new Err("<module>.error.<key>")` with an
+`[en, ko]` dictionary entry), and **never import a third-party package** from a page, a barrel, or a module file —
+re-export it through a one-line shim in the lib's `common/`, `webkit/`, or `ui/` first.
 
 ## Abstract Documents
 

package/templates/workspaceRoot/docs/GENERATED.md.template

@@ -9,20 +9,21 @@ sync or build can overwrite local changes.
 | --- | --- |
 | `apps/*/client.ts` | App-wide client entrypoint for generated fetch, store, and client runtime exports. |
 | `apps/*/server.ts` | App-wide server entrypoint for generated server, service, signal, database, and dictionary exports. |
+| `libs/*/client.ts`, `libs/*/server.ts`, `libs/*/index.ts` | The same entrypoints for a library. |
 
-## App Library Barrels
+## Module Barrels (apps and libs alike)
 
 | File | Purpose |
 | --- | --- |
-| `apps/*/lib/cnst.ts` | Re-exports constants and model shapes from module `*.constant.ts` files. |
-| `apps/*/lib/db.ts` | Re-exports database models from module `*.document.ts` files. |
-| `apps/*/lib/dict.ts` | Re-exports dictionaries from module `*.dictionary.ts` files. |
-| `apps/*/lib/srv.ts` | Re-exports services from module `*.service.ts` files. |
-| `apps/*/lib/sig.ts` | Re-exports endpoints, slices, and internals from module `*.signal.ts` files. |
-| `apps/*/lib/st.ts` | Re-exports stores from module `*.store.ts` files. |
-| `apps/*/lib/useClient.ts` | Client-safe generated imports for fetch, message, signal, and store usage. |
-| `apps/*/lib/useServer.ts` | Server-safe generated imports for service, database, signal, and dictionary usage. |
-| `apps/*/lib/**/index.ts` | Per-module generated barrel files. |
+| `{apps,libs}/*/lib/cnst.ts` | Re-exports constants and model shapes from module `*.constant.ts` files. |
+| `{apps,libs}/*/lib/db.ts` | Re-exports database models from module `*.document.ts` files. |
+| `{apps,libs}/*/lib/dict.ts` | Re-exports dictionaries from module `*.dictionary.ts` files. |
+| `{apps,libs}/*/lib/srv.ts` | Re-exports services from module `*.service.ts` files. |
+| `{apps,libs}/*/lib/sig.ts` | Re-exports endpoints, slices, and internals from module `*.signal.ts` files. |
+| `{apps,libs}/*/lib/st.ts` | Re-exports stores from module `*.store.ts` files. |
+| `{apps,libs}/*/lib/useClient.ts` | Client-safe generated imports for fetch, message, signal, and store usage. |
+| `{apps,libs}/*/lib/useServer.ts` | Server-safe generated imports for service, database, signal, and dictionary usage. |
+| `{apps,libs}/*/lib/**/index.ts` | Per-module generated barrel files. |
 
 ## Shared Surface Barrels
 
@@ -32,6 +33,7 @@ sync or build can overwrite local changes.
 | `*/webkit/index.ts` | Re-exports webkit/browser helper files. |
 | `*/srvkit/index.ts` | Re-exports server-kit helper files. |
 | `*/common/index.ts` | Re-exports common helper files. |
+| `*/plugin/index.ts` | Re-exports `<name>.plugin.ts` declarations. |
 
 ## How To Change Generated Output
 

package/templates/workspaceRoot/package.json.template

@@ -31,8 +31,6 @@
   "dependencies": {},
   "devDependencies": {},
   "patchedDependencies": {
-    "react-dom@19.2.7": "patches/react-dom@19.2.7.patch",
-    "zod@3.25.76": "patches/zod@3.25.76.patch",
-    "zod@4.4.3": "patches/zod@4.4.3.patch"
+    "react-dom@19.2.7": "patches/react-dom@19.2.7.patch"
   }
-}
+}

package/typeChecker-3xgrzc2v.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  TypeChecker2
+} from "./index-92zztqy1.js";
+export {
+  TypeChecker2 as TypeChecker
+};

package/typecheck.proc.js

@@ -1,8 +1,7 @@
 // @bun
 import {
-  TypeChecker
-} from "./index-wnp7hwq7.js";
-import"./index-r24hmh0q.js";
+  TypeChecker2
+} from "./index-92zztqy1.js";
 
 // pkgs/@akanjs/devkit/typecheck/typecheck.proc.ts
 import { Logger } from "akanjs/common";
@@ -12,7 +11,7 @@ try {
     const cwdPath = process.env.AKAN_TYPECHECK_CWD;
     if (!cwdPath)
       throw new Error("AKAN_TYPECHECK_CWD is required");
-    const typeChecker = new TypeChecker({ cwdPath });
+    const typeChecker = new TypeChecker2({ cwdPath });
     const { fileDiagnostics, fileErrors, fileWarnings } = typeChecker.check(filePath);
     const message = typeChecker.formatDiagnostics(fileDiagnostics);
     Logger.rawLog(JSON.stringify({
@@ -26,7 +25,7 @@ try {
   const configPath = process.env.AKAN_TYPECHECK_TSCONFIG;
   if (!configPath)
     throw new Error("AKAN_TYPECHECK_TSCONFIG is required");
-  const result = TypeChecker.checkProject(configPath);
+  const result = TypeChecker2.checkProject(configPath);
   if (result.errors.length > 0) {
     console.error(result.message);
     process.exit(1);

package/{workflow.command-91wmvm8k.js → workflow.command-cvpmzwjg.js}

@@ -1,34 +1,32 @@
 // @bun
 import {
-  WorkflowRunner
-} from "./index-5pmx7bkg.js";
+  Workspace,
+  script,
+  command
+} from "./index-ft1sfjz0.js";
+import"./index-k1n0h7dk.js";
+import"./index-ayy5ecax.js";
+import"./index-6wwzs1bc.js";
 import {
-  PrimitiveScript
-} from "./index-bz2sfzzt.js";
+  createWorkflowStepRegistry
+} from "./index-saheq2bs.js";
+import"./index-wet2ytnr.js";
 import {
   ModuleScript
-} from "./index-vtj3zps1.js";
-import"./index-4hek879p.js";
+} from "./index-k86zc21w.js";
+import"./index-1kzsn94d.js";
+import"./index-h7yw2z9n.js";
 import {
-  ScalarScript
-} from "./index-gmy45vz2.js";
-import"./index-ss469dec.js";
-import"./index-0cj2zxbm.js";
-import"./index-mssqn2sq.js";
+  PrimitiveScript
+} from "./index-cd5x18qh.js";
 import {
-  createWorkflowStepRegistry
-} from "./index-2c3e2xh8.js";
-import"./index-7myvn0f0.js";
+  ScalarScript
+} from "./index-v0s24t8j.js";
+import"./index-by5gpp8x.js";
+import"./index-5y7qba1c.js";
 import {
-  Workspace,
-  command,
-  script
-} from "./index-6rhabeev.js";
-import"./index-vg0sj9nc.js";
-import"./index-mxvakhsm.js";
-import"./index-xys926f2.js";
-import"./index-67546d0j.js";
-import"./index-r24hmh0q.js";
+  WorkflowRunner
+} from "./index-j9vnq8tr.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.script.ts
 import { Logger } from "akanjs/common";