specweave 0.11.0 → 0.12.0

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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"}