@akanjs/cli 3.0.0-alpha.23 → 3.0.0-alpha.25

package/.build-stamp

@@ -1 +1 @@
-3237453a1286b1bf99348cb60b92184947f53163fa9ae1efae1013a73d10aa77
+d575c7a7d93b93f7a48cce65df5699924691699fecae350c28cd4bbcb2a68fe4

package/{application.command-e2za636m.js → application.command-sjtbk6tr.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-dh9vdsrd.js";
+} from "./index-8d2sv6pw.js";
 import"./index-73rnbwgg.js";
 import {
   getMobileTargetChoices

package/{cloud.command-krea92t8.js → cloud.command-y0e4eyqz.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   CloudScript
-} from "./index-k93ep78g.js";
-import"./index-n0zdjawn.js";
+} from "./index-becx1t0k.js";
+import"./index-t71zvmt9.js";
 import"./index-33zce8gt.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
-import"./index-dh9vdsrd.js";
+import"./index-8d2sv6pw.js";
 import"./index-73rnbwgg.js";
 import"./index-76rn3g2c.js";
 import {

package/guidelines/conventions/conventions.instruction.md

@@ -635,12 +635,13 @@ costs something to assemble.
 
 ## In-Page Agent
 
-Every akan app can host a component-level agent that reads the rendered screen and drives it. Tools, state, and
-context are **derived from the rendered screen, not from the bundle**: a store joins the surface only while a
-mounted component reads one of its keys (`st.use` / `st.sel` / `st.ref` all count), and only that store's
-catalogued actions and state are published. `Load` scopes, the route, and the live keys complete the context, so
-most screens publish a full surface with zero agent code. The React core is the `use-agentic` package; apps and
-libs never import it directly (`no-import-external-library`) — everything reaches them through `st.*` and
+Every akan app can host a component-level agent that reads the rendered screen and drives it. **A component
+declaration is the surface, exactly**: `st.tool` publishes one action, and `st.use` / `st.sel` / `st.ref` make one
+store key readable while the reading component is mounted. Nothing is derived from a store class — declaring a
+method on a `store(...)` gives an agent nothing at all, because a lever the screen does not offer the user is not
+one an agent may pull in their place, and a module's whole vocabulary published at once was noise the model paid
+for. `Load` scopes, the route, and the live keys complete the context. The React core is the `use-agentic` package;
+apps and libs never import it directly (`no-import-external-library`) — everything reaches them through `st.*` and
 `akanjs/ui`.
 
 - **Mount `<Agent.Chat />` once in a layout.** That is the floating chat, the approval card, and the client-side
@@ -672,22 +673,21 @@ libs never import it directly (`no-import-external-library`) — everything reac
   tree is the cascade: nested Guides concatenate outer-to-inner and navigating away withdraws them. It is a
   component, not a pageConfig field. Module `*.abstract.md` files are developer docs and are never served to the
   agent.
-- **Exposure is the store author's to trim.** `static agent = false` on a store class keeps the whole module off
-  the surface (the framework's base store declares it — its keys are plumbing and `tryJwt` is a credential);
-  `static agent = { exclude: ["setMapBounds", "mapCamera"] }` withholds named actions and state keys that are not
-  real levers (state a component writes into but never reads back). `st.use.x({ agent: false })` subscribes
-  without counting toward liveness. Generated `set<Key>` conveniences are never published — declare a typed action
-  or `st.tool` when an agent should set one. Form setters for the base document fields (`setIdOnX`,
-  `setCreatedAtOnX`, `setUpdatedAtOnX`, `setRemovedAtOnX`) are never published either: the server stamps those.
-  An action named after an endpoint is published with the endpoint's argument schema **only when it can consume
-  it** — one declaring fewer parameters than the endpoint is refused (and warned once in the console), because
-  the schema-shaped call would drop the tail and read stale form state instead; trailing extras beyond the
-  endpoint's arguments stay legal (`create<Model>(data, options?)` is the generated shape).
-- **Hooks are the escape hatch, not the norm.** `st.useState(name, initial, meta)` publishes local state
-  (read-only unless `set:` names a type), `st.expose(name, value)` a derived value, and
-  `st.tool("x", { desc }).arg("id", ID).exec(fn)` a one-off action. `.exec()` is the only hook, so the chain
-  completes in one unconditional statement; its callable carries `data-akan-action`, so pass it to `onClick` by
-  reference like a store setter. `remove*`-named tools default to a confirm gate.
+- **Declare the tool beside the control that already does it.**
+  `st.tool("x", { desc }).arg("id", ID).exec(fn)` publishes one action and returns the callable to hand to
+  `onClick` — one handler for the person and the agent, which is the point: a button wired to an inline arrow can
+  be clicked by a person and by nobody else. `.exec()` is the only hook, so the chain completes in one
+  unconditional statement, and the callable carries `data-akan-action` like a store setter does. A `remove*` name
+  defaults to a confirm gate. Reach a store action from the body — `.exec((id) => st.do.removeX(id))` — which is
+  how an agent gets CRUD; `st.do` on its own reaches nobody.
+- **Reading is per key, not per store.** `st.useState(name, initial, meta)` publishes local state (read-only
+  unless `set:` names a type) and `st.expose(name, value)` a derived value. A subscribed store key is listed in
+  the state context block by name and pulled with `readState(key)`, masked by the model that key declares — while
+  a key the screen does not read stays unreadable even when a sibling key of the same store is live. **There is no
+  store-level exposure declaration**: a store class says nothing about agents, and `st.use.x({ agent: false })` is
+  how the component that subscribes a value keeps it off the surface. The framework's own `base` store is the one
+  fixed exception, never published however widely it is read — its keys are routing plumbing, and `tryJwt` is the
+  caller's credential.
 - **Model-facing text is English, always** — tool `desc`, `instructions`, Guide text. The `l()` rule covers
   strings a *user* reads: Chat's own buttons go through `l("base.*")`, the model's text never does.
 - A masked model never crosses the boundary: a value whose `hidden`/`secret` fields are populated is refused at
@@ -698,8 +698,8 @@ libs never import it directly (`no-import-external-library`) — everything reac
 - The framework publishes three built-ins on every store surface: `navigate` (internal paths only, the same
   router `Link` rides), `readScreen` (the rendered DOM as compact text — headings, links, control values; the
   chat's own UI is skipped via `data-agent-ui`, and a password value is never read), and `readState(key)` (one
-  masked store key). Declaring a store action or hook tool under one of those names shadows the built-in, so
-  reuse them only to mean that.
+  masked store key). Declaring a hook tool under one of those names shadows the built-in, so reuse them only to
+  mean that.
 
 ## Scalar Modeling (`**/*.constant.ts`)
 

package/incrementalBuilder.proc.js

@@ -250,7 +250,7 @@ class IncrementalBuilder {
       return;
     this.#shuttingDown = true;
     const started = Date.now();
-    this.#logger.info(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
+    this.#logger.debug(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
     if (this.#cssRebuildTimer) {
       clearTimeout(this.#cssRebuildTimer);
       this.#cssRebuildTimer = null;
@@ -263,7 +263,7 @@ class IncrementalBuilder {
       return;
     });
     const flushed = await BuilderChannel.drain();
-    this.#logger.info(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
+    this.#logger.debug(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
     process.exit(0);
   }
   get shuttingDown() {

package/{index-dh9vdsrd.js → index-8d2sv6pw.js}

@@ -350,7 +350,7 @@ class IncrementalBuilderHost {
       return false;
     this.#recycleRequested = true;
     this.#status = "recycling";
-    this.logger.info(`recycling builder pid=${proc.pid} (${reason})`);
+    this.logger.debug(`recycling builder pid=${proc.pid} (${reason})`);
     this.#recycleTimer = setTimeout(() => {
       this.#recycleTimer = null;
       if (this.#proc !== proc)

package/{index-k93ep78g.js → index-becx1t0k.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CloudRunner
-} from "./index-n0zdjawn.js";
+} from "./index-t71zvmt9.js";
 import {
   PackageScript
 } from "./index-33zce8gt.js";
@@ -12,7 +12,7 @@ import {
 } from "./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-dh9vdsrd.js";
+} from "./index-8d2sv6pw.js";
 import {
   script
 } from "./index-n706txcv.js";

package/{index-n0zdjawn.js → index-t71zvmt9.js}

@@ -7,7 +7,7 @@ import {
 } from "./index-sh01r3pm.js";
 import {
   openBrowser
-} from "./index-dh9vdsrd.js";
+} from "./index-8d2sv6pw.js";
 import {
   runner
 } from "./index-n706txcv.js";

package/index.js

@@ -18,16 +18,16 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-5m3f02kd.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-f7jerqb2.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-e835fjem.js")).AgentCommand,
-  application: async () => (await import("./application.command-e2za636m.js")).ApplicationCommand,
+  application: async () => (await import("./application.command-sjtbk6tr.js")).ApplicationCommand,
   library: async () => (await import("./library.command-v5cyaw9t.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-bsgg0jqq.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-53t758pt.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-qkcs60ts.js")).PackageCommand,
   module: async () => (await import("./module.command-pq6w84xg.js")).ModuleCommand,
   page: async () => (await import("./page.command-qj5bfnh9.js")).PageCommand,
   context: async () => (await import("./context.command-vn87jb08.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-krea92t8.js")).CloudCommand,
+  cloud: async () => (await import("./cloud.command-y0e4eyqz.js")).CloudCommand,
   guideline: async () => (await import("./guideline.command-s4hn2bsy.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-rm6k3c65.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-bw0nes6x.js")).PrimitiveCommand,

package/{localRegistry.command-bsgg0jqq.js → localRegistry.command-53t758pt.js}

@@ -2,14 +2,14 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-n0zdjawn.js";
+} from "./index-t71zvmt9.js";
 import {
   PackageScript
 } from "./index-33zce8gt.js";
 import"./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-dh9vdsrd.js";
+} from "./index-8d2sv6pw.js";
 import"./index-73rnbwgg.js";
 import"./index-76rn3g2c.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.25",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "3.0.0-alpha.23",
+    "akanjs": "3.0.0-alpha.25",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/{workspace.command-5m3f02kd.js → workspace.command-f7jerqb2.js}

@@ -11,11 +11,11 @@ import"./index-ss469dec.js";
 import"./index-qc0tnhs2.js";
 import {
   CloudScript
-} from "./index-k93ep78g.js";
+} from "./index-becx1t0k.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-n0zdjawn.js";
+} from "./index-t71zvmt9.js";
 import {
   PackageScript
 } from "./index-33zce8gt.js";
@@ -31,7 +31,7 @@ import"./index-tsmjxph2.js";
 import"./index-j37qq1f2.js";
 import {
   ApplicationScript
-} from "./index-dh9vdsrd.js";
+} from "./index-8d2sv6pw.js";
 import {
   LibraryScript
 } from "./index-73rnbwgg.js";