specweave 0.4.0 → 0.6.0

package/dist/core/increment-status.js

@@ -0,0 +1,227 @@
+/**
+ * Increment Status Detection
+ *
+ * Utility to detect increment completion status and enforce increment discipline.
+ *
+ * **The Iron Rule**: Cannot start increment N+1 until increment N is DONE.
+ *
+ * DONE means one of:
+ * 1. All tasks in tasks.md marked [x] Completed
+ * 2. COMPLETION-SUMMARY.md exists with "COMPLETE" status
+ * 3. All tasks removed/moved with documentation
+ */
+import fs from 'fs-extra';
+import path from 'path';
+export class IncrementStatusDetector {
+    constructor(projectPath = process.cwd()) {
+        this.incrementsPath = path.join(projectPath, '.specweave/increments');
+    }
+    /**
+     * Get status for a specific increment
+     */
+    async getStatus(incrementId) {
+        const incrementPath = path.join(this.incrementsPath, incrementId);
+        if (!await fs.pathExists(incrementPath)) {
+            return {
+                id: incrementId,
+                path: incrementPath,
+                exists: false,
+                isComplete: false,
+                totalTasks: 0,
+                completedTasks: 0,
+                percentComplete: 0,
+                pendingTasks: [],
+                completionReports: [],
+                hasCompletionMarker: false,
+                reason: 'Increment directory does not exist',
+            };
+        }
+        // Check for completion markers
+        const completionReports = await this.findCompletionReports(incrementPath);
+        const hasCompletionMarker = completionReports.length > 0;
+        // Parse tasks.md
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        let totalTasks = 0;
+        let completedTasks = 0;
+        let pendingTasks = [];
+        if (await fs.pathExists(tasksPath)) {
+            const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+            const taskStats = this.parseTasksFile(tasksContent);
+            totalTasks = taskStats.totalTasks;
+            completedTasks = taskStats.completedTasks;
+            pendingTasks = taskStats.pendingTasks;
+        }
+        const percentComplete = totalTasks > 0
+            ? Math.round((completedTasks / totalTasks) * 100)
+            : (hasCompletionMarker ? 100 : 0);
+        const isComplete = hasCompletionMarker || (totalTasks > 0 && completedTasks === totalTasks);
+        let reason;
+        if (!isComplete) {
+            if (totalTasks === 0) {
+                reason = 'No tasks found (tasks.md missing or empty)';
+            }
+            else {
+                reason = `${totalTasks - completedTasks} tasks incomplete (${percentComplete}% complete)`;
+            }
+        }
+        return {
+            id: incrementId,
+            path: incrementPath,
+            exists: true,
+            isComplete,
+            totalTasks,
+            completedTasks,
+            percentComplete,
+            pendingTasks,
+            completionReports,
+            hasCompletionMarker,
+            reason,
+        };
+    }
+    /**
+     * Get all incomplete increments
+     */
+    async getAllIncomplete() {
+        if (!await fs.pathExists(this.incrementsPath)) {
+            return [];
+        }
+        const entries = await fs.readdir(this.incrementsPath, { withFileTypes: true });
+        const incrementDirs = entries
+            .filter(entry => entry.isDirectory())
+            .filter(entry => /^\d{4}-/.test(entry.name)) // Only numbered increments
+            .map(entry => entry.name);
+        const statuses = await Promise.all(incrementDirs.map(id => this.getStatus(id)));
+        return statuses.filter(status => status.exists && !status.isComplete);
+    }
+    /**
+     * Get latest increment ID
+     */
+    async getLatest() {
+        if (!await fs.pathExists(this.incrementsPath)) {
+            return null;
+        }
+        const entries = await fs.readdir(this.incrementsPath, { withFileTypes: true });
+        const incrementDirs = entries
+            .filter(entry => entry.isDirectory())
+            .filter(entry => /^\d{4}-/.test(entry.name))
+            .map(entry => entry.name)
+            .sort()
+            .reverse();
+        return incrementDirs[0] || null;
+    }
+    /**
+     * Check if increment is complete
+     */
+    async isComplete(incrementId) {
+        const status = await this.getStatus(incrementId);
+        return status.isComplete;
+    }
+    /**
+     * Find completion reports (COMPLETION-SUMMARY.md, etc.)
+     */
+    async findCompletionReports(incrementPath) {
+        const reportPatterns = [
+            'COMPLETION-SUMMARY.md',
+            'COMPLETION-REPORT.md',
+            'FINAL-REPORT.md',
+            'DONE.md',
+        ];
+        const reports = [];
+        for (const pattern of reportPatterns) {
+            const reportPath = path.join(incrementPath, pattern);
+            if (await fs.pathExists(reportPath)) {
+                // Check if report contains "COMPLETE" status
+                const content = await fs.readFile(reportPath, 'utf-8');
+                if (/Status.*:.*COMPLETE/i.test(content) || /✅.*COMPLETE/i.test(content)) {
+                    reports.push(pattern);
+                }
+            }
+        }
+        return reports;
+    }
+    /**
+     * Parse tasks.md to extract task statistics
+     */
+    parseTasksFile(content) {
+        const lines = content.split('\n');
+        let totalTasks = 0;
+        let completedTasks = 0;
+        const pendingTasks = [];
+        let currentTaskId = null;
+        let currentTaskTitle = null;
+        let currentTaskPriority = null;
+        let currentTaskPhase = null;
+        for (const line of lines) {
+            // Match task header: ### T-001: Task Title OR ### T-001-DISCIPLINE: Task Title
+            const taskHeaderMatch = line.match(/^###\s+(T-\d+(?:-[A-Z]+)?):\s+(.+)/);
+            if (taskHeaderMatch) {
+                currentTaskId = taskHeaderMatch[1];
+                currentTaskTitle = taskHeaderMatch[2];
+                currentTaskPriority = null;
+                currentTaskPhase = null;
+                continue;
+            }
+            // Match priority: **Priority**: P0
+            const priorityMatch = line.match(/\*\*Priority\*\*:\s+(\w+)/);
+            if (priorityMatch && currentTaskId) {
+                currentTaskPriority = priorityMatch[1];
+                continue;
+            }
+            // Match phase: **Phase**: Week 1
+            const phaseMatch = line.match(/\*\*Phase\*\*:\s+(.+)/);
+            if (phaseMatch && currentTaskId) {
+                currentTaskPhase = phaseMatch[1];
+                continue;
+            }
+            // Match status: **Status**: [x] Completed OR pending
+            const statusMatch = line.match(/\*\*Status\*\*:\s+\[([x ])\]\s+(\w+)/);
+            if (statusMatch && currentTaskId && currentTaskTitle) {
+                totalTasks++;
+                const isComplete = statusMatch[1] === 'x';
+                if (isComplete) {
+                    completedTasks++;
+                }
+                else {
+                    pendingTasks.push({
+                        id: currentTaskId,
+                        title: currentTaskTitle,
+                        priority: currentTaskPriority || undefined,
+                        phase: currentTaskPhase || undefined,
+                    });
+                }
+                // Reset for next task
+                currentTaskId = null;
+                currentTaskTitle = null;
+                currentTaskPriority = null;
+                currentTaskPhase = null;
+            }
+        }
+        return {
+            totalTasks,
+            completedTasks,
+            pendingTasks,
+        };
+    }
+}
+/**
+ * Convenience function to check if an increment is complete
+ */
+export async function isIncrementComplete(incrementId, projectPath) {
+    const detector = new IncrementStatusDetector(projectPath);
+    return detector.isComplete(incrementId);
+}
+/**
+ * Convenience function to get all incomplete increments
+ */
+export async function getAllIncompleteIncrements(projectPath) {
+    const detector = new IncrementStatusDetector(projectPath);
+    return detector.getAllIncomplete();
+}
+/**
+ * Convenience function to get latest increment
+ */
+export async function getLatestIncrement(projectPath) {
+    const detector = new IncrementStatusDetector(projectPath);
+    return detector.getLatest();
+}
+//# sourceMappingURL=increment-status.js.map

package/dist/core/increment-status.js.map

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

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

@@ -0,0 +1,96 @@
+/**
+ * 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 type { DetectionResult } from './types/plugin.js';
+/**
+ * PluginDetector - Auto-detects relevant plugins for a project
+ */
+export declare class PluginDetector {
+    private loader;
+    private availablePlugins;
+    private pluginsDir;
+    /**
+     * Create a new PluginDetector
+     *
+     * @param pluginsDir - Path to plugins directory (default: src/plugins)
+     */
+    constructor(pluginsDir?: string);
+    /**
+     * Load available plugins for detection
+     *
+     * Scans plugins directory and loads all plugin manifests
+     */
+    loadAvailablePlugins(): Promise<void>;
+    /**
+     * 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
+     */
+    detectFromProject(projectPath: string): Promise<DetectionResult[]>;
+    /**
+     * 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
+     */
+    detectFromSpec(specContent: string): Promise<DetectionResult[]>;
+    /**
+     * 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
+     */
+    detectFromTask(taskContent: string): Promise<DetectionResult[]>;
+    /**
+     * 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
+     */
+    detectFromChanges(diff: string): Promise<DetectionResult[]>;
+    /**
+     * 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: DetectionResult[][]): DetectionResult[];
+    /**
+     * 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: DetectionResult[], threshold?: number): string[];
+    /**
+     * Format detection results for display
+     *
+     * @param results - Detection results
+     * @returns Formatted string for CLI output
+     */
+    formatResults(results: DetectionResult[]): string;
+}
+//# sourceMappingURL=plugin-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-detector.d.ts","sourceRoot":"","sources":["../../src/core/plugin-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAU,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGjE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM;IAK/B;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3C;;;;;;;OAOG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAoFxE;;;;;;;OAOG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4CrE;;;;;;;OAOG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyCrE;;;;;;;OAOG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqEjE;;;;;;;OAOG;IACH,cAAc,CAAC,GAAG,OAAO,EAAE,eAAe,EAAE,EAAE,GAAG,eAAe,EAAE;IAwBlE;;;;;;;;OAQG;IACH,4BAA4B,CAC1B,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,GAAE,MAAY,GACtB,MAAM,EAAE;IAMX;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;CAkBlD"}

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