@nexical/cli 0.11.0 → 0.11.2

package/dist/src/commands/module/update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/commands/module/update.ts"],"sourcesContent":["import { type CommandDefinition, BaseCommand, logger, runCommand } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\n\nexport default class ModuleUpdateCommand extends BaseCommand {\n    static usage = 'module update [name]';\n    static description = 'Update a specific module or all modules.';\n    static requiresProject = true;\n\n    static args: CommandDefinition = {\n        args: [\n            { name: 'name', required: false, description: 'Name of the module to update' }\n        ]\n    };\n\n    async run(options: any) {\n        const projectRoot = this.projectRoot as string;\n        let { name } = options;\n\n        this.info(name ? `Updating module ${name}...` : 'Updating all modules...');\n        logger.debug('Update context:', { name, projectRoot: projectRoot });\n\n        try {\n            if (name) {\n                const relativePath = `modules/${name}`;\n                const fullPath = path.resolve(projectRoot, relativePath);\n\n                if (!(await fs.pathExists(fullPath))) {\n                    this.error(`Module ${name} not found.`);\n                    return;\n                }\n\n                // Update specific module\n                // We enter the directory and pull? Or generic submodule update?\n                // Generic submodule update --remote src/modules/name\n                await runCommand(`git submodule update --remote --merge ${relativePath}`, projectRoot);\n            } else {\n                // Update all\n                await runCommand('git submodule update --remote --merge', projectRoot);\n            }\n\n            this.info('Syncing workspace dependencies...');\n            await runCommand('npm install', projectRoot);\n\n            this.success('Modules updated successfully.');\n        } catch (e: any) {\n            this.error(`Failed to update modules: ${e.message}`);\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAiC,aAAa,QAAQ,kBAAkB;AAExE,OAAO,UAAU;AAEjB,IAAqB,sBAArB,cAAiD,YAAY;AAAA,EACzD,OAAO,QAAQ;AAAA,EACf,OAAO,cAAc;AAAA,EACrB,OAAO,kBAAkB;AAAA,EAEzB,OAAO,OAA0B;AAAA,IAC7B,MAAM;AAAA,MACF,EAAE,MAAM,QAAQ,UAAU,OAAO,aAAa,+BAA+B;AAAA,IACjF;AAAA,EACJ;AAAA,EAEA,MAAM,IAAI,SAAc;AACpB,UAAM,cAAc,KAAK;AACzB,QAAI,EAAE,KAAK,IAAI;AAEf,SAAK,KAAK,OAAO,mBAAmB,IAAI,QAAQ,yBAAyB;AACzE,WAAO,MAAM,mBAAmB,EAAE,MAAM,YAAyB,CAAC;AAElE,QAAI;AACA,UAAI,MAAM;AACN,cAAM,eAAe,WAAW,IAAI;AACpC,cAAM,WAAW,KAAK,QAAQ,aAAa,YAAY;AAEvD,YAAI,CAAE,MAAM,gBAAAA,QAAG,WAAW,QAAQ,GAAI;AAClC,eAAK,MAAM,UAAU,IAAI,aAAa;AACtC;AAAA,QACJ;AAKA,cAAM,WAAW,yCAAyC,YAAY,IAAI,WAAW;AAAA,MACzF,OAAO;AAEH,cAAM,WAAW,yCAAyC,WAAW;AAAA,MACzE;AAEA,WAAK,KAAK,mCAAmC;AAC7C,YAAM,WAAW,eAAe,WAAW;AAE3C,WAAK,QAAQ,+BAA+B;AAAA,IAChD,SAAS,GAAQ;AACb,WAAK,MAAM,6BAA6B,EAAE,OAAO,EAAE;AAAA,IACvD;AAAA,EACJ;AACJ;","names":["fs"]}
+{"version":3,"sources":["../../../../src/commands/module/update.ts"],"sourcesContent":["import { type CommandDefinition, BaseCommand, logger, runCommand } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\n\nexport default class ModuleUpdateCommand extends BaseCommand {\n  static usage = 'module update [name]';\n  static description = 'Update a specific module or all modules.';\n  static requiresProject = true;\n\n  static args: CommandDefinition = {\n    args: [{ name: 'name', required: false, description: 'Name of the module to update' }],\n  };\n\n  async run(options: { name?: string }) {\n    const projectRoot = this.projectRoot as string;\n    const { name } = options;\n\n    this.info(name ? `Updating module ${name}...` : 'Updating all modules...');\n    logger.debug('Update context:', { name, projectRoot: projectRoot });\n\n    try {\n      if (name) {\n        const relativePath = `modules/${name}`;\n        const fullPath = path.resolve(projectRoot, relativePath);\n\n        if (!(await fs.pathExists(fullPath))) {\n          this.error(`Module ${name} not found.`);\n          return;\n        }\n\n        // Update specific module\n        // We enter the directory and pull? Or generic submodule update?\n        // Generic submodule update --remote src/modules/name\n        await runCommand(`git submodule update --remote --merge ${relativePath}`, projectRoot);\n      } else {\n        // Update all\n        await runCommand('git submodule update --remote --merge', projectRoot);\n      }\n\n      this.info('Syncing workspace dependencies...');\n      await runCommand('npm install', projectRoot);\n\n      this.success('Modules updated successfully.');\n    } catch (e: unknown) {\n      if (e instanceof Error) {\n        this.error(`Failed to update modules: ${e.message}`);\n      } else {\n        this.error(`Failed to update modules: ${String(e)}`);\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAiC,aAAa,QAAQ,kBAAkB;AAExE,OAAO,UAAU;AAEjB,IAAqB,sBAArB,cAAiD,YAAY;AAAA,EAC3D,OAAO,QAAQ;AAAA,EACf,OAAO,cAAc;AAAA,EACrB,OAAO,kBAAkB;AAAA,EAEzB,OAAO,OAA0B;AAAA,IAC/B,MAAM,CAAC,EAAE,MAAM,QAAQ,UAAU,OAAO,aAAa,+BAA+B,CAAC;AAAA,EACvF;AAAA,EAEA,MAAM,IAAI,SAA4B;AACpC,UAAM,cAAc,KAAK;AACzB,UAAM,EAAE,KAAK,IAAI;AAEjB,SAAK,KAAK,OAAO,mBAAmB,IAAI,QAAQ,yBAAyB;AACzE,WAAO,MAAM,mBAAmB,EAAE,MAAM,YAAyB,CAAC;AAElE,QAAI;AACF,UAAI,MAAM;AACR,cAAM,eAAe,WAAW,IAAI;AACpC,cAAM,WAAW,KAAK,QAAQ,aAAa,YAAY;AAEvD,YAAI,CAAE,MAAM,gBAAAA,QAAG,WAAW,QAAQ,GAAI;AACpC,eAAK,MAAM,UAAU,IAAI,aAAa;AACtC;AAAA,QACF;AAKA,cAAM,WAAW,yCAAyC,YAAY,IAAI,WAAW;AAAA,MACvF,OAAO;AAEL,cAAM,WAAW,yCAAyC,WAAW;AAAA,MACvE;AAEA,WAAK,KAAK,mCAAmC;AAC7C,YAAM,WAAW,eAAe,WAAW;AAE3C,WAAK,QAAQ,+BAA+B;AAAA,IAC9C,SAAS,GAAY;AACnB,UAAI,aAAa,OAAO;AACtB,aAAK,MAAM,6BAA6B,EAAE,OAAO,EAAE;AAAA,MACrD,OAAO;AACL,aAAK,MAAM,6BAA6B,OAAO,CAAC,CAAC,EAAE;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;","names":["fs"]}

package/dist/src/commands/run.d.ts

@@ -5,7 +5,10 @@ declare class RunCommand extends BaseCommand {
     static description: string;
     static requiresProject: boolean;
     static args: CommandDefinition;
-    run(options: any): Promise<void>;
+    run(options: {
+        script: string;
+        args?: string[];
+    }): Promise<void>;
 }
 
 export { RunCommand as default };

package/dist/src/commands/run.js

@@ -20,7 +20,11 @@ var RunCommand = class extends BaseCommand {
   static requiresProject = true;
   static args = {
     args: [
-      { name: "script", required: true, description: "The script to run (script-name OR module:script-name)" },
+      {
+        name: "script",
+        required: true,
+        description: "The script to run (script-name OR module:script-name)"
+      },
       { name: "args...", required: false, description: "Arguments for the script" }
     ]
   };
@@ -56,7 +60,11 @@ var RunCommand = class extends BaseCommand {
         return;
       }
     } catch (e) {
-      this.error(`Failed to read package.json at ${execPath}: ${e.message}`);
+      if (e instanceof Error) {
+        this.error(`Failed to read package.json at ${execPath}: ${e.message}`);
+      } else {
+        this.error(`Failed to read package.json at ${execPath}: ${String(e)}`);
+      }
       return;
     }
     const finalArgs = ["run", scriptName, "--", ...scriptArgs];

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/run.ts"],"sourcesContent":["import { type CommandDefinition, BaseCommand, logger } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\nimport { spawn } from 'child_process';\nimport process from 'node:process';\n\nexport default class RunCommand extends BaseCommand {\n    static usage = 'run <script> [args...]';\n    static description = 'Run a script inside the Nexical environment.';\n    static requiresProject = true;\n\n    static args: CommandDefinition = {\n        args: [\n            { name: 'script', required: true, description: 'The script to run (script-name OR module:script-name)' },\n            { name: 'args...', required: false, description: 'Arguments for the script' }\n        ]\n    };\n\n    async run(options: any) {\n        const projectRoot = this.projectRoot as string;\n        const script = options.script;\n        const scriptArgs = options.args || [];\n\n        if (!script) {\n            this.error('Please specify a script to run.');\n            return;\n        }\n\n        logger.debug('Run command context:', { script, args: scriptArgs, projectRoot });\n\n        let execPath = projectRoot;\n        let scriptName = script;\n\n        // Handle module:script syntax\n        if (script.includes(':')) {\n            const [moduleName, name] = script.split(':');\n            execPath = path.resolve(projectRoot, 'modules', moduleName);\n            scriptName = name;\n\n            logger.debug(`Resolving module script: ${moduleName}:${scriptName} at ${execPath}`);\n        } else {\n            logger.debug(`Resolving core script: ${scriptName} at ${execPath}`);\n        }\n\n        // Validate script existence\n        const pkgJsonPath = path.join(execPath, 'package.json');\n        if (!(await fs.pathExists(pkgJsonPath))) {\n            this.error(`Failed to find package.json at ${execPath}`);\n            return;\n        }\n\n        try {\n            const pkg = await fs.readJson(pkgJsonPath);\n            if (!pkg.scripts || !pkg.scripts[scriptName]) {\n                const type = script.includes(':') ? `module ${script.split(':')[0]}` : 'Nexical core';\n                this.error(`Script \"${scriptName}\" does not exist in ${type}`);\n                return;\n            }\n        } catch (e: any) {\n            this.error(`Failed to read package.json at ${execPath}: ${e.message}`);\n            return;\n        }\n\n        const finalArgs = ['run', scriptName, '--', ...scriptArgs];\n        logger.debug(`Executing: npm ${finalArgs.join(' ')} in ${execPath}`);\n\n        const child = spawn('npm', finalArgs, {\n            cwd: execPath,\n            stdio: 'inherit',\n            env: {\n                ...process.env,\n                FORCE_COLOR: '1'\n            }\n        });\n\n        // Handle process termination to kill child\n        const cleanup = () => {\n            child.kill();\n            process.exit();\n        };\n\n        process.on('SIGINT', cleanup);\n        process.on('SIGTERM', cleanup);\n\n        await new Promise<void>((resolve) => {\n            child.on('close', (code) => {\n                // Remove listeners to prevent memory leaks if this command is run multiple times in-process (e.g. tests)\n                process.off('SIGINT', cleanup);\n                process.off('SIGTERM', cleanup);\n\n                if (code !== 0) {\n                    process.exit(code || 1);\n                }\n                resolve();\n            });\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAiC,aAAa,cAAc;AAE5D,OAAO,UAAU;AACjB,SAAS,aAAa;AACtB,OAAO,aAAa;AAEpB,IAAqB,aAArB,cAAwC,YAAY;AAAA,EAChD,OAAO,QAAQ;AAAA,EACf,OAAO,cAAc;AAAA,EACrB,OAAO,kBAAkB;AAAA,EAEzB,OAAO,OAA0B;AAAA,IAC7B,MAAM;AAAA,MACF,EAAE,MAAM,UAAU,UAAU,MAAM,aAAa,wDAAwD;AAAA,MACvG,EAAE,MAAM,WAAW,UAAU,OAAO,aAAa,2BAA2B;AAAA,IAChF;AAAA,EACJ;AAAA,EAEA,MAAM,IAAI,SAAc;AACpB,UAAM,cAAc,KAAK;AACzB,UAAM,SAAS,QAAQ;AACvB,UAAM,aAAa,QAAQ,QAAQ,CAAC;AAEpC,QAAI,CAAC,QAAQ;AACT,WAAK,MAAM,iCAAiC;AAC5C;AAAA,IACJ;AAEA,WAAO,MAAM,wBAAwB,EAAE,QAAQ,MAAM,YAAY,YAAY,CAAC;AAE9E,QAAI,WAAW;AACf,QAAI,aAAa;AAGjB,QAAI,OAAO,SAAS,GAAG,GAAG;AACtB,YAAM,CAAC,YAAY,IAAI,IAAI,OAAO,MAAM,GAAG;AAC3C,iBAAW,KAAK,QAAQ,aAAa,WAAW,UAAU;AAC1D,mBAAa;AAEb,aAAO,MAAM,4BAA4B,UAAU,IAAI,UAAU,OAAO,QAAQ,EAAE;AAAA,IACtF,OAAO;AACH,aAAO,MAAM,0BAA0B,UAAU,OAAO,QAAQ,EAAE;AAAA,IACtE;AAGA,UAAM,cAAc,KAAK,KAAK,UAAU,cAAc;AACtD,QAAI,CAAE,MAAM,gBAAAA,QAAG,WAAW,WAAW,GAAI;AACrC,WAAK,MAAM,kCAAkC,QAAQ,EAAE;AACvD;AAAA,IACJ;AAEA,QAAI;AACA,YAAM,MAAM,MAAM,gBAAAA,QAAG,SAAS,WAAW;AACzC,UAAI,CAAC,IAAI,WAAW,CAAC,IAAI,QAAQ,UAAU,GAAG;AAC1C,cAAM,OAAO,OAAO,SAAS,GAAG,IAAI,UAAU,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK;AACvE,aAAK,MAAM,WAAW,UAAU,uBAAuB,IAAI,EAAE;AAC7D;AAAA,MACJ;AAAA,IACJ,SAAS,GAAQ;AACb,WAAK,MAAM,kCAAkC,QAAQ,KAAK,EAAE,OAAO,EAAE;AACrE;AAAA,IACJ;AAEA,UAAM,YAAY,CAAC,OAAO,YAAY,MAAM,GAAG,UAAU;AACzD,WAAO,MAAM,kBAAkB,UAAU,KAAK,GAAG,CAAC,OAAO,QAAQ,EAAE;AAEnE,UAAM,QAAQ,MAAM,OAAO,WAAW;AAAA,MAClC,KAAK;AAAA,MACL,OAAO;AAAA,MACP,KAAK;AAAA,QACD,GAAG,QAAQ;AAAA,QACX,aAAa;AAAA,MACjB;AAAA,IACJ,CAAC;AAGD,UAAM,UAAU,MAAM;AAClB,YAAM,KAAK;AACX,cAAQ,KAAK;AAAA,IACjB;AAEA,YAAQ,GAAG,UAAU,OAAO;AAC5B,YAAQ,GAAG,WAAW,OAAO;AAE7B,UAAM,IAAI,QAAc,CAAC,YAAY;AACjC,YAAM,GAAG,SAAS,CAAC,SAAS;AAExB,gBAAQ,IAAI,UAAU,OAAO;AAC7B,gBAAQ,IAAI,WAAW,OAAO;AAE9B,YAAI,SAAS,GAAG;AACZ,kBAAQ,KAAK,QAAQ,CAAC;AAAA,QAC1B;AACA,gBAAQ;AAAA,MACZ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AACJ;","names":["fs"]}
+{"version":3,"sources":["../../../src/commands/run.ts"],"sourcesContent":["import { type CommandDefinition, BaseCommand, logger } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\nimport { spawn } from 'child_process';\nimport process from 'node:process';\n\nexport default class RunCommand extends BaseCommand {\n  static usage = 'run <script> [args...]';\n  static description = 'Run a script inside the Nexical environment.';\n  static requiresProject = true;\n\n  static args: CommandDefinition = {\n    args: [\n      {\n        name: 'script',\n        required: true,\n        description: 'The script to run (script-name OR module:script-name)',\n      },\n      { name: 'args...', required: false, description: 'Arguments for the script' },\n    ],\n  };\n\n  async run(options: { script: string; args?: string[] }) {\n    const projectRoot = this.projectRoot as string;\n    const script = options.script;\n    const scriptArgs = options.args || [];\n\n    if (!script) {\n      this.error('Please specify a script to run.');\n      return;\n    }\n\n    logger.debug('Run command context:', { script, args: scriptArgs, projectRoot });\n\n    let execPath = projectRoot;\n    let scriptName = script;\n\n    // Handle module:script syntax\n    if (script.includes(':')) {\n      const [moduleName, name] = script.split(':');\n      execPath = path.resolve(projectRoot, 'modules', moduleName);\n      scriptName = name;\n\n      logger.debug(`Resolving module script: ${moduleName}:${scriptName} at ${execPath}`);\n    } else {\n      logger.debug(`Resolving core script: ${scriptName} at ${execPath}`);\n    }\n\n    // Validate script existence\n    const pkgJsonPath = path.join(execPath, 'package.json');\n    if (!(await fs.pathExists(pkgJsonPath))) {\n      this.error(`Failed to find package.json at ${execPath}`);\n      return;\n    }\n\n    try {\n      const pkg = await fs.readJson(pkgJsonPath);\n      if (!pkg.scripts || !pkg.scripts[scriptName]) {\n        const type = script.includes(':') ? `module ${script.split(':')[0]}` : 'Nexical core';\n        this.error(`Script \"${scriptName}\" does not exist in ${type}`);\n        return;\n      }\n    } catch (e: unknown) {\n      if (e instanceof Error) {\n        this.error(`Failed to read package.json at ${execPath}: ${e.message}`);\n      } else {\n        this.error(`Failed to read package.json at ${execPath}: ${String(e)}`);\n      }\n      return;\n    }\n\n    const finalArgs = ['run', scriptName, '--', ...scriptArgs];\n    logger.debug(`Executing: npm ${finalArgs.join(' ')} in ${execPath}`);\n\n    const child = spawn('npm', finalArgs, {\n      cwd: execPath,\n      stdio: 'inherit',\n      env: {\n        ...process.env,\n        FORCE_COLOR: '1',\n      },\n    });\n\n    // Handle process termination to kill child\n    const cleanup = () => {\n      child.kill();\n      process.exit();\n    };\n\n    process.on('SIGINT', cleanup);\n    process.on('SIGTERM', cleanup);\n\n    await new Promise<void>((resolve) => {\n      child.on('close', (code) => {\n        // Remove listeners to prevent memory leaks if this command is run multiple times in-process (e.g. tests)\n        process.off('SIGINT', cleanup);\n        process.off('SIGTERM', cleanup);\n\n        if (code !== 0) {\n          process.exit(code || 1);\n        }\n        resolve();\n      });\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAiC,aAAa,cAAc;AAE5D,OAAO,UAAU;AACjB,SAAS,aAAa;AACtB,OAAO,aAAa;AAEpB,IAAqB,aAArB,cAAwC,YAAY;AAAA,EAClD,OAAO,QAAQ;AAAA,EACf,OAAO,cAAc;AAAA,EACrB,OAAO,kBAAkB;AAAA,EAEzB,OAAO,OAA0B;AAAA,IAC/B,MAAM;AAAA,MACJ;AAAA,QACE,MAAM;AAAA,QACN,UAAU;AAAA,QACV,aAAa;AAAA,MACf;AAAA,MACA,EAAE,MAAM,WAAW,UAAU,OAAO,aAAa,2BAA2B;AAAA,IAC9E;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,SAA8C;AACtD,UAAM,cAAc,KAAK;AACzB,UAAM,SAAS,QAAQ;AACvB,UAAM,aAAa,QAAQ,QAAQ,CAAC;AAEpC,QAAI,CAAC,QAAQ;AACX,WAAK,MAAM,iCAAiC;AAC5C;AAAA,IACF;AAEA,WAAO,MAAM,wBAAwB,EAAE,QAAQ,MAAM,YAAY,YAAY,CAAC;AAE9E,QAAI,WAAW;AACf,QAAI,aAAa;AAGjB,QAAI,OAAO,SAAS,GAAG,GAAG;AACxB,YAAM,CAAC,YAAY,IAAI,IAAI,OAAO,MAAM,GAAG;AAC3C,iBAAW,KAAK,QAAQ,aAAa,WAAW,UAAU;AAC1D,mBAAa;AAEb,aAAO,MAAM,4BAA4B,UAAU,IAAI,UAAU,OAAO,QAAQ,EAAE;AAAA,IACpF,OAAO;AACL,aAAO,MAAM,0BAA0B,UAAU,OAAO,QAAQ,EAAE;AAAA,IACpE;AAGA,UAAM,cAAc,KAAK,KAAK,UAAU,cAAc;AACtD,QAAI,CAAE,MAAM,gBAAAA,QAAG,WAAW,WAAW,GAAI;AACvC,WAAK,MAAM,kCAAkC,QAAQ,EAAE;AACvD;AAAA,IACF;AAEA,QAAI;AACF,YAAM,MAAM,MAAM,gBAAAA,QAAG,SAAS,WAAW;AACzC,UAAI,CAAC,IAAI,WAAW,CAAC,IAAI,QAAQ,UAAU,GAAG;AAC5C,cAAM,OAAO,OAAO,SAAS,GAAG,IAAI,UAAU,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK;AACvE,aAAK,MAAM,WAAW,UAAU,uBAAuB,IAAI,EAAE;AAC7D;AAAA,MACF;AAAA,IACF,SAAS,GAAY;AACnB,UAAI,aAAa,OAAO;AACtB,aAAK,MAAM,kCAAkC,QAAQ,KAAK,EAAE,OAAO,EAAE;AAAA,MACvE,OAAO;AACL,aAAK,MAAM,kCAAkC,QAAQ,KAAK,OAAO,CAAC,CAAC,EAAE;AAAA,MACvE;AACA;AAAA,IACF;AAEA,UAAM,YAAY,CAAC,OAAO,YAAY,MAAM,GAAG,UAAU;AACzD,WAAO,MAAM,kBAAkB,UAAU,KAAK,GAAG,CAAC,OAAO,QAAQ,EAAE;AAEnE,UAAM,QAAQ,MAAM,OAAO,WAAW;AAAA,MACpC,KAAK;AAAA,MACL,OAAO;AAAA,MACP,KAAK;AAAA,QACH,GAAG,QAAQ;AAAA,QACX,aAAa;AAAA,MACf;AAAA,IACF,CAAC;AAGD,UAAM,UAAU,MAAM;AACpB,YAAM,KAAK;AACX,cAAQ,KAAK;AAAA,IACf;AAEA,YAAQ,GAAG,UAAU,OAAO;AAC5B,YAAQ,GAAG,WAAW,OAAO;AAE7B,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,YAAM,GAAG,SAAS,CAAC,SAAS;AAE1B,gBAAQ,IAAI,UAAU,OAAO;AAC7B,gBAAQ,IAAI,WAAW,OAAO;AAE9B,YAAI,SAAS,GAAG;AACd,kBAAQ,KAAK,QAAQ,CAAC;AAAA,QACxB;AACA,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;","names":["fs"]}

package/dist/src/commands/setup.js

@@ -21,7 +21,7 @@ var SetupCommand = class extends BaseCommand {
       process.exit(1);
     }
     const apps = ["frontend", "backend"];
-    const sharedAssets = ["prisma", "src", "public", "locales", "scripts", "astro.config.mjs", "tsconfig.json"];
+    const sharedAssets = ["prisma", "src", "public", "locales", "scripts"];
     for (const app of apps) {
       const appDir = path.join(rootDir, "apps", app);
       if (!import_fs_extra.default.existsSync(appDir)) {
@@ -40,16 +40,21 @@ var SetupCommand = class extends BaseCommand {
           const destDir = path.dirname(dest);
           await import_fs_extra.default.ensureDir(destDir);
           try {
-            const stats = import_fs_extra.default.lstatSync(dest);
+            import_fs_extra.default.lstatSync(dest);
             import_fs_extra.default.removeSync(dest);
           } catch (e) {
-            if (e.code !== "ENOENT") throw e;
+            if (e && typeof e === "object" && "code" in e && e.code !== "ENOENT")
+              throw e;
           }
           const relSource = path.relative(destDir, source);
           await import_fs_extra.default.symlink(relSource, dest);
           logger.debug(`Symlinked ${asset} to ${app}`);
         } catch (e) {
-          this.error(`Failed to symlink ${asset} to ${app}: ${e.message}`);
+          if (e instanceof Error) {
+            this.error(`Failed to symlink ${asset} to ${app}: ${e.message}`);
+          } else {
+            this.error(`Failed to symlink ${asset} to ${app}: ${String(e)}`);
+          }
         }
       }
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/setup.ts"],"sourcesContent":["import { BaseCommand, logger } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\n\nexport default class SetupCommand extends BaseCommand {\n    static description = 'Setup the application environment by symlinking core assets.';\n\n    async run() {\n        // We assume we are in the project root\n        // But the CLI might be run from anywhere?\n        // findProjectRoot in index.ts handles finding the root.\n        // BaseCommand has this.projectRoot?\n\n        // BaseCommand doesn't expose projectRoot directly in current implementation seen in memory, checking source if possible?\n        // InitCommand used process.cwd().\n\n        // Let's assume process.cwd() is project root if run via `npm run setup` from root.\n        const rootDir = process.cwd();\n\n        // Verify we are in the right place\n        if (!fs.existsSync(path.join(rootDir, 'core'))) {\n            this.error('Could not find \"core\" directory. Are you in the project root?');\n            process.exit(1);\n        }\n\n        const apps = ['frontend', 'backend'];\n        const sharedAssets = ['prisma', 'src', 'public', 'locales', 'scripts', 'astro.config.mjs', 'tsconfig.json']; // tsconfig might be needed if extended\n\n        for (const app of apps) {\n            const appDir = path.join(rootDir, 'apps', app);\n            if (!fs.existsSync(appDir)) {\n                this.warn(`App directory ${app} not found. Skipping.`);\n                continue;\n            }\n\n            this.info(`Setting up ${app}...`);\n\n            for (const asset of sharedAssets) {\n                const source = path.join(rootDir, 'core', asset);\n                const dest = path.join(appDir, asset);\n\n                if (!fs.existsSync(source)) {\n                    this.warn(`Source asset ${asset} not found in core.`);\n                    continue;\n                }\n\n                try {\n                    // Remove existing destination if it exists (to ensure clean symlink)\n                    // Be careful not to delete real files if they aren't symlinks?\n                    // For now, we assume setup controls these.\n\n                    const destDir = path.dirname(dest);\n                    await fs.ensureDir(destDir);\n\n                    try {\n                        const stats = fs.lstatSync(dest);\n                        fs.removeSync(dest);\n                    } catch (e: any) {\n                        if (e.code !== 'ENOENT') throw e;\n                    }\n\n                    const relSource = path.relative(destDir, source);\n                    await fs.symlink(relSource, dest);\n\n                    logger.debug(`Symlinked ${asset} to ${app}`);\n                } catch (e: any) {\n                    this.error(`Failed to symlink ${asset} to ${app}: ${e.message}`);\n                }\n            }\n        }\n\n        this.success('Application setup complete.');\n    }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAS,aAAa,cAAc;AAEpC,OAAO,UAAU;AAEjB,IAAqB,eAArB,cAA0C,YAAY;AAAA,EAClD,OAAO,cAAc;AAAA,EAErB,MAAM,MAAM;AAUR,UAAM,UAAU,QAAQ,IAAI;AAG5B,QAAI,CAAC,gBAAAA,QAAG,WAAW,KAAK,KAAK,SAAS,MAAM,CAAC,GAAG;AAC5C,WAAK,MAAM,+DAA+D;AAC1E,cAAQ,KAAK,CAAC;AAAA,IAClB;AAEA,UAAM,OAAO,CAAC,YAAY,SAAS;AACnC,UAAM,eAAe,CAAC,UAAU,OAAO,UAAU,WAAW,WAAW,oBAAoB,eAAe;AAE1G,eAAW,OAAO,MAAM;AACpB,YAAM,SAAS,KAAK,KAAK,SAAS,QAAQ,GAAG;AAC7C,UAAI,CAAC,gBAAAA,QAAG,WAAW,MAAM,GAAG;AACxB,aAAK,KAAK,iBAAiB,GAAG,uBAAuB;AACrD;AAAA,MACJ;AAEA,WAAK,KAAK,cAAc,GAAG,KAAK;AAEhC,iBAAW,SAAS,cAAc;AAC9B,cAAM,SAAS,KAAK,KAAK,SAAS,QAAQ,KAAK;AAC/C,cAAM,OAAO,KAAK,KAAK,QAAQ,KAAK;AAEpC,YAAI,CAAC,gBAAAA,QAAG,WAAW,MAAM,GAAG;AACxB,eAAK,KAAK,gBAAgB,KAAK,qBAAqB;AACpD;AAAA,QACJ;AAEA,YAAI;AAKA,gBAAM,UAAU,KAAK,QAAQ,IAAI;AACjC,gBAAM,gBAAAA,QAAG,UAAU,OAAO;AAE1B,cAAI;AACA,kBAAM,QAAQ,gBAAAA,QAAG,UAAU,IAAI;AAC/B,4BAAAA,QAAG,WAAW,IAAI;AAAA,UACtB,SAAS,GAAQ;AACb,gBAAI,EAAE,SAAS,SAAU,OAAM;AAAA,UACnC;AAEA,gBAAM,YAAY,KAAK,SAAS,SAAS,MAAM;AAC/C,gBAAM,gBAAAA,QAAG,QAAQ,WAAW,IAAI;AAEhC,iBAAO,MAAM,aAAa,KAAK,OAAO,GAAG,EAAE;AAAA,QAC/C,SAAS,GAAQ;AACb,eAAK,MAAM,qBAAqB,KAAK,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE;AAAA,QACnE;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,QAAQ,6BAA6B;AAAA,EAC9C;AACJ;","names":["fs"]}
+{"version":3,"sources":["../../../src/commands/setup.ts"],"sourcesContent":["import { BaseCommand, logger } from '@nexical/cli-core';\nimport fs from 'fs-extra';\nimport path from 'path';\n\nexport default class SetupCommand extends BaseCommand {\n  static description = 'Setup the application environment by symlinking core assets.';\n\n  async run() {\n    // We assume we are in the project root\n    // But the CLI might be run from anywhere?\n    // findProjectRoot in index.ts handles finding the root.\n    // BaseCommand has this.projectRoot?\n\n    // BaseCommand doesn't expose projectRoot directly in current implementation seen in memory, checking source if possible?\n    // InitCommand used process.cwd().\n\n    // Let's assume process.cwd() is project root if run via `npm run setup` from root.\n    const rootDir = process.cwd();\n\n    // Verify we are in the right place\n    if (!fs.existsSync(path.join(rootDir, 'core'))) {\n      this.error('Could not find \"core\" directory. Are you in the project root?');\n      process.exit(1);\n    }\n\n    const apps = ['frontend', 'backend'];\n    const sharedAssets = ['prisma', 'src', 'public', 'locales', 'scripts']; // tsconfig might be needed if extended\n\n    for (const app of apps) {\n      const appDir = path.join(rootDir, 'apps', app);\n      if (!fs.existsSync(appDir)) {\n        this.warn(`App directory ${app} not found. Skipping.`);\n        continue;\n      }\n\n      this.info(`Setting up ${app}...`);\n\n      for (const asset of sharedAssets) {\n        const source = path.join(rootDir, 'core', asset);\n        const dest = path.join(appDir, asset);\n\n        if (!fs.existsSync(source)) {\n          this.warn(`Source asset ${asset} not found in core.`);\n          continue;\n        }\n\n        try {\n          // Remove existing destination if it exists (to ensure clean symlink)\n          // Be careful not to delete real files if they aren't symlinks?\n          // For now, we assume setup controls these.\n\n          const destDir = path.dirname(dest);\n          await fs.ensureDir(destDir);\n\n          try {\n            fs.lstatSync(dest);\n            fs.removeSync(dest);\n          } catch (e: unknown) {\n            if (\n              e &&\n              typeof e === 'object' &&\n              'code' in e &&\n              (e as { code: string }).code !== 'ENOENT'\n            )\n              throw e;\n          }\n\n          const relSource = path.relative(destDir, source);\n          await fs.symlink(relSource, dest);\n\n          logger.debug(`Symlinked ${asset} to ${app}`);\n        } catch (e: unknown) {\n          if (e instanceof Error) {\n            this.error(`Failed to symlink ${asset} to ${app}: ${e.message}`);\n          } else {\n            this.error(`Failed to symlink ${asset} to ${app}: ${String(e)}`);\n          }\n        }\n      }\n    }\n\n    this.success('Application setup complete.');\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,sBAAe;AADf,SAAS,aAAa,cAAc;AAEpC,OAAO,UAAU;AAEjB,IAAqB,eAArB,cAA0C,YAAY;AAAA,EACpD,OAAO,cAAc;AAAA,EAErB,MAAM,MAAM;AAUV,UAAM,UAAU,QAAQ,IAAI;AAG5B,QAAI,CAAC,gBAAAA,QAAG,WAAW,KAAK,KAAK,SAAS,MAAM,CAAC,GAAG;AAC9C,WAAK,MAAM,+DAA+D;AAC1E,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,OAAO,CAAC,YAAY,SAAS;AACnC,UAAM,eAAe,CAAC,UAAU,OAAO,UAAU,WAAW,SAAS;AAErE,eAAW,OAAO,MAAM;AACtB,YAAM,SAAS,KAAK,KAAK,SAAS,QAAQ,GAAG;AAC7C,UAAI,CAAC,gBAAAA,QAAG,WAAW,MAAM,GAAG;AAC1B,aAAK,KAAK,iBAAiB,GAAG,uBAAuB;AACrD;AAAA,MACF;AAEA,WAAK,KAAK,cAAc,GAAG,KAAK;AAEhC,iBAAW,SAAS,cAAc;AAChC,cAAM,SAAS,KAAK,KAAK,SAAS,QAAQ,KAAK;AAC/C,cAAM,OAAO,KAAK,KAAK,QAAQ,KAAK;AAEpC,YAAI,CAAC,gBAAAA,QAAG,WAAW,MAAM,GAAG;AAC1B,eAAK,KAAK,gBAAgB,KAAK,qBAAqB;AACpD;AAAA,QACF;AAEA,YAAI;AAKF,gBAAM,UAAU,KAAK,QAAQ,IAAI;AACjC,gBAAM,gBAAAA,QAAG,UAAU,OAAO;AAE1B,cAAI;AACF,4BAAAA,QAAG,UAAU,IAAI;AACjB,4BAAAA,QAAG,WAAW,IAAI;AAAA,UACpB,SAAS,GAAY;AACnB,gBACE,KACA,OAAO,MAAM,YACb,UAAU,KACT,EAAuB,SAAS;AAEjC,oBAAM;AAAA,UACV;AAEA,gBAAM,YAAY,KAAK,SAAS,SAAS,MAAM;AAC/C,gBAAM,gBAAAA,QAAG,QAAQ,WAAW,IAAI;AAEhC,iBAAO,MAAM,aAAa,KAAK,OAAO,GAAG,EAAE;AAAA,QAC7C,SAAS,GAAY;AACnB,cAAI,aAAa,OAAO;AACtB,iBAAK,MAAM,qBAAqB,KAAK,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE;AAAA,UACjE,OAAO;AACL,iBAAK,MAAM,qBAAqB,KAAK,OAAO,GAAG,KAAK,OAAO,CAAC,CAAC,EAAE;AAAA,UACjE;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,SAAK,QAAQ,6BAA6B;AAAA,EAC5C;AACF;","names":["fs"]}

package/dist/src/utils/discovery.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   discoverCommandDirectories
-} from "../../chunk-OKXOCNXP.js";
+} from "../../chunk-AC4B3HPJ.js";
 import "../../chunk-OYFWMYPG.js";
 export {
   discoverCommandDirectories

package/dist/src/utils/git.js

@@ -11,7 +11,7 @@ import {
   renameBranch,
   renameRemote,
   updateSubmodules
-} from "../../chunk-WKERTCM6.js";
+} from "../../chunk-Q7YLW5HJ.js";
 import "../../chunk-OYFWMYPG.js";
 export {
   addAll,

package/dist/src/utils/url-resolver.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   resolveGitUrl
-} from "../../chunk-JYASTIIW.js";
+} from "../../chunk-PJIOCW2A.js";
 import "../../chunk-OYFWMYPG.js";
 export {
   resolveGitUrl

package/eslint.config.mjs

@@ -0,0 +1,67 @@
+import eslintPluginAstro from 'eslint-plugin-astro';
+import eslintPluginReact from 'eslint-plugin-react';
+import eslintPluginReactHooks from 'eslint-plugin-react-hooks';
+import eslintPluginJsxA11y from 'eslint-plugin-jsx-a11y';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import tseslint from 'typescript-eslint';
+import globals from 'globals';
+import js from '@eslint/js';
+
+export default tseslint.config(
+  // Global ignore
+  {
+    ignores: ['**/dist/**', '**/node_modules/**', '**/coverage/**', '**/.astro/**', '**/.agent/**'],
+  },
+
+  // Base JS/TS configuration
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+
+  // React configuration
+  {
+    files: ['**/*.{js,jsx,mjs,cjs,ts,tsx}'],
+    plugins: {
+      react: eslintPluginReact,
+      'react-hooks': eslintPluginReactHooks,
+      'jsx-a11y': eslintPluginJsxA11y,
+    },
+    languageOptions: {
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      ...eslintPluginReact.configs.recommended.rules,
+      ...eslintPluginReactHooks.configs.recommended.rules,
+      ...eslintPluginJsxA11y.configs.recommended.rules,
+      'react/react-in-jsx-scope': 'off', // Not needed in React 17+ or Astro
+      'react/no-unknown-property': 'off', // Conflicts with some Astro/Web Component patterns
+    },
+  },
+
+  // Astro configuration
+  ...eslintPluginAstro.configs.recommended,
+
+  // Custom rules override
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['error', { args: 'none', varsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn', // Downgrade to warning for now as codebase has some anys
+      'no-console': ['warn', { allow: ['warn', 'error', 'info'] }],
+    },
+  },
+
+  // Prettier must be last to override conflicting rules
+  eslintConfigPrettier,
+);

package/index.ts

@@ -8,31 +8,45 @@ import path from 'node:path';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 const commandName = 'nexical';
-const projectRoot = await findProjectRoot(commandName, process.cwd()) || process.cwd();
+const projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();
 const coreCommandsDir = path.resolve(__dirname, './src/commands');
 const additionalCommands = discoverCommandDirectories(projectRoot);
 
-// Filter out the source version of core commands if we are running from dist
-const filteredAdditional = additionalCommands.filter(dir => {
-    if (dir === coreCommandsDir) return false;
-
-    // Handle the case where we are running from dist/ and it finds src/commands in projectRoot
-    if (coreCommandsDir.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {
-        const srcVersion = coreCommandsDir.replace(
-            path.join(path.sep, 'dist', 'src', 'commands'),
-            path.join(path.sep, 'src', 'commands')
-        );
-        if (dir === srcVersion) return false;
-    }
-    return true;
+// Filter out duplicate core commands and source versions
+const filteredAdditional = additionalCommands.filter((dir) => {
+  const resolvedDir = path.resolve(dir);
+  const resolvedCore = path.resolve(coreCommandsDir);
+
+  if (resolvedDir === resolvedCore) return false;
+
+  // Check if this is another instance of the core CLI commands (by checking path suffix)
+  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');
+  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');
+  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');
+
+  if (
+    resolvedDir.endsWith(coreSuffix) ||
+    resolvedDir.endsWith(coreSuffixSrc) ||
+    resolvedDir.endsWith(coreSuffixRawSrc)
+  ) {
+    return false;
+  }
+
+  // Handle mismatch between dist/src and src/
+  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {
+    const srcVersion = resolvedCore.replace(
+      path.join(path.sep, 'dist', 'src', 'commands'),
+      path.join(path.sep, 'src', 'commands'),
+    );
+    if (resolvedDir === srcVersion) return false;
+  }
+
+  return true;
 });
 
 const app = new CLI({
-    version: pkg.version,
-    commandName: commandName,
-    searchDirectories: [...new Set([
-        coreCommandsDir,
-        ...filteredAdditional
-    ])]
+  version: pkg.version,
+  commandName: commandName,
+  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],
 });
 app.start();

package/package.json

@@ -1,34 +1,58 @@
 {
-    "name": "@nexical/cli",
-    "version": "0.11.0",
-    "type": "module",
-    "bin": {
-        "nexical": "./dist/index.js"
-    },
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "start": "node dist/index.js",
-        "test": "npm run test:unit && npm run test:integration && npm run test:e2e",
-        "test:unit": "vitest run --config vitest.config.ts --coverage",
-        "test:integration": "vitest run --config vitest.integration.config.ts",
-        "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts",
-        "test:watch": "vitest"
-    },
-    "dependencies": {
-        "@nexical/cli-core": "^0.1.12",
-        "yaml": "^2.3.4",
-        "fast-glob": "^3.3.3"
-    },
-    "devDependencies": {
-        "@types/fs-extra": "^11.0.4",
-        "@types/node": "^20.10.0",
-        "@vitest/coverage-v8": "^4.0.15",
-        "execa": "^9.6.1",
-        "fs-extra": "^11.3.2",
-        "tsup": "^8.0.1",
-        "tsx": "^4.21.0",
-        "typescript": "^5.3.3",
-        "vitest": "^4.0.15"
-    }
+  "name": "@nexical/cli",
+  "version": "0.11.2",
+  "type": "module",
+  "bin": {
+    "nexical": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "test": "npm run test:unit && npm run test:integration && npm run test:e2e",
+    "test:unit": "vitest run --config vitest.config.ts --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "**/*": [
+      "prettier --write --ignore-unknown"
+    ],
+    "**/*.{js,jsx,ts,tsx,astro}": [
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "@nexical/cli-core": "^0.1.12",
+    "yaml": "^2.3.4",
+    "fast-glob": "^3.3.3"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.2",
+    "tsup": "^8.0.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.15",
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-astro": "^1.5.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "globals": "^17.2.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "typescript-eslint": "^8.54.0"
+  }
 }

package/src/commands/init.ts

@@ -5,82 +5,85 @@ import fs from 'fs-extra';
 import path from 'path';
 
 export default class InitCommand extends BaseCommand {
-    static usage = 'init';
-    static description = 'Initialize a new Nexical project.';
-    static requiresProject = false;
-
-    static args: CommandDefinition = {
-        args: [
-            { name: 'directory', required: true, description: 'Directory to initialize the project in' }
-        ],
-        options: [
-            {
-                name: '--repo <url>',
-                description: 'Starter repository URL (supports gh@owner/repo syntax)',
-                default: 'gh@nexical/app-starter'
-            }
-        ]
-    };
-
-    async run(options: any) {
-        const directory = options.directory;
-        const targetPath = path.resolve(process.cwd(), directory);
-        let repoUrl = resolveGitUrl(options.repo);
-
-        logger.debug('Init options:', { directory, targetPath, repoUrl });
-
-        this.info(`Initializing project in: ${targetPath}`);
-        this.info(`Using starter repository: ${repoUrl}`);
-
-        if (await fs.pathExists(targetPath)) {
-            if ((await fs.readdir(targetPath)).length > 0) {
-                this.error(`Directory ${directory} is not empty.`);
-                process.exit(1);
-            }
-        } else {
-            await fs.mkdir(targetPath, { recursive: true });
-        }
-
-        try {
-            this.info('Cloning starter repository...');
-            await git.clone(repoUrl, targetPath, { recursive: true });
-
-            this.info('Updating submodules...');
-            await git.updateSubmodules(targetPath);
-
-            this.info('Installing dependencies...');
-            await runCommand('npm install', targetPath);
-
-            this.info('Setting up upstream remote...');
-            await git.renameRemote('origin', 'upstream', targetPath);
-
-            // Run setup script
-            this.info('Running project setup...');
-            await runCommand('npm run setup', targetPath);
-
-            // Check for nexical.yaml, if not present create a default one
-            const configPath = path.join(targetPath, 'nexical.yaml');
-            if (!await fs.pathExists(configPath)) {
-                this.info('Creating default nexical.yaml...');
-                await fs.writeFile(configPath, 'name: ' + path.basename(targetPath) + '\nmodules: []\n');
-            }
-
-            // Create VERSION file
-            const versionPath = path.join(targetPath, 'VERSION');
-            // Check if version file exists, if not create it
-            if (!await fs.pathExists(versionPath)) {
-                this.info('Creating VERSION file with 0.1.0...');
-                await fs.writeFile(versionPath, '0.1.0');
-            }
-
-            await git.addAll(targetPath);
-            await git.commit('Initial site commit', targetPath);
-
-            this.success(`Project initialized successfully in ${directory}!`);
+  static usage = 'init';
+  static description = 'Initialize a new Nexical project.';
+  static requiresProject = false;
+
+  static args: CommandDefinition = {
+    args: [
+      { name: 'directory', required: true, description: 'Directory to initialize the project in' },
+    ],
+    options: [
+      {
+        name: '--repo <url>',
+        description: 'Starter repository URL (supports gh@owner/repo syntax)',
+        default: 'gh@nexical/app-starter',
+      },
+    ],
+  };
+
+  async run(options: { directory: string; repo: string }) {
+    const directory = options.directory;
+    const targetPath = path.resolve(process.cwd(), directory);
+    const repoUrl = resolveGitUrl(options.repo);
+
+    logger.debug('Init options:', { directory, targetPath, repoUrl });
+
+    this.info(`Initializing project in: ${targetPath}`);
+    this.info(`Using starter repository: ${repoUrl}`);
+
+    if (await fs.pathExists(targetPath)) {
+      if ((await fs.readdir(targetPath)).length > 0) {
+        this.error(`Directory ${directory} is not empty.`);
+        process.exit(1);
+      }
+    } else {
+      await fs.mkdir(targetPath, { recursive: true });
+    }
 
-        } catch (error: any) {
-            this.error(`Failed to initialize project: ${error.message}`);
-            process.exit(1);
-        }
+    try {
+      this.info('Cloning starter repository...');
+      await git.clone(repoUrl, targetPath, { recursive: true });
+
+      this.info('Updating submodules...');
+      await git.updateSubmodules(targetPath);
+
+      this.info('Installing dependencies...');
+      await runCommand('npm install', targetPath);
+
+      this.info('Setting up upstream remote...');
+      await git.renameRemote('origin', 'upstream', targetPath);
+
+      // Run setup script
+      this.info('Running project setup...');
+      await runCommand('npm run setup', targetPath);
+
+      // Check for nexical.yaml, if not present create a default one
+      const configPath = path.join(targetPath, 'nexical.yaml');
+      if (!(await fs.pathExists(configPath))) {
+        this.info('Creating default nexical.yaml...');
+        await fs.writeFile(configPath, 'name: ' + path.basename(targetPath) + '\nmodules: []\n');
+      }
+
+      // Create VERSION file
+      const versionPath = path.join(targetPath, 'VERSION');
+      // Check if version file exists, if not create it
+      if (!(await fs.pathExists(versionPath))) {
+        this.info('Creating VERSION file with 0.1.0...');
+        await fs.writeFile(versionPath, '0.1.0');
+      }
+
+      await git.addAll(targetPath);
+      await git.commit('Initial site commit', targetPath);
+
+      this.success(`Project initialized successfully in ${directory}!`);
+    } catch (error: unknown) {
+      if (error instanceof Error) {
+        this.error(`Failed to initialize project: ${error.message}`);
+      } else {
+        this.error(`Failed to initialize project: ${String(error)}`);
+      }
+      process.exit(1);
     }
+  }
 }