ui-pro-forge-cli 2.5.0

package/assets/templates/platforms/kiro.json

@@ -0,0 +1,21 @@
+{
+  "platform": "kiro",
+  "displayName": "Kiro",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".kiro",
+    "skillPath": "steering/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "steering/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks."
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Workflow"
+}

package/assets/templates/platforms/opencode.json

@@ -0,0 +1,21 @@
+{
+  "platform": "opencode",
+  "displayName": "OpenCode",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".opencode",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "UI/UX design intelligence with searchable database"
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Skill"
+}

package/assets/templates/platforms/qoder.json

@@ -0,0 +1,21 @@
+{
+  "platform": "qoder",
+  "displayName": "Qoder",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".qoder",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "UI/UX design intelligence with searchable database"
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Skill"
+}

package/assets/templates/platforms/roocode.json

@@ -0,0 +1,21 @@
+{
+  "platform": "roocode",
+  "displayName": "Roo Code",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".roo",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks."
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Workflow"
+}

package/assets/templates/platforms/trae.json

@@ -0,0 +1,21 @@
+{
+  "platform": "trae",
+  "displayName": "Trae",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".trae",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "UI/UX design intelligence with searchable database"
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Skill"
+}

package/assets/templates/platforms/warp.json

@@ -0,0 +1,18 @@
+{
+  "platform": "warp",
+  "displayName": "Warp",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".warp",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": null,
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Skill"
+}

package/assets/templates/platforms/windsurf.json

@@ -0,0 +1,21 @@
+{
+  "platform": "windsurf",
+  "displayName": "Windsurf",
+  "installType": "full",
+  "folderStructure": {
+    "root": ".windsurf",
+    "skillPath": "skills/ui-pro-forge",
+    "filename": "SKILL.md"
+  },
+  "scriptPath": "skills/ui-pro-forge/scripts/search.py",
+  "frontmatter": {
+    "name": "ui-pro-forge",
+    "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks."
+  },
+  "sections": {
+    "quickReference": false
+  },
+  "title": "ui-pro-forge",
+  "description": "Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks. Searchable database with priority-based recommendations.",
+  "skillOrWorkflow": "Skill"
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+import type { AIType } from '../types/index.js';
+interface InitOptions {
+    ai?: AIType;
+    force?: boolean;
+    offline?: boolean;
+    legacy?: boolean;
+    global?: boolean;
+    token?: string;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};

package/dist/commands/init.js

@@ -0,0 +1,165 @@
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { AI_TYPES } from '../types/index.js';
+import { copyFolders, installFromZip, createTempDir, cleanup } from '../utils/extract.js';
+import { generatePlatformFiles, generateAllPlatformFiles } from '../utils/template.js';
+import { detectAIType, getAITypeDescription } from '../utils/detect.js';
+import { logger } from '../utils/logger.js';
+import { getLatestRelease, getAssetUrl, downloadRelease, getGitHubTokenGuidance, GitHubRateLimitError, GitHubDownloadError, } from '../utils/github.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ASSETS_CANDIDATES = [
+    // Bun bundle: dist/index.js
+    join(__dirname, '..', 'assets'),
+    // TypeScript fallback: dist/commands/init.js
+    join(__dirname, '..', '..', 'assets'),
+];
+const ASSETS_DIR = ASSETS_CANDIDATES.find(path => existsSync(path)) ?? ASSETS_CANDIDATES[0];
+/**
+ * Try to install from GitHub release (legacy method)
+ * Returns the copied folders if successful, null if failed
+ */
+async function tryGitHubInstall(targetDir, aiType, spinner, token) {
+    let tempDir = null;
+    try {
+        spinner.text = 'Fetching latest release from GitHub...';
+        const release = await getLatestRelease(token);
+        const assetUrl = getAssetUrl(release);
+        if (!assetUrl) {
+            throw new GitHubDownloadError('No ZIP asset found in latest release');
+        }
+        spinner.text = `Downloading ${release.tag_name}...`;
+        tempDir = await createTempDir();
+        const zipPath = join(tempDir, 'release.zip');
+        await downloadRelease(assetUrl, zipPath, token);
+        spinner.text = 'Extracting and installing files...';
+        const { copiedFolders, tempDir: extractedTempDir } = await installFromZip(zipPath, targetDir, aiType);
+        // Cleanup temp directory
+        await cleanup(extractedTempDir);
+        return copiedFolders;
+    }
+    catch (error) {
+        // Cleanup temp directory on error
+        if (tempDir) {
+            await cleanup(tempDir);
+        }
+        if (error instanceof GitHubRateLimitError) {
+            spinner.warn(`GitHub rate limit reached, falling back to bundled assets.\n${getGitHubTokenGuidance()}`);
+            return null;
+        }
+        if (error instanceof GitHubDownloadError) {
+            spinner.warn('GitHub download failed, using template generation...');
+            return null;
+        }
+        // Network errors or other fetch failures
+        if (error instanceof TypeError && error.message.includes('fetch')) {
+            spinner.warn('Network error, using template generation...');
+            return null;
+        }
+        // Unknown errors - still fall back
+        spinner.warn('Download failed, using template generation...');
+        return null;
+    }
+}
+/**
+ * Install using template generation (new method)
+ */
+async function templateInstall(targetDir, aiType, spinner, isGlobal = false, force = false) {
+    spinner.text = isGlobal
+        ? 'Generating skill files globally...'
+        : 'Generating skill files from templates...';
+    if (aiType === 'all') {
+        return generateAllPlatformFiles(targetDir, isGlobal, force);
+    }
+    return generatePlatformFiles(targetDir, aiType, isGlobal, force);
+}
+export async function initCommand(options) {
+    logger.title('UI Pro Forge Installer');
+    let aiType = options.ai;
+    // Auto-detect or prompt for AI type
+    if (!aiType) {
+        const { detected, suggested } = detectAIType();
+        if (detected.length > 0) {
+            logger.info(`Detected: ${detected.map(t => chalk.cyan(t)).join(', ')}`);
+        }
+        const response = await prompts({
+            type: 'select',
+            name: 'aiType',
+            message: 'Select AI assistant to install for:',
+            choices: AI_TYPES.map(type => ({
+                title: getAITypeDescription(type),
+                value: type,
+            })),
+            initial: suggested ? AI_TYPES.indexOf(suggested) : 0,
+        });
+        if (!response.aiType) {
+            logger.warn('Installation cancelled');
+            return;
+        }
+        aiType = response.aiType;
+    }
+    const isGlobal = !!options.global;
+    const modeLabel = isGlobal ? ' (global)' : '';
+    logger.info(`Installing for: ${chalk.cyan(getAITypeDescription(aiType))}${modeLabel}`);
+    const spinner = ora('Installing files...').start();
+    const cwd = process.cwd();
+    let copiedFolders = [];
+    let installMethod = 'template';
+    try {
+        // Use legacy ZIP-based install if --legacy flag is set
+        if (options.legacy) {
+            if (isGlobal) {
+                spinner.warn('--global is not supported with --legacy mode, installing locally instead');
+            }
+            // Try GitHub download first (unless offline mode)
+            if (!options.offline) {
+                const githubResult = await tryGitHubInstall(cwd, aiType, spinner, options.token);
+                if (githubResult) {
+                    copiedFolders = githubResult;
+                    installMethod = 'github';
+                }
+            }
+            // Fall back to bundled assets if GitHub failed or offline mode
+            if (installMethod !== 'github') {
+                spinner.text = 'Installing from bundled assets...';
+                copiedFolders = await copyFolders(ASSETS_DIR, cwd, aiType);
+                installMethod = 'bundled';
+            }
+        }
+        else {
+            // Use new template-based generation (default)
+            copiedFolders = await templateInstall(cwd, aiType, spinner, isGlobal, options.force);
+            installMethod = 'template';
+        }
+        const methodMessage = {
+            github: 'Installed from GitHub release!',
+            bundled: 'Installed from bundled assets!',
+            template: 'Generated from templates!',
+        }[installMethod];
+        spinner.succeed(methodMessage);
+        // Summary
+        console.log();
+        logger.info('Installed folders:');
+        copiedFolders.forEach(folder => {
+            console.log(`  ${chalk.green('+')} ${folder}`);
+        });
+        console.log();
+        logger.success('UI Pro Forge installed successfully!');
+        // Next steps
+        console.log();
+        console.log(chalk.bold('Next steps:'));
+        console.log(chalk.dim('  1. Restart your AI coding assistant'));
+        console.log(chalk.dim('  2. Try: "Build a landing page for a SaaS product"'));
+        console.log();
+    }
+    catch (error) {
+        spinner.fail('Installation failed');
+        if (error instanceof Error) {
+            logger.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/uninstall.d.ts

@@ -0,0 +1,7 @@
+import type { AIType } from '../types/index.js';
+interface UninstallOptions {
+    ai?: AIType;
+    global?: boolean;
+}
+export declare function uninstallCommand(options: UninstallOptions): Promise<void>;
+export {};

package/dist/commands/uninstall.js

@@ -0,0 +1,131 @@
+import { rm, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { AI_FOLDERS } from '../types/index.js';
+import { detectAIType, getAITypeDescription } from '../utils/detect.js';
+import { listBundledSubSkills, loadPlatformConfig } from '../utils/template.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Remove skill directory for a given AI type
+ */
+async function removeSkillDir(baseDir, aiType) {
+    const removed = [];
+    // The orchestrator plus the bundled sibling sub-skills installed by init.
+    const skillNames = ['ui-pro-forge', ...(await listBundledSubSkills())];
+    // Parent directories to clean. Derive the real install location from the
+    // platform config's skillPath (same source the installer uses), so
+    // non-`skills/` platforms are handled — copilot installs under
+    // `.github/prompts/`, kiro under `.kiro/steering/`. Also clean the legacy
+    // `<folder>/skills/` layout (incl. `.shared/`) so older installs are removed.
+    const parents = new Set();
+    try {
+        const { folderStructure } = await loadPlatformConfig(aiType);
+        parents.add(join(folderStructure.root, dirname(folderStructure.skillPath)));
+    }
+    catch {
+        // No platform config — fall back to the legacy folders below.
+    }
+    for (const folder of AI_FOLDERS[aiType]) {
+        parents.add(join(folder, 'skills'));
+    }
+    for (const parent of parents) {
+        for (const name of skillNames) {
+            const skillDir = join(baseDir, parent, name);
+            try {
+                await stat(skillDir);
+                await rm(skillDir, { recursive: true, force: true });
+                removed.push(`${parent.replaceAll('\\', '/')}/${name}`);
+            }
+            catch (err) {
+                // Skip non-existent dirs; re-throw permission or other errors
+                if (err.code !== 'ENOENT')
+                    throw err;
+            }
+        }
+    }
+    return removed;
+}
+export async function uninstallCommand(options) {
+    logger.title('UI Pro Forge Uninstaller');
+    const isGlobal = !!options.global;
+    const baseDir = isGlobal ? homedir() : process.cwd();
+    const locationLabel = isGlobal ? '~/ (global)' : process.cwd();
+    let aiType = options.ai;
+    const { detected: initialDetected } = detectAIType(baseDir);
+    // Auto-detect or prompt for AI type
+    if (!aiType) {
+        const detected = initialDetected;
+        if (detected.length === 0) {
+            logger.warn('No installed AI skill directories detected.');
+            return;
+        }
+        logger.info(`Detected installations: ${detected.map(t => chalk.cyan(t)).join(', ')}`);
+        const choices = [
+            ...detected.map(type => ({
+                title: getAITypeDescription(type),
+                value: type,
+            })),
+            { title: 'All detected', value: 'all' },
+        ];
+        const response = await prompts({
+            type: 'select',
+            name: 'aiType',
+            message: 'Select which AI skill to uninstall:',
+            choices,
+        });
+        if (!response.aiType) {
+            logger.warn('Uninstall cancelled');
+            return;
+        }
+        aiType = response.aiType;
+    }
+    // Confirm before removing
+    const { confirmed } = await prompts({
+        type: 'confirm',
+        name: 'confirmed',
+        message: `Remove UI Pro Forge skill for ${chalk.cyan(getAITypeDescription(aiType))} from ${locationLabel}?`,
+        initial: false,
+    });
+    if (!confirmed) {
+        logger.warn('Uninstall cancelled');
+        return;
+    }
+    const spinner = ora('Removing skill files...').start();
+    try {
+        const allRemoved = [];
+        if (aiType === 'all') {
+            // Remove for all detected platforms
+            for (const type of initialDetected) {
+                const removed = await removeSkillDir(baseDir, type);
+                allRemoved.push(...removed);
+            }
+        }
+        else {
+            const removed = await removeSkillDir(baseDir, aiType);
+            allRemoved.push(...removed);
+        }
+        if (allRemoved.length === 0) {
+            spinner.warn('No skill files found to remove');
+            return;
+        }
+        spinner.succeed('Skill files removed!');
+        console.log();
+        logger.info('Removed:');
+        allRemoved.forEach(folder => {
+            console.log(`  ${chalk.red('-')} ${folder}`);
+        });
+        console.log();
+        logger.success('UI Pro Forge uninstalled successfully!');
+        console.log();
+    }
+    catch (error) {
+        spinner.fail('Uninstall failed');
+        if (error instanceof Error) {
+            logger.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/update.d.ts

@@ -0,0 +1,7 @@
+import type { AIType } from '../types/index.js';
+interface UpdateOptions {
+    ai?: AIType;
+    token?: string;
+}
+export declare function updateCommand(options: UpdateOptions): Promise<void>;
+export {};

package/dist/commands/update.js

@@ -0,0 +1,73 @@
+import { execFileSync } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getLatestRelease } from '../utils/github.js';
+import { logger } from '../utils/logger.js';
+import { initCommand } from './init.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CLI_PACKAGE_NAME = 'ui-pro-forge-cli';
+async function getPackageVersion() {
+    const packagePath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(await readFile(packagePath, 'utf-8'));
+    return pkg.version;
+}
+function normalizeTagVersion(tagName) {
+    return tagName.replace(/^v/i, '');
+}
+export async function updateCommand(options) {
+    logger.title('UI Pro Forge Updater');
+    const spinner = ora('Checking for updates...').start();
+    try {
+        const release = await getLatestRelease(options.token);
+        const currentVersion = await getPackageVersion();
+        const latestVersion = normalizeTagVersion(release.tag_name);
+        spinner.succeed(`Latest version: ${chalk.cyan(release.tag_name)}`);
+        if (currentVersion !== latestVersion) {
+            console.log();
+            // Only auto-run with a well-formed semver, so nothing unexpected can
+            // reach the shell that npm.cmd requires on Windows.
+            if (!/^\d+\.\d+\.\d+([.-][0-9A-Za-z.-]+)?$/.test(latestVersion)) {
+                logger.warn(`Installed CLI is ${chalk.cyan(currentVersion)}; latest release is ${chalk.cyan(release.tag_name)}.`);
+                logger.info(`Update the CLI package: ${chalk.cyan(`npm install -g ${CLI_PACKAGE_NAME}@${latestVersion}`)}`);
+                logger.info('Then rerun: uipro init --ai <platform> --force');
+                return;
+            }
+            logger.info(`Updating CLI from ${chalk.cyan(currentVersion)} to ${chalk.cyan(latestVersion)}...`);
+            console.log();
+            const isWindows = process.platform === 'win32';
+            try {
+                // execFileSync with an explicit args array — no shell string to expand.
+                // On Windows npm is npm.cmd, which Node only spawns via a shell.
+                execFileSync(isWindows ? 'npm.cmd' : 'npm', ['install', '-g', `${CLI_PACKAGE_NAME}@${latestVersion}`], { stdio: 'inherit', shell: isWindows });
+            }
+            catch {
+                console.log();
+                logger.error('Automatic update failed (you may need elevated/admin permissions).');
+                logger.info(`Update manually: ${chalk.cyan(`npm install -g ${CLI_PACKAGE_NAME}@${latestVersion}`)}`);
+                process.exit(1);
+            }
+            console.log();
+            logger.success(`Updated to ${chalk.cyan(latestVersion)}.`);
+            logger.info(`Now rerun ${chalk.cyan('uipro init --ai <platform> --force')} to refresh your skill files.`);
+            return;
+        }
+        console.log();
+        logger.info('Refreshing installed skill files from this CLI package...');
+        console.log();
+        await initCommand({
+            ai: options.ai,
+            force: true,
+            token: options.token,
+        });
+    }
+    catch (error) {
+        spinner.fail('Update check failed');
+        if (error instanceof Error) {
+            logger.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/versions.d.ts

@@ -0,0 +1,5 @@
+interface VersionsOptions {
+    token?: string;
+}
+export declare function versionsCommand(options?: VersionsOptions): Promise<void>;
+export {};

package/dist/commands/versions.js

@@ -0,0 +1,36 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { fetchReleases } from '../utils/github.js';
+import { logger } from '../utils/logger.js';
+export async function versionsCommand(options = {}) {
+    const spinner = ora('Fetching available versions...').start();
+    try {
+        const releases = await fetchReleases(options.token);
+        if (releases.length === 0) {
+            spinner.warn('No releases found');
+            return;
+        }
+        spinner.succeed(`Found ${releases.length} version(s)\n`);
+        console.log(chalk.bold('Available versions:\n'));
+        releases.forEach((release, index) => {
+            const isLatest = index === 0;
+            const tag = release.tag_name;
+            const date = new Date(release.published_at).toLocaleDateString();
+            if (isLatest) {
+                console.log(`  ${chalk.green('*')} ${chalk.bold(tag)} ${chalk.dim(`(${date})`)} ${chalk.green('[latest]')}`);
+            }
+            else {
+                console.log(`    ${tag} ${chalk.dim(`(${date})`)}`);
+            }
+        });
+        console.log();
+        logger.dim('Update the CLI package first, then run: uipro init --ai <platform>');
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch versions');
+        if (error instanceof Error) {
+            logger.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};