specweave 0.3.12 → 0.4.0

package/dist/core/cost-tracker.js

@@ -0,0 +1,281 @@
+/**
+ * Cost Tracker Service
+ *
+ * Real-time cost tracking for agent executions. Tracks token usage, calculates
+ * costs, aggregates by increment, and calculates savings vs baseline (Sonnet-only).
+ *
+ * Persistence: Stores data in .specweave/logs/costs.json
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { calculateCost, calculateSavings } from '../utils/pricing-constants';
+const DEFAULT_LOG_PATH = '.specweave/logs/costs.json';
+export class CostTracker {
+    constructor(config = {}) {
+        this.sessions = new Map();
+        this.currentSessionId = null;
+        this.logPath = config.logPath || DEFAULT_LOG_PATH;
+        this.autoSave = config.autoSave !== false; // Default true
+    }
+    /**
+     * Start a new tracking session
+     *
+     * @param agent - Agent name (e.g., 'pm', 'frontend')
+     * @param model - Model used ('sonnet', 'haiku', 'opus')
+     * @param increment - Optional increment ID (e.g., '0003')
+     * @param command - Optional command that triggered this (e.g., '/specweave.inc')
+     * @returns Session ID
+     */
+    startSession(agent, model, increment, command) {
+        const sessionId = this.generateSessionId();
+        const session = {
+            sessionId,
+            agent,
+            model,
+            increment,
+            command,
+            startedAt: new Date().toISOString(),
+            tokenUsage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                totalTokens: 0,
+            },
+            cost: 0,
+            savings: 0,
+        };
+        this.sessions.set(sessionId, session);
+        this.currentSessionId = sessionId;
+        return sessionId;
+    }
+    /**
+     * Record token usage for current session
+     *
+     * @param inputTokens - Number of input tokens
+     * @param outputTokens - Number of output tokens
+     * @param sessionId - Optional session ID (defaults to current)
+     */
+    recordTokens(inputTokens, outputTokens, sessionId) {
+        const id = sessionId || this.currentSessionId;
+        if (!id) {
+            throw new Error('No active session. Call startSession() first.');
+        }
+        const session = this.sessions.get(id);
+        if (!session) {
+            throw new Error(`Session ${id} not found`);
+        }
+        // Update token usage
+        session.tokenUsage.inputTokens += inputTokens;
+        session.tokenUsage.outputTokens += outputTokens;
+        session.tokenUsage.totalTokens += inputTokens + outputTokens;
+        // Recalculate cost
+        session.cost = calculateCost(session.model, session.tokenUsage.inputTokens, session.tokenUsage.outputTokens);
+        // Calculate savings vs Sonnet baseline
+        session.savings = calculateSavings(session.model, session.tokenUsage.inputTokens, session.tokenUsage.outputTokens);
+    }
+    /**
+     * End current session
+     *
+     * @param sessionId - Optional session ID (defaults to current)
+     */
+    endSession(sessionId) {
+        const id = sessionId || this.currentSessionId;
+        if (!id) {
+            throw new Error('No active session to end');
+        }
+        const session = this.sessions.get(id);
+        if (!session) {
+            throw new Error(`Session ${id} not found`);
+        }
+        session.endedAt = new Date().toISOString();
+        if (this.autoSave) {
+            this.saveToDisk();
+        }
+        // Clear current session if it's the one we just ended
+        if (this.currentSessionId === id) {
+            this.currentSessionId = null;
+        }
+    }
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get current session
+     */
+    getCurrentSession() {
+        return this.currentSessionId
+            ? this.sessions.get(this.currentSessionId)
+            : undefined;
+    }
+    /**
+     * Get all sessions for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Array of sessions for this increment
+     */
+    getIncrementSessions(incrementId) {
+        return Array.from(this.sessions.values()).filter((s) => s.increment === incrementId);
+    }
+    /**
+     * Get cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    getIncrementCost(incrementId) {
+        const sessions = this.getIncrementSessions(incrementId);
+        if (sessions.length === 0) {
+            return {
+                incrementId,
+                totalCost: 0,
+                totalSavings: 0,
+                totalTokens: 0,
+                sessionCount: 0,
+                costByModel: {},
+                costByAgent: {},
+            };
+        }
+        const report = {
+            incrementId,
+            totalCost: 0,
+            totalSavings: 0,
+            totalTokens: 0,
+            sessionCount: sessions.length,
+            costByModel: {},
+            costByAgent: {},
+        };
+        for (const session of sessions) {
+            // Aggregate totals
+            report.totalCost += session.cost;
+            report.totalSavings += session.savings;
+            report.totalTokens += session.tokenUsage.totalTokens;
+            // Aggregate by model
+            if (!report.costByModel[session.model]) {
+                report.costByModel[session.model] = 0;
+            }
+            report.costByModel[session.model] += session.cost;
+            // Aggregate by agent
+            if (!report.costByAgent[session.agent]) {
+                report.costByAgent[session.agent] = 0;
+            }
+            report.costByAgent[session.agent] += session.cost;
+        }
+        return report;
+    }
+    /**
+     * Get total cost across all sessions
+     */
+    getTotalCost() {
+        return Array.from(this.sessions.values()).reduce((sum, session) => sum + session.cost, 0);
+    }
+    /**
+     * Get total savings across all sessions
+     */
+    getTotalSavings() {
+        return Array.from(this.sessions.values()).reduce((sum, session) => sum + session.savings, 0);
+    }
+    /**
+     * Get all sessions
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clearSessions() {
+        this.sessions.clear();
+        this.currentSessionId = null;
+    }
+    /**
+     * Save sessions to disk
+     */
+    async saveToDisk() {
+        try {
+            const data = {
+                version: '1.0',
+                savedAt: new Date().toISOString(),
+                sessions: Array.from(this.sessions.entries()).map(([id, session]) => ({
+                    ...session,
+                    sessionId: id,
+                })),
+            };
+            await fs.ensureDir(path.dirname(this.logPath));
+            await fs.writeJson(this.logPath, data, { spaces: 2 });
+        }
+        catch (error) {
+            throw new Error(`Failed to save cost data: ${error.message}`);
+        }
+    }
+    /**
+     * Load sessions from disk
+     */
+    async loadFromDisk() {
+        try {
+            if (!(await fs.pathExists(this.logPath))) {
+                // No data file yet, that's ok
+                return;
+            }
+            const data = await fs.readJson(this.logPath);
+            // Validate version (for future migrations)
+            if (data.version !== '1.0') {
+                throw new Error(`Unsupported cost data version: ${data.version}`);
+            }
+            // Load sessions
+            this.sessions.clear();
+            for (const session of data.sessions) {
+                this.sessions.set(session.sessionId, session);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to load cost data: ${error.message}`);
+        }
+    }
+    /**
+     * Generate unique session ID
+     */
+    generateSessionId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 9);
+        return `session_${timestamp}_${random}`;
+    }
+    /**
+     * Get summary statistics
+     */
+    getSummary() {
+        const sessions = this.getAllSessions();
+        if (sessions.length === 0) {
+            return {
+                totalSessions: 0,
+                totalCost: 0,
+                totalSavings: 0,
+                savingsPercentage: 0,
+                mostExpensiveAgent: null,
+                cheapestAgent: null,
+            };
+        }
+        const totalCost = this.getTotalCost();
+        const totalSavings = this.getTotalSavings();
+        const baselineCost = totalCost + totalSavings;
+        // Calculate by agent
+        const agentCosts = {};
+        for (const session of sessions) {
+            if (!agentCosts[session.agent]) {
+                agentCosts[session.agent] = 0;
+            }
+            agentCosts[session.agent] += session.cost;
+        }
+        const sortedAgents = Object.entries(agentCosts).sort(([, a], [, b]) => b - a);
+        return {
+            totalSessions: sessions.length,
+            totalCost,
+            totalSavings,
+            savingsPercentage: baselineCost > 0 ? (totalSavings / baselineCost) * 100 : 0,
+            mostExpensiveAgent: sortedAgents[0]?.[0] || null,
+            cheapestAgent: sortedAgents[sortedAgents.length - 1]?.[0] || null,
+        };
+    }
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/core/cost-tracker.js.map

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

package/dist/core/model-selector.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Model Selector
+ *
+ * Decision engine that combines agent preferences + phase detection to select
+ * the optimal AI model for each task.
+ *
+ * Decision hierarchy:
+ * 1. User override (--model flag) - Always wins
+ * 2. Agent preference (from AGENT.md) - Used when not 'auto'
+ * 3. Phase detection - Used for 'auto' agents with high confidence
+ * 4. Safe default (Sonnet) - Used when confidence is low
+ *
+ * Achieves 60-70% cost savings by routing execution to Haiku.
+ */
+import type { Model, ModelSelectionDecision } from '../types/model-selection';
+import type { ExecutionContext } from './phase-detector';
+import { AgentModelManager } from './agent-model-manager';
+import { PhaseDetector } from './phase-detector';
+export interface ModelSelectionConfig {
+    mode: 'auto' | 'balanced' | 'manual';
+    forceModel?: Exclude<Model, 'auto'>;
+    highConfidenceThreshold: number;
+    mediumConfidenceThreshold: number;
+    defaultPlanningModel: 'sonnet' | 'opus';
+    defaultExecutionModel: 'haiku' | 'sonnet';
+    defaultReviewModel: 'sonnet' | 'opus';
+    logDecisions: boolean;
+    showReasoning: boolean;
+}
+export declare class ModelSelector {
+    private agentModelManager;
+    private phaseDetector;
+    private config;
+    constructor(agentModelManager: AgentModelManager, phaseDetector: PhaseDetector, config?: Partial<ModelSelectionConfig>);
+    /**
+     * Select optimal model for a given task
+     *
+     * @param prompt - User's prompt/task description
+     * @param agent - Agent name (e.g., 'pm', 'frontend', 'architect')
+     * @param context - Execution context (command, increment state, etc.)
+     * @returns Model selection decision with reasoning
+     */
+    select(prompt: string, agent: string, context?: ExecutionContext): ModelSelectionDecision;
+    /**
+     * Log model selection decision (if logging enabled)
+     */
+    logDecision(decision: ModelSelectionDecision, agent: string): void;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<ModelSelectionConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ModelSelectionConfig;
+}
+//# sourceMappingURL=model-selector.d.ts.map

package/dist/core/model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.d.ts","sourceRoot":"","sources":["../../src/core/model-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAS,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,oBAAoB,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxC,qBAAqB,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,kBAAkB,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAsBD,qBAAa,aAAa;IACxB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAuB;gBAGnC,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAO5C;;;;;;;OAOG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,sBAAsB;IA8CzB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAalE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACH,SAAS,IAAI,oBAAoB;CAGlC"}

package/dist/core/model-selector.js

@@ -0,0 +1,115 @@
+/**
+ * Model Selector
+ *
+ * Decision engine that combines agent preferences + phase detection to select
+ * the optimal AI model for each task.
+ *
+ * Decision hierarchy:
+ * 1. User override (--model flag) - Always wins
+ * 2. Agent preference (from AGENT.md) - Used when not 'auto'
+ * 3. Phase detection - Used for 'auto' agents with high confidence
+ * 4. Safe default (Sonnet) - Used when confidence is low
+ *
+ * Achieves 60-70% cost savings by routing execution to Haiku.
+ */
+const DEFAULT_CONFIG = {
+    mode: 'auto',
+    highConfidenceThreshold: 0.7,
+    mediumConfidenceThreshold: 0.4,
+    defaultPlanningModel: 'sonnet',
+    defaultExecutionModel: 'haiku',
+    defaultReviewModel: 'sonnet',
+    logDecisions: true,
+    showReasoning: true,
+};
+/**
+ * Phase-to-model mapping (when agent is 'auto')
+ */
+const PHASE_MODEL_MAP = {
+    planning: 'sonnet',
+    execution: 'haiku',
+    review: 'sonnet',
+};
+export class ModelSelector {
+    constructor(agentModelManager, phaseDetector, config = {}) {
+        this.agentModelManager = agentModelManager;
+        this.phaseDetector = phaseDetector;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Select optimal model for a given task
+     *
+     * @param prompt - User's prompt/task description
+     * @param agent - Agent name (e.g., 'pm', 'frontend', 'architect')
+     * @param context - Execution context (command, increment state, etc.)
+     * @returns Model selection decision with reasoning
+     */
+    select(prompt, agent, context = {}) {
+        // Step 1: Check explicit user override
+        if (this.config.forceModel) {
+            return {
+                model: this.config.forceModel,
+                reason: 'user_override',
+                reasoning: `User explicitly forced ${this.config.forceModel} model via --model flag`,
+            };
+        }
+        // Step 2: Load agent preference
+        const agentPref = this.agentModelManager.getPreferredModel(agent);
+        const costProfile = this.agentModelManager.getCostProfile(agent);
+        // If agent has explicit preference (not 'auto'), use it
+        if (agentPref !== 'auto') {
+            return {
+                model: agentPref,
+                reason: 'agent_preference',
+                reasoning: `Agent '${agent}' prefers ${agentPref} for ${costProfile} work`,
+            };
+        }
+        // Step 3: Detect phase (for 'auto' agents)
+        const phaseDetection = this.phaseDetector.detect(prompt, context);
+        // Step 4: Apply decision matrix based on confidence
+        if (phaseDetection.confidence >= this.config.highConfidenceThreshold) {
+            // High confidence - use phase-based model
+            return {
+                model: PHASE_MODEL_MAP[phaseDetection.phase],
+                reason: 'phase_detection',
+                confidence: phaseDetection.confidence,
+                reasoning: phaseDetection.reasoning,
+            };
+        }
+        // Step 5: Low confidence - default to Sonnet for safety
+        return {
+            model: 'sonnet',
+            reason: 'low_confidence_default',
+            confidence: phaseDetection.confidence,
+            reasoning: `Low confidence (${(phaseDetection.confidence * 100).toFixed(0)}%), defaulting to Sonnet for safety. Detected: ${phaseDetection.reasoning}`,
+        };
+    }
+    /**
+     * Log model selection decision (if logging enabled)
+     */
+    logDecision(decision, agent) {
+        if (!this.config.logDecisions)
+            return;
+        const timestamp = new Date().toISOString();
+        const logMessage = `[${timestamp}] [Model Selection] Agent: ${agent} → ${decision.model} (${decision.reason})`;
+        if (this.config.showReasoning) {
+            console.log(`${logMessage}\n  Reasoning: ${decision.reasoning}`);
+        }
+        else {
+            console.log(logMessage);
+        }
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=model-selector.js.map

package/dist/core/model-selector.js.map

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

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

@@ -0,0 +1,62 @@
+/**
+ * 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%
+ */
+import type { Phase } from '../types/model-selection';
+export interface PhaseDetectionResult {
+    phase: Phase;
+    confidence: number;
+    signals: {
+        keywords: string[];
+        command?: string;
+        context: string[];
+    };
+    reasoning: string;
+}
+export interface ExecutionContext {
+    command?: string;
+    incrementState?: 'backlog' | 'planned' | 'in-progress' | 'completed' | 'closed';
+    previousPhases?: Phase[];
+    filesModified?: string[];
+}
+export declare class PhaseDetector {
+    private readonly planningKeywords;
+    private readonly executionKeywords;
+    private readonly reviewKeywords;
+    private readonly commandPhaseMap;
+    /**
+     * Detect phase from user prompt and execution context
+     */
+    detect(prompt: string, context?: ExecutionContext): PhaseDetectionResult;
+    /**
+     * Analyze keywords in prompt
+     */
+    private analyzeKeywords;
+    /**
+     * Analyze command hints
+     */
+    private analyzeCommand;
+    /**
+     * Analyze execution context
+     */
+    private analyzeContext;
+    /**
+     * Analyze explicit hints in prompt
+     */
+    private analyzeHints;
+    /**
+     * Generate human-readable reasoning
+     */
+    private generateReasoning;
+}
+//# sourceMappingURL=phase-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase-detector.d.ts","sourceRoot":"","sources":["../../src/core/phase-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAChF,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAK/B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAGF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAU9B;IAEF;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,oBAAoB;IA4C5E;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuDtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuC1B"}