@akanjs/cli 1.0.7 → 1.0.8

package/cjs/index.js

@@ -236,15 +236,15 @@ var Logger = class _Logger {
       console.log(`${processMsg} ${timestampMsg} ${logLevelMsg} ${contextMsg} ${contentMsg} ${timeDiffMsg}
 `);
   }
-  static rawLog(msg = "", method) {
+  static rawLog(msg = "", method, outputStream) {
     this.raw(`${msg}
-`, method);
+`, method, outputStream);
   }
-  static raw(msg = "", method) {
+  static raw(msg = "", method, outputStream) {
     if (typeof window === "undefined" && method !== "console" && global.process)
-      global.process.stdout.write(msg);
+      global.process[outputStream === "error" ? "stderr" : "stdout"].write(msg);
     else
-      console.log(msg.trim());
+      console[outputStream === "error" ? "error" : "log"](msg.trim());
   }
 };
 
@@ -3353,13 +3353,186 @@ var Target = {
   Dev: getTarget("dev")
 };
 
+// pkgs/@akanjs/devkit/src/commandDecorators/helpFormatter.ts
+var import_chalk4 = __toESM(require("chalk"));
+var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
+var groupCommands = (commands) => {
+  const groups = /* @__PURE__ */ 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) {
+      if (targetMeta.targetOption.devOnly)
+        continue;
+      const [allArgMetas] = getArgMetas(command, targetMeta.key);
+      const args = allArgMetas.filter((arg) => arg.type !== "Option").map((arg) => {
+        if (arg.type === "Workspace")
+          return "";
+        if (arg.type === "Module")
+          return "[sys:module]";
+        if (arg.type === "Argument") {
+          return `[${arg.name}]`;
+        }
+        return `[${arg.type.toLowerCase()}]`;
+      }).filter(Boolean);
+      const group = groups.get(groupName);
+      if (group) {
+        group.commands.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(import_chalk4.default.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(
+    import_chalk4.default.bold.cyan("  \u2551") + import_chalk4.default.bold.white("              Akan.js Framework CLI            ") + import_chalk4.default.bold.cyan("    \u2551")
+  );
+  lines.push(import_chalk4.default.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(import_chalk4.default.gray(`  Version: ${version}`));
+  lines.push("");
+  lines.push(import_chalk4.default.bold.yellow("  USAGE"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("    $ ") + import_chalk4.default.white("akan") + import_chalk4.default.gray(" <command> [options]"));
+  lines.push("");
+  lines.push(import_chalk4.default.bold.yellow("  COMMANDS"));
+  lines.push("");
+  for (const [groupName, group] of groups) {
+    if (group.commands.length === 0)
+      continue;
+    lines.push(import_chalk4.default.bold.magenta(`    ${groupName}`));
+    lines.push("");
+    for (const cmd of group.commands) {
+      const cmdName = import_chalk4.default.green(cmd.key);
+      const cmdArgs = cmd.args.length > 0 ? import_chalk4.default.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}  ${import_chalk4.default.gray(cmd.desc)}`);
+        } else {
+          lines.push(cmdPrefix);
+          lines.push(`${indent}${import_chalk4.default.gray(cmd.desc)}`);
+        }
+      } else {
+        lines.push(`      ${cmdName}${cmdArgs}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(import_chalk4.default.bold.yellow("  OPTIONS"));
+  lines.push("");
+  lines.push(`      ${import_chalk4.default.green("-v, --verbose")}      ${import_chalk4.default.gray("Enable verbose output")}`);
+  lines.push(`      ${import_chalk4.default.green("-h, --help")}         ${import_chalk4.default.gray("Display this help message")}`);
+  lines.push(`      ${import_chalk4.default.green("-V, --version")}      ${import_chalk4.default.gray("Output version number")}`);
+  lines.push("");
+  lines.push(import_chalk4.default.bold.yellow("  EXAMPLES"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("    # Create a new workspace"));
+  lines.push(import_chalk4.default.white("    $ akan create-workspace myproject"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("    # Start development server"));
+  lines.push(import_chalk4.default.white("    $ akan start myapp"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("    # Create a new module"));
+  lines.push(import_chalk4.default.white("    $ akan create-module userProfile"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("  Documentation: ") + import_chalk4.default.cyan("https://akanjs.com/docs"));
+  lines.push(import_chalk4.default.gray("  Report issues: ") + import_chalk4.default.cyan("https://github.com/akan-team/akanjs/issues"));
+  lines.push("");
+  return lines.join("\n");
+};
+var formatCommandHelp = (command, key) => {
+  const [allArgMetas, argMetas] = getArgMetas(command, key);
+  const kebabKey = camelToKebabCase(key);
+  const lines = [];
+  const targetMetas = getTargetMetas(command);
+  const targetMeta = targetMetas.find((t) => t.key === key);
+  const commandDesc = targetMeta?.targetOption.desc;
+  lines.push("");
+  lines.push(import_chalk4.default.bold.cyan(`  Command: ${kebabKey}`));
+  if (commandDesc) {
+    lines.push(import_chalk4.default.gray(`  ${commandDesc}`));
+  }
+  lines.push("");
+  const args = allArgMetas.filter((arg) => arg.type !== "Option").map((arg) => {
+    if (arg.type === "Workspace")
+      return "";
+    if (arg.type === "Module")
+      return "[sys:module]";
+    if (arg.type === "Argument") {
+      return `[${camelToKebabCase(arg.name)}]`;
+    }
+    return `[${arg.type.toLowerCase()}]`;
+  }).filter(Boolean).join(" ");
+  lines.push(import_chalk4.default.bold.yellow("  USAGE"));
+  lines.push("");
+  lines.push(import_chalk4.default.gray("    $ ") + import_chalk4.default.white(`akan ${kebabKey}`) + (args ? import_chalk4.default.gray(` ${args}`) : ""));
+  lines.push("");
+  const nonOptionArgs = allArgMetas.filter((arg) => arg.type !== "Option");
+  if (nonOptionArgs.length > 0) {
+    lines.push(import_chalk4.default.bold.yellow("  ARGUMENTS"));
+    lines.push("");
+    for (const arg of nonOptionArgs) {
+      if (arg.type === "Workspace")
+        continue;
+      let argName;
+      let argDesc;
+      let example = "";
+      if (arg.type === "Argument") {
+        argName = camelToKebabCase(arg.name);
+        argDesc = arg.argsOption.desc ?? "";
+        example = arg.argsOption.example ? import_chalk4.default.gray(` (e.g., ${String(arg.argsOption.example)})`) : "";
+      } else if (arg.type === "Module") {
+        argName = "sys:module";
+        argDesc = "Module in format: app-name:module-name or lib-name:module-name";
+      } else {
+        argName = arg.type.toLowerCase();
+        argDesc = `${arg.type} name in this workspace`;
+      }
+      lines.push(`      ${import_chalk4.default.green(argName)}      ${import_chalk4.default.gray(argDesc)}${example}`);
+    }
+    lines.push("");
+  }
+  const optionArgs = argMetas.filter((a) => a.type === "Option");
+  if (optionArgs.length > 0) {
+    lines.push(import_chalk4.default.bold.yellow("  OPTIONS"));
+    lines.push("");
+    for (const arg of optionArgs) {
+      const opt = arg.argsOption;
+      const flag = opt.flag ? `-${opt.flag}, ` : "";
+      const kebabName = camelToKebabCase(arg.name);
+      const optName = `${flag}--${kebabName}`;
+      const optDesc = opt.desc ?? "";
+      const defaultVal = opt.default !== void 0 ? import_chalk4.default.gray(` [default: ${String(opt.default)}]`) : "";
+      const choices = opt.enum ? import_chalk4.default.gray(` (${opt.enum.join(", ")})`) : "";
+      lines.push(`      ${import_chalk4.default.green(optName)}      ${import_chalk4.default.gray(optDesc)}${defaultVal}${choices}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+};
+
 // pkgs/@akanjs/devkit/src/commandDecorators/command.ts
 var import_prompts3 = require("@inquirer/prompts");
-var import_chalk4 = __toESM(require("chalk"));
+var import_chalk5 = __toESM(require("chalk"));
 var import_commander = require("commander");
 var import_fs8 = __toESM(require("fs"));
 var import_meta3 = {};
-var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
+var camelToKebabCase2 = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
 var handleOption = (programCommand, argMeta) => {
   const {
     type,
@@ -3369,7 +3542,7 @@ var handleOption = (programCommand, argMeta) => {
     enum: enumChoices,
     ask
   } = argMeta.argsOption;
-  const kebabName = camelToKebabCase(argMeta.name);
+  const kebabName = camelToKebabCase2(argMeta.name);
   const choices = enumChoices?.map(
     (choice) => typeof choice === "object" ? { value: choice.value, name: choice.label } : { value: choice, name: choice.toString() }
   );
@@ -3380,7 +3553,7 @@ var handleOption = (programCommand, argMeta) => {
   return programCommand;
 };
 var handleArgument = (programCommand, argMeta) => {
-  const kebabName = camelToKebabCase(argMeta.name);
+  const kebabName = camelToKebabCase2(argMeta.name);
   if ((argMeta.argsOption.type ?? "string") !== "string")
     throw new Error(`Argument type must be string: ${argMeta.name}`);
   programCommand.argument(
@@ -3540,11 +3713,21 @@ var runCommands = async (...commands) => {
   const __dirname = getDirname(import_meta3.url);
   const hasPackageJson = import_fs8.default.existsSync(`${__dirname}/../package.json`);
   process.env.AKAN_VERSION = hasPackageJson ? JSON.parse(import_fs8.default.readFileSync(`${__dirname}/../package.json`, "utf8")).version : "0.0.1";
-  import_commander.program.version(process.env.AKAN_VERSION).description("Akan CLI");
+  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);
+    }
+  }
+  import_commander.program.version(process.env.AKAN_VERSION).description("Akan CLI").configureHelp({
+    helpWidth: 100
+  });
   const akanBasePackageJson = import_fs8.default.existsSync("./node_modules/@akanjs/base/package.json") ? JSON.parse(import_fs8.default.readFileSync("./node_modules/@akanjs/base/package.json", "utf8")) : null;
   if (akanBasePackageJson && akanBasePackageJson.version !== process.env.AKAN_VERSION) {
     Logger.rawLog(
-      import_chalk4.default.yellow(
+      import_chalk5.default.yellow(
         `
 Akan CLI version is mismatch with installed package. ${process.env.AKAN_VERSION} (global) vs ${akanBasePackageJson.version} (base)
 It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`
@@ -3554,7 +3737,7 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`
   for (const command of commands) {
     const targetMetas = getTargetMetas(command);
     for (const targetMeta of targetMetas) {
-      const kebabKey = camelToKebabCase(targetMeta.key);
+      const kebabKey = camelToKebabCase2(targetMeta.key);
       const commandNames = targetMeta.targetOption.short === true ? [
         kebabKey,
         typeof targetMeta.targetOption.short === "string" ? targetMeta.targetOption.short : kebabKey.split("-").map((s) => s.slice(0, 1)).join("")
@@ -3585,6 +3768,9 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`
           }
         }
         programCommand = programCommand.option(`-v, --verbose [boolean]`, `verbose output`);
+        programCommand.helpInformation = () => {
+          return formatCommandHelp(command, targetMeta.key);
+        };
         programCommand.action(async (...args) => {
           Logger.rawLog();
           const cmdArgs = args.slice(0, args.length - 2);
@@ -3614,7 +3800,7 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`
           } catch (e) {
             const errMsg = e instanceof Error ? e.message : typeof e === "string" ? e : JSON.stringify(e);
             Logger.rawLog(`
-${import_chalk4.default.red(errMsg)}`);
+${import_chalk5.default.red(errMsg)}`);
             throw e;
           }
         });
@@ -3629,7 +3815,7 @@ var import_prompts4 = require("@inquirer/prompts");
 var import_messages = require("@langchain/core/messages");
 var import_deepseek = require("@langchain/deepseek");
 var import_openai2 = require("@langchain/openai");
-var import_chalk5 = __toESM(require("chalk"));
+var import_chalk6 = __toESM(require("chalk"));
 var import_fs9 = __toESM(require("fs"));
 var MAX_ASK_TRY = 300;
 var supportedLlmModels = ["deepseek-chat", "deepseek-reasoner"];
@@ -3641,11 +3827,11 @@ var AiSession = class _AiSession {
       const llmConfig2 = this.getLlmConfig();
       if (llmConfig2) {
         this.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
-        Logger.rawLog(import_chalk5.default.dim(`\u{1F916}akan editor uses existing LLM config (${llmConfig2.model})`));
+        Logger.rawLog(import_chalk6.default.dim(`\u{1F916}akan editor uses existing LLM config (${llmConfig2.model})`));
         return this;
       }
     } else
-      Logger.rawLog(import_chalk5.default.yellow("\u{1F916}akan-editor is not initialized. LLM configuration should be set first."));
+      Logger.rawLog(import_chalk6.default.yellow("\u{1F916}akan-editor is not initialized. LLM configuration should be set first."));
     const llmConfig = await this.#requestLlmConfig();
     const { model, apiKey } = llmConfig;
     await this.#validateApiKey(model, apiKey);
@@ -3689,7 +3875,7 @@ var AiSession = class _AiSession {
       return true;
     } catch (error) {
       spinner.fail(
-        import_chalk5.default.red(
+        import_chalk6.default.red(
           `LLM API key is invalid. Please check your API key and try again. You can set it again by running "akan set-llm" or reset by running "akan reset-llm"`
         )
       );
@@ -3726,7 +3912,7 @@ var AiSession = class _AiSession {
   }
   async ask(question, {
     onReasoning = (reasoning) => {
-      Logger.raw(import_chalk5.default.dim(reasoning));
+      Logger.raw(import_chalk6.default.dim(reasoning));
     },
     onChunk = (chunk) => {
       Logger.raw(chunk);
@@ -5565,82 +5751,82 @@ var ApplicationCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new application in the workspace" }),
   __decorateParam(0, Argument("appName", { desc: "name of application" })),
   __decorateParam(1, Option("start", { type: "boolean", desc: "start application", default: false })),
   __decorateParam(2, Workspace())
 ], ApplicationCommand.prototype, "createApplication", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Remove an application from the workspace" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "removeApplication", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Sync dependencies and configuration for an app or library" }),
   __decorateParam(0, Sys())
 ], ApplicationCommand.prototype, "sync", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Run a custom script in the application" }),
   __decorateParam(0, App()),
   __decorateParam(1, Argument("filename", { desc: "name of script", nullable: true }))
 ], ApplicationCommand.prototype, "script", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build the application for production (frontend + backend)" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "build", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build only the backend for production" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "buildBackend", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build only the frontend (SSR) for production" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "buildFrontend", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build the CSR (Client-Side Rendering) frontend" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "buildCsr", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build iOS app with Capacitor" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "buildIos", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Build Android app with Capacitor" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "buildAndroid", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start development server (frontend SSR + backend)" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("open", { type: "boolean", desc: "open web browser?", default: false })),
   __decorateParam(2, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "start", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start only the backend development server" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("open", { type: "boolean", desc: "open graphql playground", default: false })),
   __decorateParam(2, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "startBackend", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start only the frontend SSR development server" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("open", { type: "boolean", desc: "open web browser", default: false })),
   __decorateParam(2, Option("turbo", { type: "boolean", desc: "turbo", default: false })),
   __decorateParam(3, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "startFrontend", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start CSR (Client-Side Rendering) development server" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("open", { type: "boolean", desc: "open web browser", default: false })),
   __decorateParam(2, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "startCsr", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start iOS app in simulator or device" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("open", { type: "boolean", desc: "open ios simulator", default: false })),
   __decorateParam(2, Option("release", { type: "boolean", desc: "release mode", default: false })),
   __decorateParam(3, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "startIos", 1);
 __decorateClass([
-  Target.Public({ short: true }),
+  Target.Public({ short: true, desc: "Start Android app in emulator or device" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("host", {
     type: "string",
@@ -5653,16 +5839,16 @@ __decorateClass([
   __decorateParam(4, Option("sync", { type: "boolean", desc: "sync application", default: true }))
 ], ApplicationCommand.prototype, "startAndroid", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Build and package iOS app for release (App Store)" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "releaseIos", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Build and package Android app for release (Play Store)" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("assembleType", { type: "string", enum: ["apk", "aab"], default: "apk" }))
 ], ApplicationCommand.prototype, "releaseAndroid", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Release app source code with OTA update support" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("rebuild", { type: "boolean", desc: "rebuild", default: false })),
   __decorateParam(2, Option("buildNum", { desc: "build number", default: 0 })),
@@ -5670,11 +5856,11 @@ __decorateClass([
   __decorateParam(4, Option("local", { type: "boolean", desc: "local", default: true }))
 ], ApplicationCommand.prototype, "releaseSource", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Deploy over-the-air (OTA) update for mobile app" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "codepush", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Dump application database to local file" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("environment", {
     desc: "environment",
@@ -5684,7 +5870,7 @@ __decorateClass([
   }))
 ], ApplicationCommand.prototype, "dumpDatabase", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Restore application database from local dump" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("source", {
     desc: "source environment",
@@ -5698,21 +5884,21 @@ __decorateClass([
   }))
 ], ApplicationCommand.prototype, "restoreDatabase", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Start local database services (MongoDB, Redis, Meilisearch)" }),
   __decorateParam(0, Workspace())
 ], ApplicationCommand.prototype, "dbup", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Stop local database services" }),
   __decorateParam(0, Workspace())
 ], ApplicationCommand.prototype, "dbdown", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Pull database from cloud to local" }),
   __decorateParam(0, App()),
   __decorateParam(1, Option("env", { default: "debug" })),
   __decorateParam(2, Option("dump", { default: true }))
 ], ApplicationCommand.prototype, "pullDatabase", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Configure application settings interactively" }),
   __decorateParam(0, App())
 ], ApplicationCommand.prototype, "configureApp", 1);
 ApplicationCommand = __decorateClass([
@@ -5803,7 +5989,7 @@ var PackageScript = class {
 
 // pkgs/@akanjs/cli/src/cloud/cloud.runner.ts
 var import_prompts9 = require("@inquirer/prompts");
-var import_chalk6 = __toESM(require("chalk"), 1);
+var import_chalk7 = __toESM(require("chalk"), 1);
 var import_latest_version = __toESM(require("latest-version"), 1);
 var import_open2 = __toESM(require("open"), 1);
 var QRcode = __toESM(require("qrcode"), 1);
@@ -5813,17 +5999,17 @@ var CloudRunner = class {
     const config = getHostConfig();
     const self = config.auth ? await getSelf(config.auth.token) : null;
     if (self) {
-      Logger.rawLog(import_chalk6.default.green(`
+      Logger.rawLog(import_chalk7.default.green(`
 \u2713 Already logged in akan cloud as ${self.nickname}
 `));
       return true;
     }
     const remoteId = (0, import_uuid.v4)();
     const signinUrl = `${akanCloudClientUrl}/signin?remoteId=${remoteId}`;
-    Logger.rawLog(import_chalk6.default.bold(`
-${import_chalk6.default.green("\u27A4")} Authentication Required`));
-    Logger.rawLog(import_chalk6.default.dim("Please visit or click the following URL:"));
-    Logger.rawLog(import_chalk6.default.cyan.underline(signinUrl) + "\n");
+    Logger.rawLog(import_chalk7.default.bold(`
+${import_chalk7.default.green("\u27A4")} Authentication Required`));
+    Logger.rawLog(import_chalk7.default.dim("Please visit or click the following URL:"));
+    Logger.rawLog(import_chalk7.default.cyan.underline(signinUrl) + "\n");
     try {
       const qrcode = await new Promise((resolve, reject) => {
         QRcode.toString(signinUrl, { type: "terminal", small: true }, (err, data) => {
@@ -5834,11 +6020,11 @@ ${import_chalk6.default.green("\u27A4")} Authentication Required`));
       });
       Logger.rawLog(qrcode);
       await (0, import_open2.default)(signinUrl);
-      Logger.rawLog(import_chalk6.default.dim("Opening browser..."));
+      Logger.rawLog(import_chalk7.default.dim("Opening browser..."));
     } catch {
-      Logger.rawLog(import_chalk6.default.yellow("Could not open browser. Please visit the URL manually."));
+      Logger.rawLog(import_chalk7.default.yellow("Could not open browser. Please visit the URL manually."));
     }
-    Logger.rawLog(import_chalk6.default.dim("Waiting for authentication..."));
+    Logger.rawLog(import_chalk7.default.dim("Waiting for authentication..."));
     const MAX_RETRY = 300;
     for (let i = 0; i < MAX_RETRY; i++) {
       const res = await fetch(`${akanCloudBackendUrl}/user/getRemoteAuthToken/${remoteId}`);
@@ -5846,28 +6032,28 @@ ${import_chalk6.default.green("\u27A4")} Authentication Required`));
       const self2 = jwt ? await getSelf(jwt) : null;
       if (jwt && self2) {
         setHostConfig(akanCloudHost, { auth: { token: jwt, self: self2 } });
-        Logger.rawLog(import_chalk6.default.green(`\r\u2713 Authentication successful!`));
-        Logger.rawLog(import_chalk6.default.green.bold(`
+        Logger.rawLog(import_chalk7.default.green(`\r\u2713 Authentication successful!`));
+        Logger.rawLog(import_chalk7.default.green.bold(`
 \u2728 Welcome aboard, ${self2.nickname}!`));
-        Logger.rawLog(import_chalk6.default.dim("You're now ready to use Akan CLI!\n"));
+        Logger.rawLog(import_chalk7.default.dim("You're now ready to use Akan CLI!\n"));
         return true;
       }
       await sleep(2e3);
     }
-    throw new Error(import_chalk6.default.red("\u2716 Authentication timed out after 10 minutes. Please try again."));
+    throw new Error(import_chalk7.default.red("\u2716 Authentication timed out after 10 minutes. Please try again."));
   }
   logout() {
     const config = getHostConfig();
     if (config.auth) {
       setHostConfig(akanCloudHost, {});
-      Logger.rawLog(import_chalk6.default.magenta.bold(`
+      Logger.rawLog(import_chalk7.default.magenta.bold(`
 \u{1F44B} Goodbye, ${config.auth.self.nickname}!`));
-      Logger.rawLog(import_chalk6.default.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
-      Logger.rawLog(import_chalk6.default.cyan("You have been successfully logged out."));
-      Logger.rawLog(import_chalk6.default.dim("Thank you for using Akan CLI. Come back soon! \u{1F31F}\n"));
+      Logger.rawLog(import_chalk7.default.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+      Logger.rawLog(import_chalk7.default.cyan("You have been successfully logged out."));
+      Logger.rawLog(import_chalk7.default.dim("Thank you for using Akan CLI. Come back soon! \u{1F31F}\n"));
     } else {
-      Logger.rawLog(import_chalk6.default.yellow.bold("\n\u26A0\uFE0F  No active session found"));
-      Logger.rawLog(import_chalk6.default.dim("You were not logged in to begin with\n"));
+      Logger.rawLog(import_chalk7.default.yellow.bold("\n\u26A0\uFE0F  No active session found"));
+      Logger.rawLog(import_chalk7.default.dim("You were not logged in to begin with\n"));
     }
   }
   async setLlm() {
@@ -5875,7 +6061,7 @@ ${import_chalk6.default.green("\u27A4")} Authentication Required`));
   }
   resetLlm() {
     AiSession.setLlmConfig(null);
-    Logger.rawLog(import_chalk6.default.green("\u2611\uFE0F LLM model config is cleared. Please run `akan set-llm` to set a new LLM model."));
+    Logger.rawLog(import_chalk7.default.green("\u2611\uFE0F LLM model config is cleared. Please run `akan set-llm` to set a new LLM model."));
   }
   async getAkanPkgs(workspace) {
     const pkgs = await workspace.getPkgs();
@@ -6015,32 +6201,32 @@ var CloudCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Login to Akan Cloud services" }),
   __decorateParam(0, Workspace())
 ], CloudCommand.prototype, "login", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Logout from Akan Cloud services" }),
   __decorateParam(0, Workspace())
 ], CloudCommand.prototype, "logout", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Configure LLM (Large Language Model) API key" }),
   __decorateParam(0, Workspace())
 ], CloudCommand.prototype, "setLlm", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Reset LLM configuration to default" }),
   __decorateParam(0, Workspace())
 ], CloudCommand.prototype, "resetLlm", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Ask AI assistant a question about your project" }),
   __decorateParam(0, Option("question", { ask: "question to ask" })),
   __decorateParam(1, Workspace())
 ], CloudCommand.prototype, "ask", 1);
 __decorateClass([
-  Target.Public({ devOnly: true }),
+  Target.Public({ devOnly: true, desc: "Deploy Akan.js framework to cloud (internal use)" }),
   __decorateParam(0, Workspace())
 ], CloudCommand.prototype, "deployAkan", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Update Akan.js framework to the latest version" }),
   __decorateParam(0, Workspace()),
   __decorateParam(1, Option("tag", {
     desc: "tag of the update",
@@ -6069,20 +6255,20 @@ var LibraryCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new shared library in the workspace" }),
   __decorateParam(0, Argument("libName", { desc: "name of library" })),
   __decorateParam(1, Workspace())
 ], LibraryCommand.prototype, "createLibrary", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Remove a library from the workspace" }),
   __decorateParam(0, Lib())
 ], LibraryCommand.prototype, "removeLibrary", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Sync dependencies and configuration for a library" }),
   __decorateParam(0, Lib())
 ], LibraryCommand.prototype, "syncLibrary", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Install pre-built library templates (shared, util, etc.)" }),
   __decorateParam(0, Argument("libName", { desc: "name of library", nullable: true })),
   __decorateParam(1, Workspace())
 ], LibraryCommand.prototype, "installLibrary", 1);
@@ -6635,25 +6821,25 @@ var ModuleCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new domain module (constant, service, signal, store, UI)" }),
   __decorateParam(0, Argument("moduleName", { desc: "name of module" })),
   __decorateParam(1, Sys()),
   __decorateParam(2, Option("page", { type: "boolean", desc: "create page", default: false }))
 ], ModuleCommand.prototype, "createModule", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Remove a module from an app or library" }),
   __decorateParam(0, Module())
 ], ModuleCommand.prototype, "removeModule", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a View component for a module (full page view)" }),
   __decorateParam(0, Module())
 ], ModuleCommand.prototype, "createView", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a Unit component for a module (list/card item)" }),
   __decorateParam(0, Module())
 ], ModuleCommand.prototype, "createUnit", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a Template component for a module (form)" }),
   __decorateParam(0, Module())
 ], ModuleCommand.prototype, "createTemplate", 1);
 ModuleCommand = __decorateClass([
@@ -6680,24 +6866,24 @@ var PackageCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Show version information for all packages" }),
   __decorateParam(0, Workspace())
 ], PackageCommand.prototype, "version", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new package in pkgs/@akanjs/" }),
   __decorateParam(0, Option("name", { desc: "name of package" })),
   __decorateParam(1, Workspace())
 ], PackageCommand.prototype, "createPackage", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Remove a package from the workspace" }),
   __decorateParam(0, Pkg())
 ], PackageCommand.prototype, "removePackage", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Sync dependencies and configuration for a package" }),
   __decorateParam(0, Pkg())
 ], PackageCommand.prototype, "syncPackage", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Build a package for distribution" }),
   __decorateParam(0, Pkg())
 ], PackageCommand.prototype, "buildPackage", 1);
 PackageCommand = __decorateClass([
@@ -6712,7 +6898,7 @@ var PageCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create CRUD pages for a module (list, detail, create, edit)" }),
   __decorateParam(0, App()),
   __decorateParam(1, Module()),
   __decorateParam(2, Option("basePath", { desc: "base path", nullable: true })),
@@ -6919,7 +7105,7 @@ var WorkspaceCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new Akan.js workspace" }),
   __decorateParam(0, Argument("workspaceName", { desc: "what is the name of your organization?" })),
   __decorateParam(1, Option("app", { desc: "what is the codename of your first application? (e.g. myapp)" })),
   __decorateParam(2, Option("dir", { desc: "directory of workspace", default: process.env.USE_AKANJS_PKGS === "true" ? "local" : "." })),
@@ -6941,26 +7127,26 @@ __decorateClass([
   }))
 ], WorkspaceCommand.prototype, "createWorkspace", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Generate MongoDB types and schemas" }),
   __decorateParam(0, Workspace())
 ], WorkspaceCommand.prototype, "generateMongo", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Lint and fix code in a specific app/lib/pkg" }),
   __decorateParam(0, Exec()),
   __decorateParam(1, Option("fix", { type: "boolean", default: true })),
   __decorateParam(2, Workspace())
 ], WorkspaceCommand.prototype, "lint", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Lint and fix code in all apps and libraries" }),
   __decorateParam(0, Option("fix", { type: "boolean", default: true })),
   __decorateParam(1, Workspace())
 ], WorkspaceCommand.prototype, "lintAll", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Sync dependencies and configuration for all apps and libraries" }),
   __decorateParam(0, Workspace())
 ], WorkspaceCommand.prototype, "syncAll", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Dump all application databases to local files" }),
   __decorateParam(0, Option("environment", {
     desc: "environment",
     default: "debug",
@@ -6970,7 +7156,7 @@ __decorateClass([
   __decorateParam(1, Workspace())
 ], WorkspaceCommand.prototype, "dumpDatabaseAll", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Restore all application databases from local dump" }),
   __decorateParam(0, Option("source", {
     desc: "source environment",
     enum: ["debug", "develop", "main"],
@@ -7291,23 +7477,23 @@ var GuidelineCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ devOnly: true, desc: "Generate AI development guideline/instruction for your project" }),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
 ], GuidelineCommand.prototype, "generateInstruction", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ devOnly: true, desc: "Update existing AI guideline/instruction" }),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Option("request", { ask: "What do you want to update?" })),
   __decorateParam(2, Workspace())
 ], GuidelineCommand.prototype, "updateInstruction", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ devOnly: true, desc: "Generate documentation from guideline/instruction" }),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
 ], GuidelineCommand.prototype, "generateDocument", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ devOnly: true, desc: "Re-apply guideline/instruction to codebase" }),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
 ], GuidelineCommand.prototype, "reapplyInstruction", 1);
@@ -7504,13 +7690,13 @@ var ScalarCommand = class {
   }
 };
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Create a new scalar type (simple data model without DB)" }),
   __decorateParam(0, Argument("scalarName", { desc: "name of scalar" })),
   __decorateParam(1, Option("ai", { type: "boolean", default: false, desc: "use ai to create scalar" })),
   __decorateParam(2, Sys())
 ], ScalarCommand.prototype, "createScalar", 1);
 __decorateClass([
-  Target.Public(),
+  Target.Public({ desc: "Remove a scalar type from an app or library" }),
   __decorateParam(0, Argument("scalarName", { desc: "name of scalar" })),
   __decorateParam(1, Sys())
 ], ScalarCommand.prototype, "removeScalar", 1);