specweave 0.3.13 → 0.4.1

package/dist/core/plugin-detector.js

@@ -0,0 +1,349 @@
+/**
+ * Plugin Detector
+ *
+ * Automatically detects which plugins should be enabled based on:
+ * 1. Project structure (package.json, directories, env vars, git remote)
+ * 2. Spec content (keywords, domain analysis)
+ * 3. Task descriptions (pre-task hook)
+ * 4. Git changes (post-increment hook)
+ *
+ * @module core/plugin-detector
+ * @version 0.4.0
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import { PluginLoader } from './plugin-loader.js';
+/**
+ * PluginDetector - Auto-detects relevant plugins for a project
+ */
+export class PluginDetector {
+    /**
+     * Create a new PluginDetector
+     *
+     * @param pluginsDir - Path to plugins directory (default: src/plugins)
+     */
+    constructor(pluginsDir) {
+        this.availablePlugins = [];
+        this.loader = new PluginLoader();
+        this.pluginsDir = pluginsDir || path.join(process.cwd(), 'src', 'plugins');
+    }
+    /**
+     * Load available plugins for detection
+     *
+     * Scans plugins directory and loads all plugin manifests
+     */
+    async loadAvailablePlugins() {
+        this.availablePlugins = [];
+        if (!(await fs.pathExists(this.pluginsDir))) {
+            return; // No plugins available
+        }
+        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 plugin = await this.loader.loadFromDirectory(pluginPath);
+                    this.availablePlugins.push(plugin);
+                }
+                catch (error) {
+                    console.warn(`⚠️  Failed to load plugin ${dir}: ${error.message}`);
+                }
+            }
+        }
+    }
+    /**
+     * Phase 1: Init-time detection
+     *
+     * Detects plugins based on project structure during `specweave init`
+     *
+     * @param projectPath - Path to project root
+     * @returns Array of detection results with confidence scores
+     */
+    async detectFromProject(projectPath) {
+        const results = [];
+        // Ensure plugins are loaded
+        if (this.availablePlugins.length === 0) {
+            await this.loadAvailablePlugins();
+        }
+        // Check each plugin's auto_detect rules
+        for (const plugin of this.availablePlugins) {
+            const { auto_detect } = plugin.manifest;
+            if (!auto_detect)
+                continue;
+            let confidence = 0;
+            const reasons = [];
+            // Check files/directories
+            if (auto_detect.files) {
+                for (const pattern of auto_detect.files) {
+                    const filePath = path.join(projectPath, pattern);
+                    if (await fs.pathExists(filePath)) {
+                        confidence += 0.3;
+                        reasons.push(`Found ${pattern}`);
+                    }
+                }
+            }
+            // Check package.json dependencies
+            if (auto_detect.packages) {
+                const packageJsonPath = path.join(projectPath, 'package.json');
+                if (await fs.pathExists(packageJsonPath)) {
+                    const packageJson = await fs.readJSON(packageJsonPath);
+                    const allDeps = {
+                        ...packageJson.dependencies,
+                        ...packageJson.devDependencies
+                    };
+                    for (const pkg of auto_detect.packages) {
+                        if (allDeps[pkg]) {
+                            confidence += 0.25;
+                            reasons.push(`Uses ${pkg}`);
+                        }
+                    }
+                }
+            }
+            // Check environment variables
+            if (auto_detect.env_vars) {
+                for (const envVar of auto_detect.env_vars) {
+                    if (process.env[envVar]) {
+                        confidence += 0.2;
+                        reasons.push(`Env var ${envVar} set`);
+                    }
+                }
+            }
+            // Check git remote pattern
+            if (auto_detect.git_remote_pattern) {
+                const gitConfigPath = path.join(projectPath, '.git', 'config');
+                if (await fs.pathExists(gitConfigPath)) {
+                    const gitConfig = await fs.readFile(gitConfigPath, 'utf-8');
+                    const regex = new RegExp(auto_detect.git_remote_pattern);
+                    if (regex.test(gitConfig)) {
+                        confidence += 0.25;
+                        reasons.push(`Git remote matches ${auto_detect.git_remote_pattern}`);
+                    }
+                }
+            }
+            // Add to results if confidence > 0
+            if (confidence > 0) {
+                results.push({
+                    pluginName: plugin.manifest.name,
+                    confidence: Math.min(confidence, 1.0), // Cap at 1.0
+                    reason: reasons.join(', '),
+                    trigger: 'project-structure'
+                });
+            }
+        }
+        // Sort by confidence (highest first)
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Phase 2: Spec-based detection
+     *
+     * Detects plugins based on increment spec content during `/specweave.inc`
+     *
+     * @param specContent - Content of spec.md
+     * @returns Array of detection results
+     */
+    async detectFromSpec(specContent) {
+        const results = [];
+        // Ensure plugins are loaded
+        if (this.availablePlugins.length === 0) {
+            await this.loadAvailablePlugins();
+        }
+        const normalizedContent = specContent.toLowerCase();
+        // Check each plugin's trigger keywords
+        for (const plugin of this.availablePlugins) {
+            const { triggers } = plugin.manifest;
+            if (!triggers || triggers.length === 0)
+                continue;
+            let matchCount = 0;
+            const matchedTriggers = [];
+            for (const trigger of triggers) {
+                const regex = new RegExp(`\\b${trigger.toLowerCase()}\\b`, 'gi');
+                const matches = normalizedContent.match(regex);
+                if (matches) {
+                    matchCount += matches.length;
+                    matchedTriggers.push(trigger);
+                }
+            }
+            if (matchCount > 0) {
+                // Confidence based on frequency (capped at 1.0)
+                const confidence = Math.min(matchCount * 0.1, 1.0);
+                results.push({
+                    pluginName: plugin.manifest.name,
+                    confidence,
+                    reason: `Spec mentions: ${matchedTriggers.join(', ')}`,
+                    trigger: 'spec-keywords'
+                });
+            }
+        }
+        // Sort by confidence
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Phase 3: Task-based detection
+     *
+     * Detects plugins based on task description (pre-task hook)
+     *
+     * @param taskContent - Content of task description
+     * @returns Array of detection results
+     */
+    async detectFromTask(taskContent) {
+        const results = [];
+        // Ensure plugins are loaded
+        if (this.availablePlugins.length === 0) {
+            await this.loadAvailablePlugins();
+        }
+        const normalizedContent = taskContent.toLowerCase();
+        // Check each plugin's trigger keywords
+        for (const plugin of this.availablePlugins) {
+            const { triggers } = plugin.manifest;
+            if (!triggers || triggers.length === 0)
+                continue;
+            const matchedTriggers = [];
+            for (const trigger of triggers) {
+                const regex = new RegExp(`\\b${trigger.toLowerCase()}\\b`, 'i');
+                if (regex.test(normalizedContent)) {
+                    matchedTriggers.push(trigger);
+                }
+            }
+            if (matchedTriggers.length > 0) {
+                // Task-based detection has moderate confidence
+                const confidence = 0.6;
+                results.push({
+                    pluginName: plugin.manifest.name,
+                    confidence,
+                    reason: `Task mentions: ${matchedTriggers.join(', ')}`,
+                    trigger: 'task-keywords'
+                });
+            }
+        }
+        // Sort by confidence
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Phase 4: Git diff detection
+     *
+     * Detects plugins based on recent git changes (post-increment hook)
+     *
+     * @param diff - Git diff output
+     * @returns Array of detection results
+     */
+    async detectFromChanges(diff) {
+        const results = [];
+        // Ensure plugins are loaded
+        if (this.availablePlugins.length === 0) {
+            await this.loadAvailablePlugins();
+        }
+        const normalizedDiff = diff.toLowerCase();
+        // Check for new file patterns
+        for (const plugin of this.availablePlugins) {
+            const { auto_detect } = plugin.manifest;
+            if (!auto_detect?.files)
+                continue;
+            const matchedFiles = [];
+            for (const pattern of auto_detect.files) {
+                // Check if diff contains new files matching pattern
+                const regex = new RegExp(`\\+\\+\\+.*${pattern}`, 'i');
+                if (regex.test(normalizedDiff)) {
+                    matchedFiles.push(pattern);
+                }
+            }
+            if (matchedFiles.length > 0) {
+                results.push({
+                    pluginName: plugin.manifest.name,
+                    confidence: 0.7,
+                    reason: `Added files: ${matchedFiles.join(', ')}`,
+                    trigger: 'git-changes'
+                });
+            }
+        }
+        // Check for new package.json dependencies
+        const packageJsonMatch = diff.match(/\+\+\+ b\/package\.json([\s\S]+?)(?=\+\+\+|$)/);
+        if (packageJsonMatch) {
+            const addedLines = packageJsonMatch[1]
+                .split('\n')
+                .filter(line => line.startsWith('+') && !line.startsWith('+++'));
+            for (const plugin of this.availablePlugins) {
+                const { auto_detect } = plugin.manifest;
+                if (!auto_detect?.packages)
+                    continue;
+                const matchedPackages = [];
+                for (const pkg of auto_detect.packages) {
+                    if (addedLines.some(line => line.includes(`"${pkg}"`))) {
+                        matchedPackages.push(pkg);
+                    }
+                }
+                if (matchedPackages.length > 0) {
+                    results.push({
+                        pluginName: plugin.manifest.name,
+                        confidence: 0.8,
+                        reason: `Added dependencies: ${matchedPackages.join(', ')}`,
+                        trigger: 'package-json-changes'
+                    });
+                }
+            }
+        }
+        // Sort by confidence
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Combine detection results from multiple sources
+     *
+     * Merges results and adjusts confidence scores
+     *
+     * @param results - Array of detection result arrays
+     * @returns Merged and deduplicated results
+     */
+    combineResults(...results) {
+        const combined = new Map();
+        for (const resultArray of results) {
+            for (const result of resultArray) {
+                const existing = combined.get(result.pluginName);
+                if (existing) {
+                    // Boost confidence if detected from multiple sources
+                    existing.confidence = Math.min(existing.confidence + result.confidence * 0.3, 1.0);
+                    existing.reason += `; ${result.reason}`;
+                }
+                else {
+                    combined.set(result.pluginName, { ...result });
+                }
+            }
+        }
+        // Convert to array and sort
+        return Array.from(combined.values()).sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Get high-confidence suggestions
+     *
+     * Filters detection results by confidence threshold
+     *
+     * @param results - Detection results
+     * @param threshold - Minimum confidence (default: 0.6)
+     * @returns High-confidence plugin suggestions
+     */
+    getHighConfidenceSuggestions(results, threshold = 0.6) {
+        return results
+            .filter(r => r.confidence >= threshold)
+            .map(r => r.pluginName);
+    }
+    /**
+     * Format detection results for display
+     *
+     * @param results - Detection results
+     * @returns Formatted string for CLI output
+     */
+    formatResults(results) {
+        if (results.length === 0) {
+            return 'No plugins detected for this project.';
+        }
+        let output = '\n📦 Detected plugins:\n\n';
+        for (const result of results) {
+            const confidenceBar = '█'.repeat(Math.floor(result.confidence * 10));
+            const confidencePercent = Math.floor(result.confidence * 100);
+            output += `  ${result.pluginName}\n`;
+            output += `    Confidence: ${confidenceBar} ${confidencePercent}%\n`;
+            output += `    Reason: ${result.reason}\n\n`;
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=plugin-detector.js.map

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

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

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

@@ -0,0 +1,111 @@
+/**
+ * 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 type { Plugin, PluginManifest, ValidationResult } from './types/plugin.js';
+/**
+ * PluginLoader - Loads and validates plugins from filesystem
+ */
+export declare class PluginLoader {
+    private ajv;
+    private validateManifestSchema;
+    constructor();
+    /**
+     * 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
+     */
+    loadFromDirectory(pluginPath: string): Promise<Plugin>;
+    /**
+     * Load plugin manifest from .claude-plugin/manifest.json
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Validated plugin manifest
+     * @throws ManifestValidationError if manifest is invalid
+     */
+    loadManifest(pluginPath: string): Promise<PluginManifest>;
+    /**
+     * Validate manifest against JSON schema
+     *
+     * @param manifest - Manifest object to validate
+     * @returns Validation result with errors/warnings
+     */
+    validateManifest(manifest: any): ValidationResult;
+    /**
+     * Load skills from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param skillNames - Skill names from manifest
+     * @returns Array of loaded skills
+     */
+    private loadSkills;
+    /**
+     * Load agents from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param agentNames - Agent names from manifest
+     * @returns Array of loaded agents
+     */
+    private loadAgents;
+    /**
+     * Load commands from plugin
+     *
+     * @param pluginPath - Path to plugin directory
+     * @param commandNames - Command names from manifest
+     * @returns Array of loaded commands
+     */
+    private loadCommands;
+    /**
+     * Load test cases from skill directory
+     *
+     * @param skillPath - Path to skill directory
+     * @returns Array of test cases
+     */
+    private loadTestCases;
+    /**
+     * Extract description from SKILL.md or AGENT.md frontmatter
+     *
+     * @param content - File content
+     * @returns Extracted description
+     */
+    private extractDescription;
+    /**
+     * Extract capabilities from agent content
+     *
+     * @param content - Agent file content
+     * @returns Array of capability strings
+     */
+    private extractCapabilities;
+    /**
+     * Verify plugin integrity
+     *
+     * Checks that all declared skills/agents/commands exist
+     *
+     * @param plugin - Plugin to verify
+     * @returns True if plugin is intact
+     */
+    verifyPlugin(plugin: Plugin): Promise<boolean>;
+    /**
+     * Get plugin metadata (lightweight, without loading full plugin)
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Plugin metadata
+     */
+    getMetadata(pluginPath: string): Promise<{
+        name: string;
+        version: string;
+        description: string;
+        skillCount: number;
+        agentCount: number;
+        commandCount: number;
+    }>;
+}
+//# sourceMappingURL=plugin-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/core/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EAKd,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAS3B;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,sBAAsB,CAAM;;IAQpC;;;;;;;OAOG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB5D;;;;;;OAMG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkC/D;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB;IAyBjD;;;;;;OAMG;YACW,UAAU;IA6BxB;;;;;;OAMG;YACW,UAAU;IA2BxB;;;;;;OAMG;YACW,YAAY;IA2B1B;;;;;OAKG;YACW,aAAa;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpD;;;;;OAKG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CAYH"}