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

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

@@ -10,7 +10,7 @@ import {
   LibExecutor,
   PkgExecutor,
   ModuleExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.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-35hc95h5.js → index-xsd96yzw.js}

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

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

@@ -1,13 +1,13 @@
 // @bun
 import {
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   jsonText,
   createWorkflowBaselineSummary,
   buildAkanModuleContextIndex,
   toolingRolloutGate
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   buildResourceList,
   codexMcpConfigPath,
@@ -17,29 +17,29 @@ import {
   upsertCodexMcpServerBlock,
   renderDoctorText,
   AkanContextAnalyzer
-} from "./index-5edzv8fn.js";
+} from "./index-nv79n88g.js";
 import {
   runner
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   isPlaceholderAppId
-} from "./index-vk0pa0mn.js";
+} from "./index-4v43h00g.js";
 import {
   getMobileTargets,
   appIdsOf
 } from "./index-m9jj544v.js";
 import {
   NativeApp
-} from "./index-g1mbppa9.js";
+} from "./index-35m6bzm7.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";
 import {
   RepairRunner
-} from "./index-j4mkhz93.js";
+} from "./index-pg1t468s.js";
 import {
   WorkflowRunner
-} from "./index-1xj2t7cb.js";
+} from "./index-75n5q4ph.js";
 
 // pkgs/@akanjs/devkit/akanMcpContract.ts
 import path from "path";

package/index.js

@@ -4,35 +4,35 @@ import {
   getTargetMetas,
   getTargetCommandNames,
   runCommands
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 
 // pkgs/@akanjs/cli/commandManifest.ts
 import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-jqs7vjhe.js")).WorkspaceCommand,
-  agent: async () => (await import("./agent.command-3qxf4xcj.js")).AgentCommand,
-  code: async () => (await import("./code.command-130bdmhe.js")).CodeCommand,
-  application: async () => (await import("./application.command-zfja7x4r.js")).ApplicationCommand,
-  library: async () => (await import("./library.command-erp2f56n.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-hj3p16p5.js")).LocalRegistryCommand,
-  package: async () => (await import("./package.command-j10r76ax.js")).PackageCommand,
-  module: async () => (await import("./module.command-gs2r615e.js")).ModuleCommand,
-  page: async () => (await import("./page.command-4h4a8pnh.js")).PageCommand,
-  context: async () => (await import("./context.command-0qx447mb.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-fcc8e8tp.js")).CloudCommand,
-  subspace: async () => (await import("./subspace.command-baz73jpk.js")).SubspaceCommand,
-  guideline: async () => (await import("./guideline.command-cv5bmrx2.js")).GuidelineCommand,
-  scalar: async () => (await import("./scalar.command-20b8cy0k.js")).ScalarCommand,
-  primitive: async () => (await import("./primitive.command-w6t0asqz.js")).PrimitiveCommand,
-  quality: async () => (await import("./quality.command-77x7vbbx.js")).QualityCommand,
-  repair: async () => (await import("./repair.command-y6sstev7.js")).RepairCommand,
-  workflow: async () => (await import("./workflow.command-2djwmpqf.js")).WorkflowCommand,
-  pipeline: async () => (await import("./pipeline.command-a2nrk26m.js")).PipelineCommand,
-  tunnel: async () => (await import("./tunnel.command-2kw8vt9g.js")).TunnelCommand
+  workspace: async () => (await import("./workspace.command-1r9hvvw0.js")).WorkspaceCommand,
+  agent: async () => (await import("./agent.command-67ysh3n6.js")).AgentCommand,
+  code: async () => (await import("./code.command-ttk8tje2.js")).CodeCommand,
+  application: async () => (await import("./application.command-q0tqw5pc.js")).ApplicationCommand,
+  library: async () => (await import("./library.command-6amzsrb8.js")).LibraryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-yqc0nyhh.js")).LocalRegistryCommand,
+  package: async () => (await import("./package.command-pwfvecjf.js")).PackageCommand,
+  module: async () => (await import("./module.command-10x6jv6c.js")).ModuleCommand,
+  page: async () => (await import("./page.command-ahhgx9y1.js")).PageCommand,
+  context: async () => (await import("./context.command-bdsk2z2r.js")).ContextCommand,
+  cloud: async () => (await import("./cloud.command-e7tkxyx6.js")).CloudCommand,
+  subspace: async () => (await import("./subspace.command-sc0t527y.js")).SubspaceCommand,
+  guideline: async () => (await import("./guideline.command-man90n70.js")).GuidelineCommand,
+  scalar: async () => (await import("./scalar.command-fprap51w.js")).ScalarCommand,
+  primitive: async () => (await import("./primitive.command-g5xwv6tj.js")).PrimitiveCommand,
+  quality: async () => (await import("./quality.command-fw9ck061.js")).QualityCommand,
+  repair: async () => (await import("./repair.command-g8kecj96.js")).RepairCommand,
+  workflow: async () => (await import("./workflow.command-j0jgkr13.js")).WorkflowCommand,
+  pipeline: async () => (await import("./pipeline.command-1ptr3e9y.js")).PipelineCommand,
+  tunnel: async () => (await import("./tunnel.command-mqnsqbwf.js")).TunnelCommand
 };
 var commandModuleIds = Object.keys(commandModules);
 

package/{library.command-erp2f56n.js → library.command-6amzsrb8.js}

@@ -3,12 +3,12 @@ import {
   Lib,
   Workspace,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import {
   LibraryScript
-} from "./index-pydbnfez.js";
+} from "./index-9mt4smfy.js";
 
 // pkgs/@akanjs/cli/library/library.command.ts
 class LibraryCommand extends command("library", [LibraryScript], ({ public: target }) => ({

package/{localRegistry.command-hj3p16p5.js → localRegistry.command-yqc0nyhh.js}

@@ -4,32 +4,32 @@ import {
   runner,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
 import {
   PkgExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import"./index-5nd1wtkv.js";
-import"./index-vk0pa0mn.js";
+import"./index-4v43h00g.js";
 import"./index-m9jj544v.js";
-import"./index-g1mbppa9.js";
-import"./index-192ha4xh.js";
-import"./index-pydbnfez.js";
+import"./index-35m6bzm7.js";
+import"./index-h3r3nr9y.js";
+import"./index-9mt4smfy.js";
 import {
   ApplicationScript
-} from "./index-qtfmtcrw.js";
+} from "./index-h6czey01.js";
 import"./index-7md2g9vw.js";
-import"./index-cpb3nvma.js";
+import"./index-jrmzcp66.js";
 import {
   getNpmRegistryUrl,
   CloudRunner
-} from "./index-fyq1z6kt.js";
+} from "./index-rc51f9ht.js";
 import"./index-tvehn2sp.js";
 import {
   PackageScript
-} from "./index-j237xtew.js";
-import"./index-35hc95h5.js";
-import"./index-665zp9rs.js";
+} from "./index-ebarbgba.js";
+import"./index-xsd96yzw.js";
+import"./index-nx64dz92.js";
 
 // pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
 import { mkdir, rm } from "fs/promises";

package/{module.command-gs2r615e.js → module.command-10x6jv6c.js}

@@ -3,16 +3,16 @@ import {
   Sys,
   Module,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import {
   renderPrimitiveReport
-} from "./index-trpasv9q.js";
-import"./index-86jt2a0e.js";
+} from "./index-033wne2j.js";
+import"./index-27y8t17p.js";
 import {
   ModuleScript
-} from "./index-fmzcs8v6.js";
+} from "./index-p2r64bpa.js";
 
 // pkgs/@akanjs/cli/module/module.command.ts
 import { Logger, lowerlize } from "akanjs/common";

package/{package.command-j10r76ax.js → package.command-pwfvecjf.js}

@@ -3,13 +3,13 @@ import {
   Pkg,
   Workspace,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import"./index-tvehn2sp.js";
 import {
   PackageScript
-} from "./index-j237xtew.js";
+} from "./index-ebarbgba.js";
 
 // pkgs/@akanjs/cli/package/package.command.ts
 class PackageCommand extends command("package", [PackageScript], ({ public: target }) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.1.0-rc.20",
+  "version": "3.1.0-rc.21",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "@earendil-works/pi-tui": "1.3.0",
     "@inquirer/prompts": "^8.7.3",
     "@tailwindcss/node": "^4.3.3",
-    "akanjs": "3.1.0-rc.20",
+    "akanjs": "3.1.0-rc.21",
     "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "dayjs": "^1.11.23",

package/{page.command-4h4a8pnh.js → page.command-ahhgx9y1.js}

@@ -3,12 +3,12 @@ import {
   App,
   Module,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import {
   PageScript
-} from "./index-86jt2a0e.js";
+} from "./index-27y8t17p.js";
 
 // pkgs/@akanjs/cli/page/page.command.ts
 class PageCommand extends command("page", [PageScript], ({ public: target }) => ({

package/{pipeline.command-a2nrk26m.js → pipeline.command-1ptr3e9y.js}

@@ -4,7 +4,7 @@ import {
   runner,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";
@@ -12,7 +12,7 @@ import {
   AkanAppConfig,
   AkanWorkspaceConfig,
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   resolveMobileTargets
 } from "./index-m9jj544v.js";

package/{primitive.command-w6t0asqz.js → primitive.command-g5xwv6tj.js}

@@ -2,17 +2,17 @@
 import {
   Workspace,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import {
   renderPrimitiveReport
-} from "./index-trpasv9q.js";
-import"./index-86jt2a0e.js";
-import"./index-fmzcs8v6.js";
+} from "./index-033wne2j.js";
+import"./index-27y8t17p.js";
+import"./index-p2r64bpa.js";
 import {
   PrimitiveScript
-} from "./index-awbdfcf2.js";
+} from "./index-4393nb4b.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.command.ts
 import { Logger } from "akanjs/common";

package/{projectTypecheck-f534enqj.js → projectTypecheck-fx8x7cat.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ProjectTypecheck2
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 export {
   ProjectTypecheck2 as ProjectTypecheck
 };

package/{quality.command-77x7vbbx.js → quality.command-fw9ck061.js}

@@ -3,7 +3,7 @@ import {
   Workspace,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
 import {
   rootAllowedFiles,
@@ -12,7 +12,7 @@ import {
   libFacetRootHintOf,
   facetIndexShadowOf,
   rootEntryHintOf
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 
 // pkgs/@akanjs/devkit/qualityScanner.ts
 import { createHash } from "crypto";

package/{repair.command-y6sstev7.js → repair.command-g8kecj96.js}

@@ -3,15 +3,15 @@ import {
   Workspace,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import"./index-hj6w4ka1.js";
-import"./index-trpasv9q.js";
-import"./index-5edzv8fn.js";
+import"./index-033wne2j.js";
+import"./index-nv79n88g.js";
 import {
   RepairRunner
-} from "./index-j4mkhz93.js";
+} from "./index-pg1t468s.js";
 
 // pkgs/@akanjs/cli/repair/repair.script.ts
 import { Logger } from "akanjs/common";

package/{scalar.command-20b8cy0k.js → scalar.command-fprap51w.js}

@@ -2,15 +2,15 @@
 import {
   Sys,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
-import"./index-va06nr10.js";
+import"./index-g6ax17x4.js";
 import {
   renderPrimitiveReport
-} from "./index-trpasv9q.js";
+} from "./index-033wne2j.js";
 import {
   ScalarScript
-} from "./index-1p98exm2.js";
+} from "./index-g9ks2k8c.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.command.ts
 import { Logger, lowerlize } from "akanjs/common";

package/{subspace.command-baz73jpk.js → subspace.command-sc0t527y.js}

@@ -5,7 +5,7 @@ import {
   runner,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";
@@ -14,20 +14,20 @@ import {
   Executor,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   GlobalConfig
-} from "./index-cpb3nvma.js";
+} from "./index-jrmzcp66.js";
 import"./index-m9jj544v.js";
-import"./index-g1mbppa9.js";
-import"./index-192ha4xh.js";
+import"./index-35m6bzm7.js";
+import"./index-h3r3nr9y.js";
 import {
   SubspaceConfig
 } from "./index-4pf8g7ff.js";
 import {
   SlicePlanner
-} from "./index-35hc95h5.js";
-import"./index-665zp9rs.js";
+} from "./index-xsd96yzw.js";
+import"./index-nx64dz92.js";
 
 // pkgs/@akanjs/devkit/subspace.ts
 import { mkdir as mkdir2 } from "fs/promises";
@@ -825,7 +825,7 @@ class SubspaceRunner extends runner("subspace") {
     if (!asked)
       return { name: subspace.name, workspaceId, host, apps, libs: [], outcome: "cancelled", files: [] };
     const { libs } = await subspace.slice();
-    const { CloudScript } = await import("./cloud.script-1xt3tnts.js");
+    const { CloudScript } = await import("./cloud.script-krzh3d7k.js");
     const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
       host,
       workspaceId,

package/templates/migration/__migrationId__.ts

@@ -0,0 +1,23 @@
+import type { AppInfo, LibInfo } from "akanjs";
+
+interface Dict {
+  migrationId: string;
+  title: string;
+}
+export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
+  return `import { migration } from "akanjs/server";
+
+export default migration(${JSON.stringify(dict.title)})
+  .plan(async ({ table }) => {
+    // TODO: count the rows apply changes, and list each decision a person approves
+    return { summary: {}, items: [] };
+  })
+  .apply(async ({ table }, { items }) => {
+    // TODO: write through table(refName), so every change is logged and a rollback can undo it
+  })
+  .verify(async ({ table }) => {
+    // TODO: one line per row apply left wrong; none means the data is as intended
+    return [];
+  });
+`;
+}

package/templates/server.ts

@@ -6,7 +6,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [
   const databaseModules = [...scanInfo.database.entries()].filter(([_, files]) => files.has("service"));
   const serviceModules = [...scanInfo.service.entries()].filter(([_, files]) => files.has("service"));
   const scalarModules = [...scanInfo.scalar.entries()];
-  return `import { ${scanInfo.type === "app" ? "AkanServer, " : ""}AkanLib } from "akanjs/server";
+  return `import { ${scanInfo.type === "app" ? "AkanServer, " : ""}AkanLib${scanInfo.type === "app" ? ", Migrations" : ""} } from "akanjs/server";
 import * as cnst from "./lib/cnst";
 import * as db from "./lib/db";
 import * as sig from "./lib/sig";
@@ -29,6 +29,13 @@ ${scalarModules.map(([model]) => `    { constant: cnst.${model}, database: db.${
 });
 
 ${scanInfo.type === "app" ? `export const server = new AkanServer("${scanInfo.name}", env, undefined${libs.length ? `, ${libs.join(", ")}` : ""}, lib);` : ""}
+${
+  scanInfo.type === "app"
+    ? `export const migrations = new Migrations([
+${scanInfo.migrations.map(({ id, checksum }) => `  { id: "${id}", checksum: "${checksum}", load: () => import("./script/migration/${id}") },`).join("\n")}
+]);`
+    : ""
+}
 
 ${scanInfo.type === "lib" ? `export { env } from "./env/env.server.testing";` : ""}
 export * as db from "./lib/db";

package/{tunnel.command-2kw8vt9g.js → tunnel.command-mqnsqbwf.js}

@@ -4,25 +4,25 @@ import {
   runner,
   script,
   command
-} from "./index-jw1zm273.js";
+} from "./index-vkb9m4z7.js";
 import"./index-52w0fvh8.js";
 import {
   AppExecutor
-} from "./index-va06nr10.js";
+} from "./index-g6ax17x4.js";
 import {
   GlobalConfig,
   CloudApi
-} from "./index-cpb3nvma.js";
+} from "./index-jrmzcp66.js";
 import"./index-m9jj544v.js";
-import"./index-g1mbppa9.js";
-import"./index-192ha4xh.js";
+import"./index-35m6bzm7.js";
+import"./index-h3r3nr9y.js";
 import {
   TunnelShare2
-} from "./index-qwa5k1j8.js";
+} from "./index-48edp6q4.js";
 import {
   writeClipboard
 } from "./index-p6pbz9n5.js";
-import"./index-665zp9rs.js";
+import"./index-nx64dz92.js";
 
 // pkgs/@akanjs/cli/tunnel/tunnel.script.ts
 import { select } from "@inquirer/prompts";