@akanjs/cli 3.0.0-alpha.45 → 3.0.0-alpha.47

package/{primitive.command-bw0nes6x.js → primitive.command-4fcn8k83.js}

@@ -1,20 +1,20 @@
 // @bun
 import {
   PrimitiveScript
-} from "./index-9jsnb4vw.js";
-import"./index-mykmf6wd.js";
+} from "./index-97cw8sg1.js";
+import"./index-xrdrttjb.js";
 import"./index-ss469dec.js";
-import"./index-qc0tnhs2.js";
+import"./index-4z05haak.js";
 import"./index-sh01r3pm.js";
 import {
   renderPrimitiveReport
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

package/{quality.command-g1s2wt8b.js → quality.command-hx5af2yn.js}

@@ -7,11 +7,12 @@ import {
   command,
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
-  appRootAllowedFiles,
-  libFacetRootAllowedFiles
-} from "./index-8vkkm7v0.js";
+  isAllowedLibFacetRootFile,
+  rootAllowedDirs,
+  rootAllowedFiles
+} from "./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";
@@ -476,7 +477,7 @@ var SUGGESTED_RULES = [
   "Use domain module folders consistently: lib/<model> for database modules, lib/_<service> for service modules, and lib/__scalar/<scalar> for scalar modules.",
   "Keep module UI filenames predictable: database modules use <Model>.Template/Unit/Util/View/Zone.tsx, service modules use <Service>.Util/Zone.tsx, and scalar modules use <Scalar>.Template/Unit.tsx.",
   "Hand a form control its store setter by reference so the field publishes an agent tool; put normalization in the control's transform prop and a multi-write in a _postSet<Field> hook on the store.",
-  "Move shared app utilities to apps/*/common instead of creating apps/*/base.",
+  "Move shared app and lib utilities to common/ instead of creating apps/*/base or libs/*/base.",
   "Avoid large mixed-purpose class files; class export files should import helpers from neighboring utility files instead of declaring them inline."
 ];
 var CONVENTION_SUFFIXES = [
@@ -503,7 +504,10 @@ var RULE_FIXES = {
   "akan.file.component-internal-declaration": "Move the type or helper to a type/util file in ui/, webkit/, or common/ by purpose. If it is the component's props, declare it as `interface <Component>Props`.",
   "akan.file.component-export": "Move the value or type to a util/constant/type file in ui/, webkit/, or common/ and import it. Adding `export` is not a valid fix \u2014 only PascalCase components and their `<Component>Props` interface belong here.",
   "akan.layout.app-root-file": "Move the file into a conventional app folder (common, env, lib, page, private, public, script, srvkit, ui, or webkit).",
-  "akan.layout.lib-root-file": "Move the file into a domain module folder under lib/; keep lib root limited to generated support facets.",
+  "akan.layout.app-root-folder": "Move the folder's contents into a conventional app folder (common, env, lib, page, private, public, script, srvkit, ui, or webkit) and delete it.",
+  "akan.layout.lib-root-file": "Move the file into a conventional lib folder (common, env, lib, page, private, public, srvkit, ui, or webkit).",
+  "akan.layout.lib-root-folder": "Move the folder's contents into a conventional lib folder (common, env, lib, page, private, public, srvkit, ui, or webkit) and delete it.",
+  "akan.layout.lib-facet-file": "Move the file into a domain module folder under lib/; keep the lib facet root limited to generated support facets.",
   "akan.layout.module-ui-file": "Rename the file to an allowed module UI name, or move it to ui/ if it is not a module component.",
   "akan.ssr.unnecessary-use-client": 'Delete the "use client" directive so the file renders on the server. If it exists only to wrap one client child, drop the wrapper and use the child directly.',
   "akan.ssr.client-static-component": "Move the component to a server file \u2014 a <Model>.Unit.tsx / <Model>.View.tsx for a module, or a ui/ file with no directive \u2014 and reference it from the client file.",
@@ -743,25 +747,30 @@ class AkanQualityScanner {
     ];
   }
   #scanLayoutQuality(sourceFile) {
-    const segments = sourceFile.file.split("/");
     const warnings = [];
-    if (segments[0] === "apps" && segments.length === 3 && !appRootAllowedFiles.has(segments[2])) {
-      warnings.push({
-        rule: "akan.layout.app-root-file",
-        scope: "layout",
-        severity: "warning",
-        file: sourceFile.file,
-        message: `Unexpected app root file "${segments[2]}". Keep application code in conventional app folders.`
-      });
+    const rootEntry = getSysRootEntry(sourceFile.file);
+    if (rootEntry) {
+      const { type, name, isDir } = rootEntry;
+      const allowed = isDir ? rootAllowedDirs[type].has(name) : rootAllowedFiles[type].has(name);
+      const kind = isDir ? "folder" : "file";
+      if (!allowed) {
+        warnings.push({
+          rule: `akan.layout.${type}-root-${kind}`,
+          scope: "layout",
+          severity: "warning",
+          file: sourceFile.file,
+          message: `Unexpected ${type} root ${kind} "${name}". Keep ${type} code in conventional ${type} folders.`
+        });
+      }
     }
-    const libRootFile = getLibRootFile(sourceFile.file);
-    if (libRootFile && !libFacetRootAllowedFiles.has(libRootFile)) {
+    const libFacetFile = getLibFacetRootFile(sourceFile.file);
+    if (libFacetFile && !isAllowedLibFacetRootFile(libFacetFile)) {
       warnings.push({
-        rule: "akan.layout.lib-root-file",
+        rule: "akan.layout.lib-facet-file",
         scope: "layout",
         severity: "warning",
         file: sourceFile.file,
-        message: `Unexpected lib root file "${libRootFile}". Keep direct lib root files limited to generated support facets.`
+        message: `Unexpected lib facet root file "${libFacetFile}". Keep direct lib/ root files limited to generated support facets.`
       });
     }
     const moduleUiWarning = getModuleUiWarning(sourceFile.file);
@@ -1115,7 +1124,19 @@ function getConventionDescription(suffix, modelName) {
     return `${modelName}Internal, ${modelName}Slice, or ${modelName}Endpoint`;
   return `${modelName}Store`;
 }
-function getLibRootFile(file) {
+var sysRootTypes = { apps: "app", libs: "lib" };
+function getSysRootEntry(file) {
+  const segments = file.split("/");
+  const root = segments[0];
+  const name = segments[2];
+  if (!root || !name || segments.length < 3)
+    return null;
+  const type = sysRootTypes[root];
+  if (!type)
+    return null;
+  return { type, name, isDir: segments.length > 3 };
+}
+function getLibFacetRootFile(file) {
   const segments = file.split("/");
   if ((segments[0] === "libs" || segments[0] === "apps") && segments.length === 4 && segments[2] === "lib")
     return segments[3];

package/{repair.command-mzwtejpk.js → repair.command-ysxd8pef.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   RepairRunner
-} from "./index-xyrb7pk5.js";
-import"./index-g9e2fhw2.js";
-import"./index-tsmjxph2.js";
+} from "./index-5fe016p2.js";
+import"./index-24h5bqpj.js";
+import"./index-5em412h5.js";
 import {
   Workspace,
   command,
   script
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-1577bej2.js";

package/{scalar.command-rm6k3c65.js → scalar.command-3chgxybs.js}

@@ -1,18 +1,18 @@
 // @bun
 import {
   ScalarScript
-} from "./index-x33gnap3.js";
+} from "./index-7w5vv8jk.js";
 import"./index-ss469dec.js";
 import"./index-sh01r3pm.js";
 import {
   renderPrimitiveReport
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   Sys,
   command
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

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/{workflow.command-g2cgcgxn.js → workflow.command-endxfzv5.js}

@@ -1,30 +1,30 @@
 // @bun
 import {
   WorkflowRunner
-} from "./index-3dp7x6rc.js";
+} from "./index-k7sm38v6.js";
 import {
   ScalarScript
-} from "./index-x33gnap3.js";
+} from "./index-7w5vv8jk.js";
 import {
   PrimitiveScript
-} from "./index-9jsnb4vw.js";
+} from "./index-97cw8sg1.js";
 import {
   ModuleScript
-} from "./index-mykmf6wd.js";
+} from "./index-xrdrttjb.js";
 import"./index-ss469dec.js";
-import"./index-qc0tnhs2.js";
+import"./index-4z05haak.js";
 import"./index-sh01r3pm.js";
-import"./index-g9e2fhw2.js";
+import"./index-24h5bqpj.js";
 import {
   createWorkflowStepRegistry
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command,
   script
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-1577bej2.js";

package/{workspace.command-f7jerqb2.js → workspace.command-zkhcjsj2.js}

@@ -1,40 +1,40 @@
 // @bun
 import {
   ContextScript
-} from "./index-0h212yqe.js";
-import"./index-xyrb7pk5.js";
-import"./index-3dp7x6rc.js";
-import"./index-x33gnap3.js";
-import"./index-9jsnb4vw.js";
-import"./index-mykmf6wd.js";
+} from "./index-866yqz3y.js";
+import"./index-5fe016p2.js";
+import"./index-k7sm38v6.js";
+import"./index-7w5vv8jk.js";
+import"./index-97cw8sg1.js";
+import"./index-xrdrttjb.js";
 import"./index-ss469dec.js";
-import"./index-qc0tnhs2.js";
+import"./index-4z05haak.js";
 import {
   CloudScript
-} from "./index-becx1t0k.js";
+} from "./index-awt2gttt.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-t71zvmt9.js";
+} from "./index-2kjyh1jb.js";
 import {
   PackageScript
-} from "./index-33zce8gt.js";
-import"./index-mz5jtaq7.js";
+} from "./index-7zd96bng.js";
+import"./index-zgkey4d0.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
 import {
   AgentScript
-} from "./index-k6fvbcj1.js";
-import"./index-g9e2fhw2.js";
-import"./index-tsmjxph2.js";
+} from "./index-xe3ychw5.js";
+import"./index-24h5bqpj.js";
+import"./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   ApplicationScript
-} from "./index-8d2sv6pw.js";
+} from "./index-hnysajy8.js";
 import {
   LibraryScript
-} from "./index-73rnbwgg.js";
+} from "./index-6bs24rb4.js";
 import"./index-76rn3g2c.js";
 import {
   Exec,
@@ -42,7 +42,7 @@ import {
   command,
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import"./index-fgc8r6dj.js";
 import {
   ThemeValidator,
@@ -59,7 +59,7 @@ import {
   collectScopeRecipeSources,
   extractAgentBlock,
   renderScopeAgentBlock
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import {
   collectRecipeSources,