@akanjs/cli 3.0.0-alpha.64 → 3.0.0-alpha.65

package/.build-stamp

@@ -1 +1 @@
-91051910ed4a6b677266a1e02acdb28b3dd899f6d24b642112cf0de3dcb7c1f2
+d9a9cb283fc6902d147352f88eeb5fbd6d7ea8772a5b896f6abb475c2581fb44

package/{agent.command-tsx1nsdj.js → agent.command-99yaptk3.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   AgentScript
-} from "./index-h0mnt0b0.js";
-import"./index-wc19q8mb.js";
-import"./index-g44fykfw.js";
+} from "./index-wxc9p0n0.js";
+import"./index-v76gy4dn.js";
+import"./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{application.command-n8ex8g9h.js → application.command-77nxchr4.js}

@@ -4,8 +4,8 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-r8z20vnj.js";
-import"./index-f0t3wjyr.js";
+} from "./index-m285dkby.js";
+import"./index-emsw8h3b.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
@@ -15,10 +15,10 @@ import {
   Sys,
   Workspace,
   command
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import"./index-fgc8r6dj.js";
 import"./index-5vy2jzar.js";
-import"./index-681sx6nt.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{applicationBuildRunner-x8h12rp0.js → applicationBuildRunner-k6dna8sz.js}

@@ -4,7 +4,7 @@ import {
   CsrArtifactBuilder,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-xj5b8c0w.js";
+} from "./index-xesyg6bc.js";
 import"./index-xjd3rqzj.js";
 import"./index-qnv0aqmm.js";
 import"./index-5vy2jzar.js";
@@ -58,14 +58,15 @@ class ApplicationBuildRunner {
   }
   async build({ spinner = false } = {}) {
     const phaseOptions = { spinner };
+    const { web } = await this.#app.getConfig();
     await this.#runPhase("prepare", "Preparing output directory", () => this.#app.prepareCommand("build"), undefined, {
       spinner
     });
     if (!this.#fast)
       await this.#runPhase("typecheck", "Typechecking", () => this.typecheck(), undefined, phaseOptions);
     await this.#runPhase("backend", "Compiling backend", () => this.#buildBackend(), (result) => `${result.entrypoints} entrypoints, ${result.outputs} outputs`, phaseOptions);
-    await this.#runPhase("ssr", "Building SSR route artifacts", () => this.#buildSsr(), (result) => result ? `${result.allRoutes.manifest.routeIds.length} routes, ${result.allRoutes.manifest.knownEntries.length} entries` : "skipped", phaseOptions);
-    await this.#runPhase("csr", "Building CSR assets", () => this.#buildCsr(), (result) => result?.outputDir ?? "skipped", phaseOptions);
+    await this.#runPhase("ssr", "Building SSR route artifacts", async () => web.ssr ? await this.#buildSsr() : null, (result) => result ? `${result.allRoutes.manifest.routeIds.length} routes, ${result.allRoutes.manifest.knownEntries.length} entries` : web.ssr ? "skipped" : "disabled by akan.config.ts web.ssr", phaseOptions);
+    await this.#runPhase("csr", "Building CSR assets", async () => web.csr ? await this.#buildCsr() : null, (result) => result?.outputDir ?? (web.csr ? "skipped" : "disabled by akan.config.ts web.csr"), phaseOptions);
     await this.#runPhase("compress", "Compressing static assets", () => precompressArtifacts(this.#app), (result) => result.files > 0 ? `${result.files} files, ${ApplicationBuildRunner.formatBytes(result.inputBytes)} -> gzip ${ApplicationBuildRunner.formatBytes(result.outputBytes)} / br ${ApplicationBuildRunner.formatBytes(result.brotliBytes)}` : "no files", phaseOptions);
     await this.#runPhase("metadata", "Writing production metadata", () => this.#buildAppMeta(), undefined, {
       spinner
@@ -115,6 +116,7 @@ class ApplicationBuildRunner {
     const backendExternals = [
       ...new Set([...akanConfig.externalLibs, ...SSR_RENDER_EXTERNALS, ...AKAN_OPTIONAL_BACKEND_EXTERNALS])
     ];
+    const { web } = akanConfig;
     const backendEntryPoints = [`${this.#app.cwdPath}/main.ts`, `${this.#app.cwdPath}/server.ts`];
     for (const entrypoint of backendEntryPoints) {
       if (!await Bun.file(entrypoint).exists())
@@ -129,7 +131,7 @@ class ApplicationBuildRunner {
       define: { "process.env.NODE_ENV": JSON.stringify("production") },
       plugins: backendExternals.length > 0 ? [this.#createExternalSpecifiersPlugin(backendExternals)] : []
     });
-    const rscWorkerResult = await this.#buildOrThrow("rsc-worker", {
+    const rscWorkerResult = web.ssr ? await this.#buildOrThrow("rsc-worker", {
       entrypoints: [this.#resolveRscWorkerBuildEntry()],
       outdir: this.#app.dist.cwdPath,
       target: "bun",
@@ -138,7 +140,7 @@ class ApplicationBuildRunner {
       conditions: ["react-server"],
       define: { "process.env.NODE_ENV": JSON.stringify("production") },
       plugins: backendExternals.length > 0 ? [this.#createExternalSpecifiersPlugin(backendExternals)] : []
-    });
+    }) : null;
     const consoleRuntimeResult = await this.#buildOrThrow("console-runtime", {
       entrypoints: [this.#resolveConsoleRuntimeBuildEntry()],
       outdir: this.#app.dist.cwdPath,
@@ -149,8 +151,8 @@ class ApplicationBuildRunner {
     });
     await this.#writeConsoleShim();
     return {
-      entrypoints: backendEntryPoints.length + 2,
-      outputs: backendResult.outputs.length + rscWorkerResult.outputs.length + consoleRuntimeResult.outputs.length + 1
+      entrypoints: backendEntryPoints.length + (rscWorkerResult ? 2 : 1),
+      outputs: backendResult.outputs.length + (rscWorkerResult?.outputs.length ?? 0) + consoleRuntimeResult.outputs.length + 1
     };
   }
   async#writeConsoleShim() {

package/buildBatch.proc.js

@@ -5,14 +5,14 @@ import {
   FontOptimizer,
   PagesBundleBuilder,
   SsrBaseArtifactBuilder
-} from "./index-xj5b8c0w.js";
+} from "./index-xesyg6bc.js";
 import"./index-xjd3rqzj.js";
 import"./index-qnv0aqmm.js";
 import"./index-5vy2jzar.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{capacitorApp-8mv9e537.js → capacitorApp-4g1s9n37.js}

@@ -25,9 +25,9 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-ce9755av.js";
+} from "./index-cwa0jvjt.js";
 import"./index-76rn3g2c.js";
-import"./index-681sx6nt.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{cloud.command-f0rhw014.js → cloud.command-gegy1qxv.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   CloudScript
-} from "./index-0g9ajdz8.js";
-import"./index-8md8zszv.js";
-import"./index-x1dbhd80.js";
+} from "./index-db89awmp.js";
+import"./index-wm5hw5mr.js";
+import"./index-j35ceh2c.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
-import"./index-r8z20vnj.js";
-import"./index-f0t3wjyr.js";
+import"./index-m285dkby.js";
+import"./index-emsw8h3b.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import"./index-fgc8r6dj.js";
 import"./index-5vy2jzar.js";
-import"./index-681sx6nt.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{context.command-s7a41qjs.js → context.command-a0pwgc3v.js}

@@ -1,25 +1,25 @@
 // @bun
 import {
   ContextScript
-} from "./index-ek4mkwxp.js";
-import"./index-ryns915y.js";
-import"./index-dvg362vq.js";
-import"./index-4mtyaqj2.js";
-import"./index-cc1mgv1f.js";
-import"./index-tn46rr6w.js";
+} from "./index-1t5r09v4.js";
+import"./index-4sgv0wcr.js";
+import"./index-ejr3h3wc.js";
+import"./index-rm7xj6bc.js";
+import"./index-rzekxec9.js";
+import"./index-27jj517n.js";
 import"./index-ss469dec.js";
-import"./index-kkya2ped.js";
-import"./index-ce9755av.js";
+import"./index-4etexq7j.js";
+import"./index-cwa0jvjt.js";
 import"./index-sh01r3pm.js";
-import"./index-wc19q8mb.js";
-import"./index-g44fykfw.js";
+import"./index-v76gy4dn.js";
+import"./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{guideline.command-qrw84ttb.js → guideline.command-83p3y9w7.js}

@@ -10,8 +10,8 @@ import {
   command,
   runner,
   script
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import {

package/guidelines/conventions/conventions.instruction.md

@@ -271,6 +271,44 @@ are, because those are the ones the server could have done.
 Full version with code, the `Tab` composition example, and a review checklist: `get_guideline` with `ssrRule`, or
 `akan guideline show ssrRule`.
 
+## Web Surfaces — Building And Serving Without SSR/CSR
+
+An app serves three things: the API, the SSR/RSC web renderer, and the CSR single-file bundle. The API is always
+on; the other two are declared in `akan.config.ts` as **`web: true | false | { csr: boolean }`** and can be
+narrowed again per deployment.
+
+```ts
+const config: AppConfig = { web: { csr: false } }; // web without the mobile bundle
+const config: AppConfig = { web: false }; // api only
+```
+
+- **`web: { csr: false }`** drops the CSR build phase and the `/__csr` + `?csr=true` routes. The CSR bundle is
+  what the Capacitor mobile build ships, so a web-only deployment never needs it — and an app that declares a
+  `mobile` section is refused, because `akan build-ios` copies `dist/apps/<app>/csr/<target>.html` into the
+  native project.
+- **`web: false`** is an API-only build: no base artifact, no pages or client bundles, no RSC worker
+  entrypoint, and no `public/` in the image (the web router's catch-all is its only reader). Nothing under
+  `page/` is served, including routes a lib contributed through `syncPageLibs`.
+- **There is no CSR-without-SSR option, by type.** The CSR bundle inlines the stylesheet the SSR base artifact
+  compiles, so it would ship an unstyled app — the object form therefore carries only `csr`, and SSR goes off
+  only through the whole-surface `false`.
+- **At runtime, `AKAN_SSR` and `AKAN_CSR` narrow further and never widen** — `false` or `0` turns one off, and
+  `AKAN_SSR=false` takes CSR with it for the same reason the option has no such pair. A surface the build left
+  out cannot be switched back on, and the boot log names what the process ended up serving. The generated
+  Dockerfile writes the build's own answer as the image default.
+- **A build with no web artifact boots the API instead of crashing.** `WebRouter.create` returns `null` when
+  `.akan/artifact/base-artifact.json` is absent — an api-only build, or a workspace with no `page/` at all.
+- `akan start` ignores `web` and keeps the whole dev surface: the incremental builder is also the file watcher,
+  so switching it off would take server-code HMR with it. It warns once when the config and the dev server
+  disagree.
+- The saving is mostly the RSC worker, which is a **separate process per web-serving replica**. Measured on
+  `apps/akan` at boot plus one render: 350MB across 3 processes with SSR on, 120MB across 2 with
+  `AKAN_SSR=false`, and the built image goes 86MB → 6.2MB when the artifacts are left out of it too.
+- **The generated image installs `ca-certificates` and `tzdata` and nothing else.** It used to carry the whole
+  Chromium runtime, ffmpeg, `build-essential`, `python3` and `redis` in every app's image whether or not the app
+  reached for any of them. An app that needs one declares it in `docker.preRuns` / `docker.postRuns`, which are
+  emitted around the `bun install` — that is the migration for a `puppeteer` or `ffmpeg` app.
+
 ## React Components And Styling (`**/*.tsx`)
 
 - Components are `export const X = ({ … }: XProps) => { return (…); };` — arrow const with a block body. `export default` is reserved for pages, layouts, and `lazy()` targets.
@@ -380,6 +418,12 @@ workflow changes.
   `context.getClientPort()`) along with host and protocol.
 - **Every socket carries a `socketId`, and only the framework mints one.** `AppWsData` assigns it at the handshake, and a `message` / `pubsub` handler reads it off the `Ws` internal arg — `.with(Ws)` hands `{ ws, socketId, subscribe, on, off }`. Never mint your own from `ws.data`: the room bookkeeping keys on the framework's id, and a second one fails to match it silently. It identifies a **connection**, not a caller — a reconnect gets a new id and the federation gateway's own socket is a different one — so per-user state keys on the account, never on this.
 
+- **A cleanup registered with `ws.on("disconnect" | "unsubscribe", fn)` is scoped to the call that registered it.**
+  From a `pubsub` subscribe it belongs to that room — `unsubscribe` runs when the client leaves it or a credential
+  change revokes it, `disconnect` when the socket closes while still subscribed — so a room already left runs
+  neither again, and cleanup that must happen either way registers for both. From a `message` handler it belongs to
+  the socket and runs at close. A handler that throws is logged and never blocks the rest of the teardown.
+
 ### Authorization Defaults
 
 - **Every `slice()` takes an explicit `{ guards: {…} }` second argument, and `root:` is always `Admin`.**

package/incrementalBuilder.proc.js

@@ -16,7 +16,7 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{index-ek4mkwxp.js → index-1t5r09v4.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-ryns915y.js";
+} from "./index-4sgv0wcr.js";
 import {
   WorkflowRunner
-} from "./index-dvg362vq.js";
+} from "./index-ejr3h3wc.js";
 import {
   ScalarScript
-} from "./index-4mtyaqj2.js";
+} from "./index-rm7xj6bc.js";
 import {
   PrimitiveScript
-} from "./index-cc1mgv1f.js";
+} from "./index-rzekxec9.js";
 import {
   ModuleScript
-} from "./index-tn46rr6w.js";
+} from "./index-27jj517n.js";
 import {
   isPlaceholderAppId
-} from "./index-ce9755av.js";
+} from "./index-cwa0jvjt.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,14 +27,14 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-wc19q8mb.js";
+} from "./index-v76gy4dn.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   AppExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-tn46rr6w.js → index-27jj517n.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-ss469dec.js";
 import {
   PageScript
-} from "./index-kkya2ped.js";
+} from "./index-4etexq7j.js";
 import {
   AiSession
 } from "./index-sh01r3pm.js";
@@ -15,17 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   ModuleExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-kkya2ped.js → index-4etexq7j.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-ryns915y.js → index-4sgv0wcr.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-wc19q8mb.js";
+} from "./index-v76gy4dn.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   runner
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-ce9755av.js → index-cwa0jvjt.js}

@@ -5,7 +5,7 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   CommandExecutionError
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";

package/{index-0g9ajdz8.js → index-db89awmp.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   CloudRunner
-} from "./index-8md8zszv.js";
+} from "./index-wm5hw5mr.js";
 import {
   PackageScript
-} from "./index-x1dbhd80.js";
+} from "./index-j35ceh2c.js";
 import {
   AiSession,
   CloudApi,
@@ -12,13 +12,13 @@ import {
 } from "./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-r8z20vnj.js";
+} from "./index-m285dkby.js";
 import {
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   PkgExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-dvg362vq.js → index-ejr3h3wc.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-wc19q8mb.js";
+} from "./index-v76gy4dn.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   runner
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-f0t3wjyr.js → index-emsw8h3b.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   LibExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/cli/semver.ts
 var stripRangeOperator = (version) => version.replace(/^[\s^~>=<v]+/, "").trim();

package/{index-x1dbhd80.js → index-j35ceh2c.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   PkgExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";

package/{index-r8z20vnj.js → index-m285dkby.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   LibraryScript
-} from "./index-f0t3wjyr.js";
+} from "./index-emsw8h3b.js";
 import {
   resolveMobileTargets
 } from "./index-76rn3g2c.js";
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -18,7 +18,7 @@ import {
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   __require
 } from "./index-yb2wsc7f.js";
@@ -1898,9 +1898,9 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-x8h12rp0.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-k6dna8sz.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-93nzdfsy.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-8mv9e537.js")).CapacitorApp;
+var loadCapacitorApp = async () => (await import("./capacitorApp-4g1s9n37.js")).CapacitorApp;
 var loadAbstractCompactor = async () => (await import("./abstractCompactor-20e0cwbs.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 

package/{index-g44fykfw.js → index-mr02v9xp.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `

package/{index-681sx6nt.js → index-n57kkvtg.js}

@@ -320,6 +320,7 @@ class AkanAppConfig {
   rootPackageJson;
   docker;
   defaultDatabaseMode;
+  web;
   externalLibs;
   barrelImports;
   optimizeImports;
@@ -362,8 +363,15 @@ class AkanAppConfig {
     this.syncPageLibs = config?.syncPageLibs ?? false;
     this.hasMobileConfig = Boolean(config.mobile);
     this.mobile = this.#resolveMobileConfig(config.mobile);
+    this.web = this.#resolveWebConfig(config.web);
     this.docker = this.#makeDockerContent(config?.docker ?? {});
   }
+  #resolveWebConfig(web) {
+    const resolved = typeof web === "object" ? { ssr: true, csr: web.csr } : { ssr: web ?? true, csr: web ?? true };
+    if (!resolved.csr && this.hasMobileConfig)
+      throw new Error(`apps/${this.app.name}/akan.config.ts turns the CSR bundle off but declares mobile targets; the Capacitor build ships that bundle. Drop the mobile section or leave CSR on.`);
+    return resolved;
+  }
   #resolveMobileConfig(mobile) {
     const {
       targets: rawTargets,
@@ -485,10 +493,14 @@ class AkanAppConfig {
     const postRunScripts = this.#getDockerRunScripts(docker.postRuns ?? []);
     const imageScript = docker.image ? this.#getDockerImageScript(docker.image, "oven/bun:1-slim") : "FROM oven/bun:1-slim";
     const command = docker.command ?? ["bun", "main.js"];
+    const webEnvLines = [
+      ...this.web.ssr ? [] : ["ENV AKAN_SSR=false"],
+      ...this.web.csr ? [] : ["ENV AKAN_CSR=false"]
+    ].join(`
+`);
     const content = `${imageScript}
+RUN apt-get update && apt-get upgrade -y && apt-get install -y --no-install-recommends ca-certificates tzdata && rm -rf /var/lib/apt/lists/*
 RUN ln -sf /usr/share/zoneinfo/Asia/Seoul /etc/localtime
-RUN apt-get update && apt-get upgrade -y
-RUN apt-get install -y --no-install-recommends git redis build-essential python3 ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils udev ffmpeg
 ARG TARGETARCH
 ${preRunScripts.join(`
 `)}
@@ -509,7 +521,7 @@ ${this.basePaths.size ? `ENV AKAN_PUBLIC_BASE_PATHS=${[...this.basePaths].join("
 ENV AKAN_PUBLIC_DEFAULT_LOCALE=${this.i18n.defaultLocale}
 ENV AKAN_PUBLIC_LOCALES=${this.i18n.locales.join(",")}
 ENV AKAN_PUBLIC_OPERATION_MODE=cloud
-
+${webEnvLines}
 CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return {
       content,
@@ -2656,10 +2668,13 @@ class AppExecutor extends SysExecutor {
       await Promise.all([this.dist.mkdir("private"), this.dist.mkdir("public")]);
       await Promise.all([
         this.cp("private", `${this.dist.cwdPath}/private`, { dereference: true }),
-        this.cp("public", `${this.dist.cwdPath}/public`, { dereference: true })
+        ...akanConfig2.web.ssr ? [this.cp("public", `${this.dist.cwdPath}/public`, { dereference: true })] : []
       ]);
-    } else
+    } else {
       await this.removeDir(".akan");
+      if (!akanConfig2.web.ssr || !akanConfig2.web.csr)
+        this.logger.warn(`akan.config.ts disables web.${!akanConfig2.web.ssr ? "ssr" : "csr"}; \`akan start\` still serves it, \`akan build\` will not`);
+    }
     if (type === "start")
       process.env.NODE_ENV = "development";
     const devPort = type === "start" ? (await this.getDevPort()).toString() : undefined;

package/{index-ckpwq052.js → index-qch3r961.js}

@@ -6,7 +6,7 @@ import {
   ModuleExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   getDirname
 } from "./index-1577bej2.js";

package/{index-4mtyaqj2.js → index-rm7xj6bc.js}

@@ -9,14 +9,14 @@ import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";

package/{index-cc1mgv1f.js → index-rzekxec9.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-tn46rr6w.js";
+} from "./index-27jj517n.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-wc19q8mb.js → index-v76gy4dn.js}

@@ -2,7 +2,7 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import {
   AppExecutor,
   LibExecutor,
@@ -11,7 +11,7 @@ import {
   readDevkitVersion,
   rootAllowedDirs,
   rootAllowedFiles
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,

package/{index-8md8zszv.js → index-wm5hw5mr.js}

@@ -7,14 +7,14 @@ import {
 } from "./index-sh01r3pm.js";
 import {
   openBrowser
-} from "./index-r8z20vnj.js";
+} from "./index-m285dkby.js";
 import {
   runner
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
 var defaultNpmRegistry = "https://registry.npmjs.org";

package/{index-h0mnt0b0.js → index-wxc9p0n0.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-wc19q8mb.js";
+} from "./index-v76gy4dn.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   AGENT_BLOCK_END,
   AGENT_BLOCK_START,
@@ -19,7 +19,7 @@ import {
   renderRecipeEntries,
   stampBlockVersion,
   upsertAgentBlock
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import {
   collectRecipeSources,
   scanRecipes

package/{index-xj5b8c0w.js → index-xesyg6bc.js}

@@ -1976,6 +1976,7 @@ class SsrBaseArtifactBuilder {
       branches: [...akanConfig.branches],
       i18n: akanConfig.i18n,
       imageConfig: akanConfig.images,
+      web: akanConfig.web,
       deepLinkAssociations: Object.values(akanConfig.mobile.targets).filter((target) => (target.deepLinks?.domains?.length ?? 0) > 0).map((target) => ({
         targetName: target.name,
         appId: target.appId,

package/index.js

@@ -4,8 +4,8 @@ import {
   getTargetCommandNames,
   getTargetMetas,
   runCommands
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
@@ -19,22 +19,22 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-ma3g994j.js")).WorkspaceCommand,
-  agent: async () => (await import("./agent.command-tsx1nsdj.js")).AgentCommand,
-  application: async () => (await import("./application.command-n8ex8g9h.js")).ApplicationCommand,
-  library: async () => (await import("./library.command-p3jgf5h2.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-bms0qn6t.js")).LocalRegistryCommand,
-  package: async () => (await import("./package.command-fbpa6r4w.js")).PackageCommand,
-  module: async () => (await import("./module.command-hb3xm07r.js")).ModuleCommand,
-  page: async () => (await import("./page.command-92vrmw96.js")).PageCommand,
-  context: async () => (await import("./context.command-s7a41qjs.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-f0rhw014.js")).CloudCommand,
-  guideline: async () => (await import("./guideline.command-qrw84ttb.js")).GuidelineCommand,
-  scalar: async () => (await import("./scalar.command-zcsjgvax.js")).ScalarCommand,
-  primitive: async () => (await import("./primitive.command-k6b9jfxr.js")).PrimitiveCommand,
-  quality: async () => (await import("./quality.command-89vwmjvf.js")).QualityCommand,
-  repair: async () => (await import("./repair.command-nh9jn8rh.js")).RepairCommand,
-  workflow: async () => (await import("./workflow.command-jj0cphfm.js")).WorkflowCommand
+  workspace: async () => (await import("./workspace.command-2pfnrhmw.js")).WorkspaceCommand,
+  agent: async () => (await import("./agent.command-99yaptk3.js")).AgentCommand,
+  application: async () => (await import("./application.command-77nxchr4.js")).ApplicationCommand,
+  library: async () => (await import("./library.command-2b20rx36.js")).LibraryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-tdn3373t.js")).LocalRegistryCommand,
+  package: async () => (await import("./package.command-dcdya2hn.js")).PackageCommand,
+  module: async () => (await import("./module.command-ez5psv7q.js")).ModuleCommand,
+  page: async () => (await import("./page.command-he49r0vd.js")).PageCommand,
+  context: async () => (await import("./context.command-a0pwgc3v.js")).ContextCommand,
+  cloud: async () => (await import("./cloud.command-gegy1qxv.js")).CloudCommand,
+  guideline: async () => (await import("./guideline.command-83p3y9w7.js")).GuidelineCommand,
+  scalar: async () => (await import("./scalar.command-q4ravcd9.js")).ScalarCommand,
+  primitive: async () => (await import("./primitive.command-w2hyrf9c.js")).PrimitiveCommand,
+  quality: async () => (await import("./quality.command-8xewbve2.js")).QualityCommand,
+  repair: async () => (await import("./repair.command-9f9wy32e.js")).RepairCommand,
+  workflow: async () => (await import("./workflow.command-3stj54ek.js")).WorkflowCommand
 };
 var commandModuleIds = Object.keys(commandModules);
 

package/{library.command-p3jgf5h2.js → library.command-2b20rx36.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   LibraryScript
-} from "./index-f0t3wjyr.js";
+} from "./index-emsw8h3b.js";
 import {
   Lib,
   Workspace,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{localRegistry.command-bms0qn6t.js → localRegistry.command-tdn3373t.js}

@@ -2,27 +2,27 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-8md8zszv.js";
+} from "./index-wm5hw5mr.js";
 import {
   PackageScript
-} from "./index-x1dbhd80.js";
+} from "./index-j35ceh2c.js";
 import"./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-r8z20vnj.js";
-import"./index-f0t3wjyr.js";
+} from "./index-m285dkby.js";
+import"./index-emsw8h3b.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command,
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import"./index-fgc8r6dj.js";
 import"./index-5vy2jzar.js";
 import {
   PkgExecutor
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{module.command-hb3xm07r.js → module.command-ez5psv7q.js}

@@ -1,20 +1,20 @@
 // @bun
 import {
   ModuleScript
-} from "./index-tn46rr6w.js";
+} from "./index-27jj517n.js";
 import"./index-ss469dec.js";
-import"./index-kkya2ped.js";
+import"./index-4etexq7j.js";
 import"./index-sh01r3pm.js";
 import {
   renderPrimitiveReport
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   Module,
   Sys,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{package.command-fbpa6r4w.js → package.command-dcdya2hn.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   PackageScript
-} from "./index-x1dbhd80.js";
+} from "./index-j35ceh2c.js";
 import {
   Pkg,
   Workspace,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.64",
+  "version": "3.0.0-alpha.65",
   "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.64",
+    "akanjs": "3.0.0-alpha.65",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/{page.command-92vrmw96.js → page.command-he49r0vd.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   PageScript
-} from "./index-kkya2ped.js";
+} from "./index-4etexq7j.js";
 import {
   App,
   Module,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{primitive.command-k6b9jfxr.js → primitive.command-w2hyrf9c.js}

@@ -1,20 +1,20 @@
 // @bun
 import {
   PrimitiveScript
-} from "./index-cc1mgv1f.js";
-import"./index-tn46rr6w.js";
+} from "./index-rzekxec9.js";
+import"./index-27jj517n.js";
 import"./index-ss469dec.js";
-import"./index-kkya2ped.js";
+import"./index-4etexq7j.js";
 import"./index-sh01r3pm.js";
 import {
   renderPrimitiveReport
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{quality.command-89vwmjvf.js → quality.command-8xewbve2.js}

@@ -7,12 +7,12 @@ import {
   command,
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import {
   isAllowedLibFacetRootFile,
   rootAllowedDirs,
   rootAllowedFiles
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{repair.command-nh9jn8rh.js → repair.command-9f9wy32e.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   RepairRunner
-} from "./index-ryns915y.js";
-import"./index-wc19q8mb.js";
-import"./index-g44fykfw.js";
+} from "./index-4sgv0wcr.js";
+import"./index-v76gy4dn.js";
+import"./index-mr02v9xp.js";
 import {
   Workspace,
   command,
   script
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{scalar.command-zcsjgvax.js → scalar.command-q4ravcd9.js}

@@ -1,18 +1,18 @@
 // @bun
 import {
   ScalarScript
-} from "./index-4mtyaqj2.js";
+} from "./index-rm7xj6bc.js";
 import"./index-ss469dec.js";
 import"./index-sh01r3pm.js";
 import {
   renderPrimitiveReport
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   Sys,
   command
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{workflow.command-jj0cphfm.js → workflow.command-3stj54ek.js}

@@ -1,30 +1,30 @@
 // @bun
 import {
   WorkflowRunner
-} from "./index-dvg362vq.js";
+} from "./index-ejr3h3wc.js";
 import {
   ScalarScript
-} from "./index-4mtyaqj2.js";
+} from "./index-rm7xj6bc.js";
 import {
   PrimitiveScript
-} from "./index-cc1mgv1f.js";
+} from "./index-rzekxec9.js";
 import {
   ModuleScript
-} from "./index-tn46rr6w.js";
+} from "./index-27jj517n.js";
 import"./index-ss469dec.js";
-import"./index-kkya2ped.js";
+import"./index-4etexq7j.js";
 import"./index-sh01r3pm.js";
-import"./index-wc19q8mb.js";
+import"./index-v76gy4dn.js";
 import {
   createWorkflowStepRegistry
-} from "./index-g44fykfw.js";
+} from "./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command,
   script
-} from "./index-ckpwq052.js";
-import"./index-681sx6nt.js";
+} from "./index-qch3r961.js";
+import"./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{workspace.command-ma3g994j.js → workspace.command-2pfnrhmw.js}

@@ -1,40 +1,40 @@
 // @bun
 import {
   ContextScript
-} from "./index-ek4mkwxp.js";
-import"./index-ryns915y.js";
-import"./index-dvg362vq.js";
-import"./index-4mtyaqj2.js";
-import"./index-cc1mgv1f.js";
-import"./index-tn46rr6w.js";
+} from "./index-1t5r09v4.js";
+import"./index-4sgv0wcr.js";
+import"./index-ejr3h3wc.js";
+import"./index-rm7xj6bc.js";
+import"./index-rzekxec9.js";
+import"./index-27jj517n.js";
 import"./index-ss469dec.js";
-import"./index-kkya2ped.js";
+import"./index-4etexq7j.js";
 import {
   CloudScript
-} from "./index-0g9ajdz8.js";
+} from "./index-db89awmp.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-8md8zszv.js";
+} from "./index-wm5hw5mr.js";
 import {
   PackageScript
-} from "./index-x1dbhd80.js";
-import"./index-ce9755av.js";
+} from "./index-j35ceh2c.js";
+import"./index-cwa0jvjt.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
 import {
   AgentScript
-} from "./index-h0mnt0b0.js";
-import"./index-wc19q8mb.js";
-import"./index-g44fykfw.js";
+} from "./index-wxc9p0n0.js";
+import"./index-v76gy4dn.js";
+import"./index-mr02v9xp.js";
 import"./index-j37qq1f2.js";
 import {
   ApplicationScript
-} from "./index-r8z20vnj.js";
+} from "./index-m285dkby.js";
 import {
   LibraryScript
-} from "./index-f0t3wjyr.js";
+} from "./index-emsw8h3b.js";
 import"./index-76rn3g2c.js";
 import {
   Exec,
@@ -42,7 +42,7 @@ import {
   command,
   runner,
   script
-} from "./index-ckpwq052.js";
+} from "./index-qch3r961.js";
 import"./index-fgc8r6dj.js";
 import {
   ThemeValidator,
@@ -59,7 +59,7 @@ import {
   collectScopeRecipeSources,
   extractAgentBlock,
   renderScopeAgentBlock
-} from "./index-681sx6nt.js";
+} from "./index-n57kkvtg.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import {