specweave 0.3.13 → 0.4.1

package/dist/core/plugin-loader.js

@@ -0,0 +1,319 @@
+/**
+ * Plugin Loader
+ *
+ * Reads plugin directories, validates manifests, and loads skills/agents/commands.
+ * Provides plugin discovery and integrity checking.
+ *
+ * @module core/plugin-loader
+ * @version 0.4.0
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import Ajv from 'ajv';
+import { ManifestValidationError, PluginNotFoundError } from './types/plugin.js';
+// Import JSON schema for validation
+import pluginManifestSchema from './schemas/plugin-manifest.schema.json';
+/**
+ * PluginLoader - Loads and validates plugins from filesystem
+ */
+export class PluginLoader {
+    constructor() {
+        // Initialize JSON schema validator
+        this.ajv = new Ajv({ allErrors: true });
+        this.validateManifestSchema = this.ajv.compile(pluginManifestSchema);
+    }
+    /**
+     * Load a plugin from directory
+     *
+     * @param pluginPath - Absolute path to plugin directory
+     * @returns Loaded plugin with all components
+     * @throws PluginNotFoundError if directory doesn't exist
+     * @throws ManifestValidationError if manifest is invalid
+     */
+    async loadFromDirectory(pluginPath) {
+        // Verify directory exists
+        if (!(await fs.pathExists(pluginPath))) {
+            throw new PluginNotFoundError(path.basename(pluginPath));
+        }
+        // Load and validate manifest
+        const manifest = await this.loadManifest(pluginPath);
+        // Load components
+        const [skills, agents, commands] = await Promise.all([
+            this.loadSkills(pluginPath, manifest.provides.skills),
+            this.loadAgents(pluginPath, manifest.provides.agents),
+            this.loadCommands(pluginPath, manifest.provides.commands)
+        ]);
+        return {
+            manifest,
+            path: pluginPath,
+            skills,
+            agents,
+            commands
+        };
+    }
+    /**
+     * Load plugin manifest from .claude-plugin/manifest.json
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Validated plugin manifest
+     * @throws ManifestValidationError if manifest is invalid
+     */
+    async loadManifest(pluginPath) {
+        const manifestPath = path.join(pluginPath, '.claude-plugin', 'manifest.json');
+        // Check if manifest exists
+        if (!(await fs.pathExists(manifestPath))) {
+            throw new ManifestValidationError(`Manifest not found at ${manifestPath}`, path.basename(pluginPath));
+        }
+        // Read and parse manifest
+        let content;
+        try {
+            content = await fs.readJSON(manifestPath);
+        }
+        catch (error) {
+            throw new ManifestValidationError(`Invalid JSON in manifest: ${error.message}`, path.basename(pluginPath));
+        }
+        // Validate against schema
+        const validation = this.validateManifest(content);
+        if (!validation.valid) {
+            throw new ManifestValidationError(`Manifest validation failed:\n${validation.errors.join('\n')}`, path.basename(pluginPath));
+        }
+        return content;
+    }
+    /**
+     * Validate manifest against JSON schema
+     *
+     * @param manifest - Manifest object to validate
+     * @returns Validation result with errors/warnings
+     */
+    validateManifest(manifest) {
+        const valid = this.validateManifestSchema(manifest);
+        const errors = [];
+        const warnings = [];
+        if (!valid && this.validateManifestSchema.errors) {
+            for (const error of this.validateManifestSchema.errors) {
+                errors.push(`${error.instancePath} ${error.message}`);
+            }
+        }
+        // Additional semantic validation
+        if (manifest.provides) {
+            // Warn if no skills, agents, or commands provided
+            if (manifest.provides.skills.length === 0 &&
+                manifest.provides.agents.length === 0 &&
+                manifest.provides.commands.length === 0) {
+                warnings.push('Plugin provides no skills, agents, or commands');
+            }
+        }
+        return { valid, errors, warnings };
+    }
+    /**
+     * Load skills from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param skillNames - Skill names from manifest
+     * @returns Array of loaded skills
+     */
+    async loadSkills(pluginPath, skillNames) {
+        const skills = [];
+        const skillsDir = path.join(pluginPath, 'skills');
+        for (const skillName of skillNames) {
+            const skillPath = path.join(skillsDir, skillName);
+            const skillMdPath = path.join(skillPath, 'SKILL.md');
+            if (await fs.pathExists(skillMdPath)) {
+                const content = await fs.readFile(skillMdPath, 'utf-8');
+                const description = this.extractDescription(content);
+                // Load test cases if they exist
+                const testCases = await this.loadTestCases(skillPath);
+                skills.push({
+                    name: skillName,
+                    path: skillPath,
+                    description,
+                    testCases
+                });
+            }
+            else {
+                console.warn(`Skill ${skillName} not found at ${skillMdPath}`);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Load agents from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param agentNames - Agent names from manifest
+     * @returns Array of loaded agents
+     */
+    async loadAgents(pluginPath, agentNames) {
+        const agents = [];
+        const agentsDir = path.join(pluginPath, 'agents');
+        for (const agentName of agentNames) {
+            const agentPath = path.join(agentsDir, agentName);
+            const agentMdPath = path.join(agentPath, 'AGENT.md');
+            if (await fs.pathExists(agentMdPath)) {
+                const content = await fs.readFile(agentMdPath, 'utf-8');
+                const systemPrompt = content; // Full content is the system prompt
+                const capabilities = this.extractCapabilities(content);
+                agents.push({
+                    name: agentName,
+                    path: agentPath,
+                    systemPrompt,
+                    capabilities
+                });
+            }
+            else {
+                console.warn(`Agent ${agentName} not found at ${agentMdPath}`);
+            }
+        }
+        return agents;
+    }
+    /**
+     * Load commands from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param commandNames - Command names from manifest
+     * @returns Array of loaded commands
+     */
+    async loadCommands(pluginPath, commandNames) {
+        const commands = [];
+        const commandsDir = path.join(pluginPath, 'commands');
+        for (const commandName of commandNames) {
+            // Convert specweave.github.sync → github-sync.md
+            const fileName = commandName.replace('specweave.', '').replace(/\./g, '-') + '.md';
+            const commandPath = path.join(commandsDir, fileName);
+            if (await fs.pathExists(commandPath)) {
+                const content = await fs.readFile(commandPath, 'utf-8');
+                const description = this.extractDescription(content);
+                commands.push({
+                    name: commandName,
+                    path: commandPath,
+                    description,
+                    prompt: content
+                });
+            }
+            else {
+                console.warn(`Command ${commandName} not found at ${commandPath}`);
+            }
+        }
+        return commands;
+    }
+    /**
+     * Load test cases from skill directory
+     *
+     * @param skillPath - Path to skill directory
+     * @returns Array of test cases
+     */
+    async loadTestCases(skillPath) {
+        const testCases = [];
+        const testCasesDir = path.join(skillPath, 'test-cases');
+        if (!(await fs.pathExists(testCasesDir))) {
+            return testCases;
+        }
+        const files = await fs.readdir(testCasesDir);
+        for (const file of files) {
+            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+                const testCasePath = path.join(testCasesDir, file);
+                // TODO: Parse YAML test case
+                // For now, just record the path
+                testCases.push({
+                    id: file.replace(/\.(yaml|yml)$/, ''),
+                    description: `Test case from ${file}`,
+                    input: '',
+                    expected: '',
+                    path: testCasePath
+                });
+            }
+        }
+        return testCases;
+    }
+    /**
+     * Extract description from SKILL.md or AGENT.md frontmatter
+     *
+     * @param content - File content
+     * @returns Extracted description
+     */
+    extractDescription(content) {
+        // Extract from YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]+?)\n---/);
+        if (frontmatterMatch) {
+            const descMatch = frontmatterMatch[1].match(/description:\s*(.+)/);
+            if (descMatch) {
+                return descMatch[1].trim();
+            }
+        }
+        // Fallback: first non-empty line after frontmatter
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('-')) {
+                return trimmed.substring(0, 200); // Max 200 chars
+            }
+        }
+        return 'No description available';
+    }
+    /**
+     * Extract capabilities from agent content
+     *
+     * @param content - Agent file content
+     * @returns Array of capability strings
+     */
+    extractCapabilities(content) {
+        const capabilities = [];
+        // Look for "Capabilities" or "Can do" section
+        const capabilitiesMatch = content.match(/##\s*Capabilities\s*\n([\s\S]+?)(?=\n##|$)/i);
+        if (capabilitiesMatch) {
+            const lines = capabilitiesMatch[1].split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed.startsWith('-') || trimmed.startsWith('*')) {
+                    capabilities.push(trimmed.substring(1).trim());
+                }
+            }
+        }
+        return capabilities;
+    }
+    /**
+     * Verify plugin integrity
+     *
+     * Checks that all declared skills/agents/commands exist
+     *
+     * @param plugin - Plugin to verify
+     * @returns True if plugin is intact
+     */
+    async verifyPlugin(plugin) {
+        const { manifest, skills, agents, commands } = plugin;
+        // Check skills
+        if (skills.length !== manifest.provides.skills.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.skills.length} skills, found ${skills.length}`);
+            return false;
+        }
+        // Check agents
+        if (agents.length !== manifest.provides.agents.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.agents.length} agents, found ${agents.length}`);
+            return false;
+        }
+        // Check commands
+        if (commands.length !== manifest.provides.commands.length) {
+            console.warn(`Plugin ${manifest.name}: Expected ${manifest.provides.commands.length} commands, found ${commands.length}`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get plugin metadata (lightweight, without loading full plugin)
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Plugin metadata
+     */
+    async getMetadata(pluginPath) {
+        const manifest = await this.loadManifest(pluginPath);
+        return {
+            name: manifest.name,
+            version: manifest.version,
+            description: manifest.description,
+            skillCount: manifest.provides.skills.length,
+            agentCount: manifest.provides.agents.length,
+            commandCount: manifest.provides.commands.length
+        };
+    }
+}
+//# sourceMappingURL=plugin-loader.js.map

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

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

package/dist/core/plugin-manager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Plugin Manager
+ *
+ * Central orchestrator for plugin lifecycle management.
+ * Handles loading/unloading, dependency resolution, configuration management.
+ *
+ * @module core/plugin-manager
+ * @version 0.4.0
+ */
+import type { Plugin, PluginInfo, PluginLoadOptions, PluginUnloadOptions } from './types/plugin.js';
+import type { IAdapter } from '../adapters/adapter-interface.js';
+/**
+ * PluginManager - Manages plugin lifecycle and configuration
+ */
+export declare class PluginManager {
+    private projectPath;
+    private loader;
+    private configPath;
+    private pluginsDir;
+    private loadedPlugins;
+    /**
+     * Create a new PluginManager
+     *
+     * @param projectPath - Path to project root
+     * @param pluginsDir - Path to plugins directory (default: src/plugins)
+     */
+    constructor(projectPath?: string, pluginsDir?: string);
+    /**
+     * 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
+     */
+    loadPlugin(name: string, adapter: IAdapter, options?: PluginLoadOptions): Promise<void>;
+    /**
+     * Unload (disable) a plugin
+     *
+     * @param name - Plugin name
+     * @param adapter - Adapter to use for uninstallation
+     * @param options - Unload options
+     */
+    unloadPlugin(name: string, adapter: IAdapter, options?: PluginUnloadOptions): Promise<void>;
+    /**
+     * Get all available plugins (scan src/plugins/)
+     *
+     * @returns Array of plugin info
+     */
+    getAvailablePlugins(): Promise<PluginInfo[]>;
+    /**
+     * Get enabled plugins from config
+     *
+     * @returns Array of enabled plugin names
+     */
+    getEnabledPlugins(): Promise<string[]>;
+    /**
+     * Check if a plugin is enabled
+     *
+     * @param name - Plugin name
+     * @returns True if enabled
+     */
+    isPluginEnabled(name: string): Promise<boolean>;
+    /**
+     * Update plugin configuration
+     *
+     * @param name - Plugin name
+     * @param action - 'enable' or 'disable'
+     */
+    private updateConfig;
+    /**
+     * Load plugin configuration from .specweave/config.yaml
+     *
+     * @returns Plugin configuration
+     */
+    private loadConfig;
+    /**
+     * Save plugin configuration to .specweave/config.yaml
+     *
+     * @param pluginConfig - Plugin configuration to save
+     */
+    private saveConfig;
+    /**
+     * Check plugin dependencies
+     *
+     * Ensures all required plugins are loaded
+     *
+     * @param plugin - Plugin to check
+     * @throws PluginDependencyError if dependencies are not met
+     */
+    checkDependencies(plugin: Plugin): Promise<void>;
+    /**
+     * 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
+     */
+    resolveDependencies(plugin: Plugin): Promise<Plugin[]>;
+    /**
+     * Get plugins that depend on a given plugin
+     *
+     * @param name - Plugin name
+     * @returns Array of dependent plugin names
+     */
+    private getDependents;
+    /**
+     * Validate plugin configuration
+     *
+     * Checks for circular dependencies, missing plugins, etc.
+     *
+     * @returns Validation result
+     */
+    validateConfig(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Get plugin by name
+     *
+     * @param name - Plugin name
+     * @returns Loaded plugin
+     * @throws PluginNotFoundError if plugin is not loaded
+     */
+    getPlugin(name: string): Plugin;
+    /**
+     * Get all loaded plugins
+     *
+     * @returns Map of loaded plugins
+     */
+    getLoadedPlugins(): Map<string, Plugin>;
+    /**
+     * Clear loaded plugins cache
+     *
+     * Useful for testing or forcing reload
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/core/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/core/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAEV,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE;;GAEG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,WAAW;IAZrB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAsB;IAE3C;;;;;OAKG;gBAEO,WAAW,GAAE,MAAsB,EAC3C,UAAU,CAAC,EAAE,MAAM;IAQrB;;;;;;;;;;;OAWG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,EACjB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAmDhB;;;;;;OAMG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;IAkChB;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAwClD;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK5C;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrD;;;;;OAKG;YACW,YAAY;IAc1B;;;;OAIG;YACW,UAAU;IA4BxB;;;;OAIG;YACW,UAAU;IAgBxB;;;;;;;OAOG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBtD;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4B5D;;;;;OAKG;YACW,aAAa;IAgB3B;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAuDrE;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ/B;;;;OAIG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;;;OAIG;IACH,UAAU,IAAI,IAAI;CAGnB"}