@akanjs/cli 3.0.0-alpha.88 → 3.0.0-alpha.89

package/{index-k1n0h7dk.js → index-q8sn827n.js}

@@ -1,11 +1,126 @@
 // @bun
 import {
   FileSys
-} from "./index-ayy5ecax.js";
+} from "./index-q0y2jq9j.js";
 import {
   getDirname2
 } from "./index-6wwzs1bc.js";
 
+// pkgs/@akanjs/devkit/codegenLock.ts
+import { mkdir, open, readFile, rm, stat } from "fs/promises";
+import path from "path";
+import { Logger } from "akanjs/common";
+
+class CodegenLock {
+  static fileName = "codegen.lock";
+  static waitTimeoutMs = 1e4;
+  static unknownHolderStaleMs = 60000;
+  static #pollMs = 25;
+  static #logger = new Logger("CodegenLock");
+  static #queue = Promise.resolve();
+  static pathIn(workspaceRoot) {
+    return path.join(workspaceRoot, "local", ".akan", CodegenLock.fileName);
+  }
+  static async run(workspaceRoot, label, fn) {
+    const ahead = CodegenLock.#queue;
+    let done;
+    CodegenLock.#queue = new Promise((resolve) => {
+      done = resolve;
+    });
+    try {
+      await CodegenLock.#waitForQueue(ahead, label);
+      return await CodegenLock.#withFileLock(workspaceRoot, label, fn);
+    } finally {
+      done();
+    }
+  }
+  static async#waitForQueue(ahead, label) {
+    let timer = null;
+    const expired = new Promise((resolve) => {
+      timer = setTimeout(() => resolve("expired"), CodegenLock.waitTimeoutMs);
+    });
+    try {
+      if (await Promise.race([ahead.then(() => "done"), expired]) === "expired")
+        CodegenLock.#logger.warn(`codegen lock queued past ${CodegenLock.waitTimeoutMs}ms in this process; continuing without waiting (${label})`);
+    } finally {
+      if (timer)
+        clearTimeout(timer);
+    }
+  }
+  static async#withFileLock(workspaceRoot, label, fn) {
+    const lockPath = CodegenLock.pathIn(workspaceRoot);
+    await mkdir(path.dirname(lockPath), { recursive: true }).catch(() => {
+      return;
+    });
+    const held = await CodegenLock.#acquire(lockPath, label);
+    try {
+      return await fn();
+    } finally {
+      if (held)
+        await rm(lockPath, { force: true }).catch(() => {
+          return;
+        });
+    }
+  }
+  static async#acquire(lockPath, label) {
+    const deadline = Date.now() + CodegenLock.waitTimeoutMs;
+    for (;; ) {
+      const handle = await open(lockPath, "wx").catch(() => null);
+      if (handle) {
+        await handle.writeFile(JSON.stringify({ pid: process.pid, at: Date.now(), label })).catch(() => {
+          return;
+        });
+        await handle.close().catch(() => {
+          return;
+        });
+        return true;
+      }
+      if (await CodegenLock.#reclaimIfAbandoned(lockPath))
+        continue;
+      if (Date.now() >= deadline) {
+        CodegenLock.#logger.warn(`codegen lock at ${lockPath} held past ${CodegenLock.waitTimeoutMs}ms; continuing without it (${label})`);
+        return false;
+      }
+      await Bun.sleep(CodegenLock.#pollMs);
+    }
+  }
+  static async#reclaimIfAbandoned(lockPath) {
+    const info = await stat(lockPath).catch(() => null);
+    if (!info)
+      return true;
+    const holder = CodegenLock.#parseHolder(await readFile(lockPath, "utf8").catch(() => ""));
+    if (holder) {
+      if (CodegenLock.#isAlive(holder.pid))
+        return false;
+    } else if (Date.now() - info.mtimeMs < CodegenLock.unknownHolderStaleMs)
+      return false;
+    await rm(lockPath, { force: true }).catch(() => {
+      return;
+    });
+    return true;
+  }
+  static #parseHolder(raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.pid !== "number" || typeof parsed.at !== "number")
+        return null;
+      return { pid: parsed.pid, at: parsed.at, label: typeof parsed.label === "string" ? parsed.label : "" };
+    } catch {
+      return null;
+    }
+  }
+  static #isAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+      return false;
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch (error) {
+      return error.code === "EPERM";
+    }
+  }
+}
+
 // pkgs/@akanjs/devkit/spinner.ts
 import ora from "ora";
 
@@ -80,20 +195,20 @@ import { readFileSync as readFileSync2 } from "fs";
 import {
   copyFile,
   cp as cpEntry,
-  mkdir as mkdir2,
+  mkdir as mkdir3,
   readdir as readDirEntries,
   realpath,
-  rm as rm2,
-  stat,
+  rm as rm3,
+  stat as stat2,
   symlink
 } from "fs/promises";
-import path7 from "path";
+import path8 from "path";
 import { pathToFileURL } from "url";
 import {
   capitalize,
   getPageSourceFileViolation,
   isRouteSourceFile,
-  Logger,
+  Logger as Logger2,
   parseRouteModuleKey,
   validatePageSourceFile,
   validateSubRoutePageKey
@@ -241,8 +356,9 @@ ${CLAUDE_COMMENT_RULE}
 
 // pkgs/@akanjs/devkit/akanConfig/akanConfig.ts
 import fs from "fs";
-import path from "path";
+import path2 from "path";
 import { fileURLToPath } from "url";
+import { normalizeRoutePrefix } from "akanjs/base";
 import { resolveAkanI18nConfig } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/akanConfig/types.ts
@@ -329,8 +445,8 @@ var normalizeIndexPath = (indexPath) => {
   const normalized = indexPath?.trim();
   if (!normalized)
     return;
-  const path2 = `/${normalized.replace(/^\/+|\/+$/g, "")}`;
-  return path2 === "/" ? "/" : path2;
+  const path = `/${normalized.replace(/^\/+|\/+$/g, "")}`;
+  return path === "/" ? "/" : path;
 };
 var normalizeStringList = (values) => {
   const normalized = values?.map((value) => value.trim()).filter(Boolean) ?? [];
@@ -397,6 +513,7 @@ class AkanAppConfig {
   optimizeImports;
   images;
   i18n;
+  api;
   publicEnv;
   mobile;
   hasMobileConfig;
@@ -430,6 +547,12 @@ class AkanAppConfig {
     this.i18n = resolveAkanI18nConfig(config?.i18n);
     process.env.AKAN_PUBLIC_DEFAULT_LOCALE = this.i18n.defaultLocale;
     process.env.AKAN_PUBLIC_LOCALES = this.i18n.locales.join(",");
+    this.api = {
+      prefix: normalizeRoutePrefix(config?.api?.prefix) ?? "/api",
+      websocketPrefix: normalizeRoutePrefix(config?.api?.websocketPrefix) ?? "/ws"
+    };
+    process.env.AKAN_PUBLIC_API_PREFIX = this.api.prefix;
+    process.env.AKAN_PUBLIC_WS_PREFIX = this.api.websocketPrefix;
     this.publicEnv = config?.publicEnv ?? [];
     this.secrets = config?.secrets ?? [];
     this.assets = {
@@ -604,6 +727,8 @@ ENV AKAN_PUBLIC_ENV=${this.baseDevEnv.env}
 ${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_API_PREFIX=${this.api.prefix}
+ENV AKAN_PUBLIC_WS_PREFIX=${this.api.websocketPrefix}
 ENV AKAN_PUBLIC_OPERATION_MODE=cloud
 ENV AKAN_LOG_TO_FILE=0
 ${webEnvLines}
@@ -618,7 +743,7 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
   static async from(app, { bustImportCache = false } = {}) {
     const [configImp, baseDevEnv, libs, rootPackageJson] = await Promise.all([
       AkanAppConfig.importConfigModule(app.cwdPath, { bustImportCache }),
-      WorkspaceExecutor.getBaseDevEnv(path.join(app.workspace.workspaceRoot, ".env")),
+      WorkspaceExecutor.getBaseDevEnv(path2.join(app.workspace.workspaceRoot, ".env")),
       app.workspace.getLibs(),
       app.workspace.getPackageJson()
     ]);
@@ -698,11 +823,11 @@ var akanPackageJson = null;
 function getAkanPackageJson() {
   if (akanPackageJson)
     return akanPackageJson;
-  const sourceDir = path.dirname(fileURLToPath(import.meta.url));
+  const sourceDir = path2.dirname(fileURLToPath(import.meta.url));
   const packageJsonPaths = [
-    path.join(sourceDir, "../../../akanjs/package.json"),
-    path.join(process.cwd(), "pkgs/akanjs/package.json"),
-    path.join(path.dirname(Bun.main), "node_modules/akanjs/package.json")
+    path2.join(sourceDir, "../../../akanjs/package.json"),
+    path2.join(process.cwd(), "pkgs/akanjs/package.json"),
+    path2.join(path2.dirname(Bun.main), "node_modules/akanjs/package.json")
   ];
   try {
     packageJsonPaths.unshift(Bun.resolveSync("akanjs/package.json", sourceDir));
@@ -757,25 +882,25 @@ class AkanLibConfig {
 //! need to refactor
 var increaseBuildNum = async (app) => {
   const appConfig = await AkanAppConfig.from(app);
-  const akanConfigPath = path.join(app.cwdPath, "akan.config.ts");
+  const akanConfigPath = path2.join(app.cwdPath, "akan.config.ts");
   const akanConfig = fs.readFileSync(akanConfigPath, "utf8");
   const akanConfigContent = akanConfig.replace(`buildNum: ${appConfig.mobile.buildNum}`, `buildNum: ${appConfig.mobile.buildNum + 1}`);
   fs.writeFileSync(akanConfigPath, akanConfigContent);
 };
 var decreaseBuildNum = async (app) => {
   const appConfig = await AkanAppConfig.from(app);
-  const akanConfigPath = path.join(app.cwdPath, "akan.config.ts");
+  const akanConfigPath = path2.join(app.cwdPath, "akan.config.ts");
   const akanConfig = fs.readFileSync(akanConfigPath, "utf8");
   const akanConfigContent = akanConfig.replace(`buildNum: ${appConfig.mobile.buildNum}`, `buildNum: ${appConfig.mobile.buildNum - 1}`);
   fs.writeFileSync(akanConfigPath, akanConfigContent);
 };
 // pkgs/@akanjs/devkit/artifact/implicitRootLayout.ts
-import { mkdir } from "fs/promises";
-import path3 from "path";
+import { mkdir as mkdir2 } from "fs/promises";
+import path4 from "path";
 
 // pkgs/@akanjs/devkit/transforms/asyncDefaultExportDetector.ts
 import fs2 from "fs";
-import path2 from "path";
+import path3 from "path";
 
 class AsyncDefaultExportDetector {
   static #typescriptLoad;
@@ -786,7 +911,7 @@ class AsyncDefaultExportDetector {
   static async detect(moduleAbsPath) {
     try {
       const typescript = await AsyncDefaultExportDetector.#loadTypescript();
-      const source = fs2.readFileSync(path2.resolve(moduleAbsPath), "utf8");
+      const source = fs2.readFileSync(path3.resolve(moduleAbsPath), "utf8");
       const sourceFile = typescript.createSourceFile(moduleAbsPath, source, typescript.ScriptTarget.Latest, true, AsyncDefaultExportDetector.#scriptKind(typescript, moduleAbsPath));
       return new AsyncDefaultExportDetector(typescript).detectInSourceFile(sourceFile);
     } catch {
@@ -853,16 +978,16 @@ class AsyncDefaultExportDetector {
 // pkgs/@akanjs/devkit/artifact/implicitRootLayout.ts
 var LAYOUT_KEY_RE = /^\.\/(.+\/)?_layout\.(tsx|ts|jsx|js)$/;
 async function appHasStModule(appCwdPath) {
-  return Bun.file(path3.join(appCwdPath, "lib", "st.ts")).exists();
+  return Bun.file(path4.join(appCwdPath, "lib", "st.ts")).exists();
 }
-var IMPLICIT_LAYOUT_DIR = path3.join(".akan", "generated", "root-layouts");
-var IMPLICIT_DICT_DIR = path3.join(".akan", "generated", "dict");
-var IMPLICIT_OVERRIDES_DIR = path3.join(".akan", "generated", "overrides");
+var IMPLICIT_LAYOUT_DIR = path4.join(".akan", "generated", "root-layouts");
+var IMPLICIT_DICT_DIR = path4.join(".akan", "generated", "dict");
+var IMPLICIT_OVERRIDES_DIR = path4.join(".akan", "generated", "overrides");
 var OVERRIDES_KEY_RE = /^\.\/(.+\/)?_overrides\.(tsx|ts|jsx|js)$/;
 async function writeGeneratedOverridesLayoutFile(opts) {
   const filename = `${opts.key.replace(/^\.\//, "").replace(/[^a-zA-Z0-9]+/g, "_")}.tsx`;
-  const absPath = path3.join(path3.resolve(opts.appCwdPath), IMPLICIT_OVERRIDES_DIR, filename);
-  const userRel = path3.relative(path3.dirname(absPath), opts.userAbsPath).split(path3.sep).join("/");
+  const absPath = path4.join(path4.resolve(opts.appCwdPath), IMPLICIT_OVERRIDES_DIR, filename);
+  const userRel = path4.relative(path4.dirname(absPath), opts.userAbsPath).split(path4.sep).join("/");
   const userSpecifier = userRel.startsWith(".") ? userRel : `./${userRel}`;
   const source = `"use client";
 import { UiOverrideProvider } from "akanjs/ui";
@@ -890,10 +1015,10 @@ function implicitRootLayoutKey(segments) {
 }
 function implicitRootLayoutAbsPath(appCwdPath, segments) {
   const filename = segments.length ? `${segments.join("__")}__root_layout.tsx` : "__root_layout.tsx";
-  return path3.join(path3.resolve(appCwdPath), IMPLICIT_LAYOUT_DIR, filename);
+  return path4.join(path4.resolve(appCwdPath), IMPLICIT_LAYOUT_DIR, filename);
 }
 function implicitDictionaryMacroAbsPath(appCwdPath) {
-  return path3.join(path3.resolve(appCwdPath), IMPLICIT_DICT_DIR, "useDict.ts");
+  return path4.join(path4.resolve(appCwdPath), IMPLICIT_DICT_DIR, "useDict.ts");
 }
 function isRootBoundarySegments(segments, basePaths) {
   const firstVisibleIndex = segments.findIndex((segment) => !/^\(.+\)$/.test(segment));
@@ -916,7 +1041,7 @@ function findRootBoundaries(pageKeys, appCwdPath, basePaths) {
     const id = segments.join("/");
     boundaries.set(id, {
       sourceKey: key,
-      sourceAbsPath: path3.resolve(appCwdPath, "page", key.replace(/^\.\//, "")),
+      sourceAbsPath: path4.resolve(appCwdPath, "page", key.replace(/^\.\//, "")),
       segments
     });
   }
@@ -934,21 +1059,21 @@ function findExplicitRootLayoutAbsPath(pageKeys, appCwdPath) {
     const segments = getRootBoundarySegments(key);
     return segments !== null && segments.length === 0;
   });
-  return rootLayoutKey ? path3.resolve(appCwdPath, "page", rootLayoutKey.replace(/^\.\//, "")) : null;
+  return rootLayoutKey ? path4.resolve(appCwdPath, "page", rootLayoutKey.replace(/^\.\//, "")) : null;
 }
 function routePrefixForSegments(segments) {
   const visible = segments.filter((segment) => !/^\(.+\)$/.test(segment));
   return visible[0] ?? null;
 }
 async function assertEnvClientConvention(appCwdPath, appName) {
-  const envPath = path3.join(appCwdPath, "env", "env.client.ts");
+  const envPath = path4.join(appCwdPath, "env", "env.client.ts");
   if (!await Bun.file(envPath).exists()) {
     throw new Error(`[route-convention] app "${appName}" must provide env/env.client.ts exporting "env" for generated System.Provider`);
   }
 }
 async function writeGeneratedDictionaryMacroFile(appCwdPath, appName) {
   const absPath = implicitDictionaryMacroAbsPath(appCwdPath);
-  await mkdir(path3.dirname(absPath), { recursive: true });
+  await mkdir2(path4.dirname(absPath), { recursive: true });
   await Bun.write(absPath, `import { getAllDictionary } from "@apps/${appName}/lib/dict" with { type: "macro" };
 
 export const allDictionary = getAllDictionary();
@@ -959,13 +1084,13 @@ async function writeGeneratedRootLayoutFile(opts) {
   await assertEnvClientConvention(opts.appCwdPath, opts.appName);
   const dictMacroAbsPath = opts.includeSystemProvider ? await writeGeneratedDictionaryMacroFile(opts.appCwdPath, opts.appName) : null;
   const absPath = implicitRootLayoutAbsPath(opts.appCwdPath, opts.boundary.segments);
-  await mkdir(path3.dirname(absPath), { recursive: true });
-  const dictMacroRel = dictMacroAbsPath ? path3.relative(path3.dirname(absPath), dictMacroAbsPath).split(path3.sep).join("/") : null;
+  await mkdir2(path4.dirname(absPath), { recursive: true });
+  const dictMacroRel = dictMacroAbsPath ? path4.relative(path4.dirname(absPath), dictMacroAbsPath).split(path4.sep).join("/") : null;
   const dictMacroSpecifier = dictMacroRel ? dictMacroRel.startsWith(".") ? dictMacroRel : `./${dictMacroRel}` : null;
-  const sourceRel = opts.boundary.sourceAbsPath ? path3.relative(path3.dirname(absPath), opts.boundary.sourceAbsPath).split(path3.sep).join("/") : null;
+  const sourceRel = opts.boundary.sourceAbsPath ? path4.relative(path4.dirname(absPath), opts.boundary.sourceAbsPath).split(path4.sep).join("/") : null;
   const sourceSpecifier = sourceRel ? sourceRel.startsWith(".") ? sourceRel : `./${sourceRel}` : null;
   const inheritedSourceAbsPath = opts.rootSourceAbsPath && opts.rootSourceAbsPath !== opts.boundary.sourceAbsPath ? opts.rootSourceAbsPath : null;
-  const inheritedSourceRel = inheritedSourceAbsPath ? path3.relative(path3.dirname(absPath), inheritedSourceAbsPath).split(path3.sep).join("/") : null;
+  const inheritedSourceRel = inheritedSourceAbsPath ? path4.relative(path4.dirname(absPath), inheritedSourceAbsPath).split(path4.sep).join("/") : null;
   const inheritedSourceSpecifier = inheritedSourceRel ? inheritedSourceRel.startsWith(".") ? inheritedSourceRel : `./${inheritedSourceRel}` : null;
   const clientImport = opts.includeStInit ? `import { st } from "@apps/${opts.appName}/client";
 void st;
@@ -1069,7 +1194,7 @@ ${layoutBinding}  return ${layoutReturn};
   return absPath;
 }
 async function resolveSsrPageEntries(opts) {
-  const absPageDir = path3.resolve(opts.appCwdPath, "page");
+  const absPageDir = path4.resolve(opts.appCwdPath, "page");
   const hasSt = await appHasStModule(opts.appCwdPath);
   const basePaths = opts.basePaths ?? [];
   const rootSourceAbsPath = findExplicitRootLayoutAbsPath(opts.pageKeys, opts.appCwdPath);
@@ -1079,7 +1204,7 @@ async function resolveSsrPageEntries(opts) {
     return segments !== null && isRootBoundarySegments(segments, basePaths);
   }));
   const base = await Promise.all(opts.pageKeys.filter((key) => !rootLayoutKeys.has(key)).map(async (key) => {
-    const userAbsPath = path3.resolve(absPageDir, key);
+    const userAbsPath = path4.resolve(absPageDir, key);
     if (OVERRIDES_KEY_RE.test(key)) {
       const moduleAbsPath = await writeGeneratedOverridesLayoutFile({
         appCwdPath: opts.appCwdPath,
@@ -1114,7 +1239,7 @@ async function resolveSsrPageEntriesForApp(app, pageKeys) {
 // pkgs/@akanjs/devkit/linter.ts
 import { spawn } from "child_process";
 import { existsSync, readFileSync } from "fs";
-import path4 from "path";
+import path5 from "path";
 import chalk from "chalk";
 var parseBiomeReport = (output) => {
   for (let start = output.indexOf("{");start !== -1; start = output.indexOf("{", start + 1)) {
@@ -1171,13 +1296,13 @@ class Linter {
   #biomeBin;
   constructor(cwdPath) {
     this.lintRoot = this.#findBiomeRootPath(cwdPath);
-    this.configPath = Linter.#configPathIn(this.lintRoot) ?? path4.join(this.lintRoot, "biome.json");
-    const localBiomeBin = path4.join(this.lintRoot, "node_modules/.bin/biome");
+    this.configPath = Linter.#configPathIn(this.lintRoot) ?? path5.join(this.lintRoot, "biome.json");
+    const localBiomeBin = path5.join(this.lintRoot, "node_modules/.bin/biome");
     this.#biomeBin = existsSync(localBiomeBin) ? localBiomeBin : "biome";
   }
   static #configPathIn(dir) {
     for (const fileName of BIOME_CONFIG_FILES) {
-      const configPath = path4.join(dir, fileName);
+      const configPath = path5.join(dir, fileName);
       if (existsSync(configPath))
         return configPath;
     }
@@ -1186,19 +1311,19 @@ class Linter {
   #findBiomeRootPath(dir) {
     if (Linter.#configPathIn(dir))
       return dir;
-    const parentDir = path4.dirname(dir);
+    const parentDir = path5.dirname(dir);
     if (parentDir === dir)
       throw new Error(`biome.json not found from ${dir}`);
     return this.#findBiomeRootPath(parentDir);
   }
   #toBiomePath(filePath) {
-    const relativePath = path4.relative(this.lintRoot, filePath);
-    if (!relativePath.startsWith("..") && !path4.isAbsolute(relativePath))
+    const relativePath = path5.relative(this.lintRoot, filePath);
+    if (!relativePath.startsWith("..") && !path5.isAbsolute(relativePath))
       return relativePath;
     return filePath;
   }
   #resolveFilePath(filePath) {
-    return path4.isAbsolute(filePath) ? filePath : path4.join(this.lintRoot, filePath);
+    return path5.isAbsolute(filePath) ? filePath : path5.join(this.lintRoot, filePath);
   }
   async#runBiome(args, input) {
     return await new Promise((resolve, reject) => {
@@ -1223,7 +1348,7 @@ class Linter {
     const diagnosticPath = diagnostic.location?.path;
     if (!diagnosticPath)
       return fallbackFilePath;
-    return path4.isAbsolute(diagnosticPath) ? diagnosticPath : path4.join(this.lintRoot, diagnosticPath);
+    return path5.isAbsolute(diagnosticPath) ? diagnosticPath : path5.join(this.lintRoot, diagnosticPath);
   }
   #createLintMessage(diagnostic) {
     const start = diagnostic.location?.start;
@@ -1453,7 +1578,7 @@ ${errorText}, ${warningText} found`];
 
 // pkgs/@akanjs/devkit/repoIdentity.ts
 import { execFileSync } from "child_process";
-import path5 from "path";
+import path6 from "path";
 var resolved = new Map;
 var readRemoteName = (workspaceRoot) => {
   try {
@@ -1471,14 +1596,14 @@ var resolveRepoName = (workspaceRoot) => {
   const cached = resolved.get(workspaceRoot);
   if (cached)
     return cached;
-  const repoName = readRemoteName(workspaceRoot) ?? path5.basename(workspaceRoot);
+  const repoName = readRemoteName(workspaceRoot) ?? path6.basename(workspaceRoot);
   resolved.set(workspaceRoot, repoName);
   return repoName;
 };
 
 // pkgs/@akanjs/devkit/scanInfo.ts
-import { rm } from "fs/promises";
-import path6 from "path";
+import { rm as rm2 } from "fs/promises";
+import path7 from "path";
 
 // pkgs/@akanjs/devkit/workspaceLayout.ts
 var appRootAllowedFiles = new Set([
@@ -1582,16 +1707,16 @@ var moduleUiFileTypes = {
   scalar: new Set(["Template", "Unit"])
 };
 var testFilePattern = /\.(test|spec)\.(ts|tsx)$/;
-var createDependencyScanner = async (exec) => (await import("./dependencyScanner-c64m6fxp.js")).TypeScriptDependencyScanner.from(exec);
+var createDependencyScanner = async (exec) => (await import("./dependencyScanner-shs82ynp.js")).TypeScriptDependencyScanner.from(exec);
 var isAllowedTestFile = (filename) => testFilePattern.test(filename);
-var getScanPath = (exec, relativePath) => path6.posix.join(`${exec.type}s`, exec.name, relativePath.split(path6.sep).join("/"));
+var getScanPath = (exec, relativePath) => path7.posix.join(`${exec.type}s`, exec.name, relativePath.split(path7.sep).join("/"));
 async function clearGeneratedRootCapacitorConfigs(exec) {
   if (exec.type !== "app")
     return;
-  await Promise.all(generatedRootCapacitorConfigFiles.map((filename) => rm(exec.getPath(filename), { force: true })));
+  await Promise.all(generatedRootCapacitorConfigFiles.map((filename) => rm2(exec.getPath(filename), { force: true })));
 }
 var getModuleNameFromPath = (kind, modulePath) => {
-  const dirname = path6.basename(modulePath);
+  const dirname = path7.basename(modulePath);
   return kind === "service" ? dirname.replace(/^_+/, "") : dirname;
 };
 async function assertScanConvention(exec, libRoot) {
@@ -1613,18 +1738,18 @@ async function assertScanConvention(exec, libRoot) {
     for (const { relativePath, reason } of await exec.getPageConventionViolations())
       addViolation(relativePath, reason);
   libRoot.files.filter((filename) => !isAllowedLibFacetRootFile(filename)).forEach((filename) => {
-    addViolation(path6.join("lib", filename), "unsupported lib facet root file");
+    addViolation(path7.join("lib", filename), "unsupported lib facet root file");
   });
   libRoot.dirs.filter((dirname) => dirname.startsWith("__") && !internalLibDirs.has(dirname)).forEach((dirname) => {
-    addViolation(path6.join("lib", dirname), "unsupported internal lib folder");
+    addViolation(path7.join("lib", dirname), "unsupported internal lib folder");
   });
   const databaseDirs = libRoot.dirs.filter((dirname) => !dirname.startsWith("_"));
   const serviceDirs = libRoot.dirs.filter((dirname) => dirname.startsWith("_") && !dirname.startsWith("__"));
   const scalarDirs = await exec.readdir("lib/__scalar");
   await Promise.all([
-    ...databaseDirs.map((dirname) => validateModuleFiles(exec, violations, "database", path6.join("lib", dirname))),
-    ...serviceDirs.map((dirname) => validateModuleFiles(exec, violations, "service", path6.join("lib", dirname))),
-    ...scalarDirs.map((dirname) => validateModuleFiles(exec, violations, "scalar", path6.join("lib/__scalar", dirname)))
+    ...databaseDirs.map((dirname) => validateModuleFiles(exec, violations, "database", path7.join("lib", dirname))),
+    ...serviceDirs.map((dirname) => validateModuleFiles(exec, violations, "service", path7.join("lib", dirname))),
+    ...scalarDirs.map((dirname) => validateModuleFiles(exec, violations, "scalar", path7.join("lib/__scalar", dirname)))
   ]);
   if (violations.length > 0) {
     throw new Error(`[scan-convention]
@@ -1636,11 +1761,11 @@ async function validateModuleFiles(exec, violations, kind, modulePath) {
   const { files, dirs } = await exec.getFilesAndDirs(modulePath);
   const moduleName = getModuleNameFromPath(kind, modulePath);
   dirs.forEach((dirname) => {
-    violations.push(`${getScanPath(exec, path6.join(modulePath, dirname))}: unsupported module folder`);
+    violations.push(`${getScanPath(exec, path7.join(modulePath, dirname))}: unsupported module folder`);
   });
   const uiModuleName = moduleName[0].toUpperCase() + moduleName.slice(1);
   files.forEach((filename) => {
-    const filePath = path6.join(modulePath, filename);
+    const filePath = path7.join(modulePath, filename);
     if (filename === "index.ts" || filename === "index.tsx" || isAllowedTestFile(filename))
       return;
     if (filename === `${moduleName}.abstract.md`)
@@ -1720,7 +1845,7 @@ class ScanInfo {
     });
     await Promise.all([
       ...databaseDirs.map(async (name) => {
-        const filenames = await exec.readdir(path6.join("lib", name));
+        const filenames = await exec.readdir(path7.join("lib", name));
         filenames.forEach((filename) => {
           if (filename.endsWith(".constant.ts"))
             files.constant.databases.push(name);
@@ -1748,7 +1873,7 @@ class ScanInfo {
       }),
       ...serviceDirs.map(async (dirname) => {
         const name = dirname.slice(1);
-        const filenames = await exec.readdir(path6.join("lib", dirname));
+        const filenames = await exec.readdir(path7.join("lib", dirname));
         filenames.forEach((filename) => {
           if (filename.endsWith(".dictionary.ts"))
             files.dictionary.services.push(name);
@@ -1771,7 +1896,7 @@ class ScanInfo {
         });
       }),
       ...scalarDirs.map(async (name) => {
-        const filenames = await exec.readdir(path6.join("lib/__scalar", name));
+        const filenames = await exec.readdir(path7.join("lib/__scalar", name));
         filenames.forEach((filename) => {
           if (filename.endsWith(".constant.ts"))
             files.constant.scalars.push(name);
@@ -1797,7 +1922,7 @@ class ScanInfo {
       name: exec.name,
       type: exec.type,
       repoName: exec.workspace.repoName,
-      serveDomain: WorkspaceExecutor.getBaseDevEnv(path6.join(exec.workspace.workspaceRoot, ".env")).serveDomain,
+      serveDomain: WorkspaceExecutor.getBaseDevEnv(path7.join(exec.workspace.workspaceRoot, ".env")).serveDomain,
       files,
       libDeps,
       pkgDeps,
@@ -2194,16 +2319,16 @@ class Executor {
   linter = null;
   constructor(name, cwdPath) {
     this.name = name;
-    this.logger = new Logger(name);
+    this.logger = new Logger2(name);
     this.logs = [];
     this.cwdPath = cwdPath;
   }
   #stdout(data) {
     if (Executor.verbose)
-      Logger.raw(chalk2.dim(data.toString()));
+      Logger2.raw(chalk2.dim(data.toString()));
   }
   #stderr(data) {
-    Logger.raw(chalk2.red(data.toString()));
+    Logger2.raw(chalk2.red(data.toString()));
   }
   exec(command, options = {}) {
     const cwd = options.cwd?.toString() ?? this.cwdPath;
@@ -2345,10 +2470,10 @@ class Executor {
     });
   }
   getPath(filePath) {
-    if (path7.isAbsolute(filePath))
+    if (path8.isAbsolute(filePath))
       return filePath;
     if (filePath.startsWith("."))
-      return path7.join(this.cwdPath, filePath);
+      return path8.join(this.cwdPath, filePath);
     const baseParts = this.cwdPath.split(/[\\/]/).filter(Boolean);
     const targetParts = filePath.split(/[\\/]/).filter(Boolean);
     let overlapLength = 0;
@@ -2362,12 +2487,12 @@ class Executor {
       if (isOverlap)
         overlapLength = i;
     }
-    return path7.join(this.cwdPath, ...targetParts.slice(overlapLength));
+    return path8.join(this.cwdPath, ...targetParts.slice(overlapLength));
   }
   async mkdir(dirPath) {
     const writePath = this.getPath(dirPath);
     if (!await FileSys.dirExists(writePath))
-      await mkdir2(writePath, { recursive: true });
+      await mkdir3(writePath, { recursive: true });
     this.logger.verbose(`Make directory ${writePath}`);
     return this;
   }
@@ -2405,17 +2530,17 @@ class Executor {
     return this;
   }
   async removeDir(dirPath) {
-    const readPath = path7.join(this.getPath(dirPath), ".");
+    const readPath = path8.join(this.getPath(dirPath), ".");
     if (await FileSys.entryExists(readPath))
-      await rm2(readPath, { recursive: true, force: true });
+      await rm3(readPath, { recursive: true, force: true });
     this.logger.verbose(`Remove directory ${readPath}`);
     return this;
   }
   async writeFile(filePath, content, { overwrite = true, silent = false } = {}) {
     const writePath = this.getPath(filePath);
-    const dir = path7.dirname(writePath);
+    const dir = path8.dirname(writePath);
     if (!await FileSys.dirExists(dir))
-      await mkdir2(dir, { recursive: true });
+      await mkdir3(dir, { recursive: true });
     let contentStr = typeof content === "string" ? content : `${JSON.stringify(content, null, 2)}
 `;
     if (await FileSys.fileExists(writePath)) {
@@ -2425,7 +2550,7 @@ class Executor {
         contentStr = currentContent;
       } else {
         await FileSys.writeText(writePath, contentStr);
-        if (Logger.isVerbose())
+        if (Logger2.isVerbose())
           this.logger.rawLog(chalk2.yellow(`File Update: ${filePath}`));
       }
     } else {
@@ -2439,7 +2564,7 @@ class Executor {
     await this.writeFile(filePath, content);
   }
   async getLocalFile(targetPath) {
-    const filePath = path7.isAbsolute(targetPath) ? targetPath : targetPath.replace(this.cwdPath, "");
+    const filePath = path8.isAbsolute(targetPath) ? targetPath : targetPath.replace(this.cwdPath, "");
     const content = await this.readFile(filePath);
     return { filePath, content };
   }
@@ -2456,9 +2581,9 @@ class Executor {
     const dest = this.getPath(destPath);
     if (!await FileSys.exists(src))
       return;
-    const isDirectory = (await stat(src)).isDirectory();
+    const isDirectory = (await stat2(src)).isDirectory();
     if (!await FileSys.exists(dest) && isDirectory)
-      await mkdir2(dest, { recursive: true });
+      await mkdir3(dest, { recursive: true });
     if (dereference)
       await cpEntry(src, dest, { recursive: isDirectory, dereference: true, force: true });
     else
@@ -2536,9 +2661,9 @@ class Executor {
       const result = await getContent.default(scanInfo ?? null, dict, options);
       if (result === null)
         return null;
-      const filename = typeof result === "object" ? result.filename : path7.basename(targetPath).replace(".js", ".ts");
+      const filename = typeof result === "object" ? result.filename : path8.basename(targetPath).replace(".js", ".ts");
       const content = typeof result === "object" ? result.content : result;
-      const dirname = path7.dirname(targetPath);
+      const dirname = path8.dirname(targetPath);
       const convertedTargetPath = Object.entries(dict).reduce((path, [key, value]) => path.replace(new RegExp(`__${key}__`, "g"), value), `${dirname}/${filename}`);
       this.logger.verbose(`Apply template ${templatePath} to ${convertedTargetPath}`);
       return this.writeFile(convertedTargetPath, content, { overwrite });
@@ -2550,12 +2675,12 @@ class Executor {
       return this.writeFile(convertedTargetPath, convertedContent, {
         overwrite
       });
-    } else if (staticTemplateFileExtensions.has(path7.extname(targetPath).toLowerCase())) {
+    } else if (staticTemplateFileExtensions.has(path8.extname(targetPath).toLowerCase())) {
       const convertedTargetPath = Object.entries(dict).reduce((path, [key, value]) => path.replace(new RegExp(`__${key}__`, "g"), value), targetPath);
       const writePath = this.getPath(convertedTargetPath);
-      const dirname = path7.dirname(writePath);
+      const dirname = path8.dirname(writePath);
       if (!await FileSys.dirExists(dirname))
-        await mkdir2(dirname, { recursive: true });
+        await mkdir3(dirname, { recursive: true });
       await copyFile(templatePath, writePath);
       this.logger.verbose(`Apply template ${templatePath} to ${convertedTargetPath}`);
       return { filePath: writePath, content: "" };
@@ -2573,11 +2698,11 @@ class Executor {
     const templateRoot = await this.#resolveTemplateRoot();
     const templatePath = `${templateRoot}${template ? `/${template}` : ""}`;
     const prefixTemplatePath = templatePath;
-    if ((await stat(prefixTemplatePath)).isFile()) {
-      const filename = path7.basename(prefixTemplatePath);
+    if ((await stat2(prefixTemplatePath)).isFile()) {
+      const filename = path8.basename(prefixTemplatePath);
       const fileContent = await this.#applyTemplateFile({
         templatePath: prefixTemplatePath,
-        targetPath: path7.join(basePath, filename),
+        targetPath: path8.join(basePath, filename),
         scanInfo,
         overwrite
       }, dict, options);
@@ -2585,19 +2710,19 @@ class Executor {
     } else {
       const subdirs = await readDirEntries(templatePath);
       const fileContents = (await Promise.all(subdirs.map(async (subdir) => {
-        const subpath = path7.join(templatePath, subdir);
-        if ((await stat(subpath)).isFile()) {
+        const subpath = path8.join(templatePath, subdir);
+        if ((await stat2(subpath)).isFile()) {
           const fileContent = await this.#applyTemplateFile({
             templatePath: subpath,
-            targetPath: path7.join(basePath, subdir),
+            targetPath: path8.join(basePath, subdir),
             scanInfo,
             overwrite
           }, dict, options);
           return fileContent ? [fileContent] : [];
         } else
           return await this._applyTemplate({
-            basePath: path7.join(basePath, subdir),
-            template: path7.join(template, subdir),
+            basePath: path8.join(basePath, subdir),
+            template: path8.join(template, subdir),
             scanInfo,
             dict,
             overwrite,
@@ -2609,8 +2734,8 @@ class Executor {
   }
   async#resolveTemplateRoot() {
     const candidates = [
-      path7.resolve(getDirname2(import.meta.url), "templates"),
-      path7.resolve(getDirname2(import.meta.url), "../cli/templates")
+      path8.resolve(getDirname2(import.meta.url), "templates"),
+      path8.resolve(getDirname2(import.meta.url), "../cli/templates")
     ];
     for (const candidate of candidates) {
       if (await FileSys.dirExists(candidate))
@@ -2682,11 +2807,11 @@ class Executor {
   async#resolveTypecheckWorkerEntry() {
     const dirname = getDirname2(import.meta.url);
     const candidates = [
-      path7.join(process.cwd(), "pkgs/@akanjs/devkit/typecheck/typecheck.proc.ts"),
-      path7.join(process.cwd(), "node_modules/@akanjs/devkit/typecheck/typecheck.proc.ts"),
-      path7.join(dirname, "typecheck/typecheck.proc.ts"),
-      path7.join(dirname, "typecheck.proc.js"),
-      path7.join(dirname, "typecheck.proc.ts")
+      path8.join(process.cwd(), "pkgs/@akanjs/devkit/typecheck/typecheck.proc.ts"),
+      path8.join(process.cwd(), "node_modules/@akanjs/devkit/typecheck/typecheck.proc.ts"),
+      path8.join(dirname, "typecheck/typecheck.proc.ts"),
+      path8.join(dirname, "typecheck.proc.js"),
+      path8.join(dirname, "typecheck.proc.ts")
     ];
     for (const candidate of candidates)
       if (await Bun.file(candidate).exists())
@@ -2813,8 +2938,8 @@ class WorkspaceExecutor extends Executor {
       await Promise.all(dirs.map(async (dir) => {
         if (dir.includes("_") || AVOID_DIRS.includes(dir))
           return;
-        const dirPath = path7.join(dirname, dir);
-        if ((await stat(dirPath)).isDirectory()) {
+        const dirPath = path8.join(dirname, dir);
+        if ((await stat2(dirPath)).isDirectory()) {
           results.push(`${prefix}${dir}`);
           if (maxDepth > 0)
             await getDirs(dirPath, maxDepth - 1, results, `${prefix}${dir}/`);
@@ -2848,9 +2973,9 @@ class WorkspaceExecutor extends Executor {
       await Promise.all(dirs.map(async (dir) => {
         if (AVOID_DIRS.includes(dir))
           return;
-        const dirPath = path7.join(dirname, dir);
+        const dirPath = path8.join(dirname, dir);
         if (await FileSys.dirExists(dirPath)) {
-          const hasTargetFile = await FileSys.fileExists(path7.join(dirPath, targetFilename));
+          const hasTargetFile = await FileSys.fileExists(path8.join(dirPath, targetFilename));
           if (hasTargetFile)
             results.push(`${prefix}${dir}`);
           if (maxDepth > 0)
@@ -2924,7 +3049,7 @@ class SysExecutor extends Executor {
       return [];
     const violations = [];
     for (const entry of await this.getAllFiles("**/*", { cwd: this.getPath("page") })) {
-      const relativePath = entry.split(path7.sep).join("/");
+      const relativePath = entry.split(path8.sep).join("/");
       const reason = getPageSourceFileViolation(relativePath);
       if (reason)
         violations.push({ relativePath: `page/${relativePath}`, reason });
@@ -2987,18 +3112,19 @@ class SysExecutor extends Executor {
     }) : await LibInfo.fromExecutor(this, {
       refresh
     });
-    if (write) {
-      await Promise.all(this.#getScanTemplateTasks(scanInfo));
-      await this.writeJson(`akan.${this.type}.json`, scanInfo.getScanResult());
-      if (this.type === "lib")
-        this.#updateDependencies(scanInfo);
-      if (writeLib) {
-        const libInfos = [...scanInfo.getLibInfos().values()];
-        await this.#updateDependencies(scanInfo);
-        await Promise.all(libInfos.flatMap((libInfo) => libInfo.exec.#getScanTemplateTasks(libInfo)));
-      }
-      await this.syncAgentsIndex(scanInfo);
-    }
+    if (write)
+      await CodegenLock.run(this.workspace.workspaceRoot, `scan:${this.name}`, async () => {
+        await Promise.all(this.#getScanTemplateTasks(scanInfo));
+        await this.writeJson(`akan.${this.type}.json`, scanInfo.getScanResult());
+        if (this.type === "lib")
+          this.#updateDependencies(scanInfo);
+        if (writeLib) {
+          const libInfos = [...scanInfo.getLibInfos().values()];
+          await this.#updateDependencies(scanInfo);
+          await Promise.all(libInfos.flatMap((libInfo) => libInfo.exec.#getScanTemplateTasks(libInfo)));
+        }
+        await this.syncAgentsIndex(scanInfo);
+      });
     this.#scanInfo = scanInfo;
     return scanInfo;
   }
@@ -3033,7 +3159,7 @@ class SysExecutor extends Executor {
     await this.setPackageJson(libPkgJsonWithDeps);
   }
   async getLocalFile(targetPath) {
-    const filePath = path7.isAbsolute(targetPath) ? targetPath : `${this.type}s/${this.name}/${targetPath}`;
+    const filePath = path8.isAbsolute(targetPath) ? targetPath : `${this.type}s/${this.name}/${targetPath}`;
     const content = await this.workspace.readFile(filePath);
     return { filePath, content };
   }
@@ -3172,6 +3298,8 @@ class AppExecutor extends SysExecutor {
     const databaseMode = process.env.AKAN_DATABASE_MODE ?? akanConfig.defaultDatabaseMode ?? "single";
     const routeEnv = {
       AKAN_PUBLIC_BASE_PATHS: [...akanConfig.basePaths].join(","),
+      AKAN_PUBLIC_API_PREFIX: akanConfig.api.prefix,
+      AKAN_PUBLIC_WS_PREFIX: akanConfig.api.websocketPrefix,
       AKAN_DATABASE_MODE: databaseMode
     };
     Object.assign(process.env, routeEnv);
@@ -3252,11 +3380,11 @@ class AppExecutor extends SysExecutor {
         absolute: false,
         onlyFiles: true
       })) {
-        const segments = rel.split(path7.sep);
+        const segments = rel.split(path8.sep);
         if (segments.some((s) => s === "node_modules"))
           continue;
         const posix = `${root.keyPrefix}${segments.join("/")}`;
-        const absPath = path7.join(root.dir, ...segments);
+        const absPath = path8.join(root.dir, ...segments);
         validatePageSourceFile(posix, { filePath: absPath });
         if (!isRouteSourceFile(posix))
           continue;
@@ -3395,12 +3523,12 @@ class AppExecutor extends SysExecutor {
   static async#linkLibAsset(targetPath, linkPath) {
     const isWindows = process.platform === "win32";
     try {
-      const target = isWindows ? targetPath : path7.relative(path7.dirname(linkPath), targetPath);
+      const target = isWindows ? targetPath : path8.relative(path8.dirname(linkPath), targetPath);
       await symlink(target, linkPath, isWindows ? "junction" : "dir");
     } catch (error) {
       if (!isWindows)
         throw error;
-      await mkdir2(linkPath, { recursive: true });
+      await mkdir3(linkPath, { recursive: true });
       await cpEntry(targetPath, linkPath, { recursive: true, dereference: true, force: true });
     }
   }
@@ -3437,7 +3565,7 @@ class AppExecutor extends SysExecutor {
         await this.writeFile(rel, content, opts);
       },
       readEnvClient: async () => {
-        const envClientPath = path7.join(this.cwdPath, "env", "env.client.ts");
+        const envClientPath = path8.join(this.cwdPath, "env", "env.client.ts");
         if (!await FileSys.fileExists(envClientPath))
           return null;
         try {
@@ -3547,7 +3675,7 @@ class PkgExecutor extends Executor {
       return rootVersion;
     try {
       const packageJsonPath = `pkgs/${dep}/package.json`;
-      if (!await Bun.file(path7.join(this.workspace.workspaceRoot, packageJsonPath)).exists())
+      if (!await Bun.file(path8.join(this.workspace.workspaceRoot, packageJsonPath)).exists())
         return;
       const packageJson = await this.workspace.readJson(packageJsonPath);
       if (packageJson.name === dep)
@@ -3648,4 +3776,4 @@ class ModuleExecutor extends Executor {
   }
 }
 
-export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, CLAUDE_COMMENT_RULE, AsyncDefaultExportDetector, resolveSsrPageEntriesForApp, rootAllowedFiles, rootAllowedDirs, isAllowedLibFacetRootFile, isScannedRootEntry, AppInfo, Spinner, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };
+export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, CLAUDE_COMMENT_RULE, AsyncDefaultExportDetector, resolveSsrPageEntriesForApp, CodegenLock, rootAllowedFiles, rootAllowedDirs, isAllowedLibFacetRootFile, isScannedRootEntry, AppInfo, Spinner, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };