@akanjs/cli 2.3.1-rc.4 → 2.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.3.1-rc.4",
+  "version": "2.3.1",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -35,7 +35,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.1-rc.4",
+    "akanjs": "2.3.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "^5.5.20",

package/templates/appSample/lib/__scalar/workHistory/workHistory.abstract.ts

@@ -12,7 +12,7 @@ Scalar modules are embedded into models via field([ScalarType]), not stored inde
 They live under the double-underscore prefix to distinguish them from database models.
 
 Standard scalar layers:
-- workHistory.constant.ts — enum (WorkHistoryAction) + entry class (WorkHistoryEntry) defined via via() + enumOf()
+- workHistory.constant.ts — enum (WorkHistoryAction) + entry class (WorkHistory) defined via via() + enumOf()
 - workHistory.dictionary.ts — i18n via scalarDictionary() (fewer layers than modelDictionary)
 - workHistory.abstract.md — embedding rules and intent
 
@@ -20,14 +20,14 @@ Standard scalar layers:
 
 - Scalar modules use double-underscore prefix: lib/__scalar/workHistory/
 - Files drop the underscores: workHistory.constant.ts, not __workHistory.constant.ts
-- Models embed scalars via field([WorkHistoryEntry], { default: [] }) — list-of-scalar embedding
+- Models embed scalars via field([WorkHistory]) — list-of-scalar embedding
 
 ## Embedding Example (in task.constant.ts)
 
-TaskObject embeds a list of WorkHistoryEntry:
-  import { WorkHistoryEntry } from "../../__scalar/workHistory/workHistory.constant";
+TaskObject embeds a list of WorkHistory:
+  import { WorkHistory } from "../../__scalar/workHistory/workHistory.constant";
   export class TaskObject extends via(TaskInput, (field) => ({
-    workHistory: field([WorkHistoryEntry], { default: [] }),
+    workHistory: field([WorkHistory]),
   }))
 
 Each status change (create, start, complete) pushes a new entry.

package/templates/appSample/lib/__scalar/workHistory/workHistory.constant.ts

@@ -1,14 +1,12 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "workHistory.constant.ts",
-    content: `import { dayjs, enumOf } from "akanjs/base";
+  return `import { dayjs, enumOf } from "akanjs/base";
 import { via } from "akanjs/constant";
 
 // ===== workHistory.constant.ts =====
 // Convention: lib/__scalar/<type>/ — scalar modules use double-underscore prefix.
-// Scalars are embedded value shapes, reused across models via field([ScalarType], { default: [] }).
+// Scalars are embedded value shapes, reused across models via field([ScalarType]).
 // Define enums with enumOf() and entry classes with via() from akanjs/constant.
 
 // ---- Enum ----
@@ -21,10 +19,10 @@ export class WorkHistoryAction extends enumOf("workHistoryAction", [
 ] as const) {}
 
 // ---- Scalar Entry ----
-// WorkHistoryEntry: a single entry in a model's workHistory list
+// WorkHistory: a single entry in a model's workHistory list
 // Each status change in the owning model pushes a new entry into the list
-// field([WorkHistoryEntry], { default: [] }) in the parent model's Object layer
-export class WorkHistoryEntry extends via((field) => ({
+// field([WorkHistory]) in the parent model's Object layer
+export class WorkHistory extends via((field) => ({
   action: field(WorkHistoryAction),
   at: field(Date, { default: () => dayjs() }),
   note: field(String, { default: "" }),
@@ -33,6 +31,5 @@ export class WorkHistoryEntry extends via((field) => ({
 // ---- Expandable additional fields: ----
 //  - actor: field(String).optional() — who performed the action
 //  - previousStatus: field(TaskStatus).optional() — status before the change
-`,
-  };
+`;
 }

package/templates/appSample/lib/__scalar/workHistory/workHistory.dictionary.ts

@@ -1,18 +1,16 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "workHistory.dictionary.ts",
-    content: `import { scalarDictionary } from "akanjs/dictionary";
+  return `import { scalarDictionary } from "akanjs/dictionary";
 
-import type { WorkHistoryAction, WorkHistoryEntry } from "./workHistory.constant";
+import type { WorkHistoryAction, WorkHistory } from "./workHistory.constant";
 
 // ===== workHistory.dictionary.ts =====
 // Convention: scalarDictionary() for scalar module i18n — fewer layers than modelDictionary().
 // Scalar dictionaries define field labels and enum value labels only; no model/insight/query/sort layers.
 
 export const dictionary = scalarDictionary(["en", "ko"])
-  .model<WorkHistoryEntry>((t) => ({
+  .model<WorkHistory>((t) => ({
     action: t(["Action", "작업"]).desc(["Type of work history event", "작업 이력 이벤트 유형"]),
     at: t(["At", "시간"]).desc(["When the event occurred", "이벤트 발생 시간"]),
     note: t(["Note", "메모"]).desc(["Optional note about the event", "이벤트에 대한 선택적 메모"]),
@@ -23,6 +21,5 @@ export const dictionary = scalarDictionary(["en", "ko"])
     completed: t(["Completed", "완료됨"]).desc(["Task was completed", "할 일이 완료됨"]),
   }))
   .translate({});
-`,
-  };
+`;
 }

package/templates/appSample/lib/__scalar/workHistory/workHistory.document.ts

@@ -0,0 +1,10 @@
+import type { AppInfo, LibInfo } from "akanjs";
+
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
+  return `import { by } from "akanjs/document";
+
+import * as cnst from "./workHistory.constant";
+
+export class WorkHistory extends by(cnst.WorkHistory) {}
+`;
+}

package/templates/appSample/lib/_noti/noti.dictionary.ts

@@ -1,9 +1,8 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "noti.dictionary.ts",
-    content: `import { serviceDictionary } from "akanjs/dictionary";
+  return `import { serviceDictionary } from "akanjs/dictionary";
+import type { NotiEndpoint } from "./noti.signal";
 
 // ===== noti.dictionary.ts =====
 // Convention: <module>.dictionary.ts for a pure service module.
@@ -13,13 +12,12 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
 // Registered by akan scan into dict.ts barrel.
 
 export const dictionary = serviceDictionary(["en", "ko"])
-  .endpoint<typeof import("./noti.signal").NotiEndpoint>((fn) => ({
+  .endpoint<NotiEndpoint>((fn) => ({
     send: fn(["Send Notification", "알림 보내기"]),
   }))
   .translate({
     notiReceived: ["New notification", "새 알림이 도착했습니다"],
     notiMarkAllRead: ["Mark all as read", "모두 읽음으로 표시"],
   });
-`,
-  };
+`;
 }

package/templates/appSample/lib/_noti/noti.service.ts

@@ -1,10 +1,7 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "noti.service.ts",
-    content: `import { serve } from "akanjs/service";
-import { dayjs } from "akanjs/base";
+  return `import { serve } from "akanjs/service";
 
 // ===== noti.service.ts =====
 // Convention: <module>.service.ts for a pure service module.
@@ -26,6 +23,5 @@ export class NotiService extends serve("noti" as const, () => ({})) {}
 //     return this.pushApi.send({ token, title, body });
 //   }
 // }
-`,
-  };
+`;
 }

package/templates/appSample/lib/_noti/noti.signal.ts

@@ -1,10 +1,7 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "noti.signal.ts",
-    content: `import { dayjs } from "akanjs/base";
-import { endpoint } from "akanjs/signal";
+  return `import { internal, endpoint } from "akanjs/signal";
 
 import * as srv from "../srv";
 
@@ -15,9 +12,9 @@ import * as srv from "../srv";
 // Client subscribes via fetch.subscribeSend((data) => { ... }).
 // Registered by akan scan into sig.ts barrel.
 
-export class NotiEndpoint extends endpoint(srv.noti, ({ pubsub }) => ({
+export class NotiInternal extends internal(srv.noti, () => ({})) {}
 
-})) {}
+export class NotiEndpoint extends endpoint(srv.noti, () => ({})) {}
 
 // ---- Expandable additional fields: ----
 //   history: query(NotiHistory)
@@ -25,6 +22,5 @@ export class NotiEndpoint extends endpoint(srv.noti, ({ pubsub }) => ({
 //     .exec(async function (userId) {
 //       return await this.notiService.getHistory(userId);
 //     }),
-`,
-  };
+`;
 }

package/templates/appSample/lib/_noti/noti.store.ts

@@ -1,9 +1,7 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "noti.store.ts",
-    content: `import { dayjs } from "akanjs/base";
+  return `import type { Dayjs } from "akanjs/base";
 import { store } from "akanjs/store";
 
 // ===== noti.store.ts =====
@@ -14,10 +12,10 @@ import { store } from "akanjs/store";
 // Registered by akan scan into st.ts barrel.
 
 export class NotiStore extends store("noti" as const, () => ({
-  notiList: [] as { id: string; type: string; message: string; sentAt: dayjs.Dayjs }[],
+  notiList: [] as { id: string; type: string; message: string; sentAt: Dayjs }[],
   unreadCount: 0,
 })) {
-  addNoti(noti: { type: string; message: string; sentAt: dayjs.Dayjs }) {
+  addNoti(noti: { type: string; message: string; sentAt: Dayjs }) {
     const id = Math.random().toString(36).slice(2);
     this.set({
       notiList: [...(this.get().notiList ?? []), { ...noti, id }],
@@ -33,6 +31,5 @@ export class NotiStore extends store("noti" as const, () => ({
     });
   }
 }
-`,
-  };
+`;
 }

package/templates/appSample/lib/task/Task.Template.tsx

@@ -4,12 +4,10 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
   return {
     filename: "Task.Template.tsx",
     content: `"use client";
-
+import { st, usePage } from "@apps/${dict.appName}/client";
 import { clsx } from "akanjs/client";
 import { Field, Layout } from "akanjs/ui";
 
-import { st, usePage } from "@apps/${dict.appName}/client";
-
 // ===== Task.Template.tsx =====
 // Convention: lib/<module>/ — PascalCase .tsx, Template suffix = form/edit template component.
 // Uses akanjs/ui Field and Layout components: the framework convention for controlled form UIs.
@@ -34,16 +32,14 @@ export const General = ({ className }: TaskEditProps) => {
         value={taskForm.title}
         onChange={st.do.setTitleOnTask}
       />
-      <Field.Text
+      <Field.TextArea
         label={l("task.content")}
         desc={l("task.content.desc")}
         value={taskForm.content}
         onChange={st.do.setContentOnTask}
-        multiline
       />
     </Layout.Template>
   );
-};
-`,
+};`,
   };
 }

package/templates/appSample/lib/task/Task.Unit.tsx

@@ -3,12 +3,10 @@ import type { AppInfo, LibInfo } from "akanjs";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
   return {
     filename: "Task.Unit.tsx",
-    content: `import { type ModelProps, clsx } from "akanjs/client";
+    content: `import { type cnst, usePage } from "@apps/${dict.appName}/client";
+import { type ModelProps, clsx } from "akanjs/client";
 import { Layout } from "akanjs/ui";
 
-import * as cnst from "@apps/${dict.appName}/lib/cnst";
-import { usePage } from "@apps/${dict.appName}/client";
-
 // ===== Task.Unit.tsx =====
 // Convention: lib/<module>/ — PascalCase .tsx, Unit suffix = card/list-item component.
 // Unit receives LightModel as props via the ModelProps<modelName, LightModelType> generic from akanjs/client.
@@ -39,9 +37,7 @@ export const Card = ({ task, className, href }: CardProps) => {
     >
       <div className="flex items-start justify-between gap-2">
         <span className="font-semibold text-base-content">{task.title}</span>
-        <span className={clsx("badge badge-sm shrink-0", statusBadge)}>
-          {l(\`taskStatus.\${task.status}\`)}
-        </span>
+        <span className={clsx("badge badge-sm shrink-0", statusBadge)}>{l(\`taskStatus.\${task.status}\`)}</span>
       </div>
       {task.due && (
         <div className="mt-2 text-base-content/60 text-xs">
@@ -64,7 +60,6 @@ export const Card = ({ task, className, href }: CardProps) => {
 // Abstract: abstracted summary display (search results, previews)
 // export const Abstract = ({ task }: AbstractProps) => (
 //   <div className="text-sm">{task.title} — {l("taskStatus", task.status)}</div>
-// );
-`,
+// );`,
   };
 }

package/templates/appSample/lib/task/Task.Util.tsx

@@ -4,8 +4,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
   return {
     filename: "Task.Util.tsx",
     content: `"use client";
-
-import { st, usePage } from "@apps/${dict.appName}/client";
+import { fetch, st, usePage } from "@apps/${dict.appName}/client";
 import { Model } from "akanjs/ui";
 
 // ===== Task.Util.tsx =====
@@ -46,7 +45,7 @@ interface RemoveProps {
 }
 
 export const Remove = ({ taskId }: RemoveProps) => (
-  <Model.Remove modelId={taskId}>
+  <Model.Remove modelId={taskId} slice={fetch.slice.task}>
     <button className="btn btn-xs btn-ghost text-error">{usePage().l("task.taskRemove")}</button>
   </Model.Remove>
 );
@@ -63,7 +62,10 @@ export const Toolbox = ({ taskId, status }: ToolboxProps) => {
       <button tabIndex={0} className="btn btn-xs btn-ghost">
         ···
       </button>
-      <ul tabIndex={0} className="dropdown-content menu rounded-box z-[1] w-40 border border-base-content/10 bg-base-100 p-2 shadow">
+      <ul
+        tabIndex={0}
+        className="dropdown-content menu z-[1] w-40 rounded-box border border-base-content/10 bg-base-100 p-2 shadow"
+      >
         {status === "todo" && (
           <li>
             <button onClick={() => st.do.startTask(taskId)}>{l("task.taskStart")}</button>

package/templates/appSample/lib/task/Task.View.tsx

@@ -3,10 +3,8 @@ import type { AppInfo, LibInfo } from "akanjs";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
   return {
     filename: "Task.View.tsx",
-    content: `import { clsx } from "akanjs/client";
-
-import * as cnst from "@apps/${dict.appName}/lib/cnst";
-import { usePage } from "@apps/${dict.appName}/client";
+    content: `import { type cnst, usePage } from "@apps/${dict.appName}/client";
+import { clsx } from "akanjs/client";
 
 // ===== Task.View.tsx =====
 // Convention: lib/<module>/ — PascalCase .tsx, View suffix = detail display component.
@@ -31,46 +29,40 @@ export const General = ({ className, task }: GeneralProps) => {
     <div className={clsx("flex w-full flex-col gap-4", className)}>
       <div>
         <h1 className="font-bold text-2xl text-base-content">{task.title}</h1>
-        <div className={clsx("mt-1 font-medium text-sm", statusColor)}>
-          {l(\`taskStatus.\${task.status}\`)}
-        </div>
+        <div className={clsx("mt-1 font-medium text-sm", statusColor)}>{l(\`taskStatus.\${task.status}\`)}</div>
       </div>
 
       {task.content && (
         <div className="rounded-lg border border-base-content/10 bg-base-100 p-4">
-          <p className="whitespace-pre-wrap text-base-content/80 text-sm">
-            {task.content}
-          </p>
+          <p className="whitespace-pre-wrap text-base-content/80 text-sm">{task.content}</p>
         </div>
       )}
 
       <div className="flex items-center gap-4 text-base-content/60 text-sm">
         <div>
-          <span className="font-medium">
-            {l("task.taskDueLabel")}{" "}
-          </span>
-          {task.due
-            ? task.due.toDate().toLocaleDateString()
-            : l("task.taskNoDue")}
+          <span className="font-medium">{l("task.taskDueLabel")} </span>
+          {task.due ? task.due.toDate().toLocaleDateString() : l("task.taskNoDue")}
         </div>
       </div>
 
       {task.workHistory && task.workHistory.length > 0 && (
-        <div className="mt-2 border-t border-base-content/10 pt-4">
-          <h3 className="font-semibold text-base-content text-sm mb-3">{l("task.taskWorkHistoryTitle")}</h3>
+        <div className="mt-2 border-base-content/10 border-t pt-4">
+          <h3 className="mb-3 font-semibold text-base-content text-sm">{l("task.taskWorkHistoryTitle")}</h3>
           <ul className="space-y-2">
             {task.workHistory.map((entry, i) => (
               <li key={i} className="flex items-start gap-3 text-sm">
-                <span className={clsx("badge badge-xs mt-0.5 shrink-0", {
-                  "badge-ghost": entry.action === "created",
-                  "badge-primary": entry.action === "started",
-                  "badge-success": entry.action === "completed",
-                })}>
+                <span
+                  className={clsx("badge badge-xs mt-0.5 shrink-0", {
+                    "badge-ghost": entry.action === "created",
+                    "badge-primary": entry.action === "started",
+                    "badge-success": entry.action === "completed",
+                  })}
+                >
                   {l(\`workHistoryAction.\${entry.action}\`)}
                 </span>
                 <div>
                   <span className="text-base-content/60">{entry.at.toDate().toLocaleString()}</span>
-                  {entry.note && <span className="text-base-content/50 ml-2">{entry.note}</span>}
+                  {entry.note && <span className="ml-2 text-base-content/50">{entry.note}</span>}
                 </div>
               </li>
             ))}

package/templates/appSample/lib/task/Task.Zone.tsx

@@ -4,10 +4,9 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
   return {
     filename: "Task.Zone.tsx",
     content: `"use client";
-
-import { fetch, Task, usePage } from "@apps/${dict.appName}/client";
-import { Load } from "akanjs/ui";
+import { Task, usePage } from "@apps/${dict.appName}/client";
 import type { ClientInit, ClientView } from "akanjs/fetch";
+import { Link, Load } from "akanjs/ui";
 
 import * as cnst from "../cnst";
 
@@ -32,16 +31,12 @@ export const Card = ({ className, init }: CardProps) => {
       renderEmpty={() => (
         <div className="flex flex-col items-center gap-4 py-16 text-center">
           <div className="text-base-content/40 text-lg">{l("task.taskNoTasks")}</div>
-          <button className="btn btn-primary btn-sm">{l("task.taskCreateFirst")}</button>
+          <Link href="/task/new">
+            <button className="btn btn-primary btn-sm">{l("task.taskCreateFirst")}</button>
+          </Link>
         </div>
       )}
-      renderItem={(task) => (
-        <Task.Unit.Card
-          key={task.id}
-          task={task}
-          href={\`/task/\${task.id}\`}
-        />
-      )}
+      renderItem={(task) => <Task.Unit.Card key={task.id} task={task} href={\`/task/\${task.id}\`} />}
     />
   );
 };
@@ -52,15 +47,8 @@ interface ViewProps {
 }
 
 export const View = ({ className, view }: ViewProps) => {
-  return (
-    <Load.View
-      className={className}
-      view={view}
-      renderView={(task) => <Task.View.General task={task} />}
-    />
-  );
+  return <Load.View className={className} view={view} renderView={(task) => <Task.View.General task={task} />} />;
 };
-
 `,
   };
 }

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

@@ -1,17 +1,15 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.constant.ts",
-    content: `import { enumOf } from "akanjs/base";
+  return `import { enumOf } from "akanjs/base";
 import { via } from "akanjs/constant";
 
-import { WorkHistoryEntry } from "../__scalar/workHistory/workHistory.constant";
+import { WorkHistory } from "../__scalar/workHistory/workHistory.constant";
 
 // ===== task.constant.ts =====
 // Convention: <module>.constant.ts — the data shape layer of an Akan.js database module.
 // Import scalar primitives from akanjs/base; define model layers with via() from akanjs/constant.
-// Scalars are embedded via field([ScalarType], ...) — see WorkHistoryEntry embedding below.
+// Scalars are embedded via field([ScalarType], ...) — see WorkHistory embedding below.
 // Layer order: enum → Input → Object → Light → Full.
 //   Input = user-provided fields; Object = Input + system fields + embedded scalars; Light = subset for list views; Full = Object + Light.
 // Registered by akan scan into cnst.ts barrel.
@@ -27,19 +25,21 @@ export class TaskInput extends via((field) => ({
   content: field(String, { default: "" }),
 })) {}
 
-// TaskObject embeds WorkHistoryEntry as a list field — the scalar embedding pattern.
-// field([WorkHistoryEntry], { default: [] }) stores a list of scalar objects in the parent document.
+// TaskObject embeds WorkHistory as a list field — the scalar embedding pattern.
+// field([WorkHistory]) stores a list of scalar objects in the parent document.
 // Each status change (create, start, complete) pushes a new entry into this list.
 export class TaskObject extends via(TaskInput, (field) => ({
   status: field(TaskStatus, { default: "todo" }),
   due: field(Date).optional(),
-  workHistory: field([WorkHistoryEntry], { default: [] }),
+  workHistory: field([WorkHistory]),
 })) {}
 
 export class LightTask extends via(TaskObject, ["title", "status", "due"] as const, (resolve) => ({})) {}
 
 export class Task extends via(TaskObject, LightTask, (resolve) => ({})) {}
 
+export class TaskInsight extends via(Task, (field) => ({})) {}
+
 // ---- Expandable additional fields: ----
 // ===== Add to TaskInput =====
 //  - priority: field(TaskPriority, { default: "medium" })
@@ -49,6 +49,5 @@ export class Task extends via(TaskObject, LightTask, (resolve) => ({})) {}
 //  - completedAt: field(Date).optional()
 // ===== Add to Task =====
 //  isOverdue(): boolean { return this.due && this.due < new Date() }
-`,
-  };
+`;
 }

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

@@ -1,11 +1,9 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.dictionary.ts",
-    content: `import { modelDictionary } from "akanjs/dictionary";
+  return `import { modelDictionary } from "akanjs/dictionary";
 
-import type { Task, LightTask } from "./task.constant";
+import type { Task, TaskStatus } from "./task.constant";
 import type { TaskFilter } from "./task.document";
 
 // ===== task.dictionary.ts =====
@@ -27,11 +25,6 @@ export const dictionary = modelDictionary(["en", "ko"])
     due: t(["Due Date", "마감일"]).desc(["Deadline for completion", "완료 마감일"]),
     workHistory: t(["Work History", "작업 이력"]).desc(["Status change log", "상태 변경 기록"]),
   }))
-  .lightModel<LightTask>((t) => ({
-    title: t(["Title", "제목"]),
-    status: t(["Status", "상태"]),
-    due: t(["Due", "마감"]),
-  }))
   .query<TaskFilter>((fn) => ({
     byStatus: fn(["By Status", "상태별"]).arg((t) => ({
       status: t(["Status", "상태"]),
@@ -80,6 +73,5 @@ export const dictionary = modelDictionary(["en", "ko"])
     taskEdit: ["Edit", "수정"],
     taskNew: ["+ New Task", "+ 새 할 일"],
   });
-`,
-  };
+`;
 }

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

@@ -1,9 +1,7 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.document.ts",
-    content: `import { dayjs } from "akanjs/base";
+  return `import { dayjs } from "akanjs/base";
 import { by, from, into } from "akanjs/document";
 
 import { Err } from "../dict";
@@ -32,23 +30,22 @@ export class TaskFilter extends from(cnst.Task, (filter) => ({
   },
 })) {}
 
-export class TaskDocument extends by(cnst.Task) {
+export class Task extends by(cnst.Task) {
   start() {
     if (this.status !== "todo") throw new Err("task.error.cannotStartFromNonTodo");
     this.status = "inProgress";
-    this.workHistory.push({ action: cnst.WorkHistoryAction.started, at: dayjs() } as cnst.WorkHistoryEntry);
+    this.workHistory.push({ action: "completed", at: dayjs(), note: "" });
     return this;
   }
 
   complete() {
     if (this.status !== "inProgress") throw new Err("task.error.cannotCompleteFromNonInProgress");
     this.status = "completed";
-    this.workHistory.push({ action: cnst.WorkHistoryAction.completed, at: dayjs() } as cnst.WorkHistoryEntry);
+    this.workHistory.push({ action: "completed", at: dayjs(), note: "" });
     return this;
   }
 }
 
-export class TaskModel extends into(TaskDocument, TaskFilter, cnst.task, () => ({})) {}
-`,
-  };
+export class TaskModel extends into(Task, TaskFilter, cnst.task, () => ({})) {}
+`;
 }

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

@@ -1,12 +1,9 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.service.ts",
-    content: `import { dayjs } from "akanjs/base";
+  return `import { dayjs } from "akanjs/base";
+import type { DataInputOf } from "akanjs/document";
 import { serve } from "akanjs/service";
-
-import * as cnst from "../cnst";
 import * as db from "../db";
 
 // ===== task.service.ts =====
@@ -21,10 +18,10 @@ import * as db from "../db";
 export class TaskService extends serve(db.task, () => ({})) {
   // Lifecycle hook: runs before every document creation.
   // Auto-injects the initial workHistory entry for the scalar embedding pattern.
-  _preCreate(data: cnst.TaskInput): cnst.TaskInput {
+  override _preCreate(data: DataInputOf<db.TaskInput, db.Task>): DataInputOf<db.TaskInput, db.Task> {
     return {
       ...data,
-      workHistory: [{ action: cnst.WorkHistoryAction.created, at: dayjs(), note: "" } as cnst.WorkHistoryEntry],
+      workHistory: [{ action: "created", at: dayjs(), note: "" }],
     };
   }
 
@@ -43,6 +40,5 @@ export class TaskService extends serve(db.task, () => ({})) {
 // export class TaskService extends serve(db.task, ({ service, use, signal, plug, env, memory }) => ({
 //   notiService: service<srv.NotiService>(),
 // })) {
-`,
-  };
+`;
 }

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

@@ -1,9 +1,7 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.signal.ts",
-    content: `import { endpoint } from "akanjs/signal";
+  return `import { endpoint, internal, Public, slice } from "akanjs/signal";
 
 import * as cnst from "../cnst";
 import * as srv from "../srv";
@@ -21,6 +19,14 @@ import * as srv from "../srv";
 // Manual endpoints below: only define endpoints that need custom business logic.
 // Registered by akan scan into sig.ts barrel.
 
+export class TaskInternal extends internal(srv.task, ({ interval }) => ({})) {}
+
+export class TaskSlice extends slice(srv.task, { guards: { root: Public, get: Public, cru: Public } }, (init) => ({
+  inPublic: init().exec(function () {
+    return this.taskService.queryAny();
+  }),
+})) {}
+
 export class TaskEndpoint extends endpoint(srv.task, ({ mutation }) => ({
   startTask: mutation(cnst.Task)
     .param("taskId", String)
@@ -44,6 +50,5 @@ export class TaskEndpoint extends endpoint(srv.task, ({ mutation }) => ({
 //   searchTask: query(cnst.LightTask).search("keyword", String).exec(...),
 //   // guards: authentication/authorization guards
 //   // export class TaskEndpoint extends endpoint(srv.task, { guards: { root: SignedIn } }, ({ query, mutation }) => ({})) {}
-`,
-  };
+`;
 }

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

@@ -1,11 +1,9 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
-  return {
-    filename: "task.store.ts",
-    content: `import { store } from "akanjs/store";
+  return `import { store } from "akanjs/store";
 
-import { fetch, sig, msg } from "../useClient";
+import { fetch, msg, sig } from "../useClient";
 
 // ===== task.store.ts =====
 // Convention: <module>.store.ts — client-side state management for a database module.
@@ -40,6 +38,5 @@ export class TaskStore extends store(sig.task, () => ({})) {
 //     filterKeyword: "",
 //   })) { ... }
 // The auto-generated taskForm handles title, content, due states automatically.
-`,
-  };
+`;
 }

package/templates/appSample/page/task/[taskId]/edit.tsx

@@ -4,7 +4,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
   return {
     filename: "edit.tsx",
     content: `import { fetch, Task } from "@apps/${dict.appName}/client";
-import { Load } from "akanjs/ui";
+import { Load, Link } from "akanjs/ui";
 
 // ===== page/task/[taskId]/edit.tsx =====
 // Convention: Server-side edit form page using Load.Edit from akanjs/ui.
@@ -16,17 +16,25 @@ interface PageProps {
   params: { taskId: string };
 }
 export default async function Page({ params: { taskId } }: PageProps) {
-  const taskEdit = await fetch.editTask(taskId);
+  const { taskEdit } = await fetch.editTask(taskId);
 
   return (
-    <Load.Edit
-      slice={fetch.slice.task}
-      edit={taskEdit}
-      type="form"
-      onSubmit={\`/task/\${params.taskId}\`}
-    >
-      <Task.Template.General />
-    </Load.Edit>
+    <main className="mx-auto max-w-2xl px-6 py-8">
+      <div className="mb-6">
+        <Link href={\`/task/\${taskId}\`} className="btn btn-ghost btn-sm">
+          ← Back to Task
+        </Link>
+      </div>
+      <div className="mb-6">
+        <h1 className="font-extrabold text-3xl text-base-content">Edit Task</h1>
+        <p className="mt-1 text-base-content/60 text-sm">Update the task details</p>
+      </div>
+      <div className="rounded-xl border border-base-content/10 bg-base-100 p-6 shadow-sm">
+        <Load.Edit slice={fetch.slice.taskInPublic} edit={taskEdit} type="form" onSubmit={\`/task/\${taskId}\`}>
+          <Task.Template.General />
+        </Load.Edit>
+      </div>
+    </main>
   );
 }
 `,

package/templates/appSample/page/task/_index.tsx

@@ -3,9 +3,7 @@ import type { AppInfo, LibInfo } from "akanjs";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
   return {
     filename: "_index.tsx",
-    content: `"use client";
-
-import { fetch, Task, usePage } from "@apps/${dict.appName}/client";
+    content: `import { fetch, Task, usePage } from "@apps/${dict.appName}/client";
 import { Link } from "akanjs/ui";
 
 // ===== page/task/_index.tsx =====
@@ -13,26 +11,24 @@ import { Link } from "akanjs/ui";
 // Server-side data loading via loader() at the page level; passes init/view props to Zone components.
 // Uses usePage().l() for i18n — the framework convention for dictionary-based translations.
 
-export default function Page() {
+export default async function Page() {
   const { l } = usePage();
+  const { taskInitInPublic } = await fetch.initTaskInPublic();
   return (
     <main className="mx-auto max-w-4xl px-6 py-8">
       <div className="mb-6 flex items-center justify-between">
         <div>
           <h1 className="font-extrabold text-3xl text-base-content">{l("task.modelName")}</h1>
-          <p className="mt-1 text-base-content/60 text-sm">
-            {l("task.modelDesc")}
-          </p>
+          <p className="mt-1 text-base-content/60 text-sm">{l("task.modelDesc")}</p>
         </div>
         <Link href="/task/new" className="btn btn-primary btn-sm">
           {l("task.taskNew")}
         </Link>
       </div>
 
-      <Task.Zone.Card className="flex flex-col gap-3" init={fetch.slice.task} />
+      <Task.Zone.Card className="flex flex-col gap-3" init={taskInitInPublic} />
     </main>
   );
-}
-`,
+}`,
   };
 }

package/templates/appSample/page/task/new.tsx

@@ -3,9 +3,8 @@ import type { AppInfo, LibInfo } from "akanjs";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
   return {
     filename: "new.tsx",
-    content: `import { fetch, usePage } from "@apps/${dict.appName}/client";
-import { Load } from "akanjs/ui";
-import { cnst, Task } from "@apps/${dict.appName}/client";
+    content: `import { type cnst, fetch, Task, usePage } from "@apps/${dict.appName}/client";
+import { Load, Link } from "akanjs/ui";
 
 // ===== page/task/new.tsx =====
 // Convention: Server-side form page using Load.Edit from akanjs/ui.
@@ -18,17 +17,23 @@ export default async function Page() {
   const taskForm: Partial<cnst.Task> = { status: "todo" };
 
   return (
-    <Load.Edit
-      slice={fetch.slice.task}
-      edit={taskForm}
-      type="form"
-      onCancel="back"
-      onSubmit="/task"
-    >
-      <Task.Template.General />
-    </Load.Edit>
+    <main className="mx-auto max-w-2xl px-6 py-8">
+      <div className="mb-6">
+        <Link href="/task" className="btn btn-ghost btn-sm">
+          ← Tasks
+        </Link>
+      </div>
+      <div className="mb-6">
+        <h1 className="font-extrabold text-3xl text-base-content">New Task</h1>
+        <p className="mt-1 text-base-content/60 text-sm">Create a new task with title and description</p>
+      </div>
+      <div className="rounded-xl border border-base-content/10 bg-base-100 p-6 shadow-sm">
+        <Load.Edit slice={fetch.slice.taskInPublic} edit={taskForm} type="form" onCancel="back" onSubmit="/task">
+          <Task.Template.General />
+        </Load.Edit>
+      </div>
+    </main>
   );
-}
-`,
+}`,
   };
 }

package/templates/module/__model__.document.ts

@@ -7,7 +7,7 @@ interface Dict {
 }
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
   return `
-import { by, from, into, type SchemaOf } from "akanjs/document";
+import { by, from, into } from "akanjs/document";
 
 import * as cnst from "../cnst";