npm - @nexical/cli - Versions diffs - 0.1.6 → 0.10.0 - Mend

@nexical/cli 0.1.6 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (236) hide show

package/.github/workflows/deploy.yml +3 -3
package/README.md +317 -104
package/dist/chunk-JYASTIIW.js +42 -0
package/dist/chunk-JYASTIIW.js.map +1 -0
package/dist/chunk-LZ3YQWAR.js +2204 -0
package/dist/chunk-LZ3YQWAR.js.map +1 -0
package/dist/chunk-OKXOCNXP.js +105 -0
package/dist/chunk-OKXOCNXP.js.map +1 -0
package/dist/chunk-OYFWMYPG.js +52 -0
package/dist/chunk-OYFWMYPG.js.map +1 -0
package/dist/chunk-WKERTCM6.js +74 -0
package/dist/chunk-WKERTCM6.js.map +1 -0
package/dist/index.js +33 -6
package/dist/index.js.map +1 -1
package/dist/src/commands/init.d.ts +11 -0
package/dist/src/commands/init.js +88 -0
package/dist/src/commands/init.js.map +1 -0
package/dist/src/commands/module/add.d.ts +14 -0
package/dist/src/commands/module/add.js +136 -0
package/dist/src/commands/module/add.js.map +1 -0
package/dist/src/commands/module/list.d.ts +10 -0
package/dist/src/commands/module/list.js +73 -0
package/dist/src/commands/module/list.js.map +1 -0
package/dist/src/commands/module/remove.d.ts +12 -0
package/dist/src/commands/module/remove.js +71 -0
package/dist/src/commands/module/remove.js.map +1 -0
package/dist/src/commands/module/update.d.ts +11 -0
package/dist/src/commands/module/update.js +52 -0
package/dist/src/commands/module/update.js.map +1 -0
package/dist/src/commands/run.d.ts +11 -0
package/dist/src/commands/run.js +93 -0
package/dist/src/commands/run.js.map +1 -0
package/dist/src/utils/discovery.d.ts +13 -0
package/dist/src/utils/discovery.js +9 -0
package/dist/src/utils/git.d.ts +16 -0
package/dist/src/utils/git.js +29 -0
package/dist/src/utils/git.js.map +1 -0
package/dist/src/utils/url-resolver.d.ts +15 -0
package/dist/src/utils/url-resolver.js +9 -0
package/dist/src/utils/url-resolver.js.map +1 -0
package/index.ts +29 -5
package/package.json +32 -30
package/src/commands/init.ts +85 -0
package/src/commands/module/add.ts +169 -0
package/src/commands/module/list.ts +69 -0
package/src/commands/module/remove.ts +74 -0
package/src/commands/module/update.ts +50 -0
package/src/commands/run.ts +98 -0
package/src/utils/discovery.ts +134 -0
package/src/utils/git.ts +65 -0
package/src/utils/url-resolver.ts +57 -0
package/test/e2e/lifecycle.e2e.test.ts +152 -0
package/test/integration/commands/init.integration.test.ts +82 -0
package/test/integration/commands/module.integration.test.ts +144 -0
package/test/integration/commands/run.integration.test.ts +90 -0
package/test/integration/utils/command-loading.integration.test.ts +80 -0
package/test/unit/commands/init.test.ts +153 -0
package/test/unit/commands/module/add.test.ts +262 -0
package/test/unit/commands/module/list.test.ts +115 -0
package/test/unit/commands/module/remove.test.ts +89 -0
package/test/unit/commands/module/update.test.ts +91 -0
package/test/unit/commands/run.test.ts +252 -0
package/test/unit/utils/command-discovery.test.ts +176 -0
package/test/unit/utils/git.test.ts +152 -0
package/test/unit/utils/integration-helpers.test.ts +72 -0
package/test/unit/utils/url-resolver.test.ts +39 -0
package/test/utils/integration-helpers.ts +66 -0
package/vitest.e2e.config.ts +0 -1
package/dist/chunk-JDRAVUKK.js +0 -48
package/dist/chunk-JDRAVUKK.js.map +0 -1
package/dist/src/commands/admin/create-user.d.ts +0 -15
package/dist/src/commands/admin/create-user.js +0 -49
package/dist/src/commands/admin/create-user.js.map +0 -1
package/dist/src/commands/branch/create.d.ts +0 -19
package/dist/src/commands/branch/create.js +0 -59
package/dist/src/commands/branch/create.js.map +0 -1
package/dist/src/commands/branch/delete.d.ts +0 -15
package/dist/src/commands/branch/delete.js +0 -50
package/dist/src/commands/branch/delete.js.map +0 -1
package/dist/src/commands/branch/get.d.ts +0 -15
package/dist/src/commands/branch/get.js +0 -53
package/dist/src/commands/branch/get.js.map +0 -1
package/dist/src/commands/branch/list.d.ts +0 -15
package/dist/src/commands/branch/list.js +0 -51
package/dist/src/commands/branch/list.js.map +0 -1
package/dist/src/commands/job/get.d.ts +0 -15
package/dist/src/commands/job/get.js +0 -62
package/dist/src/commands/job/get.js.map +0 -1
package/dist/src/commands/job/list.d.ts +0 -15
package/dist/src/commands/job/list.js +0 -57
package/dist/src/commands/job/list.js.map +0 -1
package/dist/src/commands/job/logs.d.ts +0 -15
package/dist/src/commands/job/logs.js +0 -67
package/dist/src/commands/job/logs.js.map +0 -1
package/dist/src/commands/job/trigger.d.ts +0 -19
package/dist/src/commands/job/trigger.js +0 -74
package/dist/src/commands/job/trigger.js.map +0 -1
package/dist/src/commands/login.d.ts +0 -8
package/dist/src/commands/login.js +0 -31
package/dist/src/commands/login.js.map +0 -1
package/dist/src/commands/project/create.d.ts +0 -24
package/dist/src/commands/project/create.js +0 -63
package/dist/src/commands/project/create.js.map +0 -1
package/dist/src/commands/project/delete.d.ts +0 -20
package/dist/src/commands/project/delete.js +0 -58
package/dist/src/commands/project/delete.js.map +0 -1
package/dist/src/commands/project/get.d.ts +0 -15
package/dist/src/commands/project/get.js +0 -49
package/dist/src/commands/project/get.js.map +0 -1
package/dist/src/commands/project/list.d.ts +0 -15
package/dist/src/commands/project/list.js +0 -45
package/dist/src/commands/project/list.js.map +0 -1
package/dist/src/commands/project/update.d.ts +0 -19
package/dist/src/commands/project/update.js +0 -66
package/dist/src/commands/project/update.js.map +0 -1
package/dist/src/commands/team/create.d.ts +0 -19
package/dist/src/commands/team/create.js +0 -45
package/dist/src/commands/team/create.js.map +0 -1
package/dist/src/commands/team/delete.d.ts +0 -20
package/dist/src/commands/team/delete.js +0 -52
package/dist/src/commands/team/delete.js.map +0 -1
package/dist/src/commands/team/get.d.ts +0 -15
package/dist/src/commands/team/get.js +0 -42
package/dist/src/commands/team/get.js.map +0 -1
package/dist/src/commands/team/list.d.ts +0 -8
package/dist/src/commands/team/list.js +0 -30
package/dist/src/commands/team/list.js.map +0 -1
package/dist/src/commands/team/member/invite.d.ts +0 -20
package/dist/src/commands/team/member/invite.js +0 -54
package/dist/src/commands/team/member/invite.js.map +0 -1
package/dist/src/commands/team/member/remove.d.ts +0 -15
package/dist/src/commands/team/member/remove.js +0 -43
package/dist/src/commands/team/member/remove.js.map +0 -1
package/dist/src/commands/team/update.d.ts +0 -19
package/dist/src/commands/team/update.js +0 -55
package/dist/src/commands/team/update.js.map +0 -1
package/dist/src/commands/token/generate.d.ts +0 -19
package/dist/src/commands/token/generate.js +0 -48
package/dist/src/commands/token/generate.js.map +0 -1
package/dist/src/commands/token/list.d.ts +0 -8
package/dist/src/commands/token/list.js +0 -31
package/dist/src/commands/token/list.js.map +0 -1
package/dist/src/commands/token/revoke.d.ts +0 -15
package/dist/src/commands/token/revoke.js +0 -38
package/dist/src/commands/token/revoke.js.map +0 -1
package/dist/src/commands/whoami.d.ts +0 -8
package/dist/src/commands/whoami.js +0 -26
package/dist/src/commands/whoami.js.map +0 -1
package/dist/src/utils/nexical-client.d.ts +0 -10
package/dist/src/utils/nexical-client.js +0 -12
package/src/commands/admin/create-user.ts +0 -46
package/src/commands/branch/create.ts +0 -57
package/src/commands/branch/delete.ts +0 -47
package/src/commands/branch/get.ts +0 -50
package/src/commands/branch/list.ts +0 -50
package/src/commands/job/get.ts +0 -59
package/src/commands/job/list.ts +0 -56
package/src/commands/job/logs.ts +0 -67
package/src/commands/job/trigger.ts +0 -73
package/src/commands/login.ts +0 -31
package/src/commands/project/create.ts +0 -61
package/src/commands/project/delete.ts +0 -56
package/src/commands/project/get.ts +0 -46
package/src/commands/project/list.ts +0 -44
package/src/commands/project/update.ts +0 -63
package/src/commands/team/create.ts +0 -43
package/src/commands/team/delete.ts +0 -50
package/src/commands/team/get.ts +0 -39
package/src/commands/team/list.ts +0 -26
package/src/commands/team/member/invite.ts +0 -56
package/src/commands/team/member/remove.ts +0 -40
package/src/commands/team/update.ts +0 -53
package/src/commands/token/generate.ts +0 -45
package/src/commands/token/list.ts +0 -27
package/src/commands/token/revoke.ts +0 -35
package/src/commands/whoami.ts +0 -21
package/src/utils/nexical-client.ts +0 -47
package/test/e2e/auth.e2e.test.ts +0 -46
package/test/e2e/job-workflow.e2e.test.ts +0 -33
package/test/e2e/project-lifecycle.e2e.test.ts +0 -48
package/test/e2e/setup.ts +0 -237
package/test/e2e/utils.ts +0 -33
package/test/integration/commands/admin/create-user.test.ts +0 -51
package/test/integration/commands/branch/create.test.ts +0 -51
package/test/integration/commands/branch/delete.test.ts +0 -43
package/test/integration/commands/branch/get.test.ts +0 -49
package/test/integration/commands/branch/list.test.ts +0 -47
package/test/integration/commands/job/get.test.ts +0 -54
package/test/integration/commands/job/list.test.ts +0 -47
package/test/integration/commands/job/logs.test.ts +0 -47
package/test/integration/commands/job/trigger.test.ts +0 -57
package/test/integration/commands/login.test.ts +0 -62
package/test/integration/commands/project/create.test.ts +0 -53
package/test/integration/commands/project/delete.test.ts +0 -43
package/test/integration/commands/project/get.test.ts +0 -51
package/test/integration/commands/project/list.test.ts +0 -47
package/test/integration/commands/project/update.test.ts +0 -53
package/test/integration/commands/team/create.test.ts +0 -53
package/test/integration/commands/team/delete.test.ts +0 -43
package/test/integration/commands/team/get.test.ts +0 -50
package/test/integration/commands/team/list.test.ts +0 -47
package/test/integration/commands/team/member/invite.test.ts +0 -46
package/test/integration/commands/team/member/remove.test.ts +0 -43
package/test/integration/commands/team/update.test.ts +0 -50
package/test/integration/commands/token/generate.test.ts +0 -51
package/test/integration/commands/token/list.test.ts +0 -47
package/test/integration/commands/token/revoke.test.ts +0 -43
package/test/integration/commands/whoami.test.ts +0 -49
package/test/unit/commands/admin/create-user.test.ts +0 -51
package/test/unit/commands/branch/create.test.ts +0 -57
package/test/unit/commands/branch/delete.test.ts +0 -49
package/test/unit/commands/branch/get.test.ts +0 -67
package/test/unit/commands/branch/list.test.ts +0 -62
package/test/unit/commands/job/get.test.ts +0 -76
package/test/unit/commands/job/list.test.ts +0 -62
package/test/unit/commands/job/logs.test.ts +0 -60
package/test/unit/commands/job/trigger.test.ts +0 -75
package/test/unit/commands/login.test.ts +0 -64
package/test/unit/commands/project/create.test.ts +0 -64
package/test/unit/commands/project/delete.test.ts +0 -72
package/test/unit/commands/project/get.test.ts +0 -73
package/test/unit/commands/project/list.test.ts +0 -62
package/test/unit/commands/project/update.test.ts +0 -58
package/test/unit/commands/team/create.test.ts +0 -68
package/test/unit/commands/team/delete.test.ts +0 -71
package/test/unit/commands/team/get.test.ts +0 -70
package/test/unit/commands/team/list.test.ts +0 -56
package/test/unit/commands/team/member/invite.test.ts +0 -52
package/test/unit/commands/team/member/remove.test.ts +0 -49
package/test/unit/commands/team/update.test.ts +0 -63
package/test/unit/commands/token/generate.test.ts +0 -65
package/test/unit/commands/token/list.test.ts +0 -58
package/test/unit/commands/token/revoke.test.ts +0 -49
package/test/unit/commands/whoami.test.ts +0 -49
package/test/unit/utils/nexical-client.test.ts +0 -113
/package/dist/src/utils/{nexical-client.js.map → discovery.js.map} +0 -0

package/test/e2e/lifecycle.e2e.test.ts ADDED Viewed

@@ -0,0 +1,152 @@
+import { describe, it, expect, beforeEach, afterAll } from 'vitest';
+import { createTempDir, createMockRepo, runCLI } from '../utils/integration-helpers.js';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { execa } from 'execa';
+describe('CLI Lifecycle E2E', () => {
+    let testRoot: string;
+    let starterDir: string;
+    let moduleDir: string;
+    let mockAstroDir: string;
+    beforeEach(async () => {
+        testRoot = await createTempDir('e2e-life-');
+        // 1. Setup Mock "Astro" package
+        // We create a local package that impersonates 'astro'.
+        // This avoids npm install downloading the internet.
+        mockAstroDir = path.join(testRoot, 'mock-astro');
+        await fs.ensureDir(mockAstroDir);
+        await fs.outputFile(path.join(mockAstroDir, 'package.json'), JSON.stringify({
+            name: 'astro',
+            version: '1.0.0',
+            bin: {
+                astro: './bin.js'
+            }
+        }));
+        // The mock binary acts as "npx astro"
+        await fs.outputFile(path.join(mockAstroDir, 'bin.js'), `#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const args = process.argv.slice(2);
+console.log("MOCK_ASTRO_EXECUTED " + args.join(' '));
+if (args[0] === 'build') {
+    const dist = path.join(process.cwd(), 'dist');
+    if (!fs.existsSync(dist)) fs.mkdirSync(dist, { recursive: true });
+    fs.writeFileSync(path.join(dist, 'index.html'), '<html></html>');
+}
+`);
+        await fs.chmod(path.join(mockAstroDir, 'bin.js'), '755');
+        // 2. Setup Mock Starter Repo
+        starterDir = path.join(testRoot, 'starter-repo');
+        // We need a package.json that points 'astro' to our mock
+        await createMockRepo(starterDir, {
+            'package.json': JSON.stringify({
+                name: 'e2e-project',
+                version: '0.0.0',
+                dependencies: {
+                    // Use file: protocol to point to local mock
+                    'astro': `file:${mockAstroDir}`
+                },
+                scripts: {
+                    'build': 'astro build',
+                    'dev': 'astro dev',
+                    'preview': 'astro preview'
+                }
+            }),
+            'README.md': '# E2E Starter',
+            'nexical.yml': 'name: e2e-test\nversion: 0.0.1', // ESSENTIAL for CLI to recognize project
+            'src/pages/index.astro': '--- ---',
+            'src/core/index.ts': '// core',
+            'src/core/package.json': JSON.stringify({
+                scripts: {
+                    'build': 'astro build',
+                    'dev': 'astro dev',
+                    'preview': 'astro preview'
+                }
+            })
+        });
+        // 3. Setup Mock Module Repo
+        moduleDir = path.join(testRoot, 'module-repo');
+        await createMockRepo(moduleDir, {
+            'package.json': JSON.stringify({ name: 'my-module', version: '0.1.0' }),
+            'module.yaml': 'name: my-test-module\nversion: 0.1.0', // Name matches E2E expectation
+            'index.ts': 'console.log("module")'
+        });
+    });
+    afterAll(async () => {
+        if (testRoot) await fs.remove(testRoot);
+    });
+    it('should complete a full project lifecycle', async () => {
+        const projectDir = path.join(testRoot, 'my-project');
+        const env = {
+            // Essential for git inside init/module commands
+            GIT_AUTHOR_NAME: 'Test User',
+            GIT_AUTHOR_EMAIL: 'test@example.com',
+            GIT_COMMITTER_NAME: 'Test User',
+            GIT_COMMITTER_EMAIL: 'test@example.com',
+            GIT_ALLOW_PROTOCOL: 'file'
+            // DEBUG: 'true' - Removed to reduce noise
+        };
+        // --- STEP 1: INIT ---
+        // Run: nexical init my-project --repo <starter>
+        const initResult = await runCLI([
+            'init',
+            'my-project',
+            '--repo', starterDir
+        ], testRoot, { env });
+        // 4. Check git initialization (preserved history)
+        const { stdout: log } = await execa('git', ['log', '--oneline'], { cwd: projectDir });
+        const lines = log.split('\n').filter(Boolean);
+        expect(lines.length).toBeGreaterThanOrEqual(2);
+        expect(lines[0]).toContain('Initial site commit');
+        // --- STEP 2: MODULE ADD ---
+        // Run: nexical module add <module>
+        const modResult = await runCLI([
+            'module',
+            'add',
+            moduleDir,
+            'my-test-module' // Explicit name
+        ], projectDir, { env });
+        if (modResult.exitCode !== 0) {
+            console.error('Module Add Failed:', modResult.stderr || modResult.stdout);
+        }
+        expect(modResult.exitCode).toBe(0);
+        expect(fs.existsSync(path.join(projectDir, 'modules/my-test-module'))).toBe(true);
+        // --- STEP 3: BUILD ---
+        // Run: nexical run build
+        // Should trigger our mock astro binary
+        const buildResult = await runCLI(['run', 'build'], projectDir, { env });
+        if (buildResult.exitCode !== 0) {
+            console.log(buildResult.stderr || buildResult.stdout);
+        }
+        expect(buildResult.exitCode).toBe(0);
+        expect(buildResult.stdout).toContain('MOCK_ASTRO_EXECUTED build');
+        // --- STEP 4: PREVIEW ---
+        // Run: nexical run preview
+        const previewResult = await runCLI(['run', 'preview'], projectDir, { env });
+        expect(previewResult.exitCode).toBe(0);
+        expect(previewResult.stdout).toContain('MOCK_ASTRO_EXECUTED preview');
+        // --- STEP 5: CLEAN ---
+        // Clean is now handled by manual file operations or external scripts,
+        // it's no longer a top-level command.
+    }, 120000); // Long timeout for full chain
+});

package/test/integration/commands/init.integration.test.ts ADDED Viewed

@@ -0,0 +1,82 @@
+import { CLI } from '@nexical/cli-core';
+import { describe, it, expect, beforeEach, afterEach, afterAll } from 'vitest';
+import InitCommand from '../../../src/commands/init.js';
+import { createTempDir, createMockRepo, cleanupTestRoot } from '../../utils/integration-helpers.js';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { execa } from 'execa';
+describe('InitCommand Integration', () => {
+    let tempDir: string;
+    let starterRepoDir: string;
+    beforeEach(async () => {
+        tempDir = await createTempDir('init-integration-');
+        const starterDir = await createTempDir('starter-repo-');
+        // precise setup of a starter repo
+        starterRepoDir = await createMockRepo(starterDir, {
+            'package.json': JSON.stringify({
+                name: 'nexical-starter',
+                version: '0.0.0',
+                dependencies: {
+                    'is-odd': '3.0.1'
+                }
+            }),
+            'README.md': '# Starter Template'
+        });
+        // Set Git Identity for the test process so InitCommand's commit works in CI
+        process.env.GIT_AUTHOR_NAME = 'Test User';
+        process.env.GIT_AUTHOR_EMAIL = 'test@example.com';
+        process.env.GIT_COMMITTER_NAME = 'Test User';
+        process.env.GIT_COMMITTER_EMAIL = 'test@example.com';
+        // Allow file protocol for local cloning in CI
+        process.env.GIT_ALLOW_PROTOCOL = 'file';
+    });
+    afterAll(async () => {
+        // await cleanupTestRoot(); // conflicting with parallel tests
+        if (tempDir) await fs.remove(tempDir);
+    });
+    it('should initialize a new project from a local git repo', async () => {
+        const targetProjectName = 'my-new-project';
+        const targetPath = path.join(tempDir, targetProjectName);
+        const cli = new CLI({ commandName: 'nexical' });
+        const command = new InitCommand(cli);
+        // Capture stdout/stderr? InitCommand uses consola.
+        // For integration, we care about the FS side effects.
+        await command.run({
+            directory: targetPath,
+            repo: starterRepoDir // Passing local path as repo URL
+        });
+        // 1. Check directory exists
+        expect(fs.existsSync(targetPath)).toBe(true);
+        // 2. Check files cloned
+        expect(fs.existsSync(path.join(targetPath, 'package.json'))).toBe(true);
+        expect(fs.existsSync(path.join(targetPath, 'README.md'))).toBe(true);
+        // 3. Check git initialization
+        expect(fs.existsSync(path.join(targetPath, '.git'))).toBe(true);
+        // 4. Check git initialization (history should be preserved + one new commit)
+        const { stdout: log } = await execa('git', ['log', '--oneline'], { cwd: targetPath });
+        const lines = log.split('\n').filter(Boolean);
+        expect(lines.length).toBe(2); // Should have "Initial site commit" and "Initial commit"
+        expect(lines[0]).toContain('Initial site commit');
+        expect(lines[1]).toContain('Initial commit');
+        // 5. Check dependencies (optional, but command tries to install them)
+        // Since we are mocking the repo, it doesn't have a real lockfile or valid deps,
+        // so `npm install` might have failed or done nothing.
+        // However, `InitCommand` runs `npm install`. If that fails, the command throws/exits.
+        // We provided a minimal package.json so it should succeed.
+        expect(fs.existsSync(path.join(targetPath, 'node_modules'))).toBe(true);
+    }, 60000); // Increase timeout for real git/npm ops
+});

package/test/integration/commands/module.integration.test.ts ADDED Viewed

@@ -0,0 +1,144 @@
+import { CLI } from '@nexical/cli-core';
+import { describe, it, expect, beforeEach, afterEach, afterAll, vi } from 'vitest';
+import ModuleAddCommand from '../../../src/commands/module/add.js';
+import ModuleRemoveCommand from '../../../src/commands/module/remove.js';
+import ModuleListCommand from '../../../src/commands/module/list.js';
+import ModuleUpdateCommand from '../../../src/commands/module/update.js';
+import { createTempDir, createMockRepo, cleanupTestRoot } from '../../utils/integration-helpers.js';
+import path from 'node:path';
+import fs from 'fs-extra';
+// Mock picocolors to return strings as-is for easy matching
+vi.mock('picocolors', () => ({
+    default: {
+        bold: (s: string) => s,
+        cyan: (s: string) => s,
+        yellow: (s: string) => s,
+        dim: (s: string) => s,
+        red: (s: string) => s,
+        green: (s: string) => s,
+        blue: (s: string) => s,
+        magenta: (s: string) => s,
+    }
+}));
+describe('Module Commands Integration', () => {
+    let projectDir: string;
+    let moduleRepo: string;
+    let consoleTableSpy: any;
+    let consoleLogSpy: any;
+    beforeEach(async () => {
+        // 1. Create a "Project" that is a git repo
+        const temp = await createTempDir('module-project-');
+        projectDir = await createMockRepo(temp, {
+            'package.json': '{"name": "test-project", "version": "1.0.0"}',
+            'nexical.yaml': 'site: test\nmodules: []'
+        });
+        // Allow file protocol for submodules in this repo
+        // await execa('git', ['config', 'protocol.file.allow', 'always'], { cwd: projectDir }); // Config approach failed
+        process.env.GIT_ALLOW_PROTOCOL = 'file';
+        // 2. Create a "Module" that is a SEPARATE git repo
+        const modTemp = await createTempDir('module-source-');
+        moduleRepo = await createMockRepo(modTemp, {
+            'package.json': '{"name": "my-module", "version": "1.0.0", "description": "Awesome module"}',
+            'module.yaml': 'name: my-module\nversion: 1.0.0',
+            'index.ts': 'export const hello = "world";'
+        });
+        consoleTableSpy = vi.spyOn(console, 'table').mockImplementation(() => { });
+        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        // Switch CWD to project for commands to find root
+        // Note: process.chdir behavior might persist, so we rely on mocking or careful cleanup
+        // But integration tests run sequentially in same thread usually with vitest unless configured otherwise.
+        // We will pass specific CWD to commands if possible, OR chdir and restore.
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    afterAll(async () => {
+        await cleanupTestRoot();
+    });
+    it('should add, list, update and remove a module', async () => {
+        const originalCwd = process.cwd();
+        const cli = new CLI({ commandName: 'nexical' });
+        try {
+            process.chdir(projectDir);
+            // 1. ADD MODULE
+            const addCmd = new ModuleAddCommand(cli);
+            await addCmd.init();
+            await addCmd.run({ url: moduleRepo, name: 'my-module' });
+            const modulePath = path.join(projectDir, 'modules/my-module');
+            expect(fs.existsSync(modulePath)).toBe(true);
+            expect(fs.existsSync(path.join(modulePath, 'package.json'))).toBe(true);
+            // Verify nexical.yaml updated
+            const config = await fs.readFile(path.join(projectDir, 'nexical.yaml'), 'utf8');
+            expect(config).toContain('modules:');
+            expect(config).toContain('- my-module');
+            // Check it is a submodule
+            // .git file in module dir pointing to gitdir
+            expect(fs.existsSync(path.join(modulePath, '.git'))).toBe(true);
+            const gitModules = await fs.readFile(path.join(projectDir, '.gitmodules'), 'utf-8');
+            expect(gitModules).toContain('path = modules/my-module');
+            // 2. LIST MODULES with valid module
+            const listCmd = new ModuleListCommand(cli);
+            await listCmd.init();
+            await listCmd.run();
+            // Check console.table called with module info
+            expect(consoleTableSpy).toHaveBeenCalledWith(expect.arrayContaining([
+                expect.objectContaining({
+                    name: 'my-module',
+                    version: '1.0.0',
+                    description: 'Awesome module'
+                })
+            ]));
+            // 3. UPDATE MODULE
+            const updateCmd = new ModuleUpdateCommand(cli);
+            await updateCmd.init();
+            await updateCmd.run({ name: 'my-module' });
+            // Hard to check "update" without changing the remote first.
+            // But we verify it ran without throwing.
+            // 4. REMOVE MODULE
+            const removeCmd = new ModuleRemoveCommand(cli);
+            await removeCmd.init();
+            await removeCmd.run({ name: 'my-module' });
+            expect(fs.existsSync(modulePath)).toBe(false);
+            // Verify git cleanup
+            // .git/modules/modules/my-module should be gone
+            const gitInternalModuleDir = path.join(projectDir, '.git/modules/modules/my-module');
+            expect(fs.existsSync(gitInternalModuleDir)).toBe(false);
+            // .gitmodules entry gone? `git rm` usually handles this.
+            // Check if .gitmodules file exists (if empty it might remain or be deleted depending on git version, usually implicitly updated)
+            if (fs.existsSync(path.join(projectDir, '.gitmodules'))) {
+                const updatedGitModules = await fs.readFile(path.join(projectDir, '.gitmodules'), 'utf-8');
+                expect(updatedGitModules).not.toContain('modules/my-module');
+            }
+            // Verify nexical.yaml updated
+            const configRemoved = await fs.readFile(path.join(projectDir, 'nexical.yaml'), 'utf8');
+            expect(configRemoved).not.toContain('- my-module');
+        } finally {
+            process.chdir(originalCwd);
+        }
+    });
+});

package/test/integration/commands/run.integration.test.ts ADDED Viewed

@@ -0,0 +1,90 @@
+import { CLI } from '@nexical/cli-core';
+import { describe, it, expect, beforeEach, afterEach, afterAll, vi } from 'vitest';
+import RunCommand from '../../../src/commands/run.js';
+import { createTempDir } from '../../utils/integration-helpers.js';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { spawn } from 'child_process';
+import EventEmitter from 'events';
+vi.mock('child_process', () => ({
+    spawn: vi.fn(),
+    exec: vi.fn(),
+}));
+describe('RunCommand Integration', () => {
+    let projectDir: string;
+    let spawnMock: any;
+    beforeEach(async () => {
+        projectDir = await createTempDir('run-project-');
+        vi.mocked(spawn).mockClear();
+        // Setup minimal env (New Architecture: no site/ directory)
+        await fs.ensureDir(projectDir);
+        await fs.outputFile(path.join(projectDir, 'package.json'), JSON.stringify({
+            name: 'nexical-core',
+            scripts: {
+                'test-script': 'echo test'
+            }
+        }));
+        await fs.ensureDir(path.join(projectDir, 'modules', 'my-auth'));
+        await fs.outputFile(path.join(projectDir, 'modules', 'my-auth', 'package.json'), JSON.stringify({
+            scripts: {
+                'seed': 'node seed.js'
+            }
+        }));
+        spawnMock = vi.mocked(spawn).mockImplementation(() => {
+            const child: any = new EventEmitter();
+            child.stdout = new EventEmitter();
+            child.stderr = new EventEmitter();
+            setTimeout(() => child.emit('close', 0), 10);
+            child.kill = vi.fn();
+            return child;
+        });
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+        vi.restoreAllMocks();
+    });
+    afterAll(async () => {
+        if (projectDir) await fs.remove(projectDir);
+    });
+    it('should run standard npm scripts', async () => {
+        const cli = new CLI({ commandName: 'nexical' });
+        const command = new RunCommand(cli);
+        Object.assign(command, { projectRoot: projectDir });
+        await command.run({ script: 'test-script', args: ['--flag'] });
+        expect(spawnMock).toHaveBeenCalledWith(
+            'npm',
+            ['run', 'test-script', '--', '--flag'],
+            expect.objectContaining({
+                cwd: projectDir
+            })
+        );
+    });
+    it('should run module specific scripts', async () => {
+        const cli = new CLI({ commandName: 'nexical' });
+        const command = new RunCommand(cli);
+        Object.assign(command, { projectRoot: projectDir });
+        await command.run({ script: 'my-auth:seed', args: ['--force'] });
+        // Module scripts run via npm run scriptName inside module dir
+        expect(spawnMock).toHaveBeenCalledWith(
+            'npm',
+            ['run', 'seed', '--', '--force'],
+            expect.objectContaining({
+                cwd: path.resolve(projectDir, 'modules', 'my-auth')
+            })
+        );
+    });
+});

package/test/integration/utils/command-loading.integration.test.ts ADDED Viewed

@@ -0,0 +1,80 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { execa } from 'execa';
+const CLI_ENTRY = path.resolve(__dirname, '../../../index.ts');
+const TEST_TMP_DIR = path.resolve(__dirname, '../../.test-tmp/command-loading');
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const tsxPackagePath = require.resolve('tsx/package.json');
+const tsxDir = path.dirname(tsxPackagePath);
+const TSX_BIN = path.resolve(tsxDir, 'dist/cli.mjs');
+console.log('Using TSX binary at:', TSX_BIN);
+describe('Command Loading Integration', () => {
+    beforeAll(async () => {
+        await fs.ensureDir(TEST_TMP_DIR);
+    });
+    afterAll(async () => {
+        await fs.remove(TEST_TMP_DIR);
+    });
+    it('should load commands from modules', async () => {
+        // Create nexical.yaml to mock project root
+        await fs.writeFile(path.join(TEST_TMP_DIR, 'nexical.yaml'), 'name: test-project');
+        // Setup module structure
+        const moduleDir = path.join(TEST_TMP_DIR, 'src/modules/test-mod/src/commands');
+        await fs.ensureDir(moduleDir);
+        const commandFile = path.join(moduleDir, 'hello.ts');
+        const commandContent = `
+            import { BaseCommand } from '@nexical/cli-core';
+            export default class HelloCommand extends BaseCommand {
+                static description = 'Test hello command';
+                static args = {
+                     args: [{ name: 'name', required: false }]
+                };
+                async run(options: any) {
+                    console.log('Hello from test module!');
+                }
+            }
+        `;
+        const jsCommandContent = `
+            export default class HelloCommand {
+                constructor(cli) { this.cli = cli; }
+                async init() {}
+                async runInit(options) { return this.run(options); }
+                async run() { console.log('Hello from test module!'); }
+            }
+            HelloCommand.description = 'Test hello command';
+            HelloCommand.args = {};
+        `;
+        await fs.writeFile(path.join(moduleDir, 'hello.js'), jsCommandContent);
+        const { stdout, stderr } = await execa('node', [TSX_BIN, CLI_ENTRY, 'hello', '--debug'], {
+            cwd: TEST_TMP_DIR,
+            reject: false,
+            env: {
+                ...process.env,
+                FORCE_COLOR: '0'
+            }
+        });
+        if (!stdout.includes('Hello from test module!')) {
+            console.log('STDOUT:', stdout);
+            console.log('STDERR:', stderr);
+        }
+        expect(stdout).toContain('Hello from test module!');
+    }, 20000);
+});