specweave 0.11.0 → 0.12.0

package/dist/plugins/specweave/lib/hooks/reflection-parser.js

@@ -0,0 +1,419 @@
+/**
+ * Reflection Parser
+ *
+ * Parses markdown output from reflective-reviewer agent
+ * Extracts structured data (issues, metrics, lessons learned, etc.)
+ *
+ * @module reflection-parser
+ */
+import { IssueSeverity, IssueCategory, ReflectionModel } from './types/reflection-types';
+/**
+ * Extract section content by heading
+ * @param markdown Markdown content
+ * @param heading Section heading to find (e.g., "## What Was Accomplished")
+ * @returns Section content (text after heading until next heading or end)
+ */
+function extractSection(markdown, heading) {
+    const headingRegex = new RegExp(`^${heading}\\s*$`, 'mi');
+    const match = markdown.match(headingRegex);
+    if (!match || match.index === undefined) {
+        return '';
+    }
+    const startIndex = match.index + match[0].length;
+    const afterHeading = markdown.slice(startIndex);
+    // Find next heading at same or higher level
+    const nextHeadingMatch = afterHeading.match(/^#{1,3}\s+/m);
+    const endIndex = nextHeadingMatch?.index ?? afterHeading.length;
+    return afterHeading.slice(0, endIndex).trim();
+}
+/**
+ * Parse accomplishments from "What Was Accomplished" section
+ * @param markdown Reflection markdown
+ * @returns Array of accomplishment strings
+ */
+function parseAccomplishments(markdown) {
+    const section = extractSection(markdown, '## ✅ What Was Accomplished');
+    if (!section)
+        return [];
+    // Extract bullet points and paragraphs
+    const lines = section.split('\n').filter(line => line.trim());
+    const accomplishments = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Match bullet points (-, *, +) or numbered lists (1., 2.)
+        if (/^[-*+]\s+/.test(trimmed) || /^\d+\.\s+/.test(trimmed)) {
+            accomplishments.push(trimmed.replace(/^[-*+\d.]\s+/, '').trim());
+        }
+        else if (trimmed.length > 10 && !trimmed.startsWith('#')) {
+            // Include non-heading paragraphs
+            accomplishments.push(trimmed);
+        }
+    }
+    return accomplishments;
+}
+/**
+ * Parse strengths from "Quality Assessment" section
+ * @param markdown Reflection markdown
+ * @returns Array of strength strings
+ */
+function parseStrengths(markdown) {
+    const section = extractSection(markdown, '### ✅ Strengths');
+    if (!section)
+        return [];
+    const lines = section.split('\n').filter(line => line.trim());
+    const strengths = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('- ✅') || trimmed.startsWith('✅')) {
+            strengths.push(trimmed.replace(/^[-*+]?\s*✅\s*/, '').trim());
+        }
+    }
+    return strengths;
+}
+/**
+ * Parse severity from issue description
+ * @param text Issue text (e.g., "**CRITICAL (SECURITY)**")
+ * @returns Issue severity enum or undefined
+ */
+function parseSeverity(text) {
+    if (/CRITICAL/i.test(text))
+        return IssueSeverity.CRITICAL;
+    if (/HIGH/i.test(text))
+        return IssueSeverity.HIGH;
+    if (/MEDIUM/i.test(text))
+        return IssueSeverity.MEDIUM;
+    if (/LOW/i.test(text))
+        return IssueSeverity.LOW;
+    return undefined;
+}
+/**
+ * Parse category from issue description
+ * @param text Issue text (e.g., "**CRITICAL (SECURITY)**")
+ * @returns Issue category enum or undefined
+ */
+function parseCategory(text) {
+    if (/SECURITY/i.test(text))
+        return IssueCategory.SECURITY;
+    if (/QUALITY/i.test(text))
+        return IssueCategory.QUALITY;
+    if (/TESTING/i.test(text))
+        return IssueCategory.TESTING;
+    if (/PERFORMANCE/i.test(text))
+        return IssueCategory.PERFORMANCE;
+    if (/TECHNICAL[_\s]DEBT/i.test(text))
+        return IssueCategory.TECHNICAL_DEBT;
+    return undefined;
+}
+/**
+ * Parse location from issue text
+ * @param text Issue text (may contain **Location**: `path/to/file.ts:123`)
+ * @returns Location object or undefined
+ */
+function parseLocation(text) {
+    // Match: **Location**: `path/to/file.ts:123`
+    const locationMatch = text.match(/\*\*Location\*\*:\s*`([^`]+)`/i);
+    if (!locationMatch)
+        return undefined;
+    const locationStr = locationMatch[1];
+    const [file, lineStr] = locationStr.split(':');
+    const line = lineStr ? parseInt(lineStr, 10) : undefined;
+    return {
+        file: file.trim(),
+        line
+    };
+}
+/**
+ * Parse issues from "Issues Identified" section
+ * @param markdown Reflection markdown
+ * @returns Array of ReflectionIssue objects
+ */
+function parseIssues(markdown) {
+    const section = extractSection(markdown, '### ⚠️ Issues Identified');
+    if (!section)
+        return [];
+    const issues = [];
+    const lines = section.split('\n');
+    let currentIssue = null;
+    let currentField = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check for severity/category header (e.g., "**CRITICAL (SECURITY)**")
+        const headerMatch = trimmed.match(/^\*\*(CRITICAL|HIGH|MEDIUM|LOW)\s*\(([^)]+)\)\*\*/i);
+        if (headerMatch) {
+            // Save previous issue
+            if (currentIssue && currentIssue.severity && currentIssue.category && currentIssue.description) {
+                issues.push(currentIssue);
+            }
+            // Start new issue
+            currentIssue = {
+                severity: parseSeverity(headerMatch[1]),
+                category: parseCategory(headerMatch[2]),
+                description: '',
+                impact: '',
+                recommendation: ''
+            };
+            currentField = null;
+            continue;
+        }
+        // Check for issue bullet point (❌ or ⚠️)
+        if ((trimmed.startsWith('- ❌') || trimmed.startsWith('❌') || trimmed.startsWith('- ⚠️')) && currentIssue) {
+            currentField = 'description';
+            const descText = trimmed.replace(/^[-*+]?\s*[❌⚠️]\s*/, '').trim();
+            currentIssue.description = descText;
+            continue;
+        }
+        // Check for Impact field
+        if (trimmed.startsWith('- **Impact**:') || trimmed.startsWith('**Impact**:')) {
+            currentField = 'impact';
+            const impactText = trimmed.replace(/^[-*+]?\s*\*\*Impact\*\*:\s*/, '').trim();
+            if (currentIssue)
+                currentIssue.impact = impactText;
+            continue;
+        }
+        // Check for Recommendation field
+        if (trimmed.startsWith('- **Recommendation**:') || trimmed.startsWith('**Recommendation**:')) {
+            currentField = 'recommendation';
+            const recText = trimmed.replace(/^[-*+]?\s*\*\*Recommendation\*\*:\s*/, '').trim();
+            if (currentIssue)
+                currentIssue.recommendation = recText;
+            continue;
+        }
+        // Check for Location field
+        if (trimmed.startsWith('- **Location**:') || trimmed.startsWith('**Location**:')) {
+            if (currentIssue) {
+                const location = parseLocation(trimmed);
+                if (location)
+                    currentIssue.location = location;
+            }
+            currentField = null;
+            continue;
+        }
+        // Append continuation lines to current field
+        if (currentField && currentIssue && trimmed && !trimmed.startsWith('#')) {
+            const fieldValue = currentIssue[currentField] || '';
+            currentIssue[currentField] = fieldValue + ' ' + trimmed;
+        }
+    }
+    // Save last issue
+    if (currentIssue && currentIssue.severity && currentIssue.category && currentIssue.description) {
+        issues.push(currentIssue);
+    }
+    return issues;
+}
+/**
+ * Parse recommended actions from "Recommended Follow-Up Actions" section
+ * @param markdown Reflection markdown
+ * @returns Recommended actions object with priority levels
+ */
+function parseRecommendedActions(markdown) {
+    const section = extractSection(markdown, '## 🔧 Recommended Follow-Up Actions');
+    const actions = {
+        priority1: [],
+        priority2: [],
+        priority3: []
+    };
+    if (!section)
+        return actions;
+    const lines = section.split('\n');
+    let currentPriority = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check for priority headers
+        if (/Priority 1|MUST FIX/i.test(trimmed)) {
+            currentPriority = 'priority1';
+            continue;
+        }
+        if (/Priority 2|SHOULD FIX/i.test(trimmed)) {
+            currentPriority = 'priority2';
+            continue;
+        }
+        if (/Priority 3|NICE TO HAVE/i.test(trimmed)) {
+            currentPriority = 'priority3';
+            continue;
+        }
+        // Parse action items (numbered or bulleted)
+        if (currentPriority && (/^\d+\.\s/.test(trimmed) || /^[-*+]\s/.test(trimmed))) {
+            const actionText = trimmed.replace(/^(\d+\.|-|\*|\+)\s+/, '').trim();
+            if (actionText.length > 0) {
+                actions[currentPriority].push(actionText);
+            }
+        }
+    }
+    return actions;
+}
+/**
+ * Parse lessons learned from "Lessons Learned" section
+ * @param markdown Reflection markdown
+ * @returns LessonLearned object
+ */
+function parseLessonsLearned(markdown) {
+    const section = extractSection(markdown, '## 📚 Lessons Learned');
+    const lessons = {
+        whatWentWell: [],
+        whatCouldImprove: [],
+        forNextTime: []
+    };
+    if (!section)
+        return lessons;
+    const lines = section.split('\n');
+    let currentCategory = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check for category headers
+        if (/What went well/i.test(trimmed)) {
+            currentCategory = 'whatWentWell';
+            continue;
+        }
+        if (/What could improve/i.test(trimmed)) {
+            currentCategory = 'whatCouldImprove';
+            continue;
+        }
+        if (/For next time/i.test(trimmed)) {
+            currentCategory = 'forNextTime';
+            continue;
+        }
+        // Parse bullet points
+        if (currentCategory && /^[-*+]\s/.test(trimmed)) {
+            const text = trimmed.replace(/^[-*+]\s+/, '').trim();
+            if (text.length > 0) {
+                lessons[currentCategory].push(text);
+            }
+        }
+    }
+    return lessons;
+}
+/**
+ * Parse metrics from "Metrics" section
+ * @param markdown Reflection markdown
+ * @returns ReflectionMetrics object
+ */
+function parseMetrics(markdown) {
+    const section = extractSection(markdown, '## 📊 Metrics');
+    const metrics = {
+        codeQuality: 5,
+        security: 5,
+        testCoverage: undefined,
+        technicalDebt: 'MEDIUM',
+        performance: 'ACCEPTABLE'
+    };
+    if (!section)
+        return metrics;
+    // Parse Code Quality (1-10)
+    const qualityMatch = section.match(/Code Quality.*?(\d+)/i);
+    if (qualityMatch) {
+        metrics.codeQuality = parseInt(qualityMatch[1], 10);
+    }
+    // Parse Security (1-10)
+    const securityMatch = section.match(/Security.*?(\d+)/i);
+    if (securityMatch) {
+        metrics.security = parseInt(securityMatch[1], 10);
+    }
+    // Parse Test Coverage (percentage)
+    const coverageMatch = section.match(/Test Coverage.*?(\d+)%/i);
+    if (coverageMatch) {
+        metrics.testCoverage = parseInt(coverageMatch[1], 10);
+    }
+    // Parse Technical Debt (LOW/MEDIUM/HIGH)
+    const debtMatch = section.match(/Technical Debt.*?(LOW|MEDIUM|HIGH)/i);
+    if (debtMatch) {
+        metrics.technicalDebt = debtMatch[1].toUpperCase();
+    }
+    // Parse Performance (GOOD/ACCEPTABLE/NEEDS WORK)
+    const perfMatch = section.match(/Performance.*?(GOOD|ACCEPTABLE|NEEDS[\s_]WORK)/i);
+    if (perfMatch) {
+        metrics.performance = perfMatch[1].toUpperCase().replace(/[\s_]/g, '_');
+    }
+    return metrics;
+}
+/**
+ * Parse complete reflection result from markdown
+ * Main parsing function
+ *
+ * @param markdown Reflection markdown from reflective-reviewer agent
+ * @param taskName Task name for result
+ * @param model Model used for reflection
+ * @param reflectionTime Time taken in seconds
+ * @param estimatedCost Estimated cost in USD
+ * @returns Complete ReflectionResult object
+ */
+export function parseReflectionMarkdown(markdown, taskName, model = ReflectionModel.HAIKU, reflectionTime = 0, estimatedCost = 0) {
+    const result = {
+        taskName,
+        completed: new Date().toISOString(),
+        duration: reflectionTime > 0 ? `${reflectionTime}s` : undefined,
+        filesModified: {
+            count: 0,
+            linesAdded: 0,
+            linesRemoved: 0
+        },
+        accomplishments: parseAccomplishments(markdown),
+        strengths: parseStrengths(markdown),
+        issues: parseIssues(markdown),
+        recommendedActions: parseRecommendedActions(markdown),
+        lessonsLearned: parseLessonsLearned(markdown),
+        metrics: parseMetrics(markdown),
+        metadata: {
+            model,
+            reflectionTime,
+            estimatedCost
+        }
+    };
+    // Extract file modification stats from markdown if present
+    const filesChangedMatch = markdown.match(/\*\*Files Modified\*\*:\s*(\d+)\s*files?,\s*\+(\d+)\s*-(\d+)/i);
+    if (filesChangedMatch) {
+        result.filesModified = {
+            count: parseInt(filesChangedMatch[1], 10),
+            linesAdded: parseInt(filesChangedMatch[2], 10),
+            linesRemoved: parseInt(filesChangedMatch[3], 10)
+        };
+    }
+    return result;
+}
+/**
+ * Validate parsed reflection result
+ * Checks for required fields and data quality
+ *
+ * @param result Parsed reflection result
+ * @returns Validation result with errors
+ */
+export function validateReflectionResult(result) {
+    const errors = [];
+    // Check required fields
+    if (!result.taskName) {
+        errors.push('Missing task name');
+    }
+    if (!result.completed) {
+        errors.push('Missing completion timestamp');
+    }
+    // Check for meaningful content
+    if (result.accomplishments.length === 0 && result.strengths.length === 0) {
+        errors.push('No accomplishments or strengths identified (reflection too sparse)');
+    }
+    // Validate metrics
+    if (result.metrics.codeQuality < 1 || result.metrics.codeQuality > 10) {
+        errors.push('Code quality must be 1-10');
+    }
+    if (result.metrics.security < 1 || result.metrics.security > 10) {
+        errors.push('Security must be 1-10');
+    }
+    if (result.metrics.testCoverage !== undefined && (result.metrics.testCoverage < 0 || result.metrics.testCoverage > 100)) {
+        errors.push('Test coverage must be 0-100%');
+    }
+    // Validate issues have required fields
+    for (const issue of result.issues) {
+        if (!issue.description) {
+            errors.push('Issue missing description');
+        }
+        if (!issue.impact) {
+            errors.push('Issue missing impact explanation');
+        }
+        if (!issue.recommendation) {
+            errors.push('Issue missing recommendation');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=reflection-parser.js.map

package/dist/plugins/specweave/lib/hooks/reflection-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-parser.js","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/reflection-parser.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Reflection Prompt Builder
+ *
+ * Builds comprehensive prompts for the reflective-reviewer agent
+ * Includes modified files context, configuration, task information
+ *
+ * @module reflection-prompt-builder
+ */
+import { ReflectionConfig, GitDiffInfo } from './types/reflection-types';
+/**
+ * Build the complete reflection prompt
+ * Main function for creating agent prompts
+ *
+ * @param options Prompt options
+ * @returns Complete markdown-formatted prompt for reflective-reviewer agent
+ */
+export declare function buildReflectionPrompt(options: {
+    taskId: string;
+    taskName?: string;
+    modifiedFiles: GitDiffInfo[];
+    config: ReflectionConfig;
+    incrementId?: string;
+    includeFullDiff?: boolean;
+}): string;
+/**
+ * Estimate token count for prompt (rough approximation)
+ * Used for cost estimation
+ *
+ * @param prompt Reflection prompt
+ * @returns Estimated token count (1 token ≈ 4 characters)
+ */
+export declare function estimatePromptTokens(prompt: string): number;
+/**
+ * Truncate large diffs to fit within token budget
+ * Preserves most recent changes (bottom of diff)
+ *
+ * @param modifiedFiles Array of modified files
+ * @param maxTokens Maximum tokens to use (default: 8000)
+ * @returns Truncated array of modified files
+ */
+export declare function truncateModifiedFiles(modifiedFiles: GitDiffInfo[], maxTokens?: number): GitDiffInfo[];
+/**
+ * Build a simplified prompt for very large changes
+ * Used when full diff exceeds reasonable token budget
+ *
+ * @param options Prompt options (same as buildReflectionPrompt)
+ * @returns Simplified prompt with file list only (no diffs)
+ */
+export declare function buildSimplifiedPrompt(options: {
+    taskId: string;
+    taskName?: string;
+    modifiedFiles: GitDiffInfo[];
+    config: ReflectionConfig;
+    incrementId?: string;
+}): string;
+//# sourceMappingURL=reflection-prompt-builder.d.ts.map

package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-prompt-builder.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/reflection-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAmB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAwI1F;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,MAAM,CAyET;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,WAAW,EAAE,EAC5B,SAAS,GAAE,MAAa,GACvB,WAAW,EAAE,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAMT"}