specweave 0.3.13 → 0.4.0

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/types/cost-tracking.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Type definitions for Cost Tracking system
+ *
+ * Tracks token usage and costs per session, agent, model, and increment.
+ * Calculates savings vs all-Sonnet baseline.
+ */
+import type { Model } from './model-selection';
+/**
+ * Token usage for a single session
+ */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Single cost tracking session (one agent invocation)
+ */
+export interface CostSession {
+    sessionId: string;
+    agent: string;
+    model: Exclude<Model, 'auto'>;
+    increment?: string;
+    command?: string;
+    startedAt: string;
+    endedAt?: string;
+    tokenUsage: TokenUsage;
+    cost: number;
+    savings: number;
+}
+/**
+ * Cost report for an entire increment
+ */
+export interface IncrementCostReport {
+    incrementId: string;
+    totalCost: number;
+    totalSavings: number;
+    totalTokens: number;
+    sessionCount: number;
+    costByModel: Record<string, number>;
+    costByAgent: Record<string, number>;
+}
+//# sourceMappingURL=cost-tracking.d.ts.map

package/dist/types/cost-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracking.d.ts","sourceRoot":"","sources":["../../src/types/cost-tracking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/types/cost-tracking.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for Cost Tracking system
+ *
+ * Tracks token usage and costs per session, agent, model, and increment.
+ * Calculates savings vs all-Sonnet baseline.
+ */
+export {};
+//# sourceMappingURL=cost-tracking.js.map

package/dist/types/cost-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracking.js","sourceRoot":"","sources":["../../src/types/cost-tracking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/model-selection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Type definitions for the Intelligent Model Selection system
+ *
+ * This system automatically routes work to the optimal AI model based on:
+ * - Agent preferences (planning vs execution agents)
+ * - Phase detection (planning vs execution vs review)
+ * - User overrides (manual model selection)
+ *
+ * Achieves 60-70% cost savings by using Haiku for execution, Sonnet for planning.
+ */
+/**
+ * Available AI models
+ * - sonnet: Latest Sonnet 4.5 (planning, complex analysis)
+ * - haiku: Latest Haiku 4.5 (execution, simple tasks)
+ * - opus: Latest Opus (rare, critical decisions)
+ * - auto: System decides based on context
+ */
+export type Model = 'sonnet' | 'haiku' | 'opus' | 'auto';
+/**
+ * Work phases for phase detection
+ */
+export type Phase = 'planning' | 'execution' | 'review';
+/**
+ * Cost profiles for agents
+ */
+export type CostProfile = 'planning' | 'execution' | 'hybrid';
+/**
+ * Fallback behavior when preferred model fails
+ */
+export type FallbackBehavior = 'strict' | 'flexible' | 'auto';
+/**
+ * Agent model preference loaded from AGENT.md frontmatter
+ */
+export interface AgentModelPreference {
+    agent: string;
+    preference: Model;
+    profile: CostProfile;
+    fallback: FallbackBehavior;
+}
+/**
+ * Model selection decision with reasoning
+ */
+export interface ModelSelectionDecision {
+    model: Exclude<Model, 'auto'>;
+    reason: 'user_override' | 'agent_preference' | 'phase_detection' | 'low_confidence_default' | 'cost_policy' | 'fallback';
+    confidence?: number;
+    reasoning: string;
+    alternatives?: Array<{
+        model: Model;
+        score: number;
+    }>;
+}
+//# sourceMappingURL=model-selection.d.ts.map

package/dist/types/model-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,aAAa,GAAG,UAAU,CAAC;IACzH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/dist/types/model-selection.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for the Intelligent Model Selection system
+ *
+ * This system automatically routes work to the optimal AI model based on:
+ * - Agent preferences (planning vs execution agents)
+ * - Phase detection (planning vs execution vs review)
+ * - User overrides (manual model selection)
+ *
+ * Achieves 60-70% cost savings by using Haiku for execution, Sonnet for planning.
+ */
+export {};
+//# sourceMappingURL=model-selection.js.map

package/dist/types/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/utils/cost-reporter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Cost Report Generation
+ *
+ * Generates human-readable cost reports with multiple export formats:
+ * - JSON (machine-readable)
+ * - CSV (spreadsheet import)
+ * - ASCII Dashboard (CLI display)
+ */
+import type { CostTracker } from '../core/cost-tracker';
+import type { IncrementCostReport } from '../types/cost-tracking';
+export declare class CostReporter {
+    private costTracker;
+    constructor(costTracker: CostTracker);
+    /**
+     * Generate cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    generateIncrementReport(incrementId: string): IncrementCostReport;
+    /**
+     * Export report to JSON file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    exportToJSON(incrementId: string, outputPath: string): Promise<void>;
+    /**
+     * Export report to CSV file
+     *
+     * @param incrementId - Increment ID
+     * @param outputPath - Output file path
+     */
+    exportToCSV(incrementId: string, outputPath: string): Promise<void>;
+    /**
+     * Generate ASCII dashboard for CLI display
+     *
+     * @param incrementId - Optional increment ID (defaults to all increments)
+     * @returns ASCII table with cost breakdown
+     */
+    generateDashboard(incrementId?: string): string;
+    /**
+     * Generate dashboard for a specific increment
+     */
+    private generateIncrementDashboard;
+    /**
+     * Generate dashboard for all increments
+     */
+    private generateOverallDashboard;
+    /**
+     * Generate compact one-line summary
+     *
+     * @param incrementId - Optional increment ID
+     * @returns One-line summary string
+     */
+    generateSummaryLine(incrementId?: string): string;
+}
+//# sourceMappingURL=cost-reporter.d.ts.map

package/dist/utils/cost-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-reporter.d.ts","sourceRoot":"","sources":["../../src/utils/cost-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,qBAAa,YAAY;IACX,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;;;;OAKG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB;IAIjE;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCzE;;;;;OAKG;IACH,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA8FlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmEhC;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;CASlD"}