specweave 0.14.0 → 0.15.0

package/dist/src/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/src/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/src/core/plugin-loader.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Plugin Loader - Claude Code Native
+ *
+ * Reads plugin directories using Claude's official plugin.json format.
+ * Discovers components by scanning directory structure (not from manifest).
+ *
+ * @module core/plugin-loader
+ * @version 0.6.1
+ * @see https://docs.claude.com/en/docs/claude-code/plugins
+ */
+import type { Plugin, PluginManifest, ValidationResult } from './types/plugin.js';
+/**
+ * PluginLoader - Loads Claude Code plugins from filesystem
+ */
+export declare class PluginLoader {
+    constructor();
+    /**
+     * Load a plugin from directory (Claude Code native)
+     *
+     * @param pluginPath - Absolute path to plugin directory
+     * @returns Loaded plugin with all components
+     * @throws PluginNotFoundError if directory doesn't exist
+     * @throws ManifestValidationError if plugin.json is invalid
+     */
+    loadFromDirectory(pluginPath: string): Promise<Plugin>;
+    /**
+     * Load plugin manifest from .claude-plugin/plugin.json (Claude's official format)
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Plugin manifest
+     * @throws ManifestValidationError if plugin.json is invalid
+     */
+    loadManifest(pluginPath: string): Promise<PluginManifest>;
+    /**
+     * Validate plugin.json (simple validation, no JSON Schema)
+     *
+     * @param manifest - Manifest object to validate
+     * @returns Validation result with errors/warnings
+     */
+    validateManifest(manifest: any): ValidationResult;
+    /**
+     * Discover skills by scanning skills/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered skills
+     */
+    private discoverSkills;
+    /**
+     * Discover agents by scanning agents/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered agents
+     */
+    private discoverAgents;
+    /**
+     * Discover commands by scanning commands/ directory
+     *
+     * @param pluginPath - Path to plugin directory
+     * @returns Array of discovered commands
+     */
+    private discoverCommands;
+    /**
+     * 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/src/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;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EAKd,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAM3B;;GAEG;AACH,qBAAa,YAAY;;IAKvB;;;;;;;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;IAkCjD;;;;;OAKG;YACW,cAAc;IAgC5B;;;;;OAKG;YACW,cAAc;IA+B5B;;;;;OAKG;YACW,gBAAgB;IA4B9B;;;;;;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"}