More updates to the Nexical CLI to align it to the app-core architecture.

Author: adrianwebb

.github/workflows/deploy.yml

@@ -1,4 +1,4 @@
-name: Deploy Astrical CLI
+name: Deploy Nexical CLI
 
 on:
   push:

README.md

@@ -1,8 +1,8 @@
-# @astrical/cli
+# @nexical/cli
 
-The official Command Line Interface (CLI) for the Astrical framework.
+The official Command Line Interface (CLI) for the Nexical framework.
 
-This project serves as the primary entry point for managing Astrical projects, handling tasks such as project initialization, module management, and development workflows. It is designed to be **extensible**, **fast**, and **developer-friendly**, focusing on a clean architecture that allows for easy addition of new commands.
+This project serves as the primary entry point for managing Nexical projects, handling tasks such as project initialization, module management, and development workflows. It is designed to be **extensible**, **fast**, and **developer-friendly**, focusing on a clean architecture that allows for easy addition of new commands.
 
 ## Table of Contents
 
@@ -22,8 +22,8 @@ This project serves as the primary entry point for managing Astrical projects, h
 
 ## Purpose
 
-The Astrical CLI allows developers to:
-1.  **Initialize** new Astrical projects with best practices built-in.
+The Nexical CLI allows developers to:
+1.  **Initialize** new Nexical projects with best practices built-in.
 2.  **Manage** project configuration and dependencies.
 3.  **Extend** the framework functionality through modular commands.
 
@@ -36,7 +36,7 @@ This CLI is built with **TypeScript** and follows a **Class-Based Command Patter
 ### Key Technologies
 *   **[CAC (Command And Conquer)](https://github.com/cacjs/cac)**: A lightweight, robust framework for building CLIs. It handles argument parsing, help generation, and command registration.
 *   **[Consola](https://github.com/unjs/consola)**: Elegant console logging with fallback and structured output capabilities.
-*   **[Lilconfig](https://github.com/antonk52/lilconfig)**: Configuration loading (searching for `astrical.yml`, `astrical.yaml`) akin to `cosmiconfig` but lighter.
+*   **[Lilconfig](https://github.com/antonk52/lilconfig)**: Configuration loading (searching for `nexical.yml`, `nexical.yaml`) akin to `cosmiconfig` but lighter.
 *   **Vitest**: A blazing fast unit test framework powered by Vite.
 
 ### Core Components
@@ -52,7 +52,7 @@ This CLI is built with **TypeScript** and follows a **Class-Based Command Patter
     *   Project root detection (`this.projectRoot`).
 
 ### Design Goals
-*   **Zero-Config Defaults**: It should work out of the box but allow rich configuration via `astrical.yml`.
+*   **Zero-Config Defaults**: It should work out of the box but allow rich configuration via `nexical.yaml`.
 *   **Extensibility**: Adding a command should be as simple as adding a file.
 *   **Testability**: Every component is designed to be unit-testable, with dependency injection where appropriate (e.g., `CommandLoader` importer).
 
@@ -74,37 +74,37 @@ npm run build
 
 ```bash
 # Run the built CLI
-npx astrical <command> [options]
+npx nexical <command> [options]
 
 # Example: Initialize a new project
-npx astrical init my-new-project
+npx nexical init my-new-project
 
 # Get help
-npx astrical help
+npx nexical help
 
 # Get help for a specific command
-npx astrical help init
-npx astrical help module add
+npx nexical help init
+npx nexical help module add
 ```
 
 ### Command Reference
 
 #### `init`
 
-Initializes a new Astrical project by cloning a starter repository, setting up dependencies, and preparing a fresh git history.
+Initializes a new Nexical project by cloning a starter repository, setting up dependencies, and preparing a fresh git history.
 
 **Usage:**
 ```bash
-npx astrical init <directory> [options]
+npx nexical init <directory> [options]
 ```
 
 **Arguments:**
 - `directory` (Required): The directory to initialize the project in. If the directory does not exist, it will be created. If it does exist, it must be empty.
 
 **Options:**
-- `--repo <url>` (Default: `https://github.com/nexical/astrical-starter`): The URL of the starter repository to clone.
+- `--repo <url>` (Default: `https://github.com/nexical/app-core`): The URL of the starter repository to clone.
     - Supports standard Git URLs (e.g., `https://github.com/user/repo.git`).
-    - Supports GitHub short syntax `gh@owner/repo` (e.g., `gh@nexical/astrical-starter`).
+    - Supports GitHub short syntax `gh@owner/repo` (e.g., `gh@nexical/app-core`).
 
 **What it does:**
 1.  **Clones** the specified starter repository (recursively, including submodules) into the target directory.
@@ -118,7 +118,7 @@ npx astrical init <directory> [options]
     - Removes the `origin` remote to prevent accidental pushes to the starter repo.
 
 **Output:**
-- A ready-to-use Astrical project in the specified directory, with fresh git history and installed dependencies.
+- A ready-to-use Nexical project in the specified directory, with fresh git history and installed dependencies.
 
 ---
 
@@ -128,11 +128,10 @@ Starts the development server in ephemeral mode. It constructs a temporary build
 
 **Usage:**
 ```bash
-npx astrical dev
+npx nexical dev
 ```
 
 **What it does:**
-1.  **Prepares** the `site` directory by mounting `src/core`, `src/modules`, and content.
 2.  **Starts** the Astro development server (accessible at `http://localhost:4321` by default).
 3.  **Watches** for changes in your project and updates the ephemeral build automatically.
 
@@ -144,12 +143,12 @@ Compiles the project for production. It assembles the final site structure in `s
 
 **Usage:**
 ```bash
-npx astrical build
+npx nexical build
 ```
 
 **What it does:**
 1.  **Cleans** the `site` directory to ensure a fresh build.
-2.  **Copies** all necessary source files (`src/core`, `src/modules`, `src/content`, `public`) into `site`.
+2.  **Copies** all necessary source files (`src/`, `modules`, `src/content`, `public`) into `site`.
 3.  **Runs** `astro build` to generate the production output in `site/dist`.
 
 **Output:**
@@ -159,15 +158,15 @@ npx astrical build
 
 #### `preview`
 
-Previews the locally built production site. This is useful for verifying the output of `astrical build` before deploying.
+Previews the locally built production site. This is useful for verifying the output of `nexical build` before deploying.
 
 **Usage:**
 ```bash
-npx astrical preview
+npx nexical preview
 ```
 
 **Prerequisites:**
-- You must run `astrical build` first.
+- You must run `nexical build` first.
 
 **What it does:**
 - Starts a local web server serving the static files from `site/dist`.
@@ -180,7 +179,7 @@ Removes generated build artifacts and temporary directories to ensure a clean st
 
 **Usage:**
 ```bash
-npx astrical clean
+npx nexical clean
 ```
 
 **What it does:**
@@ -190,11 +189,11 @@ npx astrical clean
 
 #### `run`
 
-Executes a script within the Astrical environment context. This handles path resolution and environment variable setup for you.
+Executes a script within the Nexical environment context. This handles path resolution and environment variable setup for you.
 
 **Usage:**
 ```bash
-npx astrical run <script> [args...]
+npx nexical run <script> [args...]
 ```
 
 **Arguments:**
@@ -206,25 +205,25 @@ npx astrical run <script> [args...]
 **Examples:**
 ```bash
 # Run a core project script
-npx astrical run test
+npx nexical run test
 
 # Run a script defined in the 'blog' module's package.json
-npx astrical run blog:sync --force
+npx nexical run blog:sync --force
 ```
 
 ---
 
 #### `module`
 
-Manages the modular architecture of your Astrical project. Allows you to add, remove, update, and list Git-based modules.
+Manages the modular architecture of your Nexical project. Allows you to add, remove, update, and list Git-based modules.
 
 ##### `module add`
 
 Adds a new module as a Git submodule.
 
 **Usage:**
 ```bash
-npx astrical module add <url> [name]
+npx nexical module add <url> [name]
 ```
 
 **Arguments:**
@@ -242,7 +241,7 @@ Lists all installed modules in the project.
 
 **Usage:**
 ```bash
-npx astrical module list
+npx nexical module list
 ```
 
 **Output:**
@@ -254,7 +253,7 @@ Updates one or all modules to their latest remote commit.
 
 **Usage:**
 ```bash
-npx astrical module update [name]
+npx nexical module update [name]
 ```
 
 **Arguments:**
@@ -270,7 +269,7 @@ Removes an installed module and cleans up references.
 
 **Usage:**
 ```bash
-npx astrical module remove <name>
+npx nexical module remove <name>
 ```
 
 **Arguments:**

src/commands/module/init.ts

@@ -18,7 +18,7 @@ export default class ModuleInitCommand extends BaseCommand {
             {
                 name: '--repo <url>',
                 description: 'Starter repository URL',
-                default: 'gh@astrical-modules/starter'
+                default: 'gh@nexical-modules/starter'
             }
         ]
     };

src/commands/run.ts

@@ -7,7 +7,7 @@ import { linkEnvironment } from '../utils/environment.js';
 
 export default class RunCommand extends BaseCommand {
     static usage = 'run <script> [args...]';
-    static description = 'Run a script inside the Astrical environment.';
+    static description = 'Run a script inside the Nexical environment.';
     static requiresProject = true;
 
     static args: CommandDefinition = {
@@ -67,7 +67,7 @@ export default class RunCommand extends BaseCommand {
             const corePkgJsonPath = path.join(siteDir, 'package.json');
             const pkg = await fs.readJson(corePkgJsonPath);
             if (!pkg.scripts || !pkg.scripts[script]) {
-                this.error(`Script ${script} does not exist in Astrical core`);
+                this.error(`Script ${script} does not exist in Nexical core`);
                 return;
             }
             finalArgs = ['run', script, '--', ...scriptArgs];

src/utils/discovery.ts

@@ -6,8 +6,8 @@ import fs from 'node:fs';
  * Discovers command directories to load into the CLI.
  * 
  * Scans for:
- * 1. Core commands (projectRoot/src/core/commands)
- * 2. Module commands (projectRoot/src/modules/ * /commands)
+ * 1. Core commands (projectRoot/src/commands)
+ * 2. Module commands (projectRoot/src/modules/ * /src/commands)
  * 
  * @param projectRoot - The root directory of the project
  * @returns Array of absolute paths to command directories
@@ -33,15 +33,12 @@ export function discoverCommandDirectories(projectRoot: string): string[] {
     // Search in projectRoot
     const possibleCorePaths = [
         path.join(projectRoot, 'src/commands'),
-        path.join(projectRoot, 'src/core/src/commands'),
     ];
 
     possibleCorePaths.forEach(addDir);
 
     // 2. Module commands
-    // 2. Module commands (src/modules for standalone CLI, modules for platform)
     const possibleModuleDirs = [
-        path.join(projectRoot, 'src/modules'),
         path.join(projectRoot, 'modules')
     ];
 
@@ -67,8 +64,7 @@ export function discoverCommandDirectories(projectRoot: string): string[] {
         }
     });
 
-    // 3. Package commands (e.g. platform/core/packages/*)
-    // This assumes we are running in the context of platform/core or similar workspace
+    // 3. Package commands (e.g. packages/*)
     const packagesDir = path.join(projectRoot, 'packages');
     if (fs.existsSync(packagesDir)) {
         try {
@@ -88,25 +84,5 @@ export function discoverCommandDirectories(projectRoot: string): string[] {
         }
     }
 
-    // 4. Platform Core Packages (e.g. platform/core/packages/*)
-    const platformPackagesDir = path.join(projectRoot, 'platform/core/packages');
-    if (fs.existsSync(platformPackagesDir)) {
-        try {
-            const packages = fs.readdirSync(platformPackagesDir);
-            for (const pkg of packages) {
-                if (pkg.startsWith('.')) continue;
-
-                const pkgPath = path.join(platformPackagesDir, pkg);
-                const pkgCommands = path.join(pkgPath, 'src/commands');
-
-                if (fs.existsSync(pkgCommands) && fs.statSync(pkgCommands).isDirectory()) {
-                    addDir(pkgCommands);
-                }
-            }
-        } catch (e: any) {
-            logger.debug(`Error scanning platform packages directory: ${e.message}`);
-        }
-    }
-
     return directories;
 }

test/e2e/lifecycle.e2e.test.ts

@@ -57,7 +57,7 @@ if (args[0] === 'build') {
                 }
             }),
             'README.md': '# E2E Starter',
-            'astrical.yml': 'name: e2e-test\nversion: 0.0.1', // ESSENTIAL for CLI to recognize project
+            '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({
@@ -96,7 +96,7 @@ if (args[0] === 'build') {
         };
 
         // --- STEP 1: INIT ---
-        // Run: astrical init my-project --repo <starter>
+        // Run: nexical init my-project --repo <starter>
         const initResult = await runCLI([
             'init',
             'my-project',
@@ -111,7 +111,7 @@ if (args[0] === 'build') {
         expect(fs.existsSync(path.join(projectDir, 'node_modules', 'astro'))).toBe(true);
 
         // --- STEP 2: MODULE ADD ---
-        // Run: astrical module add <module>
+        // Run: nexical module add <module>
         const modResult = await runCLI([
             'module',
             'add',
@@ -126,7 +126,7 @@ if (args[0] === 'build') {
         expect(fs.existsSync(path.join(projectDir, 'src/modules/my-test-module'))).toBe(true);
 
         // --- STEP 3: BUILD ---
-        // Run: astrical build
+        // Run: nexical build
         // Should trigger our mock astro binary
         const buildResult = await runCLI(['build'], projectDir, { env });
 
@@ -139,7 +139,7 @@ if (args[0] === 'build') {
         expect(buildResult.stdout).toContain('MOCK_ASTRO_EXECUTED build');
 
         // --- STEP 4: PREVIEW ---
-        // Run: astrical preview
+        // Run: nexical preview
         // Should trigger mock astro preview
         const previewResult = await runCLI(['preview'], projectDir, { env });
         // NOTE: Real astro preview blocks. Our mock bin just prints and exits.
@@ -148,7 +148,7 @@ if (args[0] === 'build') {
         expect(previewResult.stdout).toContain('MOCK_ASTRO_EXECUTED preview');
 
         // --- STEP 5: CLEAN ---
-        // Run: astrical clean
+        // Run: nexical clean
         const cleanResult = await runCLI(['clean'], projectDir, { env });
 
         expect(cleanResult.exitCode).toBe(0);

test/integration/commands/build.integration.test.ts

@@ -58,7 +58,7 @@ describe('BuildCommand Integration', () => {
     });
 
     it('should assemble environment and spawn astro build', async () => {
-        const cli = new CLI({ commandName: 'astrical' });
+        const cli = new CLI({ commandName: 'nexical' });
         const command = new BuildCommand(cli);
         Object.assign(command, { projectRoot: projectDir });