@akanjs/cli 3.0.0-alpha.3 → 3.0.0-alpha.4

package/{repair.command-ehf2g112.js → repair.command-nakkq2zp.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   RepairRunner
-} from "./index-mr5s7mqd.js";
-import"./index-a00jg8x8.js";
-import"./index-rzwcpcc3.js";
+} from "./index-b978vs2e.js";
+import"./index-4yp06pn1.js";
+import"./index-4zgs8g1w.js";
 import {
   Workspace,
   command,
   script
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
-import"./index-mxvakhsm.js";
+} from "./index-jk9q6pse.js";
+import"./index-jtm86byd.js";
+import"./index-6pz1j0zj.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{scalar.command-7a2jtv33.js → scalar.command-fjq272gs.js}

@@ -1,19 +1,19 @@
 // @bun
 import {
   ScalarScript
-} from "./index-ec09pws3.js";
+} from "./index-fmgbwsr5.js";
 import"./index-ss469dec.js";
-import"./index-0cj2zxbm.js";
+import"./index-3pgtw35d.js";
 import {
   renderPrimitiveReport
-} from "./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-4zgs8g1w.js";
+import"./index-xwgm94zr.js";
 import {
   Sys,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
-import"./index-mxvakhsm.js";
+} from "./index-jk9q6pse.js";
+import"./index-jtm86byd.js";
+import"./index-6pz1j0zj.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/templates/lib/db.ts

@@ -16,9 +16,7 @@ ${databaseModules.map((module) => `import * as ${module}Db from "./${module}/${m
 ${libs.map((lib) => `export { db as ${lib} } from "@libs/${lib}/server";`).join("\n")}
 
 ${databaseModules.map((module) => `class ${capitalize(module)}Input extends by(cnst.${capitalize(module)}Input) {}`).join("\n")}
-${databaseModules.map((module) => `class ${capitalize(module)}Insight extends by(cnst.${capitalize(module)}Insight) {}`).join("\n")}
 ${databaseModules.length ? `export type { ${databaseModules.map((module) => `${capitalize(module)}Input`).join(", ")} };` : ""}
-${databaseModules.length ? `export type { ${databaseModules.map((module) => `${capitalize(module)}Insight`).join(", ")} };` : ""}
 
 ${scalarModules.map((module) => `export type * from "./__scalar/${module}/${module}.document";`).join("\n")}
 ${databaseModules.map((module) => `export type * from "./${module}/${module}.document";`).join("\n")}
@@ -26,7 +24,7 @@ ${databaseModules.map((module) => `export type * from "./${module}/${module}.doc
 ${databaseModules
   .map((module) => {
     const names = { Module: module.charAt(0).toUpperCase() + module.slice(1) };
-    return `export const ${module} = DatabaseRegistry.buildModel("${module}" as const, ${names.Module}Input, ${module}Db.${names.Module}, ${module}Db.${names.Module}Model, cnst.${names.Module}, ${names.Module}Insight, ${module}Db.${names.Module}Filter);`;
+    return `export const ${module} = DatabaseRegistry.buildModel("${module}" as const, ${names.Module}Input, ${module}Db.${names.Module}, ${module}Db.${names.Module}Model, cnst.${names.Module}, cnst.${names.Module}Insight, ${module}Db.${names.Module}Filter);`;
   })
   .join("\n")}
 ${scalarModules.map((module) => `export const ${module} = DatabaseRegistry.buildScalar("${module}" as const, ${capitalize(module)});`).join("\n")}

package/templates/libRoot/base/baseLogic.ts

@@ -0,0 +1,14 @@
+interface Dict {
+  libName: string;
+}
+export default function getContent(scanInfo: null, dict: Dict) {
+  return `
+// 현 디렉토리에서는 프로젝트 내 전체적으로 사용되는 로직을 구현하며, 따라서 백/프론트 비의존적인 pure js 코드만 구현 가능합니다.
+// common폴더와 다른점은, base 코드는 시스템 전체에서 import되어 사용되므로, 가장 핵심적인 로직과 추상화된 기능만 구현해야합니다.
+// @${dict.libName}/base에서는 서버/클라이언트 관련 라이브러리(@*/server, @*/server, @*/client, @*/client)를 모두 import할 수 없으며, @*/base 라이브러리만 import 가능합니다.
+
+export const someBaseLogic = () => {
+  //
+};
+  `;
+}

package/templates/libRoot/base/index.ts

@@ -0,0 +1,8 @@
+interface Dict {
+  [key: string]: string;
+}
+export default function getContent(scanInfo: null, dict: Dict = {}) {
+  return `
+export * from "./baseLogic";
+  `;
+}

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

@@ -15,4 +15,3 @@ alwaysApply: false
 - 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/AGENTS.md.template

@@ -74,12 +74,11 @@ Use the local module shape before adding a new abstraction.
 9. Keep page and layout files server-oriented: route-level `usePage`, headers, static layout, and `akanjs/ui` `Tab` composition belong there.
 10. Put interactive loading, submit/import actions, local form state, and `router.push` in client `Util`, `Template`, or `Zone` components.
 11. Prefer `Tab` for static mode selection instead of extra `useState`; render one focused client component inside each `Tab.Panel`.
-12. Default to server rendering. Add `"use client"` only for a real client-only capability, and keep markup out of the component that carries it — see **SSR First** below.
-13. Keep server-only logic out of client surfaces and client-only code out of server imports.
-14. Treat `AKAN_PUBLIC_*` env vars as public. Never put secrets in them.
-15. Add or update tests when behavior, contracts, or CLI output changes.
-16. Update `*.abstract.md` when business invariants, workflows, or public behavior change.
-17. Run the smallest relevant verification command after changes. After touching any `.tsx`, that includes `akan quality ssr`.
+12. Keep server-only logic out of client surfaces and client-only code out of server imports.
+13. Treat `AKAN_PUBLIC_*` env vars as public. Never put secrets in them.
+14. Add or update tests when behavior, contracts, or CLI output changes.
+15. Update `*.abstract.md` when business invariants, workflows, or public behavior change.
+16. Run the smallest relevant verification command after changes.
 
 ## Common Commands
 
@@ -112,11 +111,7 @@ akan typecheck <%= appName %>
 # 3. Test — Run the test code (lib/*/*.signal.test.ts or others)
 akan test <%= appName %>
 
-# 4. SSR balance — only after touching .tsx files. Reports the server render share
-#    per app/lib and flags client code that should render on the server.
-akan quality ssr
-
-# 5. Full production build — bundles the app, runs all type/lint checks combined
+# 4. Full production build — bundles the app, runs all type/lint checks combined
 akan build <%= appName %>
 ```
 
@@ -133,8 +128,6 @@ akan create-scalar <scalar-name> <%= appName %>          # Add a scalar module (
 akan create-service <service-name> <%= appName %>        # Add a service module (lib/_<service-name>/)
 akan test <%= appName %>                             # Run the test code (lib/*/*.signal.test.ts or others)
 akan lint <%= appName %>                             # Lint only (no typecheck)
-akan quality scan                                # All code-quality warnings + SSR balance
-akan quality ssr                                 # SSR balance and client-boundary warnings only
 ```
 
 **CLI argument conventions.** Two argument styles, and mixing them up is a common mistake:
@@ -247,7 +240,7 @@ final fallback when no CLI command covers the change.
 | Add a reusable value type (e.g., Address, WorkHistory) | `lib/__scalar/<type>/` → constant, dictionary, abstract | `akan sync <name>` |
 | Create a new URL-visitable page | `page/` → `_index.tsx`, `_layout.tsx`, `[param]/_index.tsx` | Rebuild (akan start auto-detects) |
 | Change the app color theme / design tokens | `apps/<app>/page/styles.css` → override the semantic token values under `:root, [data-theme="dark"]` and `[data-theme="light"]` (`--primary`, `--background`, `--foreground`, …) | akan start hot-reloads |
-| Add a form or reusable UI component | `ui/` → PascalCase `.tsx`, **no** `"use client"` unless it uses a hook, event handler, store, or browser API | `akan sync <name>` |
+| Add a form or reusable UI component | `ui/` → PascalCase `.tsx` with `"use client"` if needed | `akan sync <name>` |
 | Add a React hook or browser helper | `webkit/` → camelCase `.ts` with `"use client"` | `akan sync <name>` |
 | Add a server-only guard, middleware, or adaptor | `srvkit/` → PascalCase `.ts` | `akan sync <name>` |
 | Add a pure helper (no DOM, no server API) | `common/` → camelCase `.ts` | `akan sync <name>` |
@@ -261,127 +254,14 @@ final fallback when no CLI command covers the change.
 | Use JS `#private` in `*.constant.ts`, `*.document.ts`, `*.service.ts`, or `*.store.ts` | `no-js-private-class-method.grit` bans `#private` in exactly those four file suffixes. The rule is scoped by file path, not class shape — `#private` stays the house style under `srvkit/`, including `adapt()` classes. | `private _methodName()` in those four files; `#methodName()` in `srvkit/` |
 | 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 |
 | `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 |
 | Use "use client" or `useState`/`useEffect` in pages/*.tsx, *.Unit.tsx, and *.View.tsx files | Server code cannot use React hooks. Wrap in a separate `"use client"` component. | Move hook logic to `webkit/` or a `"use client"` UI component |
 | Use `<a>` tag for internal navigation between pages | Akan.js uses `<Link>` from `akanjs/ui` for client-side navigation — avoids full page reloads. | `import { Link } from "akanjs/ui"` and use `<Link href="/task">...</Link>` |
 | Name a custom `Endpoint`/`Slice` like a generated CRUD op — `create<Model>`, `update<Model>`, `remove<Model>`, `view<Model>`, `edit<Model>`, `merge<Model>` | These names are already auto-generated. A collision can pass sync/typecheck/build and only fail at runtime. | Pick a distinct verb, e.g. `startTask`/`archiveTask`, never `createTask` for a custom endpoint |
-| Add `"use client"` to a file that renders markup but uses no hook, event handler, store, or browser API | The directive is a cost, not a formality: everything behind it ships twice, as HTML and as JS that re-runs in the browser. | Delete the directive. `akan quality ssr` flags this as `akan.ssr.unnecessary-use-client` |
-| Put a large static subtree inside a client component that only needs one `onClick` | The whole subtree lands in the bundle for the sake of one handler. | Keep the handler in a small client shell and pass the static markup in as `children`, or move it to a `Unit`/`View` |
-| Load server data with `useEffect(() => { void st.do.initTaskInTodo(); }, [])` | The page renders an empty shell, hydrates, then round-trips for data the server already had. | `await fetch.initTaskInTodo()` in the page and pass `init` to the `Zone` |
-
-## SSR First — Server Rendering Is The Default
-
-Akan is SSR-first. Every JSX element that renders on the server ships as HTML and costs nothing to hydrate; every
-element behind `"use client"` ships twice — as markup and as bundled JS that must re-run in the browser. The
-boundary question is not which file *may* be client, it is **how little** ends up on the client side.
-
-**The default is server. `"use client"` is a cost you justify per component, not a habit.** A component earns the
-directive only by using a client-only capability: a React hook, a JSX event handler, the store (`st.use.*` /
-`st.do.*`), a browser global, or a client-only third-party package. Rendering markup, mapping over data, reading a
-route param, and calling `l()` are all server work — `usePage()` and `l()` are legal in server components and never
-force a boundary.
-
-The file role decides *where* the boundary sits (`Template`/`Zone`/`Util` are client, `Unit`/`View` are server); it
-does not decide how much markup sits behind it. A `Zone` that hoards markup is still an SSR regression.
-
-Measure with `akan quality ssr` (`--format json` for tooling). It reports the server render share per app and lib —
-server-rendered JSX elements over total — plus the warnings below. Treat **50% server share as the floor** and a
-falling share as a regression to justify or revert.
-
-| Rule | Means |
-|---|---|
-| `akan.ssr.unnecessary-use-client` | The directive is there but nothing in the file needs it. Delete it. |
-| `akan.ssr.client-static-component` | A component in a client file renders real markup with zero client-only capability — pure server work sitting in the bundle. |
-| `akan.ssr.client-static-markup` | A large subtree wraps one or two interactive touches. Split it: interaction stays client, markup goes server. |
-| `akan.ssr.client-mount-load` | A `useEffect(…, [])` loads server data. The page can fetch it before the first byte. |
-| `akan.ssr.module-missing-server-view` | A module renders only from `Template`/`Zone`/`Util` and has no `Unit`/`View` at all. |
-| `akan.ssr.template-client-state` | A `Template` holds form state in `useState` instead of the store. |
-
-A third-party client package and the `ui/<Folder>/index_.tsx` + `lazy()` boundary both justify the directive and are
-not flagged. Interaction-driven `fetch.*` inside an `onClick` is not flagged either — only mount-time loads are,
-because those are the ones the server could have performed.
-
-### Server-Side Implementation Playbook
-
-**① Wrap the interaction, not the UI.** The smallest useful client component adds one behaviour and renders
-`children` untouched, so the markup inside never reaches the bundle.
-
-```tsx
-// apps/<%= appName %>/ui/ClickWrapper.tsx
-"use client";
-export const ClickWrapper = ({ children, onPick }: ClickWrapperProps) => <div onClick={onPick}>{children}</div>;
-
-// in a server page — Task.Unit.Card stays server-rendered
-<ClickWrapper onPick={…}>
-  <Task.Unit.Card task={task} />
-</ClickWrapper>
-```
-
-**② Split compound components so panels stay on the server.** A tab, accordion, or disclosure needs client state
-only for *which* part is visible — never for what the parts contain. `Tab` / `Tab.Menus` / `Tab.Menu` / `Tab.Panel`
-from `akanjs/ui` is the reference shape: only the provider and menu hold state, and `<Tab.Panel>` renders its
-children as-is, so a server `Unit`/`View` passed in stays server-rendered.
-
-```tsx
-<Tab defaultMenu="detail">
-  <Tab.Menus>
-    <Tab.Menu menu="detail">{l("task.detail")}</Tab.Menu>
-    <Tab.Menu menu="history">{l("task.history")}</Tab.Menu>
-  </Tab.Menus>
-  <Tab.Panel menu="detail">
-    <Task.View.General task={task} />
-  </Tab.Panel>
-</Tab>
-```
-
-Never collapse this into one `"use client"` file with a mode `useState` and every panel body inlined.
-
-**③ Sync state instead of fetching it.** A server component cannot hold state, so render the initial data on the
-server and hand it across the boundary as a serializable object. That is what `init` / `view` props are: the page
-calls `fetch.initTaskInTodo()` / `fetch.viewTask(id)`, passes the result into a `Zone`, and `Load.Units` /
-`Load.View` hydrate the store from it.
-
-```tsx
-export default async function Page() {
-  const [{ taskInitInTodo }] = await Promise.all([fetch.initTaskInTodo()]);
-  return <Task.Zone.Card init={taskInitInTodo} sliceName="taskInTodo" />;
-}
-```
-
-**④ Push the boundary down to the leaf that needs it.** When a `Zone` reads the store, it should hold *zero* markup
-and delegate to a server `View`, so the whole detail surface renders server-side wherever a page uses the `View`
-directly.
-
-```tsx
-"use client";
-export const Self = () => <Task.View.General task={st.use.task()} />;
-```
-
-**⑤ Hand the promise across, not the awaited value.** `ClientInit` / `ClientView` are `PromiseOrObject<T>`, so a
-page may pass an unawaited `fetch.initTaskInTodo()` and `Load.*` resolves it behind a skeleton. `await` blocks the
-shell for data the page needs immediately; passing the promise streams the rest. Independent fetches still go
-through one `Promise.all`.
-
-**⑥ Use named `ReactNode` slots, not just `children`.** A client shell can take several server-rendered subtrees:
-`Layout.Navbar` accepts `title`, `back`, `left`, `right`, and `children`, so it composes server content in five
-places instead of absorbing it.
-
-**⑦ Let the server do the derived work.** Display and predicate logic belongs on `LightTask` (`isNew()`,
-`canWrite(user?)`, `formatTimes()`), and enum→class lookups belong in a module-scope `as const` map. Both sides call
-the same method, so a client component that exists only to compute a label is markup in the wrong place.
-
-**⑧ Gate auth on the server.** Check the session in `_layout.tsx` and redirect there, before any HTML is sent. A
-client-side auth check costs a hydration round-trip and flashes the wrong UI first.
-
-**⑨ Prefer CSS over client state for pure visibility.** A `data-*` attribute plus `group-data-[…]` variants, or
-`<details>`/`<summary>`, keeps both branches server-rendered. Reach for `useState` when the state is real, not when
-a Tailwind variant would do.
-
-**⑩ Keep the heavy island out of the first load.** A large client-only widget goes behind the
-`ui/<Folder>/index_.tsx` + `lazy()` pair so the server renders the page around it.
 
 ## Code Style
 
@@ -420,11 +300,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<...>`.
 
@@ -650,7 +533,7 @@ export class TaskService extends serve(db.task, ({ plug }) => ({
 For a custom adapter class (not a predefined role), pass the class itself, e.g. `ipfsApi: plug(IpfsApi)`
 (see `libs/shared/lib/file/file.service.ts`). Injecting a file/image field is usually simpler than calling
 storage directly: declare `image: field(File).optional()` (or `images: field([File])`) on the model and let the
-store's generated `upload<Field>On<Model>(fileList)` action handle the upload. Add `{ cascade: "removeRef" }` to that
+store's generated `upload<Field>On<Model>(fileList)` action handle the upload. Add `{ cascade: "remove" }` to that
 field when the file belongs to the model alone, and removing the model removes the file and its stored object.
 
 ---
@@ -868,23 +751,12 @@ A short list of things the type system does not always catch:
   `secret` / `hidden` / `resolve()` fields with `text` throw at class-build time — the mirror is plaintext. Search
   runs on sqlite/libsql only; `q.search()` against Postgres throws. `thumb` is mirrored for rendering and is not
   indexed.
-- **`cascade` names a direction, and the wrong one is a data loss.** Both actions can sit on the same field shape,
-  so the value has to say which end goes away. `cascade: "removeRef"` on the relation an owner holds
-  (`image: field(File, { cascade: "removeRef" })`, arrays included) removes the target when the owner is removed;
-  only a relation accepts it. `cascade: "removeWith"` on a child's own reference to its owner
-  (`field(ID, { ref: "agentSession", cascade: "removeWith" })`, or a relation, or `refPath` for a polymorphic
-  owner whose type field must be an `enumOf`) removes the child when the owner is — the owner never learns its
-  children exist. The removal runs through the **target's service** so its `_postRemove` runs too, unless the
-  target provably has no removal side effect, in which case the boot-time plan collapses it into one query. A
-  `removeWith` field gets its index automatically. Nothing checks for other references to the same target, so
-  `removeRef` asserts exclusive ownership. Removal is soft but a storage delete is not, and a query-level removal
-  fires no hooks and therefore no cascade.
-- **Removal is always soft, and `delete` is reserved.** `remove(id)`, the facade's `removeMany(query)`, and the
-  store's `removeManyByQuery` all stamp `removedAt`; the framework has no hard delete for a model table.
-- **The model facade spells out `Many`/`One` on its writes** — `updateOne`, `updateMany`, `removeOne`, `removeMany`
-  — because a bare `update`/`remove` would read like the document-path `update(id)` / `doc.remove()` while hitting
-  every match. Reads keep the short `find`/`findOne` pair, and counting is `count(query)` (`countDocuments` is
-  `@deprecated`).
+- **`cascade: "remove"` takes a relation's target down with its owner.** Declare it on the relation itself —
+  `image: field(File, { cascade: "remove" })`, arrays included. The removal runs through the **target's service**,
+  so the target's own `_postRemove` runs too; that is how removing a model also deletes the file's stored object.
+  Only a relation accepts it: a `String`, an `ID`, or a scalar throws while the class is being built. Nothing
+  checks for other references to the same target, so declaring it asserts exclusive ownership. Document removal is
+  soft but the storage delete is not, and query-level removal fires no hooks and therefore no cascade.
 - **`q.search()` is a filter node, not a slice requirement.** Prefer
   `bySearch: filter().arg("text", String).query((text, q) => q.search(text, { prefix: true }))` — the generated
   `listBySearch` / `countBySearch` / `queryBySearch` / `insightBySearch` come for free. Only add a search slice when
@@ -962,12 +834,8 @@ akan sync automatically generates APIs across all layers. Only write custom logi
 | `pick[Query](args)`, `pickId[Query](args)` | Find one (throw if not found) |
 | `exists[Query](args)`, `count[Query](args)` | Existence check and count |
 | `insight[Query](args)`, `query[Query](args)` | Insight and raw query |
-| `remove[Query](args)`, `removeOne[Query](args)` | Query-level soft remove — all matches, or the newest one (`createdAt` desc, not caller-chosen) |
-| `update[Query](args).set(patch)`, `updateOne[Query](args).set(patch)` | Query-level update — the patch lands on a terminal `.set()`, because a filter's trailing args may be optional |
-
-**Rule**: Define `Filter` with `.query()` conditions in `document.ts`. akan sync auto-generates all 14 query helper methods per filter. Write `Document` chain methods only for state transitions with validation.
 
-**The four query-level writes fire no hooks**, so no `_pre`/`_postRemove` and no cascade run — same as `updateManyByQuery`. Reach for them when the model carries no removal side effect; otherwise remove documents one at a time. A filter keyed after its own model (filter `chat` on model `chat`) is rejected at boot, because `removeChat`/`updateChat` would otherwise shadow the generated single-document CRUD.
+**Rule**: Define `Filter` with `.query()` conditions in `document.ts`. akan sync auto-generates all 10 query helper methods per filter. Write `Document` chain methods only for state transitions with validation.
 
 ## Generated Context
 

package/templates/workspaceRoot/biome.json.template

@@ -210,6 +210,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/{workflow.command-e0tt0vk2.js → workflow.command-jswbgk90.js}

@@ -1,31 +1,31 @@
 // @bun
 import {
   WorkflowRunner
-} from "./index-2q1f5j9k.js";
+} from "./index-csqk9z5j.js";
 import {
   PrimitiveScript
-} from "./index-bekddz9q.js";
+} from "./index-r4w8cry5.js";
 import {
   ModuleScript
-} from "./index-yzmhasdb.js";
-import"./index-bbkek1bp.js";
+} from "./index-vhv3xnjz.js";
+import"./index-hjzr8ja1.js";
 import {
   ScalarScript
-} from "./index-ec09pws3.js";
+} from "./index-fmgbwsr5.js";
 import"./index-ss469dec.js";
-import"./index-0cj2zxbm.js";
-import"./index-a00jg8x8.js";
+import"./index-3pgtw35d.js";
+import"./index-4yp06pn1.js";
 import {
   createWorkflowStepRegistry
-} from "./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-4zgs8g1w.js";
+import"./index-xwgm94zr.js";
 import {
   Workspace,
   command,
   script
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
-import"./index-mxvakhsm.js";
+} from "./index-jk9q6pse.js";
+import"./index-jtm86byd.js";
+import"./index-6pz1j0zj.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{workspace.command-fpda0evj.js → workspace.command-h9wwcjpt.js}

@@ -1,48 +1,48 @@
 // @bun
 import {
   ContextScript
-} from "./index-1pvex4az.js";
-import"./index-mr5s7mqd.js";
-import"./index-2q1f5j9k.js";
-import"./index-bekddz9q.js";
-import"./index-yzmhasdb.js";
-import"./index-bbkek1bp.js";
+} from "./index-1s71fwrq.js";
+import"./index-b978vs2e.js";
+import"./index-csqk9z5j.js";
+import"./index-r4w8cry5.js";
+import"./index-vhv3xnjz.js";
+import"./index-hjzr8ja1.js";
 import {
   CloudScript
-} from "./index-nm6wghb6.js";
+} from "./index-ybybkec0.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-zasydjxd.js";
+} from "./index-xj8bks3p.js";
 import {
   PackageScript
-} from "./index-k95xkh4p.js";
-import"./index-ec09pws3.js";
+} from "./index-e3qskyt2.js";
+import"./index-fmgbwsr5.js";
 import"./index-ss469dec.js";
-import"./index-t3723f99.js";
+import"./index-y0k42k04.js";
 import {
   GlobalConfig
-} from "./index-0cj2zxbm.js";
+} from "./index-3pgtw35d.js";
 import {
   AgentScript
-} from "./index-ej426mcr.js";
-import"./index-a00jg8x8.js";
-import"./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-n0z3f2xg.js";
+import"./index-4yp06pn1.js";
+import"./index-4zgs8g1w.js";
+import"./index-xwgm94zr.js";
 import {
   ApplicationScript
-} from "./index-e16gnn26.js";
+} from "./index-tq1y56tp.js";
 import"./index-76rn3g2c.js";
 import {
   LibraryScript
-} from "./index-7c6k4yvg.js";
+} from "./index-cn24dcqn.js";
 import {
   Exec,
   Workspace,
   command,
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-jk9q6pse.js";
 import"./index-fgc8r6dj.js";
 import {
   ThemeValidator,
@@ -59,8 +59,8 @@ import {
   collectScopeRecipeSources,
   extractAgentBlock,
   renderScopeAgentBlock
-} from "./index-hgna5rjy.js";
-import"./index-mxvakhsm.js";
+} from "./index-jtm86byd.js";
+import"./index-6pz1j0zj.js";
 import {
   collectRecipeSources,
   scanRecipes

package/guidelines/ssrRule/ssrRule.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "SSR Rule",
-  "description": "Akan SSR-first rendering rules — keep JSX on the server and justify every client boundary",
-  "group": "core",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "Client boundary shells that render server children untouched",
-      "path": "{apps,libs}/*/ui/**/*.tsx",
-      "sample": 4
-    },
-    {
-      "type": "example",
-      "description": "Module UI split across client Zone/Template/Util and server Unit/View",
-      "path": "{apps,libs}/*/lib/*/*.tsx",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./ssrRule.instruction.md",
-    "contents": ["purpose", "when a client boundary is earned", "quality rules", "implementation playbook"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Keep output parseable for codegen",
-      "Name the akan.ssr.* rule ids the quality scanner emits",
-      "Ground every pattern in a file that exists in the workspace"
-    ]
-  }
-}