specweave 0.3.13 → 0.4.1

package/dist/core/plugin-manager.js

@@ -0,0 +1,393 @@
+/**
+ * Plugin Manager
+ *
+ * Central orchestrator for plugin lifecycle management.
+ * Handles loading/unloading, dependency resolution, configuration management.
+ *
+ * @module core/plugin-manager
+ * @version 0.4.0
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import * as yaml from 'js-yaml';
+import { PluginLoader } from './plugin-loader.js';
+import { PluginError, PluginDependencyError, PluginNotFoundError } from './types/plugin.js';
+/**
+ * PluginManager - Manages plugin lifecycle and configuration
+ */
+export class PluginManager {
+    /**
+     * Create a new PluginManager
+     *
+     * @param projectPath - Path to project root
+     * @param pluginsDir - Path to plugins directory (default: src/plugins)
+     */
+    constructor(projectPath = process.cwd(), pluginsDir) {
+        this.projectPath = projectPath;
+        this.loader = new PluginLoader();
+        this.configPath = path.join(projectPath, '.specweave', 'config.yaml');
+        this.pluginsDir = pluginsDir || path.join(projectPath, 'src', 'plugins');
+        this.loadedPlugins = new Map();
+    }
+    /**
+     * Load (enable) a plugin
+     *
+     * 1. Load plugin from src/plugins/
+     * 2. Check dependencies
+     * 3. Install via adapter
+     * 4. Update config
+     *
+     * @param name - Plugin name (e.g., "github", "kubernetes")
+     * @param adapter - Adapter to use for installation
+     * @param options - Load options
+     */
+    async loadPlugin(name, adapter, options = {}) {
+        console.log(`\n📦 Loading plugin: ${name}...`);
+        // Check if already loaded
+        if (this.loadedPlugins.has(name) && !options.force) {
+            console.log(`ℹ️  Plugin ${name} already loaded`);
+            return;
+        }
+        // Load plugin from disk
+        const pluginPath = path.join(this.pluginsDir, name);
+        const plugin = await this.loader.loadFromDirectory(pluginPath);
+        // Validate plugin integrity
+        if (options.validate !== false) {
+            const isValid = await this.loader.verifyPlugin(plugin);
+            if (!isValid) {
+                throw new PluginError(`Plugin ${name} failed integrity check`, name);
+            }
+        }
+        // Check dependencies
+        if (!options.skipDependencies) {
+            await this.checkDependencies(plugin);
+        }
+        // Install via adapter
+        console.log(`📋 Installing ${name} via ${adapter.name} adapter...`);
+        if (adapter.supportsPlugins && adapter.supportsPlugins()) {
+            await adapter.compilePlugin(plugin);
+        }
+        else {
+            console.warn(`⚠️  Adapter ${adapter.name} does not support plugins`);
+            throw new PluginError(`Adapter ${adapter.name} does not support plugins`, name, 'ADAPTER_NOT_SUPPORTED');
+        }
+        // Update config
+        await this.updateConfig(name, 'enable');
+        // Cache loaded plugin
+        this.loadedPlugins.set(name, plugin);
+        console.log(`✅ Plugin ${name} loaded successfully!`);
+        console.log(`   - ${plugin.skills.length} skills`);
+        console.log(`   - ${plugin.agents.length} agents`);
+        console.log(`   - ${plugin.commands.length} commands`);
+    }
+    /**
+     * Unload (disable) a plugin
+     *
+     * @param name - Plugin name
+     * @param adapter - Adapter to use for uninstallation
+     * @param options - Unload options
+     */
+    async unloadPlugin(name, adapter, options = {}) {
+        console.log(`\n🗑️  Unloading plugin: ${name}...`);
+        // Check if plugin is loaded
+        if (!this.loadedPlugins.has(name)) {
+            console.log(`ℹ️  Plugin ${name} not loaded`);
+            return;
+        }
+        // Check if other plugins depend on this one
+        if (!options.force) {
+            const dependents = await this.getDependents(name);
+            if (dependents.length > 0) {
+                throw new PluginDependencyError(`Cannot unload ${name}: Required by ${dependents.join(', ')}`, name);
+            }
+        }
+        // Uninstall via adapter
+        if (adapter.supportsPlugins && adapter.supportsPlugins()) {
+            await adapter.unloadPlugin(name);
+        }
+        // Update config
+        await this.updateConfig(name, 'disable');
+        // Remove from cache
+        this.loadedPlugins.delete(name);
+        console.log(`✅ Plugin ${name} unloaded`);
+    }
+    /**
+     * Get all available plugins (scan src/plugins/)
+     *
+     * @returns Array of plugin info
+     */
+    async getAvailablePlugins() {
+        const plugins = [];
+        // Check if plugins directory exists
+        if (!(await fs.pathExists(this.pluginsDir))) {
+            return plugins;
+        }
+        // Get enabled plugins from config
+        const enabledPlugins = await this.getEnabledPlugins();
+        // Scan plugins directory
+        const dirs = await fs.readdir(this.pluginsDir);
+        for (const dir of dirs) {
+            const pluginPath = path.join(this.pluginsDir, dir);
+            const stat = await fs.stat(pluginPath);
+            if (stat.isDirectory()) {
+                try {
+                    const metadata = await this.loader.getMetadata(pluginPath);
+                    plugins.push({
+                        name: dir,
+                        version: metadata.version,
+                        description: metadata.description,
+                        path: pluginPath,
+                        enabled: enabledPlugins.includes(dir),
+                        skillCount: metadata.skillCount,
+                        agentCount: metadata.agentCount,
+                        commandCount: metadata.commandCount
+                    });
+                }
+                catch (error) {
+                    console.warn(`⚠️  Failed to load metadata for ${dir}: ${error.message}`);
+                }
+            }
+        }
+        return plugins;
+    }
+    /**
+     * Get enabled plugins from config
+     *
+     * @returns Array of enabled plugin names
+     */
+    async getEnabledPlugins() {
+        const config = await this.loadConfig();
+        return config.enabled || [];
+    }
+    /**
+     * Check if a plugin is enabled
+     *
+     * @param name - Plugin name
+     * @returns True if enabled
+     */
+    async isPluginEnabled(name) {
+        const enabled = await this.getEnabledPlugins();
+        return enabled.includes(name);
+    }
+    /**
+     * Update plugin configuration
+     *
+     * @param name - Plugin name
+     * @param action - 'enable' or 'disable'
+     */
+    async updateConfig(name, action) {
+        const config = await this.loadConfig();
+        if (action === 'enable') {
+            if (!config.enabled.includes(name)) {
+                config.enabled.push(name);
+            }
+        }
+        else {
+            config.enabled = config.enabled.filter(p => p !== name);
+        }
+        await this.saveConfig(config);
+    }
+    /**
+     * Load plugin configuration from .specweave/config.yaml
+     *
+     * @returns Plugin configuration
+     */
+    async loadConfig() {
+        // Ensure config directory exists
+        const configDir = path.dirname(this.configPath);
+        await fs.ensureDir(configDir);
+        // Check if config file exists
+        if (!(await fs.pathExists(this.configPath))) {
+            // Create default config
+            const defaultConfig = {
+                enabled: [],
+                settings: {}
+            };
+            await this.saveConfig(defaultConfig);
+            return defaultConfig;
+        }
+        // Read and parse config
+        const content = await fs.readFile(this.configPath, 'utf-8');
+        const config = yaml.load(content);
+        // Ensure plugins section exists
+        if (!config.plugins) {
+            config.plugins = { enabled: [], settings: {} };
+        }
+        return config.plugins;
+    }
+    /**
+     * Save plugin configuration to .specweave/config.yaml
+     *
+     * @param pluginConfig - Plugin configuration to save
+     */
+    async saveConfig(pluginConfig) {
+        // Read full config (if exists)
+        let fullConfig = {};
+        if (await fs.pathExists(this.configPath)) {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            fullConfig = yaml.load(content) || {};
+        }
+        // Update plugins section
+        fullConfig.plugins = pluginConfig;
+        // Write back
+        const yamlContent = yaml.dump(fullConfig, { indent: 2 });
+        await fs.writeFile(this.configPath, yamlContent, 'utf-8');
+    }
+    /**
+     * Check plugin dependencies
+     *
+     * Ensures all required plugins are loaded
+     *
+     * @param plugin - Plugin to check
+     * @throws PluginDependencyError if dependencies are not met
+     */
+    async checkDependencies(plugin) {
+        const { dependencies } = plugin.manifest;
+        if (!dependencies || !dependencies.plugins) {
+            return; // No dependencies
+        }
+        const enabledPlugins = await this.getEnabledPlugins();
+        const missingDeps = [];
+        for (const depName of dependencies.plugins) {
+            if (!enabledPlugins.includes(depName)) {
+                missingDeps.push(depName);
+            }
+        }
+        if (missingDeps.length > 0) {
+            throw new PluginDependencyError(`Plugin ${plugin.manifest.name} requires: ${missingDeps.join(', ')}`, plugin.manifest.name);
+        }
+    }
+    /**
+     * Resolve dependency graph for a plugin
+     *
+     * Returns all plugins that need to be loaded (including transitive deps)
+     *
+     * @param plugin - Plugin to resolve
+     * @returns Array of plugins in load order
+     */
+    async resolveDependencies(plugin) {
+        const resolved = [];
+        const visited = new Set();
+        const resolve = async (p) => {
+            if (visited.has(p.manifest.name)) {
+                return; // Already processed
+            }
+            visited.add(p.manifest.name);
+            // Resolve dependencies first
+            if (p.manifest.dependencies?.plugins) {
+                for (const depName of p.manifest.dependencies.plugins) {
+                    const depPath = path.join(this.pluginsDir, depName);
+                    const depPlugin = await this.loader.loadFromDirectory(depPath);
+                    await resolve(depPlugin);
+                }
+            }
+            // Add this plugin
+            resolved.push(p);
+        };
+        await resolve(plugin);
+        return resolved;
+    }
+    /**
+     * Get plugins that depend on a given plugin
+     *
+     * @param name - Plugin name
+     * @returns Array of dependent plugin names
+     */
+    async getDependents(name) {
+        const dependents = [];
+        const availablePlugins = await this.getAvailablePlugins();
+        for (const info of availablePlugins) {
+            if (info.enabled) {
+                const plugin = await this.loader.loadFromDirectory(info.path);
+                if (plugin.manifest.dependencies?.plugins?.includes(name)) {
+                    dependents.push(info.name);
+                }
+            }
+        }
+        return dependents;
+    }
+    /**
+     * Validate plugin configuration
+     *
+     * Checks for circular dependencies, missing plugins, etc.
+     *
+     * @returns Validation result
+     */
+    async validateConfig() {
+        const errors = [];
+        const enabledPlugins = await this.getEnabledPlugins();
+        // Check if all enabled plugins exist
+        for (const name of enabledPlugins) {
+            const pluginPath = path.join(this.pluginsDir, name);
+            if (!(await fs.pathExists(pluginPath))) {
+                errors.push(`Enabled plugin '${name}' not found at ${pluginPath}`);
+            }
+        }
+        // Check for circular dependencies
+        const visited = new Set();
+        const recursionStack = new Set();
+        const hasCycle = async (name) => {
+            visited.add(name);
+            recursionStack.add(name);
+            const pluginPath = path.join(this.pluginsDir, name);
+            if (!(await fs.pathExists(pluginPath))) {
+                return false;
+            }
+            const plugin = await this.loader.loadFromDirectory(pluginPath);
+            const deps = plugin.manifest.dependencies?.plugins || [];
+            for (const dep of deps) {
+                if (!visited.has(dep)) {
+                    if (await hasCycle(dep)) {
+                        return true;
+                    }
+                }
+                else if (recursionStack.has(dep)) {
+                    errors.push(`Circular dependency detected: ${name} → ${dep}`);
+                    return true;
+                }
+            }
+            recursionStack.delete(name);
+            return false;
+        };
+        for (const name of enabledPlugins) {
+            if (!visited.has(name)) {
+                await hasCycle(name);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Get plugin by name
+     *
+     * @param name - Plugin name
+     * @returns Loaded plugin
+     * @throws PluginNotFoundError if plugin is not loaded
+     */
+    getPlugin(name) {
+        const plugin = this.loadedPlugins.get(name);
+        if (!plugin) {
+            throw new PluginNotFoundError(name);
+        }
+        return plugin;
+    }
+    /**
+     * Get all loaded plugins
+     *
+     * @returns Map of loaded plugins
+     */
+    getLoadedPlugins() {
+        return this.loadedPlugins;
+    }
+    /**
+     * Clear loaded plugins cache
+     *
+     * Useful for testing or forcing reload
+     */
+    clearCache() {
+        this.loadedPlugins.clear();
+    }
+}
+//# sourceMappingURL=plugin-manager.js.map

package/dist/core/plugin-manager.js.map

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

package/dist/core/schemas/plugin-manifest.schema.json

@@ -0,0 +1,253 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://spec-weave.com/schemas/plugin-manifest.json",
+    "title": "SpecWeave Plugin Manifest",
+    "description": "Schema for SpecWeave plugin manifest.json files",
+    "type": "object",
+    "required": ["name", "version", "description", "specweave_core_version", "provides"],
+    "properties": {
+        "name": {
+            "type": "string",
+            "pattern": "^specweave-[a-z0-9-]+$",
+            "minLength": 11,
+            "maxLength": 64,
+            "description": "Unique plugin name (must start with 'specweave-')",
+            "examples": ["specweave-kubernetes", "specweave-github", "specweave-ml-ops"]
+        },
+        "version": {
+            "type": "string",
+            "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-z0-9.-]+)?(\\+[a-z0-9.-]+)?$",
+            "description": "Semantic version (e.g., '1.0.0', '2.1.3-beta.1')",
+            "examples": ["1.0.0", "2.1.3-beta.1", "0.4.0"]
+        },
+        "description": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 1024,
+            "description": "Human-readable description of what this plugin does"
+        },
+        "author": {
+            "type": "string",
+            "maxLength": 256,
+            "description": "Plugin author name or organization"
+        },
+        "license": {
+            "type": "string",
+            "enum": ["MIT", "Apache-2.0", "BSD-3-Clause", "ISC", "GPL-3.0", "LGPL-3.0", "MPL-2.0", "Unlicense"],
+            "description": "SPDX license identifier"
+        },
+        "specweave_core_version": {
+            "type": "string",
+            "pattern": "^[><=~^]+\\d+\\.\\d+\\.\\d+$",
+            "description": "Required SpecWeave core version (e.g., '>=0.4.0', '~0.4.0', '^0.4.0')",
+            "examples": [">=0.4.0", "~0.4.0", "^0.4.0"]
+        },
+        "dependencies": {
+            "type": "object",
+            "properties": {
+                "plugins": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "^specweave-[a-z0-9-]+$"
+                    },
+                    "uniqueItems": true,
+                    "description": "Other plugins this plugin requires"
+                }
+            },
+            "additionalProperties": false
+        },
+        "auto_detect": {
+            "type": "object",
+            "properties": {
+                "files": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "minLength": 1
+                    },
+                    "uniqueItems": true,
+                    "description": "File or directory patterns to detect (e.g., 'kubernetes/', '.git/')"
+                },
+                "packages": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "minLength": 1
+                    },
+                    "uniqueItems": true,
+                    "description": "NPM package dependencies to detect (from package.json)"
+                },
+                "env_vars": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]*$"
+                    },
+                    "uniqueItems": true,
+                    "description": "Environment variables to detect"
+                },
+                "git_remote_pattern": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Regex pattern to match against git remote URL (e.g., 'github\\.com')"
+                }
+            },
+            "additionalProperties": false
+        },
+        "provides": {
+            "type": "object",
+            "required": ["skills", "agents", "commands"],
+            "properties": {
+                "skills": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "^[a-z0-9-]+$",
+                        "minLength": 1
+                    },
+                    "uniqueItems": true,
+                    "description": "Skill names provided by this plugin"
+                },
+                "agents": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "^[a-z0-9-]+$",
+                        "minLength": 1
+                    },
+                    "uniqueItems": true,
+                    "description": "Agent names provided by this plugin"
+                },
+                "commands": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "^specweave\\.[a-z0-9-.]+$",
+                        "minLength": 11
+                    },
+                    "uniqueItems": true,
+                    "description": "Command names provided by this plugin (must start with 'specweave.')"
+                }
+            },
+            "additionalProperties": false
+        },
+        "triggers": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "minLength": 2
+            },
+            "uniqueItems": true,
+            "description": "Keywords that trigger plugin suggestions in specs/tasks"
+        },
+        "credits": {
+            "type": "object",
+            "properties": {
+                "based_on": {
+                    "type": ["string", "null"],
+                    "format": "uri",
+                    "description": "Upstream source URL if forked from another project"
+                },
+                "original_author": {
+                    "type": "string",
+                    "maxLength": 256,
+                    "description": "Original author name if forked"
+                },
+                "contributors": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "maxLength": 256
+                    },
+                    "uniqueItems": true,
+                    "description": "List of contributors to this plugin"
+                },
+                "modifications": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "maxLength": 512
+                    },
+                    "description": "List of modifications made for SpecWeave integration"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "additionalProperties": false,
+    "examples": [
+        {
+            "name": "specweave-github",
+            "version": "1.0.0",
+            "description": "GitHub issues integration for SpecWeave increments",
+            "author": "SpecWeave Team",
+            "license": "MIT",
+            "specweave_core_version": ">=0.4.0",
+            "auto_detect": {
+                "files": [".git/"],
+                "env_vars": ["GITHUB_TOKEN"],
+                "git_remote_pattern": "github\\.com"
+            },
+            "provides": {
+                "skills": ["github-sync", "github-issue-tracker"],
+                "agents": ["github-manager"],
+                "commands": [
+                    "specweave.github.create-issue",
+                    "specweave.github.sync",
+                    "specweave.github.close-issue"
+                ]
+            },
+            "triggers": ["github", "issue", "gh", "pull request", "PR"]
+        },
+        {
+            "name": "specweave-kubernetes",
+            "version": "1.0.0",
+            "description": "Kubernetes deployment and management for SpecWeave projects",
+            "author": "SpecWeave Team",
+            "license": "MIT",
+            "specweave_core_version": ">=0.4.0",
+            "dependencies": {
+                "plugins": ["specweave-cloud-infrastructure"]
+            },
+            "auto_detect": {
+                "files": ["kubernetes/", "k8s/", "helm/"],
+                "packages": ["@kubernetes/client-node"],
+                "env_vars": ["KUBECONFIG"]
+            },
+            "provides": {
+                "skills": ["k8s-deployer", "helm-manager", "k8s-troubleshooter"],
+                "agents": ["devops"],
+                "commands": ["specweave.k8s.deploy", "specweave.k8s.status"]
+            },
+            "triggers": ["kubernetes", "k8s", "kubectl", "helm", "pod", "deployment", "service"]
+        },
+        {
+            "name": "specweave-observability",
+            "version": "1.0.0",
+            "description": "Observability & monitoring for SpecWeave projects (Prometheus, Grafana)",
+            "author": "SpecWeave Team",
+            "license": "MIT",
+            "specweave_core_version": ">=0.4.0",
+            "auto_detect": {
+                "files": ["prometheus/", "grafana/"],
+                "packages": ["prom-client", "@grafana/faro-web-sdk"]
+            },
+            "provides": {
+                "skills": ["monitoring-setup", "metrics-collector", "alerting-config", "dashboard-generator"],
+                "agents": ["sre"],
+                "commands": ["specweave.observe.metrics", "specweave.observe.alerts"]
+            },
+            "triggers": ["monitoring", "prometheus", "grafana", "metrics", "observability", "alerting"],
+            "credits": {
+                "based_on": "https://github.com/wshobson/agents/tree/main/plugins/observability-monitoring",
+                "original_author": "Seth Hobson",
+                "modifications": [
+                    "Adapted for SpecWeave increment lifecycle",
+                    "Added /sync-docs integration",
+                    "SpecWeave naming conventions"
+                ]
+            }
+        }
+    ]
+}