@claude-flow/cli 3.32.1 → 3.32.3

package/dist/src/plugins/manager.js

@@ -1,415 +0,0 @@
-/**
- * Plugin Manager
- * Handles actual plugin installation, persistence, and lifecycle
- * Bridges discovery service with file system persistence
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { execFile } from 'child_process';
-import { promisify } from 'util';
-const execFileAsync = promisify(execFile);
-// On Windows, `npm` is a shell script (no `.exe`) and `npm.cmd` is a batch
-// wrapper. Since Node 18.20.2 / 20.12.2 (CVE-2024-27980) the runtime refuses
-// to spawn `.cmd`/`.bat` files directly and throws `spawn EINVAL` — the only
-// supported invocation is via a real `.exe` shell. We wrap every npm call
-// through `cmd.exe /d /s /c npm <args>`, which keeps Node's safe array-form
-// argument escaping intact and avoids both ENOENT and EINVAL.
-const isWindows = process.platform === 'win32';
-function runNpm(args, timeoutMs) {
-    if (isWindows) {
-        return execFileAsync('cmd.exe', ['/d', '/s', '/c', 'npm', ...args], { timeout: timeoutMs });
-    }
-    return execFileAsync('npm', args, { timeout: timeoutMs });
-}
-/**
- * Validate npm package name to prevent shell injection (S-3)
- */
-const VALID_PACKAGE_RE = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*(@[a-z0-9._\-^~>=<]+)?$/;
-function validatePackageName(spec) {
-    if (!VALID_PACKAGE_RE.test(spec)) {
-        throw new Error(`Invalid package name: ${spec}`);
-    }
-}
-// ============================================================================
-// Plugin Manager
-// ============================================================================
-/**
- * Manages plugin installation, persistence, and lifecycle.
- *
- * Unlike the simulated version, this actually:
- * - Persists plugins to disk
- * - Downloads from npm
- * - Tracks enabled/disabled state
- * - Loads plugin modules
- */
-export class PluginManager {
-    config;
-    manifest = null;
-    constructor(baseDir = process.cwd()) {
-        const pluginsDir = path.join(baseDir, '.claude-flow', 'plugins');
-        this.config = {
-            pluginsDir,
-            manifestPath: path.join(pluginsDir, 'installed.json'),
-        };
-    }
-    // =========================================================================
-    // Initialization
-    // =========================================================================
-    /**
-     * Initialize the plugin manager, creating directories and loading manifest
-     */
-    async initialize() {
-        // Ensure plugins directory exists
-        await this.ensureDirectory(this.config.pluginsDir);
-        // Load or create manifest
-        this.manifest = await this.loadManifest();
-    }
-    async ensureDirectory(dir) {
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
-    }
-    async loadManifest() {
-        try {
-            if (fs.existsSync(this.config.manifestPath)) {
-                const content = fs.readFileSync(this.config.manifestPath, 'utf-8');
-                return JSON.parse(content);
-            }
-        }
-        catch (error) {
-            console.warn('[PluginManager] Failed to load manifest, creating new one');
-        }
-        return {
-            version: '1.0.0',
-            lastUpdated: new Date().toISOString(),
-            plugins: {},
-        };
-    }
-    async saveManifest() {
-        if (!this.manifest)
-            return;
-        this.manifest.lastUpdated = new Date().toISOString();
-        await this.ensureDirectory(path.dirname(this.config.manifestPath));
-        fs.writeFileSync(this.config.manifestPath, JSON.stringify(this.manifest, null, 2), 'utf-8');
-    }
-    // =========================================================================
-    // Installation
-    // =========================================================================
-    /**
-     * Install a plugin from npm
-     */
-    async installFromNpm(packageName, version) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const versionSpec = version ? `${packageName}@${version}` : packageName;
-        try {
-            // Check if already installed
-            if (this.manifest.plugins[packageName]) {
-                return {
-                    success: false,
-                    error: `Plugin ${packageName} is already installed. Use upgrade to update.`,
-                };
-            }
-            // Install to local plugins directory
-            const installDir = path.join(this.config.pluginsDir, 'node_modules');
-            await this.ensureDirectory(installDir);
-            // Validate package name to prevent injection (S-3)
-            validatePackageName(versionSpec);
-            // Use npm to install (array form prevents shell injection)
-            console.log(`[PluginManager] Installing ${versionSpec}...`);
-            await runNpm(['install', '--prefix', this.config.pluginsDir, versionSpec], 120000);
-            // Get installed version
-            const packageJsonPath = path.join(installDir, packageName, 'package.json');
-            let installedVersion = version || 'latest';
-            let commands = [];
-            let hooks = [];
-            if (fs.existsSync(packageJsonPath)) {
-                const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-                installedVersion = pkg.version;
-                // Check for claude-flow plugin metadata
-                if (pkg['claude-flow']) {
-                    commands = pkg['claude-flow'].commands || [];
-                    hooks = pkg['claude-flow'].hooks || [];
-                }
-            }
-            // Create plugin entry
-            const plugin = {
-                name: packageName,
-                version: installedVersion,
-                installedAt: new Date().toISOString(),
-                enabled: true,
-                source: 'npm',
-                path: path.join(installDir, packageName),
-                commands,
-                hooks,
-            };
-            // Save to manifest
-            this.manifest.plugins[packageName] = plugin;
-            await this.saveManifest();
-            console.log(`[PluginManager] Installed ${packageName}@${installedVersion}`);
-            return { success: true, plugin };
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            console.error(`[PluginManager] Failed to install ${packageName}:`, errorMsg);
-            return { success: false, error: errorMsg };
-        }
-    }
-    /**
-     * Install a plugin from a local path
-     */
-    async installFromLocal(sourcePath) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        try {
-            const absolutePath = path.resolve(sourcePath);
-            if (!fs.existsSync(absolutePath)) {
-                return { success: false, error: `Path does not exist: ${absolutePath}` };
-            }
-            // Read package.json
-            const packageJsonPath = path.join(absolutePath, 'package.json');
-            if (!fs.existsSync(packageJsonPath)) {
-                return { success: false, error: 'No package.json found at path' };
-            }
-            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-            const packageName = pkg.name;
-            // Check if already installed
-            if (this.manifest.plugins[packageName]) {
-                return {
-                    success: false,
-                    error: `Plugin ${packageName} is already installed`,
-                };
-            }
-            // Create plugin entry (link to local path, don't copy)
-            const plugin = {
-                name: packageName,
-                version: pkg.version,
-                installedAt: new Date().toISOString(),
-                enabled: true,
-                source: 'local',
-                path: absolutePath,
-                commands: pkg['claude-flow']?.commands || [],
-                hooks: pkg['claude-flow']?.hooks || [],
-            };
-            // Save to manifest
-            this.manifest.plugins[packageName] = plugin;
-            await this.saveManifest();
-            console.log(`[PluginManager] Installed local plugin ${packageName}@${pkg.version}`);
-            return { success: true, plugin };
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            console.error(`[PluginManager] Failed to install from local:`, errorMsg);
-            return { success: false, error: errorMsg };
-        }
-    }
-    // =========================================================================
-    // Uninstallation
-    // =========================================================================
-    /**
-     * Uninstall a plugin
-     */
-    async uninstall(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const plugin = this.manifest.plugins[packageName];
-        if (!plugin) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        try {
-            // For npm-installed plugins, remove from node_modules
-            if (plugin.source === 'npm') {
-                validatePackageName(packageName);
-                await runNpm(['uninstall', '--prefix', this.config.pluginsDir, packageName], 60000);
-            }
-            // Remove from manifest
-            delete this.manifest.plugins[packageName];
-            await this.saveManifest();
-            console.log(`[PluginManager] Uninstalled ${packageName}`);
-            return { success: true };
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            console.error(`[PluginManager] Failed to uninstall ${packageName}:`, errorMsg);
-            return { success: false, error: errorMsg };
-        }
-    }
-    // =========================================================================
-    // Enable/Disable
-    // =========================================================================
-    /**
-     * Enable a plugin
-     */
-    async enable(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const plugin = this.manifest.plugins[packageName];
-        if (!plugin) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        // HIGH-04: Warn about unsandboxed plugin execution
-        console.warn(`[SECURITY] Plugin loaded without sandboxing: ${packageName}. Plugins run with full process access.`);
-        plugin.enabled = true;
-        await this.saveManifest();
-        return { success: true };
-    }
-    /**
-     * Disable a plugin
-     */
-    async disable(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const plugin = this.manifest.plugins[packageName];
-        if (!plugin) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        plugin.enabled = false;
-        await this.saveManifest();
-        return { success: true };
-    }
-    /**
-     * Toggle a plugin's enabled state
-     */
-    async toggle(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const plugin = this.manifest.plugins[packageName];
-        if (!plugin) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        plugin.enabled = !plugin.enabled;
-        await this.saveManifest();
-        return { success: true, enabled: plugin.enabled };
-    }
-    // =========================================================================
-    // Query
-    // =========================================================================
-    /**
-     * Get all installed plugins
-     */
-    async getInstalled() {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        return Object.values(this.manifest.plugins);
-    }
-    /**
-     * Get enabled plugins
-     */
-    async getEnabled() {
-        const all = await this.getInstalled();
-        return all.filter(p => p.enabled);
-    }
-    /**
-     * Check if a plugin is installed
-     */
-    async isInstalled(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        return packageName in this.manifest.plugins;
-    }
-    /**
-     * Get a specific installed plugin
-     */
-    async getPlugin(packageName) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        return this.manifest.plugins[packageName];
-    }
-    // =========================================================================
-    // Upgrade
-    // =========================================================================
-    /**
-     * Upgrade a plugin to a new version
-     */
-    async upgrade(packageName, version) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const existing = this.manifest.plugins[packageName];
-        if (!existing) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        if (existing.source !== 'npm') {
-            return { success: false, error: 'Can only upgrade npm-installed plugins' };
-        }
-        try {
-            const versionSpec = version ? `${packageName}@${version}` : `${packageName}@latest`;
-            // Validate package name to prevent injection (S-3)
-            validatePackageName(versionSpec);
-            // Reinstall with new version (array form prevents shell injection)
-            await runNpm(['install', '--prefix', this.config.pluginsDir, versionSpec], 120000);
-            // Update manifest
-            const installDir = path.join(this.config.pluginsDir, 'node_modules');
-            const packageJsonPath = path.join(installDir, packageName, 'package.json');
-            if (fs.existsSync(packageJsonPath)) {
-                const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-                existing.version = pkg.version;
-                existing.commands = pkg['claude-flow']?.commands || existing.commands;
-                existing.hooks = pkg['claude-flow']?.hooks || existing.hooks;
-            }
-            await this.saveManifest();
-            console.log(`[PluginManager] Upgraded ${packageName} to ${existing.version}`);
-            return { success: true, plugin: existing };
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            return { success: false, error: errorMsg };
-        }
-    }
-    // =========================================================================
-    // Config
-    // =========================================================================
-    /**
-     * Update plugin config
-     */
-    async setConfig(packageName, config) {
-        if (!this.manifest) {
-            await this.initialize();
-        }
-        const plugin = this.manifest.plugins[packageName];
-        if (!plugin) {
-            return { success: false, error: `Plugin ${packageName} is not installed` };
-        }
-        plugin.config = { ...plugin.config, ...config };
-        await this.saveManifest();
-        return { success: true };
-    }
-    /**
-     * Get plugins directory path
-     */
-    getPluginsDir() {
-        return this.config.pluginsDir;
-    }
-    /**
-     * Get manifest path
-     */
-    getManifestPath() {
-        return this.config.manifestPath;
-    }
-}
-// ============================================================================
-// Singleton Instance
-// ============================================================================
-let defaultManager = null;
-export function getPluginManager(baseDir) {
-    if (!defaultManager) {
-        defaultManager = new PluginManager(baseDir);
-    }
-    else if (baseDir && defaultManager.getPluginsDir() !== path.join(baseDir, '.claude-flow', 'plugins')) {
-        console.warn(`[PluginManager] Warning: getPluginManager called with different baseDir. Using existing instance. Call resetPluginManager() first to change.`);
-    }
-    return defaultManager;
-}
-export function resetPluginManager() {
-    defaultManager = null;
-}
-//# sourceMappingURL=manager.js.map

package/dist/src/plugins/store/discovery.d.ts

@@ -1,99 +0,0 @@
-/**
- * Plugin Discovery Service
- * Discovers plugin registries via IPNS and fetches from IPFS
- * Parallel implementation to pattern store for plugins
- */
-import type { PluginRegistry, KnownPluginRegistry, PluginStoreConfig } from './types.js';
-/**
- * Default plugin store configuration
- */
-/**
- * Live IPFS Registry CID - Updated 2026-05-11
- * This is the current pinned registry on Pinata.
- * 2026-05-11: bumped agentic-qe→3.0.0-alpha.5, gastown-bridge→0.1.4,
- * legal-contracts/healthcare-clinical/perf-optimizer→3.0.0-alpha.2
- * (republished to fix #1902/#1903/#1904 install breakage).
- */
-export declare const LIVE_REGISTRY_CID = "QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2";
-/**
- * Pre-trained Model Registry CID - Updated 2026-01-24
- * Contains 8 pre-trained learning pattern models with 40 patterns
- * Trained on 110,600+ examples with 90.5% average accuracy
- */
-export declare const MODEL_REGISTRY_CID = "QmNr1yYMKi7YBaL8JSztQyuB5ZUaTdRMLxJC1pBpGbjsTc";
-export declare const DEFAULT_PLUGIN_STORE_CONFIG: PluginStoreConfig;
-/**
- * Discovery result
- */
-export interface PluginDiscoveryResult {
-    success: boolean;
-    registry?: PluginRegistry;
-    cid?: string;
-    source?: string;
-    fromCache?: boolean;
-    error?: string;
-}
-/**
- * Plugin Discovery Service
- */
-export declare class PluginDiscoveryService {
-    private config;
-    private cache;
-    constructor(config?: Partial<PluginStoreConfig>);
-    /**
-     * Discover plugin registry via IPNS
-     */
-    discoverRegistry(registryName?: string): Promise<PluginDiscoveryResult>;
-    /**
-     * Create demo plugin registry with real npm stats
-     */
-    private createDemoRegistryAsync;
-    /**
-     * Get demo plugins
-     */
-    private getDemoPlugins;
-    /**
-     * Get demo plugins with real npm stats
-     */
-    private getDemoPluginsWithStats;
-    /**
-     * Verify registry Ed25519 signature.
-     *
-     * Mirrors the signing scheme in scripts/publish-registry.ts: the signer
-     * removes registrySignature + registryPublicKey from the registry object
-     * and signs JSON.stringify(rest). The verifier reproduces those bytes and
-     * checks the signature against the registry config's pre-pinned
-     * publicKey — NOT registry.registryPublicKey, which is asserted by
-     * whoever served the registry and can be swapped by a compromised
-     * gateway / on-path attacker.
-     */
-    private verifyRegistrySignature;
-    /**
-     * List available registries
-     */
-    listRegistries(): KnownPluginRegistry[];
-    /**
-     * Add a new registry
-     */
-    addRegistry(registry: KnownPluginRegistry): void;
-    /**
-     * Remove a registry
-     */
-    removeRegistry(name: string): boolean;
-    /**
-     * Clear cache
-     */
-    clearCache(): void;
-    /**
-     * Get cache statistics
-     */
-    getCacheStats(): {
-        entries: number;
-        registries: string[];
-    };
-}
-/**
- * Create discovery service with default config
- */
-export declare function createPluginDiscoveryService(config?: Partial<PluginStoreConfig>): PluginDiscoveryService;
-//# sourceMappingURL=discovery.d.ts.map