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

package/{index-axs61rna.js → index-54wc2phm.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   resolveSsrPageEntriesForApp
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   computeRouteSeedIndex,
   saveRouteSeedIndex,
@@ -9,7 +9,7 @@ import {
   ClientEntriesBundler,
   VENDOR_SPECIFIERS,
   RouteClientBuilder
-} from "./index-w44cy4vs.js";
+} from "./index-1r5a8bzx.js";
 import {
   SOURCE_EXTS
 } from "./index-5nd1wtkv.js";
@@ -19,7 +19,7 @@ import {
   createTsconfigPackageResolver,
   rewriteBarrelImports,
   PagesBundleBuilder
-} from "./index-192ha4xh.js";
+} from "./index-h3r3nr9y.js";
 import {
   CssBlockParser
 } from "./index-62md4dwy.js";

package/{index-1xj2t7cb.js → index-75n5q4ph.js}

@@ -22,26 +22,26 @@ import {
   renderWorkflowApply,
   renderWorkflowValidation,
   renderWorkflowRunArtifact
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-nv79n88g.js";
 import {
   CommandContainer,
   runner
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   ModuleScript
-} from "./index-fmzcs8v6.js";
+} from "./index-p2r64bpa.js";
 import {
   PrimitiveScript
-} from "./index-awbdfcf2.js";
+} from "./index-4393nb4b.js";
 import {
   spawnShell
-} from "./index-j4mkhz93.js";
+} from "./index-pg1t468s.js";
 import {
   ScalarScript
-} from "./index-1p98exm2.js";
+} from "./index-g9ks2k8c.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-hsadfb6c.js → index-844q7f8z.js}

@@ -4,26 +4,26 @@ import {
   CloudApi,
   CloudUpdates,
   PipelineSecrets
-} from "./index-cpb3nvma.js";
+} from "./index-jrmzcp66.js";
 import {
   PkgExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   NativePublicEnv,
   UpdatePackFolder
-} from "./index-g1mbppa9.js";
+} from "./index-35m6bzm7.js";
 import {
   script
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   ApplicationScript
-} from "./index-qtfmtcrw.js";
+} from "./index-h6czey01.js";
 import {
   PackageScript
-} from "./index-j237xtew.js";
+} from "./index-ebarbgba.js";
 import {
   CloudRunner
-} from "./index-fyq1z6kt.js";
+} from "./index-rc51f9ht.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-4mhy6qme.js → index-8jehkey8.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   jsonText
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   akanMcpInstallTargets
-} from "./index-5edzv8fn.js";
+} from "./index-nv79n88g.js";
 import {
   script
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   ContextRunner2
-} from "./index-d72hfmdm.js";
+} from "./index-zv5s8x58.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-pydbnfez.js → index-9mt4smfy.js}

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

package/{index-dye8pnxx.js → index-cae9m5jz.js}

@@ -179,7 +179,7 @@ class SubagentPool2 {
     }
   }
   async#run(id, kind, prompt, signal) {
-    const { CodeAgent } = await import("./CodeAgent-n3tzjm91.js");
+    const { CodeAgent } = await import("./CodeAgent-gzfc5t52.js");
     const budget = this.#options.parent.tools.subagent;
     const child = SubagentPool2.childOf(this.#options.parent, kind);
     const agent = await CodeAgent.create({

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

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

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

@@ -2251,6 +2251,7 @@ var resolveRepoName = (workspaceRoot) => {
 };
 
 // pkgs/@akanjs/devkit/scanInfo.ts
+import { createHash } from "crypto";
 import path11 from "path";
 
 // pkgs/@akanjs/devkit/workspaceLayout.ts
@@ -2574,10 +2575,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 +2593,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 +2614,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))
@@ -4268,4 +4288,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-1p98exm2.js → index-g9ks2k8c.js}

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

package/{index-192ha4xh.js → index-h3r3nr9y.js}

@@ -2,7 +2,7 @@
 import {
   AsyncDefaultExportDetector,
   resolveSsrPageEntriesForApp
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";

package/{index-qtfmtcrw.js → index-h6czey01.js}

@@ -39,18 +39,21 @@ import {
 import {
   runner,
   script,
+  markCliErrorPrinted,
   assertPromptable
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
+  AppInfo,
+  CommandExecutionError,
   WorkspaceExecutor,
   AppExecutor,
   LibExecutor,
   PkgExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   DesktopServerStage,
   UpdateUploader
-} from "./index-vk0pa0mn.js";
+} from "./index-4v43h00g.js";
 import {
   resolveMobileTargets,
   resolveAppId
@@ -59,17 +62,17 @@ import {
   NativePublicEnv,
   UpdatePackFolder,
   NativeApp
-} from "./index-g1mbppa9.js";
+} from "./index-35m6bzm7.js";
 import {
   LibraryScript
-} from "./index-pydbnfez.js";
+} from "./index-9mt4smfy.js";
 import {
   stripAnsi
 } from "./index-7md2g9vw.js";
 import {
   SlicePlanner,
   formatSlicePlan
-} from "./index-35hc95h5.js";
+} from "./index-xsd96yzw.js";
 import {
   openBrowser
 } from "./index-9dp031by.js";
@@ -1896,7 +1899,7 @@ ${uniqueCandidates.map((candidate) => `  - ${candidate}`).join(`
 
 // pkgs/@akanjs/cli/application/application.runner.ts
 import { Logger as Logger3, toError } from "akanjs/common";
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-vh4j6vdv.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-wsszr305.js")).ApplicationBuildRunner;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -1938,8 +1941,12 @@ class ApplicationRunner extends runner("application") {
     const scriptPath = `script/${scriptName}.ts`;
     if (!await app.exists(scriptPath))
       throw new Error(`Script file not found: apps/${app.name}/${scriptPath}`);
-    await app.spawn("bun", [scriptPath], {
-      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "script", ...await app.getDatabaseModeEnv() }),
+    await this.#spawnFromRoot(app, "script", [`${app.cwdPath}/${scriptPath}`]);
+  }
+  async#spawnFromRoot(app, commandType, args) {
+    await app.spawn("bun", args, {
+      cwd: app.workspace.workspaceRoot,
+      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: commandType, ...await app.getDatabaseModeEnv() }),
       stdio: "inherit"
     });
   }
@@ -2026,10 +2033,7 @@ try {
   await server.stop();
 }
 `;
-    await app.spawn("bun", ["-e", code], {
-      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "console", ...await app.getDatabaseModeEnv() }),
-      stdio: "inherit"
-    });
+    await this.#spawnFromRoot(app, "console", ["-e", code]);
   }
   async transferDatabase(app, direction, dir) {
     const serverPath = `${app.cwdPath}/server.ts`;
@@ -2048,16 +2052,55 @@ try {
   await server.stop();
 }
 `;
-    await app.spawn("bun", ["-e", code], {
-      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "script", ...await app.getDatabaseModeEnv() }),
-      stdio: "inherit"
+    await this.#spawnFromRoot(app, "script", ["-e", code]);
+  }
+  async migrate(app, argv) {
+    const serverPath = `${app.cwdPath}/server.ts`;
+    if (!await app.exists("server.ts"))
+      throw new Error(`Server file not found: apps/${app.name}/server.ts`);
+    const code = `
+const argv = ${JSON.stringify(argv)};
+let loaded;
+try {
+  loaded = await import(${JSON.stringify(serverPath)});
+} catch (error) {
+  console.error(error);
+  const { MigrationCommand } = await import("akanjs/server");
+  process.exitCode = await MigrationCommand.print(MigrationCommand.failure(null, error), MigrationCommand.jsonOf(argv));
+}
+if (loaded) process.exitCode = await loaded.migrations.command(loaded.server, argv, ${JSON.stringify(`akan migrate ${app.name}`)});
+`;
+    try {
+      await this.#spawnFromRoot(app, "script", ["-e", code]);
+    } catch (error) {
+      if (!(error instanceof CommandExecutionError) || error.code === null)
+        throw error;
+      process.exitCode = error.code;
+    }
+  }
+  async createMigration(app, migrationName, now = new Date) {
+    const words = migrationName.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    const name = words.map((word, idx) => (idx ? word.charAt(0).toUpperCase() : word.charAt(0).toLowerCase()) + word.slice(1)).join("");
+    if (!/^[A-Za-z][A-Za-z0-9]*$/.test(name))
+      throw new Error(`"${migrationName}" is no migration name; name what it does in camelCase, e.g. bizLicenseOwnership`);
+    const migrationId = `${now.toISOString().replace(/\D/g, "").slice(0, 12)}_${name}`;
+    const filePath = `${AppInfo.migrationDir}/${migrationId}.ts`;
+    if (await app.exists(filePath))
+      throw new Error(`apps/${app.name}/${filePath} already exists`);
+    const title = name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase();
+    await app.applyTemplate({
+      basePath: AppInfo.migrationDir,
+      template: "migration",
+      dict: { migrationId, title: title.charAt(0).toUpperCase() + title.slice(1) },
+      overwrite: false
     });
+    return migrationId;
   }
   async typecheck(app, options = {}) {
     await new (await loadBuildRunner())(app).typecheck(options);
   }
   async typecheckLibrary(lib, options = {}) {
-    const { ProjectTypecheck } = await import("./projectTypecheck-f534enqj.js");
+    const { ProjectTypecheck } = await import("./projectTypecheck-fx8x7cat.js");
     const root = lib.workspace.workspaceRoot;
     await new ProjectTypecheck(lib.cwdPath, root, { ...process.env, AKAN_WORKSPACE_ROOT: root }).run([
       "../../server.ts",
@@ -3339,6 +3382,14 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     await app.scanSync();
     await this.applicationRunner.runConsole(app);
   }
+  async migrate(app, argv) {
+    await app.scanSync();
+    await this.applicationRunner.migrate(app, argv);
+  }
+  async createMigration(app, migrationName) {
+    const migrationId = await this.applicationRunner.createMigration(app, migrationName);
+    Logger6.rawLog(`Created apps/${app.name}/script/migration/${migrationId}.ts; plan it with \`akan migrate ${app.name} plan ${migrationId}\``);
+  }
   async logs(app, options) {
     await this.applicationRunner.runLogs(app, options);
   }
@@ -3359,6 +3410,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     } catch (error) {
       Logger6.rawLog(`${app.name} build failed in dist/apps/${app.name}`, undefined, "error");
       Logger6.rawLog(ApplicationBuildReporter.formatError(error), undefined, "error");
+      markCliErrorPrinted(error);
       throw error;
     }
   }
@@ -3381,6 +3433,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     } catch (error) {
       spinner.fail(`${exec.name} typecheck failed`);
       Logger6.rawLog(ApplicationBuildReporter.formatError(error), undefined, "error");
+      markCliErrorPrinted(error);
       throw error;
     }
   }
@@ -3635,7 +3688,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
       await Promise.all(shares.map(async (share) => await share.close()));
     }, "Abandoning the tunnel release; the shares expire on their own.");
     await Promise.all(apps.map(async (app) => {
-      const { TunnelShare } = await import("./TunnelShare-661cxz5e.js");
+      const { TunnelShare } = await import("./TunnelShare-tfrnftgr.js");
       const share = await TunnelShare.open(app, { workspace: app.workspace });
       shares.push(share);
       urls.set(app.name, share.url);

package/{index-cpb3nvma.js → index-jrmzcp66.js}

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

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

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

package/{index-665zp9rs.js → index-nx64dz92.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   resolveSsrPageEntriesForApp
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   bundleDefine,
   CsrEntryFiles,
   PagesEntrySourceGenerator,
   PagesBundleBuilder
-} from "./index-192ha4xh.js";
+} from "./index-h3r3nr9y.js";
 
 // pkgs/@akanjs/devkit/frontendBuild/csrArtifactBuilder.ts
 import { mkdir, rm, unlink } from "fs/promises";

package/{index-fmzcs8v6.js → index-p2r64bpa.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   ModuleExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   sourceFile,
   moduleSourcePaths,
@@ -13,10 +13,10 @@ import {
   createPassedPrimitiveReport,
   bilingualLabelForField,
   bilingualDescriptionForField
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   PageScript
-} from "./index-86jt2a0e.js";
+} from "./index-27y8t17p.js";
 import {
   pluralizeName
 } from "./index-nz8prx9g.js";

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

@@ -5,13 +5,13 @@ import {
   writeGeneratedSyncState,
   createRepairReport,
   renderRepairReport
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-nv79n88g.js";
 import {
   runner
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.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-fyq1z6kt.js → index-rc51f9ht.js}

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

package/{index-tamvyvj3.js → index-ta1dychm.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   AGENT_BLOCK_START,
   AGENT_BLOCK_END,
@@ -13,14 +13,14 @@ import {
   CLAUDE_COMMENT_RULE,
   AppExecutor,
   LibExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   collectRecipeSources2,
   scanRecipes2
 } from "./index-hj6w4ka1.js";
 import {
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-nv79n88g.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";