@akanjs/cli 3.0.0-beta.2 → 3.0.0-beta.20

package/{index-mak3cd28.js → index-w2zdcw3k.js}

@@ -1,7 +1,8 @@
 // @bun
 import {
-  FileSys
-} from "./index-q0y2jq9j.js";
+  getDirname2,
+  FileSys2
+} from "./index-5b6tavv3.js";
 import {
   Executor,
   WorkspaceExecutor,
@@ -9,10 +10,10 @@ import {
   LibExecutor,
   PkgExecutor,
   ModuleExecutor
-} from "./index-2tv3fdx4.js";
-import {
-  getDirname2
-} from "./index-6wwzs1bc.js";
+} from "./index-9d9bgcx4.js";
+
+// pkgs/@akanjs/devkit/commandDecorators/camelToKebabCase.ts
+var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
 
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
 var COMMAND_META = Symbol("akan.command.meta");
@@ -22,7 +23,6 @@ var getTargetMetas = (command) => {
     throw new Error(`TargetMeta is not defined for ${command.name}`);
   return [...targetMetaMap.values()];
 };
-var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
 var getTargetCommandNames = (targetMeta) => {
   const kebabKey = camelToKebabCase(targetMeta.key);
   if (targetMeta.targetOption.short !== true)
@@ -59,30 +59,6 @@ var Pkg = createInternalArgToken("Pkg");
 var Module = createInternalArgToken("Module");
 var Workspace = createInternalArgToken("Workspace");
 
-// pkgs/@akanjs/devkit/commandDecorators/command.ts
-import path2 from "path";
-import { Logger } from "akanjs/common";
-import chalk2 from "chalk";
-import { program } from "commander";
-
-// pkgs/@akanjs/devkit/appSelectionMemory.ts
-import path from "path";
-class AppSelectionMemory {
-  static pathIn(workspaceRoot) {
-    return path.join(workspaceRoot, "local", ".akan", "lastStart.json");
-  }
-  static async read(workspaceRoot) {
-    const stored = await Bun.file(AppSelectionMemory.pathIn(workspaceRoot)).json().catch(() => null);
-    const apps = stored?.apps;
-    return Array.isArray(apps) ? apps.filter((name) => typeof name === "string") : [];
-  }
-  static async write(workspaceRoot, apps) {
-    await FileSys.writeJson(AppSelectionMemory.pathIn(workspaceRoot), { apps }).catch(() => {
-      return;
-    });
-  }
-}
-
 // pkgs/@akanjs/devkit/commandDecorators/dependencyBuilder.ts
 var capitalize = (value) => value.slice(0, 1).toUpperCase() + value.slice(1);
 var createDependencyKey = (refName, kind) => `${refName}${capitalize(kind)}`;
@@ -160,20 +136,38 @@ var script = (refName, deps = []) => {
   return ScriptBase;
 };
 
+// pkgs/@akanjs/devkit/commandDecorators/command.ts
+import path2 from "path";
+import { Logger } from "akanjs/common";
+import chalk2 from "chalk";
+import { program } from "commander";
+
+// pkgs/@akanjs/devkit/appSelectionMemory.ts
+import path from "path";
+class AppSelectionMemory {
+  static pathIn(workspaceRoot) {
+    return path.join(workspaceRoot, "local", ".akan", "lastStart.json");
+  }
+  static async read(workspaceRoot) {
+    const stored = await Bun.file(AppSelectionMemory.pathIn(workspaceRoot)).json().catch(() => null);
+    const apps = stored?.apps;
+    return Array.isArray(apps) ? apps.filter((name) => typeof name === "string") : [];
+  }
+  static async write(workspaceRoot, apps) {
+    await FileSys2.writeJson(AppSelectionMemory.pathIn(workspaceRoot), { apps }).catch(() => {
+      return;
+    });
+  }
+}
+
 // pkgs/@akanjs/devkit/commandDecorators/helpFormatter.ts
 import chalk from "chalk";
-var camelToKebabCase2 = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
 var formatChoice = (choice) => typeof choice === "object" ? choice.label : choice.toString();
 var groupCommands = (commands) => {
   const groups = new Map;
   for (const command of commands) {
-    const className = command.name.replace("Command", "");
-    const groupName = className;
-    if (!groups.has(groupName)) {
-      groups.set(groupName, { name: groupName, commands: [] });
-    }
-    const targetMetas = getTargetMetas(command);
-    for (const targetMeta of targetMetas) {
+    const group = groups.getOrInsert(command.name.replace("Command", ""), []);
+    for (const targetMeta of getTargetMetas(command)) {
       if (targetMeta.targetOption.devOnly)
         continue;
       const [allArgMetas] = getArgMetas(command, targetMeta.key);
@@ -182,119 +176,72 @@ var groupCommands = (commands) => {
           return "";
         if (arg.type === "Module")
           return "[sys:module]";
-        if (arg.type === "Argument") {
+        if (arg.type === "Argument")
           return `[${arg.name}]`;
-        }
         return `[${arg.type.toLowerCase()}]`;
       }).filter(Boolean);
-      const group = groups.get(groupName);
-      if (group) {
-        group.commands.push({
-          key: camelToKebabCase2(targetMeta.key),
-          args,
-          desc: targetMeta.targetOption.desc
-        });
-      }
+      group.push({ key: camelToKebabCase(targetMeta.key), args, desc: targetMeta.targetOption.desc });
     }
   }
   return groups;
 };
 var formatHelp = (commands, version) => {
-  const groups = groupCommands(commands);
-  const lines = [];
-  lines.push("");
-  lines.push(chalk.bold.cyan("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
-  lines.push(chalk.bold.cyan("  \u2551") + chalk.bold.white("              Akan.js Framework CLI            ") + chalk.bold.cyan("    \u2551"));
-  lines.push(chalk.bold.cyan("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
-  lines.push("");
-  lines.push(chalk.gray(`  Version: ${version}`));
-  lines.push("");
-  lines.push(chalk.bold.yellow("  USAGE"));
-  lines.push("");
-  lines.push(chalk.gray("    $ ") + chalk.white("akan") + chalk.gray(" <command> [options]"));
-  lines.push("");
-  lines.push(chalk.bold.yellow("  COMMANDS"));
-  lines.push("");
-  for (const [groupName, group] of groups) {
-    if (group.commands.length === 0)
+  const lines = [
+    "",
+    chalk.bold.cyan("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"),
+    chalk.bold.cyan("  \u2551") + chalk.bold.white("              Akan.js Framework CLI            ") + chalk.bold.cyan("    \u2551"),
+    chalk.bold.cyan("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"),
+    "",
+    chalk.gray(`  Version: ${version}`),
+    "",
+    chalk.bold.yellow("  USAGE"),
+    "",
+    chalk.gray("    $ ") + chalk.white("akan") + chalk.gray(" <command> [options]"),
+    "",
+    chalk.bold.yellow("  COMMANDS"),
+    ""
+  ];
+  for (const [groupName, cmds] of groupCommands(commands)) {
+    if (cmds.length === 0)
       continue;
-    lines.push(chalk.bold.magenta(`    ${groupName}`));
-    lines.push("");
-    for (const cmd of group.commands) {
-      const cmdName = chalk.green(cmd.key);
-      const cmdArgs = cmd.args.length > 0 ? chalk.gray(` ${cmd.args.join(" ")}`) : "";
-      if (cmd.desc) {
-        const maxLineLength = 70;
-        const cmdPrefix = `      ${cmdName}${cmdArgs}`;
-        const indent = "        ";
-        if (cmdPrefix.length + cmd.desc.length + 3 < maxLineLength) {
-          lines.push(`${cmdPrefix}  ${chalk.gray(cmd.desc)}`);
-        } else {
-          lines.push(cmdPrefix);
-          lines.push(`${indent}${chalk.gray(cmd.desc)}`);
-        }
-      } else {
-        lines.push(`      ${cmdName}${cmdArgs}`);
-      }
+    lines.push(chalk.bold.magenta(`    ${groupName}`), "");
+    for (const cmd of cmds) {
+      const cmdPrefix = `      ${chalk.green(cmd.key)}${cmd.args.length > 0 ? chalk.gray(` ${cmd.args.join(" ")}`) : ""}`;
+      if (!cmd.desc)
+        lines.push(cmdPrefix);
+      else if (cmdPrefix.length + cmd.desc.length + 3 < 70)
+        lines.push(`${cmdPrefix}  ${chalk.gray(cmd.desc)}`);
+      else
+        lines.push(cmdPrefix, `        ${chalk.gray(cmd.desc)}`);
     }
     lines.push("");
   }
-  lines.push(chalk.bold.yellow("  OPTIONS"));
-  lines.push("");
-  lines.push(`      ${chalk.green("-v, --verbose")}      ${chalk.gray("Enable verbose output")}`);
-  lines.push(`      ${chalk.green("-h, --help")}         ${chalk.gray("Display this help message")}`);
-  lines.push(`      ${chalk.green("-V, --version")}      ${chalk.gray("Output version number")}`);
-  lines.push("");
-  lines.push(chalk.bold.yellow("  EXAMPLES"));
-  lines.push("");
-  lines.push(chalk.gray("    # Create a new workspace"));
-  lines.push(chalk.white("    $ akan create-workspace myproject"));
-  lines.push("");
-  lines.push(chalk.gray("    # Start development server"));
-  lines.push(chalk.white("    $ akan start myapp"));
-  lines.push("");
-  lines.push(chalk.gray("    # Create a new module"));
-  lines.push(chalk.white("    $ akan create-module userProfile"));
-  lines.push("");
-  lines.push(chalk.gray("  Documentation: ") + chalk.cyan("https://akanjs.com/docs"));
-  lines.push(chalk.gray("  Report issues: ") + chalk.cyan("https://github.com/akan-team/akanjs/issues"));
-  lines.push("");
+  lines.push(chalk.bold.yellow("  OPTIONS"), "", `      ${chalk.green("-v, --verbose")}      ${chalk.gray("Enable verbose output")}`, `      ${chalk.green("-h, --help")}         ${chalk.gray("Display this help message")}`, `      ${chalk.green("-V, --version")}      ${chalk.gray("Output version number")}`, "", chalk.bold.yellow("  EXAMPLES"), "", chalk.gray("    # Create a new workspace"), chalk.white("    $ akan create-workspace myproject"), "", chalk.gray("    # Start development server"), chalk.white("    $ akan start myapp"), "", chalk.gray("    # Create a new module"), chalk.white("    $ akan create-module userProfile"), "", chalk.gray("  Documentation: ") + chalk.cyan("https://akanjs.com/docs"), chalk.gray("  Report issues: ") + chalk.cyan("https://github.com/akan-team/akanjs/issues"), "");
   return lines.join(`
 `);
 };
 var formatCommandHelp = (command, key) => {
-  const [allArgMetas, argMetas] = getArgMetas(command, key);
-  const kebabKey = camelToKebabCase2(key);
-  const lines = [];
-  const targetMetas = getTargetMetas(command);
-  const targetMeta = targetMetas.find((t) => t.key === key);
-  const commandDesc = targetMeta?.targetOption.desc;
-  lines.push("");
-  lines.push(chalk.bold.cyan(`  Command: ${kebabKey}`));
-  if (commandDesc) {
-    lines.push(chalk.gray(`  ${commandDesc}`));
-  }
-  lines.push("");
-  const args = allArgMetas.filter((arg) => arg.type !== "Option").map((arg) => {
+  const [allArgMetas, optionArgs] = getArgMetas(command, key);
+  const kebabKey = camelToKebabCase(key);
+  const commandDesc = getTargetMetas(command).find((t) => t.key === key)?.targetOption.desc;
+  const nonOptionArgs = allArgMetas.filter((arg) => arg.type !== "Option");
+  const args = nonOptionArgs.map((arg) => {
     if (arg.type === "Workspace")
       return "";
     if (arg.type === "Module")
       return "[sys:module]";
     if (arg.type === "Apps")
       return "[apps...]";
-    if (arg.type === "Argument") {
-      return `[${camelToKebabCase2(arg.name)}]`;
-    }
+    if (arg.type === "Argument")
+      return `[${camelToKebabCase(arg.name)}]`;
     return `[${arg.type.toLowerCase()}]`;
   }).filter(Boolean).join(" ");
-  lines.push(chalk.bold.yellow("  USAGE"));
-  lines.push("");
-  lines.push(chalk.gray("    $ ") + chalk.white(`akan ${kebabKey}`) + (args ? chalk.gray(` ${args}`) : ""));
-  lines.push("");
-  const nonOptionArgs = allArgMetas.filter((arg) => arg.type !== "Option");
+  const lines = ["", chalk.bold.cyan(`  Command: ${kebabKey}`)];
+  if (commandDesc)
+    lines.push(chalk.gray(`  ${commandDesc}`));
+  lines.push("", chalk.bold.yellow("  USAGE"), "", chalk.gray("    $ ") + chalk.white(`akan ${kebabKey}`) + (args ? chalk.gray(` ${args}`) : ""), "");
   if (nonOptionArgs.length > 0) {
-    lines.push(chalk.bold.yellow("  ARGUMENTS"));
-    lines.push("");
+    lines.push(chalk.bold.yellow("  ARGUMENTS"), "");
     for (const arg of nonOptionArgs) {
       if (arg.type === "Workspace")
         continue;
@@ -302,7 +249,7 @@ var formatCommandHelp = (command, key) => {
       let argDesc;
       let example = "";
       if (arg.type === "Argument") {
-        argName = camelToKebabCase2(arg.name);
+        argName = camelToKebabCase(arg.name);
         argDesc = arg.argsOption.desc ?? "";
         example = arg.argsOption.example ? chalk.gray(` (e.g., ${String(arg.argsOption.example)})`) : "";
       } else if (arg.type === "Module") {
@@ -319,15 +266,14 @@ var formatCommandHelp = (command, key) => {
     }
     lines.push("");
   }
-  const optionArgs = argMetas.filter((a) => a.type === "Option");
   if (optionArgs.length > 0) {
-    lines.push(chalk.bold.yellow("  OPTIONS"));
-    lines.push("");
+    lines.push(chalk.bold.yellow("  OPTIONS"), "");
     for (const arg of optionArgs) {
       const opt = arg.argsOption;
       const flag = opt.flag ? `-${opt.flag}, ` : "";
-      const kebabName = camelToKebabCase2(arg.name);
-      const optName = `${flag}--${kebabName}`;
+      const kebabName = camelToKebabCase(arg.name);
+      const negation = opt.type === "boolean" && opt.default === true ? `, --no-${kebabName}` : "";
+      const optName = `${flag}--${kebabName}${negation}`;
       const optDesc = opt.desc ?? "";
       const defaultVal = opt.default !== undefined ? chalk.gray(` [default: ${String(opt.default)}]`) : "";
       const choices = opt.enum ? chalk.gray(typeof opt.enum === "function" ? " ([dynamic choices])" : ` (${opt.enum.map(formatChoice).join(", ")})`) : "";
@@ -340,7 +286,6 @@ var formatCommandHelp = (command, key) => {
 };
 
 // pkgs/@akanjs/devkit/commandDecorators/command.ts
-var camelToKebabCase3 = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
 var loggedCliErrorObjects = new WeakSet;
 var loggedCliErrorMessages = new Set;
 var formatCliError = (error) => {
@@ -381,13 +326,15 @@ var handleOption = (programCommand, argMeta) => {
     enum: enumChoices,
     ask
   } = argMeta.argsOption;
-  const kebabName = camelToKebabCase3(argMeta.name);
+  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(", ")})` : ""}`);
+  if (type === "boolean" && argMeta.argsOption.default === true)
+    programCommand.option(`--no-${kebabName}`, `turn off --${kebabName}`);
   return programCommand;
 };
 var handleArgument = (programCommand, argMeta) => {
-  const kebabName = camelToKebabCase3(argMeta.name);
+  const kebabName = camelToKebabCase(argMeta.name);
   programCommand.argument(`[${kebabName}]`, `${argMeta.argsOption.desc}${argMeta.argsOption.example ? ` (example: ${argMeta.argsOption.example})` : ""}`);
   return programCommand;
 };
@@ -412,21 +359,14 @@ var assertEnumChoice = (argMeta, value) => {
   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}'`;
+  const label = argMeta.type === "Option" ? `option '--${camelToKebabCase(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)
-    return null;
-  if (typeof enumChoices === "function")
-    return await enumChoices(context);
-  return enumChoices;
-};
+var inputMessageOf = ({ name, argsOption: { desc, example, ask } }) => ask ? `${ask}: ` : desc ? `${desc}: ` : `Enter the ${name} value${example ? ` (example: ${example})` : ""}: `;
 var getOptionValue = async (argMeta, opt, context) => {
   const {
     name,
-    argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, example, ask }
+    argsOption: { enum: enumChoices, default: defaultValue, type, desc, nullable, ask }
   } = argMeta;
   if (opt[argMeta.name] !== undefined) {
     assertEnumChoice(argMeta, opt[argMeta.name]);
@@ -434,29 +374,20 @@ var getOptionValue = async (argMeta, opt, context) => {
   } else if (defaultValue !== undefined)
     return defaultValue;
   if (enumChoices) {
-    const choices = normalizeEnumChoices(await resolveEnumChoices(argMeta, context) ?? []);
+    const choices = normalizeEnumChoices((typeof enumChoices === "function" ? await enumChoices(context) : enumChoices) ?? []);
     if (choices.length === 1)
       return choices[0]?.value;
-    const choice = await select({ message: ask ?? desc ?? `Select the ${name} value`, choices });
-    return choice;
+    return await select({ message: ask ?? desc ?? `Select the ${name} value`, choices });
   } else if (nullable)
     return null;
   else if (type === "boolean") {
     const message = ask ?? desc ?? `Do you want to set ${name}? ${desc ? ` (${desc})` : ""}: `;
     return await confirm({ message });
-  } else {
-    const message = ask ? `${ask}: ` : desc ? `${desc}: ` : `Enter the ${name} value${example ? ` (example: ${example})` : ""}: `;
-    if (argMeta.argsOption.nullable)
-      return await input({ message });
-    else
-      return convertArgValue(await input({ message }), type ?? "string");
-  }
+  } else
+    return convertArgValue(await input({ message: inputMessageOf(argMeta) }), type ?? "string");
 };
 var getArgumentValue = async (argMeta, value) => {
-  const {
-    name,
-    argsOption: { default: defaultValue, type, desc, nullable, example, ask }
-  } = argMeta;
+  const { default: defaultValue, type, nullable } = argMeta.argsOption;
   if (value !== undefined) {
     assertEnumChoice(argMeta, value);
     return convertArgValue(value, type ?? "string");
@@ -464,8 +395,7 @@ var getArgumentValue = async (argMeta, value) => {
     return defaultValue;
   else if (nullable)
     return null;
-  const message = ask ? `${ask}: ` : desc ? `${desc}: ` : `Enter the ${name} value${example ? ` (example: ${example})` : ""}: `;
-  return convertArgValue(await input({ message }), type ?? "string");
+  return convertArgValue(await input({ message: inputMessageOf(argMeta) }), type ?? "string");
 };
 var assignCommandContext = (context, argMeta, value) => {
   if (value instanceof AppExecutor)
@@ -486,9 +416,9 @@ var assignCommandContext = (context, argMeta, value) => {
 var assertCurrentDirectoryIsWorkspaceRoot = async () => {
   const cwd = process.cwd();
   const [hasPackageJson, hasTsConfig, hasEnv] = await Promise.all([
-    FileSys.fileExists(`${cwd}/package.json`),
-    FileSys.fileExists(`${cwd}/tsconfig.json`),
-    FileSys.fileExists(`${cwd}/.env`)
+    FileSys2.fileExists(`${cwd}/package.json`),
+    FileSys2.fileExists(`${cwd}/tsconfig.json`),
+    FileSys2.fileExists(`${cwd}/.env`)
   ]);
   if (hasPackageJson && hasTsConfig && hasEnv)
     return;
@@ -529,44 +459,28 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     return workspace;
   const sysType = argMeta.type.toLowerCase();
   const [appNames, libNames, pkgNames] = await workspace.getExecs();
-  if (sysType === "sys") {
-    if (value && appNames.includes(value))
-      return AppExecutor.from(workspace, value);
-    else if (value && libNames.includes(value))
-      return LibExecutor.from(workspace, value);
-    else {
-      const sysName = await select({
-        message: `Select the App or Lib name`,
-        choices: [...appNames, ...libNames]
-      });
-      if (appNames.includes(sysName))
-        return AppExecutor.from(workspace, sysName);
-      else if (libNames.includes(sysName))
-        return LibExecutor.from(workspace, sysName);
-      else
-        throw new Error(`Invalid system name: ${sysName}`);
-    }
-  } else if (sysType === "exec") {
-    if (value && appNames.includes(value))
-      return AppExecutor.from(workspace, value);
-    else if (value && libNames.includes(value))
-      return LibExecutor.from(workspace, value);
-    else if (value && pkgNames.includes(value))
-      return PkgExecutor.from(workspace, value);
-    else {
-      const execName = await select({
-        message: `Select the App or Lib or Pkg name`,
-        choices: [...appNames, ...libNames, ...pkgNames]
-      });
-      if (appNames.includes(execName))
-        return AppExecutor.from(workspace, execName);
-      else if (libNames.includes(execName))
-        return LibExecutor.from(workspace, execName);
-      else if (pkgNames.includes(execName))
-        return PkgExecutor.from(workspace, execName);
-      else
-        throw new Error(`Invalid system name: ${execName}`);
-    }
+  if (sysType === "sys" || sysType === "exec") {
+    const pkgChoices = sysType === "exec" ? pkgNames : [];
+    const execOf = (name) => {
+      if (appNames.includes(name))
+        return AppExecutor.from(workspace, name);
+      if (libNames.includes(name))
+        return LibExecutor.from(workspace, name);
+      if (pkgChoices.includes(name))
+        return PkgExecutor.from(workspace, name);
+      return null;
+    };
+    const found = value ? execOf(value) : null;
+    if (found)
+      return found;
+    const name = await select({
+      message: sysType === "exec" ? `Select the App or Lib or Pkg name` : `Select the App or Lib name`,
+      choices: [...appNames, ...libNames, ...pkgChoices]
+    });
+    const picked = execOf(name);
+    if (!picked)
+      throw new Error(`Invalid system name: ${name}`);
+    return picked;
   } else if (sysType === "app") {
     if (value && appNames.includes(value))
       return AppExecutor.from(workspace, value);
@@ -631,9 +545,9 @@ var runCommands = async (...commands) => {
   const packageJsonCandidates = [`${path2.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
   let cliPackageJson = null;
   for (const packageJsonPath of packageJsonCandidates) {
-    if (!await FileSys.fileExists(packageJsonPath))
+    if (!await FileSys2.fileExists(packageJsonPath))
       continue;
-    const packageJson = await FileSys.readJson(packageJsonPath);
+    const packageJson = await FileSys2.readJson(packageJsonPath);
     if (packageJson.name === "@akanjs/cli" || packageJson.name === "@akanjs/devkit") {
       cliPackageJson = packageJson;
       break;
@@ -641,17 +555,14 @@ var runCommands = async (...commands) => {
   }
   process.env.AKAN_VERSION = cliPackageJson?.version ?? "0.0.1";
   const hasHelpFlag = process.argv.includes("--help") || process.argv.includes("-h");
-  const hasCommand = process.argv.length > 2 && !process.argv[2]?.startsWith("-");
-  if (hasHelpFlag || !hasCommand) {
-    if (process.argv.length === 2 || process.argv.length === 3 && hasHelpFlag) {
-      Logger.rawLog(formatHelp(commands, process.env.AKAN_VERSION));
-      process.exit(0);
-    }
+  if (process.argv.length === 2 || process.argv.length === 3 && hasHelpFlag) {
+    Logger.rawLog(formatHelp(commands, process.env.AKAN_VERSION));
+    process.exit(0);
   }
   program.version(process.env.AKAN_VERSION).description("Akan CLI").configureHelp({
     helpWidth: 100
   });
-  const installedAkanPackageJson = await FileSys.fileExists("./node_modules/akanjs/package.json") ? await FileSys.readJson("./node_modules/akanjs/package.json") : null;
+  const installedAkanPackageJson = await FileSys2.fileExists("./node_modules/akanjs/package.json") ? await FileSys2.readJson("./node_modules/akanjs/package.json") : null;
   if (installedAkanPackageJson && installedAkanPackageJson.version !== process.env.AKAN_VERSION) {
     Logger.rawLog(chalk2.yellow(`
 Akan CLI version is mismatch with installed package. ${process.env.AKAN_VERSION} (global) vs ${installedAkanPackageJson.version} (akanjs)
@@ -729,10 +640,15 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
       }
     }
   }
-  await program.parseAsync(process.argv);
+  await program.parseAsync(process.argv).catch((error) => {
+    printCliError(error);
+    process.exit(1);
+  });
 };
 
 // pkgs/@akanjs/devkit/commandDecorators/commandBuilder.ts
+var argMetaOf = (type, name, primitive, argsOption, idx) => ({ name, argsOption: { ...argsOption, type: normalizePrimitiveArgType(primitive) }, key: "", idx, type });
+
 class TargetBuilder {
   targetOption;
   #args;
@@ -740,39 +656,17 @@ class TargetBuilder {
     this.targetOption = targetOption;
     this.#args = args;
   }
+  #add(...argMetas) {
+    return new TargetBuilder(this.targetOption, [...this.#args, ...argMetas]);
+  }
   arg(name, type, argsOption = {}) {
-    return new TargetBuilder(this.targetOption, [
-      ...this.#args,
-      {
-        name,
-        argsOption: { ...argsOption, type: normalizePrimitiveArgType(type) },
-        key: "",
-        idx: this.#args.length,
-        type: "Argument"
-      }
-    ]);
+    return this.#add(argMetaOf("Argument", name, type, argsOption, this.#args.length));
   }
   option(name, type, argsOption = {}) {
-    return new TargetBuilder(this.targetOption, [
-      ...this.#args,
-      {
-        name,
-        argsOption: { ...argsOption, type: normalizePrimitiveArgType(type) },
-        key: "",
-        idx: this.#args.length,
-        type: "Option"
-      }
-    ]);
+    return this.#add(argMetaOf("Option", name, type, argsOption, this.#args.length));
   }
   with(...tokens) {
-    return new TargetBuilder(this.targetOption, [
-      ...this.#args,
-      ...tokens.map((token, offset) => ({
-        key: "",
-        idx: this.#args.length + offset,
-        type: token.type
-      }))
-    ]);
+    return this.#add(...tokens.map((token, offset) => ({ key: "", idx: this.#args.length + offset, type: token.type })));
   }
   exec(handler) {
     return {
@@ -787,20 +681,8 @@ var createContext = () => ({
   public: createTarget("public"),
   cloud: createTarget("cloud"),
   dev: createTarget("dev"),
-  arg: (name, type, argsOption) => ({
-    name,
-    argsOption: { ...argsOption ?? {}, type: normalizePrimitiveArgType(type) },
-    key: "",
-    idx: -1,
-    type: "Argument"
-  }),
-  option: (name, type, argsOption) => ({
-    name,
-    argsOption: { ...argsOption ?? {}, type: normalizePrimitiveArgType(type) },
-    key: "",
-    idx: -1,
-    type: "Option"
-  })
+  arg: (name, type, argsOption) => argMetaOf("Argument", name, type, argsOption, -1),
+  option: (name, type, argsOption) => argMetaOf("Option", name, type, argsOption, -1)
 });
 var buildCommandMeta = (definitions) => {
   const commandMeta = new Map;