@nexical/cli 0.11.15 → 0.11.16

package/dist/index.js

@@ -15,7 +15,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@nexical/cli",
-  version: "0.11.15",
+  version: "0.11.16",
   license: "Apache-2.0",
   type: "module",
   bin: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.15\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.16\",\n    \"dotenv\": \"^17.3.1\",\n    \"fast-glob\": \"^3.3.3\",\n    \"glob\": \"^13.0.5\",\n    \"jiti\": \"^2.6.1\",\n    \"yaml\": \"^2.8.2\"\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^9.39.2\",\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^25.3.0\",\n    \"@vitest/coverage-v8\": \"^4.0.18\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.6.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.3\",\n    \"globals\": \"^17.3.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"tsup\": \"^8.5.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.9.3\",\n    \"typescript-eslint\": \"^8.56.0\",\n    \"vitest\": \"^4.0.18\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,IACV,aAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,IACR,MAAQ;AAAA,EACV;AAAA,EACA,iBAAmB;AAAA,IACjB,cAAc;AAAA,IACd,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,EACZ;AACF;;;ADxDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}
+{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.16\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.16\",\n    \"dotenv\": \"^17.3.1\",\n    \"fast-glob\": \"^3.3.3\",\n    \"glob\": \"^13.0.5\",\n    \"jiti\": \"^2.6.1\",\n    \"yaml\": \"^2.8.2\"\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^9.39.2\",\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^25.3.0\",\n    \"@vitest/coverage-v8\": \"^4.0.18\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.6.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.3\",\n    \"globals\": \"^17.3.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"tsup\": \"^8.5.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.9.3\",\n    \"typescript-eslint\": \"^8.56.0\",\n    \"vitest\": \"^4.0.18\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,IACV,aAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,IACR,MAAQ;AAAA,EACV;AAAA,EACA,iBAAmB;AAAA,IACjB,cAAc;AAAA,IACd,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,EACZ;AACF;;;ADxDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}

package/dist/src/commands/init.js

@@ -1,10 +1,4 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
-import {
-  SetupCommand
-} from "../../chunk-GUUPSHWC.js";
-import {
-  require_lib
-} from "../../chunk-OUGA4CB4.js";
 import {
   addAll,
   clone,
@@ -15,6 +9,12 @@ import {
 import {
   resolveGitUrl
 } from "../../chunk-PJIOCW2A.js";
+import {
+  SetupCommand
+} from "../../chunk-GUUPSHWC.js";
+import {
+  require_lib
+} from "../../chunk-OUGA4CB4.js";
 import {
   __toESM,
   init_esm_shims

package/dist/src/commands/module/add.js

@@ -1,7 +1,4 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
-import {
-  require_lib
-} from "../../../chunk-OUGA4CB4.js";
 import {
   addSubmodule,
   clone,
@@ -10,6 +7,9 @@ import {
 import {
   resolveGitUrl
 } from "../../../chunk-PJIOCW2A.js";
+import {
+  require_lib
+} from "../../../chunk-OUGA4CB4.js";
 import {
   __toESM,
   init_esm_shims

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexical/cli",
-  "version": "0.11.15",
+  "version": "0.11.16",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {

package/GEMINI.md

@@ -1,199 +0,0 @@
-# Nexical CLI Core Development Guide
-
-This guide details how to build command libraries and CLIs using the `@nexical/cli-core` framework within this project.
-
-## Overview
-
-The project is configured to use `@nexical/cli-core` as its CLI framework. usage entails:
-
-1.  **Entry Point**: `index.ts` initializes the `CLI` instance.
-2.  **Command Discovery**: The CLI automatically scans `src/commands` for command files.
-3.  **Command Implementation**: Commands are TypeScript classes extending `BaseCommand`.
-
-## Directory Structure
-
-Commands are defined in `src/commands`. The file structure directly maps to the command hierarchy.
-
-| File Path                     | Command           | Description                       |
-| :---------------------------- | :---------------- | :-------------------------------- |
-| `src/commands/init.ts`        | `app init`        | Root level command                |
-| `src/commands/user/create.ts` | `app user create` | Subcommand                        |
-| `src/commands/user/index.ts`  | `app user`        | Parent command handler (optional) |
-
-> **Note**: The CLI name (`app`) is configured in `index.ts`.
-
-## Creating a New Command
-
-To create a new command, add a `.ts` file in `src/commands`.
-
-### 1. Basic Command Template
-
-Create `src/commands/hello.ts`:
-
-```typescript
-import { BaseCommand } from '@nexical/cli-core';
-
-export default class HelloCommand extends BaseCommand {
-  // Description displayed in help menus
-  static description = 'Prints a hello message';
-
-  // The main execution method
-  async run(options: any) {
-    this.success('Hello World!');
-  }
-}
-```
-
-**Run it:**
-
-```bash
-npm run cli hello
-```
-
-### 2. Arguments and Options
-
-Use the static `args` property to define inputs.
-
-```typescript
-import { BaseCommand } from '@nexical/cli-core';
-
-export default class GreetCommand extends BaseCommand {
-  static description = 'Greets a user';
-
-  static args = {
-    // Positional Arguments
-    args: [
-      {
-        name: 'name',
-        description: 'Name of the user',
-        required: true,
-      },
-    ],
-    // Options (Flags)
-    options: [
-      {
-        name: '--loud',
-        description: 'Print in uppercase',
-        default: false,
-      },
-      {
-        name: '-c, --count <n>',
-        description: 'Number of times to greet',
-        default: 1,
-      },
-    ],
-  };
-
-  async run(options: any) {
-    // 'name' is mapped from args
-    // 'loud' and 'count' are mapped from options
-    const { name, loud, count } = options;
-
-    let message = `Hello, ${name}`;
-    if (loud) message = message.toUpperCase();
-
-    for (let i = 0; i < count; i++) {
-      this.info(message);
-    }
-  }
-}
-```
-
-**Run it:**
-
-```bash
-npm run cli greet Adrian --loud --count 3
-```
-
-### 3. User Input & Prompts
-
-`BaseCommand` provides built-in methods for interactivity.
-
-```typescript
-export default class InteractiveCommand extends BaseCommand {
-  async run() {
-    // Simple confirmation or input
-    const name = await this.prompt('What is your name?');
-
-    this.success(`Nice to meet you, ${name}`);
-  }
-}
-```
-
-### 4. Output Helpers
-
-Use the built-in helper methods for consistent logging:
-
-- `this.success(msg)`: Green checkmark (✔ Success)
-- `this.error(msg)`: Red cross (✖ Error) - **Exits process**
-- `this.warn(msg)`: Yellow warning (⚠ Warning)
-- `this.info(msg)`: Standard log
-- `this.notice(msg)`: Blue notice (📢 Note)
-- `this.input(msg)`: Cyan input prompt (? Question)
-
-## Subcommands
-
-To create grouped commands (e.g., `user create`, `user list`), use directories.
-
-1.  **Create Directory**: `src/commands/user/`
-2.  **Add Commands**:
-    - `src/commands/user/create.ts` -> `app user create`
-    - `src/commands/user/list.ts` -> `app user list`
-
-### Index Commands (Container Commands)
-
-If you need the parent command `app user` to do something (or just provide a description for the group), create `src/commands/user/index.ts`.
-
-```typescript
-// src/commands/user/index.ts
-import { BaseCommand } from '@nexical/cli-core';
-
-export default class UserCommand extends BaseCommand {
-  static description = 'Manage users';
-
-  async run() {
-    // This runs when user types 'app user' without a subcommand
-    // Often used to show help
-    this.cli.getRawCLI().outputHelp();
-  }
-}
-```
-
-## Internal API Reference
-
-### `BaseCommand`
-
-All commands inherit from `BaseCommand`.
-
-**Properties:**
-
-- `cli`: Access to the main `CLI` instance.
-- `projectRoot`: Path to the project root (if detected).
-- `config`: Loaded configuration from `{cliName}.yml`.
-- `globalOptions`: Global flags passed to the CLI (e.g., `--debug`).
-
-**Methods:**
-
-- `init()`: Called before `run()`. Useful for setup.
-- `run(options)`: Abstract method. Must be implemented.
-- `prompt(message)`: Async, returns string.
-
-**Static Properties:**
-
-- `description`: String. Shown in help.
-- `args`: Object. Defines arguments and options.
-  - `args`: Array of `{ name, description, required, default }`.
-  - `options`: Array of `{ name, description, default }`.
-- `requiresProject`: Boolean. If true, command fails if not run inside a project with a config file.
-
-## Best Practices
-
-1.  **Type Safety**: While `options` is `any` in `run()`, validate inputs early.
-2.  **Error Handling**: Use `this.error()` for fatal errors to ensure proper exit codes.
-3.  **Clean Output**: Use the helper methods (`success`, `info`, etc.) instead of `console.log` for a consistent UI.
-4.  **Async**: The `run` method is async. Always `await` asynchronous operations.
-
-## Troubleshooting
-
-- **Command not found**: Ensure the file exports a class leveraging `export default` and extends `BaseCommand`.
-- **Changes not reflected**: If using `tsup`, ensure you are building or running in dev mode (`npm run dev`). For `npm run cli` using `ts-node` (via `cli.ts` or similar), changes should be instant.