specweave 0.3.13 → 0.4.1

package/dist/core/phase-detector.js

@@ -0,0 +1,229 @@
+/**
+ * Phase Detector
+ *
+ * Multi-signal phase detection algorithm that analyzes user prompts and context
+ * to determine whether work is in planning, execution, or review phase.
+ *
+ * Uses 4 signals with weighted scoring:
+ * 1. Keyword analysis (40%) - Planning/execution/review keywords
+ * 2. Command analysis (30%) - Slash commands hint at phase
+ * 3. Context analysis (20%) - Increment state, file types
+ * 4. Explicit hints (10%) - User explicitly states phase
+ *
+ * Target accuracy: >95%
+ */
+export class PhaseDetector {
+    constructor() {
+        // Keyword dictionaries for each phase
+        this.planningKeywords = [
+            'plan', 'design', 'analyze', 'research', 'architecture', 'decide',
+            'strategy', 'requirements', 'specification', 'feasibility', 'explore',
+            'brainstorm', 'assess', 'evaluate', 'investigate', 'study', 'conceive',
+            'blueprint', 'roadmap', 'scope', 'estimate', 'proposal'
+        ];
+        this.executionKeywords = [
+            'implement', 'build', 'create', 'write', 'code', 'generate',
+            'develop', 'construct', 'refactor', 'fix', 'update', 'modify',
+            'add', 'delete', 'remove', 'change', 'integrate', 'deploy',
+            'setup', 'configure', 'install', 'run', 'execute'
+        ];
+        this.reviewKeywords = [
+            'review', 'validate', 'audit', 'assess', 'check', 'verify',
+            'test', 'evaluate', 'inspect', 'examine', 'quality',
+            'debug', 'troubleshoot', 'analyze error', 'find bug', 'measure'
+        ];
+        // Command-to-phase mapping
+        this.commandPhaseMap = {
+            '/specweave.inc': 'planning',
+            '/specweave': 'planning',
+            '/increment': 'planning',
+            '/specweave.do': 'execution',
+            '/do': 'execution',
+            '/specweave.validate': 'review',
+            '/validate': 'review',
+            '/specweave.done': 'review',
+            '/spec-driven-brainstorming': 'planning',
+        };
+    }
+    /**
+     * Detect phase from user prompt and execution context
+     */
+    detect(prompt, context = {}) {
+        const scores = {
+            planning: 0,
+            execution: 0,
+            review: 0,
+        };
+        const signals = {
+            keywords: [],
+            context: [],
+        };
+        // Signal 1: Keyword analysis (40% weight)
+        const keywordScore = this.analyzeKeywords(prompt, scores, signals);
+        // Signal 2: Command analysis (30% weight)
+        const commandScore = this.analyzeCommand(context, scores, signals);
+        // Signal 3: Context analysis (20% weight)
+        const contextScore = this.analyzeContext(context, scores, signals);
+        // Signal 4: Explicit hints (10% weight)
+        const hintScore = this.analyzeHints(prompt, scores, signals);
+        // Calculate total signal strength
+        const totalSignals = keywordScore + commandScore + contextScore + hintScore;
+        // Determine winning phase
+        const phase = Object.keys(scores).reduce((a, b) => scores[a] > scores[b] ? a : b);
+        // Calculate confidence (normalized score of winning phase)
+        const maxScore = Math.max(...Object.values(scores));
+        const confidence = maxScore > 0 ? scores[phase] / maxScore : 0.5;
+        return {
+            phase,
+            confidence,
+            signals,
+            reasoning: this.generateReasoning(phase, confidence, signals, totalSignals),
+        };
+    }
+    /**
+     * Analyze keywords in prompt
+     */
+    analyzeKeywords(prompt, scores, signals) {
+        const lowerPrompt = prompt.toLowerCase();
+        let matchCount = 0;
+        // Check planning keywords
+        for (const keyword of this.planningKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.planning++;
+                if (signals.keywords.length < 5) { // Limit to first 5
+                    signals.keywords.push(`planning:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        // Check execution keywords
+        for (const keyword of this.executionKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.execution++;
+                if (signals.keywords.length < 5) {
+                    signals.keywords.push(`execution:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        // Check review keywords
+        for (const keyword of this.reviewKeywords) {
+            if (lowerPrompt.includes(keyword)) {
+                scores.review++;
+                if (signals.keywords.length < 5) {
+                    signals.keywords.push(`review:${keyword}`);
+                }
+                matchCount++;
+            }
+        }
+        return matchCount > 0 ? 1 : 0;
+    }
+    /**
+     * Analyze command hints
+     */
+    analyzeCommand(context, scores, signals) {
+        if (context.command && this.commandPhaseMap[context.command]) {
+            const phase = this.commandPhaseMap[context.command];
+            scores[phase] += 3; // Strong signal
+            signals.command = context.command;
+            return 1;
+        }
+        return 0;
+    }
+    /**
+     * Analyze execution context
+     */
+    analyzeContext(context, scores, signals) {
+        let signalCount = 0;
+        // Increment state signals
+        if (context.incrementState === 'backlog' || context.incrementState === 'planned') {
+            scores.planning++;
+            signals.context.push(`increment:${context.incrementState}`);
+            signalCount++;
+        }
+        else if (context.incrementState === 'in-progress') {
+            scores.execution++;
+            signals.context.push('increment:in-progress');
+            signalCount++;
+        }
+        else if (context.incrementState === 'completed') {
+            scores.review++;
+            signals.context.push('increment:completed');
+            signalCount++;
+        }
+        // File modification signals
+        if (context.filesModified && context.filesModified.length > 0) {
+            const hasArchitectureDocs = context.filesModified.some(f => f.includes('/architecture/') || f.includes('/adr/') || f.includes('spec.md') || f.includes('plan.md'));
+            const hasCodeFiles = context.filesModified.some(f => f.endsWith('.ts') || f.endsWith('.js') || f.endsWith('.py') ||
+                f.endsWith('.tsx') || f.endsWith('.jsx') || f.endsWith('.java'));
+            const hasTestFiles = context.filesModified.some(f => f.includes('.test.') || f.includes('.spec.') || f.includes('__tests__/'));
+            if (hasArchitectureDocs) {
+                scores.planning++;
+                signals.context.push('files:architecture-docs');
+                signalCount++;
+            }
+            if (hasCodeFiles) {
+                scores.execution++;
+                signals.context.push('files:code-files');
+                signalCount++;
+            }
+            if (hasTestFiles) {
+                scores.review++;
+                signals.context.push('files:test-files');
+                signalCount++;
+            }
+        }
+        return signalCount > 0 ? 1 : 0;
+    }
+    /**
+     * Analyze explicit hints in prompt
+     */
+    analyzeHints(prompt, scores, signals) {
+        const lowerPrompt = prompt.toLowerCase();
+        // Explicit phase mentions
+        if (lowerPrompt.includes('planning phase') || lowerPrompt.includes('plan for')) {
+            scores.planning += 2;
+            return 1;
+        }
+        if (lowerPrompt.includes('implementation') || lowerPrompt.includes('execution phase') || lowerPrompt.includes('build phase')) {
+            scores.execution += 2;
+            return 1;
+        }
+        if (lowerPrompt.includes('review phase') || lowerPrompt.includes('validation phase')) {
+            scores.review += 2;
+            return 1;
+        }
+        return 0;
+    }
+    /**
+     * Generate human-readable reasoning
+     */
+    generateReasoning(phase, confidence, signals, totalSignals) {
+        const reasons = [];
+        if (signals.command) {
+            reasons.push(`command '${signals.command}' indicates ${phase}`);
+        }
+        const planningKeywords = signals.keywords.filter(k => k.startsWith('planning:')).map(k => k.substring(9));
+        const executionKeywords = signals.keywords.filter(k => k.startsWith('execution:')).map(k => k.substring(10));
+        const reviewKeywords = signals.keywords.filter(k => k.startsWith('review:')).map(k => k.substring(7));
+        if (planningKeywords.length > 0) {
+            reasons.push(`planning keywords: ${planningKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (executionKeywords.length > 0) {
+            reasons.push(`execution keywords: ${executionKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (reviewKeywords.length > 0) {
+            reasons.push(`review keywords: ${reviewKeywords.slice(0, 3).join(', ')}`);
+        }
+        if (signals.context.length > 0) {
+            reasons.push(`context: ${signals.context.join(', ')}`);
+        }
+        const confidencePercent = (confidence * 100).toFixed(0);
+        const signalStrength = totalSignals >= 3 ? 'strong' : totalSignals >= 2 ? 'moderate' : 'weak';
+        if (reasons.length === 0) {
+            return `${phase} phase (${confidencePercent}% confidence, ${signalStrength} signals) - defaulting due to low signal`;
+        }
+        return `${phase} phase (${confidencePercent}% confidence, ${signalStrength} signals) - ${reasons.join('; ')}`;
+    }
+}
+//# sourceMappingURL=phase-detector.js.map

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

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