@akanjs/cli 3.0.0-alpha.46 → 3.0.0-alpha.48

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/{workspace.command-f2966kvr.js → workspace.command-zkhcjsj2.js}

@@ -11,11 +11,11 @@ import"./index-ss469dec.js";
 import"./index-4z05haak.js";
 import {
   CloudScript
-} from "./index-xc6bbz6e.js";
+} from "./index-awt2gttt.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-3h0d06v8.js";
+} from "./index-2kjyh1jb.js";
 import {
   PackageScript
 } from "./index-7zd96bng.js";
@@ -31,7 +31,7 @@ import"./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   ApplicationScript
-} from "./index-yay1fd05.js";
+} from "./index-hnysajy8.js";
 import {
   LibraryScript
 } from "./index-6bs24rb4.js";