@nitrostack/cli 1.0.13 → 1.0.15

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,13 +1,14 @@
 {
   "name": "@nitrostack/cli",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "CLI for NitroStack - Create and manage MCP server projects",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
     "nitrostack-cli": "dist/index.js",
-    "@nitrostack/cli": "dist/index.js"
+    "@nitrostack/cli": "dist/index.js",
+    "nitrostack-pack": "dist/pack/standalone.js"
   },
   "exports": {
     ".": {
@@ -23,7 +24,7 @@
     "assets"
   ],
   "scripts": {
-    "build": "tsc && chmod +x dist/index.js",
+    "build": "tsc && chmod +x dist/index.js dist/pack/standalone.js",
     "dev": "tsc --watch",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
@@ -40,6 +41,7 @@
   "author": "Nitrostack Inc <hello@nitrostack.ai>",
   "license": "Apache-2.0",
   "dependencies": {
+    "archiver": "^7.0.1",
     "chalk": "^5.3.0",
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
@@ -51,6 +53,7 @@
     "posthog-node": "^5.21.2"
   },
   "devDependencies": {
+    "@types/archiver": "^6.0.3",
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
     "@types/jest": "^29.5.14",

package/templates/typescript-oauth/.env.example

@@ -1,6 +1,6 @@
 # NitroStack Configuration
 NITRO_LOG_LEVEL=info
-NITROSTACK_APP_MODE=openai
+NITROSTACK_APP_MODE=universal
 
 # Server Transport Configuration (Optional)
 # =============================================================================

package/templates/typescript-oauth/_gitignore

@@ -0,0 +1,57 @@
+# Dependencies
+node_modules/
+src/widgets/node_modules/
+
+# Build outputs
+dist/
+src/widgets/.next/
+src/widgets/out/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage
+coverage/
+.nyc_output/
+
+# Uploads
+uploads/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache
+.npm/
+
+# Optional eslint cache
+.eslintcache
+
+# OAuth tokens/secrets (never commit these!)
+*.pem
+*.key
+tokens.json

package/templates/typescript-pizzaz/.env.example

@@ -1,6 +1,6 @@
 # NitroStack Configuration
 NITRO_LOG_LEVEL=info
-NITROSTACK_APP_MODE=openai
+NITROSTACK_APP_MODE=universal
 
 # Server Transport Configuration (Optional)
 # =============================================================================

package/templates/typescript-pizzaz/_gitignore

@@ -0,0 +1,57 @@
+# Dependencies
+node_modules/
+src/widgets/node_modules/
+
+# Build outputs
+dist/
+src/widgets/.next/
+src/widgets/out/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage
+coverage/
+.nyc_output/
+
+# Uploads
+uploads/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache
+.npm/
+
+# Optional eslint cache
+.eslintcache
+
+# OAuth tokens/secrets (never commit these!)
+*.pem
+*.key
+tokens.json

package/templates/typescript-starter/.env.example

@@ -1,6 +1,6 @@
 # NitroStack Configuration
 NITRO_LOG_LEVEL=info
-NITROSTACK_APP_MODE=openai
+NITROSTACK_APP_MODE=universal
 
 # Server Transport Configuration (Optional)
 # =============================================================================

package/templates/typescript-starter/_gitignore

@@ -0,0 +1,57 @@
+# Dependencies
+node_modules/
+src/widgets/node_modules/
+
+# Build outputs
+dist/
+src/widgets/.next/
+src/widgets/out/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage
+coverage/
+.nyc_output/
+
+# Uploads
+uploads/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache
+.npm/
+
+# Optional eslint cache
+.eslintcache
+
+# OAuth tokens/secrets (never commit these!)
+*.pem
+*.key
+tokens.json