@akanjs/cli 3.1.0-rc.20 → 3.1.0-rc.22

package/{index-1xj2t7cb.js → index-85h3dhe0.js}

@@ -22,26 +22,26 @@ import {
   renderWorkflowApply,
   renderWorkflowValidation,
   renderWorkflowRunArtifact
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 import {
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-tbmtmkhx.js";
 import {
   CommandContainer,
   runner
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   ModuleScript
-} from "./index-fmzcs8v6.js";
+} from "./index-1bhv9dh4.js";
 import {
   PrimitiveScript
-} from "./index-awbdfcf2.js";
+} from "./index-rp9anyeb.js";
 import {
   spawnShell
-} from "./index-j4mkhz93.js";
+} from "./index-t8npm331.js";
 import {
   ScalarScript
-} from "./index-1p98exm2.js";
+} from "./index-94jq9cbz.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-axs61rna.js → index-8abyrfw8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   resolveSsrPageEntriesForApp
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   computeRouteSeedIndex,
   saveRouteSeedIndex,
@@ -9,7 +9,7 @@ import {
   ClientEntriesBundler,
   VENDOR_SPECIFIERS,
   RouteClientBuilder
-} from "./index-w44cy4vs.js";
+} from "./index-cgyqx6q1.js";
 import {
   SOURCE_EXTS
 } from "./index-5nd1wtkv.js";
@@ -19,7 +19,7 @@ import {
   createTsconfigPackageResolver,
   rewriteBarrelImports,
   PagesBundleBuilder
-} from "./index-192ha4xh.js";
+} from "./index-6nqnqzv1.js";
 import {
   CssBlockParser
 } from "./index-62md4dwy.js";
@@ -1240,7 +1240,8 @@ class FontPruner {
       { dir: path5.join(this.#artifactRoot, "client"), label: ".akan/artifact/client", needles: bundled },
       { dir: path5.join(this.#artifactRoot, "client-ssr"), label: ".akan/artifact/client-ssr", needles: bundled },
       { dir: path5.join(this.#artifactRoot, "server"), label: ".akan/artifact/server", needles: bundled },
-      { dir: path5.join(this.#app.dist.cwdPath, "csr"), label: "csr", needles: bundled }
+      { dir: path5.join(this.#app.dist.cwdPath, "csr"), label: "csr", needles: bundled },
+      { dir: path5.join(this.#app.dist.cwdPath, "mcp-apps"), label: "mcp-apps", needles: bundled }
     ];
     for (const root of roots) {
       const pending = root.needles.filter((candidate) => !referrers.has(candidate.rel));

package/{index-1p98exm2.js → index-94jq9cbz.js}

@@ -2,12 +2,12 @@
 import {
   runner,
   script
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   generatedFilesForSync,
   createPassedPrimitiveReport,
   scalarChangedFiles
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 import {
   pluralizeName
 } from "./index-nz8prx9g.js";

package/{index-cpb3nvma.js → index-9h0z0tjr.js}

@@ -9,10 +9,10 @@ import {
   NativePublicEnv,
   UpdatePackFolder,
   NativeApp
-} from "./index-g1mbppa9.js";
+} from "./index-551gh8h2.js";
 import {
   ExitCodeError
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   ConfigLock
 } from "./index-bqbf654f.js";

package/{index-hsadfb6c.js → index-c9rfak6r.js}

@@ -4,26 +4,26 @@ import {
   CloudApi,
   CloudUpdates,
   PipelineSecrets
-} from "./index-cpb3nvma.js";
+} from "./index-9h0z0tjr.js";
 import {
   PkgExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   NativePublicEnv,
   UpdatePackFolder
-} from "./index-g1mbppa9.js";
+} from "./index-551gh8h2.js";
 import {
   script
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   ApplicationScript
-} from "./index-qtfmtcrw.js";
+} from "./index-1xqq3va9.js";
 import {
   PackageScript
-} from "./index-j237xtew.js";
+} from "./index-deckcwbg.js";
 import {
   CloudRunner
-} from "./index-fyq1z6kt.js";
+} from "./index-hagw9c94.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-w44cy4vs.js → index-cgyqx6q1.js}

@@ -19,11 +19,11 @@ import {
   CsrDevPaths,
   PagesEntrySourceGenerator,
   PagesBundleBuilder
-} from "./index-192ha4xh.js";
+} from "./index-6nqnqzv1.js";
 import {
   AsyncDefaultExportDetector,
   resolveSsrPageEntriesForApp
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 
 // pkgs/@akanjs/devkit/frontendBuild/autoImportSync.ts
 import { readdir, readFile, stat } from "fs/promises";

package/{index-d72hfmdm.js → index-cq5x7a9k.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   jsonText,
   createWorkflowBaselineSummary,
   buildAkanModuleContextIndex,
   toolingRolloutGate
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 import {
   buildResourceList,
   codexMcpConfigPath,
@@ -17,29 +17,29 @@ import {
   upsertCodexMcpServerBlock,
   renderDoctorText,
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-tbmtmkhx.js";
 import {
   runner
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   isPlaceholderAppId
-} from "./index-vk0pa0mn.js";
+} from "./index-ex35dg39.js";
 import {
   getMobileTargets,
   appIdsOf
 } from "./index-m9jj544v.js";
 import {
   NativeApp
-} from "./index-g1mbppa9.js";
+} from "./index-551gh8h2.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";
 import {
   RepairRunner
-} from "./index-j4mkhz93.js";
+} from "./index-t8npm331.js";
 import {
   WorkflowRunner
-} from "./index-1xj2t7cb.js";
+} from "./index-85h3dhe0.js";
 
 // pkgs/@akanjs/devkit/akanMcpContract.ts
 import path from "path";

package/{index-j237xtew.js → index-deckcwbg.js}

@@ -2,13 +2,13 @@
 import {
   runner,
   script
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";
 import {
   PkgExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   TypeScriptDependencyScanner2
 } from "./index-tvehn2sp.js";

package/{index-vk0pa0mn.js → index-ex35dg39.js}

@@ -2,7 +2,7 @@
 import {
   DesktopBin,
   UpdatePackFolder
-} from "./index-g1mbppa9.js";
+} from "./index-551gh8h2.js";
 // pkgs/@akanjs/devkit/mobile/desktopServerStage.ts
 import { cp, mkdir, readdir, rm, writeFile } from "fs/promises";
 import path from "path";
@@ -16,6 +16,7 @@ class DesktopServerStage {
     "console.js",
     "console-runtime.js",
     "csr",
+    "mcp-apps",
     "public",
     ".akan"
   ]);

package/{index-35hc95h5.js → index-f9118j70.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AppInfo
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 
 // pkgs/@akanjs/devkit/slicePlanner.ts
 class SlicePlanner {

package/{index-jw1zm273.js → index-g5px5pxd.js}

@@ -10,7 +10,7 @@ import {
   LibExecutor,
   PkgExecutor,
   ModuleExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 
 // pkgs/@akanjs/devkit/commandDecorators/camelToKebabCase.ts
 var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -289,8 +289,9 @@ var formatCommandHelp = (command, key) => {
       const optName = `${flag}--${kebabName}${negation}`;
       const optDesc = opt.desc ?? "";
       const defaultVal = opt.default !== undefined ? chalk.gray(` [default: ${String(opt.default)}]`) : "";
+      const repeatable = opt.multiple ? chalk.gray(" (repeatable)") : "";
       const choices = opt.enum ? chalk.gray(typeof opt.enum === "function" ? " ([dynamic choices])" : ` (${opt.enum.map(formatChoice).join(", ")})`) : "";
-      lines.push(`      ${chalk.green(optName)}      ${chalk.gray(optDesc)}${defaultVal}${choices}`);
+      lines.push(`      ${chalk.green(optName)}      ${chalk.gray(optDesc)}${defaultVal}${choices}${repeatable}`);
     }
     lines.push("");
   }
@@ -301,6 +302,10 @@ var formatCommandHelp = (command, key) => {
 // pkgs/@akanjs/devkit/commandDecorators/command.ts
 var loggedCliErrorObjects = new WeakSet;
 var loggedCliErrorMessages = new Set;
+var markCliErrorPrinted = (error) => {
+  if (typeof error === "object" && error !== null)
+    loggedCliErrorObjects.add(error);
+};
 var formatCliError = (error) => {
   if (error instanceof Error)
     return error.message || error.name;
@@ -341,7 +346,12 @@ var handleOption = (programCommand, argMeta) => {
   } = argMeta.argsOption;
   const kebabName = camelToKebabCase(argMeta.name);
   const choices = enumChoices && typeof enumChoices !== "function" ? normalizeEnumChoices(enumChoices) : null;
-  programCommand.option(`-${flag}, --${kebabName}${type === "boolean" ? " [boolean]" : ` <${kebabName}>`}`, `${desc}${ask ? ` (${ask})` : ""}${example ? ` (example: ${example})` : ""}${choices ? ` (choices: ${choices.map((choice) => choice.name).join(", ")})` : ""}`);
+  const flags = `-${flag}, --${kebabName}${type === "boolean" ? " [boolean]" : ` <${kebabName}>`}`;
+  const description = `${desc}${ask ? ` (${ask})` : ""}${example ? ` (example: ${example})` : ""}${choices ? ` (choices: ${choices.map((choice) => choice.name).join(", ")})` : ""}`;
+  if (argMeta.argsOption.multiple)
+    programCommand.option(flags, description, (value, previous = []) => [...previous, value]);
+  else
+    programCommand.option(flags, description);
   if (type === "boolean" && argMeta.argsOption.default === true)
     programCommand.option(`--no-${kebabName}`, `turn off --${kebabName}`);
   return programCommand;
@@ -359,6 +369,17 @@ var convertArgValue = (value, type) => {
   else
     return value === true || value === "true";
 };
+var givenOptionsOf = (argMetas, opt) => {
+  const given = {};
+  for (const argMeta of argMetas) {
+    if (argMeta.type !== "Option" || opt[argMeta.name] === undefined)
+      continue;
+    const type = argMeta.argsOption.type ?? "string";
+    const value = opt[argMeta.name];
+    given[argMeta.name] = Array.isArray(value) ? value.map((each) => convertArgValue(each, type)) : convertArgValue(value, type);
+  }
+  return given;
+};
 var normalizeEnumChoices = (enumChoices) => enumChoices.map((choice) => typeof choice === "object" ? { value: choice.value, name: choice.label } : { value: choice, name: choice.toString() });
 var prompts = async () => await import("@inquirer/prompts");
 var select = (config, context) => prompts().then((m) => m.select(config, context));
@@ -384,8 +405,14 @@ var inputMessageOf = ({ name, argsOption: { desc, example, ask } }) => ask ? `${
 var getOptionValue = async (argMeta, opt, context) => {
   const {
     name,
-    argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, ask }
+    argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, ask, multiple }
   } = argMeta;
+  if (multiple) {
+    const values = opt[argMeta.name] ?? [];
+    for (const value of values)
+      assertEnumChoice(argMeta, value);
+    return values.map((value) => convertArgValue(value, type ?? "string"));
+  }
   if (opt[argMeta.name] !== undefined) {
     assertEnumChoice(argMeta, opt[argMeta.name]);
     return convertArgValue(opt[argMeta.name], type ?? "string");
@@ -574,6 +601,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
 };
 var runCommands = async (...commands) => {
   let failureExitCode = 1;
+  let reportFailure = async (_error) => {};
   process.on("unhandledRejection", (error) => {
     printCliError(error);
     process.exit(ExitCodeError.codeOf(error) ?? failureExitCode);
@@ -614,9 +642,19 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
           hidden: targetMeta.targetOption.devOnly
         });
         const targetFailureExitCode = targetMeta.targetOption.failureExitCode;
-        if (targetFailureExitCode !== undefined)
-          programCommand.exitOverride((error) => process.exit(error.exitCode === 0 ? 0 : targetFailureExitCode));
+        const usageExitCode = targetMeta.targetOption.usageExitCode ?? targetFailureExitCode;
+        const { onFailure } = targetMeta.targetOption;
         const [allArgMetas] = getArgMetas(command, targetMeta.key);
+        if (usageExitCode !== undefined || onFailure)
+          programCommand.exitOverride((error) => {
+            if (error.exitCode === 0)
+              process.exit(0);
+            const refused = new ExitCodeError(error.message.replace(/^error: /, ""), usageExitCode ?? error.exitCode);
+            markCliErrorPrinted(refused);
+            const given = givenOptionsOf(allArgMetas, programCommand.opts());
+            reportFailure = async (failure) => await onFailure?.(failure, { usage: true, given });
+            throw refused;
+          });
         for (const argMeta of allArgMetas) {
           if (argMeta.type === "Option")
             programCommand = handleOption(programCommand, argMeta);
@@ -643,6 +681,7 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
             Logger.rawLog();
           const cmdArgs = args.slice(0, args.length - 2);
           const opt = args[args.length - 2];
+          reportFailure = async (failure) => await onFailure?.(failure, { usage: false, given: givenOptionsOf(allArgMetas, opt) });
           const commandArgs = [];
           if (targetMeta.targetOption.runsOnWorkspaceRoot)
             await assertCurrentDirectoryIsWorkspaceRoot();
@@ -681,13 +720,18 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
       }
     }
   }
-  await program.parseAsync(process.argv).catch((error) => {
+  await program.parseAsync(process.argv).catch(async (error) => {
     printCliError(error);
+    await reportFailure(error).catch(printCliError);
     process.exit(ExitCodeError.codeOf(error) ?? failureExitCode);
   });
 };
 // pkgs/@akanjs/devkit/commandDecorators/commandBuilder.ts
-var argMetaOf = (type, name, primitive, argsOption, idx) => ({ name, argsOption: { ...argsOption, type: normalizePrimitiveArgType(primitive) }, key: "", idx, type });
+var argMetaOf = (type, name, primitive, argsOption, idx) => {
+  if (type === "Argument" && argsOption?.multiple)
+    throw new Error(`argument '${name}' cannot be multiple`);
+  return { name, argsOption: { ...argsOption, type: normalizePrimitiveArgType(primitive) }, key: "", idx, type };
+};
 
 class TargetBuilder {
   targetOption;
@@ -758,4 +802,4 @@ function command(refName, depsOrBuilder, builder) {
   }
   return CommandBase;
 }
-export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, SysOrOnlyApp, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, ExitCodeError, assertPromptable, runCommands, command };
+export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, SysOrOnlyApp, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, ExitCodeError, markCliErrorPrinted, assertPromptable, runCommands, command };

package/{index-va06nr10.js → index-gxqvev8w.js}

@@ -1344,8 +1344,9 @@ var IMPLICIT_LAYOUT_DIR = path6.join(".akan", "generated", "root-layouts");
 var IMPLICIT_DICT_DIR = path6.join(".akan", "generated", "dict");
 var IMPLICIT_OVERRIDES_DIR = path6.join(".akan", "generated", "overrides");
 var OVERRIDES_KEY_RE = /^\.\/(.+\/)?_overrides\.(tsx|ts|jsx|js)$/;
+var posixRelative = (fromDir, toAbsPath) => path6.relative(fromDir, toAbsPath).split(path6.sep).join("/");
 var importSpecifier = (fromAbsPath, toAbsPath) => {
-  const rel = path6.relative(path6.dirname(fromAbsPath), toAbsPath).split(path6.sep).join("/");
+  const rel = posixRelative(path6.dirname(fromAbsPath), toAbsPath);
   return rel.startsWith(".") ? rel : `./${rel}`;
 };
 async function writeGeneratedOverridesLayoutFile(opts) {
@@ -1449,15 +1450,15 @@ async function writeGeneratedRootLayoutFile(opts) {
 void st;
 ` : `import "@apps/${opts.appName}/client";
 `;
-  const inheritedLabel = inheritedSourceAbsPath ? path6.relative(opts.appCwdPath, inheritedSourceAbsPath) : "";
+  const inheritedLabel = inheritedSourceAbsPath ? posixRelative(opts.appCwdPath, inheritedSourceAbsPath) : "";
   const inheritedImport = inheritedSourceSpecifier ? `import * as inheritedModule from ${JSON.stringify(inheritedSourceSpecifier)};
-const inheritedLayout = resolveRouteModule(inheritedModule as never, ${JSON.stringify(inheritedLabel)}).module as LayoutModule;
+const inheritedLayout = assertGuardOnChain(${JSON.stringify(inheritedLabel)}, resolveRouteModule(inheritedModule as never, ${JSON.stringify(inheritedLabel)})).module as LayoutModule;
 ` : `const inheritedLayout: LayoutModule = {};
 `;
   const prefix = opts.boundary.segments.find((segment) => !/^\(.+\)$/.test(segment)) ?? null;
-  const userLabel = opts.boundary.sourceAbsPath ? path6.relative(opts.appCwdPath, opts.boundary.sourceAbsPath) : "";
+  const userLabel = opts.boundary.sourceAbsPath ? posixRelative(opts.appCwdPath, opts.boundary.sourceAbsPath) : "";
   const userImport = sourceSpecifier ? `import * as userModule from ${JSON.stringify(sourceSpecifier)};
-const userLayout = resolveRouteModule(userModule as never, ${JSON.stringify(userLabel)}).module as LayoutModule;
+const userLayout = assertGuardOnChain(${JSON.stringify(userLabel)}, resolveRouteModule(userModule as never, ${JSON.stringify(userLabel)})).module as LayoutModule;
 const UserLayout = userLayout.default as (props: LayoutProps) => ReactNode | Promise<ReactNode>;
 ` : `const UserLayout = ({ children }: LayoutProps) => children;
 const userLayout: LayoutModule = {};
@@ -1473,6 +1474,7 @@ const userLayout: LayoutModule = {};
   const layoutChild = isAsyncUserLayout ? "{layout}" : userLayoutElement;
   const layoutReturn = isAsyncUserLayout ? "layout" : userLayoutElement;
   const headLayouts = opts.includeSystemProvider ? "[inheritedLayout, userLayout]" : "[userLayout]";
+  const guardExport = opts.includeSystemProvider ? "export const guard = RouteGuards.compose(inheritedLayout.guard, userLayout.guard);" : "export const guard = userLayout.guard;";
   const layoutExports = `export async function generateHead(props: PageProps) {
   const heads = await Promise.all(
     ${headLayouts}.map((layout) => (layout.generateHead ? layout.generateHead(props) : layout.head)),
@@ -1484,13 +1486,15 @@ export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
 export const Error = userLayout.Error ?? inheritedLayout.Error;
 export const pageConfig = userLayout.pageConfig ?? inheritedLayout.pageConfig;
 export const Loading = userLayout.Loading;
+${guardExport}
 
 ${layoutSignature}({ children, params, searchParams }: LayoutProps) {
 ${layoutBinding}  return `;
   const source = opts.includeSystemProvider ? `import type { LayoutModule, LayoutProps, PageProps } from "akanjs/client";
-import { loadFonts, resolveRouteModule, RouteHead } from "akanjs/client";
+import { assertGuardOnChain, loadFonts, RouteGuards, resolveRouteModule, RouteHead } from "akanjs/client";
 import type { ReactNode } from "react";
 import { System } from "akanjs/ui";
+import type { McpAppRootProps } from "akanjs/webkit";
 import { env } from "@apps/${opts.appName}/env/env.client";
 import { allDictionary } from ${JSON.stringify(dictMacroSpecifier)};
 ${clientImport}${inheritedImport}${userImport}
@@ -1524,8 +1528,24 @@ ${layoutExports}(
     </System.Provider>
   );
 }
+
+export function McpAppRoot({ children, params, path }: McpAppRootProps) {
+  return (
+    <System.App
+      params={params}
+      path={path}
+      env={env}
+      theme={theme}
+      viewport={viewport}
+      fonts={loadFonts(userFonts)}
+      className={defaultFontClassName}
+    >
+      {children}
+    </System.App>
+  );
+}
 ` : `import type { LayoutModule, LayoutProps, PageProps } from "akanjs/client";
-import { resolveRouteModule, RouteHead } from "akanjs/client";
+import { assertGuardOnChain, resolveRouteModule, RouteHead } from "akanjs/client";
 import type { ReactNode } from "react";
 ${inheritedImport}${userImport}
 ${layoutExports}${layoutReturn};
@@ -2251,6 +2271,7 @@ var resolveRepoName = (workspaceRoot) => {
 };
 
 // pkgs/@akanjs/devkit/scanInfo.ts
+import { createHash } from "crypto";
 import path11 from "path";
 
 // pkgs/@akanjs/devkit/workspaceLayout.ts
@@ -2574,10 +2595,13 @@ class ScanInfo {
 var isAkanFrameworkDependency = (dep) => dep === "akanjs" || dep.startsWith("akanjs/");
 
 class AppInfo extends ScanInfo {
+  static migrationDir = "script/migration";
+  static #migrationIdRe = /^\d{12}_[A-Za-z][A-Za-z0-9]*$/;
   type = "app";
   exec;
   akanConfig;
   libDeps;
+  migrations;
   static appInfos = new Map;
   static async fromExecutor(exec, options = {}) {
     const existingAppInfo = AppInfo.appInfos.get(exec.name);
@@ -2589,16 +2613,20 @@ class AppInfo extends ScanInfo {
       const libExecutor = LibExecutor.from(exec, libName);
       LibInfo.libInfos.set(libName, await LibInfo.fromExecutor(libExecutor));
     }));
-    const libDeps = await AppInfo.#getAllLibDeps(exec, scanResult.libDeps);
-    const appInfo = new AppInfo(exec, scanResult, libDeps);
+    const [libDeps, migrations] = await Promise.all([
+      AppInfo.#getAllLibDeps(exec, scanResult.libDeps),
+      AppInfo.scanMigrations(exec)
+    ]);
+    const appInfo = new AppInfo(exec, scanResult, libDeps, migrations);
     AppInfo.appInfos.set(exec.name, appInfo);
     return appInfo;
   }
-  constructor(exec, scanResult, libDeps) {
+  constructor(exec, scanResult, libDeps, migrations = []) {
     super(scanResult);
     this.exec = exec;
     this.akanConfig = scanResult.akanConfig;
     this.libDeps = libDeps;
+    this.migrations = migrations;
   }
   getScanResult() {
     return this.scanResult;
@@ -2606,6 +2634,18 @@ class AppInfo extends ScanInfo {
   setRoutes(routes) {
     this.scanResult.routes = routes;
   }
+  static async scanMigrations(exec) {
+    const files = (await exec.readdir(AppInfo.migrationDir)).filter((file) => file.endsWith(".ts") && !/\.(test|spec|d)\.ts$/.test(file));
+    return await Promise.all(files.map(async (file) => {
+      const id = file.slice(0, -".ts".length);
+      if (!AppInfo.#migrationIdRe.test(id))
+        throw new Error(`${AppInfo.migrationDir}/${file}: a migration is named <yyyyMMddHHmm>_<camelName>.ts; create one with \`akan create-migration\``);
+      const source = (await exec.readFile(`${AppInfo.migrationDir}/${file}`)).replace(/^\uFEFF/, "").replaceAll(`\r
+`, `
+`);
+      return { id, checksum: createHash("sha256").update(source).digest("hex") };
+    }));
+  }
   static async#getAllLibDeps(exec, libDeps, libSet = new Set) {
     await Promise.all(libDeps.map(async (libName) => {
       if (libSet.has(libName))
@@ -3741,7 +3781,7 @@ class SysExecutor extends Executor {
 class AppExecutor extends SysExecutor {
   static #routeSourceValidator = null;
   static async#getRouteSourceValidator() {
-    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-7ycnfz0e.js")).RouteSourceValidator;
+    AppExecutor.#routeSourceValidator ??= (await import("./routeSourceValidator-6jd0q6r6.js")).RouteSourceValidator;
     return AppExecutor.#routeSourceValidator;
   }
   dist;
@@ -4268,4 +4308,4 @@ class ModuleExecutor extends Executor {
   }
 }
 
-export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, CLAUDE_COMMENT_RULE, binPlatforms, ServerEnvProfile, AkanAppConfig, AkanWorkspaceConfig, AsyncDefaultExportDetector, resolveSsrPageEntriesForApp, CodegenLock, Linter, LibSource, formatLibStatuses, rootAllowedFiles, rootAllowedDirs, isAllowedLibFacetRootFile, libFacetRootHintOf, barrelFacetDirs, facetIndexShadowOf, rootEntryHintOf, isScannedRootEntry, AppInfo, Spinner, ProjectTypecheck2, 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, binPlatforms, ServerEnvProfile, AkanAppConfig, AkanWorkspaceConfig, AsyncDefaultExportDetector, resolveSsrPageEntriesForApp, CodegenLock, Linter, LibSource, formatLibStatuses, rootAllowedFiles, rootAllowedDirs, isAllowedLibFacetRootFile, libFacetRootHintOf, barrelFacetDirs, facetIndexShadowOf, rootEntryHintOf, isScannedRootEntry, AppInfo, Spinner, ProjectTypecheck2, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };

package/{index-fyq1z6kt.js → index-hagw9c94.js}

@@ -5,15 +5,15 @@ import {
   CloudApi,
   CloudUpdates,
   PipelineSecrets
-} from "./index-cpb3nvma.js";
+} from "./index-9h0z0tjr.js";
 import {
   WorkspaceExecutor,
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   runner,
   assertPromptable
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   SubspaceConfig
 } from "./index-4pf8g7ff.js";

package/{index-pydbnfez.js → index-p44jnjfr.js}

@@ -2,12 +2,12 @@
 import {
   runner,
   script
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   LibSource,
   formatLibStatuses,
   LibExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 
 // pkgs/@akanjs/cli/library/library.script.ts
 import { Logger } from "akanjs/common";

package/{index-awbdfcf2.js → index-rp9anyeb.js}

@@ -1,12 +1,12 @@
 // @bun
 import {
   script
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   workflowStatus,
   compactDiagnostics,
@@ -41,10 +41,10 @@ import {
   hasSignalFactoryEntry,
   insertSignalFactoryEntry,
   addFieldUiPolicyForType
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 import {
   ModuleScript
-} from "./index-fmzcs8v6.js";
+} from "./index-1bhv9dh4.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize, lowerlize } from "akanjs/common";

package/{index-j4mkhz93.js → index-t8npm331.js}

@@ -5,13 +5,13 @@ import {
   writeGeneratedSyncState,
   createRepairReport,
   renderRepairReport
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 import {
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-tbmtmkhx.js";
 import {
   runner
-} from "./index-jw1zm273.js";
+} from "./index-g5px5pxd.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var spawnShell = async (workspace, command) => await workspace.spawn("bash", ["-lc", command.startsWith("akan ") ? `bun run ${command}` : command], {

package/{index-5edzv8fn.js → index-tbmtmkhx.js}

@@ -10,7 +10,7 @@ import {
   isScannedRootEntry,
   AppExecutor,
   LibExecutor
-} from "./index-va06nr10.js";
+} from "./index-gxqvev8w.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";
@@ -23,7 +23,7 @@ import {
   workflowPathsForPlan,
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-trpasv9q.js";
+} from "./index-5m0s0gdv.js";
 
 // pkgs/@akanjs/devkit/akanContext.ts
 import { readdir } from "fs/promises";