specweave 0.17.0 → 0.17.1

package/dist/core/comment-builder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Comment Builder for External Tool Sync
+ *
+ * Generates formatted comments for posting to external tools
+ * (GitHub, JIRA, Azure DevOps) with commit/PR links and summaries.
+ */
+import { GitCommit, GitRepository, PullRequest } from '../utils/git-utils.js';
+import { Task, UserStory } from './spec-task-mapper.js';
+export interface CommentContent {
+    userStory: UserStory;
+    tasks: Task[];
+    commits: GitCommit[];
+    pullRequests: PullRequest[];
+    summary: string;
+}
+export interface FormattedComment {
+    markdown: string;
+    html?: string;
+    plain?: string;
+}
+/**
+ * Build comment for completed user story
+ */
+export declare function buildUserStoryComment(content: CommentContent, repo: GitRepository): FormattedComment;
+/**
+ * Build short summary comment (for quick updates)
+ */
+export declare function buildShortComment(commits: GitCommit[], repo: GitRepository, summary?: string): FormattedComment;
+/**
+ * Build comment for multiple commits (batch update)
+ */
+export declare function buildCommitBatchComment(commits: GitCommit[], repo: GitRepository, groupByDate?: boolean): FormattedComment;
+/**
+ * Build comment for PR merge
+ */
+export declare function buildPRMergeComment(pr: PullRequest, commits: GitCommit[], repo: GitRepository): FormattedComment;
+/**
+ * Generate smart summary from commits
+ */
+export declare function generateSmartSummary(commits: GitCommit[], tasks: Task[]): string;
+/**
+ * Format comment for JIRA (converts markdown to JIRA markup)
+ */
+export declare function formatForJira(comment: FormattedComment): string;
+/**
+ * Format comment for Azure DevOps (HTML)
+ */
+export declare function formatForAdo(comment: FormattedComment): string;
+/**
+ * Validate comment size (some platforms have limits)
+ */
+export declare function validateCommentSize(comment: FormattedComment, maxLength?: number): boolean;
+/**
+ * Truncate comment if too long
+ */
+export declare function truncateComment(comment: FormattedComment, maxLength?: number): FormattedComment;
+//# sourceMappingURL=comment-builder.d.ts.map

package/dist/core/comment-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-builder.d.ts","sourceRoot":"","sources":["../../src/core/comment-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAwDlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,CAsBlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,WAAW,GAAE,OAAc,GAC1B,gBAAgB,CA8ClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAyBlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,IAAI,EAAE,GACZ,MAAM,CAoCR;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuB/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,gBAAgB,CAYlB"}

package/dist/core/comment-builder.js

@@ -0,0 +1,239 @@
+/**
+ * Comment Builder for External Tool Sync
+ *
+ * Generates formatted comments for posting to external tools
+ * (GitHub, JIRA, Azure DevOps) with commit/PR links and summaries.
+ */
+/**
+ * Build comment for completed user story
+ */
+export function buildUserStoryComment(content, repo) {
+    const { userStory, tasks, commits, pullRequests } = content;
+    // Build markdown comment
+    let markdown = `## ✅ ${userStory.id}: ${userStory.title}\n\n`;
+    // Add summary
+    if (content.summary) {
+        markdown += `${content.summary}\n\n`;
+    }
+    // Add completed tasks
+    if (tasks.length > 0) {
+        markdown += `**Completed Tasks:**\n`;
+        for (const task of tasks) {
+            markdown += `- ${task.id}: ${task.title}\n`;
+        }
+        markdown += '\n';
+    }
+    // Add commits
+    if (commits.length > 0) {
+        markdown += `**Commits:**\n`;
+        for (const commit of commits) {
+            const url = commit.url || `${repo.url}/commit/${commit.sha}`;
+            const shortMsg = commit.message.split('\n')[0].substring(0, 60);
+            markdown += `- [\`${commit.shortSha}\`](${url}) ${shortMsg}\n`;
+        }
+        markdown += '\n';
+    }
+    // Add pull requests
+    if (pullRequests.length > 0) {
+        markdown += `**Pull Requests:**\n`;
+        for (const pr of pullRequests) {
+            markdown += `- [#${pr.number}](${pr.url}) ${pr.title} (${pr.state})\n`;
+        }
+        markdown += '\n';
+    }
+    // Add acceptance criteria
+    const completedACs = userStory.acceptanceCriteria.filter(ac => ac.completed);
+    if (completedACs.length > 0) {
+        markdown += `**Acceptance Criteria:**\n`;
+        for (const ac of completedACs) {
+            markdown += `- ✓ ${ac.id}: ${ac.description}\n`;
+        }
+        markdown += '\n';
+    }
+    markdown += `---\n🤖 _Auto-generated by SpecWeave_`;
+    return {
+        markdown,
+        plain: markdownToPlainText(markdown),
+    };
+}
+/**
+ * Build short summary comment (for quick updates)
+ */
+export function buildShortComment(commits, repo, summary) {
+    let markdown = '';
+    if (summary) {
+        markdown += `${summary}\n\n`;
+    }
+    if (commits.length > 0) {
+        markdown += `**Commits:**\n`;
+        for (const commit of commits) {
+            const url = commit.url || `${repo.url}/commit/${commit.sha}`;
+            const shortMsg = commit.message.split('\n')[0].substring(0, 60);
+            markdown += `- [\`${commit.shortSha}\`](${url}) ${shortMsg}\n`;
+        }
+    }
+    markdown += `\n---\n🤖 _Auto-generated by SpecWeave_`;
+    return {
+        markdown,
+        plain: markdownToPlainText(markdown),
+    };
+}
+/**
+ * Build comment for multiple commits (batch update)
+ */
+export function buildCommitBatchComment(commits, repo, groupByDate = true) {
+    let markdown = `## 🔄 Recent Updates\n\n`;
+    if (groupByDate) {
+        // Group commits by date
+        const commitsByDate = new Map();
+        for (const commit of commits) {
+            const dateKey = commit.date.toISOString().split('T')[0];
+            if (!commitsByDate.has(dateKey)) {
+                commitsByDate.set(dateKey, []);
+            }
+            commitsByDate.get(dateKey).push(commit);
+        }
+        // Sort dates descending
+        const sortedDates = Array.from(commitsByDate.keys()).sort().reverse();
+        for (const date of sortedDates) {
+            markdown += `### ${date}\n\n`;
+            const dateCommits = commitsByDate.get(date);
+            for (const commit of dateCommits) {
+                const url = commit.url || `${repo.url}/commit/${commit.sha}`;
+                const shortMsg = commit.message.split('\n')[0].substring(0, 60);
+                markdown += `- [\`${commit.shortSha}\`](${url}) ${shortMsg} _by ${commit.author}_\n`;
+            }
+            markdown += '\n';
+        }
+    }
+    else {
+        // Simple list
+        for (const commit of commits) {
+            const url = commit.url || `${repo.url}/commit/${commit.sha}`;
+            const shortMsg = commit.message.split('\n')[0].substring(0, 60);
+            markdown += `- [\`${commit.shortSha}\`](${url}) ${shortMsg}\n`;
+        }
+        markdown += '\n';
+    }
+    markdown += `---\n🤖 _Auto-generated by SpecWeave_`;
+    return {
+        markdown,
+        plain: markdownToPlainText(markdown),
+    };
+}
+/**
+ * Build comment for PR merge
+ */
+export function buildPRMergeComment(pr, commits, repo) {
+    let markdown = `## 🎉 Merged: [#${pr.number}](${pr.url})\n\n`;
+    markdown += `${pr.title}\n\n`;
+    if (commits.length > 0) {
+        markdown += `**Commits (${commits.length}):**\n`;
+        for (const commit of commits.slice(0, 10)) { // Limit to 10
+            const url = commit.url || `${repo.url}/commit/${commit.sha}`;
+            const shortMsg = commit.message.split('\n')[0].substring(0, 60);
+            markdown += `- [\`${commit.shortSha}\`](${url}) ${shortMsg}\n`;
+        }
+        if (commits.length > 10) {
+            markdown += `\n_...and ${commits.length - 10} more commits_\n`;
+        }
+        markdown += '\n';
+    }
+    markdown += `---\n🤖 _Auto-generated by SpecWeave_`;
+    return {
+        markdown,
+        plain: markdownToPlainText(markdown),
+    };
+}
+/**
+ * Generate smart summary from commits
+ */
+export function generateSmartSummary(commits, tasks) {
+    if (commits.length === 0) {
+        return 'Work completed';
+    }
+    // Analyze commit messages for common patterns
+    const messages = commits.map(c => c.message.toLowerCase());
+    const patterns = {
+        feat: messages.filter(m => m.startsWith('feat:')).length,
+        fix: messages.filter(m => m.startsWith('fix:')).length,
+        docs: messages.filter(m => m.startsWith('docs:')).length,
+        refactor: messages.filter(m => m.startsWith('refactor:')).length,
+        test: messages.filter(m => m.startsWith('test:')).length,
+        chore: messages.filter(m => m.startsWith('chore:')).length,
+    };
+    const sortedPatterns = Object.entries(patterns)
+        .filter(([_, count]) => count > 0)
+        .sort(([_, a], [__, b]) => b - a);
+    if (sortedPatterns.length === 0) {
+        return `Completed ${tasks.length} task(s) with ${commits.length} commit(s)`;
+    }
+    const [topPattern, topCount] = sortedPatterns[0];
+    const patternNames = {
+        feat: 'New features',
+        fix: 'Bug fixes',
+        docs: 'Documentation updates',
+        refactor: 'Code refactoring',
+        test: 'Test improvements',
+        chore: 'Maintenance work',
+    };
+    return `${patternNames[topPattern]} (${topCount} commit${topCount > 1 ? 's' : ''})`;
+}
+/**
+ * Convert markdown to plain text (strip markdown formatting)
+ */
+function markdownToPlainText(markdown) {
+    return markdown
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Links
+        .replace(/[*_`#]/g, '') // Formatting
+        .replace(/---/g, '---') // Horizontal rules
+        .replace(/\n{3,}/g, '\n\n'); // Multiple newlines
+}
+/**
+ * Format comment for JIRA (converts markdown to JIRA markup)
+ */
+export function formatForJira(comment) {
+    let jira = comment.markdown;
+    // Convert markdown headers to JIRA
+    jira = jira.replace(/^## (.+)$/gm, 'h2. $1');
+    jira = jira.replace(/^### (.+)$/gm, 'h3. $1');
+    // Convert markdown links to JIRA
+    jira = jira.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '[$1|$2]');
+    // Convert markdown code to JIRA
+    jira = jira.replace(/`([^`]+)`/g, '{{$1}}');
+    // Convert markdown lists to JIRA
+    jira = jira.replace(/^- (.+)$/gm, '* $1');
+    // Convert bold
+    jira = jira.replace(/\*\*([^*]+)\*\*/g, '*$1*');
+    // Convert italic
+    jira = jira.replace(/\*([^*]+)\*/g, '_$1_');
+    return jira;
+}
+/**
+ * Format comment for Azure DevOps (HTML)
+ */
+export function formatForAdo(comment) {
+    // Azure DevOps supports markdown in comments
+    return comment.markdown;
+}
+/**
+ * Validate comment size (some platforms have limits)
+ */
+export function validateCommentSize(comment, maxLength = 5000) {
+    return comment.markdown.length <= maxLength;
+}
+/**
+ * Truncate comment if too long
+ */
+export function truncateComment(comment, maxLength = 5000) {
+    if (comment.markdown.length <= maxLength) {
+        return comment;
+    }
+    const truncated = comment.markdown.substring(0, maxLength - 50);
+    const markdown = truncated + '\n\n_...truncated_\n\n---\n🤖 _Auto-generated by SpecWeave_';
+    return {
+        markdown,
+        plain: comment.plain ? comment.plain.substring(0, maxLength - 50) : undefined,
+    };
+}
+//# sourceMappingURL=comment-builder.js.map

package/dist/core/comment-builder.js.map

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