@akanjs/cli 3.0.0-alpha.45 → 3.0.0-alpha.46

package/.build-stamp

@@ -1 +1 @@
-3d17e70d8a2d8236808e345bba738f7377dfe29fa09d7f7f2c2722f562bd3695
+a449ecf4ed04e054d920f6f80354679ed20e1dd7aa0876766c212592a816bc2a

package/{agent.command-e835fjem.js → agent.command-nqs3bw0g.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   AgentScript
-} from "./index-k6fvbcj1.js";
-import"./index-g9e2fhw2.js";
-import"./index-tsmjxph2.js";
+} from "./index-xe3ychw5.js";
+import"./index-24h5bqpj.js";
+import"./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-1577bej2.js";

package/{application.command-sjtbk6tr.js → application.command-cfx525a9.js}

@@ -4,8 +4,8 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-8d2sv6pw.js";
-import"./index-73rnbwgg.js";
+} from "./index-yay1fd05.js";
+import"./index-6bs24rb4.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
@@ -15,10 +15,10 @@ import {
   Sys,
   Workspace,
   command
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-8vkkm7v0.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

package/buildBatch.proc.js

@@ -12,7 +12,7 @@ import"./index-bjpxzr6s.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

package/{capacitorApp-qv7g3dp2.js → capacitorApp-927ahhz2.js}

@@ -25,9 +25,9 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-mz5jtaq7.js";
+} from "./index-zgkey4d0.js";
 import"./index-76rn3g2c.js";
-import"./index-8vkkm7v0.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

package/{cloud.command-y0e4eyqz.js → cloud.command-4mkbvey2.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   CloudScript
-} from "./index-becx1t0k.js";
-import"./index-t71zvmt9.js";
-import"./index-33zce8gt.js";
+} from "./index-xc6bbz6e.js";
+import"./index-3h0d06v8.js";
+import"./index-7zd96bng.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
-import"./index-8d2sv6pw.js";
-import"./index-73rnbwgg.js";
+import"./index-yay1fd05.js";
+import"./index-6bs24rb4.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-8vkkm7v0.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-46tjzh6s.js";

package/{context.command-vn87jb08.js → context.command-6kn3tady.js}

@@ -1,25 +1,25 @@
 // @bun
 import {
   ContextScript
-} from "./index-0h212yqe.js";
-import"./index-xyrb7pk5.js";
-import"./index-3dp7x6rc.js";
-import"./index-x33gnap3.js";
-import"./index-9jsnb4vw.js";
-import"./index-mykmf6wd.js";
+} from "./index-866yqz3y.js";
+import"./index-5fe016p2.js";
+import"./index-k7sm38v6.js";
+import"./index-7w5vv8jk.js";
+import"./index-97cw8sg1.js";
+import"./index-xrdrttjb.js";
 import"./index-ss469dec.js";
-import"./index-qc0tnhs2.js";
-import"./index-mz5jtaq7.js";
+import"./index-4z05haak.js";
+import"./index-zgkey4d0.js";
 import"./index-sh01r3pm.js";
-import"./index-g9e2fhw2.js";
-import"./index-tsmjxph2.js";
+import"./index-24h5bqpj.js";
+import"./index-5em412h5.js";
 import"./index-j37qq1f2.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-1577bej2.js";

package/{guideline.command-s4hn2bsy.js → guideline.command-pjdrndqk.js}

@@ -10,8 +10,8 @@ import {
   command,
   runner,
   script
-} from "./index-n706txcv.js";
-import"./index-8vkkm7v0.js";
+} from "./index-8rr621r2.js";
+import"./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import {
   getDirname

package/guidelines/conventions/conventions.instruction.md

@@ -1176,17 +1176,19 @@ export const pageConfig = { transition: "stack" } satisfies PageConfig;
 
 ## Akan Sync Conventions (`apps/**`, `libs/**`)
 
-- `apps/<appName>` root may only contain these files: `AGENTS.md`, `CLAUDE.md`, `akan.app.json`, `akan.config.ts`, `capacitor.config.ts`, `client.ts`, `main.ts`, `package.json`, `server.ts`, `tsconfig.json`.
+- `apps/<appName>` root may only contain these files: `AGENTS.md`, `CLAUDE.md`, `akan.app.json`, `akan.config.ts`, `capacitor.config.ts`, `client.ts`, `main.ts`, `package.json`, `server.ts`, `tsconfig.json`, `tsconfig.tsbuildinfo`.
 - `apps/<appName>` root may only contain these folders: `.akan`, `android`, `common`, `env`, `ios`, `lib`, `mobile`, `page`, `plugin`, `private`, `public`, `script`, `secrets`, `srvkit`, `ui`, `webkit`.
-- That allowlist has one source — `pkgs/@akanjs/devkit/workspaceLayout.ts`. `akan sync` (error), `akan doctor`
+- `libs/<libName>` root may only contain these files: `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`.
+- `libs/<libName>` root may only contain these folders: `common`, `env`, `lib`, `page`, `plugin`, `private`, `public`, `srvkit`, `ui`, `webkit`. A library is never booted or packaged as an app, so the run and mobile entries an app carries (`main.ts`, `capacitor.config.ts`, `.akan`, `android`, `ios`, `mobile`, `script`, `secrets`) are rejected there.
+- Both allowlists have one source — `pkgs/@akanjs/devkit/workspaceLayout.ts`. `akan sync` (error), `akan doctor`
   (diagnostic), and `akan quality scan` (warning) all read it, so add a new root entry there and mirror it into this
   list, never into one of the three call sites.
 - `akan sync` maintains a scoped agent guide per app/lib: `apps/<app>/AGENTS.md` / `libs/<lib>/AGENTS.md`. The
   section between the `akan:agent` markers (the `## Recipes In Scope` index) is generated — do not hand-edit it;
   content outside the markers is yours. `akan lint` fails when the generated section is stale.
 - The `plugin/` facet holds Akan plugin declarations; files use the `<name>.plugin.ts` convention (e.g. `pushNotification.plugin.ts`) and are re-exported from the generated `plugin/index.ts` barrel.
-- Do not add `apps/*/base`; place shared app utilities under `apps/*/common`.
-- `apps/*/lib` and `libs/*/lib` root files are limited to generated/support files: `cnst.ts`, `db.ts`, `dict.ts`, `option.ts`, `sig.ts`, `srv.ts`, `st.ts`, `useClient.ts`, `useServer.ts`.
+- Do not add `apps/*/base` or `libs/*/base`; place shared utilities under that app or lib's own `common/`.
+- `apps/*/lib` and `libs/*/lib` root files are limited to generated/support files: `cnst.ts`, `db.ts`, `dict.ts`, `option.ts`, `sig.ts`, `srv.ts`, `st.ts`, `useClient.ts`, `useServer.ts` — plus a `<model>.signal.test.ts` / `.spec.ts`, the one hand-written file that belongs there because the suite boots the whole barrel.
 - Domain module folders are `lib/<model>` for database modules, `lib/_<service>` for service modules, and `lib/__scalar/<scalar>` for scalar modules.
 - Database module UI files are limited to `<Model>.Template.tsx`, `<Model>.Unit.tsx`, `<Model>.Util.tsx`, `<Model>.View.tsx`, and `<Model>.Zone.tsx`.
 - Service module UI files are limited to `<Service>.Util.tsx` and `<Service>.Zone.tsx`.

package/incrementalBuilder.proc.js

@@ -16,7 +16,7 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";
 import"./index-67546d0j.js";

package/{index-g9e2fhw2.js → index-24h5bqpj.js}

@@ -2,16 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   AppExecutor,
   LibExecutor,
-  appRootAllowedDirs,
-  appRootAllowedFiles,
   extractBlockVersion,
-  isScannedAppRootEntry,
-  readDevkitVersion
-} from "./index-8vkkm7v0.js";
+  isScannedRootEntry,
+  readDevkitVersion,
+  rootAllowedDirs,
+  rootAllowedFiles
+} from "./index-90zyjrby.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,
@@ -404,19 +404,19 @@ class AkanContextAnalyzer {
       repairAction("generated", "akan repair generated --app <app-or-lib>", "Refresh generated Akan files.", true),
       repairAction("format", "akan repair format --target <app-or-lib-or-pkg>", "Run the formatter/linter repair path.", true)
     ];
-    for (const app of context.apps) {
-      const appPath = path.join(workspace.workspaceRoot, app.path);
-      for (const entry of await safeReadDir(appPath)) {
-        if (!isScannedAppRootEntry(entry.name))
+    for (const sys of [...context.apps, ...context.libs]) {
+      const sysPath = path.join(workspace.workspaceRoot, sys.path);
+      for (const entry of await safeReadDir(sysPath)) {
+        if (!isScannedRootEntry(sys.type, entry.name))
           continue;
-        const allowed = entry.isDirectory() ? appRootAllowedDirs.has(entry.name) : appRootAllowedFiles.has(entry.name);
+        const allowed = entry.isDirectory() ? rootAllowedDirs[sys.type].has(entry.name) : rootAllowedFiles[sys.type].has(entry.name);
         if (!allowed) {
-          const action = repairAction("module-shape", `akan repair module-shape --app ${app.name}`, "Review app root shape and remove or move the unknown entry.", false);
+          const action = repairAction("module-shape", `akan repair module-shape --app ${sys.name}`, `Review ${sys.type} root shape and remove or move the unknown entry.`, false);
           diagnostics.push({
             severity: "error",
-            code: "app-root-unknown-entry",
-            path: `${app.path}/${entry.name}`,
-            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in app root: ${app.path}/${entry.name}`,
+            code: `${sys.type}-root-unknown-entry`,
+            path: `${sys.path}/${entry.name}`,
+            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in ${sys.type} root: ${sys.path}/${entry.name}`,
             repairActions: [action]
           });
           repairActions.push(action);

package/{index-t71zvmt9.js → index-3h0d06v8.js}

@@ -7,14 +7,14 @@ import {
 } from "./index-sh01r3pm.js";
 import {
   openBrowser
-} from "./index-8d2sv6pw.js";
+} from "./index-yay1fd05.js";
 import {
   runner
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
 var defaultNpmRegistry = "https://registry.npmjs.org";

package/{index-qc0tnhs2.js → index-4z05haak.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-tsmjxph2.js → index-5em412h5.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `

package/{index-xyrb7pk5.js → index-5fe016p2.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-g9e2fhw2.js";
+} from "./index-24h5bqpj.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   runner
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-73rnbwgg.js → index-6bs24rb4.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
   LibExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/semver.ts
 var stripRangeOperator = (version) => version.replace(/^[\s^~>=<v]+/, "").trim();

package/{index-x33gnap3.js → index-7w5vv8jk.js}

@@ -9,14 +9,14 @@ import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";

package/{index-33zce8gt.js → index-7zd96bng.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
   PkgExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";

package/{index-0h212yqe.js → index-866yqz3y.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-xyrb7pk5.js";
+} from "./index-5fe016p2.js";
 import {
   WorkflowRunner
-} from "./index-3dp7x6rc.js";
+} from "./index-k7sm38v6.js";
 import {
   ScalarScript
-} from "./index-x33gnap3.js";
+} from "./index-7w5vv8jk.js";
 import {
   PrimitiveScript
-} from "./index-9jsnb4vw.js";
+} from "./index-97cw8sg1.js";
 import {
   ModuleScript
-} from "./index-mykmf6wd.js";
+} from "./index-xrdrttjb.js";
 import {
   isPlaceholderAppId
-} from "./index-mz5jtaq7.js";
+} from "./index-zgkey4d0.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,14 +27,14 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-g9e2fhw2.js";
+} from "./index-24h5bqpj.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
   AppExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-n706txcv.js → index-8rr621r2.js}

@@ -6,7 +6,7 @@ import {
   ModuleExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 import {
   getDirname
 } from "./index-1577bej2.js";

package/{index-8vkkm7v0.js → index-90zyjrby.js}

@@ -33,6 +33,7 @@ import path5 from "path";
 import { pathToFileURL } from "url";
 import {
   capitalize,
+  getPageSourceFileViolation,
   isRouteSourceFile,
   Logger,
   parseRouteModuleKey,
@@ -332,7 +333,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;
@@ -340,7 +341,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}`),
@@ -529,7 +530,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];
@@ -633,8 +642,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 ?? []);
@@ -997,6 +1006,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",
@@ -1008,7 +1045,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 = [
@@ -1037,10 +1076,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-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")
@@ -1057,17 +1094,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");
@@ -2348,6 +2388,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;
@@ -2922,7 +2974,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;
   }
 }
@@ -3062,4 +3114,4 @@ class ModuleExecutor extends Executor {
   }
 }
 
-export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, CLAUDE_COMMENT_RULE, 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-9jsnb4vw.js → index-97cw8sg1.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-mykmf6wd.js";
+} from "./index-xrdrttjb.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   script
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-8vkkm7v0.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-3dp7x6rc.js → index-k7sm38v6.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-g9e2fhw2.js";
+} from "./index-24h5bqpj.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-tsmjxph2.js";
+} from "./index-5em412h5.js";
 import {
   runner
-} from "./index-n706txcv.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";