@nexus-framework/cli 0.2.1 → 0.3.1

package/README.md

@@ -8,10 +8,11 @@
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
-[![Vitest](https://img.shields.io/badge/Vitest-190_Passing-green?style=for-the-badge&logo=vitest&logoColor=white)](https://vitest.dev/)
+[![Vitest](https://img.shields.io/badge/Vitest-295_Passing-green?style=for-the-badge&logo=vitest&logoColor=white)](https://vitest.dev/)
 [![npm](https://img.shields.io/npm/v/@nexus-framework/cli?style=for-the-badge&logo=npm&logoColor=white&label=npm)](https://www.npmjs.com/package/@nexus-framework/cli)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue?style=for-the-badge)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen?style=for-the-badge)](https://github.com/GDA-Africa/nexus-cli/pulls)
+[![Website](https://img.shields.io/badge/Website-nexus.glenhalton.com-8A2BE2?style=for-the-badge&logo=googlechrome&logoColor=white)](https://nexus.glenhalton.com)
 
 ---
 
@@ -79,6 +80,20 @@ Every project gets a documentation system AI agents can parse, a knowledge base
 - **`nexus adopt`** — add NEXUS to any existing codebase
 - **`nexus upgrade`** — regenerate templates, preserve user work
 - **`nexus repair`** — fix missing or corrupted NEXUS files
+- **`nexus pack`** — zip `.nexus/` into a portable backup
+- **`nexus unpack`** — restore from a backup zip with verification
+- **`nexus update`** — self-update the CLI to the latest version
+
+</td>
+<td width="50%">
+
+### 🧠 Skills System
+- **`nexus skill list`** — see all skills installed in your project
+- **`nexus skill registry`** — browse all available skills in the registry
+- **`nexus skill new`** — scaffold a custom skill interactively
+- **`nexus skill status`** — health-check all installed skills
+- Pre-read instruction files so AI agents know *how* to do tasks
+- Sourced from `@nexus-framework/skills` — updated independently
 
 </td>
 <td width="50%">
@@ -112,7 +127,7 @@ nexus init my-app
 You'll be guided through an interactive setup:
 
 ```
-🔮 NEXUS CLI v0.2.0 — AI-Native Development Framework
+🔮 NEXUS CLI v0.3.1 — AI-Native Development Framework
 
 ? What are you building?                › Web Application
 ? How will your app handle data?        › Cloud First
@@ -161,6 +176,7 @@ Every generated project includes:
 | `src/` | Framework-specific source code and branded landing page |
 | `.nexus/docs/` | **The NEXUS Doc System** — 8 AI-readable files + project brain + knowledge base |
 | `.nexus/ai/` | Master AI instructions — the single source of truth for agent behavior |
+| `.nexus/skills/` | **Skills System** — `core/` (framework skills), `custom/` (yours), `community/` (registry) |
 | Tool configs | `.cursorrules`, `.windsurfrules`, `.clinerules`, `AGENTS.md`, `.github/copilot-instructions.md` — each embeds full instructions |
 | `tests/` | Vitest/Jest config, example tests, and test helpers |
 | `package.json` | Real dependencies, real scripts — `npm run dev` works immediately |
@@ -184,6 +200,44 @@ Every generated project includes:
 
 ---
 
+## 🧠 Skills System
+
+Skills are pre-read instruction files that tell AI agents *how* to execute tasks in your specific project — not just what to do, but the exact patterns, conventions, and anti-patterns your codebase follows.
+
+Every project gets a `.nexus/skills/` directory with three zones:
+
+```
+.nexus/skills/
+  README.md          ← auto-generated index agents read first
+  core/              ← framework-matched skills from @nexus-framework/skills
+  custom/            ← your own skills (created with nexus skill new, never touched by NEXUS)
+  community/         ← skills installed from the registry
+```
+
+### Managing Skills
+
+```bash
+nexus skill list                         # what's installed in this project
+nexus skill registry                     # browse everything in the registry
+nexus skill registry --framework nextjs  # filter to one framework
+nexus skill new                          # scaffold a custom skill interactively
+nexus skill status                       # health-check: deprecated, invalid frontmatter
+nexus skill install <pkg>                # install a community skill pack
+nexus skill remove <name>                # remove a community skill
+```
+
+### Custom Skills
+
+```bash
+nexus skill new my-service-pattern
+```
+
+Guides you through setting a category, trigger phrases, and scaffolds a full markdown template. The AI agent reads this file before any task matching the triggers.
+
+**Precedence:** `custom/` > `core/` > `community/` — your skills always win.
+
+---
+
 ## 🎭 Agent Persona
 
 NEXUS lets you configure how AI agents communicate when they're synced with your project.
@@ -232,18 +286,21 @@ After adopting, your AI coding tool will auto-detect the NEXUS docs, scan your c
 ### ✅ Shipped
 - [x] Core CLI with `nexus init`, `nexus adopt`, `nexus upgrade`, `nexus repair`
 - [x] Interactive prompt system (7 modules including persona)
-- [x] Generator engine (8 modules: structure, docs, config, tests, CI/CD, landing page, AI config, orchestrator)
+- [x] Generator engine (8 modules: structure, docs, config, tests, CI/CD, landing page, AI config, skills)
 - [x] AI-native documentation system (8 structured files + project brain + knowledge base + onboarding protocol)
 - [x] Agent Persona system (tone, verbosity, identity, custom directives)
 - [x] Multi-tool AI support (Cursor, Copilot, Windsurf, Cline, Claude Code)
 - [x] 6 frontend frameworks supported
 - [x] Smart file strategy (upgrade preserves user work, repair fixes corruption)
 - [x] Progressive knowledge base (append-only, category-tagged, AI-scannable)
-- [x] 190 unit tests passing
+- [x] **Skills System** — `nexus skill` (6 subcommands), `.nexus/skills/`, sourced from `@nexus-framework/skills`
+- [x] **`nexus pack` / `nexus unpack`** — portable `.nexus/` migration with zip + verification
+- [x] **`nexus update`** — self-updating CLI + startup update notifications
+- [x] 295 unit tests passing
 - [x] Published to npm as `@nexus-framework/cli`
 - [x] CI/CD with auto-publish to npm on version bump
 
-### 🔜 Next Up (v0.3.0)
+### 🔜 Next Up (v0.3.x)
 - [ ] E2E tests — generate a project, run its build, verify all files
 - [ ] Framework-specific template content (not just landing pages)
 - [ ] `nexus add <feature>` — add capabilities to existing NEXUS projects
@@ -272,7 +329,7 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 ```bash
 git clone https://github.com/GDA-Africa/nexus-cli.git
 cd nexus-cli && yarn install
-yarn lint && yarn test    # 190 tests, zero lint errors
+yarn lint && yarn test    # 295 tests, zero lint errors
 ```
 
 ---
@@ -283,7 +340,7 @@ yarn lint && yarn test    # 190 tests, zero lint errors
 
 **Built with ❤️ by [GDA Africa](https://github.com/GDA-Africa)** — Powering Africa's Digital Future
 
-*NEXUS CLI is the open-source foundation of the NEXUS framework — where AI agents don't just write code, they understand your project. For questions, ideas, or collaboration, reach out to the GDA engineering team.*
+*NEXUS CLI is the open-source foundation of the NEXUS framework — where AI agents don't just write code, they understand your project. For questions, ideas, or collaboration, visit [nexus.glenhalton.com](https://nexus.glenhalton.com) or reach out to the GDA engineering team.*
 
 ---
 

package/dist/cli.js

@@ -6,8 +6,12 @@
 import { Command } from 'commander';
 import { adoptCommand } from './commands/adopt.js';
 import { initCommand } from './commands/init.js';
+import { packCommand, unpackCommand } from './commands/pack.js';
 import { repairCommand } from './commands/repair.js';
+import { skillInstallCommand, skillListCommand, skillNewCommand, skillRegistryCommand, skillRemoveCommand, skillStatusCommand, } from './commands/skill.js';
+import { updateCommand, printUpdateBanner } from './commands/update.js';
 import { upgradeCommand } from './commands/upgrade.js';
+import { checkForUpdate } from './utils/update-check.js';
 import { version } from './version.js';
 const program = new Command();
 program
@@ -41,6 +45,82 @@ program
     .action(async (targetPath) => {
     await repairCommand(targetPath);
 });
-// Default to help if no command is given
-program.parse();
+// ── nexus skill ──────────────────────────────────────────────
+const skillCmd = program
+    .command('skill')
+    .description('Manage NEXUS Skills — pre-read AI task instructions in .nexus/skills/');
+skillCmd
+    .command('new [name]')
+    .description('Scaffold a new custom skill in .nexus/skills/custom/')
+    .action(async (name) => {
+    await skillNewCommand(name);
+});
+skillCmd
+    .command('list')
+    .description('List all installed skills (core / custom / community)')
+    .action(async () => {
+    await skillListCommand();
+});
+skillCmd
+    .command('registry')
+    .description('Browse all skills available in the @nexus-framework/skills registry')
+    .option('--framework <name>', 'Filter to a single framework (e.g. nextjs, react-vite, shared)')
+    .action(async (options) => {
+    await skillRegistryCommand(options);
+});
+skillCmd
+    .command('install <package>')
+    .description('Install community skills from @nexus-framework/skills or a registry package')
+    .action(async (pkg) => {
+    await skillInstallCommand(pkg);
+});
+skillCmd
+    .command('remove <name>')
+    .description('Remove a community skill (cannot remove core or custom skills)')
+    .action(async (name) => {
+    await skillRemoveCommand(name);
+});
+skillCmd
+    .command('status')
+    .description('Check skill health — missing core skills, invalid frontmatter, deprecated status')
+    .action(async () => {
+    await skillStatusCommand();
+});
+// ── nexus pack / unpack ───────────────────────────────────────
+program
+    .command('pack [path]')
+    .description('Zip .nexus/ into a portable nexus-backup-<timestamp>.zip for migration')
+    .action(async (targetPath) => {
+    await packCommand(targetPath);
+});
+program
+    .command('unpack [path]')
+    .description('Extract a nexus-backup-*.zip and verify the restored .nexus/ structure')
+    .option('--file <zipfile>', 'Specify a zip file to unpack (default: most recent backup in directory)')
+    .action(async (targetPath, options) => {
+    await unpackCommand(targetPath, options);
+});
+// ── nexus update ──────────────────────────────────────────────
+program
+    .command('update')
+    .description('Check for a newer version of NEXUS CLI and install it automatically')
+    .action(async () => {
+    await updateCommand();
+});
+// ── Startup update notification ───────────────────────────────
+// Silently checks the npm registry after every command.
+// If a newer version exists, prints a short non-blocking banner
+// at the end of the command output.
+async function runWithUpdateCheck() {
+    // Fire update check in background — does not block CLI startup
+    const updatePromise = checkForUpdate(4000);
+    // Parse and run the actual command
+    await program.parseAsync();
+    // After the command finishes, check if an update was found
+    const info = await updatePromise;
+    if (info?.hasUpdate) {
+        printUpdateBanner(info);
+    }
+}
+void runWithUpdateCheck();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAErC,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,SAAS,EAAE,qEAAqE,CAAC;KACxF,MAAM,CAAC,SAAS,EAAE,oDAAoD,CAAC;KACvE,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,OAA6C,EAAE,EAAE;IAC/F,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,SAAS,EAAE,+CAA+C,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,OAA4B,EAAE,EAAE;IAC7E,MAAM,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,2EAA2E,CAAC;KACxF,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,EAAE;IAC/C,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,wEAAwE,CAAC;KACrF,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,EAAE;IAC/C,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEL,yCAAyC;AACzC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/pack.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NEXUS CLI - Pack & Unpack Commands
+ *
+ * `nexus pack`   — Zips .nexus/ into nexus-backup-<timestamp>.zip for portable migration.
+ * `nexus unpack` — Finds + unzips a nexus-backup-*.zip, then verifies the restored structure.
+ */
+/**
+ * `nexus pack [path]`
+ *
+ * Zips the .nexus/ folder in the target directory into a portable
+ * nexus-backup-<timestamp>.zip file placed in the same directory.
+ * Safe to run anywhere — does not modify .nexus/ at all.
+ */
+export declare function packCommand(targetPath?: string): Promise<void>;
+/**
+ * `nexus unpack [path] [--file <zipfile>]`
+ *
+ * Finds the most recent nexus-backup-*.zip in the target directory
+ * (or a specific file via --file), extracts it, then verifies the
+ * restored .nexus/ structure is complete.
+ *
+ * Safe to run even if .nexus/ already exists — extracted files will
+ * overwrite/merge but no existing file is deleted.
+ */
+export declare function unpackCommand(targetPath?: string, options?: {
+    file?: string;
+}): Promise<void>;
+//# sourceMappingURL=pack.d.ts.map

package/dist/commands/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDpE;AAID;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/commands/pack.js

@@ -0,0 +1,206 @@
+/**
+ * NEXUS CLI - Pack & Unpack Commands
+ *
+ * `nexus pack`   — Zips .nexus/ into nexus-backup-<timestamp>.zip for portable migration.
+ * `nexus unpack` — Finds + unzips a nexus-backup-*.zip, then verifies the restored structure.
+ */
+import fs from 'node:fs';
+import { createWriteStream } from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import archiver from 'archiver';
+import unzipper from 'unzipper';
+import { logger } from '../utils/logger.js';
+// ─── Constants ────────────────────────────────────────────────
+const NEXUS_DIR = '.nexus';
+const ZIP_PREFIX = 'nexus-backup-';
+const ZIP_PATTERN = /^nexus-backup-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}\.zip$/;
+/**
+ * Directories and files that must be present after a successful unpack.
+ */
+const REQUIRED_AFTER_UNPACK = [
+    '.nexus',
+    '.nexus/docs',
+    '.nexus/ai',
+    '.nexus/manifest.json',
+];
+// ─── Pack ─────────────────────────────────────────────────────
+/**
+ * `nexus pack [path]`
+ *
+ * Zips the .nexus/ folder in the target directory into a portable
+ * nexus-backup-<timestamp>.zip file placed in the same directory.
+ * Safe to run anywhere — does not modify .nexus/ at all.
+ */
+export async function packCommand(targetPath) {
+    const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
+    const nexusDir = path.join(cwd, NEXUS_DIR);
+    // Guard: .nexus/ must exist
+    try {
+        const stat = await fsp.stat(nexusDir);
+        if (!stat.isDirectory()) {
+            logger.error(`.nexus is not a directory at: ${cwd}`);
+            process.exit(1);
+        }
+    }
+    catch {
+        logger.error(`No .nexus/ folder found at: ${cwd}`);
+        logger.info('Run nexus init or nexus adopt first.');
+        process.exit(1);
+    }
+    // Build output filename with ISO timestamp (colons → dashes for cross-platform)
+    const ts = new Date().toISOString().slice(0, 19).replace(/:/g, '-');
+    const zipName = `${ZIP_PREFIX}${ts}.zip`;
+    const zipPath = path.join(cwd, zipName);
+    logger.nexus(`Packing .nexus/ → ${zipName} …`);
+    await new Promise((resolve, reject) => {
+        const output = createWriteStream(zipPath);
+        const archive = archiver('zip', { zlib: { level: 9 } });
+        output.on('close', resolve);
+        archive.on('error', reject);
+        archive.pipe(output);
+        // Add the whole .nexus/ directory, preserving internal structure
+        archive.directory(nexusDir, NEXUS_DIR);
+        void archive.finalize();
+    });
+    const stats = fs.statSync(zipPath);
+    const kb = (stats.size / 1024).toFixed(1);
+    logger.newline();
+    logger.success(`Packed successfully!`);
+    logger.info(`  File   : ${zipName}`);
+    logger.info(`  Size   : ${kb} KB`);
+    logger.info(`  Location: ${zipPath}`);
+    logger.newline();
+    logger.info('To migrate: copy this zip to another project or computer,');
+    logger.info('then run:   nexus unpack');
+    logger.newline();
+}
+// ─── Unpack ───────────────────────────────────────────────────
+/**
+ * `nexus unpack [path] [--file <zipfile>]`
+ *
+ * Finds the most recent nexus-backup-*.zip in the target directory
+ * (or a specific file via --file), extracts it, then verifies the
+ * restored .nexus/ structure is complete.
+ *
+ * Safe to run even if .nexus/ already exists — extracted files will
+ * overwrite/merge but no existing file is deleted.
+ */
+export async function unpackCommand(targetPath, options = {}) {
+    const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
+    // Resolve the zip file to use
+    let zipPath;
+    if (options.file) {
+        zipPath = path.isAbsolute(options.file)
+            ? options.file
+            : path.join(cwd, options.file);
+    }
+    else {
+        zipPath = await findLatestBackup(cwd);
+    }
+    // Verify the zip exists
+    try {
+        await fsp.stat(zipPath);
+    }
+    catch {
+        logger.error(`Zip file not found: ${zipPath}`);
+        logger.newline();
+        logger.info('Looking for a file matching: nexus-backup-YYYY-MM-DDTHH-MM-SS.zip');
+        logger.info(`In directory: ${cwd}`);
+        logger.newline();
+        logger.info('To create one:  nexus pack');
+        logger.info('To specify one: nexus unpack --file <path-to-zip>');
+        process.exit(1);
+    }
+    const zipName = path.basename(zipPath);
+    logger.nexus(`Unpacking ${zipName} → ${cwd} …`);
+    // Extract
+    await new Promise((resolve, reject) => {
+        fs.createReadStream(zipPath)
+            .pipe(unzipper.Extract({ path: cwd }))
+            .on('close', resolve)
+            .on('error', reject);
+    });
+    logger.success('Extraction complete.');
+    logger.newline();
+    // Verify
+    await verifyUnpack(cwd);
+}
+// ─── Helpers ──────────────────────────────────────────────────
+/**
+ * Scan cwd for nexus-backup-*.zip files and return the most recent one.
+ */
+async function findLatestBackup(cwd) {
+    let entries;
+    try {
+        entries = await fsp.readdir(cwd);
+    }
+    catch {
+        logger.error(`Cannot read directory: ${cwd}`);
+        process.exit(1);
+    }
+    const zips = entries
+        .filter((f) => ZIP_PATTERN.test(f))
+        .sort()
+        .reverse(); // ISO timestamps sort lexicographically, newest last → reverse for newest first
+    if (zips.length === 0) {
+        logger.error('No nexus-backup-*.zip file found in this directory.');
+        logger.newline();
+        logger.info('To create one:  nexus pack');
+        logger.info('To specify one: nexus unpack --file <path-to-zip>');
+        process.exit(1);
+    }
+    if (zips.length > 1) {
+        logger.info(`Found ${zips.length} backup zips — using the most recent:`);
+        logger.info(`  ${zips[0]}`);
+        logger.info(`  (others: ${zips.slice(1).join(', ')})`);
+        logger.newline();
+    }
+    return path.join(cwd, zips[0]);
+}
+/**
+ * After extraction, verify all expected .nexus/ paths exist and report.
+ */
+async function verifyUnpack(cwd) {
+    logger.info('Verifying restored structure …');
+    logger.newline();
+    let allOk = true;
+    for (const rel of REQUIRED_AFTER_UNPACK) {
+        const full = path.join(cwd, rel);
+        try {
+            await fsp.stat(full);
+            logger.success(`  ✔  ${rel}`);
+        }
+        catch {
+            logger.error(`  ✖  ${rel}  — MISSING`);
+            allOk = false;
+        }
+    }
+    // Also check for optional but expected items and report informatively
+    const optionals = [
+        '.nexus/skills',
+        '.nexus/docs/knowledge.md',
+        '.nexus/docs/index.md',
+    ];
+    for (const rel of optionals) {
+        const full = path.join(cwd, rel);
+        try {
+            await fsp.stat(full);
+            logger.success(`  ✔  ${rel}`);
+        }
+        catch {
+            logger.warn(`  ⚠  ${rel}  — not present (optional)`);
+        }
+    }
+    logger.newline();
+    if (allOk) {
+        logger.success('All required NEXUS files are in place.');
+        logger.info('Your AI tools will detect .nexus/ automatically on next use.');
+    }
+    else {
+        logger.warn('Some required files are missing. The archive may be incomplete.');
+        logger.info('Run nexus repair to restore any missing files from templates.');
+    }
+    logger.newline();
+}
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,53 @@
+/**
+ * NEXUS CLI - Skill Command
+ *
+ * Provides the `nexus skill` subcommand suite for managing skills in .nexus/skills/.
+ *
+ * Subcommands:
+ *   nexus skill new <name>        — scaffold a new custom skill
+ *   nexus skill list              — list all installed skills
+ *   nexus skill install <pkg>     — install from registry (community/)
+ *   nexus skill remove <name>     — remove a community skill
+ *   nexus skill status            — check core skills freshness
+ *
+ * Directory rules:
+ *   core/      — NEXUS-owned; updated by `nexus upgrade`; NOT manageable via this command
+ *   custom/    — User-owned; created with `skill new`; NEVER removed by NEXUS
+ *   community/ — Registry-installed; managed by `skill install` / `skill remove`
+ */
+/**
+ * Scaffold a new custom skill interactively.
+ * Creates `.nexus/skills/custom/<name>.md` with template content and `status: draft`.
+ */
+export declare function skillNewCommand(name?: string): Promise<void>;
+/**
+ * List all skills installed in .nexus/skills/ grouped by directory.
+ */
+export declare function skillListCommand(): Promise<void>;
+/**
+ * List all skills available in the @nexus-framework/skills registry,
+ * optionally filtered to a single framework.
+ *
+ * Reads directly from the installed npm package — no network required.
+ */
+export declare function skillRegistryCommand(options?: {
+    framework?: string;
+}): Promise<void>;
+/**
+ * Install skills from the @nexus-framework/skills registry into community/.
+ *
+ * Currently a stub — will source from npm when @nexus-framework/skills is published.
+ * For now, notifies the user of upcoming availability.
+ */
+export declare function skillInstallCommand(pkg?: string): Promise<void>;
+/**
+ * Remove a community skill from .nexus/skills/community/.
+ * Refuses to remove core or custom skills with a clear explanation.
+ */
+export declare function skillRemoveCommand(name?: string): Promise<void>;
+/**
+ * Check if core skills are present and report any issues.
+ * Suggests running `nexus upgrade` if core skills are missing or outdated.
+ */
+export declare function skillStatusCommand(): Promise<void>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGlE;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDtD;AAMD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D9F;AAMD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrE;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCrE;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDxD"}