@akanjs/cli 3.0.0-beta.16 → 3.0.0-beta.18

package/guidelines/transportRule/transportRule.instruction.md

@@ -58,23 +58,25 @@ mutation is mounted under. `conventions` carries the invariants — this is the
 
 ## Cached Answers
 
-- **`{ cache: <ms> }` in an endpoint's signal option is the whole cache surface.** The `Cache` middleware is
-  registered by default and stands aside unless an endpoint declares one — it used to be opt-in and to ignore the
-  declared value for a hard-coded 60 seconds, which is the same shape the `timeout` bug had.
+- **`{ cache: <ms> }` in an endpoint's signal option is the whole cache surface.** The lookup is a step of every
+  call and stands aside unless an endpoint declares one.
 - **Only a `query` that takes no internal argument may carry one.** The handler's inputs are its declared
   arguments plus its internal ones, so an endpoint with none of the latter answers the same thing to everyone who
   may read it — which is the only answer a shared entry can hold. An endpoint that takes `.with(Self)` answers
   per caller, and one entry would be one caller's answer handed to the next; that endpoint and every `mutation`
   are named once in the log and left uncached rather than silently ignored.
-- **The guards run on every hit.** A cache hit skips `next()`, and `next()` is what runs them, so the middleware
-  calls `context.checkGuards()` itself before handing the entry over. Shared is not public.
-- **The entry is the handler's result, not the response.** The middleware wraps execution, so `resolveReturn`
+- **The guards run before every hit.** The lookup sits after the guards and the internal arguments, inside the
+  call, so every middleware — the account resolution a lib registers among them — has already run and a hit
+  reaches only a caller the guards admitted. It used to be a middleware ahead of the lib's, and a guard reading
+  the account refused a signed-in caller on every hit. Shared is not public.
+- **The entry is the handler's result, not the response.** The lookup wraps the handler only, so `resolveReturn`
   still runs per call on the cached value — field masking, `hidden`/`secret` stripping and relation resolution are
   never cached, and a relation still costs its own load. The cache saves the handler, not the serialization.
 - **A cache backend that is down does not take the endpoint down.** A failed read is warned and the call runs
   uncached; a failed write is warned and dropped.
-- The default middleware chain is `Logging → Timeout → Cache → handler`: a hung cache backend is bounded by the
-  same deadline as the handler it stands in for. **`Retry` was removed** — an automatic re-run of an endpoint
+- The default middleware chain is `Logging → Timeout → <lib middlewares>`, and the call inside it runs guards →
+  internal arguments → cache → handler: a hung cache backend is bounded by the same deadline as the handler it
+  stands in for. **`Retry` was removed** — an automatic re-run of an endpoint
   whose failure it cannot classify replays whatever the first attempt already did.
 
 ## Binary Pubsub

package/guidelines/workspaceRecipes/workspaceRecipes.instruction.md

@@ -376,15 +376,16 @@ export default page()
 |---|---|
 | `interface PageProps { params }` + `[x]` folder | `.param("x", ID \| String \| Int \| …)` — one per `[x]` segment, every one of them, in path order |
 | `searchParams.k` | `.search("k", Type)`; `[Type]` for a repeated key; the value arrives typed and optional |
-| `params.lang` | `lang` — on every route's `.render()`, `.head()`, `.metadata()` and `.loading()` with no stage; `.param("lang")` is refused |
+| `params.lang` | `lang` — on every route's `.render()`, `.head()` and `.loading()` with no stage; `.param("lang")` is refused |
 | `export const pageConfig = {…}` | `.config({…})` — `devOnly` stays a literal |
 | `export const head = <…/>` / `generateHead({ params })` | `.head(<…/>)` / `.head(({ x }) => <…/>)` |
-| `export const metadata` / `generateMetadata` | `.metadata({…})` / `.metadata((args) => …)` |
+| `export const metadata` / `generateMetadata` | `.head(<><title>…</title><meta name="description" content="…" /></>)` — there is no object form |
 | `export function Loading()` | `.loading((args) => …)` |
 | `export default async function Page({ params, searchParams })` | `.render(async ({ x, k }) => { …same body… })` — `async` only if it awaits |
 | `_layout.tsx`: `export default function Layout({ children })` | `layout().render(({ children }) => …)` |
 | `export function NotFound` / `export function Error` | `.notFound(fn)` / `.error(fn)` on `layout()` |
-| root `_layout.tsx`: `fonts`, `theme`, `manifest`, `reconnect`, `wsConnect`, `layoutStyle`, `gaTrackingId` | `rootLayout().fonts([…]).theme("dark").manifest({…}).reconnect(false).wsConnect(false).layoutStyle("web").gaTrackingId("G-…")` |
+| root `_layout.tsx`: `fonts`, `theme`, `manifest`, `reconnect`, `wsConnect`, `layoutStyle` | `rootLayout().fonts([…]).theme("dark").manifest({…}).reconnect(false).wsConnect(false).layoutStyle("web")` |
+| root `_layout.tsx`: `gaTrackingId` | none — render the app's own `"use client"` analytics component from the root layout's `.render()` |
 | `prompt()` on `endpoint()` (removed) | `.prompt(name, description)` on the page that shows the same screen |
 
 Rules the loader and `akan sync` enforce: a chain module has no other export; `page()` belongs in a page file and

package/incrementalBuilder.proc.js

@@ -3,7 +3,7 @@ import {
   CodegenLock,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 import"./index-q0y2jq9j.js";
 import"./index-6wwzs1bc.js";
 import {

package/{index-sxg87a8f.js → index-14zrtgfa.js}

@@ -1,4 +1,160 @@
 // @bun
+// pkgs/@akanjs/cli/code/CodeTuiLines.ts
+import stringWidth from "string-width";
+
+class CodeTuiLines2 {
+  static width(text) {
+    return stringWidth(text);
+  }
+  static rows(rows, width, keyBase) {
+    const lines = [];
+    rows.forEach((row, idx) => {
+      for (const line of CodeTuiLines2.#row(row, Math.max(8, width), `${keyBase}:${idx}`))
+        lines.push(line);
+    });
+    return lines;
+  }
+  static #row(row, width, key) {
+    const prefix = row.prefix;
+    const head = prefix ? CodeTuiLines2.width(prefix.text) : 0;
+    const hang = row.hang ?? " ".repeat(head);
+    const body = width - Math.max(head, CodeTuiLines2.width(hang));
+    const wrapped = CodeTuiLines2.#wrap(row.spans, Math.max(4, body));
+    if (!wrapped.length)
+      wrapped.push([]);
+    return wrapped.map((spans, at) => ({
+      key: `${key}:${at}`,
+      spans: [...at === 0 ? prefix ? [prefix] : [] : hang ? [{ text: hang }] : [], ...spans]
+    }));
+  }
+  static #wrap(spans, width) {
+    const lines = [];
+    let line = [];
+    let used = 0;
+    let soft = false;
+    const push = (fromWrap) => {
+      lines.push(line);
+      line = [];
+      used = 0;
+      soft = fromWrap;
+    };
+    for (const span of spans) {
+      const { text, ...style } = span;
+      for (const piece of text.split(`
+`).flatMap((part, at) => at ? [null, part] : [part])) {
+        if (piece === null) {
+          push(false);
+          continue;
+        }
+        for (const word of CodeTuiLines2.#words(piece)) {
+          const size = CodeTuiLines2.width(word);
+          if (!word.trim() && !used && soft)
+            continue;
+          if (used && used + size > width)
+            push(true);
+          if (size > width) {
+            for (const chunk of CodeTuiLines2.#chunks(word, width)) {
+              if (used)
+                push(true);
+              line.push({ ...style, text: chunk });
+              used = CodeTuiLines2.width(chunk);
+              if (used >= width)
+                push(true);
+            }
+            continue;
+          }
+          line.push({ ...style, text: word });
+          used += size;
+        }
+      }
+    }
+    if (line.length)
+      lines.push(line);
+    return lines;
+  }
+  static #words(text) {
+    return text.match(/\S+\s*|\s+/g) ?? [];
+  }
+  static #chunks(word, width) {
+    const chunks = [];
+    let chunk = "";
+    for (const char of word) {
+      if (CodeTuiLines2.width(chunk + char) > width) {
+        chunks.push(chunk);
+        chunk = char;
+      } else
+        chunk += char;
+    }
+    if (chunk)
+      chunks.push(chunk);
+    return chunks;
+  }
+  static text(line) {
+    return line.spans.map((span) => span.text).join("");
+  }
+}
+
+// pkgs/@akanjs/cli/code/CodeTuiAgents.ts
+class CodeTuiAgents2 {
+  static markWidth = 4;
+  static minDescription = 12;
+  static rows(agents, session, width, now = Date.now()) {
+    if (!agents.length)
+      return [];
+    const kindColumn = Math.max(...agents.map((agent) => CodeTuiLines2.width(agent.kind))) + 2;
+    return [
+      {
+        key: "agents:self",
+        spans: [{ text: "\u276F ", color: "cyan" }, { text: "\u23FA ", color: "green" }, { text: session }]
+      },
+      ...agents.map((agent, at) => ({
+        key: `agents:${agent.id || at}`,
+        spans: CodeTuiAgents2.#row(agent, kindColumn, width, now)
+      }))
+    ];
+  }
+  static #row(agent, kindColumn, width, now) {
+    const meta = `${CodeTuiAgents2.elapsed(now - agent.startedAt)} \xB7 \u2193 ${CodeTuiAgents2.tokens(agent.tokens)} tokens`;
+    const head = CodeTuiAgents2.markWidth + kindColumn;
+    const room = width - head - CodeTuiLines2.width(meta) - 2;
+    const spans = [{ text: "  \u25EF ", color: "yellow" }, { text: agent.kind.padEnd(kindColumn) }];
+    if (room < CodeTuiAgents2.minDescription)
+      return [...spans, { text: CodeTuiAgents2.#clip(agent.description, Math.max(1, width - head)) }];
+    const description = CodeTuiAgents2.#clip(agent.description, room);
+    const pad = " ".repeat(Math.max(0, room - CodeTuiLines2.width(description)));
+    return [...spans, { text: `${description}${pad}` }, { text: `  ${meta}`, dim: true }];
+  }
+  static elapsed(ms) {
+    const total = Math.max(0, Math.round(ms / 1000));
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor(total % 3600 / 60);
+    const seconds = total % 60;
+    if (hours)
+      return `${hours}h ${minutes}m`;
+    if (minutes)
+      return `${minutes}m ${seconds}s`;
+    return `${seconds}s`;
+  }
+  static tokens(count) {
+    if (count < 1000)
+      return `${Math.max(0, Math.round(count))}`;
+    if (count < 1e6)
+      return `${(count / 1000).toFixed(1)}k`;
+    return `${(count / 1e6).toFixed(1)}M`;
+  }
+  static #clip(text, width) {
+    if (CodeTuiLines2.width(text) <= width)
+      return text;
+    let clipped = "";
+    for (const char of text) {
+      if (CodeTuiLines2.width(clipped + char) > width - 1)
+        break;
+      clipped += char;
+    }
+    return `${clipped}\u2026`;
+  }
+}
+
 // pkgs/@akanjs/cli/code/CodeTuiClipboard.ts
 import { existsSync } from "fs";
 import { tmpdir } from "os";
@@ -93,7 +249,7 @@ class CodeTuiCommands2 {
   static all = [
     { name: "help", desc: "list these commands and the keys" },
     { name: "tools", desc: "what this session can call" },
-    { name: "model", desc: "switch model", arg: "<provider>/<id>" },
+    { name: "model", desc: "switch model, or list what is available", arg: "[<provider>/<id>]" },
     { name: "effort", desc: "how hard the model thinks before it answers", arg: "<level>" },
     { name: "thinking", desc: "show the model's reasoning, or fold it away again" },
     { name: "compact", desc: "summarise the conversation to free the window", arg: "[notes]" },
@@ -102,6 +258,7 @@ class CodeTuiCommands2 {
     { name: "name", desc: "name this session", arg: "<text>" },
     { name: "fork", desc: "continue this conversation twice; the copy takes over here", arg: "[name]" },
     { name: "agents", desc: "what a sub-agent may be, and what one may spend" },
+    { name: "mcp", desc: "the MCP servers this session reached", arg: "[add|remove|login|reload]" },
     { name: "peers", desc: "the other akan code sessions running here" },
     { name: "msg", desc: "hand a message to another session", arg: "<peer> <text>" },
     { name: "quit", desc: "leave the session" }
@@ -131,109 +288,16 @@ class CodeTuiCommands2 {
       "esc interrupt \xB7 pgup/pgdn scroll \xB7 ^c quit",
       "@ completes a file in this repo \xB7 \u2190 at the start of the prompt lists past sessions",
       "",
+      "Scroll: the wheel scrolls this transcript \xB7 hold shift to select text with the mouse instead",
+      "",
       "Images: cmd+v attaches what is on the clipboard \xB7 ^v does too, without the terminal in the way",
       "",
-      'shift+enter needs a terminal that reports it \u2014 in VS Code bind it to send "\\u001b\\r".'
+      'shift+enter needs a terminal that reports it \u2014 in VS Code bind it to send "\\\\u001b\\r".'
     ].join(`
 `);
   }
 }
 
-// pkgs/@akanjs/cli/code/CodeTuiLines.ts
-import stringWidth from "string-width";
-
-class CodeTuiLines2 {
-  static width(text) {
-    return stringWidth(text);
-  }
-  static rows(rows, width, keyBase) {
-    const lines = [];
-    rows.forEach((row, idx) => {
-      for (const line of CodeTuiLines2.#row(row, Math.max(8, width), `${keyBase}:${idx}`))
-        lines.push(line);
-    });
-    return lines;
-  }
-  static #row(row, width, key) {
-    const prefix = row.prefix;
-    const head = prefix ? CodeTuiLines2.width(prefix.text) : 0;
-    const hang = row.hang ?? " ".repeat(head);
-    const body = width - Math.max(head, CodeTuiLines2.width(hang));
-    const wrapped = CodeTuiLines2.#wrap(row.spans, Math.max(4, body));
-    if (!wrapped.length)
-      wrapped.push([]);
-    return wrapped.map((spans, at) => ({
-      key: `${key}:${at}`,
-      spans: [...at === 0 ? prefix ? [prefix] : [] : hang ? [{ text: hang }] : [], ...spans]
-    }));
-  }
-  static #wrap(spans, width) {
-    const lines = [];
-    let line = [];
-    let used = 0;
-    let soft = false;
-    const push = (fromWrap) => {
-      lines.push(line);
-      line = [];
-      used = 0;
-      soft = fromWrap;
-    };
-    for (const span of spans) {
-      const { text, ...style } = span;
-      for (const piece of text.split(`
-`).flatMap((part, at) => at ? [null, part] : [part])) {
-        if (piece === null) {
-          push(false);
-          continue;
-        }
-        for (const word of CodeTuiLines2.#words(piece)) {
-          const size = CodeTuiLines2.width(word);
-          if (!word.trim() && !used && soft)
-            continue;
-          if (used && used + size > width)
-            push(true);
-          if (size > width) {
-            for (const chunk of CodeTuiLines2.#chunks(word, width)) {
-              if (used)
-                push(true);
-              line.push({ ...style, text: chunk });
-              used = CodeTuiLines2.width(chunk);
-              if (used >= width)
-                push(true);
-            }
-            continue;
-          }
-          line.push({ ...style, text: word });
-          used += size;
-        }
-      }
-    }
-    if (line.length)
-      lines.push(line);
-    return lines;
-  }
-  static #words(text) {
-    return text.match(/\S+\s*|\s+/g) ?? [];
-  }
-  static #chunks(word, width) {
-    const chunks = [];
-    let chunk = "";
-    for (const char of word) {
-      if (CodeTuiLines2.width(chunk + char) > width) {
-        chunks.push(chunk);
-        chunk = char;
-      } else
-        chunk += char;
-    }
-    if (chunk)
-      chunks.push(chunk);
-    return chunks;
-  }
-  static text(line) {
-    return line.spans.map((span) => span.text).join("");
-  }
-}
-
 // pkgs/@akanjs/cli/code/CodeTuiEditor.ts
 class CodeTuiEditor2 {
   #text = "";
@@ -271,6 +335,8 @@ class CodeTuiEditor2 {
     this.set(this.#text.slice(0, this.#caret) + clean + this.#text.slice(this.#caret), this.#caret + clean.length);
   }
   newline() {
+    if (this.#text.slice(0, this.#caret).endsWith("\\"))
+      this.set(this.#text.slice(0, this.#caret - 1) + this.#text.slice(this.#caret), this.#caret - 1);
     this.insert(`
 `);
   }
@@ -724,4 +790,4 @@ class CodeTuiParts2 {
   }
 }
 
-export { CodeTuiClipboard2, CodeTuiCommands2, CodeTuiLines2, CodeTuiEditor2, CodeTuiFiles2, CodeTuiMarkdown2, CodeTuiParts2 };
+export { CodeTuiLines2, CodeTuiAgents2, CodeTuiClipboard2, CodeTuiCommands2, CodeTuiEditor2, CodeTuiFiles2, CodeTuiMarkdown2, CodeTuiParts2 };

package/{index-57p9p179.js → index-3hpxeys1.js}

@@ -6,14 +6,14 @@ import {
 } from "./index-myj01w9r.js";
 import {
   runner
-} from "./index-6na0sd2b.js";
+} from "./index-ycy302an.js";
 import {
   WorkspaceExecutor,
   AppExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 import {
   openBrowser
-} from "./index-ns128c4q.js";
+} from "./index-9dp031by.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 import path from "path";
@@ -297,11 +297,12 @@ ${chalk.green("\u27A4")} Authentication Required`));
     const registry = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
     const registryArgs = this.#getRegistryArgs(registry);
     const env = this.#getRegistryEnv(registry);
+    const globalCliArgs = ["add", "-g", `@akanjs/cli@${tag}`, ...registryArgs];
     if (!await workspace.exists("package.json"))
-      await workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env });
+      await workspace.spawn("bun", globalCliArgs, { env });
     else
       await Promise.all([
-        workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env }),
+        workspace.spawn("bun", globalCliArgs, { env }),
         this.#updateAkanPkgs(workspace, tag, registry)
       ]);
   }

package/{index-sn7dnzq4.js → index-4r42ext5.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AppInfo
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 
 // pkgs/@akanjs/devkit/slicePlanner.ts
 class SlicePlanner {

package/{index-3mg4h788.js → index-6q589y9t.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-6na0sd2b.js";
+} from "./index-ycy302an.js";
 import {
   LibExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 import {
   LibSource,
   formatLibStatuses

package/index-9dp031by.js

@@ -0,0 +1,12 @@
+// @bun
+// pkgs/@akanjs/cli/openBrowser.ts
+import { spawn } from "child_process";
+function openBrowser(url) {
+  const command = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+  const child = spawn(command[0], command.slice(1), { detached: true, stdio: "ignore" });
+  child.on("error", () => {});
+  child.unref();
+  return Promise.resolve();
+}
+
+export { openBrowser };

package/{index-p4p9t45x.js → index-bwxpk2cj.js}

@@ -1141,13 +1141,6 @@ export async function generateHead(props: PageProps) {
   return inheritedLayout.head;
 }
 
-export async function generateMetadata(props: PageProps) {
-  if (userLayout.generateMetadata) return userLayout.generateMetadata(props);
-  if (userLayout.metadata !== undefined) return userLayout.metadata;
-  if (inheritedLayout.generateMetadata) return inheritedLayout.generateMetadata(props);
-  return inheritedLayout.metadata;
-}
-
 export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
 export const Error = userLayout.Error ?? inheritedLayout.Error;
 export const pageConfig = userLayout.pageConfig ?? inheritedLayout.pageConfig;
@@ -1164,7 +1157,6 @@ ${layoutBinding}  return (
       theme={userLayout.theme ?? inheritedLayout.theme}
       fonts={loadFonts(userFonts)}
       className={defaultFontClassName}
-      gaTrackingId={userLayout.gaTrackingId ?? inheritedLayout.gaTrackingId}
       layoutStyle={userLayout.layoutStyle ?? inheritedLayout.layoutStyle}
       reconnect={userLayout.reconnect ?? inheritedLayout.reconnect ?? false}
       wsConnect={userLayout.wsConnect ?? inheritedLayout.wsConnect ?? true}
@@ -1185,13 +1177,6 @@ export async function generateHead(props: PageProps) {
   return inheritedLayout.head;
 }
 
-export async function generateMetadata(props: PageProps) {
-  if (userLayout.generateMetadata) return userLayout.generateMetadata(props);
-  if (userLayout.metadata !== undefined) return userLayout.metadata;
-  if (inheritedLayout.generateMetadata) return inheritedLayout.generateMetadata(props);
-  return inheritedLayout.metadata;
-}
-
 export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
 export const Error = userLayout.Error ?? inheritedLayout.Error;
 export const pageConfig = userLayout.pageConfig ?? inheritedLayout.pageConfig;
@@ -2139,11 +2124,12 @@ class PkgInfo {
     const [tsconfig, rootPackageJson] = await Promise.all([exec.getTsConfig(), exec.workspace.getPackageJson()]);
     const scanner = await createDependencyScanner(exec);
     const npmSet = new Set(Object.keys({ ...rootPackageJson.dependencies, ...rootPackageJson.devDependencies }));
-    const pkgPathSet = new Set(Object.keys(tsconfig.compilerOptions.paths ?? {}).filter((path) => tsconfig.compilerOptions.paths?.[path]?.some((resolve) => resolve.startsWith("pkgs/"))).map((path) => path.replace("/*", "")));
+    const workspacePathOf = (resolve) => resolve.replace(/^\.\//, "");
+    const pkgPathSet = new Set(Object.keys(tsconfig.compilerOptions.paths ?? {}).filter((path) => tsconfig.compilerOptions.paths?.[path]?.some((resolve) => workspacePathOf(resolve).startsWith("pkgs/"))).map((path) => path.replace("/*", "")));
     const [npmDepSet, pkgPathDepSet] = await scanner.getImportSets([npmSet, pkgPathSet]);
     const pkgDeps = [...pkgPathDepSet].map((path) => {
       const pathSplitLength = path.split("/").length;
-      return (tsconfig.compilerOptions.paths?.[path]?.[0] ?? "*").split("/").slice(1, 1 + pathSplitLength).join("/");
+      return workspacePathOf(tsconfig.compilerOptions.paths?.[path]?.[0] ?? "*").split("/").slice(1, 1 + pathSplitLength).join("/");
     }).filter((pkg) => pkg !== exec.name);
     const pkgScanResult = {
       name: exec.name,
@@ -3255,7 +3241,7 @@ class SysExecutor extends Executor {
 class AppExecutor extends SysExecutor {
   static #routeSourceValidator = null;
   static async#getRouteSourceValidator() {
-    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-apyqw7wk.js")).RouteSourceValidator;
+    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-7ycnfz0e.js")).RouteSourceValidator;
     return AppExecutor.#routeSourceValidator;
   }
   dist;

package/{index-g9zghs4h.js → index-cjw1sj1x.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   AppExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 import {
   jsonText,
   createWorkflowBaselineSummary,
   buildAkanModuleContextIndex,
   createWorkflowStepRegistry,
   toolingRolloutGate
-} from "./index-qhtj9y6j.js";
+} from "./index-yw6g3bbv.js";
 import {
   buildResourceList,
   codexMcpConfigPath,
@@ -18,32 +18,32 @@ import {
   upsertCodexMcpServerBlock,
   renderDoctorText,
   AkanContextAnalyzer
-} from "./index-v17gj504.js";
+} from "./index-rpgxs245.js";
 import {
   isPlaceholderAppId2
-} from "./index-3cymrzsb.js";
+} from "./index-erfc1x40.js";
 import {
   CommandContainer,
   runner
-} from "./index-6na0sd2b.js";
+} from "./index-ycy302an.js";
 import {
   Prompter2
-} from "./index-twq9p2sp.js";
+} from "./index-s5rhm04y.js";
 import {
   RepairRunner
-} from "./index-4cvpzkq6.js";
+} from "./index-ef228gzf.js";
 import {
   WorkflowRunner
-} from "./index-2pm1j01n.js";
+} from "./index-zmj143x7.js";
 import {
   ModuleScript
-} from "./index-xjc7gg65.js";
+} from "./index-pn8mhpps.js";
 import {
   PrimitiveScript
-} from "./index-te0y1c0m.js";
+} from "./index-d9fjz06h.js";
 import {
   ScalarScript
-} from "./index-vpx68e4x.js";
+} from "./index-q9c3c0hy.js";
 import {
   getMobileTargets
 } from "./index-47pj3aee.js";
@@ -1021,7 +1021,7 @@ ${payload}`);
       test: "`akan test <app-or-lib-or-pkg>` prepares the target and runs its tests.",
       build: "`akan build <app-name>` creates a production build after preparing generated files.",
       doctor: "`akan doctor --strict --format json` reports agent-readable workspace convention diagnostics and validation hints.",
-      "guideline show": "`akan guideline show <name>` prints an Akan codegen guideline instruction.",
+      "guideline show": "`akan guideline show <name>` prints an Akan guideline instruction.",
       workflow: "`akan workflow list|explain|plan|apply|validate|report` lists, plans, applies, validates, and reports agent-readable Akan workflows.",
       "workflow list": "`akan workflow list` lists parseable read-only workflow specs.",
       "workflow explain": "`akan workflow explain <workflow>` explains inputs, optional surfaces, steps, and validation.",

package/{index-te0y1c0m.js → index-d9fjz06h.js}

@@ -1,12 +1,12 @@
 // @bun
 import {
   script
-} from "./index-6na0sd2b.js";
+} from "./index-ycy302an.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-bwxpk2cj.js";
 import {
   compactDiagnostics,
   createPrimitiveWriteReport,
@@ -18,6 +18,8 @@ import {
   nextActionsForTarget,
   lowerlize,
   normalizeFieldType,
+  ensureNamedImport,
+  ensureBaseImport,
   ensureBaseTypeImport,
   coerceFieldDefault,
   fieldExpression,
@@ -39,10 +41,10 @@ import {
   hasSignalFactoryEntry,
   insertSignalFactoryEntry,
   addFieldUiPolicyForType
-} from "./index-qhtj9y6j.js";
+} from "./index-yw6g3bbv.js";
 import {
   ModuleScript
-} from "./index-xjc7gg65.js";
+} from "./index-pn8mhpps.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";
@@ -210,6 +212,8 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
       if (defaultCoercion.diagnostic)
         diagnostics.push(defaultCoercion.diagnostic);
       constantContent = ensureBaseTypeImport(constantContent, input.type);
+      if (input.type === "Date" && defaultCoercion.expression)
+        constantContent = ensureBaseImport(constantContent, "dayjs");
     }
     if (enumValues) {
       const defaultCoercion = coerceFieldDefault("enum", input.defaultValue, { enumValues });
@@ -353,7 +357,7 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
       signal: name ? {
         className: `${moduleClassName}Endpoint`,
         entryLine: [
-          `${name}: mutation(Boolean)`,
+          `${name}: mutation(Boolean, { guards: [None] })`,
           `    .exec(async function () {`,
           `      return await this.${serviceRef}Service.${name}();`,
           `    }),`
@@ -388,7 +392,7 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
       signal: name && queryName ? {
         className: `${moduleClassName}Slice`,
         entryLine: [
-          `${name}: init()`,
+          `${name}: init({ guards: [None] })`,
           `    .exec(function () {`,
           `      return this.${serviceRef}Service.${queryName}();`,
           `    }),`
@@ -476,7 +480,8 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
       });
     }
     const nextServiceContent = serviceMethodExists ? serviceContent : insertClassMethod(serviceContent, serviceClassName, spec.serviceMethod.block);
-    const nextSignalContent = insertSignalFactoryEntry(signalContent, spec.signal.className, spec.entryName, spec.signal.entryLine, spec.signal.param);
+    const insertedSignalContent = insertSignalFactoryEntry(signalContent, spec.signal.className, spec.entryName, spec.signal.entryLine, spec.signal.param);
+    const nextSignalContent = insertedSignalContent ? ensureNamedImport(insertedSignalContent, "akanjs/signal", "None") : insertedSignalContent;
     if (!nextServiceContent) {
       diagnostics.push({
         severity: "error",

package/{index-4n4821gp.js → index-dw943k93.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   jsonText
-} from "./index-qhtj9y6j.js";
+} from "./index-yw6g3bbv.js";
 import {
   akanMcpInstallTargets
-} from "./index-v17gj504.js";
+} from "./index-rpgxs245.js";
 import {
   script
-} from "./index-6na0sd2b.js";
+} from "./index-ycy302an.js";
 import {
   ContextRunner2
-} from "./index-g9zghs4h.js";
+} from "./index-cjw1sj1x.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";