@akanjs/devkit 3.0.0-alpha.97 → 3.0.0-alpha.99

package/DEV_RUNTIME_KNOBS.md

@@ -97,12 +97,19 @@ sized against idle suspend being on**; setting it to `0` keeps every builder res
 
 Two things bound the peak rather than the floor:
 
-- **`--concurrency` (default 1).** Apps boot in waves, and the next wave starts only once the previous one
-  reports ready. A cold boot build is the builder's peak, so booting `n` apps at once means `n` overlapping
-  peaks — which is what OOM-kills a container that would have been fine with them staggered.
+- **`--concurrency` (default: what the machine allows).** Apps boot in waves, and the next wave starts only
+  once the previous one reports ready. A cold boot build is the builder's peak, so booting `n` apps at once
+  means `n` overlapping peaks — which is what OOM-kills a container that would have been fine with them
+  staggered. Unset, the wave is `min(apps, half the memory budget / 900MB per app, cores / 4)`, never below
+  one, and the session prints which — so a laptop boots its apps together and a 1.2GB container still
+  staggers them. The memory budget is the smaller of the host's RAM and `AKAN_MEMORY_LIMIT` / the cgroup
+  limit; `os.freemem()` is not consulted, because it counts free pages rather than reclaimable ones and
+  reports ~0.3GB on an idle 48GB laptop.
 - **`AKAN_MEMORY_LIMIT` is per process, not per session.** Each dev host derives its builder and RSC-worker
   ceilings from it independently, so a limit sized for one app does not become a budget for four. Divide it
-  yourself, or leave it unset on a laptop.
+  yourself, or leave it unset on a laptop. The one place it is read as a session ceiling is the boot wave
+  above, and only downward: a session cannot outgrow the container it runs in, whatever each process inside
+  it was told it may take.
 
 ## Sizing a small sandbox
 

package/executors.test.ts

@@ -315,6 +315,11 @@ describe("Workspace and app executor environment contracts", () => {
     const prepared = await app.prepareCommand("build");
     expect(prepared.env.AKAN_COMMAND_TYPE).toBe("build");
     expect(prepared.env.AKAN_PUBLIC_BASE_PATHS).toBe("admin");
+    // Bundling reads `process.env` through getPublicEnv and `define`s every AKAN_PUBLIC_* into a literal, so a
+    // dev port published here would be baked into the artifact and outrank the PORT the container is run with.
+    expect(process.env.AKAN_PUBLIC_APP_NAME).toBe("demo");
+    expect(process.env.AKAN_PUBLIC_CLIENT_PORT).toBeUndefined();
+    expect(process.env.AKAN_PUBLIC_SERVER_PORT).toBeUndefined();
     expect((await stat(path.join(root, "dist/apps/demo/private"))).isDirectory()).toBe(true);
     expect((await stat(path.join(root, "dist/apps/demo/public"))).isDirectory()).toBe(true);
   });

package/executors.ts

@@ -1455,7 +1455,15 @@ export class AppExecutor extends SysExecutor {
     // which filters to AKAN_PUBLIC_*) sees AKAN_PUBLIC_APP_NAME — otherwise SSR throws
     // "environment variable AKAN_PUBLIC_APP_NAME is required". Only AKAN_PUBLIC_* is baked into bundles, so
     // this does not leak non-public env.
-    if (type === "build") Object.assign(process.env, env);
+    // The port keys are this machine's dev allocation, and `define` turns an `AKAN_PUBLIC_*` into a literal the
+    // artifact can never be run with a different value for — a baked port would outrank the `PORT` the container
+    // is started with and send every SSR self-call to a port nothing bound.
+    if (type === "build") {
+      const buildEnv = { ...env };
+      delete buildEnv.AKAN_PUBLIC_CLIENT_PORT;
+      delete buildEnv.AKAN_PUBLIC_SERVER_PORT;
+      Object.assign(process.env, buildEnv);
+    }
     return { env };
   }
   #publicEnv: Record<string, string> | null = null;

package/package.json

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