@nexical/cli 0.11.15 → 0.11.17

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.17",
   license: "Apache-2.0",
   type: "module",
   bin: {
@@ -44,17 +44,23 @@ var package_default = {
     ]
   },
   dependencies: {
+    "@nexical/ai": "^0.1.3",
     "@nexical/cli-core": "^0.1.16",
     dotenv: "^17.3.1",
     "fast-glob": "^3.3.3",
     glob: "^13.0.5",
     jiti: "^2.6.1",
+    minimist: "^1.2.8",
+    nunjucks: "^3.2.4",
+    repomix: "^1.11.1",
     yaml: "^2.8.2"
   },
   devDependencies: {
     "@eslint/js": "^9.39.2",
     "@types/fs-extra": "^11.0.4",
+    "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.0",
+    "@types/nunjucks": "^3.2.6",
     "@vitest/coverage-v8": "^4.0.18",
     eslint: "^9.39.2",
     "eslint-config-prettier": "^10.1.8",

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.17\",\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/ai\": \"^0.1.3\",\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    \"minimist\": \"^1.2.8\",\n    \"nunjucks\": \"^3.2.4\",\n    \"repomix\": \"^1.11.1\",\n    \"yaml\": \"^2.8.2\"\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^9.39.2\",\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/minimist\": \"^1.2.5\",\n    \"@types/node\": \"^25.3.0\",\n    \"@types/nunjucks\": \"^3.2.6\",\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":"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","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/dist/src/commands/prompt.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand, CommandDefinition } from '@nexical/cli-core';
+
+declare class PromptCommand extends BaseCommand {
+    static usage: string;
+    static description: string;
+    static requiresProject: boolean;
+    static args: CommandDefinition;
+    run(options: {
+        promptName: string;
+        args?: string[];
+        module?: string;
+        m?: string;
+        interactive?: boolean;
+        i?: boolean;
+        models?: string;
+    }): Promise<void>;
+}
+
+export { PromptCommand as default };

package/dist/src/commands/prompt.js

@@ -0,0 +1,347 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  require_lib
+} from "../../chunk-OUGA4CB4.js";
+import {
+  __toESM,
+  init_esm_shims
+} from "../../chunk-OYFWMYPG.js";
+
+// src/commands/prompt.ts
+init_esm_shims();
+var import_fs_extra = __toESM(require_lib(), 1);
+import { BaseCommand, logger } from "@nexical/cli-core";
+import path from "path";
+import os from "os";
+import nunjucks from "nunjucks";
+import minimist from "minimist";
+import readline from "readline";
+import YAML from "yaml";
+import { pack } from "repomix";
+import { existsSync, statSync } from "fs";
+import { AiClientFactory } from "@nexical/ai";
+var PromptCommand = class extends BaseCommand {
+  static usage = "prompt <prompt-name> [args...]";
+  static description = "Run an AI prompt using templates from the prompts directory.";
+  static requiresProject = true;
+  static args = {
+    args: [
+      {
+        name: "promptName",
+        required: true,
+        description: "The name of the markdown file in the prompts directory."
+      },
+      {
+        name: "args...",
+        required: false,
+        description: "Additional arguments for the template and command"
+      }
+    ],
+    options: [
+      {
+        name: "--module, -m <module>",
+        description: "Target a specific module (searches apps/frontend/modules and apps/backend/modules)"
+      },
+      { name: "--interactive, -i", description: "Run in interactive chat mode" },
+      {
+        name: "--models <models>",
+        description: "Comma-separated list of models to try",
+        default: "gemini-3-flash-preview,gemini-3-pro-preview"
+      }
+    ]
+  };
+  async run(options) {
+    const projectRoot = this.projectRoot;
+    const promptName = options.promptName;
+    const argv = minimist(options.args || []);
+    const isInteractive = options.interactive || options.i || argv.interactive || argv.i;
+    const moduleName = options.module || options.m || argv.module || argv.m;
+    const modelsArg = options.models || argv.models || "gemini-3-flash-preview,gemini-3-pro-preview";
+    const models = modelsArg.split(",").map((m) => m.trim()).filter(Boolean);
+    const promptFileName = promptName.endsWith(".md") ? promptName : `${promptName}.md`;
+    const PROMPTS_DIRS = [path.join(projectRoot, "prompts")];
+    const generatorAgentsPrompts = path.join(projectRoot, "packages/generator/prompts/agents");
+    if (await import_fs_extra.default.pathExists(generatorAgentsPrompts)) {
+      PROMPTS_DIRS.push(generatorAgentsPrompts);
+    }
+    let promptFile;
+    for (const dir of PROMPTS_DIRS) {
+      const candidate = path.join(dir, promptFileName);
+      if (await import_fs_extra.default.pathExists(candidate)) {
+        promptFile = candidate;
+        break;
+      }
+    }
+    if (!promptFile) {
+      this.error(
+        `Prompt file '${promptFileName}' not found in any of the search directories:
+` + PROMPTS_DIRS.map((d) => `  - ${d}`).join("\n")
+      );
+      return;
+    }
+    const contextVars = { ...argv };
+    if (moduleName) {
+      const frontendPath = path.join(projectRoot, "apps/frontend/modules", moduleName);
+      const backendPath = path.join(projectRoot, "apps/backend/modules", moduleName);
+      let moduleRoot;
+      let moduleType;
+      if (await import_fs_extra.default.pathExists(frontendPath)) {
+        moduleRoot = frontendPath;
+        moduleType = "frontend";
+      } else if (await import_fs_extra.default.pathExists(backendPath)) {
+        moduleRoot = backendPath;
+        moduleType = "backend";
+      }
+      if (!moduleRoot) {
+        this.error(
+          `Module '${moduleName}' not found in apps/frontend/modules or apps/backend/modules.`
+        );
+        return;
+      }
+      logger.debug(`[Context] Targeting ${moduleType} module: ${moduleName}`);
+      contextVars.module_root = moduleRoot;
+      contextVars.module_name = moduleName;
+      contextVars.module_type = moduleType;
+      contextVars.root_path = moduleRoot + "/";
+    } else {
+      if (!contextVars.root_path) {
+        contextVars.root_path = process.cwd() + "/";
+      }
+    }
+    const env = new nunjucks.Environment(new nunjucks.FileSystemLoader(PROMPTS_DIRS), {
+      autoescape: false,
+      trimBlocks: true,
+      lstripBlocks: true
+    });
+    const asyncResolvers = /* @__PURE__ */ new Map();
+    let resolverId = 0;
+    env.addGlobal("context", (targetPath) => {
+      const id = `__NEXICAL_ASYNC_CONTEXT_${resolverId++}__`;
+      const promise = (async () => {
+        try {
+          if (!existsSync(targetPath)) {
+            logger.debug(`[Context] Path not found: ${targetPath}`);
+            return `[Path not found: ${targetPath}]`;
+          }
+          const stats = statSync(targetPath);
+          if (stats.isFile()) {
+            logger.debug(`[Context] Reading file directly at: ${targetPath}`);
+            const content = await import_fs_extra.default.readFile(targetPath, "utf-8");
+            return `<CODEBASE_CONTEXT path="${targetPath}">
+${content}
+</CODEBASE_CONTEXT>`;
+          }
+          logger.debug(`[Context] Analyzing codebase at: ${targetPath}`);
+          const tempOutputFile = path.join(
+            os.tmpdir(),
+            `repomix-output-${Date.now()}-${Math.random().toString(36).substring(7)}.xml`
+          );
+          await pack([targetPath], {
+            input: { maxFileSize: 1024 * 1024 * 10 },
+            output: {
+              filePath: tempOutputFile,
+              style: "xml",
+              showLineNumbers: false,
+              fileSummary: false,
+              directoryStructure: false,
+              removeComments: false,
+              removeEmptyLines: false,
+              includeEmptyDirectories: false,
+              topFilesLength: 5,
+              parsableStyle: false,
+              files: true,
+              compress: false,
+              truncateBase64: true,
+              copyToClipboard: false,
+              includeDiffs: false,
+              includeLogs: false,
+              includeLogsCount: 0,
+              gitSortByChanges: false,
+              includeFullDirectoryStructure: false
+            },
+            ignore: {
+              useGitignore: true,
+              useDotIgnore: true,
+              useDefaultPatterns: true,
+              customPatterns: ["**/node_modules", "**/dist"]
+            },
+            include: [],
+            security: { enableSecurityCheck: false },
+            tokenCount: { encoding: "o200k_base" },
+            cwd: targetPath
+          });
+          const output = await import_fs_extra.default.readFile(tempOutputFile, "utf-8");
+          try {
+            await import_fs_extra.default.unlink(tempOutputFile);
+          } catch {
+          }
+          return `<CODEBASE_CONTEXT path="${targetPath}">
+${output}
+</CODEBASE_CONTEXT>`;
+        } catch (error) {
+          logger.error(`[Context] Error generating context for ${targetPath}: ${error}`);
+          return `[Error generating context for ${targetPath}]`;
+        }
+      })();
+      asyncResolvers.set(id, promise);
+      return id;
+    });
+    env.addGlobal("read", (relativePath) => {
+      const id = `__NEXICAL_ASYNC_READ_${resolverId++}__`;
+      const promise = (async () => {
+        try {
+          const cwdStr = process.cwd();
+          if (Array.isArray(relativePath)) {
+            const contents = await Promise.all(
+              relativePath.map(async (p) => {
+                const resolvedPath2 = path.resolve(cwdStr, p);
+                if (!existsSync(resolvedPath2)) {
+                  logger.debug(`[Read] File not found: ${resolvedPath2}`);
+                  return `[File not found: ${resolvedPath2}]`;
+                }
+                return await import_fs_extra.default.readFile(resolvedPath2, "utf-8");
+              })
+            );
+            return contents.join("\n\n");
+          } else if (typeof relativePath === "string" && relativePath.includes(",")) {
+            const contents = await Promise.all(
+              relativePath.split(",").map(async (p) => {
+                const resolvedPath2 = path.resolve(cwdStr, p.trim());
+                if (!existsSync(resolvedPath2)) {
+                  logger.debug(`[Read] File not found: ${resolvedPath2}`);
+                  return `[File not found: ${resolvedPath2}]`;
+                }
+                return await import_fs_extra.default.readFile(resolvedPath2, "utf-8");
+              })
+            );
+            return contents.join("\n\n");
+          }
+          const resolvedPath = path.resolve(cwdStr, relativePath);
+          if (!existsSync(resolvedPath)) {
+            logger.debug(`[Read] File not found: ${resolvedPath}`);
+            return `[File not found: ${resolvedPath}]`;
+          }
+          return await import_fs_extra.default.readFile(resolvedPath, "utf-8");
+        } catch {
+          logger.warn(`[Read] Warning: Could not read file: ${relativePath}`);
+          return `[Error reading file ${relativePath}]`;
+        }
+      })();
+      asyncResolvers.set(id, promise);
+      return id;
+    });
+    let templateContent;
+    try {
+      templateContent = await import_fs_extra.default.readFile(promptFile, "utf-8");
+    } catch (error) {
+      if (error instanceof Error) {
+        this.error(`Error reading prompt file: ${error.message}`);
+      } else {
+        this.error(`Error reading prompt file: ${String(error)}`);
+      }
+      return;
+    }
+    logger.debug(
+      `[Render] Rendering template with variables:`,
+      JSON.stringify(contextVars, null, 2)
+    );
+    let renderedPrompt;
+    try {
+      renderedPrompt = env.renderString(templateContent, {
+        ...contextVars
+      });
+    } catch (e) {
+      this.error(`Template render error: ${e}`);
+      return;
+    }
+    for (const [id, promise] of asyncResolvers.entries()) {
+      try {
+        const resolvedValue = await promise;
+        renderedPrompt = renderedPrompt.replace(id, resolvedValue);
+      } catch (e) {
+        logger.error(`[Render] Failed to resolve async variable ${id}: ${e}`);
+        renderedPrompt = renderedPrompt.replace(id, `[Error resolving id]`);
+      }
+    }
+    const tempFile = path.join(os.tmpdir(), ".temp_prompt_active.md");
+    await import_fs_extra.default.writeFile(tempFile, renderedPrompt, "utf-8");
+    logger.debug(`[Buffer] Wrote active prompt to ${tempFile}`);
+    logger.info(`[Agent] Model rotation strategy: [${models.join(", ")}]`);
+    const configPath = path.join(projectRoot, "nexical.yaml");
+    let aiConfig = {};
+    if (await import_fs_extra.default.pathExists(configPath)) {
+      try {
+        const content = await import_fs_extra.default.readFile(configPath, "utf8");
+        const config = YAML.parse(content) || {};
+        aiConfig = config.ai || {};
+      } catch {
+        logger.warn("Failed to parse nexical.yaml AI config, using defaults.");
+      }
+    }
+    const aiClient = AiClientFactory.create(aiConfig);
+    let currentPrompt = renderedPrompt;
+    let finalCode = 0;
+    while (true) {
+      let success = false;
+      let lastOutput = "";
+      for (const model of models) {
+        logger.info(`[Agent] Attempting with model: \x1B[36m${model}\x1B[0m...`);
+        const result = await aiClient.run(model, currentPrompt);
+        if (result.code === 0) {
+          success = true;
+          lastOutput = result.output;
+          break;
+        }
+        if (result.shouldRetry) {
+          logger.info(`[Agent] Switching to next model...`);
+          continue;
+        } else {
+          finalCode = result.code;
+          break;
+        }
+      }
+      if (!success) {
+        if (finalCode === 0) finalCode = 1;
+        this.error(`[Agent] \u274C All attempts failed.`);
+        break;
+      }
+      if (!isInteractive) {
+        break;
+      }
+      currentPrompt += `
+${lastOutput}`;
+      const askLink = () => {
+        const rl = readline.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        return new Promise((resolve) => {
+          this.info('\n(Type "exit" or "quit" to end the session)');
+          rl.question("> ", (ans) => {
+            rl.close();
+            resolve(ans);
+          });
+        });
+      };
+      const answer = await askLink();
+      if (["exit", "quit"].includes(answer.trim().toLowerCase())) {
+        break;
+      }
+      currentPrompt += `
+User: ${answer}
+`;
+    }
+    try {
+      await import_fs_extra.default.unlink(tempFile);
+      logger.debug(`[Cleanup] Removed active prompt file`);
+    } catch {
+    }
+    if (finalCode !== 0) {
+      process.exit(finalCode);
+    }
+  }
+};
+export {
+  PromptCommand as default
+};
+//# sourceMappingURL=prompt.js.map

package/dist/src/commands/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/prompt.ts"],"sourcesContent":["import { type CommandDefinition, BaseCommand, logger } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\nimport os from 'node:os';\nimport nunjucks from 'nunjucks';\nimport minimist from 'minimist';\nimport readline from 'node:readline';\nimport YAML from 'yaml';\nimport { pack } from 'repomix';\nimport { existsSync, statSync } from 'node:fs';\nimport { AiClientFactory } from '@nexical/ai';\n\nexport default class PromptCommand extends BaseCommand {\n  static usage = 'prompt <prompt-name> [args...]';\n  static description = 'Run an AI prompt using templates from the prompts directory.';\n  static requiresProject = true;\n\n  static args: CommandDefinition = {\n    args: [\n      {\n        name: 'promptName',\n        required: true,\n        description: 'The name of the markdown file in the prompts directory.',\n      },\n      {\n        name: 'args...',\n        required: false,\n        description: 'Additional arguments for the template and command',\n      },\n    ],\n    options: [\n      {\n        name: '--module, -m <module>',\n        description:\n          'Target a specific module (searches apps/frontend/modules and apps/backend/modules)',\n      },\n      { name: '--interactive, -i', description: 'Run in interactive chat mode' },\n      {\n        name: '--models <models>',\n        description: 'Comma-separated list of models to try',\n        default: 'gemini-3-flash-preview,gemini-3-pro-preview',\n      },\n    ],\n  };\n\n  async run(options: {\n    promptName: string;\n    args?: string[];\n    module?: string;\n    m?: string;\n    interactive?: boolean;\n    i?: boolean;\n    models?: string;\n  }) {\n    const projectRoot = this.projectRoot as string;\n    const promptName = options.promptName;\n\n    // Parse additional template flags\n    const argv = minimist(options.args || []);\n    const isInteractive = options.interactive || options.i || argv.interactive || argv.i;\n    const moduleName = options.module || options.m || argv.module || argv.m;\n    const modelsArg =\n      options.models || argv.models || 'gemini-3-flash-preview,gemini-3-pro-preview';\n    const models = modelsArg\n      .split(',')\n      .map((m: string) => m.trim())\n      .filter(Boolean);\n\n    // Resolve prompt file from multiple directories\n    const promptFileName = promptName.endsWith('.md') ? promptName : `${promptName}.md`;\n    const PROMPTS_DIRS = [path.join(projectRoot, 'prompts')];\n    const generatorAgentsPrompts = path.join(projectRoot, 'packages/generator/prompts/agents');\n\n    if (await fs.pathExists(generatorAgentsPrompts)) {\n      PROMPTS_DIRS.push(generatorAgentsPrompts);\n    }\n\n    let promptFile: string | undefined;\n    for (const dir of PROMPTS_DIRS) {\n      const candidate = path.join(dir, promptFileName);\n      if (await fs.pathExists(candidate)) {\n        promptFile = candidate;\n        break;\n      }\n    }\n\n    if (!promptFile) {\n      this.error(\n        `Prompt file '${promptFileName}' not found in any of the search directories:\\n` +\n          PROMPTS_DIRS.map((d) => `  - ${d}`).join('\\n'),\n      );\n      return;\n    }\n\n    // Module Resolution Logic\n    const contextVars = { ...argv };\n    if (moduleName) {\n      const frontendPath = path.join(projectRoot, 'apps/frontend/modules', moduleName);\n      const backendPath = path.join(projectRoot, 'apps/backend/modules', moduleName);\n\n      let moduleRoot: string | undefined;\n      let moduleType: 'frontend' | 'backend' | undefined;\n\n      if (await fs.pathExists(frontendPath)) {\n        moduleRoot = frontendPath;\n        moduleType = 'frontend';\n      } else if (await fs.pathExists(backendPath)) {\n        moduleRoot = backendPath;\n        moduleType = 'backend';\n      }\n\n      if (!moduleRoot) {\n        this.error(\n          `Module '${moduleName}' not found in apps/frontend/modules or apps/backend/modules.`,\n        );\n        return;\n      }\n\n      logger.debug(`[Context] Targeting ${moduleType} module: ${moduleName}`);\n      contextVars.module_root = moduleRoot;\n      contextVars.module_name = moduleName;\n      contextVars.module_type = moduleType;\n      contextVars.root_path = moduleRoot + '/';\n    } else {\n      if (!contextVars.root_path) {\n        contextVars.root_path = process.cwd() + '/';\n      }\n    }\n\n    // Configure Nunjucks\n    const env = new nunjucks.Environment(new nunjucks.FileSystemLoader(PROMPTS_DIRS), {\n      autoescape: false,\n      trimBlocks: true,\n      lstripBlocks: true,\n    });\n\n    const asyncResolvers = new Map<string, Promise<string>>();\n    let resolverId = 0;\n\n    // Helper: context(path) -> runs repomix\n    env.addGlobal('context', (targetPath: string) => {\n      const id = `__NEXICAL_ASYNC_CONTEXT_${resolverId++}__`;\n      const promise = (async () => {\n        try {\n          if (!existsSync(targetPath)) {\n            logger.debug(`[Context] Path not found: ${targetPath}`);\n            return `[Path not found: ${targetPath}]`;\n          }\n\n          const stats = statSync(targetPath);\n          if (stats.isFile()) {\n            logger.debug(`[Context] Reading file directly at: ${targetPath}`);\n            const content = await fs.readFile(targetPath, 'utf-8');\n            return `<CODEBASE_CONTEXT path=\"${targetPath}\">\\n${content}\\n</CODEBASE_CONTEXT>`;\n          }\n\n          logger.debug(`[Context] Analyzing codebase at: ${targetPath}`);\n          const tempOutputFile = path.join(\n            os.tmpdir(),\n            `repomix-output-${Date.now()}-${Math.random().toString(36).substring(7)}.xml`,\n          );\n\n          await pack([targetPath], {\n            input: { maxFileSize: 1024 * 1024 * 10 },\n            output: {\n              filePath: tempOutputFile,\n              style: 'xml',\n              showLineNumbers: false,\n              fileSummary: false,\n              directoryStructure: false,\n              removeComments: false,\n              removeEmptyLines: false,\n              includeEmptyDirectories: false,\n              topFilesLength: 5,\n              parsableStyle: false,\n              files: true,\n              compress: false,\n              truncateBase64: true,\n              copyToClipboard: false,\n              includeDiffs: false,\n              includeLogs: false,\n              includeLogsCount: 0,\n              gitSortByChanges: false,\n              includeFullDirectoryStructure: false,\n            },\n            ignore: {\n              useGitignore: true,\n              useDotIgnore: true,\n              useDefaultPatterns: true,\n              customPatterns: ['**/node_modules', '**/dist'],\n            },\n            include: [],\n            security: { enableSecurityCheck: false },\n            tokenCount: { encoding: 'o200k_base' },\n            cwd: targetPath,\n          } as unknown as Parameters<typeof pack>[1]);\n\n          const output = await fs.readFile(tempOutputFile, 'utf-8');\n          try {\n            await fs.unlink(tempOutputFile);\n          } catch {\n            /* ignore */\n          }\n          return `<CODEBASE_CONTEXT path=\"${targetPath}\">\\n${output}\\n</CODEBASE_CONTEXT>`;\n        } catch (error) {\n          logger.error(`[Context] Error generating context for ${targetPath}: ${error}`);\n          return `[Error generating context for ${targetPath}]`;\n        }\n      })();\n      asyncResolvers.set(id, promise);\n      return id;\n    });\n\n    // Helper: read(path) -> reads local file\n    env.addGlobal('read', (relativePath: string | string[]) => {\n      const id = `__NEXICAL_ASYNC_READ_${resolverId++}__`;\n      const promise = (async () => {\n        try {\n          const cwdStr = process.cwd();\n          if (Array.isArray(relativePath)) {\n            const contents = await Promise.all(\n              relativePath.map(async (p) => {\n                const resolvedPath = path.resolve(cwdStr, p);\n                if (!existsSync(resolvedPath)) {\n                  logger.debug(`[Read] File not found: ${resolvedPath}`);\n                  return `[File not found: ${resolvedPath}]`;\n                }\n                return await fs.readFile(resolvedPath, 'utf-8');\n              }),\n            );\n            return contents.join('\\n\\n');\n          } else if (typeof relativePath === 'string' && relativePath.includes(',')) {\n            const contents = await Promise.all(\n              relativePath.split(',').map(async (p) => {\n                const resolvedPath = path.resolve(cwdStr, p.trim());\n                if (!existsSync(resolvedPath)) {\n                  logger.debug(`[Read] File not found: ${resolvedPath}`);\n                  return `[File not found: ${resolvedPath}]`;\n                }\n                return await fs.readFile(resolvedPath, 'utf-8');\n              }),\n            );\n            return contents.join('\\n\\n');\n          }\n\n          const resolvedPath = path.resolve(cwdStr, relativePath as string);\n          if (!existsSync(resolvedPath)) {\n            logger.debug(`[Read] File not found: ${resolvedPath}`);\n            return `[File not found: ${resolvedPath}]`;\n          }\n          return await fs.readFile(resolvedPath, 'utf-8');\n        } catch {\n          logger.warn(`[Read] Warning: Could not read file: ${relativePath}`);\n          return `[Error reading file ${relativePath}]`;\n        }\n      })();\n      asyncResolvers.set(id, promise);\n      return id;\n    });\n\n    // Read template content\n    let templateContent: string;\n    try {\n      templateContent = await fs.readFile(promptFile, 'utf-8');\n    } catch (error) {\n      if (error instanceof Error) {\n        this.error(`Error reading prompt file: ${error.message}`);\n      } else {\n        this.error(`Error reading prompt file: ${String(error)}`);\n      }\n      return;\n    }\n\n    // Render template\n    logger.debug(\n      `[Render] Rendering template with variables:`,\n      JSON.stringify(contextVars, null, 2),\n    );\n    let renderedPrompt: string;\n    try {\n      renderedPrompt = env.renderString(templateContent, {\n        ...contextVars,\n      });\n    } catch (e) {\n      this.error(`Template render error: ${e}`);\n      return;\n    }\n\n    // Resolve placeholders\n    for (const [id, promise] of asyncResolvers.entries()) {\n      try {\n        const resolvedValue = await promise;\n        renderedPrompt = renderedPrompt.replace(id, resolvedValue);\n      } catch (e) {\n        logger.error(`[Render] Failed to resolve async variable ${id}: ${e}`);\n        renderedPrompt = renderedPrompt.replace(id, `[Error resolving id]`);\n      }\n    }\n\n    // Buffer to file\n    const tempFile = path.join(os.tmpdir(), '.temp_prompt_active.md');\n    await fs.writeFile(tempFile, renderedPrompt, 'utf-8');\n    logger.debug(`[Buffer] Wrote active prompt to ${tempFile}`);\n\n    logger.info(`[Agent] Model rotation strategy: [${models.join(', ')}]`);\n\n    // Extract AI configuration from nexical.yaml\n    const configPath = path.join(projectRoot, 'nexical.yaml');\n    let aiConfig: Record<string, unknown> = {};\n    if (await fs.pathExists(configPath)) {\n      try {\n        const content = await fs.readFile(configPath, 'utf8');\n        const config = YAML.parse(content) || {};\n        aiConfig = (config.ai as Record<string, unknown>) || {};\n      } catch {\n        logger.warn('Failed to parse nexical.yaml AI config, using defaults.');\n      }\n    }\n\n    // Create AI client\n    const aiClient = AiClientFactory.create(aiConfig);\n\n    let currentPrompt = renderedPrompt;\n    let finalCode = 0;\n\n    while (true) {\n      let success = false;\n      let lastOutput = '';\n\n      for (const model of models) {\n        logger.info(`[Agent] Attempting with model: \\x1b[36m${model}\\x1b[0m...`);\n        const result = await aiClient.run(model, currentPrompt);\n\n        if (result.code === 0) {\n          success = true;\n          lastOutput = result.output;\n          break;\n        }\n\n        if (result.shouldRetry) {\n          logger.info(`[Agent] Switching to next model...`);\n          continue;\n        } else {\n          finalCode = result.code;\n          break;\n        }\n      }\n\n      if (!success) {\n        if (finalCode === 0) finalCode = 1;\n        this.error(`[Agent] \\u274C All attempts failed.`);\n        break;\n      }\n\n      if (!isInteractive) {\n        break;\n      }\n\n      currentPrompt += `\\n${lastOutput}`;\n\n      const askLink = () => {\n        const rl = readline.createInterface({\n          input: process.stdin,\n          output: process.stdout,\n        });\n        return new Promise<string>((resolve) => {\n          this.info('\\n(Type \"exit\" or \"quit\" to end the session)');\n          rl.question('> ', (ans) => {\n            rl.close();\n            resolve(ans);\n          });\n        });\n      };\n\n      const answer = await askLink();\n\n      if (['exit', 'quit'].includes(answer.trim().toLowerCase())) {\n        break;\n      }\n\n      currentPrompt += `\\nUser: ${answer}\\n`;\n    }\n\n    try {\n      await fs.unlink(tempFile);\n      logger.debug(`[Cleanup] Removed active prompt file`);\n    } catch {\n      // ignore cleanup errors\n    }\n\n    if (finalCode !== 0) {\n      process.exit(finalCode);\n    }\n  }\n}\n"],"mappings":"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","names":["fs","resolvedPath"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexical/cli",
-  "version": "0.11.15",
+  "version": "0.11.17",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -29,17 +29,23 @@
     ]
   },
   "dependencies": {
+    "@nexical/ai": "^0.1.3",
     "@nexical/cli-core": "^0.1.16",
     "dotenv": "^17.3.1",
     "fast-glob": "^3.3.3",
     "glob": "^13.0.5",
     "jiti": "^2.6.1",
+    "minimist": "^1.2.8",
+    "nunjucks": "^3.2.4",
+    "repomix": "^1.11.1",
     "yaml": "^2.8.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/fs-extra": "^11.0.4",
+    "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.0",
+    "@types/nunjucks": "^3.2.6",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",

package/src/commands/prompt.ts

@@ -0,0 +1,395 @@
+import { type CommandDefinition, BaseCommand, logger } from '@nexical/cli-core';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'node:os';
+import nunjucks from 'nunjucks';
+import minimist from 'minimist';
+import readline from 'node:readline';
+import YAML from 'yaml';
+import { pack } from 'repomix';
+import { existsSync, statSync } from 'node:fs';
+import { AiClientFactory } from '@nexical/ai';
+
+export default class PromptCommand extends BaseCommand {
+  static usage = 'prompt <prompt-name> [args...]';
+  static description = 'Run an AI prompt using templates from the prompts directory.';
+  static requiresProject = true;
+
+  static args: CommandDefinition = {
+    args: [
+      {
+        name: 'promptName',
+        required: true,
+        description: 'The name of the markdown file in the prompts directory.',
+      },
+      {
+        name: 'args...',
+        required: false,
+        description: 'Additional arguments for the template and command',
+      },
+    ],
+    options: [
+      {
+        name: '--module, -m <module>',
+        description:
+          'Target a specific module (searches apps/frontend/modules and apps/backend/modules)',
+      },
+      { name: '--interactive, -i', description: 'Run in interactive chat mode' },
+      {
+        name: '--models <models>',
+        description: 'Comma-separated list of models to try',
+        default: 'gemini-3-flash-preview,gemini-3-pro-preview',
+      },
+    ],
+  };
+
+  async run(options: {
+    promptName: string;
+    args?: string[];
+    module?: string;
+    m?: string;
+    interactive?: boolean;
+    i?: boolean;
+    models?: string;
+  }) {
+    const projectRoot = this.projectRoot as string;
+    const promptName = options.promptName;
+
+    // Parse additional template flags
+    const argv = minimist(options.args || []);
+    const isInteractive = options.interactive || options.i || argv.interactive || argv.i;
+    const moduleName = options.module || options.m || argv.module || argv.m;
+    const modelsArg =
+      options.models || argv.models || 'gemini-3-flash-preview,gemini-3-pro-preview';
+    const models = modelsArg
+      .split(',')
+      .map((m: string) => m.trim())
+      .filter(Boolean);
+
+    // Resolve prompt file from multiple directories
+    const promptFileName = promptName.endsWith('.md') ? promptName : `${promptName}.md`;
+    const PROMPTS_DIRS = [path.join(projectRoot, 'prompts')];
+    const generatorAgentsPrompts = path.join(projectRoot, 'packages/generator/prompts/agents');
+
+    if (await fs.pathExists(generatorAgentsPrompts)) {
+      PROMPTS_DIRS.push(generatorAgentsPrompts);
+    }
+
+    let promptFile: string | undefined;
+    for (const dir of PROMPTS_DIRS) {
+      const candidate = path.join(dir, promptFileName);
+      if (await fs.pathExists(candidate)) {
+        promptFile = candidate;
+        break;
+      }
+    }
+
+    if (!promptFile) {
+      this.error(
+        `Prompt file '${promptFileName}' not found in any of the search directories:\n` +
+          PROMPTS_DIRS.map((d) => `  - ${d}`).join('\n'),
+      );
+      return;
+    }
+
+    // Module Resolution Logic
+    const contextVars = { ...argv };
+    if (moduleName) {
+      const frontendPath = path.join(projectRoot, 'apps/frontend/modules', moduleName);
+      const backendPath = path.join(projectRoot, 'apps/backend/modules', moduleName);
+
+      let moduleRoot: string | undefined;
+      let moduleType: 'frontend' | 'backend' | undefined;
+
+      if (await fs.pathExists(frontendPath)) {
+        moduleRoot = frontendPath;
+        moduleType = 'frontend';
+      } else if (await fs.pathExists(backendPath)) {
+        moduleRoot = backendPath;
+        moduleType = 'backend';
+      }
+
+      if (!moduleRoot) {
+        this.error(
+          `Module '${moduleName}' not found in apps/frontend/modules or apps/backend/modules.`,
+        );
+        return;
+      }
+
+      logger.debug(`[Context] Targeting ${moduleType} module: ${moduleName}`);
+      contextVars.module_root = moduleRoot;
+      contextVars.module_name = moduleName;
+      contextVars.module_type = moduleType;
+      contextVars.root_path = moduleRoot + '/';
+    } else {
+      if (!contextVars.root_path) {
+        contextVars.root_path = process.cwd() + '/';
+      }
+    }
+
+    // Configure Nunjucks
+    const env = new nunjucks.Environment(new nunjucks.FileSystemLoader(PROMPTS_DIRS), {
+      autoescape: false,
+      trimBlocks: true,
+      lstripBlocks: true,
+    });
+
+    const asyncResolvers = new Map<string, Promise<string>>();
+    let resolverId = 0;
+
+    // Helper: context(path) -> runs repomix
+    env.addGlobal('context', (targetPath: string) => {
+      const id = `__NEXICAL_ASYNC_CONTEXT_${resolverId++}__`;
+      const promise = (async () => {
+        try {
+          if (!existsSync(targetPath)) {
+            logger.debug(`[Context] Path not found: ${targetPath}`);
+            return `[Path not found: ${targetPath}]`;
+          }
+
+          const stats = statSync(targetPath);
+          if (stats.isFile()) {
+            logger.debug(`[Context] Reading file directly at: ${targetPath}`);
+            const content = await fs.readFile(targetPath, 'utf-8');
+            return `<CODEBASE_CONTEXT path="${targetPath}">\n${content}\n</CODEBASE_CONTEXT>`;
+          }
+
+          logger.debug(`[Context] Analyzing codebase at: ${targetPath}`);
+          const tempOutputFile = path.join(
+            os.tmpdir(),
+            `repomix-output-${Date.now()}-${Math.random().toString(36).substring(7)}.xml`,
+          );
+
+          await pack([targetPath], {
+            input: { maxFileSize: 1024 * 1024 * 10 },
+            output: {
+              filePath: tempOutputFile,
+              style: 'xml',
+              showLineNumbers: false,
+              fileSummary: false,
+              directoryStructure: false,
+              removeComments: false,
+              removeEmptyLines: false,
+              includeEmptyDirectories: false,
+              topFilesLength: 5,
+              parsableStyle: false,
+              files: true,
+              compress: false,
+              truncateBase64: true,
+              copyToClipboard: false,
+              includeDiffs: false,
+              includeLogs: false,
+              includeLogsCount: 0,
+              gitSortByChanges: false,
+              includeFullDirectoryStructure: false,
+            },
+            ignore: {
+              useGitignore: true,
+              useDotIgnore: true,
+              useDefaultPatterns: true,
+              customPatterns: ['**/node_modules', '**/dist'],
+            },
+            include: [],
+            security: { enableSecurityCheck: false },
+            tokenCount: { encoding: 'o200k_base' },
+            cwd: targetPath,
+          } as unknown as Parameters<typeof pack>[1]);
+
+          const output = await fs.readFile(tempOutputFile, 'utf-8');
+          try {
+            await fs.unlink(tempOutputFile);
+          } catch {
+            /* ignore */
+          }
+          return `<CODEBASE_CONTEXT path="${targetPath}">\n${output}\n</CODEBASE_CONTEXT>`;
+        } catch (error) {
+          logger.error(`[Context] Error generating context for ${targetPath}: ${error}`);
+          return `[Error generating context for ${targetPath}]`;
+        }
+      })();
+      asyncResolvers.set(id, promise);
+      return id;
+    });
+
+    // Helper: read(path) -> reads local file
+    env.addGlobal('read', (relativePath: string | string[]) => {
+      const id = `__NEXICAL_ASYNC_READ_${resolverId++}__`;
+      const promise = (async () => {
+        try {
+          const cwdStr = process.cwd();
+          if (Array.isArray(relativePath)) {
+            const contents = await Promise.all(
+              relativePath.map(async (p) => {
+                const resolvedPath = path.resolve(cwdStr, p);
+                if (!existsSync(resolvedPath)) {
+                  logger.debug(`[Read] File not found: ${resolvedPath}`);
+                  return `[File not found: ${resolvedPath}]`;
+                }
+                return await fs.readFile(resolvedPath, 'utf-8');
+              }),
+            );
+            return contents.join('\n\n');
+          } else if (typeof relativePath === 'string' && relativePath.includes(',')) {
+            const contents = await Promise.all(
+              relativePath.split(',').map(async (p) => {
+                const resolvedPath = path.resolve(cwdStr, p.trim());
+                if (!existsSync(resolvedPath)) {
+                  logger.debug(`[Read] File not found: ${resolvedPath}`);
+                  return `[File not found: ${resolvedPath}]`;
+                }
+                return await fs.readFile(resolvedPath, 'utf-8');
+              }),
+            );
+            return contents.join('\n\n');
+          }
+
+          const resolvedPath = path.resolve(cwdStr, relativePath as string);
+          if (!existsSync(resolvedPath)) {
+            logger.debug(`[Read] File not found: ${resolvedPath}`);
+            return `[File not found: ${resolvedPath}]`;
+          }
+          return await fs.readFile(resolvedPath, 'utf-8');
+        } catch {
+          logger.warn(`[Read] Warning: Could not read file: ${relativePath}`);
+          return `[Error reading file ${relativePath}]`;
+        }
+      })();
+      asyncResolvers.set(id, promise);
+      return id;
+    });
+
+    // Read template content
+    let templateContent: string;
+    try {
+      templateContent = await fs.readFile(promptFile, 'utf-8');
+    } catch (error) {
+      if (error instanceof Error) {
+        this.error(`Error reading prompt file: ${error.message}`);
+      } else {
+        this.error(`Error reading prompt file: ${String(error)}`);
+      }
+      return;
+    }
+
+    // Render template
+    logger.debug(
+      `[Render] Rendering template with variables:`,
+      JSON.stringify(contextVars, null, 2),
+    );
+    let renderedPrompt: string;
+    try {
+      renderedPrompt = env.renderString(templateContent, {
+        ...contextVars,
+      });
+    } catch (e) {
+      this.error(`Template render error: ${e}`);
+      return;
+    }
+
+    // Resolve placeholders
+    for (const [id, promise] of asyncResolvers.entries()) {
+      try {
+        const resolvedValue = await promise;
+        renderedPrompt = renderedPrompt.replace(id, resolvedValue);
+      } catch (e) {
+        logger.error(`[Render] Failed to resolve async variable ${id}: ${e}`);
+        renderedPrompt = renderedPrompt.replace(id, `[Error resolving id]`);
+      }
+    }
+
+    // Buffer to file
+    const tempFile = path.join(os.tmpdir(), '.temp_prompt_active.md');
+    await fs.writeFile(tempFile, renderedPrompt, 'utf-8');
+    logger.debug(`[Buffer] Wrote active prompt to ${tempFile}`);
+
+    logger.info(`[Agent] Model rotation strategy: [${models.join(', ')}]`);
+
+    // Extract AI configuration from nexical.yaml
+    const configPath = path.join(projectRoot, 'nexical.yaml');
+    let aiConfig: Record<string, unknown> = {};
+    if (await fs.pathExists(configPath)) {
+      try {
+        const content = await fs.readFile(configPath, 'utf8');
+        const config = YAML.parse(content) || {};
+        aiConfig = (config.ai as Record<string, unknown>) || {};
+      } catch {
+        logger.warn('Failed to parse nexical.yaml AI config, using defaults.');
+      }
+    }
+
+    // Create AI client
+    const aiClient = AiClientFactory.create(aiConfig);
+
+    let currentPrompt = renderedPrompt;
+    let finalCode = 0;
+
+    while (true) {
+      let success = false;
+      let lastOutput = '';
+
+      for (const model of models) {
+        logger.info(`[Agent] Attempting with model: \x1b[36m${model}\x1b[0m...`);
+        const result = await aiClient.run(model, currentPrompt);
+
+        if (result.code === 0) {
+          success = true;
+          lastOutput = result.output;
+          break;
+        }
+
+        if (result.shouldRetry) {
+          logger.info(`[Agent] Switching to next model...`);
+          continue;
+        } else {
+          finalCode = result.code;
+          break;
+        }
+      }
+
+      if (!success) {
+        if (finalCode === 0) finalCode = 1;
+        this.error(`[Agent] \u274C All attempts failed.`);
+        break;
+      }
+
+      if (!isInteractive) {
+        break;
+      }
+
+      currentPrompt += `\n${lastOutput}`;
+
+      const askLink = () => {
+        const rl = readline.createInterface({
+          input: process.stdin,
+          output: process.stdout,
+        });
+        return new Promise<string>((resolve) => {
+          this.info('\n(Type "exit" or "quit" to end the session)');
+          rl.question('> ', (ans) => {
+            rl.close();
+            resolve(ans);
+          });
+        });
+      };
+
+      const answer = await askLink();
+
+      if (['exit', 'quit'].includes(answer.trim().toLowerCase())) {
+        break;
+      }
+
+      currentPrompt += `\nUser: ${answer}\n`;
+    }
+
+    try {
+      await fs.unlink(tempFile);
+      logger.debug(`[Cleanup] Removed active prompt file`);
+    } catch {
+      // ignore cleanup errors
+    }
+
+    if (finalCode !== 0) {
+      process.exit(finalCode);
+    }
+  }
+}

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.