@akanjs/cli 3.0.0-alpha.8 → 3.0.0-alpha.80

package/{index-5dw57f0d.js → index-f7wewj2v.js}

@@ -1,27 +1,28 @@
 // @bun
-import {
-  resolveMobileTargets
-} from "./index-76rn3g2c.js";
-import {
-  LibraryScript
-} from "./index-a1e0j63x.js";
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-ft1sfjz0.js";
+import {
+  WorkspaceExecutor,
+  AppExecutor,
+  LibExecutor,
+  PkgExecutor
+} from "./index-k1n0h7dk.js";
+import {
+  LibraryScript
+} from "./index-xxe90kqy.js";
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-bjpxzr6s.js";
+} from "./index-ctphds8v.js";
 import {
-  AppExecutor,
-  LibExecutor,
-  PkgExecutor,
-  WorkspaceExecutor
-} from "./index-vg0sj9nc.js";
+  SlicePlanner,
+  formatSlicePlan
+} from "./index-xnhf8tr9.js";
 import {
-  __require
-} from "./index-r24hmh0q.js";
+  resolveMobileTargets
+} from "./index-47pj3aee.js";
 
 // pkgs/@akanjs/devkit/applicationBuildReporter.ts
 import { Logger } from "akanjs/common";
@@ -72,9 +73,10 @@ Caused by: ${ApplicationBuildReporter.formatError(error.cause)}` : "";
 import { confirm } from "@inquirer/prompts";
 import { Logger as Logger5 } from "akanjs/common";
 
+// pkgs/@akanjs/cli/application/application.runner.ts
+import path5 from "path";
+
 // pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
-import { stat } from "fs/promises";
-import path2 from "path";
 import { Logger as Logger3 } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/sshTunnel.ts
@@ -350,7 +352,7 @@ class IncrementalBuilderHost {
       return false;
     this.#recycleRequested = true;
     this.#status = "recycling";
-    this.logger.info(`recycling builder pid=${proc.pid} (${reason})`);
+    this.logger.debug(`recycling builder pid=${proc.pid} (${reason})`);
     this.#recycleTimer = setTimeout(() => {
       this.#recycleTimer = null;
       if (this.#proc !== proc)
@@ -470,38 +472,23 @@ class BuilderRequestRouter {
   }
 }
 
-// pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
-var backendMsgTypeSet = new Set(["build-route", "build-csr"]);
-var BACKEND_RESTART_DEBOUNCE_MS = 120;
-var BACKEND_GRACEFUL_TIMEOUT_MS = 8000;
-var BACKEND_RECOVERY_BASE_DELAY_MS = 1000;
-var BACKEND_RECOVERY_MAX_DELAY_MS = 30000;
+// pkgs/@akanjs/devkit/akanApp/BackendImportGraph.ts
+import { stat } from "fs/promises";
+import path3 from "path";
+
+// pkgs/@akanjs/devkit/akanApp/devHostPolicy.ts
+import path2 from "path";
 var BACKEND_RECOVERY_MAX_ATTEMPTS = 5;
-var BACKEND_STDERR_TAIL_LIMIT = 40;
-var BUILDER_READY_TIMEOUT_MS = 150000;
-var BUILDER_START_MAX_ATTEMPTS = 3;
 var HELD_BUILDER_REQUEST_LIMIT = 64;
-var BUILDER_RSS_RECYCLE_QUIET_MS = 750;
 var BUILDER_MIN_RSS_RECYCLE_INTERVAL_MS = 30000;
 var BUILDER_TIGHT_RSS_REPORT_LIMIT = 2;
-var BUILDER_RSS_SETTLE_MS = 20000;
-var PS_RSS_TIMEOUT_MS = 2000;
 var BUILDER_RSS_HARD_MULTIPLE = 1.5;
 var DEV_IDLE_SUSPEND_MS = 300000;
 var DEV_IDLE_MIN_UPTIME_MS = 30000;
-var BUILDER_RECOVERY_BASE_DELAY_MS = 2000;
-var BUILDER_RECOVERY_MAX_DELAY_MS = 60000;
 var SOURCE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
-var NON_SOURCE_EXT_RE = /\.(css|scss|sass|less|json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav|html)$/i;
 var SERVER_SUFFIXES = [".service.ts", ".document.ts"];
 var SHARED_SUFFIXES = [".constant.ts", ".dictionary.ts", ".signal.ts"];
 var RUNTIME_METADATA_BASENAMES = new Set(["dict.ts", "sig.ts", "useClient.ts", "useServer.ts"]);
-var GRAPH_IMPORT_KINDS = new Set([
-  "import-statement",
-  "require-call",
-  "require-resolve",
-  "dynamic-import"
-]);
 var shouldRestartBackendByDevPlan = (message) => {
   if (!message.devPlan)
     return null;
@@ -682,6 +669,15 @@ var mergeInvalidateMessages = (current, next) => {
 var buildStatusReplaySequence = (pendingReplay, latestByPhase) => [...pendingReplay, ...latestByPhase.values()];
 var filesChangedSince = (before, after) => [...before].filter(([file, stamp]) => after.get(file) !== stamp).map(([file]) => file);
 
+// pkgs/@akanjs/devkit/akanApp/BackendImportGraph.ts
+var NON_SOURCE_EXT_RE = /\.(css|scss|sass|less|json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav|html)$/i;
+var GRAPH_IMPORT_KINDS = new Set([
+  "import-statement",
+  "require-call",
+  "require-resolve",
+  "dynamic-import"
+]);
+
 class BackendImportGraph {
   #app;
   #logger;
@@ -704,7 +700,7 @@ class BackendImportGraph {
     return this.#lastRefreshSucceeded;
   }
   has(file) {
-    return this.#files.has(path2.resolve(file));
+    return this.#files.has(path3.resolve(file));
   }
   async fingerprint() {
     const stamps = await Promise.all([...this.#files].map(async (file) => {
@@ -732,9 +728,9 @@ class BackendImportGraph {
     const roots = await this.#entrypoints();
     const files = new Set;
     const queue = [...roots];
-    const workspaceRoot = path2.resolve(this.#app.workspace.workspaceRoot);
+    const workspaceRoot = path3.resolve(this.#app.workspace.workspaceRoot);
     while (queue.length > 0) {
-      const current = path2.resolve(queue.pop());
+      const current = path3.resolve(queue.pop());
       if (files.has(current))
         continue;
       if (!this.#isWorkspaceSource(current, workspaceRoot))
@@ -743,7 +739,7 @@ class BackendImportGraph {
       if (!imports)
         continue;
       files.add(current);
-      const importerDir = path2.dirname(current);
+      const importerDir = path3.dirname(current);
       for (const imp of imports) {
         if (!GRAPH_IMPORT_KINDS.has(imp.kind) || !imp.path || NON_SOURCE_EXT_RE.test(imp.path))
           continue;
@@ -774,7 +770,7 @@ class BackendImportGraph {
     const roots = [`${this.#app.cwdPath}/main.ts`, `${this.#app.cwdPath}/server.ts`];
     const existing = [];
     for (const root of roots) {
-      const abs = path2.resolve(root);
+      const abs = path3.resolve(root);
       if (await Bun.file(abs).exists())
         existing.push(abs);
     }
@@ -783,25 +779,25 @@ class BackendImportGraph {
   #resolve(specifier, importerDir) {
     try {
       const resolved = Bun.resolveSync(specifier, importerDir);
-      if (!path2.isAbsolute(resolved))
+      if (!path3.isAbsolute(resolved))
         return null;
-      if (!SOURCE_EXTS.has(path2.extname(resolved).toLowerCase()))
+      if (!SOURCE_EXTS.has(path3.extname(resolved).toLowerCase()))
         return null;
-      return path2.resolve(resolved);
+      return path3.resolve(resolved);
     } catch {
       return null;
     }
   }
   #isWorkspaceSource(file, workspaceRoot) {
-    const rel = path2.relative(workspaceRoot, file);
-    if (rel.startsWith("..") || path2.isAbsolute(rel))
+    const rel = path3.relative(workspaceRoot, file);
+    if (rel.startsWith("..") || path3.isAbsolute(rel))
       return false;
-    if (rel.includes(`${path2.sep}node_modules${path2.sep}`) || rel.includes(`${path2.sep}.akan${path2.sep}`))
+    if (rel.includes(`${path3.sep}node_modules${path3.sep}`) || rel.includes(`${path3.sep}.akan${path3.sep}`))
       return false;
-    return SOURCE_EXTS.has(path2.extname(file).toLowerCase());
+    return SOURCE_EXTS.has(path3.extname(file).toLowerCase());
   }
   #scanImports(file, source) {
-    const ext = path2.extname(file).toLowerCase();
+    const ext = path3.extname(file).toLowerCase();
     if (ext === ".tsx")
       return this.#tsxTranspiler.scanImports(source);
     if (ext === ".jsx")
@@ -812,6 +808,21 @@ class BackendImportGraph {
   }
 }
 
+// pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
+var backendMsgTypeSet = new Set(["build-route", "build-csr"]);
+var BACKEND_RESTART_DEBOUNCE_MS = 120;
+var BACKEND_GRACEFUL_TIMEOUT_MS = 8000;
+var BACKEND_RECOVERY_BASE_DELAY_MS = 1000;
+var BACKEND_RECOVERY_MAX_DELAY_MS = 30000;
+var BACKEND_STDERR_TAIL_LIMIT = 40;
+var BUILDER_READY_TIMEOUT_MS = 150000;
+var BUILDER_START_MAX_ATTEMPTS = 3;
+var BUILDER_RSS_RECYCLE_QUIET_MS = 750;
+var BUILDER_RSS_SETTLE_MS = 20000;
+var PS_RSS_TIMEOUT_MS = 2000;
+var BUILDER_RECOVERY_BASE_DELAY_MS = 2000;
+var BUILDER_RECOVERY_MAX_DELAY_MS = 60000;
+
 class AkanAppHost {
   app;
   logger = new Logger3("AkanAppHost");
@@ -907,6 +918,7 @@ class AkanAppHost {
   }
   #startBackend(startStatus = null) {
     this.#builderRequests.startGeneration();
+    this.#discardPendingBuilderMessages("the backend restarted while the builder was away");
     this.#backendStartStatus = startStatus;
     this.#backendGaveUp = false;
     this.#setBackendLifecycleState("starting");
@@ -1498,6 +1510,12 @@ ${this.#backendStderrTail.join(`
     this.#pendingBuilderMessages.push(message);
     this.logger.verbose(`[builder] holding ${message.type} until the builder is ready (${this.#pendingBuilderMessages.length} waiting)`);
   }
+  #discardPendingBuilderMessages(reason) {
+    const held = this.#pendingBuilderMessages.splice(0);
+    if (held.length === 0)
+      return;
+    this.logger.verbose(`[builder] dropped ${held.length} held builder request(s): ${reason}`);
+  }
   #failPendingBuilderMessages(reason) {
     const held = this.#pendingBuilderMessages.splice(0);
     if (held.length === 0)
@@ -1858,20 +1876,20 @@ ${this.#backendStderrTail.join(`
   }
 }
 // pkgs/@akanjs/devkit/applicationTestPreload.ts
-import path3 from "path";
+import path4 from "path";
 var SIGNAL_TEST_PRELOAD_PATH = "test/signalTest.preload.ts";
 async function resolveSignalTestPreloadPath(target) {
   const candidates = [];
   const addResolvedPackageCandidate = (basePath) => {
     try {
-      candidates.push(path3.join(path3.dirname(Bun.resolveSync("akanjs/package.json", basePath)), SIGNAL_TEST_PRELOAD_PATH));
+      candidates.push(path4.join(path4.dirname(Bun.resolveSync("akanjs/package.json", basePath)), SIGNAL_TEST_PRELOAD_PATH));
     } catch {}
   };
   addResolvedPackageCandidate(target.cwdPath);
   addResolvedPackageCandidate(process.cwd());
-  addResolvedPackageCandidate(path3.dirname(Bun.main));
+  addResolvedPackageCandidate(path4.dirname(Bun.main));
   addResolvedPackageCandidate(import.meta.dir);
-  candidates.push(path3.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(path3.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH));
+  candidates.push(path4.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(path4.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH));
   const uniqueCandidates = [...new Set(candidates)];
   for (const candidate of uniqueCandidates) {
     if (await Bun.file(candidate).exists())
@@ -1898,10 +1916,10 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-ha3y8ew8.js")).ApplicationBuildRunner;
-var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-p0z5yab2.js")).CapacitorApp;
-var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-tavpx3fv.js")).ApplicationBuildRunner;
+var loadReleasePackager = async () => (await import("./applicationReleasePackager-ktjt0erc.js")).ApplicationReleasePackager;
+var loadCapacitorApp = async () => (await import("./capacitorApp-kwa67kzs.js")).CapacitorApp;
+var loadAbstractCompactor = async () => (await import("./abstractCompactor-pwc6d6yk.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -1914,8 +1932,11 @@ class ApplicationRunner extends runner("application") {
     });
     return AppExecutor.from(workspace, appName);
   }
+  async planSlice(app) {
+    return await new SlicePlanner(app).plan();
+  }
   async removeApplication(app) {
-    await app.workspace.exec(`rm -rf apps/${app.name}`);
+    await app.workspace.removeDir(`apps/${app.name}`);
   }
   async getConfig(app) {
     return await app.getConfig();
@@ -1945,10 +1966,69 @@ class ApplicationRunner extends runner("application") {
       stdio: "inherit"
     });
   }
+  #runtimeDirOf(app, override) {
+    return path5.resolve(override ?? process.env.AKAN_RUNTIME_DIR ?? path5.join(app.workspace.workspaceRoot, "local", "apps", app.name, "runtime"));
+  }
+  async runLogs(app, options) {
+    const { LogControlUnavailableError, LogTailClient } = await import("akanjs/server/logging/logTailClient");
+    const { LogQueryMatcher } = await import("akanjs/server/logging/logQuery");
+    const runtimeDir = this.#runtimeDirOf(app, options.runtimeDir);
+    const socketPath = LogTailClient.socketPath(runtimeDir);
+    const { level, grep, endpoint, trace, child, role, origin, since } = options;
+    const query = Object.fromEntries(Object.entries({ level, grep, endpoint, trace, child, role, origin, since }).filter(([, value]) => value !== undefined && value !== null && value !== ""));
+    const print = (record) => process.stdout.write(options.json ? `${JSON.stringify(record)}
+` : Logger4.render(record));
+    const note = (text) => process.stderr.write(`[akan logs] ${text}
+`);
+    let finish = null;
+    const closed = new Promise((resolve) => {
+      finish = resolve;
+    });
+    let client;
+    try {
+      client = await LogTailClient.connect(socketPath, {
+        onRecord: (entry) => print(entry.record),
+        onEvent: (response) => {
+          if (response.type === "dropped")
+            note(`${response.count} records dropped (reader too slow)`);
+        },
+        onClose: () => finish?.()
+      });
+    } catch (error) {
+      if (error instanceof LogControlUnavailableError)
+        throw new Error(`${app.name} is not running (no ${path5.basename(socketPath)} in ${runtimeDir}). Start it with \`akan start ${app.name}\`, or pass --runtime-dir for a built app.`);
+      throw error;
+    }
+    const sinceMs = since ? LogQueryMatcher.parseSince(since) : undefined;
+    const noteCoverage = (coverage) => {
+      if (sinceMs !== undefined && coverage.from !== null && sinceMs < coverage.from)
+        note(`${LogTailClient.describeCoverage(coverage)}; older records are not retained`);
+    };
+    if (endpoint)
+      note("requests served by the primitive query fast path carry no endpoint and are not shown");
+    if (options.follow === false) {
+      const { entries, coverage } = await client.history({
+        ...query,
+        ...options.replay ? { limit: options.replay } : {}
+      });
+      for (const entry of entries)
+        print(entry.record);
+      noteCoverage(coverage);
+      client.close();
+      return;
+    }
+    const subscribed = await client.subscribe(query, { replay: options.replay });
+    noteCoverage(subscribed.coverage);
+    const stop = () => client.close();
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    await closed;
+  }
   async runConsole(app) {
     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 runtimeDir = this.#runtimeDirOf(app);
     const code = `
 const serverModule = await import(${JSON.stringify(serverPath)});
 const { assertAkanConsoleAllowed, startAkanConsole } = await import("akanjs/server");
@@ -1958,6 +2038,7 @@ assertAkanConsoleAllowed(server.env);
 await server.start({ listen: false, web: false });
 try {
   await startAkanConsole(server, {
+    runtimeDir: ${JSON.stringify(runtimeDir)},
     globals: {
       srv: serverModule.srv,
       sig: serverModule.sig,
@@ -2329,6 +2410,12 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     await this.applicationRunner.removeApplication(app);
     spinner.succeed(`Application ${app.name} (apps/${app.name}) removed`);
   }
+  async planSlice(app, format = "text") {
+    const spinner = app.spinning("Planning distributable slice...");
+    const plan = await this.applicationRunner.planSlice(app);
+    spinner.succeed(`Slice planned (${plan.libs.length} libs, ${plan.warnings.length} warnings)`);
+    Logger5.rawLog(format === "json" ? JSON.stringify(plan, null, 2) : formatSlicePlan(plan));
+  }
   async sync(sys) {
     if (sys.type === "app")
       await sys.scanSync();
@@ -2355,6 +2442,9 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     await app.scanSync();
     await this.applicationRunner.runConsole(app);
   }
+  async logs(app, options) {
+    await this.applicationRunner.runLogs(app, options);
+  }
   async build(app, { write = true, fast = false, quiet = false } = {}) {
     await app.scanSync({ write });
     if (!quiet)
@@ -2388,8 +2478,8 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
   async test(exec, { write = true } = {}) {
     if (exec instanceof LibExecutor) {
       await this.libraryScript.syncLibrary(exec);
-      const spinner2 = exec.spinning(`Preparing ${exec.name}...`);
-      spinner2.succeed(`${exec.name} prepared`);
+      const spinner = exec.spinning(`Preparing ${exec.name}...`);
+      spinner.succeed(`${exec.name} prepared`);
       await this.applicationRunner.test(exec);
       return;
     }
@@ -2528,7 +2618,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     let stopping = false;
     process.on("SIGINT", () => {
       if (stopping) {
-        Logger5.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "warn");
+        Logger5.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "error");
         process.exit(130);
       }
       stopping = true;
@@ -2542,18 +2632,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     }), timeout]);
     if (result !== "timeout")
       return;
-    Logger5.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "warn");
-  }
-  async testSys(sys) {
-    if (sys.type === "app")
-      await this.testApplication(sys);
-    else
-      await this.libraryScript.testLibrary(sys);
-  }
-  async testApplication(app) {
-    const spinner = app.spinning("Testing application...");
-    await this.applicationRunner.test(app);
-    spinner.succeed(`Application ${app.name} (apps/${app.name}) test is successful`);
+    Logger5.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "error");
   }
 }
 

package/{index-6rhabeev.js → index-ft1sfjz0.js}

@@ -1,19 +1,18 @@
 // @bun
 import {
-  AppExecutor,
   Executor,
+  WorkspaceExecutor,
+  AppExecutor,
   LibExecutor,
-  ModuleExecutor,
   PkgExecutor,
-  WorkspaceExecutor,
-  getDirname
-} from "./index-vg0sj9nc.js";
+  ModuleExecutor
+} from "./index-k1n0h7dk.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-ayy5ecax.js";
 import {
-  __require
-} from "./index-r24hmh0q.js";
+  getDirname2
+} from "./index-6wwzs1bc.js";
 
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
 var COMMAND_META = Symbol("akan.command.meta");
@@ -381,6 +380,16 @@ var prompts = async () => await import("@inquirer/prompts");
 var select = (config, context) => prompts().then((m) => m.select(config, context));
 var confirm = (config, context) => prompts().then((m) => m.confirm(config, context));
 var input = (config, context) => prompts().then((m) => m.input(config, context));
+var assertEnumChoice = (argMeta, value) => {
+  const enumChoices = argMeta.argsOption.enum;
+  if (!enumChoices || typeof enumChoices === "function")
+    return;
+  const choices = normalizeEnumChoices(enumChoices);
+  if (choices.some((choice) => String(choice.value) === String(value)))
+    return;
+  const label = argMeta.type === "Option" ? `option '--${camelToKebabCase3(argMeta.name)}'` : `argument '${argMeta.name}'`;
+  throw new Error(`${label} argument '${String(value)}' is invalid. Allowed choices are ${choices.map((choice) => choice.name).join(", ")}.`);
+};
 var resolveEnumChoices = async (argMeta, context) => {
   const enumChoices = argMeta.argsOption.enum;
   if (!enumChoices)
@@ -394,9 +403,10 @@ var getOptionValue = async (argMeta, opt, context) => {
     name,
     argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, example, ask }
   } = argMeta;
-  if (opt[argMeta.name] !== undefined)
+  if (opt[argMeta.name] !== undefined) {
+    assertEnumChoice(argMeta, opt[argMeta.name]);
     return convertArgValue(opt[argMeta.name], type ?? "string");
-  else if (defaultValue !== undefined)
+  } else if (defaultValue !== undefined)
     return defaultValue;
   if (enumChoices) {
     const choices = normalizeEnumChoices(await resolveEnumChoices(argMeta, context) ?? []);
@@ -422,9 +432,10 @@ var getArgumentValue = async (argMeta, value) => {
     name,
     argsOption: { default: defaultValue, type, desc, nullable, example, ask }
   } = argMeta;
-  if (value !== undefined)
+  if (value !== undefined) {
+    assertEnumChoice(argMeta, value);
     return convertArgValue(value, type ?? "string");
-  else if (defaultValue !== undefined)
+  } else if (defaultValue !== undefined)
     return defaultValue;
   else if (nullable)
     return null;
@@ -526,36 +537,36 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     return PkgExecutor.from(workspace, pkgName);
   } else if (sysType === "module") {
     if (value) {
-      const [sysName, moduleName2] = value.split(":");
-      if (!sysName || !moduleName2)
+      const [sysName, moduleName] = value.split(":");
+      if (!sysName || !moduleName)
         throw new Error(`Invalid module name: ${value}`);
       if (appNames.includes(sysName)) {
         const app = AppExecutor.from(workspace, sysName);
-        const modules2 = await app.getModules();
-        if (modules2.includes(moduleName2))
-          return ModuleExecutor.from(app, moduleName2);
+        const modules = await app.getModules();
+        if (modules.includes(moduleName))
+          return ModuleExecutor.from(app, moduleName);
         else
-          throw new Error(`Invalid module name: ${moduleName2}`);
+          throw new Error(`Invalid module name: ${moduleName}`);
       } else if (libNames.includes(sysName)) {
         const lib = LibExecutor.from(workspace, sysName);
-        const modules2 = await lib.getModules();
-        if (modules2.includes(moduleName2))
-          return ModuleExecutor.from(lib, moduleName2);
+        const modules = await lib.getModules();
+        if (modules.includes(moduleName))
+          return ModuleExecutor.from(lib, moduleName);
       } else
         throw new Error(`Invalid system name: ${sysName}`);
     }
     const { type, name } = await select({
       message: `select the App or Lib name`,
       choices: [
-        ...appNames.map((name2) => ({ name: name2, value: { type: "app", name: name2 } })),
-        ...libNames.map((name2) => ({ name: name2, value: { type: "lib", name: name2 } }))
+        ...appNames.map((name) => ({ name, value: { type: "app", name } })),
+        ...libNames.map((name) => ({ name, value: { type: "lib", name } }))
       ]
     });
     const executor = type === "app" ? AppExecutor.from(workspace, name) : LibExecutor.from(workspace, name);
     const modules = await executor.getModules();
     const moduleName = await select({
       message: `Select the module name`,
-      choices: modules.map((name2) => ({ name: `${executor.name}:${name2}`, value: name2 }))
+      choices: modules.map((name) => ({ name: `${executor.name}:${name}`, value: name }))
     });
     return ModuleExecutor.from(executor, moduleName);
   } else
@@ -566,7 +577,7 @@ var runCommands = async (...commands) => {
     printCliError(error);
     process.exit(1);
   });
-  const __dirname2 = getDirname(import.meta.url);
+  const __dirname2 = getDirname2(import.meta.url);
   const packageJsonCandidates = [`${path.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
   let cliPackageJson = null;
   for (const packageJsonPath of packageJsonCandidates) {

package/{index-7myvn0f0.js → index-h7yw2z9n.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
-  getDirname
-} from "./index-vg0sj9nc.js";
+  getDirname2
+} from "./index-6wwzs1bc.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";
 import { input, select } from "@inquirer/prompts";
 class Prompter {
   static async#getGuidelineRoot() {
-    const dirname = getDirname(import.meta.url);
+    const dirname = getDirname2(import.meta.url);
     const candidates = [`${dirname}/guidelines`, `${dirname}/../cli/guidelines`];
     for (const candidate of candidates) {
       try {
@@ -19,7 +19,6 @@ class Prompter {
     return candidates[0];
   }
   static async selectGuideline() {
-    const guidelineRoot = await Prompter.#getGuidelineRoot();
     const guideNames = await Prompter.listGuidelines();
     return await select({
       message: "Select a guideline",
@@ -37,10 +36,11 @@ class Prompter {
     return JSON.parse(guideJson);
   }
   static async getInstruction(guideName) {
+    const guideNames = await Prompter.listGuidelines();
+    if (!guideNames.includes(guideName))
+      throw new Error(`Unknown guideline "${guideName}". Available: ${guideNames.join(", ")}`);
     const guidelineRoot = await Prompter.#getGuidelineRoot();
-    const filePath = `${guidelineRoot}/${guideName}/${guideName}.instruction.md`;
-    const content = await fsPromise.readFile(filePath, "utf-8");
-    return content;
+    return await fsPromise.readFile(`${guidelineRoot}/${guideName}/${guideName}.instruction.md`, "utf-8");
   }
   static async getUpdateRequest(guideName) {
     return await input({

package/{index-5pmx7bkg.js → index-j9vnq8tr.js}

@@ -1,32 +1,32 @@
 // @bun
 import {
-  AkanContextAnalyzer
-} from "./index-mssqn2sq.js";
-import {
-  WorkflowExecutor,
-  compactWorkflowInputs,
-  createDryRunWorkflowApplyReport,
+  jsonText,
+  workflowPlanApproval,
   createWorkflowApplyReport,
+  workflowCommandsForPlan,
+  writeWorkflowRunArtifact,
+  readWorkflowRunArtifact,
   createWorkflowBaselineSummary,
-  createWorkflowPlan,
   createWorkflowValidationRunReport,
-  getWorkflowSpec,
-  jsonText,
+  createDryRunWorkflowApplyReport,
+  WorkflowExecutor,
   listWorkflowSpecs,
-  readWorkflowRunArtifact,
-  renderWorkflowApply,
-  renderWorkflowExplain,
+  getWorkflowSpec,
+  compactWorkflowInputs,
+  createWorkflowPlan,
   renderWorkflowList,
+  renderWorkflowExplain,
   renderWorkflowPlan,
-  renderWorkflowRunArtifact,
+  renderWorkflowApply,
   renderWorkflowValidation,
-  workflowCommandsForPlan,
-  workflowPlanApproval,
-  writeWorkflowRunArtifact
-} from "./index-2c3e2xh8.js";
+  renderWorkflowRunArtifact
+} from "./index-saheq2bs.js";
+import {
+  AkanContextAnalyzer
+} from "./index-5y7qba1c.js";
 import {
   runner
-} from "./index-6rhabeev.js";
+} from "./index-ft1sfjz0.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";