@akanjs/cli 3.0.0-alpha.9 → 3.0.0-alpha.90

package/templates/app/env/env.client.debug.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { AppClientEnv } from "./env.client.type";
 
-export const env: AppClientEnv = {
-  ...getEnv(),
-} as const;
+export const env: AppClientEnv = {};

package/templates/app/env/env.client.develop.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { AppClientEnv } from "./env.client.type";
 
-export const env: AppClientEnv = {
-  ...getEnv(),
-} as const;
+export const env: AppClientEnv = {};

package/templates/app/env/env.client.local.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { AppClientEnv } from "./env.client.type";
 
-export const env: AppClientEnv = {
-  ...getEnv(),
-} as const;
+export const env: AppClientEnv = {};

package/templates/app/env/env.client.main.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { AppClientEnv } from "./env.client.type";
 
-export const env: AppClientEnv = {
-  ...getEnv(),
-} as const;
+export const env: AppClientEnv = {};

package/templates/app/env/env.client.testing.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { AppClientEnv } from "./env.client.type";
 
-export const env: AppClientEnv = {
-  ...getEnv(),
-} as const;
+export const env: AppClientEnv = {};

package/templates/app/env/env.client.type.ts

@@ -5,12 +5,8 @@ interface Dict {
 }
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict = {}) {
   return `
-import type { ClientEnv } from "akanjs/base";
-
-export type AppClientEnv = ClientEnv & {
-  cloudflare?: {
-    siteKey: string;
-  };
+export type AppClientEnv = {
+  // apply public envs here
 };
   `;
 }

package/templates/app/env/env.server.debug.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { ModulesOptions } from "../lib/option";
 
-export const env: ModulesOptions = {
-  ...getEnv(),
-};
+export const env: ModulesOptions = {};

package/templates/app/env/env.server.develop.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { ModulesOptions } from "../lib/option";
 
-export const env: ModulesOptions = {
-  ...getEnv(),
-};
+export const env: ModulesOptions = {};

package/templates/app/env/env.server.local.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { ModulesOptions } from "../lib/option";
 
-export const env: ModulesOptions = {
-  ...getEnv(),
-};
+export const env: ModulesOptions = {};

package/templates/app/env/env.server.main.ts.template

@@ -1,7 +1,3 @@
-import { getEnv } from "akanjs/base";
-
 import type { ModulesOptions } from "../lib/option";
 
-export const env: ModulesOptions = {
-  ...getEnv(),
-};
+export const env: ModulesOptions = {};

package/templates/app/main.ts

@@ -5,7 +5,9 @@ interface Dict {
 }
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
   return `
-import { AkanApp } from "akanjs/server";
+// Not the \`akanjs/server\` barrel: it re-exports AkanServer, whose graph the gateway never runs. Through the
+// barrel this process evaluates 35MB of SSR renderer and DB driver to spawn children and relay bytes.
+import { AkanApp } from "akanjs/server/akanApp";
 
 const run = async () => {
   await new AkanApp().start();

package/templates/appSample/lib/task/task.signal.ts

@@ -1,7 +1,8 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return `import { endpoint, internal, Public, slice } from "akanjs/signal";
+  return `import { SignedIn } from "@apps/${dict.appName}/srvkit";
+import { endpoint, internal, None, Public, slice } from "akanjs/signal";
 
 import * as cnst from "../cnst";
 import * as srv from "../srv";
@@ -21,20 +22,24 @@ import * as srv from "../srv";
 
 export class TaskInternal extends internal(srv.task, ({ interval }) => ({})) {}
 
-export class TaskSlice extends slice(srv.task, { guards: { root: Public, get: Public, cru: Public } }, (init) => ({
+// Guards, per key: root = the generated admin API (runs any filter with caller-supplied args), get = reads,
+// cru = create/update/remove. root and cru are never Public; None here means "nobody until you name a guard".
+export class TaskSlice extends slice(srv.task, { guards: { root: None, get: Public, cru: SignedIn } }, (init) => ({
   inPublic: init().exec(function () {
     return this.taskService.queryAny();
   }),
 })) {}
 
+// Every custom endpoint names its own guards array — the slice's map above only covers generated CRUD.
+// It is also the MCP decision: an endpoint declaring no guard is not published to agents at all.
 export class TaskEndpoint extends endpoint(srv.task, ({ mutation }) => ({
-  startTask: mutation(cnst.Task)
+  startTask: mutation(cnst.Task, { guards: [SignedIn] })
     .param("taskId", String)
     .exec(async function (taskId) {
       return await this.taskService.startTask(taskId);
     }),
 
-  completeTask: mutation(cnst.Task)
+  completeTask: mutation(cnst.Task, { guards: [SignedIn] })
     .param("taskId", String)
     .exec(async function (taskId) {
       return await this.taskService.completeTask(taskId);
@@ -48,7 +53,7 @@ export class TaskEndpoint extends endpoint(srv.task, ({ mutation }) => ({
 //   taskEvent: pubsub(cnst.Task).exec(...),
 //   // search: search parameters (optional, URL query string)
 //   searchTask: query(cnst.LightTask).search("keyword", String).exec(...),
-//   // guards: authentication/authorization guards
-//   // export class TaskEndpoint extends endpoint(srv.task, { guards: { root: SignedIn } }, ({ query, mutation }) => ({})) {}
+//   // mcp: false keeps a guarded endpoint off the agent shelf without changing its authorization
+//   startTask: mutation(cnst.Task, { guards: [SignedIn], mcp: false })...
 `;
 }

package/templates/appSample/srvkit/AuthGuard.ts

@@ -3,7 +3,7 @@ import type { AppInfo, LibInfo } from "akanjs";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
   return {
     filename: "AuthGuard.ts",
-    content: `import type { Guard, SignalContext } from "akanjs/signal";
+    content: `import type { Guard, GuardScope, SignalContext } from "akanjs/signal";
 
 // ===== AuthGuard.ts =====
 // Convention: srvkit/ folder — server-only helpers, cannot import from client code.
@@ -14,10 +14,14 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
 
 export class SignedIn implements Guard {
   static name = "SignedIn";
+  // "account" — the verdict reads the caller and nothing about the call, so an MCP catalogue can evaluate it with
+  // no arguments and hide what this caller certainly cannot use. Required: "resource" is never evaluated for a
+  // listing, so a guard like this one marked that way would filter nothing.
+  static scope: GuardScope = "account";
 
   canPass(context: SignalContext): boolean {
-    const user = context.getHttpContext<{ user?: { id: string } }>().req.user;
-    return !!user;
+    // Reads the account the middleware resolved, so the same guard answers over HTTP, a websocket and MCP alike.
+    return !!context.get<{ id?: string }>("account");
   }
 }
 
@@ -25,9 +29,9 @@ export class SignedIn implements Guard {
 // Role-based guard: only allow users with a specific role
 // export class IsAdmin implements Guard {
 //   static name = "IsAdmin";
+//   static scope: GuardScope = "account";
 //   canPass(context: SignalContext): boolean {
-//     const user = context.getHttpContext<{ user?: { role: string } }>().req.user;
-//     return user?.role === "admin";
+//     return context.get<{ role?: string }>("account")?.role === "admin";
 //   }
 // }
 `,

package/templates/appSample/srvkit/SessionInternalArg.ts

@@ -15,8 +15,9 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
 
 export class CurrentUserId implements InternalArg<string | null> {
   getArg(context: SignalContext): string | null {
-    const user = context.getHttpContext<{ user?: { id: string } }>().req.user;
-    return user?.id ?? null;
+    // \`context.get\` reads what the account middleware resolved, on every transport. Branching on
+    // \`getHttpContext()\` would return null for the same caller arriving over a websocket or MCP.
+    return context.get<{ id?: string }>("account")?.id ?? null;
   }
 }
 
@@ -24,7 +25,7 @@ export class CurrentUserId implements InternalArg<string | null> {
 // Inject current session language/locale
 // export class CurrentLocale implements InternalArg<string> {
 //   getArg(context: SignalContext): string {
-//     return context.getHttpContext<{ locale?: string }>().req.locale ?? "en";
+//     return context.get<string>("locale") ?? "en";
 //   }
 // }
 `,

package/templates/crudPages/[__model__Id]/edit/page.tsx

@@ -9,9 +9,9 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
   return {
     filename: "_index.tsx",
     content: `
-import { Load } from "akanjs/ui";
-import { fetch, usePage, ${dict.Model} } from "@apps/${dict.appName}/client";
+import { ${dict.Model}, fetch, usePage } from "@apps/${dict.appName}/client";
 import type { PageConfig } from "akanjs/client";
+import { Load } from "akanjs/ui";
 
 interface PageProps {
   params: { ${dict.model}Id: string };
@@ -20,11 +20,11 @@ interface PageProps {
 export default async function Page({ params }: PageProps) {
   const { l } = usePage();
   const { ${dict.model}Id } = params;
-  const { ${dict.model}, ${dict.model}Edit } = await fetch.edit${dict.Model}(${dict.model}Id);
+  const [{ ${dict.model}Edit }] = await Promise.all([fetch.edit${dict.Model}(${dict.model}Id)]);
   return (
     <div className="container">
-      <div className="flex justify-between m-4 mt-8">
-        <div className="text-xl text-primary flex gap-2 items-center">
+      <div className="m-4 mt-8 flex justify-between">
+        <div className="flex items-center gap-2 text-primary text-xl">
           {l("base.updateModel", { model: l("${dict.model}.modelName") })}
         </div>
       </div>

package/templates/crudPages/[__model__Id]/page.tsx

@@ -10,37 +10,34 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
     filename: "_index.tsx",
     content: `
 import { ${dict.Model}, fetch, usePage } from "@apps/${dict.appName}/client";
-import { Link } from "akanjs/ui";
 import type { PageConfig } from "akanjs/client";
+import { buttonRecipe, Link } from "akanjs/ui";
 
 interface PageProps {
   params: { ${dict.model}Id: string };
 }
 
-export async function generateHead({ params }: PageProps) {
+export function generateHead({ params }: PageProps) {
   const { ${dict.model}Id } = params;
-  const { ${dict.model} } = await fetch.view${dict.Model}(${dict.model}Id);
   return (
     <>
-      <title>{${dict.model}.id}</title>
-      <meta name="description" content={${dict.model}.id} />
-      <meta property="og:title" content={${dict.model}.id} />
-      <meta property="og:description" content={${dict.model}.id} />
+      <title>{${dict.model}Id}</title>
+      <meta name="description" content={${dict.model}Id} />
+      <meta property="og:title" content={${dict.model}Id} />
+      <meta property="og:description" content={${dict.model}Id} />
     </>
   );
 }
 export default async function Page({ params }: PageProps) {
   const { l } = usePage();
   const { ${dict.model}Id } = params;
-  const { ${dict.model}, ${dict.model}View } = await fetch.view${dict.Model}(${dict.model}Id);
+  const [{ ${dict.model}, ${dict.model}View }] = await Promise.all([fetch.view${dict.Model}(${dict.model}Id)]);
   return (
     <div className="container flex flex-col gap-4">
-      <div className="flex gap-4 font-bold text-lg items-center">
+      <div className="flex items-center gap-4 font-bold text-lg">
         <${dict.Model}.Zone.View view={${dict.model}View} />
-        <Link href={\`/${dict.model}/\${${dict.model}.id}/edit\`}>
-          <button className="inline-flex items-center justify-center gap-2 rounded-field bg-primary px-4 py-2 font-medium text-primary-foreground text-sm transition-colors hover:bg-primary/90">
-            {l("base.updateModel", { model: l("${dict.model}.modelName") })}
-          </button>
+        <Link className={buttonRecipe()} href={\`/${dict.model}/\${${dict.model}.id}/edit\`}>
+          {l("base.updateModel", { model: l("${dict.model}.modelName") })}
         </Link>
       </div>
     </div>

package/templates/crudPages/new/page.tsx

@@ -9,17 +9,17 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
   return {
     filename: "_index.tsx",
     content: `
-import { Load } from "akanjs/ui";
-import { cnst, fetch, usePage, ${dict.Model} } from "@apps/${dict.appName}/client";
+import { type cnst, fetch, usePage, ${dict.Model} } from "@apps/${dict.appName}/client";
 import type { PageConfig } from "akanjs/client";
+import { Load } from "akanjs/ui";
 
 export default function Page() {
   const { l } = usePage();
   const ${dict.model}Form: Partial<cnst.${dict.Model}> = {};
   return (
     <div className="container">
-      <div className="flex justify-between m-4 mt-8">
-        <div className="text-xl text-primary flex gap-2 items-center">
+      <div className="m-4 mt-8 flex justify-between">
+        <div className="flex items-center gap-2 text-primary text-xl">
           + {l("base.createModel", { model: l("${dict.model}.modelName") })}
         </div>
       </div>
@@ -37,6 +37,6 @@ export default function Page() {
   );
 }
 export const pageConfig = { transition: "none" } satisfies PageConfig;
-  `,
+`,
   };
 }

package/templates/crudPages/page.tsx

@@ -10,26 +10,26 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
     filename: "_index.tsx",
     content: `
 import { ${dict.Model}, fetch, usePage } from "@apps/${dict.appName}/client";
-import { Link } from "akanjs/ui";
 import type { PageConfig } from "akanjs/client";
+import { buttonRecipe, Link } from "akanjs/ui";
 
 export default async function Page() {
   const { l } = usePage();
-  const { ${dict.model}InitInPublic } = await fetch.init${dict.Model}InPublic();
+  const [{ ${dict.model}InitInPublic }] = await Promise.all([fetch.init${dict.Model}InPublic()]);
   return (
     <div className="container flex flex-col gap-4">
-      <div className="w-full mt-5 px-5 h-full ">
+      <div className="mt-5 h-full w-full px-5">
         <div>{l("${dict.model}.modelName")}</div>
-        <div className="animate-fadeIn px-4 pt-4 flex gap-4 items-center">
+        <div className="flex animate-fadeIn items-center gap-4 px-4 pt-4">
           <div className="font-bold text-lg md:text-4xl">${dict.Model}s</div>
-          <Link href={\`/${dict.model}/new\`}>
-            <button className="inline-flex items-center justify-center gap-2 rounded-field bg-primary px-4 py-2 font-medium text-primary-foreground text-sm transition-colors hover:bg-primary/90">+ {l("base.createModel", { model: l("${dict.model}.modelName") })}</button>
+          <Link className={buttonRecipe()} href="/${dict.model}/new">
+            + {l("base.createModel", { model: l("${dict.model}.modelName") })}
           </Link>
         </div>
         <div>{l("${dict.model}.modelDesc")}</div>
-        <div className="flex px-6 mt-3 gap-4">
+        <div className="mt-3 flex gap-4 px-6">
           <${dict.Model}.Zone.Card
-            className="animate-fadeIn grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5 justify-center gap-4 w-full"
+            className="grid w-full animate-fadeIn grid-cols-1 justify-center gap-4 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5"
             init={${dict.model}InitInPublic}
           />
         </div>
@@ -38,6 +38,6 @@ export default async function Page() {
   );
 }
 export const pageConfig = { transition: "none" } satisfies PageConfig;
-  `,
+`,
   };
 }

package/templates/crudSinglePage/page.tsx

@@ -9,23 +9,27 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
   return {
     filename: "_index.tsx",
     content: `
-import type { PageConfig } from "akanjs/client";
-import { Model } from "akanjs/ui";
 import { ${dict.Model}, fetch, usePage } from "@apps/${dict.appName}/client";
+import type { PageConfig } from "akanjs/client";
+import { buttonRecipe, Model } from "akanjs/ui";
 
 export default async function Page() {
   const { l } = usePage();
-  const { ${dict.model}InitInPublic } = await fetch.init${dict.Model}InPublic();
+  const [{ ${dict.model}InitInPublic }] = await Promise.all([fetch.init${dict.Model}InPublic()]);
   return (
     <>
-      <div className="animate-fadeIn flex items-center gap-4 px-4 pt-4">
-        <div className="text-lg font-bold md:text-4xl">{l("${dict.model}.modelName")}</div>
-        <Model.New className="inline-flex items-center gap-2 rounded-field px-3 py-1.5 text-sm transition-colors hover:bg-muted" slice={fetch.slice.${dict.model}InPublic} renderTitle="id">
+      <div className="flex animate-fadeIn items-center gap-4 px-4 pt-4">
+        <div className="font-bold text-lg md:text-4xl">{l("${dict.model}.modelName")}</div>
+        <Model.New
+          className={buttonRecipe({ size: "sm", variant: "ghost" })}
+          slice={fetch.slice.${dict.model}InPublic}
+          renderTitle="id"
+        >
           <${dict.Model}.Template.General />
         </Model.New>
       </div>
       <${dict.Model}.Zone.Card
-        className="animate-fadeIn mt-2 grid w-full grid-cols-1 justify-center gap-4 md:grid-cols-2 xl:grid-cols-3"
+        className="mt-2 grid w-full animate-fadeIn grid-cols-1 justify-center gap-4 md:grid-cols-2 xl:grid-cols-3"
         init={${dict.model}InitInPublic}
       />
     </>

package/templates/env/_env.server.type.ts

@@ -5,12 +5,14 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [
   const libs = scanInfo.getLibs();
   return {
     filename: "env.server.type.ts",
-    content: `
-${libs.length ? libs.map((lib) => `import { env as ${lib}Option } from "@libs/${lib}/server";`).join("\n") : 'import { getEnv } from "akanjs/base";'}
+    content: libs.length
+      ? `
+${libs.map((lib) => `import { env as ${lib}Option } from "@libs/${lib}/server";`).join("\n")}
 
 export const libEnv = {
-${libs.length ? libs.map((lib) => `  ...${lib}Option,`).join("\n") : "  ...getEnv(),"}
-};
-`,
+${libs.map((lib) => `  ...${lib}Option,`).join("\n")}
+};`
+      : `
+export const libEnv = {};`,
   };
 }

package/templates/lib/db.ts

@@ -13,7 +13,7 @@ ${scalarModules.map((module) => `import { ${capitalize(module)} } from "./__scal
 ${databaseModules.length ? `import * as cnst from "./cnst";` : ""}
 ${databaseModules.map((module) => `import * as ${module}Db from "./${module}/${module}.document";`).join("\n")}
 
-${libs.map((lib) => `export { db as ${lib} } from "@libs/${lib}/server";`).join("\n")}
+${libs.map((lib) => `export * as ${lib} from "@libs/${lib}/lib/db";`).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")}

package/templates/lib/dict.ts

@@ -9,7 +9,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [
   const libs = scanInfo.getLibs();
   return `
 import { makeDictionary, makeTrans, registerScalarTrans, registerServiceTrans, registerModelTrans${libs.length === 0 ? `, dictionary as base` : ""} } from "akanjs/dictionary";
-${libs.length ? libs.map((lib) => `import { dictionary as ${lib} } from "@libs/${lib}/server";`).join("\n") : ""}
+${libs.length ? libs.map((lib) => `import { dictionary as ${lib} } from "@libs/${lib}/lib/dict";`).join("\n") : ""}
 
 ${databaseModules.map((module) => `import * as ${module} from "./${module}/${module}.dictionary";`).join("\n")}
 ${serviceModules.map((module) => `import * as ${module} from "./_${module}/${module}.dictionary";`).join("\n")}

package/templates/lib/sig.ts

@@ -17,7 +17,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [
   return `
 import { FetchClient, type FetchClientType } from "akanjs/fetch";
 import { SignalRegistry, serverSignal${libs.length === 0 ? ", fetch as base" : ""} } from "akanjs/signal";
-${libs.map((lib) => `import { fetch as ${lib} } from "@libs/${lib}/server";`).join("\n")}
+${libs.map((lib) => `import { fetch as ${lib} } from "@libs/${lib}/lib/sig";`).join("\n")}
 
 ${[...scanInfo.database.entries()]
   .filter(([_, files]) => files.has("signal"))

package/templates/lib/srv.ts

@@ -13,7 +13,11 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [
   const libs = scanInfo.getLibs();
   return `
 import { ServiceModel } from "akanjs/service";
-${libs.length ? libs.map((lib) => `import { option as ${lib} } from "@libs/${lib}/server";`).join("\n") : 'import type { BackendEnv } from "akanjs/base";'}
+${
+  libs.length
+    ? libs.map((lib) => `import * as ${lib} from "@libs/${lib}/lib/option";`).join("\n")
+    : 'import type { BackendEnv } from "akanjs/base";'
+}
 
 import * as cnst from "./cnst";
 import * as db from "./db";
@@ -21,7 +25,7 @@ import * as db from "./db";
 ${databaseModules.map((module) => `import { ${capitalize(module)}Service } from "./${module}/${module}.service";`).join("\n")}
 ${serviceModules.map((module) => `import { ${capitalize(module)}Service } from "./_${module}/${module}.service";`).join("\n")}
 
-${libs.map((lib) => `export { srv as ${lib} } from "@libs/${lib}/server";`).join("\n")}
+${libs.map((lib) => `export * as ${lib} from "@libs/${lib}/lib/srv";`).join("\n")}
 
 ${databaseModules.map((module) => `export { ${capitalize(module)}Service } from "./${module}/${module}.service";`).join("\n")}
 ${serviceModules.map((module) => `export { ${capitalize(module)}Service } from "./_${module}/${module}.service";`).join("\n")}

package/templates/module/__model__.dictionary.ts

@@ -18,6 +18,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
 import { modelDictionary } from "akanjs/dictionary";
 
 import type { ${dict.Model}, ${dict.Model}Insight } from "./${dict.model}.constant";
+import type { ${dict.Model}Filter } from "./${dict.model}.document";
 import type { ${dict.Model}Endpoint, ${dict.Model}Slice } from "./${dict.model}.signal";
 
 export const dictionary = modelDictionary(["en", "ko"])
@@ -25,9 +26,11 @@ export const dictionary = modelDictionary(["en", "ko"])
     t(["${modelLabelEn}", "${modelLabelKo}"]).desc(["${modelDescEn}", "${modelDescKo}"])
   )
   .model<${dict.Model}>((t) => ({
-    name: t(["Name", "이름"]),
+    name: t(["Name", "이름"]).desc(["Name", "이름"]),
   }))
   .insight<${dict.Model}Insight>((t) => ({}))
+  .query<${dict.Model}Filter>((fn) => ({}))
+  .sort<${dict.Model}Filter>((t) => ({}))
   .slice<${dict.Model}Slice>((fn) => ({
     inPublic: fn(["${dict.Model} In Public", "${dict.Model} 공개"]).arg((t) => ({})),
   }))

package/templates/module/__model__.signal.ts

@@ -8,14 +8,13 @@ interface Dict {
 }
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
   return `
-import { endpoint, internal, Public, slice } from "akanjs/signal";
+import { endpoint, internal, None, Public, slice } from "akanjs/signal";
 
-import * as cnst from "../cnst";
 import * as srv from "../srv";
 
 export class ${dict.Model}Internal extends internal(srv.${dict.model}, ({ interval }) => ({})) {}
 
-export class ${dict.Model}Slice extends slice(srv.${dict.model}, { guards: { root: Public, get: Public, cru: Public } }, (init) => ({
+export class ${dict.Model}Slice extends slice(srv.${dict.model}, { guards: { root: None, get: Public, cru: Public } }, (init) => ({
   inPublic: init()
     .exec(function () {
       return this.${dict.model}Service.queryAny();

package/templates/module/__model__.store.ts

@@ -9,8 +9,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
   return `
 import { store } from "akanjs/store";
 
-import * as cnst from "../cnst";
-import { fetch, sig } from "../useClient";
+import { sig } from "../useClient";
 
 export class ${dict.Model}Store extends store(sig.${dict.model}, () => ({
   // state

package/templates/workspaceRoot/.gitignore.template

@@ -124,5 +124,4 @@ libs/*/client.ts
 libs/*/server.ts
 libs/*/index.ts
 **/.akan
-**/bun.lock
 **/tsconfig.tsbuildinfo

package/templates/workspaceRoot/.husky/pre-commit.template

@@ -0,0 +1,16 @@
+set -e
+
+# Find commit files
+echo "Finding commit files..."
+FILES=$(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g')
+[ -z "$FILES" ] && exit 0
+
+# Filter out ts, tsx, json files, should not exit when there are no lint files
+LINT_FILES=$(echo "$FILES" | grep -E '(\.ts|\.tsx)$' || true)
+
+echo "Checking commit files with Biome..."
+# Run Biome autofix if there are lint files. Any remaining errors fail the commit.
+if [ -n "$LINT_FILES" ]; then
+  echo "$LINT_FILES" | xargs ./node_modules/.bin/biome check --write --no-errors-on-unmatched --diagnostic-level=error
+  echo "$LINT_FILES" | xargs git add --
+fi

package/templates/workspaceRoot/.vscode/settings.json.template

@@ -3,7 +3,7 @@
     "editor.defaultFormatter": "biomejs.biome",
     "editor.formatOnSave": true,
     "editor.codeActionsOnSave": {
-        "source.fixAll.biome": "explicit"
+        "source.fixAll.biome": "always"
     },
     "[typescript]": {
         "editor.defaultFormatter": "biomejs.biome"

package/templates/workspaceRoot/AGENTS.md.template

@@ -12,6 +12,10 @@ The section below is regenerated by `akan agent install` (run `bun run setup:age
 workspace's apps, generated files, validation commands, and framework guide. Edit anything outside the
 markers freely; content between them is overwritten on the next install.
 
+It carries the rules only. The reasoning behind each area lives in deep-dive guidelines fetched on demand —
+`akan guideline list` names them, `akan guideline show <name>` prints one, and an agent wired to `akan mcp`
+calls `get_guideline` instead.
+
 <!-- akan:agent:start -->
 <!-- Populated by `akan agent install`. Run `bun run setup:agent` to refresh. -->
 <!-- akan:agent:end -->

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,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.12/schema.json",
   "extends": ["@akanjs/devkit/biome.base.json"],
   "files": {
     "includes": [
@@ -12,6 +12,7 @@
       "!!**/node_modules",
       "!!**/dist",
       "!!**/.akan",
+      "!!**/.claude",
       "!!**/dump",
       "!!**/local",
       "!!**/ios/DerivedData"