specweave 0.18.0 → 0.20.0

package/dist/plugins/specweave-github/lib/completion-calculator.js

@@ -0,0 +1,301 @@
+/**
+ * Completion Calculator - Verifies actual work completion from markdown checkboxes
+ *
+ * CRITICAL FIX: Prevents premature GitHub issue closure by verifying actual
+ * AC and Task completion state, not just frontmatter status.
+ *
+ * Problem:
+ * - OLD: Issues closed based on frontmatter `status: complete`
+ * - Issue #574: Closed with 0/5 ACs complete!
+ *
+ * Solution:
+ * - NEW: Parse actual checkbox states ([x] vs [ ])
+ * - Close ONLY when ALL ACs and ALL tasks are verified [x]
+ *
+ * Architecture:
+ * - Acceptance Criteria: Read from us-*.md files
+ * - Tasks: Read from increment's tasks.md
+ * - Verification Gate: 100% completion required
+ */
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+export class CompletionCalculator {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Calculate ACTUAL completion from markdown checkboxes
+     *
+     * Returns true only if:
+     * - All ACs have [x] (not [ ])
+     * - All Tasks have **Status**: [x] (not [ ])
+     * - At least 1 AC exists (no empty user stories)
+     *
+     * @param userStoryPath - Path to us-*.md file
+     * @returns Completion status with detailed metrics
+     */
+    async calculateCompletion(userStoryPath) {
+        // Step 1: Read and parse user story
+        const content = await readFile(userStoryPath, 'utf-8');
+        const frontmatter = this.parseUserStoryFrontmatter(content);
+        // Step 2: Extract Acceptance Criteria
+        const acs = this.extractAcceptanceCriteria(content);
+        // Step 3: Extract Tasks from increment (if linked)
+        const tasks = await this.extractTasks(content, frontmatter.id);
+        // Step 4: Calculate metrics
+        const acsCompleted = acs.filter((ac) => ac.completed).length;
+        const tasksCompleted = tasks.filter((t) => t.completed).length;
+        // Step 5: Determine overall completion
+        // MUST have:
+        // - At least 1 AC (no empty user stories)
+        // - ALL ACs completed
+        // - ALL Tasks completed (or no tasks if not implemented yet)
+        const overallComplete = acs.length > 0 &&
+            acsCompleted === acs.length &&
+            (tasks.length === 0 || tasksCompleted === tasks.length);
+        return {
+            acsTotal: acs.length,
+            acsCompleted,
+            acsPercentage: acs.length > 0 ? (acsCompleted / acs.length) * 100 : 0,
+            tasksTotal: tasks.length,
+            tasksCompleted,
+            tasksPercentage: tasks.length > 0 ? (tasksCompleted / tasks.length) * 100 : 0,
+            overallComplete,
+            blockingAcs: acs.filter((ac) => !ac.completed).map((ac) => ac.id),
+            blockingTasks: tasks.filter((t) => !t.completed).map((t) => t.id),
+        };
+    }
+    /**
+     * Parse User Story frontmatter
+     */
+    parseUserStoryFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error('Missing YAML frontmatter in user story');
+        }
+        return yaml.parse(match[1]);
+    }
+    /**
+     * Extract Acceptance Criteria with checkbox state
+     *
+     * Supports TWO formats:
+     * - Format 1 (preferred): AC-US1-01, AC-US1-02 (project-specific)
+     * - Format 2 (legacy): AC-001, AC-002, AC-020 (global)
+     *
+     * Patterns:
+     * - [x] **AC-US1-01**: Description (completed)
+     * - [ ] **AC-US1-01**: Description (not completed)
+     * - **AC-US1-01**: Description (no checkbox, default to not completed)
+     */
+    extractAcceptanceCriteria(content) {
+        const criteria = [];
+        // Look for "Acceptance Criteria" section
+        const acMatch = content.match(/##\s*Acceptance Criteria\s*\n+([\s\S]*?)(?=\n##|$)/i);
+        if (!acMatch) {
+            return criteria;
+        }
+        const acSection = acMatch[1];
+        // Pattern with checkboxes (PREFERRED)
+        // Matches: - [x] **AC-US1-01**: Description
+        //          - [ ] **AC-020**: Description
+        const acPatternWithCheckbox = /(?:^|\n)\s*[-*]\s+\[([x ])\]\s+\*\*([A-Z]+-(?:[A-Z]+\d+-)?(\d+))\*\*:\s*([^\n]+)/g;
+        // Pattern without checkboxes (FALLBACK)
+        // Matches: - **AC-US1-01**: Description
+        const acPatternNoCheckbox = /(?:^|\n)\s*[-*]?\s*\*\*([A-Z]+-(?:[A-Z]+\d+-)?(\d+))\*\*:\s*([^\n]+)/g;
+        // First try pattern with checkboxes
+        let match;
+        let foundAny = false;
+        while ((match = acPatternWithCheckbox.exec(acSection)) !== null) {
+            foundAny = true;
+            criteria.push({
+                id: match[2], // e.g., "AC-US1-01" or "AC-020"
+                description: match[4].trim(),
+                completed: match[1] === 'x', // ✅ Read checkbox state from source!
+            });
+        }
+        // If no checkboxes found, try pattern without checkboxes
+        if (!foundAny) {
+            while ((match = acPatternNoCheckbox.exec(acSection)) !== null) {
+                criteria.push({
+                    id: match[1], // e.g., "AC-US1-01" or "AC-020"
+                    description: match[3].trim(),
+                    completed: false, // Default to not completed
+                });
+            }
+        }
+        return criteria;
+    }
+    /**
+     * Extract tasks from increment's tasks.md that map to this User Story
+     *
+     * Process:
+     * 1. Find increment link in user story's "Implementation" section
+     * 2. Read increment's tasks.md
+     * 3. Filter tasks that reference this user story's ACs
+     * 4. Extract completion status from **Status**: [x] or [ ]
+     */
+    async extractTasks(userStoryContent, userStoryId) {
+        const tasks = [];
+        // Look for "Implementation" section with increment link
+        const implMatch = userStoryContent.match(/##\s*Implementation\s*\n+([\s\S]*?)(?=\n##|$)/i);
+        if (!implMatch) {
+            return tasks; // No implementation yet
+        }
+        const implSection = implMatch[1];
+        // Extract increment ID from Implementation section
+        // Pattern: **Increment**: [0031-external-tool-status-sync](...)
+        const incrementMatch = implSection.match(/\*\*Increment\*\*:\s*\[([^\]]+)\]/);
+        if (!incrementMatch) {
+            return tasks; // No increment linked
+        }
+        const incrementId = incrementMatch[1];
+        // Try to read increment's tasks.md
+        const tasksPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId, 'tasks.md');
+        if (!existsSync(tasksPath)) {
+            return tasks; // Increment has no tasks.md yet
+        }
+        const tasksContent = await readFile(tasksPath, 'utf-8');
+        // Extract tasks that reference this User Story via AC-IDs
+        // Pattern:
+        // ### T-001: Task Title
+        // **User Story**: ...
+        // **Status**: [x] (100% - Completed) or [ ] (0% - Not started)
+        // **AC**: AC-US1-01, AC-US1-02
+        const taskPattern = /###?\s+(T-\d+):\s*([^\n]+)\n([\s\S]*?)(?=\n###?\s+T-\d+:|$)/g;
+        let match;
+        while ((match = taskPattern.exec(tasksContent)) !== null) {
+            const taskId = match[1];
+            const taskTitle = match[2].trim();
+            const taskBody = match[3];
+            // Extract AC list
+            const acMatch = taskBody.match(/\*\*AC\*\*:\s*([^\n]+)/);
+            if (!acMatch) {
+                continue; // Skip tasks without AC field
+            }
+            const acList = acMatch[1].trim();
+            // Check if any AC in this task belongs to current User Story
+            // AC-US1-01 → US-001
+            // AC-US001-01 → US-001
+            const acIds = acList.split(',').map((ac) => ac.trim());
+            const belongsToThisUS = acIds.some((acId) => {
+                // Extract US ID from AC-ID
+                // AC-US1-01 → US1 → US-001
+                // AC-US001-01 → US001 → US-001
+                const usMatch = acId.match(/AC-([A-Z]+\d+)-/);
+                if (!usMatch)
+                    return false;
+                // Normalize to US-XXX format (pad with zeros)
+                const extractedUsId = usMatch[1]; // e.g., "US1" or "US001"
+                const extractedNum = extractedUsId.replace(/^US/, ''); // "1" or "001"
+                const normalizedExtracted = `US-${extractedNum.padStart(3, '0')}`; // "US-001"
+                const currentNum = userStoryId.replace(/^US-?/, ''); // "001" or "1"
+                const normalizedCurrent = `US-${currentNum.padStart(3, '0')}`; // "US-001"
+                return normalizedExtracted === normalizedCurrent;
+            });
+            if (!belongsToThisUS) {
+                continue;
+            }
+            // ✅ Extract completion status from **Status**: [x] or [ ]
+            const statusMatch = taskBody.match(/\*\*Status\*\*:\s*\[([x ])\]/);
+            const completed = statusMatch ? statusMatch[1] === 'x' : false;
+            tasks.push({
+                id: taskId,
+                title: taskTitle,
+                completed, // ✅ Now reads actual completion status!
+                userStories: acIds,
+            });
+        }
+        return tasks;
+    }
+    /**
+     * Build completion comment for GitHub issue closure
+     *
+     * Used when closing issue after verification
+     */
+    buildCompletionComment(completion) {
+        return `✅ **User Story Verified Complete**
+
+**Completion Status**:
+- ✅ Acceptance Criteria: ${completion.acsCompleted}/${completion.acsTotal} (100%)
+- ✅ Implementation Tasks: ${completion.tasksCompleted}/${completion.tasksTotal} (100%)
+
+All work has been verified and completed. This issue is now closed.
+
+🤖 Auto-verified by SpecWeave AC Completion Gate`;
+    }
+    /**
+     * Build progress comment for GitHub issue update
+     *
+     * Used when issue stays open (not 100% complete)
+     */
+    buildProgressComment(completion) {
+        const sections = [];
+        sections.push('📊 **Progress Update**');
+        sections.push('');
+        // AC progress
+        const acIcon = completion.acsPercentage === 100 ? '✅' : '🔄';
+        sections.push(`${acIcon} **Acceptance Criteria**: ${completion.acsCompleted}/${completion.acsTotal} (${completion.acsPercentage.toFixed(0)}%)`);
+        if (completion.blockingAcs.length > 0) {
+            sections.push('');
+            sections.push('**Incomplete ACs**:');
+            for (const acId of completion.blockingAcs) {
+                sections.push(`- [ ] ${acId}`);
+            }
+        }
+        sections.push('');
+        // Task progress
+        const taskIcon = completion.tasksPercentage === 100 ? '✅' : '🔄';
+        sections.push(`${taskIcon} **Implementation Tasks**: ${completion.tasksCompleted}/${completion.tasksTotal} (${completion.tasksPercentage.toFixed(0)}%)`);
+        if (completion.blockingTasks.length > 0) {
+            sections.push('');
+            sections.push('**Incomplete Tasks**:');
+            for (const taskId of completion.blockingTasks) {
+                sections.push(`- [ ] ${taskId}`);
+            }
+        }
+        sections.push('');
+        sections.push('---');
+        sections.push('🤖 Auto-updated by SpecWeave AC Completion Gate');
+        return sections.join('\n');
+    }
+    /**
+     * Build reopen comment for GitHub issue
+     *
+     * Used when reopening prematurely closed issue
+     */
+    buildReopenComment(completion, reason = 'Work verification failed') {
+        const sections = [];
+        sections.push(`🔄 **Reopening Issue - ${reason}**`);
+        sections.push('');
+        sections.push('**Current Status**:');
+        sections.push(`- Acceptance Criteria: ${completion.acsCompleted}/${completion.acsTotal} (${completion.acsPercentage.toFixed(0)}%)`);
+        sections.push(`- Implementation Tasks: ${completion.tasksCompleted}/${completion.tasksTotal} (${completion.tasksPercentage.toFixed(0)}%)`);
+        const totalBlocking = completion.blockingAcs.length + completion.blockingTasks.length;
+        if (totalBlocking > 0) {
+            sections.push('');
+            sections.push(`**Blocking Items** (${totalBlocking}):`);
+            if (completion.blockingAcs.length > 0) {
+                sections.push('');
+                sections.push('**Acceptance Criteria**:');
+                for (const acId of completion.blockingAcs) {
+                    sections.push(`- [ ] ${acId}`);
+                }
+            }
+            if (completion.blockingTasks.length > 0) {
+                sections.push('');
+                sections.push('**Implementation Tasks**:');
+                for (const taskId of completion.blockingTasks) {
+                    sections.push(`- [ ] ${taskId}`);
+                }
+            }
+        }
+        sections.push('');
+        sections.push('⚠️ This issue cannot be closed until all ACs and tasks are verified complete.');
+        sections.push('');
+        sections.push('🤖 Auto-reopened by SpecWeave AC Completion Gate');
+        return sections.join('\n');
+    }
+}
+//# sourceMappingURL=completion-calculator.js.map

package/dist/plugins/specweave-github/lib/completion-calculator.js.map

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

package/dist/plugins/specweave-github/lib/duplicate-detector.d.ts

@@ -73,7 +73,7 @@ export declare class DuplicateDetector {
      * Searches GitHub for existing issues matching the title pattern.
      * This is the PRIMARY defense against duplicates.
      *
-     * @param titlePattern - Pattern to search (e.g., "[FS-031]" or "[INC-0031]")
+     * @param titlePattern - Pattern to search (e.g., "[FS-031]" current, "[INC-0031]" deprecated)
      * @param incrementId - Optional increment ID for more precise matching
      * @param repo - Optional repo (format: "owner/repo")
      * @returns Existing issue if found, null otherwise
@@ -122,8 +122,8 @@ export declare class DuplicateDetector {
      * Utility: Extract title pattern from full title
      *
      * Examples:
-     * - "[FS-031] Feature Title" → "[FS-031]"
-     * - "[INC-0031] Increment Title" → "[INC-0031]"
+     * - "[FS-031] Feature Title" → "[FS-031]" (current format)
+     * - "[INC-0031] Increment Title" → "[INC-0031]" (deprecated, legacy support only)
      *
      * @param title - Full issue title
      * @returns Extracted pattern or null

package/dist/plugins/specweave-github/lib/duplicate-detector.js

@@ -40,7 +40,7 @@ export class DuplicateDetector {
      * Searches GitHub for existing issues matching the title pattern.
      * This is the PRIMARY defense against duplicates.
      *
-     * @param titlePattern - Pattern to search (e.g., "[FS-031]" or "[INC-0031]")
+     * @param titlePattern - Pattern to search (e.g., "[FS-031]" current, "[INC-0031]" deprecated)
      * @param incrementId - Optional increment ID for more precise matching
      * @param repo - Optional repo (format: "owner/repo")
      * @returns Existing issue if found, null otherwise
@@ -361,8 +361,8 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
      * Utility: Extract title pattern from full title
      *
      * Examples:
-     * - "[FS-031] Feature Title" → "[FS-031]"
-     * - "[INC-0031] Increment Title" → "[INC-0031]"
+     * - "[FS-031] Feature Title" → "[FS-031]" (current format)
+     * - "[INC-0031] Increment Title" → "[INC-0031]" (deprecated, legacy support only)
      *
      * @param title - Full issue title
      * @returns Extracted pattern or null

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Epic Content Builder - Hierarchical GitHub issue content for Feature Specs
+ *
+ * Architecture:
+ * - Reads FS-* folder (FEATURE.md + us-*.md files)
+ * - Reads increment tasks.md files to map tasks to user stories
+ * - Generates hierarchical issue body:
+ *   1. User Stories section (with status + increment)
+ *   2. Tasks section (grouped by User Story)
+ *
+ * Key Features:
+ * - NO single "Increment" field (epics span multiple increments)
+ * - User Stories are checkable with status and increment link
+ * - Tasks grouped under their User Story
+ * - Shows which increment each US/task belongs to
+ */
+export declare class EpicContentBuilder {
+    private epicFolder;
+    private projectRoot;
+    constructor(epicFolder: string, projectRoot: string);
+    /**
+     * Build hierarchical GitHub issue body
+     *
+     * Format:
+     * - Epic overview
+     * - User Stories section (checkable, with status + increment)
+     * - Tasks section (grouped by User Story)
+     */
+    buildIssueBody(): Promise<string>;
+    /**
+     * Read Epic FEATURE.md frontmatter
+     */
+    private readEpicMetadata;
+    /**
+     * Read all user stories from us-*.md files
+     */
+    private readUserStories;
+    /**
+     * Extract tasks for a user story from its Implementation section
+     */
+    private extractTasksForUserStory;
+    /**
+     * Extract acceptance criteria from user story content
+     *
+     * Parses the "## Acceptance Criteria" section and extracts all checkable items.
+     * Format: - [x] **AC-US2-01**: Description...
+     */
+    private extractAcceptanceCriteria;
+    /**
+     * Build overview section
+     */
+    private buildOverviewSection;
+    /**
+     * Build User Stories section
+     */
+    private buildUserStoriesSection;
+    /**
+     * Build Tasks section (grouped by User Story)
+     */
+    private buildTasksSection;
+    /**
+     * Normalize status values
+     */
+    private normalizeStatus;
+    /**
+     * Get status emoji
+     */
+    private getStatusEmoji;
+}
+//# sourceMappingURL=epic-content-builder.d.ts.map

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-content-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/epic-content-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8CH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKnD;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBvC;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,eAAe;IA8C7B;;OAEG;YACW,wBAAwB;IAoEtC;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAgCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAgBvB"}