@nitrostack/cli 1.0.13 → 1.0.14

package/dist/commands/init.d.ts

@@ -3,6 +3,7 @@ interface InitOptions {
     description?: string;
     author?: string;
     skipInstall?: boolean;
+    force?: boolean;
 }
 export declare function initCommand(projectName: string | undefined, options: InitOptions): Promise<void>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAqDA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,iBA+OtF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA4IA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,iBAmPtF"}

package/dist/commands/init.js

@@ -7,6 +7,80 @@ import inquirer from 'inquirer';
 import { execSync } from 'child_process';
 import { NITRO_BANNER_FULL, createSuccessBox, NitroSpinner, log, spacer, nextSteps, brand, showFooter } from '../ui/branding.js';
 import { trackEvent, shutdownAnalytics } from '../analytics/posthog.js';
+import { runSkillsFlow } from '../skills/index.js';
+import readline from 'readline';
+/**
+ * Prompts the user with a horizontal YES/NO choice using left/right arrow keys.
+ */
+async function promptYesNoHorizontal(message, defaultValue = false) {
+    return new Promise((resolve) => {
+        let value = defaultValue;
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        // Save TTY and raw mode state
+        const isRaw = stdin.isRaw;
+        if (stdin.isTTY) {
+            stdin.setRawMode(true);
+        }
+        readline.emitKeypressEvents(stdin);
+        stdin.resume();
+        // Hide cursor
+        stdout.write('\u001B[?25l');
+        const render = () => {
+            readline.clearLine(stdout, 0);
+            readline.cursorTo(stdout, 0);
+            const qMark = chalk.cyan('?');
+            const msg = chalk.bold(message);
+            const pointer = chalk.dim('›');
+            const separator = chalk.dim(' / ');
+            const noPart = !value
+                ? chalk.cyan.underline('No')
+                : chalk.dim('No');
+            const yesPart = value
+                ? chalk.cyan.underline('Yes')
+                : chalk.dim('Yes');
+            stdout.write(`${qMark} ${msg} ${pointer} ${noPart}${separator}${yesPart}`);
+        };
+        render();
+        const onKeypress = (str, key) => {
+            if (!key)
+                return;
+            if (key.name === 'left' || key.name === 'right') {
+                value = !value;
+                render();
+            }
+            else if (key.name === 'return' || key.name === 'enter') {
+                cleanup();
+                // Clear prompt line and print final answer
+                readline.clearLine(stdout, 0);
+                readline.cursorTo(stdout, 0);
+                const checkMark = chalk.green('✔');
+                const finalAns = value ? chalk.cyan('Yes') : chalk.cyan('No');
+                stdout.write(`${checkMark} ${chalk.white(message)} ${finalAns}\n`);
+                // Resolve after a small delay to prevent keypress bleeding into the next prompt
+                setTimeout(() => {
+                    resolve(value);
+                }, 100);
+            }
+            else if (key.ctrl && key.name === 'c') {
+                cleanup();
+                process.exit(130); // SIGINT exit code
+            }
+        };
+        const cleanup = () => {
+            // Show cursor
+            stdout.write('\u001B[?25h');
+            stdin.removeListener('keypress', onKeypress);
+            // Consume any data currently sitting in the stream buffer
+            stdin.read();
+            if (stdin.isTTY) {
+                stdin.setRawMode(isRaw);
+            }
+            stdin.pause();
+        };
+        stdin.on('keypress', onKeypress);
+    });
+}
 // ES module equivalent of __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -69,14 +143,7 @@ export async function initCommand(projectName, options) {
         const targetDir = path.join(process.cwd(), finalProjectName);
         // Check if directory exists
         if (fs.existsSync(targetDir)) {
-            const { overwrite } = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'overwrite',
-                    message: chalk.yellow(`Directory ${finalProjectName} already exists. Overwrite?`),
-                    default: false,
-                },
-            ]);
+            const overwrite = await promptYesNoHorizontal(chalk.yellow(`Directory ${finalProjectName} already exists. Overwrite?`), false);
             if (!overwrite) {
                 log('Cancelled', 'warning');
                 process.exit(0);
@@ -99,7 +166,7 @@ export async function initCommand(projectName, options) {
                         value: 'typescript-pizzaz',
                     },
                     {
-                        name: `${brand.signal('OAuth')}       ${chalk.dim('Flight booking with OAuth 2.1 auth')}`,
+                        name: `${brand.signal('Flight booking')}  ${chalk.dim('Flight booking with OAuth 2.1 auth')}`,
                         value: 'typescript-oauth',
                     },
                 ],
@@ -152,6 +219,12 @@ export async function initCommand(projectName, options) {
             fs.writeJSONSync(packageJsonPath, packageJson, { spaces: 2 });
         }
         spinner.succeed('Project created');
+        // Agent skills prompt bypassed - installing project-level skills by default
+        // const addAgentSkills = await promptYesNoHorizontal('Add agent skills?', true);
+        // if (addAgentSkills) {
+        //   await runSkillsFlow(options.force ?? false, targetDir);
+        // }
+        await runSkillsFlow(options.force ?? false, targetDir);
         // Install dependencies
         if (!options.skipInstall) {
             spinner = new NitroSpinner('Installing dependencies...').start();

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA2BA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD1E;AA2BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAa9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM1D;AAqED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsI3E"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAmCA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD1E;AA2BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAa9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM1D;AAqED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmM3E"}

package/dist/commands/upgrade.js

@@ -5,6 +5,10 @@ import fs from 'fs-extra';
 import https from 'https';
 import { createHeader, createBox, createSuccessBox, createErrorBox, NitroSpinner, log, spacer, nextSteps, NITRO_BANNER_FULL, showFooter } from '../ui/branding.js';
 import { trackEvent, shutdownAnalytics } from '../analytics/posthog.js';
+import { cloneSkillsRepo } from '../skills/clone.js';
+import { discoverSkills } from '../skills/discover.js';
+import { installSkills } from '../skills/installer.js';
+import { AGENTS } from '../skills/detect-agents.js';
 /**
  * Fetch a package's latest published version from NPM using standard https module.
  */
@@ -236,6 +240,68 @@ export async function upgradeCommand(options) {
             console.error(error);
         }
     }
+    // Upgrade skills
+    const rootPackageJson = fs.readJSONSync(rootPackageJsonPath);
+    const localSkillsVersion = rootPackageJson.nitrostack?.skillsVersion || '0.0.0';
+    let tempSkillsDir = null;
+    const skillsSpinner = new NitroSpinner('Checking agent skills...').start();
+    try {
+        tempSkillsDir = await cloneSkillsRepo();
+        const skillsPkgJsonPath = path.join(tempSkillsDir, 'package.json');
+        let remoteSkillsVersion = '1.0.0';
+        if (fs.existsSync(skillsPkgJsonPath)) {
+            const skillsPkgJson = fs.readJSONSync(skillsPkgJsonPath);
+            remoteSkillsVersion = skillsPkgJson.version || '1.0.0';
+        }
+        if (compareVersions(localSkillsVersion, remoteSkillsVersion) < 0) {
+            if (dryRun) {
+                allResults.push({
+                    location: 'skills',
+                    packageName: '@nitrostack/skills',
+                    previousVersion: localSkillsVersion,
+                    newVersion: remoteSkillsVersion,
+                    upgraded: false,
+                });
+                skillsSpinner.info(`Skills: Updates available (${localSkillsVersion} → ${remoteSkillsVersion})`);
+            }
+            else {
+                const skills = await discoverSkills(tempSkillsDir);
+                await installSkills(AGENTS, skills, true, 'project', projectRoot);
+                // Write new version to package.json
+                const updatedPackageJson = fs.readJSONSync(rootPackageJsonPath);
+                if (!updatedPackageJson.nitrostack) {
+                    updatedPackageJson.nitrostack = {};
+                }
+                updatedPackageJson.nitrostack.skillsVersion = remoteSkillsVersion;
+                fs.writeJSONSync(rootPackageJsonPath, updatedPackageJson, { spaces: 2 });
+                allResults.push({
+                    location: 'skills',
+                    packageName: '@nitrostack/skills',
+                    previousVersion: localSkillsVersion,
+                    newVersion: remoteSkillsVersion,
+                    upgraded: true,
+                });
+                skillsSpinner.succeed(`Skills: Upgraded from ${localSkillsVersion} to ${remoteSkillsVersion}`);
+            }
+        }
+        else {
+            skillsSpinner.info('Skills: All agent skills are up to date');
+        }
+    }
+    catch (error) {
+        skillsSpinner.fail('Failed to upgrade agent skills');
+        console.error(error);
+    }
+    finally {
+        if (tempSkillsDir) {
+            try {
+                fs.removeSync(tempSkillsDir);
+            }
+            catch {
+                // best effort
+            }
+        }
+    }
     // Summary
     spacer();
     if (allResults.length === 0) {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,aAAa,YA4E5B;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,aAAa,YA6E5B;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -25,6 +25,7 @@ export function createProgram() {
         .option('--description <description>', 'Description of the project')
         .option('--author <author>', 'Author of the project')
         .option('--skip-install', 'Skip installing dependencies')
+        .option('--force', 'Overwrite existing skill files when adding agent skills')
         .action(initCommand);
     program
         .command('dev')

package/dist/skills/clone.d.ts

@@ -0,0 +1,28 @@
+export declare const SKILLS_REPO_URL = "https://github.com/nitrocloudofficial/skills.git";
+/**
+ * Thrown when the skills repository cannot be cloned (git missing, network
+ * error, repository not found, etc.).  The caller should catch this and
+ * display a user-friendly warning rather than crashing the entire init flow.
+ */
+export declare class SkillsCloneError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Clones the NitroStack skills repository into a unique temporary directory
+ * and returns the absolute path to that directory.
+ *
+ * The caller is responsible for cleaning up the directory when done:
+ * ```ts
+ * const tempDir = await cloneSkillsRepo();
+ * try {
+ *   // use tempDir …
+ * } finally {
+ *   await fs.remove(tempDir);
+ * }
+ * ```
+ *
+ * @throws {SkillsCloneError} when git is unavailable or the clone fails.
+ */
+export declare function cloneSkillsRepo(): Promise<string>;
+//# sourceMappingURL=clone.d.ts.map

package/dist/skills/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/skills/clone.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,qDAAqD,CAAC;AAElF;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aACI,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAiCvD"}

package/dist/skills/clone.js

@@ -0,0 +1,60 @@
+import os from 'os';
+import path from 'path';
+import crypto from 'crypto';
+import { execSync } from 'child_process';
+import fs from 'fs-extra';
+export const SKILLS_REPO_URL = 'https://github.com/nitrocloudofficial/skills.git';
+/**
+ * Thrown when the skills repository cannot be cloned (git missing, network
+ * error, repository not found, etc.).  The caller should catch this and
+ * display a user-friendly warning rather than crashing the entire init flow.
+ */
+export class SkillsCloneError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'SkillsCloneError';
+    }
+}
+/**
+ * Clones the NitroStack skills repository into a unique temporary directory
+ * and returns the absolute path to that directory.
+ *
+ * The caller is responsible for cleaning up the directory when done:
+ * ```ts
+ * const tempDir = await cloneSkillsRepo();
+ * try {
+ *   // use tempDir …
+ * } finally {
+ *   await fs.remove(tempDir);
+ * }
+ * ```
+ *
+ * @throws {SkillsCloneError} when git is unavailable or the clone fails.
+ */
+export async function cloneSkillsRepo() {
+    const uniqueId = crypto.randomBytes(6).toString('hex');
+    const tempDir = path.join(os.tmpdir(), `nitrostack-skills-${uniqueId}`);
+    try {
+        execSync(`git clone --depth 1 "${SKILLS_REPO_URL}" "${tempDir}"`, {
+            stdio: 'pipe',
+            timeout: 60_000,
+        });
+    }
+    catch (err) {
+        // Clean up any partial clone before throwing
+        try {
+            await fs.remove(tempDir);
+        }
+        catch {
+            // best-effort cleanup
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes('git: command not found') || message.includes("'git' is not recognized")) {
+            throw new SkillsCloneError('Git is not installed or not in PATH. Install Git from https://git-scm.com and try again.', err);
+        }
+        throw new SkillsCloneError(`Failed to clone skills repository: ${message.split('\n')[0]}`, err);
+    }
+    return tempDir;
+}

package/dist/skills/detect-agents.d.ts

@@ -0,0 +1,8 @@
+import type { AgentDescriptor } from './types.js';
+export declare const AGENTS: AgentDescriptor[];
+/**
+ * Runs all agent detectors in parallel and returns only the agents that are
+ * detected on the current machine.
+ */
+export declare function detectAgents(): Promise<AgentDescriptor[]>;
+//# sourceMappingURL=detect-agents.d.ts.map

package/dist/skills/detect-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-agents.d.ts","sourceRoot":"","sources":["../../src/skills/detect-agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkElD,eAAO,MAAM,MAAM,EAAE,eAAe,EAwDnC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAa/D"}

package/dist/skills/detect-agents.js

@@ -0,0 +1,129 @@
+import os from 'os';
+import path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs-extra';
+const execAsync = promisify(exec);
+/**
+ * Returns true when the given CLI command is available in the system PATH.
+ * Works cross-platform: uses `where` on Windows, `which` elsewhere.
+ */
+async function commandExists(cmd) {
+    try {
+        const whichCmd = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
+        await execAsync(whichCmd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true when a directory exists at `dirPath`.
+ */
+function dirExists(dirPath) {
+    try {
+        return fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+const HOME = os.homedir();
+/**
+ * Helper to build an AgentDescriptor from a simpler specification,
+ * reducing duplicate boilerplate for detect() and getSkillsDir().
+ */
+function createAgentDescriptor(spec) {
+    return {
+        id: spec.id,
+        name: spec.name,
+        displayPath: `~/${spec.folderName}/skills`,
+        async detect() {
+            if (spec.customDetect) {
+                return spec.customDetect();
+            }
+            const hasCmd = spec.cmd ? await commandExists(spec.cmd) : false;
+            return hasCmd || dirExists(path.join(HOME, spec.folderName));
+        },
+        getSkillsDir(scope = 'global', projectDir = process.cwd()) {
+            if (spec.getSkillsDir) {
+                return spec.getSkillsDir(scope, projectDir);
+            }
+            const base = scope === 'project' ? projectDir : HOME;
+            return path.join(base, spec.folderName, 'skills');
+        },
+    };
+}
+export const AGENTS = [
+    // ── Original 5 agents (must keep indices 0-4 for tests) ───────────────────
+    createAgentDescriptor({
+        id: 'cursor',
+        name: 'Cursor Agent',
+        folderName: '.cursor',
+    }),
+    createAgentDescriptor({
+        id: 'codex',
+        name: 'Codex',
+        folderName: '.codex',
+        cmd: 'codex',
+    }),
+    createAgentDescriptor({
+        id: 'claude-code',
+        name: 'Claude Code',
+        folderName: '.claude',
+        cmd: 'claude',
+    }),
+    createAgentDescriptor({
+        id: 'gemini-cli',
+        name: 'Gemini CLI',
+        folderName: '.gemini',
+        cmd: 'gemini',
+    }),
+    createAgentDescriptor({
+        id: 'antigravity',
+        name: 'Google Antigravity',
+        folderName: '.antigravity',
+        cmd: 'agy',
+    }),
+    // ── Additional coding agents (limited to GitHub Copilot and OpenCode) ──────
+    createAgentDescriptor({
+        id: 'github-copilot',
+        name: 'GitHub Copilot Agent',
+        folderName: '.copilot',
+    }),
+    createAgentDescriptor({
+        id: 'opencode',
+        name: 'OpenCode Agent',
+        // OpenCode stores its config at ~/.config/opencode
+        folderName: '.config/opencode',
+        cmd: 'opencode',
+        getSkillsDir(scope = 'global', projectDir = process.cwd()) {
+            if (scope === 'project') {
+                return path.join(projectDir, '.opencode', 'skills');
+            }
+            return path.join(HOME, '.config', 'opencode', 'skills');
+        },
+    }),
+    createAgentDescriptor({
+        id: 'agents',
+        name: 'Workspace Agents',
+        folderName: '.agents',
+    }),
+];
+/**
+ * Runs all agent detectors in parallel and returns only the agents that are
+ * detected on the current machine.
+ */
+export async function detectAgents() {
+    const results = await Promise.all(AGENTS.map(async (agent) => {
+        try {
+            const found = await agent.detect();
+            return found ? agent : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    return results.filter((a) => a !== null);
+}

package/dist/skills/discover.d.ts

@@ -0,0 +1,12 @@
+import type { Skill } from './types.js';
+/**
+ * Discovers all skills inside the cloned repository.
+ *
+ * A "skill" is any immediate subdirectory of `<cloneDir>/skills/` whose name
+ * does not start with a dot.  Regular files and hidden directories are ignored.
+ *
+ * @param cloneDir - Absolute path to the root of the cloned repository.
+ * @returns Array of discovered skills, sorted alphabetically by name.
+ */
+export declare function discoverSkills(cloneDir: string): Promise<Skill[]>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/skills/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/skills/discover.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAgBxC;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAwBvE"}

package/dist/skills/discover.js

@@ -0,0 +1,45 @@
+import path from 'path';
+import fs from 'fs-extra';
+/**
+ * The subdirectory inside the cloned repository that contains individual skill
+ * folders.  Repository layout:
+ *
+ *   <clone>/
+ *     skills/
+ *       remotion/        ← one skill per subdirectory
+ *       mcp-best-practices/
+ *       …
+ *     src/
+ *     README.md
+ */
+const SKILLS_SUBDIR = 'skills';
+/**
+ * Discovers all skills inside the cloned repository.
+ *
+ * A "skill" is any immediate subdirectory of `<cloneDir>/skills/` whose name
+ * does not start with a dot.  Regular files and hidden directories are ignored.
+ *
+ * @param cloneDir - Absolute path to the root of the cloned repository.
+ * @returns Array of discovered skills, sorted alphabetically by name.
+ */
+export async function discoverSkills(cloneDir) {
+    const skillsRoot = path.join(cloneDir, SKILLS_SUBDIR);
+    if (!(await fs.pathExists(skillsRoot))) {
+        return [];
+    }
+    const entries = await fs.readdir(skillsRoot, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+        // Skip hidden entries (e.g. .DS_Store, .git)
+        if (entry.name.startsWith('.'))
+            continue;
+        // Only directories are treated as skills
+        if (!entry.isDirectory())
+            continue;
+        skills.push({
+            name: entry.name,
+            sourcePath: path.join(skillsRoot, entry.name),
+        });
+    }
+    return skills.sort((a, b) => a.name.localeCompare(b.name));
+}

package/dist/skills/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Runs the full agent-skills installation flow.
+ *
+ * Steps:
+ *  1. Clone the skills repository into a temporary directory.
+ *  2. Discover all skills in the `skills/` subdirectory.
+ *  3. Detect supported AI agents installed on the machine.
+ *  4. Prompt the user to select which agents to install skills into.
+ *  5. Install the skills and report results.
+ *  6. Clean up the temporary clone.
+ *
+ * Graceful fallbacks:
+ *  - Git unavailable or clone fails → print warning and return.
+ *  - No agents detected → print warning and return.
+ *  - User selects no agents → return silently.
+ *  - Individual skill copy fails → reported per-agent, does not abort the run.
+ *
+ * @param force - When true, overwrite existing skill files.
+ */
+export declare function runSkillsFlow(force?: boolean, projectDir?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,KAAK,GAAE,OAAe,EAAE,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4E7G"}

package/dist/skills/index.js

@@ -0,0 +1,97 @@
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { cloneSkillsRepo, SkillsCloneError } from './clone.js';
+import { discoverSkills } from './discover.js';
+import { AGENTS } from './detect-agents.js';
+import { installSkills } from './installer.js';
+import { printSkillsHeader, printCloned, printSkillList, printInstalling, printSuccess, printCloneError, } from './ui.js';
+/**
+ * Runs the full agent-skills installation flow.
+ *
+ * Steps:
+ *  1. Clone the skills repository into a temporary directory.
+ *  2. Discover all skills in the `skills/` subdirectory.
+ *  3. Detect supported AI agents installed on the machine.
+ *  4. Prompt the user to select which agents to install skills into.
+ *  5. Install the skills and report results.
+ *  6. Clean up the temporary clone.
+ *
+ * Graceful fallbacks:
+ *  - Git unavailable or clone fails → print warning and return.
+ *  - No agents detected → print warning and return.
+ *  - User selects no agents → return silently.
+ *  - Individual skill copy fails → reported per-agent, does not abort the run.
+ *
+ * @param force - When true, overwrite existing skill files.
+ */
+export async function runSkillsFlow(force = false, projectDir = process.cwd()) {
+    printSkillsHeader();
+    // ── Step 1: Clone ──────────────────────────────────────────────────────────
+    let tempDir;
+    try {
+        tempDir = await cloneSkillsRepo();
+    }
+    catch (err) {
+        const message = err instanceof SkillsCloneError
+            ? err.message
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        printCloneError(message);
+        return;
+    }
+    try {
+        printCloned();
+        // ── Step 2: Discover skills ──────────────────────────────────────────────
+        const skills = await discoverSkills(tempDir);
+        if (skills.length === 0) {
+            console.log(chalk.dim('  No skills found in the repository.\n'));
+            return;
+        }
+        printSkillList(skills);
+        // ── Step 3: Install Project-Level Skills ─────────────────────────────────
+        // Installs the skills for all 6 agents by default at project scope
+        const results = await installSkills(AGENTS, skills, force, 'project', projectDir);
+        printInstalling(results);
+        // Read the skills version from the cloned repository's package.json
+        let skillsVersion = '1.0.0';
+        const skillsPackageJsonPath = path.join(tempDir, 'package.json');
+        if (await fs.pathExists(skillsPackageJsonPath)) {
+            try {
+                const pkgJson = await fs.readJSON(skillsPackageJsonPath);
+                if (pkgJson.version) {
+                    skillsVersion = pkgJson.version;
+                }
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+        // Write skills version to the project's package.json
+        const projectPackageJsonPath = path.join(projectDir, 'package.json');
+        if (await fs.pathExists(projectPackageJsonPath)) {
+            try {
+                const projectPkgJson = await fs.readJSON(projectPackageJsonPath);
+                if (!projectPkgJson.nitrostack) {
+                    projectPkgJson.nitrostack = {};
+                }
+                projectPkgJson.nitrostack.skillsVersion = skillsVersion;
+                await fs.writeJSON(projectPackageJsonPath, projectPkgJson, { spaces: 2 });
+            }
+            catch {
+                // Ignore write errors
+            }
+        }
+        printSuccess();
+    }
+    finally {
+        // ── Cleanup: always remove the temp clone ────────────────────────────────
+        try {
+            await fs.remove(tempDir);
+        }
+        catch {
+            // best-effort; temp files will be cleaned by the OS
+        }
+    }
+}

package/dist/skills/installer.d.ts

@@ -0,0 +1,21 @@
+import type { AgentDescriptor, InstallResult, Skill } from './types.js';
+/**
+ * Installs all discovered skills into the skills directory of a single agent.
+ *
+ * - Creates the target directory if it does not exist.
+ * - Skips individual skills whose destination directory already exists,
+ *   unless `force` is true.
+ * - Preserves the full folder structure of each skill.
+ *
+ * @param agent  - The agent to install into.
+ * @param skills - All skills discovered from the repository.
+ * @param force  - When true, overwrite existing skill directories.
+ * @returns      InstallResult describing what was installed vs skipped.
+ */
+export declare function installSkillsForAgent(agent: AgentDescriptor, skills: Skill[], force: boolean, scope?: 'project' | 'global', projectDir?: string): Promise<InstallResult>;
+/**
+ * Installs skills into every selected agent sequentially.
+ * Sequential (rather than parallel) installation gives cleaner CLI progress output.
+ */
+export declare function installSkills(agents: AgentDescriptor[], skills: Skill[], force: boolean, scope?: 'project' | 'global', projectDir?: string): Promise<InstallResult[]>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/skills/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,SAAS,GAAG,QAAmB,EACtC,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,SAAS,GAAG,QAAmB,EACtC,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAS1B"}

package/dist/skills/installer.js

@@ -0,0 +1,48 @@
+import path from 'path';
+import fs from 'fs-extra';
+/**
+ * Installs all discovered skills into the skills directory of a single agent.
+ *
+ * - Creates the target directory if it does not exist.
+ * - Skips individual skills whose destination directory already exists,
+ *   unless `force` is true.
+ * - Preserves the full folder structure of each skill.
+ *
+ * @param agent  - The agent to install into.
+ * @param skills - All skills discovered from the repository.
+ * @param force  - When true, overwrite existing skill directories.
+ * @returns      InstallResult describing what was installed vs skipped.
+ */
+export async function installSkillsForAgent(agent, skills, force, scope = 'global', projectDir = process.cwd()) {
+    const result = { agent, installed: [], skipped: [] };
+    try {
+        const skillsDir = agent.getSkillsDir(scope, projectDir);
+        await fs.mkdirp(skillsDir);
+        for (const skill of skills) {
+            const dest = path.join(skillsDir, skill.name);
+            const alreadyExists = await fs.pathExists(dest);
+            if (alreadyExists && !force) {
+                result.skipped.push(skill.name);
+                continue;
+            }
+            await fs.copy(skill.sourcePath, dest, { overwrite: force });
+            result.installed.push(skill.name);
+        }
+    }
+    catch (err) {
+        result.error = err instanceof Error ? err.message : String(err);
+    }
+    return result;
+}
+/**
+ * Installs skills into every selected agent sequentially.
+ * Sequential (rather than parallel) installation gives cleaner CLI progress output.
+ */
+export async function installSkills(agents, skills, force, scope = 'global', projectDir = process.cwd()) {
+    const results = [];
+    for (const agent of agents) {
+        const result = await installSkillsForAgent(agent, skills, force, scope, projectDir);
+        results.push(result);
+    }
+    return results;
+}

package/dist/skills/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A single skill discovered from the skills repository.
+ * Each skill maps to one subdirectory under `skills/` in the cloned repo.
+ */
+export interface Skill {
+    /** Directory name — used as the skill identifier and display name */
+    name: string;
+    /** Absolute path to the skill directory inside the temporary clone */
+    sourcePath: string;
+}
+/**
+ * Describes a supported AI coding agent.
+ * Add new agents by appending entries to the AGENTS registry in detect-agents.ts.
+ */
+export interface AgentDescriptor {
+    /** Machine-readable identifier (kebab-case) */
+    id: string;
+    /** Human-readable display name shown in the CLI */
+    name: string;
+    /** Short path hint shown next to the agent name in the selection list */
+    displayPath: string;
+    /** Returns true when the agent appears to be installed on this machine */
+    detect(): Promise<boolean>;
+    /** Returns the absolute path of the directory where skills should be installed */
+    getSkillsDir(scope?: 'project' | 'global', projectDir?: string): string;
+}
+/**
+ * Result of installing skills for one agent.
+ */
+export interface InstallResult {
+    agent: AgentDescriptor;
+    /** Skill names that were successfully copied */
+    installed: string[];
+    /** Skill names that were skipped because the destination already existed */
+    skipped: string[];
+    /** Non-fatal error message, if any */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,kFAAkF;IAClF,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,eAAe,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/skills/types.js

@@ -0,0 +1 @@
+export {};

package/dist/skills/ui.d.ts

@@ -0,0 +1,55 @@
+import type { InstallResult, Skill } from './types.js';
+/**
+ * Prints the skills section header:
+ *
+ *   skills
+ *
+ *   ◇ Source: https://github.com/nitrocloudofficial/skills.git
+ *   ◇ Repository cloned
+ */
+export declare function printSkillsHeader(): void;
+/**
+ * Prints the "Repository cloned" confirmation line.
+ * Called after cloneSkillsRepo() succeeds.
+ */
+export declare function printCloned(): void;
+/**
+ * Prints the discovered skill list:
+ *
+ *   ◇ Found 4 skills
+ *
+ *   • nitrostack-sdk
+ *   • mcp-best-practices
+ *   …
+ */
+export declare function printSkillList(skills: Skill[]): void;
+/**
+ * Prints the detected-agent count line:
+ *
+ *   ◇ Detected 3 agents
+ */
+export declare function printDetectedAgents(count: number): void;
+/**
+ * Prints a warning when no agents are detected so the user knows why the
+ * flow is being skipped rather than seeing a silent no-op.
+ */
+export declare function printNoAgentsWarning(): void;
+/**
+ * Prints the per-agent installation results:
+ *
+ *   Installing...
+ *
+ *   ✔ Cursor         (3 installed)
+ *   ✔ Claude Code    (2 installed, 1 skipped)
+ *   ⚠ Gemini CLI     error: …
+ */
+export declare function printInstalling(results: InstallResult[]): void;
+/**
+ * Prints the final success message.
+ */
+export declare function printSuccess(): void;
+/**
+ * Prints a warning when git is not available or the clone fails.
+ */
+export declare function printCloneError(message: string): void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/skills/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/skills/ui.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAYvD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAQpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAuB9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKrD"}

package/dist/skills/ui.js

@@ -0,0 +1,102 @@
+import chalk from 'chalk';
+import { brand } from '../ui/branding.js';
+import { SKILLS_REPO_URL } from './clone.js';
+// ── Private helpers ──────────────────────────────────────────────────────────
+/** Diamond prefix used for info lines — matches Remotion create-video style */
+const diamond = () => chalk.dim('◇');
+/** Bullet used for list items */
+const bullet = () => brand.sky('•');
+// ── Public output functions ──────────────────────────────────────────────────
+/**
+ * Prints the skills section header:
+ *
+ *   skills
+ *
+ *   ◇ Source: https://github.com/nitrocloudofficial/skills.git
+ *   ◇ Repository cloned
+ */
+export function printSkillsHeader() {
+    console.log('\n' + chalk.white.bold('  skills') + '\n');
+    console.log(`  ${diamond()} ${chalk.dim('Source:')} ${brand.sky(SKILLS_REPO_URL)}`);
+}
+/**
+ * Prints the "Repository cloned" confirmation line.
+ * Called after cloneSkillsRepo() succeeds.
+ */
+export function printCloned() {
+    console.log(`  ${diamond()} ${chalk.dim('Repository cloned')}\n`);
+}
+/**
+ * Prints the discovered skill list:
+ *
+ *   ◇ Found 4 skills
+ *
+ *   • nitrostack-sdk
+ *   • mcp-best-practices
+ *   …
+ */
+export function printSkillList(skills) {
+    console.log(`  ${diamond()} ${chalk.white(`Found ${skills.length} skill${skills.length === 1 ? '' : 's'}`)}\n`);
+    for (const skill of skills) {
+        console.log(`    ${bullet()} ${chalk.white(skill.name)}`);
+    }
+    console.log('');
+}
+/**
+ * Prints the detected-agent count line:
+ *
+ *   ◇ Detected 3 agents
+ */
+export function printDetectedAgents(count) {
+    console.log(`  ${diamond()} ${chalk.white(`Detected ${count} agent${count === 1 ? '' : 's'}`)}\n`);
+}
+/**
+ * Prints a warning when no agents are detected so the user knows why the
+ * flow is being skipped rather than seeing a silent no-op.
+ */
+export function printNoAgentsWarning() {
+    console.log(`  ${chalk.hex('#F59E0B')('⚠')} ${chalk.dim('No supported AI agents detected on this machine.')}\n` +
+        `    ${chalk.dim('Install Cursor, Claude Code, Gemini CLI, or Codex and re-run to add skills.')}\n`);
+}
+/**
+ * Prints the per-agent installation results:
+ *
+ *   Installing...
+ *
+ *   ✔ Cursor         (3 installed)
+ *   ✔ Claude Code    (2 installed, 1 skipped)
+ *   ⚠ Gemini CLI     error: …
+ */
+export function printInstalling(results) {
+    console.log(`\n  ${chalk.white.bold('Installing...')}\n`);
+    for (const result of results) {
+        if (result.error) {
+            const label = chalk.hex('#F59E0B')('⚠');
+            console.log(`    ${label} ${chalk.white(result.agent.name)}  ${chalk.dim('error: ' + result.error)}`);
+            continue;
+        }
+        const label = brand.mint('✔');
+        const parts = [];
+        if (result.installed.length > 0) {
+            parts.push(`${result.installed.length} installed`);
+        }
+        if (result.skipped.length > 0) {
+            parts.push(`${result.skipped.length} skipped`);
+        }
+        const detail = parts.length > 0 ? chalk.dim(`  (${parts.join(', ')})`) : '';
+        console.log(`    ${label} ${chalk.white(result.agent.name)}${detail}`);
+    }
+}
+/**
+ * Prints the final success message.
+ */
+export function printSuccess() {
+    console.log('\n  ' + chalk.white('✨ NitroStack agent skills installed successfully.') + '\n');
+}
+/**
+ * Prints a warning when git is not available or the clone fails.
+ */
+export function printCloneError(message) {
+    console.log(`\n  ${chalk.hex('#F59E0B')('⚠')} ${chalk.dim('Agent skills skipped:')}\n` +
+        `    ${chalk.dim(message)}\n`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitrostack/cli",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "CLI for NitroStack - Create and manage MCP server projects",
   "type": "module",
   "main": "dist/index.js",