@akanjs/devkit 3.0.0-alpha.19 → 3.0.0-alpha.20

package/executors.test.ts

@@ -881,16 +881,14 @@ describe("scan info construction", () => {
 });
 
 describe("AppExecutor.shouldRelaunchForAppEnv", () => {
-  test("relaunches when the app name is missing or different at process start", () => {
-    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", {})).toBe(true);
-    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", { AKAN_PUBLIC_APP_NAME: "other" })).toBe(true);
+  test("relaunches when the process was born without the app name, or with another app's", () => {
+    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", undefined, undefined)).toBe(true);
+    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", "other", undefined)).toBe(true);
   });
 
-  test("runs in place when the name already matches, and never relaunches twice", () => {
-    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", { AKAN_PUBLIC_APP_NAME: "sceny" })).toBe(false);
-    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", { AKAN_BUILD_RELAUNCHED: "1" })).toBe(false);
-    expect(
-      AppExecutor.shouldRelaunchForAppEnv("sceny", { AKAN_BUILD_RELAUNCHED: "1", AKAN_PUBLIC_APP_NAME: "other" }),
-    ).toBe(false);
+  test("runs in place when the name was present at birth, and never relaunches twice", () => {
+    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", "sceny", undefined)).toBe(false);
+    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", undefined, "1")).toBe(false);
+    expect(AppExecutor.shouldRelaunchForAppEnv("sceny", "other", "1")).toBe(false);
   });
 });

package/executors.ts

@@ -1284,6 +1284,10 @@ interface AppExecutorOptions {
   workspace?: WorkspaceExecutor;
   name: string;
 }
+// Captured at module load, before the command dispatcher patches the resolved app name into `process.env` —
+// the relaunch guard below must judge what bundler macros will see, which is the env this process was born with.
+const bootAppName = process.env.AKAN_PUBLIC_APP_NAME;
+
 export class AppExecutor extends SysExecutor {
   // `typescript` costs ~65MB resident, so keep it out of the module graph of every process that only
   // ever imports an executor. Route validation is the sole consumer here and is already async.
@@ -1347,15 +1351,24 @@ export class AppExecutor extends SysExecutor {
    * to them — and any hand-written `@libs/<lib>/server` import puts that lib's env files (module-scope `getEnv()`)
    * into the `getSerializedSignal` macro graph. `AKAN_PUBLIC_APP_NAME` is the one required key no workspace root
    * `.env` can carry, so the build relaunches itself once with it in place; the child sees it from birth.
+   *
+   * The decision compares the boot snapshot, never the live `process.env`: the command dispatcher writes the
+   * resolved app into `process.env.AKAN_PUBLIC_APP_NAME` before any command method runs, which satisfies runtime
+   * readers but not macros — trusting it is how this relaunch shipped once without ever firing.
    */
-  static shouldRelaunchForAppEnv(appName: string, env: Record<string, string | undefined> = process.env) {
-    if (env.AKAN_BUILD_RELAUNCHED === "1") return false;
-    return env.AKAN_PUBLIC_APP_NAME !== appName;
+  static shouldRelaunchForAppEnv(
+    appName: string,
+    bootName: string | undefined = bootAppName,
+    marker: string | undefined = process.env.AKAN_BUILD_RELAUNCHED,
+  ) {
+    if (marker === "1") return false;
+    return bootName !== appName;
   }
   async relaunchWithAppEnv(): Promise<number | null> {
     if (!AppExecutor.shouldRelaunchForAppEnv(this.name)) return null;
+    console.info(`Relaunching with AKAN_PUBLIC_APP_NAME=${this.name} so bundler macros see the app env.`);
     const child = Bun.spawn([process.execPath, ...process.argv.slice(1)], {
-      env: { ...this.getCommandEnv(), AKAN_BUILD_RELAUNCHED: "1" },
+      env: { ...this.getCommandEnv(), AKAN_PUBLIC_APP_NAME: this.name, AKAN_BUILD_RELAUNCHED: "1" },
       stdin: "inherit",
       stdout: "inherit",
       stderr: "inherit",

package/package.json

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