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

package/.build-stamp

@@ -1 +1 @@
-6c23abacd61473a71e06be68f20bc1c445facb2e3b329397668341f7273c928c
+ebb85e20e2ce0664a89d89b8a4118186e1277010b003f7c8a8222101af0c5263

package/{CodeAgent-0dh9fzzg.js → CodeAgent-p65jja35.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   CodeAgent2
-} from "./index-aaz7n8s2.js";
-import"./index-hb8sgepf.js";
+} from "./index-qm4fppfk.js";
+import"./index-tpdn30ya.js";
 import"./index-7md2g9vw.js";
 export {
   CodeAgent2 as CodeAgent

package/{CodeTui-drwdvwg9.js → CodeTui-5xr8kxx4.js}

@@ -4,7 +4,7 @@ import {
   McpServerConfig,
   McpTokenStore,
   McpSignIn
-} from "./index-hb8sgepf.js";
+} from "./index-tpdn30ya.js";
 import {
   CodeTuiLines2,
   CodeTuiAgents2,

package/TunnelShare-cwh9ezsm.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  TunnelShare2
+} from "./index-2wc41k5w.js";
+import"./index-94s080qm.js";
+import"./index-52w0fvh8.js";
+export {
+  TunnelShare2 as TunnelShare
+};

package/{agent.command-ttn09rx3.js → agent.command-rp505zxa.js}

@@ -2,16 +2,16 @@
 import {
   Workspace,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-5b6tavv3.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-52w0fvh8.js";
+import"./index-0n9q1f23.js";
 import"./index-hj6w4ka1.js";
-import"./index-yy4s1j72.js";
-import"./index-9629w7ns.js";
-import"./index-0bq14vr1.js";
+import"./index-d65fzxvd.js";
+import"./index-hzy4pe24.js";
+import"./index-zzvvc845.js";
 import {
   AgentScript
-} from "./index-4dn1p115.js";
+} from "./index-ggfhz9ab.js";
 
 // pkgs/@akanjs/cli/agent/agent.command.ts
 class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({

package/akanCode.js

@@ -28,7 +28,7 @@ import {
   CodeMailbox2,
   CodeSessionFork2,
   CodeAgent2
-} from "./index-aaz7n8s2.js";
+} from "./index-qm4fppfk.js";
 import {
   akanCodeDefaultModel2,
   akanCodeModel2,
@@ -39,7 +39,7 @@ import {
 import {
   SubagentPool2,
   akanCodePaths2
-} from "./index-hb8sgepf.js";
+} from "./index-tpdn30ya.js";
 import"./index-7md2g9vw.js";
 import {
   CodeAgentRpcHost2

package/{application.command-b6rck8d6.js → application.command-2x9jqy0k.js}

@@ -6,19 +6,19 @@ import {
   Exec,
   Workspace,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-5b6tavv3.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-52w0fvh8.js";
+import"./index-0n9q1f23.js";
 import {
   getMobileTargetChoices
 } from "./index-ys6f0bvh.js";
-import"./index-khpfpcsd.js";
-import"./index-1db2cw0y.js";
+import"./index-48k96p55.js";
+import"./index-5mm3g24t.js";
 import {
   ApplicationScript
-} from "./index-jg5e15db.js";
+} from "./index-pb10njz7.js";
 import"./index-7md2g9vw.js";
-import"./index-q44jbw48.js";
+import"./index-860zjnr1.js";
 
 // pkgs/@akanjs/cli/application/application.command.ts
 var mobileTargetOption = {

package/{applicationBuildRunner-vh74vrhg.js → applicationBuildRunner-tm0vba5t.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   Spinner
-} from "./index-ga6hygxr.js";
+} from "./index-0n9q1f23.js";
+import"./index-dt1x62ec.js";
 import {
   AllRoutesBuilder,
   CsrArtifactBuilder,
   FontPruner,
   precompressArtifacts,
   SsrBaseArtifactBuilder
-} from "./index-776sswhv.js";
-import"./index-fgq75haa.js";
-import"./index-5b6tavv3.js";
+} from "./index-4mgbzgb5.js";
+import"./index-52w0fvh8.js";
 import"./index-n68jx79w.js";
 
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts

package/buildBatch.proc.js

@@ -1,28 +1,33 @@
 // @bun
 import {
   ApplicationBuildReporter
-} from "./index-khpfpcsd.js";
+} from "./index-48k96p55.js";
 import {
   resolveSsrPageEntriesForApp,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-ga6hygxr.js";
+} from "./index-0n9q1f23.js";
 import {
   computeRouteSeedIndex,
   saveRouteSeedIndex,
-  CssCompiler,
+  ServerGraphFile,
   PagesBundleBuilder,
+  CsrDevBundler,
+  SsrDevBundler
+} from "./index-dt1x62ec.js";
+import"./index-52w0fvh8.js";
+import {
   CsrArtifactBuilder,
+  CssCompiler,
   FontOptimizer,
   SsrBaseArtifactBuilder
-} from "./index-776sswhv.js";
-import"./index-5b6tavv3.js";
-import"./index-fgq75haa.js";
+} from "./index-4mgbzgb5.js";
 import"./index-n68jx79w.js";
 
 // pkgs/@akanjs/devkit/incrementalBuilder/buildBatch.proc.ts
 import path from "path";
 import { Logger } from "akanjs/common";
+import { resolveDevCsrMode } from "akanjs/server/hmr/csrDevManifest";
 
 class BuildBatch {
   #logger = new Logger("BuildBatch");
@@ -39,15 +44,23 @@ class BuildBatch {
       await this.#buildBase();
     if (this.#request.needs.includes("csr"))
       await this.#buildCsr();
-    if (this.#request.needs.includes("pages"))
-      await this.#buildPages();
+    if (this.#request.needs.includes("ssr"))
+      await this.#buildSsrRegistry();
     if (this.#request.needs.includes("css"))
       await this.#buildCss();
+    if (this.#request.needs.includes("pages"))
+      await this.#buildPages();
     return this.#result;
   }
   #emit(message) {
     process.send?.(message);
   }
+  #sentTrace() {
+    if (!this.#request.trace)
+      return;
+    const now = Date.now();
+    return { ...this.#request.trace, patchAt: now, sentAt: now };
+  }
   #emitStatus(phase, message) {
     this.#emit({
       type: "build-status",
@@ -81,33 +94,100 @@ class BuildBatch {
   async#buildCsr() {
     const started = Date.now();
     try {
-      await new CsrArtifactBuilder(this.#app).build();
-      this.#logger.verbose(`csr-rebundle ok (${Date.now() - started}ms)`);
+      if (resolveDevCsrMode() === "registry")
+        await this.#updateCsrRegistry(started);
+      else
+        await this.#rebuildCsrArtifact(started);
       this.#emitStatus("csr");
     } catch (err) {
       this.#fail("csr", "csr-rebundle", err);
     }
   }
+  async#rebuildCsrArtifact(started) {
+    await new CsrArtifactBuilder(this.#app).build();
+    this.#logger.verbose(`csr-rebundle ok (${Date.now() - started}ms)`);
+    if (this.#request.changedFiles.length === 0)
+      return;
+    this.#emit({
+      type: "csr-updated",
+      data: { generation: Date.now(), mode: "artifact", reload: true, reason: "the CSR artifact was rebuilt" }
+    });
+  }
+  async#updateCsrRegistry(started) {
+    const update = await new CsrDevBundler(this.#app).update(this.#request.changedFiles, {
+      announce: (announced) => this.#emit({
+        type: "csr-updated",
+        data: {
+          generation: announced.generation,
+          mode: "registry",
+          reload: announced.reload,
+          reason: announced.reason,
+          patchUrl: announced.patchUrl,
+          changedIds: announced.changedIds,
+          trace: this.#sentTrace()
+        }
+      })
+    });
+    if (!update) {
+      this.#logger.verbose(`csr-dev unchanged (${Date.now() - started}ms)`);
+      return;
+    }
+    this.#logger.verbose(`csr-dev generation=${update.generation} ${update.reload ? `reload (${update.reason})` : `patch modules=${update.changedIds.length}`} graph=${update.moduleCount} (${Date.now() - started}ms)`);
+  }
+  async#buildSsrRegistry() {
+    const started = Date.now();
+    try {
+      const bundler = new SsrDevBundler(this.#app);
+      const hold = await ServerGraphFile.touches(await ServerGraphFile.read(this.#request.artifactDir), this.#request.changedFiles, (file) => ServerGraphFile.clientExportsOf(file));
+      const update = await bundler.update(this.#request.changedFiles, {
+        roots: await bundler.clientEntries(),
+        announce: (announced) => this.#emit({
+          type: "ssr-updated",
+          data: {
+            generation: announced.generation,
+            reload: announced.reload,
+            reason: announced.reason,
+            patchUrl: announced.patchUrl,
+            changedIds: announced.changedIds,
+            trace: this.#sentTrace(),
+            ...announced.epoch !== undefined ? { epoch: announced.epoch } : {},
+            ...announced.first ? { first: true } : {},
+            ...hold && this.#request.changedFiles.length > 0 ? { hold, batchGeneration: this.#request.generation } : {}
+          }
+        })
+      });
+      this.#emitStatus("ssr");
+      this.#logger.verbose(update ? `ssr-dev generation=${update.generation} ${update.reload ? `reload (${update.reason})` : `patch modules=${update.changedIds.length}`} graph=${update.moduleCount} (${Date.now() - started}ms)` : `ssr-dev unchanged (${Date.now() - started}ms)`);
+    } catch (err) {
+      this.#fail("ssr", "ssr-dev", err);
+    }
+  }
   async#buildPages() {
     const started = Date.now();
     try {
       const pageEntries = await resolveSsrPageEntriesForApp(this.#app, await this.#app.getPageKeys());
       const seedIndex = computeRouteSeedIndex(pageEntries);
+      const previousGraph = await ServerGraphFile.read(this.#request.artifactDir);
       const next = await new PagesBundleBuilder(this.#app, "start", pageEntries).build();
       await saveRouteSeedIndex(this.#request.artifactDir, seedIndex);
+      const nextGraph = await ServerGraphFile.read(this.#request.artifactDir);
+      const serverTouched = await ServerGraphFile.touches(previousGraph, [...this.#request.changedFiles, ...previousGraph?.carried ?? []], (file) => nextGraph?.clientExports[file] ?? null, nextGraph);
       this.#emit({
         type: "pages-updated",
         data: {
           bundlePath: next.bundlePath,
           buildId: next.buildId,
           generation: this.#request.generation,
-          changedFiles: this.#request.changedFiles
+          changedFiles: this.#request.changedFiles,
+          trace: this.#sentTrace(),
+          serverTouched
         }
       });
       this.#emitStatus("pages");
       this.#logger.verbose(`pages-rebundle ok buildId=${next.buildId} (${Date.now() - started}ms)`);
     } catch (err) {
       this.#fail("pages", "pages-rebundle", err);
+      await ServerGraphFile.carry(this.#request.artifactDir, this.#request.changedFiles).catch((carryError) => this.#logger.warn(`server graph carry failed; the next save may skip its RSC refresh: ${String(carryError)}`));
     }
   }
   async#buildCss() {
@@ -176,7 +256,11 @@ ${cssText}`).toString(36);
     const raw = process.argv[2];
     if (!raw)
       throw new Error("[build-batch] missing request argument");
-    const request = JSON.parse(raw);
+    const parsed = JSON.parse(raw);
+    const request = parsed.trace ? {
+      ...parsed,
+      trace: { ...parsed.trace, workerStartAt: Math.round(performance.timeOrigin), workerAt: Date.now() }
+    } : parsed;
     const workspace = WorkspaceExecutor.fromRoot({
       workspaceRoot: request.workspaceRoot,
       repoName: request.repoName
@@ -184,8 +268,11 @@ ${cssText}`).toString(36);
     const app = AppExecutor.from(workspace, request.appName);
     if (request.pageKeys)
       app.setPageKeys(request.pageKeys);
+    const orphaned = () => process.exit(1);
+    process.on("disconnect", orphaned);
     const result = await new BuildBatch(request, app).run();
     process.send?.({ type: "build-batch-result", data: result });
+    process.off("disconnect", orphaned);
   }
 }
 await BuildBatch.main().catch((err) => {

package/{cloud.command-gwdypy7k.js → cloud.command-j6m607bp.js}

@@ -1,27 +1,27 @@
 // @bun
-import"./index-5b6tavv3.js";
+import"./index-52w0fvh8.js";
 import {
   GlobalConfig
-} from "./index-22d57v4c.js";
+} from "./index-94s080qm.js";
 import {
   Workspace,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-0n9q1f23.js";
 import {
   PlatformTestRun
-} from "./index-yjkte9aj.js";
-import"./index-khpfpcsd.js";
-import"./index-1db2cw0y.js";
-import"./index-jg5e15db.js";
+} from "./index-56xwsgyn.js";
+import"./index-48k96p55.js";
+import"./index-5mm3g24t.js";
+import"./index-pb10njz7.js";
 import"./index-ys6f0bvh.js";
 import"./index-7md2g9vw.js";
-import"./index-3t7g9e4r.js";
-import"./index-mgfx3mfs.js";
+import"./index-2ahj896a.js";
+import"./index-per2kqy9.js";
 import {
   CloudScript2
-} from "./index-jn07hxrr.js";
-import"./index-q44jbw48.js";
+} from "./index-8k93esfr.js";
+import"./index-860zjnr1.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
 var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";

package/cloud.script-r5t7nhee.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  CloudScript2
+} from "./index-8k93esfr.js";
+import"./index-56xwsgyn.js";
+import"./index-per2kqy9.js";
+import"./index-pb10njz7.js";
+import"./index-860zjnr1.js";
+import"./index-5mm3g24t.js";
+import"./index-ys6f0bvh.js";
+import"./index-94s080qm.js";
+import"./index-58cyna2s.js";
+import"./index-7md2g9vw.js";
+import"./index-48k96p55.js";
+import"./index-0n9q1f23.js";
+import"./index-2ahj896a.js";
+import"./index-52w0fvh8.js";
+export {
+  CloudScript2 as CloudScript
+};

package/{code.command-1jgk14tc.js → code.command-jhrjttm1.js}

@@ -4,9 +4,9 @@ import {
   runner,
   script,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-5b6tavv3.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-52w0fvh8.js";
+import"./index-0n9q1f23.js";
 import {
   akanCodeDefaultModel2,
   CodeAgentStreamPrinter2
@@ -19,7 +19,7 @@ class CodeRunner extends runner("code") {
   async serve(options, listen) {
     await import("./consoleToStderr-h5bryj94.js");
     const [{ CodeAgent }, { CodeAgentRpcHost }, { CodeAgentRpcListener }] = await Promise.all([
-      import("./CodeAgent-0dh9fzzg.js"),
+      import("./CodeAgent-p65jja35.js"),
       import("./CodeAgentRpcHost-p7h6n2hp.js"),
       import("./CodeAgentRpcListener-7p7z5dd7.js")
     ]);
@@ -34,8 +34,8 @@ class CodeRunner extends runner("code") {
   }
   async tui(options, seed) {
     const [{ CodeAgent }, { CodeTui }] = await Promise.all([
-      import("./CodeAgent-0dh9fzzg.js"),
-      import("./CodeTui-drwdvwg9.js")
+      import("./CodeAgent-p65jja35.js"),
+      import("./CodeTui-5xr8kxx4.js")
     ]);
     const agentOptions = await CodeRunner.#agentOptions(options, false);
     let resume = options.resume;
@@ -60,7 +60,7 @@ class CodeRunner extends runner("code") {
     }
   }
   async run(prompt, options) {
-    const { CodeAgent } = await import("./CodeAgent-0dh9fzzg.js");
+    const { CodeAgent } = await import("./CodeAgent-p65jja35.js");
     const agent = await CodeAgent.create(await CodeRunner.#agentOptions(options, false));
     const printer = new CodeAgentStreamPrinter2({ json: options.json, thinking: options.thinking });
     agent.on((event) => printer.print(event));

package/{context.command-4vpjmg22.js → context.command-xncdvv7n.js}

@@ -2,24 +2,24 @@
 import {
   Workspace,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-5b6tavv3.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-52w0fvh8.js";
+import"./index-0n9q1f23.js";
 import"./index-hj6w4ka1.js";
-import"./index-yy4s1j72.js";
-import"./index-9629w7ns.js";
-import"./index-vj1cwwy5.js";
+import"./index-d65fzxvd.js";
+import"./index-hzy4pe24.js";
+import"./index-7yxndzea.js";
 import"./index-ys6f0bvh.js";
-import"./index-0bq14vr1.js";
-import"./index-ya5qbmyg.js";
-import"./index-rnt66vym.js";
-import"./index-tgjy8xf3.js";
-import"./index-wp43xrjv.js";
-import"./index-pp54p5zk.js";
-import"./index-m0ms3n1c.js";
+import"./index-zzvvc845.js";
+import"./index-t02g6dpn.js";
+import"./index-v4hnkqz9.js";
+import"./index-zazvn45w.js";
+import"./index-6dt6zft6.js";
+import"./index-xfgdmm5d.js";
+import"./index-da72pfdv.js";
 import {
   ContextScript
-} from "./index-2gh9sndr.js";
+} from "./index-50rq2qms.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/context.runner-pjy89k2s.js

@@ -0,0 +1,21 @@
+// @bun
+import {
+  ContextRunner2
+} from "./index-7yxndzea.js";
+import"./index-da72pfdv.js";
+import"./index-xfgdmm5d.js";
+import"./index-6dt6zft6.js";
+import"./index-t02g6dpn.js";
+import"./index-zazvn45w.js";
+import"./index-v4hnkqz9.js";
+import"./index-ys6f0bvh.js";
+import"./index-hzy4pe24.js";
+import"./index-d65fzxvd.js";
+import"./index-zzvvc845.js";
+import"./index-58cyna2s.js";
+import"./index-0n9q1f23.js";
+import"./index-hj6w4ka1.js";
+import"./index-52w0fvh8.js";
+export {
+  ContextRunner2 as ContextRunner
+};

package/{dependencyScanner-ye2e6pdz.js → dependencyScanner-06z2dmrr.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   TypeScriptDependencyScanner2
-} from "./index-3t7g9e4r.js";
-import"./index-5b6tavv3.js";
+} from "./index-2ahj896a.js";
+import"./index-52w0fvh8.js";
 export {
   TypeScriptDependencyScanner2 as TypeScriptDependencyScanner
 };

package/{fileSys-5ngz93ga.js → fileSys-wzzrntkw.js}

@@ -2,7 +2,7 @@
 import {
   getDirname2,
   FileSys2
-} from "./index-5b6tavv3.js";
+} from "./index-52w0fvh8.js";
 export {
   FileSys2 as FileSys,
   getDirname2 as getDirname

package/{guideline.command-7jk47fgq.js → guideline.command-d5qmxx29.js}

@@ -2,12 +2,12 @@
 import {
   script,
   command
-} from "./index-rmcw8yc8.js";
-import"./index-5b6tavv3.js";
-import"./index-ga6hygxr.js";
+} from "./index-58cyna2s.js";
+import"./index-52w0fvh8.js";
+import"./index-0n9q1f23.js";
 import {
   Prompter2
-} from "./index-0bq14vr1.js";
+} from "./index-zzvvc845.js";
 
 // pkgs/@akanjs/cli/guideline/guideline.script.ts
 import { Logger } from "akanjs/common";

package/guidelines/agentRule/agentRule.instruction.md

@@ -15,6 +15,13 @@ for. `Load` scopes, the route, and the live keys complete the context. The React
 apps and libs never import it directly (`no-import-external-library`) — everything reaches them through `st.*` and
 `akanjs/ui`.
 
+**Mounted is not published: on a CSR stack only the current page is.** The page kept under the current one for a
+swipe back stays mounted and live, and its declarations stay registered, but its tools, resources, guides and
+`st.use` keys are parked until it is current again — the agent sees the screen the user sees, never two. Each page
+container renders `use-agentic`'s `<AgentActivity active>` for this; a parked registration shadows nothing, two
+pages declaring one name never clash, and a registry kept outside the surface reads the same gate through
+`useAgentGate()`, as the store's live keys do.
+
 ## Mounting The Chat
 - **Mount `<Agent.Chat />` once in a layout.** That is the floating chat, the approval card, and the client-side
   loop. The default runner drives `runAgentTurn`, which the **framework serves on every app** — no lib to mount,

package/guidelines/conventions/conventions.instruction.md

@@ -1002,11 +1002,13 @@ actions and state (see `<model>.store.ts` above).
   other file. The previous session is kept beside it as `dev.prev.log`. Hand somebody — or an agent — the
   path rather than a paste: it costs one line instead of a transcript, and it can be re-read after a fix.
   In the view, `y` copies the lines the filters have already narrowed and `Y` copies the path.
-- **How many apps boot at once is the machine's answer, not a constant.** A cold boot build is the builder's
-  RSS peak (~900MB per app), so the default wave is what memory and cores allow — half the memory budget
-  divided by that peak, and one app per four cores — which boots a laptop's apps together and still staggers
-  them inside a small container. The session says which in one line. `--concurrency <n>` overrides it, and
-  `AKAN_MEMORY_LIMIT` lowers the budget it derives from.
+- **How many apps boot at once is the machine's answer, not a constant.** A cold boot is an app's RSS peak
+  (~1.8GB per app, most of it the build worker — the base build, then the SSR registry's), so the default wave
+  is what memory and cores allow — half the memory budget divided by that peak, and one app per four cores —
+  which boots a laptop's apps together and still staggers them inside a small container. The session says
+  which in one line. The next wave starts once an app serves and its boot builds have settled, or 30 seconds
+  after it serves, while the app shows as ready — and `--open` opens it — as soon as it serves.
+  `--concurrency <n>` overrides the wave size, and `AKAN_MEMORY_LIMIT` lowers the budget it derives from.
 - `--kill` frees the dev ports first — it resolves each port's listener, walks up to the top of that akan dev
   tree and signals it, so another checkout's server or a stale orphan on the same port is reclaimed. A holder
   that is not recognisably an akan process is reported and left alone.