@akanjs/cli 3.0.0-alpha.7 → 3.0.0-alpha.70

package/{index-vg0sj9nc.js → index-nkwmnqwn.js}

@@ -1,13 +1,20 @@
 // @bun
+import {
+  getRootBoundarySegments,
+  isRootBoundarySegments
+} from "./index-f39512t6.js";
 import {
   Spinner
 } from "./index-mxvakhsm.js";
+import {
+  getDirname
+} from "./index-1577bej2.js";
 import {
   FileSys
 } from "./index-67546d0j.js";
 import {
   __require
-} from "./index-r24hmh0q.js";
+} from "./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/executors.ts
 import {
@@ -30,6 +37,7 @@ import path5 from "path";
 import { pathToFileURL } from "url";
 import {
   capitalize,
+  getPageSourceFileViolation,
   isRouteSourceFile,
   Logger,
   parseRouteModuleKey,
@@ -41,9 +49,24 @@ import chalk2 from "chalk";
 
 // pkgs/@akanjs/devkit/agentsIndex.ts
 var recipeScannerLoad = null;
-var loadRecipeScanner = () => recipeScannerLoad ??= import("./recipeScanner-tghkzrrt.js");
+var loadRecipeScanner = () => recipeScannerLoad ??= import("./recipeScanner-zrzev25x.js");
 var AGENT_BLOCK_START = "<!-- akan:agent:start -->";
 var AGENT_BLOCK_END = "<!-- akan:agent:end -->";
+var AGENT_VERSION_PREFIX = "<!-- akan:agent:version ";
+var stampBlockVersion = (block, version) => `${AGENT_VERSION_PREFIX}${version} -->
+
+${block}`;
+var extractBlockVersion = (content) => content.match(/<!-- akan:agent:version ([^\s]+) -->/)?.[1] ?? null;
+var readDevkitVersion = async () => {
+  const { readFile } = await import("fs/promises");
+  const { getDirname: getDirname2 } = await import("./getDirname-ka11hm7e.js");
+  try {
+    const raw = await readFile(`${getDirname2(import.meta.url)}/package.json`, "utf-8");
+    return JSON.parse(raw).version ?? null;
+  } catch {
+    return null;
+  }
+};
 var upsertAgentBlock = (existing, block) => {
   const managed = `${AGENT_BLOCK_START}
 ${block}
@@ -137,9 +160,29 @@ ${AGENT_BLOCK_START}
 ${block}
 ${AGENT_BLOCK_END}
 `;
+var CLAUDE_COMMENT_RULE = `## Comments \u2014 Overrides Your Default
+
+Write **no comments** unless the comment passes the test below. This is the rule agents break most often here, so it
+is repeated outside the guide: a diff that adds a comment the test rejects is a diff to redo.
+
+Before typing \`//\`, \`/*\`, or a doc block, ask \u2014 **does this sentence carry a fact that is nowhere in the code?**
+
+- Restates the identifier, the signature, or the line under it \u2192 delete it.
+- Labels a section (\`// helpers\`, \`// state\`) or narrates a step (\`// fetch the user\`, \`// then save\`) \u2192 delete it.
+- JSDoc on an ordinary function, or a why/how preamble on ordinary logic \u2192 delete it.
+- Explains the edit you just made, for whoever reads the diff \u2192 say it in your reply, not in the file.
+- Names a vendor or protocol quirk, an infrastructure constraint, a library gotcha, security reasoning, a math
+  derivation, a domain field's business meaning, a state transition, or why an obvious alternative was rejected \u2192
+  keep it, one line.
+
+That keep-list is exact \u2014 \`Comments\` in the guide is the full version. "It aids readability" and "this logic is
+subtle" are not on it: rename or split the code instead. When you edit an existing file, match its density; if the
+surrounding code carries none, your diff carries none.`;
 var renderScopeClaudeMd = (scope) => `# ${scope.name} \u2014 Claude Code Guide
 
 @AGENTS.md
+
+${CLAUDE_COMMENT_RULE}
 `;
 
 // pkgs/@akanjs/devkit/akanConfig/akanConfig.ts
@@ -181,9 +224,8 @@ var DEFAULT_OPTIMIZE_IMPORTS = [
   "react-icons/*"
 ];
 var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
+var DEFAULT_DOCKER_IMAGE = "oven/bun:1-slim";
 var SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"];
-var NATIVE_RUNTIME_PACKAGES = ["sharp"];
-var DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"];
 var MOBILE_RUNTIME_PACKAGES = [
   "@capacitor/cli",
   "@capacitor/core",
@@ -212,8 +254,6 @@ var DATABASE_MODE_RUNTIME_PACKAGES = {
 };
 var AKAN_RUNTIME_PACKAGES = new Set([
   ...SSR_RUNTIME_PACKAGES,
-  ...NATIVE_RUNTIME_PACKAGES,
-  ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
   ...MOBILE_RUNTIME_PACKAGES,
   ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat()
 ]);
@@ -228,7 +268,8 @@ var DEFAULT_AKAN_IMAGE_CONFIG = {
   dangerouslyAllowSVG: false,
   maximumRedirects: 3,
   fetchTimeoutMs: 7000,
-  maxRemoteBytes: 25 * 1024 * 1024
+  maxRemoteBytes: 25 * 1024 * 1024,
+  maxConcurrency: 0
 };
 var normalizeIndexPath = (indexPath) => {
   const normalized = indexPath?.trim();
@@ -275,12 +316,28 @@ var normalizeDeepLinks = (deepLinks) => {
     ...sha256CertFingerprints ? { android: { sha256CertFingerprints } } : {}
   };
 };
+var emptyLibContributions = () => ({
+  externalLibs: [],
+  docker: { preRuns: [], postRuns: [] },
+  keepFonts: []
+});
+var normalizeKeepFonts = (keepFonts) => [
+  ...new Set((keepFonts ?? []).map((glob) => glob.trim().replace(/^\/+/, "")).filter(Boolean))
+];
+var dedupeDockerRuns = (runs) => {
+  const byKey = new Map;
+  for (const run of runs)
+    byKey.set(typeof run === "string" ? run : JSON.stringify(run), run);
+  return [...byKey.values()];
+};
 
 class AkanAppConfig {
   app;
   rootPackageJson;
   docker;
+  dockerfile;
   defaultDatabaseMode;
+  web;
   externalLibs;
   barrelImports;
   optimizeImports;
@@ -290,6 +347,7 @@ class AkanAppConfig {
   mobile;
   hasMobileConfig;
   secrets;
+  assets;
   syncPageLibs;
   baseDevEnv;
   libs;
@@ -298,7 +356,7 @@ class AkanAppConfig {
   subRoutes = new Map;
   basePaths = new Set;
   branches = new Set(["debug", "develop", "main"]);
-  constructor(app, libs, rootPackageJson, config, baseDevEnv, plugins = []) {
+  constructor(app, libs, rootPackageJson, config, baseDevEnv, plugins = [], libContributions = emptyLibContributions()) {
     this.app = app;
     this.rootPackageJson = rootPackageJson;
     this.libs = libs;
@@ -306,7 +364,7 @@ class AkanAppConfig {
     this.plugins = plugins;
     this.#applyRoutes(config?.routes);
     this.defaultDatabaseMode = config?.defaultDatabaseMode ?? "single";
-    this.externalLibs = config?.externalLibs ?? [];
+    this.externalLibs = [...new Set([...config?.externalLibs ?? [], ...libContributions.externalLibs])];
     this.barrelImports = [
       ...DEFAULT_BARREL_IMPORTS,
       ...WORKSPACE_BARREL_FACETS.map((facet) => `@apps/${app.name}/${facet}`),
@@ -320,10 +378,25 @@ class AkanAppConfig {
     process.env.AKAN_PUBLIC_LOCALES = this.i18n.locales.join(",");
     this.publicEnv = config?.publicEnv ?? [];
     this.secrets = config?.secrets ?? [];
+    this.assets = {
+      pruneFonts: config?.assets?.pruneFonts ?? true,
+      keepFonts: [
+        ...normalizeKeepFonts(config?.assets?.keepFonts),
+        ...libContributions.keepFonts ?? []
+      ]
+    };
     this.syncPageLibs = config?.syncPageLibs ?? false;
     this.hasMobileConfig = Boolean(config.mobile);
     this.mobile = this.#resolveMobileConfig(config.mobile);
-    this.docker = this.#makeDockerContent(config?.docker ?? {});
+    this.web = this.#resolveWebConfig(config.web);
+    this.docker = AkanAppConfig.#resolveDocker(config.docker, libContributions.docker);
+    this.dockerfile = this.#makeDockerfile();
+  }
+  #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 {
@@ -433,23 +506,31 @@ class AkanAppConfig {
       return archs.map((arch) => `FROM ${image[arch] ?? defaultImage} AS ${arch}`).join(`
 `);
   }
-  #makeDockerContent(docker) {
-    if (docker.content)
-      return {
-        content: docker.content,
-        image: {},
-        preRuns: [],
-        postRuns: [],
-        command: []
-      };
-    const preRunScripts = this.#getDockerRunScripts(docker.preRuns ?? []);
-    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 content = `${imageScript}
+  static #resolveDocker(docker, libDocker) {
+    if (typeof docker === "string")
+      return docker;
+    return {
+      image: docker?.image ?? DEFAULT_DOCKER_IMAGE,
+      preRuns: dedupeDockerRuns([...libDocker.preRuns, ...docker?.preRuns ?? []]),
+      postRuns: dedupeDockerRuns([...libDocker.postRuns, ...docker?.postRuns ?? []]),
+      command: docker?.command ?? ["bun", "main.js"]
+    };
+  }
+  #makeDockerfile() {
+    if (typeof this.docker === "string")
+      return this.docker;
+    const { image, preRuns, postRuns, command } = this.docker;
+    const preRunScripts = this.#getDockerRunScripts(preRuns);
+    const postRunScripts = this.#getDockerRunScripts(postRuns);
+    const imageScript = this.#getDockerImageScript(image, DEFAULT_DOCKER_IMAGE);
+    const webEnvLines = [
+      ...this.web.ssr ? [] : ["ENV AKAN_SSR=false"],
+      ...this.web.csr ? [] : ["ENV AKAN_CSR=false"]
+    ].join(`
+`);
+    return `${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(`
 `)}
@@ -470,15 +551,8 @@ ${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,
-      image: imageScript,
-      preRuns: docker.preRuns ?? [],
-      postRuns: docker.postRuns ?? [],
-      command
-    };
   }
   static #importGeneration = 0;
   static async importConfigModule(cwdPath, { bustImportCache = false } = {}) {
@@ -495,7 +569,22 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     ]);
     const resolved = typeof configImp === "function" ? configImp(app) : configImp;
     const { plugins, ...config } = resolved ?? {};
-    return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv, plugins ?? []);
+    const libContributions = await AkanAppConfig.#collectLibContributions(app, libs, bustImportCache);
+    return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv, plugins ?? [], libContributions);
+  }
+  static async#collectLibContributions(app, libs, bustImportCache) {
+    const libConfigs = await Promise.all(libs.map(async (libName) => LibExecutor.from(app, libName).getConfig({ refresh: bustImportCache }).catch((error) => {
+      app.logger.warn(`Skipped libs/${libName}/akan.config.ts contributions: ${String(error)}`);
+      return null;
+    })));
+    return {
+      externalLibs: libConfigs.flatMap((libConfig) => libConfig?.externalLibs ?? []),
+      docker: {
+        preRuns: libConfigs.flatMap((libConfig) => libConfig?.docker.preRuns ?? []),
+        postRuns: libConfigs.flatMap((libConfig) => libConfig?.docker.postRuns ?? [])
+      },
+      keepFonts: libConfigs.flatMap((libConfig) => (libConfig?.assets.keepFonts ?? []).map((glob) => `libs/${libConfig?.lib.name}/${glob}`))
+    };
   }
   #resolveProductionDependencyVersion(lib) {
     const rootVersion = this.rootPackageJson.dependencies?.[lib] ?? this.rootPackageJson.devDependencies?.[lib];
@@ -505,13 +594,7 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
   }
   #getProductionRuntimePackages() {
-    return [
-      ...this.externalLibs,
-      ...SSR_RUNTIME_PACKAGES,
-      ...NATIVE_RUNTIME_PACKAGES,
-      ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
-      ...this.getDatabaseModeRuntimePackages()
-    ];
+    return [...this.externalLibs, ...SSR_RUNTIME_PACKAGES, ...this.getDatabaseModeRuntimePackages()];
   }
   getDatabaseModeRuntimePackages(databaseMode = this.defaultDatabaseMode) {
     return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
@@ -599,14 +682,18 @@ function mergeImageConfig(config = {}) {
 class AkanLibConfig {
   lib;
   externalLibs;
+  docker;
+  assets;
   plugins;
   constructor(lib, config, plugins = []) {
     this.lib = lib;
     this.externalLibs = config?.externalLibs ?? [];
+    this.docker = { preRuns: config?.docker?.preRuns ?? [], postRuns: config?.docker?.postRuns ?? [] };
+    this.assets = { keepFonts: normalizeKeepFonts(config?.assets?.keepFonts) };
     this.plugins = plugins;
   }
-  static async from(lib) {
-    const [configImp] = await Promise.all([import(`${lib.cwdPath}/akan.config.ts`).then((mod) => mod.default)]);
+  static async from(lib, { bustImportCache = false } = {}) {
+    const configImp = await AkanAppConfig.importConfigModule(lib.cwdPath, { bustImportCache });
     const resolved = typeof configImp === "function" ? configImp(lib) : configImp;
     const { plugins, ...config } = resolved ?? {};
     return new AkanLibConfig(lib, config, plugins ?? []);
@@ -627,42 +714,47 @@ var decreaseBuildNum = async (app) => {
   const akanConfigContent = akanConfig.replace(`buildNum: ${appConfig.mobile.buildNum}`, `buildNum: ${appConfig.mobile.buildNum - 1}`);
   fs.writeFileSync(akanConfigPath, akanConfigContent);
 };
-// pkgs/@akanjs/devkit/getDirname.ts
-import path2 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var getDirname = (url) => path2.dirname(fileURLToPath2(url));
-
 // pkgs/@akanjs/devkit/linter.ts
 import { spawn } from "child_process";
 import { existsSync, readFileSync } from "fs";
-import path3 from "path";
+import path2 from "path";
 import chalk from "chalk";
+var BIOME_CONFIG_FILES = ["biome.json", "biome.jsonc"];
 
 class Linter {
   lintRoot;
+  configPath;
   #biomeBin;
   constructor(cwdPath) {
     this.lintRoot = this.#findBiomeRootPath(cwdPath);
-    const localBiomeBin = path3.join(this.lintRoot, "node_modules/.bin/biome");
+    this.configPath = Linter.#configPathIn(this.lintRoot) ?? path2.join(this.lintRoot, "biome.json");
+    const localBiomeBin = path2.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 = path2.join(dir, fileName);
+      if (existsSync(configPath))
+        return configPath;
+    }
+    return null;
+  }
   #findBiomeRootPath(dir) {
-    const configPath = path3.join(dir, "biome.json");
-    if (existsSync(configPath))
+    if (Linter.#configPathIn(dir))
       return dir;
-    const parentDir = path3.dirname(dir);
+    const parentDir = path2.dirname(dir);
     if (parentDir === dir)
       throw new Error(`biome.json not found from ${dir}`);
     return this.#findBiomeRootPath(parentDir);
   }
   #toBiomePath(filePath) {
-    const relativePath = path3.relative(this.lintRoot, filePath);
-    if (!relativePath.startsWith("..") && !path3.isAbsolute(relativePath))
+    const relativePath = path2.relative(this.lintRoot, filePath);
+    if (!relativePath.startsWith("..") && !path2.isAbsolute(relativePath))
       return relativePath;
     return filePath;
   }
   #resolveFilePath(filePath) {
-    return path3.isAbsolute(filePath) ? filePath : path3.join(this.lintRoot, filePath);
+    return path2.isAbsolute(filePath) ? filePath : path2.join(this.lintRoot, filePath);
   }
   async#runBiome(args, input) {
     return await new Promise((resolve, reject) => {
@@ -694,7 +786,7 @@ class Linter {
     const diagnosticPath = diagnostic.location?.path;
     if (!diagnosticPath)
       return fallbackFilePath;
-    return path3.isAbsolute(diagnosticPath) ? diagnosticPath : path3.join(this.lintRoot, diagnosticPath);
+    return path2.isAbsolute(diagnosticPath) ? diagnosticPath : path2.join(this.lintRoot, diagnosticPath);
   }
   #createLintMessage(diagnostic) {
     const start = diagnostic.location?.start;
@@ -759,7 +851,7 @@ class Linter {
       "--max-diagnostics=none",
       "--no-errors-on-unmatched",
       "--config-path",
-      path3.join(this.lintRoot, "biome.json"),
+      this.configPath,
       this.#toBiomePath(filePath)
     ]);
     const report = this.#parseBiomeReport(stdout || stderr);
@@ -880,14 +972,7 @@ ${errorText}, ${warningText} found`];
     if (!dryRun)
       return await this.#checkFile(resolvedFilePath, { write: true });
     const source = readFileSync(resolvedFilePath, "utf8");
-    const { stdout } = await this.#runBiome([
-      "check",
-      "--write",
-      "--config-path",
-      path3.join(this.lintRoot, "biome.json"),
-      "--stdin-file-path",
-      this.#toBiomePath(resolvedFilePath)
-    ], source);
+    const { stdout } = await this.#runBiome(["check", "--write", "--config-path", this.configPath, "--stdin-file-path", this.#toBiomePath(resolvedFilePath)], source);
     const lintResult = await this.lintFile(resolvedFilePath);
     return { ...lintResult, fixed: stdout !== source, output: stdout };
   }
@@ -895,7 +980,7 @@ ${errorText}, ${warningText} found`];
     const resolvedFilePath = this.#resolveFilePath(filePath);
     if (!existsSync(resolvedFilePath))
       throw new Error(`File not found: ${filePath}`);
-    return JSON.parse(readFileSync(path3.join(this.lintRoot, "biome.json"), "utf8"));
+    return JSON.parse(readFileSync(this.configPath, "utf8"));
   }
   async getProblematicRules(filePath) {
     const { results } = await this.lintFile(filePath);
@@ -910,6 +995,31 @@ ${errorText}, ${warningText} found`];
   }
 }
 
+// pkgs/@akanjs/devkit/repoIdentity.ts
+import { execFileSync } from "child_process";
+import path3 from "path";
+var resolved = new Map;
+var readRemoteName = (workspaceRoot) => {
+  try {
+    const url = execFileSync("git", ["config", "--get", "remote.origin.url"], {
+      cwd: workspaceRoot,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return url.replace(/\.git$/, "").split(/[/:]/).pop() || null;
+  } catch {
+    return null;
+  }
+};
+var resolveRepoName = (workspaceRoot) => {
+  const cached = resolved.get(workspaceRoot);
+  if (cached)
+    return cached;
+  const repoName = readRemoteName(workspaceRoot) ?? path3.basename(workspaceRoot);
+  resolved.set(workspaceRoot, repoName);
+  return repoName;
+};
+
 // pkgs/@akanjs/devkit/scanInfo.ts
 import { rm } from "fs/promises";
 import path4 from "path";
@@ -946,6 +1056,34 @@ var appRootAllowedDirs = new Set([
   "ui",
   "webkit"
 ]);
+var libRootAllowedFiles = new Set([
+  "AGENTS.md",
+  "CLAUDE.md",
+  "README.md",
+  "akan.config.ts",
+  "akan.lib.json",
+  "client.ts",
+  "index.ts",
+  "package.json",
+  "server.ts",
+  "tsconfig.json",
+  "tsconfig.spec.json",
+  "tsconfig.tsbuildinfo"
+]);
+var libRootAllowedDirs = new Set([
+  "common",
+  "env",
+  "lib",
+  "page",
+  "plugin",
+  "private",
+  "public",
+  "srvkit",
+  "ui",
+  "webkit"
+]);
+var rootAllowedFiles = { app: appRootAllowedFiles, lib: libRootAllowedFiles };
+var rootAllowedDirs = { app: appRootAllowedDirs, lib: libRootAllowedDirs };
 var libFacetRootAllowedFiles = new Set([
   "cnst.ts",
   "db.ts",
@@ -957,7 +1095,9 @@ var libFacetRootAllowedFiles = new Set([
   "useClient.ts",
   "useServer.ts"
 ]);
-var isScannedAppRootEntry = (name) => !name.startsWith(".") || appRootAllowedDirs.has(name);
+var libFacetRootTestPattern = /^[A-Za-z][A-Za-z0-9_-]*\.signal\.(test|spec)\.(ts|tsx)$/;
+var isAllowedLibFacetRootFile = (filename) => libFacetRootAllowedFiles.has(filename) || libFacetRootTestPattern.test(filename);
+var isScannedRootEntry = (type, name) => !name.startsWith(".") || rootAllowedDirs[type].has(name);
 
 // pkgs/@akanjs/devkit/scanInfo.ts
 var databaseFileTypes = [
@@ -986,10 +1126,8 @@ var moduleUiFileTypes = {
   scalar: new Set(["Template", "Unit"])
 };
 var testFilePattern = /\.(test|spec)\.(ts|tsx)$/;
-var rootSignalTestFilePattern = /^[A-Za-z][A-Za-z0-9_-]*\.signal\.(test|spec)\.(ts|tsx)$/;
-var createDependencyScanner = async (exec) => (await import("./dependencyScanner-f6grrep3.js")).TypeScriptDependencyScanner.from(exec);
+var createDependencyScanner = async (exec) => (await import("./dependencyScanner-rbs2407b.js")).TypeScriptDependencyScanner.from(exec);
 var isAllowedTestFile = (filename) => testFilePattern.test(filename);
-var isAllowedLibRootFile = (filename) => libFacetRootAllowedFiles.has(filename) || rootSignalTestFilePattern.test(filename);
 var getScanPath = (exec, relativePath) => path4.posix.join(`${exec.type}s`, exec.name, relativePath.split(path4.sep).join("/"));
 async function clearGeneratedRootCapacitorConfigs(exec) {
   if (exec.type !== "app")
@@ -1006,17 +1144,20 @@ async function assertScanConvention(exec, libRoot) {
   const addViolation = (relativePath, reason) => {
     violations.push(`${getScanPath(exec, relativePath)}: ${reason}`);
   };
-  if (exec.type === "app") {
-    const { files, dirs } = await exec.getFilesAndDirs(".");
-    files.filter((filename) => !appRootAllowedFiles.has(filename)).forEach((filename) => {
-      addViolation(filename, "unsupported app root file");
-    });
-    dirs.filter((dirname) => !appRootAllowedDirs.has(dirname)).forEach((dirname) => {
-      addViolation(dirname, "unsupported app root folder");
-    });
-  }
-  libRoot.files.filter((filename) => !isAllowedLibRootFile(filename)).forEach((filename) => {
-    addViolation(path4.join("lib", filename), "unsupported lib root file");
+  const allowedRootFiles = rootAllowedFiles[exec.type];
+  const allowedRootDirs = rootAllowedDirs[exec.type];
+  const { files, dirs } = await exec.getFilesAndDirs(".");
+  files.filter((filename) => !allowedRootFiles.has(filename)).forEach((filename) => {
+    addViolation(filename, `unsupported ${exec.type} root file`);
+  });
+  dirs.filter((dirname) => !allowedRootDirs.has(dirname)).forEach((dirname) => {
+    addViolation(dirname, `unsupported ${exec.type} root folder`);
+  });
+  if (exec.type === "lib")
+    for (const { relativePath, reason } of await exec.getPageConventionViolations())
+      addViolation(relativePath, reason);
+  libRoot.files.filter((filename) => !isAllowedLibFacetRootFile(filename)).forEach((filename) => {
+    addViolation(path4.join("lib", filename), "unsupported lib facet root file");
   });
   libRoot.dirs.filter((dirname) => dirname.startsWith("__") && !internalLibDirs.has(dirname)).forEach((dirname) => {
     addViolation(path4.join("lib", dirname), "unsupported internal lib folder");
@@ -1196,12 +1337,11 @@ class ScanInfo {
       })
     ]);
     const routes = exec.type === "lib" ? [] : await exec.getPageKeys();
-    const scanResult = {
+    const common = {
       name: exec.name,
       type: exec.type,
       repoName: exec.workspace.repoName,
       serveDomain: WorkspaceExecutor.getBaseDevEnv(path4.join(exec.workspace.workspaceRoot, ".env")).serveDomain,
-      akanConfig: akanConfig2,
       files,
       libDeps,
       pkgDeps,
@@ -1209,6 +1349,7 @@ class ScanInfo {
       devDependencies: npmDevDeps.filter((dep) => !isAkanFrameworkDependency(dep)),
       routes
     };
+    const scanResult = akanConfig2 instanceof AkanAppConfig ? { ...common, akanConfig: akanConfig2 } : { ...common, akanConfig: akanConfig2 };
     return scanResult;
   }
   constructor(scanResult) {
@@ -1634,7 +1775,7 @@ class Executor {
         }));
       });
       proc.on("exit", (code, signal) => {
-        if (!!code || signal)
+        if (code || signal)
           reject(new CommandExecutionError({
             command,
             cwd,
@@ -1732,7 +1873,7 @@ class Executor {
         }));
       });
       proc.on("exit", (code, signal) => {
-        if (!!code || signal)
+        if (code || signal)
           reject(new CommandExecutionError({
             command: modulePath,
             args,
@@ -1819,7 +1960,8 @@ class Executor {
     const dir = path5.dirname(writePath);
     if (!await FileSys.dirExists(dir))
       await mkdir(dir, { recursive: true });
-    let contentStr = typeof content === "string" ? content : JSON.stringify(content, null, 2);
+    let contentStr = typeof content === "string" ? content : `${JSON.stringify(content, null, 2)}
+`;
     if (await FileSys.fileExists(writePath)) {
       const currentContent = await FileSys.readText(writePath);
       if (currentContent === contentStr || !overwrite) {
@@ -2028,7 +2170,7 @@ class Executor {
     return this._applyTemplate({ ...options, dict });
   }
   async getTypeChecker() {
-    const { TypeChecker } = await import("./typeChecker-kravn7ns.js");
+    const { TypeChecker } = await import("./typeChecker-g6bh0xfv.js");
     this.typeChecker ??= new TypeChecker(this);
     return this.typeChecker;
   }
@@ -2109,7 +2251,7 @@ class WorkspaceExecutor extends Executor {
   static #execs = new Map;
   static fromRoot({
     workspaceRoot = process.cwd(),
-    repoName = path5.basename(process.cwd())
+    repoName = resolveRepoName(workspaceRoot)
   } = {}) {
     return WorkspaceExecutor.#execs.get(repoName) ?? new WorkspaceExecutor({ workspaceRoot, repoName });
   }
@@ -2297,6 +2439,18 @@ class SysExecutor extends Executor {
     const path6 = this.type === "app" ? `apps/${this.name}/lib` : `libs/${this.name}/lib`;
     return await this.workspace.getDirInModule(path6, this.name);
   }
+  async getPageConventionViolations() {
+    if (!await this.exists("page"))
+      return [];
+    const violations = [];
+    for (const entry of await this.getAllFiles("**/*", { cwd: this.getPath("page") })) {
+      const relativePath = entry.split(path5.sep).join("/");
+      const reason = getPageSourceFileViolation(relativePath);
+      if (reason)
+        violations.push({ relativePath: `page/${relativePath}`, reason });
+    }
+    return violations;
+  }
   #scanInfo = null;
   hasScanInfo() {
     return this.#scanInfo !== null;
@@ -2485,7 +2639,7 @@ class SysExecutor extends Executor {
 class AppExecutor extends SysExecutor {
   static #routeSourceValidator = null;
   static async#getRouteSourceValidator() {
-    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-e4jmbfcx.js")).RouteSourceValidator;
+    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-7fycdqyv.js")).RouteSourceValidator;
     return AppExecutor.#routeSourceValidator;
   }
   dist;
@@ -2549,10 +2703,15 @@ 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.verbose(`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;
     const env = this.getCommandEnv({
       AKAN_COMMAND_TYPE: type,
@@ -2641,7 +2800,8 @@ class AppExecutor extends SysExecutor {
         }
         if (!owner)
           owners.set(routeId, { absPath, fromLib });
-        const isRootLayout = parsed.kind === "layout" && parsed.moduleSegments.at(-1) === "_layout";
+        const layoutSegments = getRootBoundarySegments(key);
+        const isRootLayout = layoutSegments !== null && isRootBoundarySegments(layoutSegments, akanConfig2.basePaths);
         const routeSource = await Bun.file(absPath).text();
         const validator = await AppExecutor.#getRouteSourceValidator();
         if (parsed.kind === "overrides")
@@ -2869,7 +3029,7 @@ class LibExecutor extends SysExecutor {
   async getConfig({ refresh } = {}) {
     if (this.#akanConfig && !refresh)
       return this.#akanConfig;
-    this.#akanConfig = await AkanLibConfig.from(this);
+    this.#akanConfig = await AkanLibConfig.from(this, { bustImportCache: refresh });
     return this.#akanConfig;
   }
 }
@@ -2966,7 +3126,7 @@ class PkgExecutor extends Executor {
           default: "./index.ts"
         }
       },
-      engines: { bun: ">=1.3.13" },
+      engines: { bun: ">=1.4.0" },
       ...dependencyMaps
     };
     await Promise.all([this.dist.writeJson("package.json", distPkgJson), this.writeJson("package.json", distPkgJson)]);
@@ -3009,4 +3169,4 @@ class ModuleExecutor extends Executor {
   }
 }
 
-export { AGENT_BLOCK_START, AGENT_BLOCK_END, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, getDirname, appRootAllowedFiles, appRootAllowedDirs, libFacetRootAllowedFiles, isScannedAppRootEntry, 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, rootAllowedFiles, rootAllowedDirs, isAllowedLibFacetRootFile, isScannedRootEntry, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };