@akanjs/cli 3.0.0-alpha.6 → 3.0.0-alpha.60

package/incrementalBuilder.proc.js

@@ -8,18 +8,20 @@ import {
   DevGeneratedIndexSync,
   GraphClientEntryDiscovery,
   RouteClientBuilder
-} from "./index-j9cxndc0.js";
+} from "./index-qnv0aqmm.js";
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-bjpxzr6s.js";
+} from "./index-5vy2jzar.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-681sx6nt.js";
+import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
-import"./index-r24hmh0q.js";
+import"./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/incrementalBuilder/incrementalBuilder.proc.ts
 import path2 from "path";
@@ -249,7 +251,7 @@ class IncrementalBuilder {
       return;
     this.#shuttingDown = true;
     const started = Date.now();
-    this.#logger.info(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
+    this.#logger.debug(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
     if (this.#cssRebuildTimer) {
       clearTimeout(this.#cssRebuildTimer);
       this.#cssRebuildTimer = null;
@@ -262,7 +264,7 @@ class IncrementalBuilder {
       return;
     });
     const flushed = await BuilderChannel.drain();
-    this.#logger.info(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
+    this.#logger.debug(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
     process.exit(0);
   }
   get shuttingDown() {

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

@@ -1,24 +1,24 @@
 // @bun
 import {
   CloudRunner
-} from "./index-zbx0jheb.js";
+} from "./index-8md8zszv.js";
 import {
   PackageScript
-} from "./index-meh7mmz9.js";
+} from "./index-x1dbhd80.js";
 import {
   AiSession,
   CloudApi,
   GlobalConfig
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-r7nqv8qj.js";
+} from "./index-r8z20vnj.js";
 import {
   script
-} from "./index-jkynkyfk.js";
+} from "./index-ckpwq052.js";
 import {
   PkgExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-681sx6nt.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/index-1577bej2.js

@@ -0,0 +1,7 @@
+// @bun
+// pkgs/@akanjs/devkit/getDirname.ts
+import path from "path";
+import { fileURLToPath } from "url";
+var getDirname = (url) => path.dirname(fileURLToPath(url));
+
+export { getDirname };

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

@@ -4,19 +4,19 @@ import {
 } from "./index-ss469dec.js";
 import {
   AiSession
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-m4kpmmtj.js";
+} from "./index-g44fykfw.js";
 import {
   Prompter
-} from "./index-qp089jp0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-ckpwq052.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";

package/{index-bjpxzr6s.js → index-5vy2jzar.js}

@@ -422,7 +422,7 @@ class HmrWatcher {
     this.#unreportedChanges += unreported;
     if (!this.#reportedCompensating) {
       this.#reportedCompensating = true;
-      this.#logger.info(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
+      this.#logger.verbose(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
     }
     this.#logger.verbose(`[hmr] mtime scan found ${unreported} change(s) fs.watch never reported (${this.#unreportedChanges} total)`);
   }

package/{index-47qxw1tz.js → index-681sx6nt.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
@@ -182,8 +225,6 @@ var DEFAULT_OPTIMIZE_IMPORTS = [
 ];
 var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
 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 +253,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()
 ]);
@@ -298,7 +337,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 = [], libExternalLibs = []) {
     this.app = app;
     this.rootPackageJson = rootPackageJson;
     this.libs = libs;
@@ -306,7 +345,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 ?? [], ...libExternalLibs])];
     this.barrelImports = [
       ...DEFAULT_BARREL_IMPORTS,
       ...WORKSPACE_BARREL_FACETS.map((facet) => `@apps/${app.name}/${facet}`),
@@ -495,7 +534,15 @@ 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 libExternalLibs = await AkanAppConfig.#collectLibExternalLibs(app, libs, bustImportCache);
+    return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv, plugins ?? [], libExternalLibs);
+  }
+  static async#collectLibExternalLibs(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 externalLibs: ${String(error)}`);
+      return null;
+    })));
+    return libConfigs.flatMap((libConfig) => libConfig?.externalLibs ?? []);
   }
   #resolveProductionDependencyVersion(lib) {
     const rootVersion = this.rootPackageJson.dependencies?.[lib] ?? this.rootPackageJson.devDependencies?.[lib];
@@ -505,13 +552,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]];
@@ -605,8 +646,8 @@ class AkanLibConfig {
     this.externalLibs = config?.externalLibs ?? [];
     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 +668,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 +740,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 +805,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 +926,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 +934,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 +949,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 +1010,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 +1049,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 +1080,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 +1098,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");
@@ -1634,7 +1729,7 @@ class Executor {
         }));
       });
       proc.on("exit", (code, signal) => {
-        if (!!code || signal)
+        if (code || signal)
           reject(new CommandExecutionError({
             command,
             cwd,
@@ -1732,7 +1827,7 @@ class Executor {
         }));
       });
       proc.on("exit", (code, signal) => {
-        if (!!code || signal)
+        if (code || signal)
           reject(new CommandExecutionError({
             command: modulePath,
             args,
@@ -2028,7 +2123,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 +2204,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 +2392,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 +2592,7 @@ class SysExecutor extends Executor {
 class AppExecutor extends SysExecutor {
   static #routeSourceValidator = null;
   static async#getRouteSourceValidator() {
-    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-cncd92fv.js")).RouteSourceValidator;
+    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-7fycdqyv.js")).RouteSourceValidator;
     return AppExecutor.#routeSourceValidator;
   }
   dist;
@@ -2553,6 +2660,8 @@ class AppExecutor extends SysExecutor {
       ]);
     } else
       await this.removeDir(".akan");
+    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 +2750,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 +2979,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 +3076,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 +3119,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 };

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

@@ -4,24 +4,17 @@ import {
   CloudApi,
   GlobalConfig,
   getDefaultHostConfig
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   openBrowser
-} from "./index-r7nqv8qj.js";
+} from "./index-r8z20vnj.js";
 import {
   runner
-} from "./index-jkynkyfk.js";
+} from "./index-ckpwq052.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-47qxw1tz.js";
-
-// pkgs/@akanjs/cli/cloud/cloud.runner.ts
-import path from "path";
-import { confirm, input, select } from "@inquirer/prompts";
-import { Logger, sleep } from "akanjs/common";
-import chalk from "chalk";
-import * as QRcode from "qrcode";
+} from "./index-681sx6nt.js";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
 var defaultNpmRegistry = "https://registry.npmjs.org";
@@ -40,6 +33,11 @@ async function getLatestPackageVersion(packageName, tag = "latest", registryUrl)
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
+import path from "path";
+import { confirm, input, select } from "@inquirer/prompts";
+import { Logger, sleep } from "akanjs/common";
+import chalk from "chalk";
+import * as QRcode from "qrcode";
 var addRemoteEnvServerValue = "__addRemoteEnvServer";
 var removeRemoteEnvServerValue = "__removeRemoteEnvServer";
 
@@ -285,7 +283,10 @@ ${chalk.green("\u27A4")} Authentication Required`));
         return;
       }
     }
-    await Promise.all(akanPkgs.map(async (library) => {
+    Logger.info("Logging in to npm...");
+    await workspace.spawn("npm", ["login"], { stdio: "inherit" });
+    Logger.info("Logged in to npm");
+    for (const library of akanPkgs) {
       Logger.info(`Publishing ${library}@${nextVersion} to ${registry ?? "npm"}...`);
       await workspace.spawn("npm", ["publish", "--tag", tag, ...this.#getRegistryArgs(registry), ...this.#getLocalRegistryAuthArgs(registry)], {
         cwd: path.join(workspace.workspaceRoot, "dist/pkgs", library),
@@ -293,7 +294,7 @@ ${chalk.green("\u27A4")} Authentication Required`));
         stdio: "inherit"
       });
       Logger.info(`${library}@${nextVersion} is published to ${registry ?? "npm"}`);
-    }));
+    }
     Logger.info(`All libraries are published to ${registry ?? "npm"}`);
   }
   async update(workspace, tag = "latest", { registryUrl } = {}) {