@nexus-framework/cli 0.2.0 → 0.3.0

package/README.md

@@ -8,7 +8,7 @@
 
 [![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-225_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)
@@ -79,6 +79,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 +126,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.0 — AI-Native Development Framework
 
 ? What are you building?                › Web Application
 ? How will your app handle data?        › Cloud First
@@ -161,6 +175,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 +199,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 +285,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] 225 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 +328,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    # 225 tests, zero lint errors
 ```
 
 ---

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
@@ -18,14 +22,16 @@ program
     .command('init [project-name]')
     .description('Initialize a new NEXUS project with interactive setup')
     .option('--adopt', 'Shorthand: same as `nexus adopt` (add NEXUS to an existing project)')
+    .option('--local', 'Configure NEXUS as local-only (not tracked by git)')
     .action(async (projectName, options) => {
-    await initCommand(projectName, { adopt: options.adopt ?? false });
+    await initCommand(projectName, { adopt: options.adopt ?? false, local: options.local ?? false });
 });
 program
     .command('adopt [path]')
     .description('Add NEXUS docs & AI config to an existing project (no scaffolding)')
-    .action(async (targetPath) => {
-    await adoptCommand(targetPath);
+    .option('--force', 'Force adoption even if no project is detected')
+    .action(async (targetPath, options) => {
+    await adoptCommand(targetPath, options);
 });
 program
     .command('upgrade [path]')
@@ -39,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,KAAK,EAAE,WAA+B,EAAE,OAA4B,EAAE,EAAE;IAC9E,MAAM,WAAW,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,UAA8B,EAAE,EAAE;IAC/C,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;AACjC,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/adopt.d.ts

@@ -19,7 +19,9 @@
  * Handler for `nexus adopt [path]`.
  *
  * @param targetPath - Optional path to the project to adopt (defaults to cwd)
- * @param options    - Reserved for future flags (e.g. --force)
+ * @param options    - Command options (--force to skip project detection)
  */
-export declare function adoptCommand(targetPath?: string, _options?: Record<string, unknown>): Promise<void>;
+export declare function adoptCommand(targetPath?: string, options?: {
+    force?: boolean;
+}): Promise<void>;
 //# sourceMappingURL=adopt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,IAAI,CAAC,CAmDf"}
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,IAAI,CAAC,CA0Ff"}

package/dist/commands/adopt.js

@@ -17,6 +17,7 @@
  */
 import path from 'node:path';
 import { adoptProject } from '../generators/index.js';
+import { promptAdoption } from '../prompts/adoption.js';
 import { logger } from '../utils/logger.js';
 import { detectProject } from '../utils/project-detector.js';
 import { version } from '../version.js';
@@ -24,21 +25,57 @@ import { version } from '../version.js';
  * Handler for `nexus adopt [path]`.
  *
  * @param targetPath - Optional path to the project to adopt (defaults to cwd)
- * @param options    - Reserved for future flags (e.g. --force)
+ * @param options    - Command options (--force to skip project detection)
  */
-export async function adoptCommand(targetPath, _options = {}) {
+export async function adoptCommand(targetPath, options = {}) {
     logger.banner(version);
     const targetDir = targetPath
         ? path.resolve(process.cwd(), targetPath)
         : process.cwd();
-    // Detect the existing project
-    const projectInfo = await detectProject(targetDir);
-    if (!projectInfo.detected) {
+    // Detect the existing project (skip if --force)
+    const projectInfo = options.force
+        ? {
+            detected: true,
+            signals: {
+                hasPackageJson: false,
+                hasGit: false,
+                hasSrc: false,
+                hasTsConfig: false,
+                hasNodeModules: false,
+                hasGoMod: false,
+                hasCargoToml: false,
+                hasPyProjectToml: false,
+                hasFirebaseJson: false,
+                hasPomXml: false,
+                hasBuildGradle: false,
+                isInsideMonorepo: false,
+                monorepoRoot: null,
+            },
+            name: null,
+            description: null,
+            framework: null,
+            testFramework: null,
+            packageManager: null,
+            hasNexus: false,
+            dependencies: [],
+        }
+        : await detectProject(targetDir);
+    if (!projectInfo.detected && !options.force) {
         logger.error('No existing project detected in this directory.');
         logger.newline();
-        logger.info('The adopt command is for existing projects that already have a package.json.');
-        logger.info('To create a brand-new project, run:');
+        logger.info('NEXUS adopt works with:');
+        logger.info('  • Node.js projects (package.json)');
+        logger.info('  • Spring Boot projects (pom.xml, build.gradle)');
+        logger.info('  • Cloud Functions (firebase.json)');
+        logger.info('  • Go projects (go.mod)');
+        logger.info('  • Rust projects (Cargo.toml)');
+        logger.info('  • Python projects (pyproject.toml)');
+        logger.info('  • Monorepos (workspace structure)');
+        logger.newline();
+        logger.info('To force adoption of any directory:');
+        logger.nexus('  nexus adopt --force');
         logger.newline();
+        logger.info('To create a brand-new project:');
         logger.nexus('  nexus init <project-name>');
         logger.newline();
         process.exit(1);
@@ -58,8 +95,10 @@ export async function adoptCommand(targetPath, _options = {}) {
     logger.info(`Detected test framework: ${testFw}`);
     logger.info(`Detected package manager: ${pm}`);
     logger.newline();
+    // Run pre-adoption interview
+    const adoptionContext = await promptAdoption(projectInfo);
     try {
-        await adoptProject(targetDir, projectInfo);
+        await adoptProject(targetDir, projectInfo, adoptionContext);
         logger.adoptComplete(displayName);
     }
     catch (err) {

package/dist/commands/adopt.js.map

@@ -1 +1 @@
-{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAmB,EACnB,WAAoC,EAAE;IAEtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvB,MAAM,SAAS,GAAG,UAAU;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC;QACzC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAElB,8BAA8B;IAC9B,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CACT,oGAAoG,CACrG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,SAAS,CAAC;IACrD,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,IAAI,MAAM,CAAC;IACnD,MAAM,EAAE,GAAG,WAAW,CAAC,cAAc,IAAI,KAAK,CAAC;IAE/C,MAAM,CAAC,KAAK,CAAC,aAAa,WAAW,+BAA+B,CAAC,CAAC;IACtE,MAAM,CAAC,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,IAAI,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjB,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -13,6 +13,7 @@
 /** Options passed from cli.ts */
 export interface InitOptions {
     adopt?: boolean;
+    local?: boolean;
 }
 /**
  * Handler for the `nexus init` command.

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Df"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/commands/init.js

@@ -54,7 +54,7 @@ export async function initCommand(projectName, options = {}) {
     }
     try {
         // Run interactive prompts
-        const config = await runPrompts(projectName);
+        const config = await runPrompts(projectName, options.local);
         logger.newline();
         logger.nexus(`Creating "${config.displayName}" with ${config.frontendFramework}...`);
         logger.newline();

package/dist/commands/init.js.map

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