@nitrostack/cli 1.0.12 → 1.0.14

package/dist/commands/cursor.d.ts

@@ -0,0 +1,11 @@
+interface CursorOptions {
+    global?: boolean;
+    local?: boolean;
+    type?: string;
+    url?: string;
+    port?: string;
+    force?: boolean;
+}
+export declare function cursorCommand(options: CursorOptions): Promise<void>;
+export {};
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/commands/cursor.ts"],"names":[],"mappings":"AAqBA,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoOzE"}

package/dist/commands/cursor.js

@@ -0,0 +1,238 @@
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs-extra';
+import os from 'os';
+import inquirer from 'inquirer';
+import { createHeader, createSuccessBox, createErrorBox, NitroSpinner, log, spacer, nextSteps, showFooter, NITRO_BANNER_FULL } from '../ui/branding.js';
+import { trackEvent, shutdownAnalytics } from '../analytics/posthog.js';
+/** Normalize CLI --type values, including the deprecated `sse` alias. */
+function normalizeConnectionType(raw) {
+    if (!raw)
+        return undefined;
+    if (raw === 'sse')
+        return 'legacy-sse';
+    if (raw === 'command' || raw === 'legacy-sse' || raw === 'streamable-http') {
+        return raw;
+    }
+    return undefined;
+}
+function defaultHttpUrl(type, port) {
+    if (type === 'streamable-http') {
+        return `http://localhost:${port}/mcp`;
+    }
+    return `http://localhost:${port}/sse`;
+}
+function isHttpConnectionType(type) {
+    return type === 'legacy-sse' || type === 'streamable-http';
+}
+export async function cursorCommand(options) {
+    console.log(NITRO_BANNER_FULL);
+    console.log(createHeader('Cursor Integration', 'Configure MCP server in Cursor'));
+    const startTime = Date.now();
+    trackEvent('cli_command_invoked', {
+        command: 'cursor',
+        options: Object.keys(options).filter(k => options[k] !== undefined),
+    });
+    const projectRoot = process.cwd();
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    // Validate project
+    if (!fs.existsSync(packageJsonPath)) {
+        console.log(createErrorBox('Not a Valid Project', 'package.json not found in the current directory.'));
+        trackEvent('cli_cursor_failed', {
+            error: 'Not a valid project: package.json missing',
+        });
+        await shutdownAnalytics();
+        process.exit(1);
+    }
+    let packageJson;
+    try {
+        packageJson = await fs.readJson(packageJsonPath);
+    }
+    catch (error) {
+        console.log(createErrorBox('Invalid package.json', 'Could not parse project package.json.'));
+        trackEvent('cli_cursor_failed', {
+            error: 'Invalid package.json parsing error',
+        });
+        await shutdownAnalytics();
+        process.exit(1);
+    }
+    const rawName = packageJson.name || path.basename(projectRoot);
+    const serverName = rawName.includes('/') ? rawName.split('/').pop() : rawName;
+    let target;
+    if (options.global) {
+        target = 'global';
+    }
+    else if (options.local) {
+        target = 'local';
+    }
+    else {
+        const answers = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'target',
+                message: chalk.white('Where would you like to install the Cursor MCP configuration?'),
+                choices: [
+                    { name: `Project-level ${chalk.dim('(.cursor/mcp.json)')}`, value: 'local' },
+                    { name: `Global        ${chalk.dim('(~/.cursor/mcp.json)')}`, value: 'global' },
+                ],
+                default: 'local',
+            }
+        ]);
+        target = answers.target;
+    }
+    let type = normalizeConnectionType(options.type);
+    if (options.type && !type) {
+        console.log(createErrorBox('Invalid connection type', `Unknown --type "${options.type}". Use: command, legacy-sse, or streamable-http.`));
+        await shutdownAnalytics();
+        process.exit(1);
+    }
+    if (!type) {
+        const answers = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'type',
+                message: chalk.white('Choose the connection type for Cursor:'),
+                choices: [
+                    { name: `Command (Stdio)          ${chalk.dim('─ Starts subprocess (recommended for local dev)')}`, value: 'command' },
+                    { name: `Legacy SSE (/sse)        ${chalk.dim('─ Cursor and older HTTP clients (recommended for Cursor)')}`, value: 'legacy-sse' },
+                    { name: `Streamable HTTP (/mcp)   ${chalk.dim('─ MCP Inspector and modern Streamable HTTP clients')}`, value: 'streamable-http' },
+                ],
+                default: 'command',
+            }
+        ]);
+        type = answers.type;
+    }
+    if (!type) {
+        console.log(createErrorBox('Invalid connection type', 'No connection type selected.'));
+        await shutdownAnalytics();
+        process.exit(1);
+    }
+    const port = options.port || '3000';
+    let httpUrl = options.url;
+    if (isHttpConnectionType(type) && !httpUrl) {
+        const defaultUrl = defaultHttpUrl(type, port);
+        const urlHint = type === 'legacy-sse'
+            ? chalk.dim('Default /sse; /mcp also works for Cursor (legacy SSE fallback on GET).')
+            : chalk.dim('For MCP Inspector and clients that use POST initialize + mcp-session-id.');
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'url',
+                message: chalk.white('HTTP connection URL:'),
+                default: defaultUrl,
+            }
+        ]);
+        httpUrl = answers.url;
+        if (urlHint) {
+            console.log(urlHint);
+        }
+    }
+    let configFilePath;
+    if (target === 'global') {
+        configFilePath = path.join(os.homedir(), '.cursor', 'mcp.json');
+    }
+    else {
+        configFilePath = path.join(projectRoot, '.cursor', 'mcp.json');
+    }
+    let entry;
+    if (type === 'command') {
+        const absIndexPath = path.join(projectRoot, 'dist', 'index.js');
+        entry = {
+            command: 'node',
+            args: [absIndexPath],
+            env: {}
+        };
+    }
+    else {
+        entry = {
+            url: httpUrl
+        };
+    }
+    const spinner = new NitroSpinner(`Configuring Cursor MCP server...`).start();
+    try {
+        await fs.ensureDir(path.dirname(configFilePath));
+        let mcpConfig = { mcpServers: {} };
+        if (await fs.pathExists(configFilePath)) {
+            try {
+                mcpConfig = await fs.readJson(configFilePath);
+            }
+            catch (e) {
+                // Corrupted or empty file, initialize it
+                mcpConfig = { mcpServers: {} };
+            }
+        }
+        if (!mcpConfig.mcpServers) {
+            mcpConfig.mcpServers = {};
+        }
+        // Check if it already exists
+        if (mcpConfig.mcpServers[serverName] && !options.force) {
+            spinner.stop();
+            const { overwrite } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: chalk.yellow(`MCP Server "${serverName}" is already registered in Cursor config. Overwrite?`),
+                    default: true,
+                }
+            ]);
+            if (!overwrite) {
+                log('Cancelled integration', 'warning');
+                trackEvent('cli_cursor_cancelled', {
+                    server_name: serverName,
+                    target,
+                    type,
+                });
+                await shutdownAnalytics();
+                return;
+            }
+            spinner.start();
+        }
+        mcpConfig.mcpServers[serverName] = entry;
+        await fs.writeJson(configFilePath, mcpConfig, { spaces: 2 });
+        spinner.succeed(`Registered "${serverName}" in Cursor config`);
+    }
+    catch (err) {
+        spinner.fail('Failed to update Cursor configuration');
+        console.log(createErrorBox('Integration Failed', err instanceof Error ? err.message : String(err)));
+        trackEvent('cli_cursor_failed', {
+            error: err instanceof Error ? err.message : String(err),
+            target,
+            type,
+        });
+        await shutdownAnalytics();
+        return;
+    }
+    // Summary
+    spacer();
+    console.log(createSuccessBox('Cursor Integration Successful', [
+        `Configured target: ${chalk.cyan(configFilePath)}`,
+        `Server registered: ${chalk.cyan(serverName)}`,
+        `Connection type:   ${chalk.cyan(type)}`,
+        type === 'command'
+            ? `Command path:      ${chalk.dim(path.join(projectRoot, 'dist', 'index.js'))}`
+            : `HTTP URL:          ${chalk.cyan(httpUrl)}`
+    ]));
+    if (type === 'command') {
+        // Check if dist/index.js exists
+        const distIndexPath = path.join(projectRoot, 'dist', 'index.js');
+        if (!fs.existsSync(distIndexPath)) {
+            log('Warning: dist/index.js not found. Remember to run "npm run build" first!', 'warning');
+            spacer();
+        }
+    }
+    if (type === 'legacy-sse') {
+        log('Tip: ensure the server is running in dual or http mode before connecting from Cursor.', 'info');
+    }
+    nextSteps([
+        'Restart/Reload your Cursor window to load the new MCP server',
+        'Check active MCP servers in Cursor under Settings > Tools > MCP',
+    ]);
+    showFooter();
+    trackEvent('cli_cursor_completed', {
+        target,
+        type,
+        server_name: serverName,
+        duration_ms: Date.now() - startTime,
+    });
+    await shutdownAnalytics();
+}

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

@@ -2,6 +2,18 @@ interface UpgradeOptions {
     latest?: boolean;
     dryRun?: boolean;
 }
+/**
+ * Fetch a package's latest published version from NPM using standard https module.
+ */
+export declare function fetchLatestNpmVersion(packageName: string): Promise<string>;
+/**
+ * Compare two version strings
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Determine if a dependency refers to a local file or workspace link.
+ */
+export declare function isLocalDependency(version: string): boolean;
 /**
  * Main upgrade command handler
  */

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA0BA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAwHD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2J3E"}
+{"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"}