@magic-ingredients/tiny-brain-local 0.5.0 → 0.6.0

package/README.md

@@ -1,22 +1,155 @@
 # @magic-ingredients/tiny-brain-local
 
-Local MCP server implementation for Tiny Brain AI assistant.
+Local MCP server implementation for Tiny Brain AI assistant with CLI installation tool.
 
 ## Overview
 
-This package provides a local MCP (Model Context Protocol) server that runs on your machine using stdio transport. It uses the filesystem for storage and includes all the tools and prompts needed to run Tiny Brain locally.
+This package serves dual purposes:
+1. **MCP Server**: A local MCP (Model Context Protocol) server that runs on your machine using stdio transport
+2. **CLI Tool**: A command-line tool to install the MCP server across different AI platforms
 
 ## Installation
 
+### Option 1: NPM Global Installation (Recommended)
+
 ```bash
 npm install -g @magic-ingredients/tiny-brain-local
 ```
 
+### Option 2: DXT Package Installation
+
+For Claude Desktop users who prefer DXT packages:
+
+1. Download the latest `.dxt` package from [tiny-brain.com](https://tiny-brain.com)
+2. Install using the DXT tool in Claude Desktop
+
 ## Usage
 
-### With Claude Desktop
+### As MCP Server
+
+When run without arguments, tiny-brain operates as an MCP server:
+
+```bash
+tiny-brain
+```
+
+### As CLI Installation Tool
+
+The CLI provides commands to install, uninstall, and manage the MCP server across different AI platforms.
+
+#### Install Command
+
+Install tiny-brain on specific platforms or interactively:
+
+```bash
+# Interactive installation (recommended)
+tiny-brain install
+
+# Install on specific platform
+tiny-brain install claude-code
+tiny-brain install claude-desktop
+tiny-brain install cursor
+tiny-brain install chatgpt
+
+# Install on all supported platforms
+tiny-brain install --all
+
+# Install with validation
+tiny-brain install --validate
+```
+
+#### Uninstall Command
+
+Remove tiny-brain from platforms:
+
+```bash
+# Interactive uninstallation
+tiny-brain uninstall
+
+# Uninstall from specific platform
+tiny-brain uninstall claude-code
+
+# Uninstall from all platforms
+tiny-brain uninstall --all
+
+# Skip confirmation prompt
+tiny-brain uninstall --force
+```
+
+#### Status Command
+
+Check installation status across platforms:
+
+```bash
+# Check all platforms
+tiny-brain status
+
+# Check specific platform
+tiny-brain status --platform claude-code
+
+# Show detailed information
+tiny-brain status --verbose
+```
+
+#### List Command
+
+List all supported platforms:
+
+```bash
+# List supported platforms
+tiny-brain list
+
+# Show which platforms are detected on system
+tiny-brain list --detected
+```
+
+## Supported Platforms
+
+| Platform | Description | Config Location |
+|----------|-------------|-----------------|
+| **Claude Code** | Anthropic's AI coding assistant CLI tool | `~/.claude/code/config.json` |
+| **Claude Desktop** | Desktop chat application for Claude AI | Platform-specific (see below) |
+| **Cursor IDE** | AI-powered code editor built on VSCode | `~/.cursor/config.json` |
+| **ChatGPT Desktop** | OpenAI's desktop chat application | Platform-specific |
+
+### Platform-Specific Config Locations
+
+**Claude Desktop:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
 
-Add to your Claude Desktop config:
+## Features
+
+### MCP Server Features
+
+- **Personas**: Context-aware AI personalities with memory
+- **Rules System**: Universal directives that apply across all personas
+- **Planning**: Collaborative task management and tracking
+- **Thinking**: Structured reasoning chains with consistency checking
+- **Strategies**: Content generation strategies for different scenarios
+- **Updates**: Automatic version checking and update notifications
+
+### CLI Features
+
+- **Interactive Mode**: User-friendly prompts for platform selection
+- **Multi-Platform Support**: Install on multiple platforms simultaneously
+- **Validation**: Test server startup during installation
+- **Bundled Runtime Detection**: Automatically uses bundled Node.js from AI platforms
+- **Progress Indicators**: Visual feedback with emojis during operations
+- **Backup & Restore**: Automatic config backup before modifications
+
+## Storage
+
+All Tiny Brain data is stored locally. See [Storage Paths Documentation](../../docs/storage-paths.md) for detailed information about data storage locations and configuration.
+
+## Manual Configuration
+
+If you prefer to configure manually or the CLI doesn't work for your setup:
+
+### Claude Desktop
+
+Add to your Claude Desktop config file:
 
 ```json
 {
@@ -29,30 +162,56 @@ Add to your Claude Desktop config:
 }
 ```
 
-### Command Line
+### Claude Code
 
-```bash
-tiny-brain
+Add to `~/.claude/code/config.json`:
+
+```json
+{
+  "servers": {
+    "tiny-brain": {
+      "command": "npx",
+      "args": ["@magic-ingredients/tiny-brain-local"]
+    }
+  }
+}
 ```
 
-## Features
+## Troubleshooting
 
-- **Personas**: Context-aware AI personalities
-- **Memory**: Persistent knowledge storage
-- **Planning**: Task management and tracking
-- **Thinking**: Structured reasoning chains
-- **Strategies**: Content generation strategies
-- **Updates**: Auto-update checking
+### Common Issues
 
-## Storage
+**Installation fails with "command not found"**
+- Ensure Node.js 18+ is installed: `node --version`
+- If using NPM, ensure global packages are in PATH
+- Try using `npx` directly: `npx @magic-ingredients/tiny-brain-local install`
 
-All data is stored locally in `~/.claude/tiny-brain/` directory.
+**"Platform not detected" error**
+- The CLI couldn't find the AI application
+- Check if the application is installed in the standard location
+- Use manual configuration as a fallback
 
-## Dependencies
+**Permission denied errors**
+- On macOS/Linux, you may need to use `sudo` for global installation
+- Alternatively, use npx to run without installing: `npx @magic-ingredients/tiny-brain-local`
 
-- `@magic-ingredients/tiny-brain-core`: Core business logic
-- `@modelcontextprotocol/sdk`: MCP protocol implementation
-- `zod`: Schema validation
+**Server validation fails**
+- Ensure no other process is using the required ports
+- Check firewall settings aren't blocking the application
+- Try installing without validation: remove `--validate` flag
+
+**Config file not found**
+- Some platforms may not create config files until first launch
+- Launch the AI application once before running the installer
+- Create the config directory manually if needed
+
+### Debug Mode
+
+For troubleshooting, you can run with debug output:
+
+```bash
+DEBUG=tiny-brain* tiny-brain install
+```
 
 ## Development
 
@@ -60,16 +219,28 @@ All data is stored locally in `~/.claude/tiny-brain/` directory.
 # Install dependencies
 npm install
 
-# Build
+# Build both server and CLI
 npm run build
 
 # Run tests
 npm test
 
-# Development mode
+# Development mode (watches for changes)
 npm run dev
+
+# Test CLI locally
+npm run build && node dist/cli.js install
 ```
 
+## Dependencies
+
+- `@magic-ingredients/tiny-brain-core`: Core business logic
+- `@modelcontextprotocol/sdk`: MCP protocol implementation
+- `commander`: CLI framework
+- `inquirer`: Interactive command line prompts
+- `chalk`: Terminal string styling
+- `zod`: Schema validation
+
 ## License
 
 MIT
@@ -78,4 +249,12 @@ MIT
 
 - [GitHub Repository](https://github.com/magic-ingredients/tiny-brain)
 - [Core Package](https://www.npmjs.com/package/@magic-ingredients/tiny-brain-core)
-- [Documentation](https://github.com/magic-ingredients/tiny-brain#readme)
+- [NPM Package](https://www.npmjs.com/package/@magic-ingredients/tiny-brain-local)
+- [DXT Registry](https://dxt.modelcontextprotocol.io/server/tiny-brain)
+- [Documentation](https://github.com/magic-ingredients/tiny-brain#readme)
+
+## Support
+
+For issues, questions, or contributions:
+- [GitHub Issues](https://github.com/magic-ingredients/tiny-brain/issues)
+- [Discussions](https://github.com/magic-ingredients/tiny-brain/discussions)

package/dist/cli/cli-factory.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCLI(): Command;
+//# sourceMappingURL=cli-factory.d.ts.map

package/dist/cli/cli-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-factory.d.ts","sourceRoot":"","sources":["../../src/cli/cli-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,SAAS,IAAI,OAAO,CAyGnC"}

package/dist/cli/cli-factory.js

@@ -0,0 +1,113 @@
+import { Command } from 'commander';
+import { InstallCommand } from './commands/install.command.js';
+import { UninstallCommand } from './commands/uninstall.command.js';
+import { StatusCommand } from './commands/status.command.js';
+import { ListCommand } from './commands/list.command.js';
+import { InstallerFactory } from './installers/installer-factory.js';
+import { PlatformConfigAdapter } from '../storage/platform-config-adapter.js';
+import { NodeResolver } from './utils/node-resolver.js';
+import * as os from 'os';
+import * as path from 'path';
+export function createCLI() {
+    const program = new Command();
+    // Initialize dependencies
+    const baseDir = path.join(os.homedir(), '.tiny-brain');
+    const configAdapter = new PlatformConfigAdapter({ baseDir, autoCreate: true });
+    const nodeResolver = new NodeResolver();
+    const installerFactory = new InstallerFactory(configAdapter, nodeResolver);
+    // Initialize commands
+    const installCommand = new InstallCommand(installerFactory);
+    const uninstallCommand = new UninstallCommand(installerFactory);
+    const statusCommand = new StatusCommand(installerFactory);
+    const listCommand = new ListCommand(installerFactory);
+    program
+        .name('tiny-brain')
+        .description('🧠 Tiny Brain MCP Server - Installation and Management CLI');
+    // Install command
+    program
+        .command('install [platform]')
+        .description('Install tiny-brain MCP server for an AI platform')
+        .option('--all', 'Install for all supported platforms')
+        .option('-s, --scope <scope>', 'Configuration scope (local/user/project)', 'local')
+        .option('-n, --name <name>', 'Server name', 'tiny-brain')
+        .option('--validate', 'Validate server startup during installation')
+        .action(async (platform, options) => {
+        try {
+            await installCommand.execute({
+                platform,
+                all: options.all,
+                scope: options.scope,
+                name: options.name,
+                validate: options.validate
+            });
+        }
+        catch (error) {
+            console.error('Installation failed:', error);
+            process.exit(1);
+        }
+    });
+    // Uninstall command
+    program
+        .command('uninstall [platform]')
+        .description('Uninstall tiny-brain MCP server from an AI platform')
+        .option('--all', 'Uninstall from all installed platforms')
+        .option('-s, --scope <scope>', 'Configuration scope (local/user/project)', 'local')
+        .option('-n, --name <name>', 'Server name', 'tiny-brain')
+        .option('-f, --force', 'Skip confirmation prompt')
+        .action(async (platform, options) => {
+        try {
+            await uninstallCommand.execute({
+                platform,
+                all: options.all,
+                scope: options.scope,
+                name: options.name,
+                force: options.force
+            });
+        }
+        catch (error) {
+            console.error('Uninstallation failed:', error);
+            process.exit(1);
+        }
+    });
+    // Status command
+    program
+        .command('status')
+        .description('Check installation status for all platforms')
+        .option('-n, --name <name>', 'Server name', 'tiny-brain')
+        .option('-s, --scope <scope>', 'Configuration scope (local/user/project)', 'local')
+        .option('-p, --platform <platform>', 'Check specific platform')
+        .option('-v, --verbose', 'Show detailed information')
+        .action(async (options) => {
+        try {
+            await statusCommand.execute({
+                name: options.name,
+                scope: options.scope,
+                platform: options.platform,
+                verbose: options.verbose
+            });
+        }
+        catch (error) {
+            console.error('Status check failed:', error);
+            process.exit(1);
+        }
+    });
+    // List command
+    program
+        .command('list')
+        .alias('ls')
+        .description('List all supported platforms')
+        .option('-d, --detected', 'Show which platforms are detected on the system')
+        .action(async (options) => {
+        try {
+            await listCommand.execute({
+                showDetected: options.detected
+            });
+        }
+        catch (error) {
+            console.error('List command failed:', error);
+            process.exit(1);
+        }
+    });
+    return program;
+}
+//# sourceMappingURL=cli-factory.js.map

package/dist/cli/cli-factory.js.map

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

package/dist/cli/commands/install.command.d.ts

@@ -0,0 +1,23 @@
+import { InstallerFactory } from '../installers/installer-factory.js';
+import { ConfigScope } from '../../storage/platform-path-builder.js';
+interface InstallOptions {
+    platform?: string;
+    all?: boolean;
+    scope?: ConfigScope;
+    name?: string;
+    validate?: boolean;
+    env?: Record<string, string>;
+}
+export declare class InstallCommand {
+    private factory;
+    constructor(factory: InstallerFactory);
+    execute(options?: InstallOptions): Promise<void>;
+    private findServerPath;
+    private determinePlatforms;
+    private promptForPlatforms;
+    private getPlatformDisplayName;
+    private installPlatforms;
+    private showSummary;
+}
+export {};
+//# sourceMappingURL=install.command.d.ts.map

package/dist/cli/commands/install.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAErE,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAQD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAI/B,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YA4B5C,cAAc;YAQd,kBAAkB;YAelB,kBAAkB;IAuChC,OAAO,CAAC,sBAAsB;YAWhB,gBAAgB;IAgF9B,OAAO,CAAC,WAAW;CA6BpB"}

package/dist/cli/commands/install.command.js

@@ -0,0 +1,189 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { PackageLocator } from '../utils/package-locator.js';
+export class InstallCommand {
+    factory;
+    constructor(factory) {
+        this.factory = factory;
+    }
+    async execute(options = {}) {
+        console.log(chalk.cyan.bold('\n🚀 tiny-brain MCP Server Installer\n'));
+        // Find the package installation path
+        const serverPath = await this.findServerPath();
+        if (!serverPath) {
+            console.error(chalk.red('❌ Could not find tiny-brain installation'));
+            return;
+        }
+        console.log(chalk.gray(`📦 Found tiny-brain at: ${serverPath}`));
+        // Determine which platforms to install
+        const platforms = await this.determinePlatforms(options);
+        if (platforms.length === 0) {
+            console.log(chalk.yellow('⚠️  No platforms selected for installation'));
+            return;
+        }
+        // Install for each selected platform
+        console.log(chalk.cyan(`\n✨ Installing for ${platforms.length} platform(s)...\n`));
+        const results = await this.installPlatforms(platforms, serverPath, options);
+        // Show summary
+        this.showSummary(results);
+    }
+    async findServerPath() {
+        try {
+            return await PackageLocator.findPackage();
+        }
+        catch {
+            return null;
+        }
+    }
+    async determinePlatforms(options) {
+        // If specific platform provided
+        if (options.platform) {
+            return [options.platform];
+        }
+        // If --all flag is set
+        if (options.all) {
+            return this.factory.getSupportedPlatforms();
+        }
+        // Interactive mode
+        return await this.promptForPlatforms();
+    }
+    async promptForPlatforms() {
+        const supportedPlatforms = this.factory.getSupportedPlatforms();
+        const choices = [
+            {
+                name: chalk.bold('📦 Install All'),
+                value: 'all',
+                checked: false
+            },
+            ...supportedPlatforms.map(platform => ({
+                name: this.getPlatformDisplayName(platform),
+                value: platform,
+                checked: false
+            }))
+        ];
+        const { platforms } = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'platforms',
+                message: '🎯 Select platforms to install tiny-brain on:',
+                choices,
+                validate: (answer) => {
+                    if (answer.length === 0) {
+                        return 'You must select at least one platform';
+                    }
+                    return true;
+                }
+            }
+        ]);
+        // Handle "Install All" selection
+        if (platforms.includes('all')) {
+            return supportedPlatforms;
+        }
+        return platforms;
+    }
+    getPlatformDisplayName(platform) {
+        const displayNames = {
+            'claude-code': '🤖 Claude Code',
+            'claude-desktop': '💻 Claude Desktop',
+            'cursor': '⚡ Cursor IDE',
+            'chatgpt': '🧠 ChatGPT Desktop'
+        };
+        return displayNames[platform] || platform;
+    }
+    async installPlatforms(platforms, serverPath, options) {
+        const results = new Map();
+        for (const platform of platforms) {
+            console.log(chalk.cyan.bold(`\n🚀 Installing Tiny Brain for ${platform}...`));
+            try {
+                const installer = this.factory.getInstaller(platform);
+                // Detect and display runtime information
+                console.log(chalk.gray(`🔍 Detecting runtime environment...`));
+                // Access the node resolver through the installer
+                const nodeResolver = installer.nodeResolver;
+                if (nodeResolver) {
+                    try {
+                        const nodeRuntime = await nodeResolver.findNodeRuntime(platform);
+                        if (nodeRuntime) {
+                            const runtimeType = nodeRuntime.bundled
+                                ? `${platform} bundled runtime`
+                                : 'system Node.js';
+                            console.log(chalk.cyan(`   📦 Detected runtime: ${runtimeType}`));
+                            console.log(chalk.cyan(`   📦 Node version: ${nodeRuntime.version}`));
+                            console.log(chalk.gray(`   📍 Path: ${nodeRuntime.command}`));
+                        }
+                        else {
+                            console.log(chalk.yellow(`   ⚠️  No Node.js runtime detected, using system default`));
+                        }
+                    }
+                    catch {
+                        console.log(chalk.yellow(`   ⚠️  Could not detect Node.js runtime, using system default`));
+                    }
+                }
+                console.log(chalk.gray(`📝 Configuring ${this.getPlatformDisplayName(platform)}...`));
+                await installer.install(serverPath, {
+                    scope: options.scope || 'local',
+                    name: options.name || 'tiny-brain',
+                    validateServer: options.validate,
+                    env: options.env
+                });
+                // Verify installation
+                console.log(chalk.gray(`🔍 Verifying installation...`));
+                const verified = await installer.verify(options.name || 'tiny-brain', { scope: options.scope || 'local' });
+                if (verified) {
+                    console.log(chalk.green.bold(`✅ Successfully installed tiny-brain for ${this.getPlatformDisplayName(platform)}`));
+                    if (platform === 'claude-code') {
+                        console.log(chalk.gray(`   💡 Use "claude mcp refresh" to reload or restart Claude Code`));
+                    }
+                    else if (platform === 'claude-desktop') {
+                        console.log(chalk.gray(`   💡 Restart Claude Desktop for changes to take effect`));
+                    }
+                    else if (platform === 'cursor') {
+                        console.log(chalk.gray(`   💡 Restart Cursor IDE for changes to take effect`));
+                    }
+                    results.set(platform, { success: true });
+                }
+                else {
+                    console.log(chalk.yellow(`⚠️  Installed but verification failed for ${this.getPlatformDisplayName(platform)}`));
+                    console.log(chalk.gray(`   💡 Try restarting the application and check the configuration`));
+                    results.set(platform, { success: false, error: 'Verification failed' });
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                console.error(chalk.red(`❌ Installation failed for ${this.getPlatformDisplayName(platform)}: ${errorMessage}`));
+                results.set(platform, { success: false, error: errorMessage });
+            }
+            console.log(); // Empty line between platforms
+        }
+        return results;
+    }
+    showSummary(results) {
+        console.log(chalk.cyan.bold('📊 Installation Summary:\n'));
+        let successCount = 0;
+        let failureCount = 0;
+        for (const [platform, result] of results) {
+            if (result.success) {
+                console.log(chalk.green(`   ✅ ${this.getPlatformDisplayName(platform)}`));
+                successCount++;
+            }
+            else {
+                console.log(chalk.red(`   ❌ ${this.getPlatformDisplayName(platform)} - ${result.error}`));
+                failureCount++;
+            }
+        }
+        console.log();
+        if (failureCount === 0) {
+            console.log(chalk.green.bold(`🎉 All installations completed successfully!`));
+            console.log(chalk.gray(`\n💡 Restart your AI platforms for changes to take effect.`));
+        }
+        else if (successCount > 0) {
+            console.log(chalk.yellow(`⚠️  ${successCount} succeeded, ${failureCount} failed`));
+            console.log(chalk.gray(`\n💡 Check the errors above and try again for failed platforms.`));
+        }
+        else {
+            console.log(chalk.red(`❌ All installations failed`));
+            console.log(chalk.gray(`\n💡 Please check the errors above and ensure Node.js is installed.`));
+        }
+    }
+}
+//# sourceMappingURL=install.command.js.map

package/dist/cli/commands/install.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.command.js","sourceRoot":"","sources":["../../../src/cli/commands/install.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAkB7D,MAAM,OAAO,cAAc;IACjB,OAAO,CAAmB;IAElC,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAA0B,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAEvE,qCAAqC;QACrC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC,CAAC;QAEjE,uCAAuC;QACvC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,qCAAqC;QACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,SAAS,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;QAEnF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE5E,eAAe;QACf,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,OAAuB;QACtD,gCAAgC;QAChC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAC9C,CAAC;QAED,mBAAmB;QACnB,OAAO,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAEhE,MAAM,OAAO,GAAqB;YAChC;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;gBAClC,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,KAAK;aACf;YACD,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;gBAC3C,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YAC1C;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,+CAA+C;gBACxD,OAAO;gBACP,QAAQ,EAAE,CAAC,MAAgB,EAAE,EAAE;oBAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACxB,OAAO,uCAAuC,CAAC;oBACjD,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF;SACF,CAAC,CAAC;QAEH,iCAAiC;QACjC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,sBAAsB,CAAC,QAAgB;QAC7C,MAAM,YAAY,GAA2B;YAC3C,aAAa,EAAE,gBAAgB;YAC/B,gBAAgB,EAAE,mBAAmB;YACrC,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,oBAAoB;SAChC,CAAC;QAEF,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,SAAmB,EACnB,UAAkB,EAClB,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgD,CAAC;QAExE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,QAAQ,KAAK,CAAC,CAAC,CAAC;YAE9E,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBAEtD,yCAAyC;gBACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;gBAE/D,iDAAiD;gBACjD,MAAM,YAAY,GAAI,SAAiB,CAAC,YAAY,CAAC;gBACrD,IAAI,YAAY,EAAE,CAAC;oBACjB,IAAI,CAAC;wBACH,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;wBAEjE,IAAI,WAAW,EAAE,CAAC;4BAChB,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO;gCACrC,CAAC,CAAC,GAAG,QAAQ,kBAAkB;gCAC/B,CAAC,CAAC,gBAAgB,CAAC;4BACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC,CAAC;4BAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;4BACtE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;wBAChE,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC,CAAC;wBACxF,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+DAA+D,CAAC,CAAC,CAAC;oBAC7F,CAAC;gBACH,CAAC;gBAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEtF,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE;oBAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;oBAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;oBAClC,cAAc,EAAE,OAAO,CAAC,QAAQ;oBAChC,GAAG,EAAE,OAAO,CAAC,GAAG;iBACjB,CAAC,CAAC;gBAEH,sBAAsB;gBACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;gBACxD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CACrC,OAAO,CAAC,IAAI,IAAI,YAAY,EAC5B,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CACpC,CAAC;gBAEF,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,2CAA2C,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;oBAClH,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;wBAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC,CAAC;oBAC7F,CAAC;yBAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;wBACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC,CAAC;oBACrF,CAAC;yBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC;oBACjF,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3C,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6CAA6C,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;oBAChH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;oBAC5F,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC,CAAC;gBAChH,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,+BAA+B;QAChD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,WAAW,CAAC,OAA0D;QAC5E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAE3D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1E,YAAY,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1F,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC,CAAC;QACxF,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,YAAY,eAAe,YAAY,SAAS,CAAC,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;CACF"}

package/dist/cli/commands/list.command.d.ts

@@ -0,0 +1,15 @@
+import { InstallerFactory } from '../installers/installer-factory.js';
+interface ListOptions {
+    showDetected?: boolean;
+}
+export declare class ListCommand {
+    private factory;
+    constructor(factory: InstallerFactory);
+    execute(options?: ListOptions): Promise<void>;
+    private getPlatformInfo;
+    private getDetectedPlatforms;
+    private getPlatformDetails;
+    private displayPlatforms;
+}
+export {};
+//# sourceMappingURL=list.command.d.ts.map

package/dist/cli/commands/list.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,UAAU,WAAW;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAUD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAI/B,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgBzC,eAAe;YAef,oBAAoB;IASlC,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,gBAAgB;CAkBzB"}