specweave 2.3.0 → 3.0.1

package/dist/plugins/specweave/lib/integrations/github/progress-comment-builder.js

@@ -1,237 +0,0 @@
-/**
- * Progress Comment Builder - Generate progress update comments for GitHub issues
- *
- * Architecture:
- * - Reads user story files from living docs
- * - Extracts current AC completion status
- * - Formats progress comment with checkboxes
- * - Creates audit trail of changes over time
- *
- * Key Principle: IMMUTABLE DESCRIPTIONS
- * - Issue description created once (snapshot)
- * - All updates via progress comments (current state)
- * - Complete audit trail preserved
- */
-import { readFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import * as path from 'path';
-import * as yaml from 'yaml';
-export class ProgressCommentBuilder {
-    constructor(userStoryPath, projectRoot = process.cwd()) {
-        this.userStoryPath = userStoryPath;
-        this.projectRoot = projectRoot;
-    }
-    /**
-     * Build complete progress comment
-     */
-    async buildProgressComment(incrementId) {
-        const summary = await this.calculateProgressSummary();
-        const frontmatter = await this.extractFrontmatter();
-        let comment = '';
-        // Header
-        comment += `📊 **Progress Update from Increment ${incrementId}**\n\n`;
-        comment += `**Status**: ${summary.statusSummary} (${summary.completedACs}/${summary.totalACs} AC implemented - ${summary.percentage}%)\n\n`;
-        // Completed Acceptance Criteria
-        if (summary.completedCriteria.length > 0) {
-            comment += `## ✅ Completed Acceptance Criteria\n\n`;
-            for (const ac of summary.completedCriteria) {
-                const priority = ac.priority ? ` (${ac.priority})` : '';
-                const testable = ac.testable ? ' [testable]' : '';
-                comment += `- [x] **${ac.id}**: ${ac.description}${priority}${testable}\n`;
-            }
-            comment += '\n';
-        }
-        // Remaining Work
-        if (summary.remainingCriteria.length > 0) {
-            // Group by priority
-            const p1 = summary.remainingCriteria.filter(ac => ac.priority === 'P1');
-            const p2 = summary.remainingCriteria.filter(ac => ac.priority === 'P2');
-            const p3 = summary.remainingCriteria.filter(ac => ac.priority === 'P3');
-            if (p1.length > 0) {
-                comment += `## 🔴 Remaining Work (P1 - Critical)\n\n`;
-                for (const ac of p1) {
-                    const testable = ac.testable ? ' [testable]' : '';
-                    comment += `- [ ] **${ac.id}**: ${ac.description} (P1)${testable}\n`;
-                }
-                comment += '\n';
-            }
-            if (p2.length > 0 || p3.length > 0) {
-                comment += `## ⏳ Remaining Work (P2-P3)\n\n`;
-                for (const ac of [...p2, ...p3]) {
-                    const priority = ac.priority ? ` (${ac.priority})` : '';
-                    const testable = ac.testable ? ' [testable]' : '';
-                    comment += `- [ ] **${ac.id}**: ${ac.description}${priority}${testable}\n`;
-                }
-                comment += '\n';
-            }
-        }
-        // Tasks (if any)
-        if (summary.tasks.length > 0) {
-            const completedTasks = summary.tasks.filter(t => t.status).length;
-            const totalTasks = summary.tasks.length;
-            comment += `## 📋 Implementation Tasks (${completedTasks}/${totalTasks})\n\n`;
-            for (const task of summary.tasks) {
-                const checkbox = task.status ? '[x]' : '[ ]';
-                comment += `- ${checkbox} ${task.id}: ${task.title}\n`;
-            }
-            comment += '\n';
-        }
-        // Footer
-        comment += `---\n\n`;
-        comment += `🤖 Auto-synced by SpecWeave | `;
-        comment += `[View increment](../../increments/${incrementId}) | `;
-        comment += `${new Date().toISOString().split('T')[0]}\n`;
-        return comment;
-    }
-    /**
-     * Calculate progress summary
-     */
-    async calculateProgressSummary() {
-        const content = await readFile(this.userStoryPath, 'utf-8');
-        const acceptanceCriteria = this.extractAcceptanceCriteria(content);
-        const tasks = await this.extractTasks(content);
-        const completedCriteria = acceptanceCriteria.filter(ac => ac.completed);
-        const remainingCriteria = acceptanceCriteria.filter(ac => !ac.completed);
-        const totalACs = acceptanceCriteria.length;
-        const completedACs = completedCriteria.length;
-        const percentage = totalACs > 0 ? Math.round((completedACs / totalACs) * 100) : 0;
-        // Determine status summary
-        let statusSummary = 'In Progress';
-        if (completedACs === totalACs && totalACs > 0) {
-            statusSummary = 'Complete';
-        }
-        else if (completedACs > 0) {
-            // Check if all P1 are done
-            const p1Criteria = acceptanceCriteria.filter(ac => ac.priority === 'P1');
-            const p1Completed = p1Criteria.filter(ac => ac.completed).length;
-            if (p1Completed === p1Criteria.length && p1Criteria.length > 0) {
-                statusSummary = 'Core Complete';
-            }
-        }
-        return {
-            totalACs,
-            completedACs,
-            percentage,
-            statusSummary,
-            completedCriteria,
-            remainingCriteria,
-            tasks,
-        };
-    }
-    /**
-     * Format AC checkboxes (for inline display)
-     */
-    formatACCheckboxes() {
-        // This method is for simple inline formatting
-        // The full buildProgressComment does structured formatting
-        return ''; // Placeholder for CLI usage if needed
-    }
-    /**
-     * Format task checkboxes (for inline display)
-     */
-    formatTaskCheckboxes() {
-        // This method is for simple inline formatting
-        // The full buildProgressComment does structured formatting
-        return ''; // Placeholder for CLI usage if needed
-    }
-    /**
-     * Calculate progress percentage
-     */
-    async calculateProgressPercentage() {
-        const summary = await this.calculateProgressSummary();
-        return summary.percentage;
-    }
-    /**
-     * Extract frontmatter from user story file
-     */
-    async extractFrontmatter() {
-        const content = await readFile(this.userStoryPath, 'utf-8');
-        const match = content.match(/^---\n([\s\S]*?)\n---/);
-        if (!match) {
-            throw new Error(`User story file missing YAML frontmatter: ${this.userStoryPath}`);
-        }
-        return yaml.parse(match[1]);
-    }
-    /**
-     * Extract acceptance criteria from content
-     */
-    extractAcceptanceCriteria(content) {
-        const criteria = [];
-        // Pattern: - [x] **AC-US4-01**: Description (P1, testable)
-        const acPattern = /- \[([ x])\] \*\*AC-US(\d+)-(\d+)\*\*:\s*([^(]+)(?:\(([^)]+)\))?/g;
-        let match;
-        while ((match = acPattern.exec(content)) !== null) {
-            const completed = match[1] === 'x';
-            const usNumber = match[2];
-            const acNumber = match[3];
-            const description = match[4].trim();
-            const metadata = match[5] || '';
-            criteria.push({
-                id: `AC-US${usNumber}-${acNumber}`,
-                description,
-                completed,
-                priority: metadata.includes('P1') ? 'P1' : metadata.includes('P2') ? 'P2' : metadata.includes('P3') ? 'P3' : '',
-                testable: metadata.includes('testable'),
-            });
-        }
-        return criteria;
-    }
-    /**
-     * Extract tasks from Implementation section
-     */
-    async extractTasks(content) {
-        const tasks = [];
-        // Extract increment ID from Implementation section
-        const incrementMatch = content.match(/\*\*Increment\*\*:\s*\[([^\]]+)\]/);
-        if (!incrementMatch) {
-            return tasks; // No increment linked
-        }
-        const incrementId = incrementMatch[1];
-        // Find tasks.md file
-        const tasksPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId, 'tasks.md');
-        if (!existsSync(tasksPath)) {
-            return tasks; // Tasks file not found
-        }
-        const tasksContent = await readFile(tasksPath, 'utf-8');
-        // Extract task links from user story (e.g., - [T-001: Title](link))
-        const taskLinkPattern = /- \[([T-\d]+):\s*([^\]]+)\]/g;
-        let match;
-        while ((match = taskLinkPattern.exec(content)) !== null) {
-            const taskId = match[1];
-            const taskTitle = match[2].trim();
-            // Check if task is completed in tasks.md
-            const taskPattern = new RegExp(`### ${taskId}[:\\s].*?\\n\\*\\*Status\\*\\*:\\s*\\[([x ]?)\\]`, 's');
-            const taskMatch = tasksContent.match(taskPattern);
-            const completed = taskMatch ? taskMatch[1] === 'x' : false;
-            tasks.push({
-                id: taskId,
-                title: taskTitle,
-                status: completed,
-            });
-        }
-        return tasks;
-    }
-}
-/**
- * CLI entry point for generating progress comments
- */
-export async function main() {
-    const args = process.argv.slice(2);
-    if (args.length < 4) {
-        console.error('Usage: node progress-comment-builder.js --user-story <path> --increment <id>');
-        process.exit(1);
-    }
-    const userStoryPath = args[args.indexOf('--user-story') + 1];
-    const incrementId = args[args.indexOf('--increment') + 1];
-    const builder = new ProgressCommentBuilder(userStoryPath);
-    const comment = await builder.buildProgressComment(incrementId);
-    console.log(comment);
-}
-// Run if called directly (ESM compatible)
-if (import.meta.url === `file://${process.argv[1]}`) {
-    main().catch((error) => {
-        console.error('Error generating progress comment:', error.message);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=progress-comment-builder.js.map

package/dist/plugins/specweave/lib/integrations/github/progress-comment-builder.js.map

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

package/dist/plugins/specweave/lib/integrations/github/user-story-content-builder.d.ts

@@ -1,98 +0,0 @@
-/**
- * User Story Content Builder - GitHub issue content for individual user stories
- *
- * Architecture:
- * - Reads individual us-*.md files from living docs
- * - Extracts ACs and converts to GitHub task checkboxes
- * - Finds and links related tasks from increment tasks.md
- * - Generates rich GitHub issue body with proper formatting
- *
- * Key Features:
- * - Checkable ACs (GitHub task checkboxes)
- * - Task connections (links to increment tasks)
- * - User story description (As a... I want... So that...)
- * - Implementation details
- */
-interface UserStoryFrontmatter {
-    id: string;
-    epic: string;
-    title: string;
-    status: 'complete' | 'active' | 'planning' | 'not-started';
-    project: string;
-    priority: string;
-    created: string;
-    completed?: string;
-}
-interface AcceptanceCriterion {
-    id: string;
-    description: string;
-    completed: boolean;
-    priority: string;
-    testable: boolean;
-}
-interface Task {
-    id: string;
-    title: string;
-    status: boolean;
-    link: string;
-}
-export interface UserStoryContent {
-    frontmatter: UserStoryFrontmatter;
-    userStoryDescription: {
-        asA: string;
-        iWant: string;
-        soThat: string;
-    } | null;
-    acceptanceCriteria: AcceptanceCriterion[];
-    tasks: Task[];
-    incrementId: string | null;
-    featureId: string;
-}
-export declare class UserStoryContentBuilder {
-    private userStoryPath;
-    private projectRoot;
-    constructor(userStoryPath: string, projectRoot: string);
-    /**
-     * Parse user story file and extract all content
-     */
-    parse(): Promise<UserStoryContent>;
-    /**
-     * Build GitHub issue body from user story content
-     *
-     * @param githubRepo Optional GitHub repo in format "owner/repo" for generating URLs
-     * @param branch Optional branch name for URL generation (defaults to 'main')
-     */
-    buildIssueBody(githubRepo?: string, branch?: string): Promise<string>;
-    /**
-     * Extract feature ID from epic or path
-     */
-    private extractFeatureId;
-    /**
-     * Extract user story description (As a... I want... So that...)
-     */
-    private extractUserStoryDescription;
-    /**
-     * Extract acceptance criteria from content
-     */
-    private extractAcceptanceCriteria;
-    /**
-     * Extract increment ID from Implementation section
-     */
-    private extractIncrementId;
-    /**
-     * Extract tasks for this user story from increment tasks.md
-     */
-    private extractTasks;
-    /**
-     * Extract highest priority from acceptance criteria
-     * Priority order: P1 > P2 > P3
-     */
-    private extractPriorityFromACs;
-    /**
-     * Detect GitHub repository from git remote
-     * Returns "owner/repo" format
-     */
-    private detectGitHubRepo;
-}
-export {};
-//# sourceMappingURL=user-story-content-builder.d.ts.map

package/dist/plugins/specweave/lib/integrations/github/user-story-content-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-story-content-builder.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/user-story-content-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,oBAAoB,CAAC;IAClC,oBAAoB,EAAE;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;IACT,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;IAC1C,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAoCxC;;;;;OAKG;IACG,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiH3E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoBnC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2BjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;YACW,YAAY;IA+D1B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;;OAGG;YACW,gBAAgB;CAuB/B"}

package/dist/plugins/specweave/lib/integrations/github/user-story-content-builder.js

@@ -1,310 +0,0 @@
-/**
- * User Story Content Builder - GitHub issue content for individual user stories
- *
- * Architecture:
- * - Reads individual us-*.md files from living docs
- * - Extracts ACs and converts to GitHub task checkboxes
- * - Finds and links related tasks from increment tasks.md
- * - Generates rich GitHub issue body with proper formatting
- *
- * Key Features:
- * - Checkable ACs (GitHub task checkboxes)
- * - Task connections (links to increment tasks)
- * - User story description (As a... I want... So that...)
- * - Implementation details
- */
-import { readFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import * as path from 'path';
-import * as yaml from 'yaml';
-export class UserStoryContentBuilder {
-    constructor(userStoryPath, projectRoot) {
-        this.userStoryPath = userStoryPath;
-        this.projectRoot = projectRoot;
-    }
-    /**
-     * Parse user story file and extract all content
-     */
-    async parse() {
-        const content = await readFile(this.userStoryPath, 'utf-8');
-        const match = content.match(/^---\n([\s\S]*?)\n---/);
-        if (!match) {
-            throw new Error('User story file missing YAML frontmatter');
-        }
-        const frontmatter = yaml.parse(match[1]);
-        const bodyContent = content.slice(match[0].length).trim();
-        // Extract feature ID from epic or path
-        const featureId = this.extractFeatureId(frontmatter.epic, this.userStoryPath);
-        // Extract user story description
-        const userStoryDescription = this.extractUserStoryDescription(bodyContent);
-        // Extract acceptance criteria
-        const acceptanceCriteria = this.extractAcceptanceCriteria(bodyContent);
-        // Extract increment ID and tasks
-        const incrementId = this.extractIncrementId(bodyContent);
-        const tasks = incrementId
-            ? await this.extractTasks(bodyContent, incrementId, frontmatter.id)
-            : [];
-        return {
-            frontmatter,
-            userStoryDescription,
-            acceptanceCriteria,
-            tasks,
-            incrementId,
-            featureId,
-        };
-    }
-    /**
-     * Build GitHub issue body from user story content
-     *
-     * @param githubRepo Optional GitHub repo in format "owner/repo" for generating URLs
-     * @param branch Optional branch name for URL generation (defaults to 'main')
-     */
-    async buildIssueBody(githubRepo, branch) {
-        const content = await this.parse();
-        let body = '';
-        // Detect GitHub repo from git remote if not provided
-        const repo = githubRepo || await this.detectGitHubRepo();
-        const branchName = branch || 'main';
-        // ❌ REMOVED: Metadata header (Feature, Status, Priority)
-        // WHY: GitHub has NATIVE fields for this (labels, milestones)
-        // Body should contain ONLY actual work content (ACs, tasks, user story)
-        // See: .specweave/docs/internal/troubleshooting/CRITICAL-remove-metadata-header-from-github-issues.md
-        // Progress section (consistency with user-story-issue-builder.ts)
-        const completedACs = content.acceptanceCriteria.filter(ac => ac.completed).length;
-        const totalACs = content.acceptanceCriteria.length;
-        const completedTasks = content.tasks.filter(t => t.status).length;
-        const totalTasks = content.tasks.length;
-        const overallPercentage = (totalACs + totalTasks) > 0
-            ? Math.round(((completedACs + completedTasks) / (totalACs + totalTasks)) * 100)
-            : 0;
-        body += `## Progress\n\n`;
-        body += `**Acceptance Criteria**: ${completedACs}/${totalACs} (${totalACs > 0 ? Math.round((completedACs / totalACs) * 100) : 0}%)\n`;
-        body += `**Tasks**: ${completedTasks}/${totalTasks} (${totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0}%)\n`;
-        body += `**Overall**: ${overallPercentage}%\n\n`;
-        // Progress bar
-        const filledBlocks = Math.floor(overallPercentage / 5);
-        const emptyBlocks = 20 - filledBlocks;
-        body += `${'█'.repeat(filledBlocks)}${'░'.repeat(emptyBlocks)} ${overallPercentage}%\n\n`;
-        body += `---\n\n`;
-        // User Story description
-        body += `## User Story\n\n`;
-        if (content.userStoryDescription) {
-            body += `**As a** ${content.userStoryDescription.asA}\n`;
-            body += `**I want** ${content.userStoryDescription.iWant}\n`;
-            body += `**So that** ${content.userStoryDescription.soThat}\n\n`;
-        }
-        else {
-            body += `*User story description not found*\n\n`;
-        }
-        // Link to full user story file (GitHub URL)
-        const usFilename = path.basename(this.userStoryPath);
-        if (repo) {
-            const relativePath = this.userStoryPath
-                .replace(this.projectRoot, '')
-                .replace(/^\//, '');
-            body += `📄 View full story: [\`${usFilename}\`](https://github.com/${repo}/tree/${branchName}/${relativePath})\n\n`;
-        }
-        body += `---\n\n`;
-        // Acceptance Criteria (checkable!)
-        body += `## Acceptance Criteria\n\n`;
-        if (content.acceptanceCriteria.length > 0) {
-            const completed = content.acceptanceCriteria.filter((ac) => ac.completed).length;
-            const total = content.acceptanceCriteria.length;
-            const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
-            body += `Progress: ${completed}/${total} criteria met (${percentage}%)\n\n`;
-            for (const ac of content.acceptanceCriteria) {
-                const checkbox = ac.completed ? '[x]' : '[ ]';
-                const priority = ac.priority ? ` (${ac.priority})` : '';
-                const testable = ac.testable ? ' [testable]' : '';
-                body += `- ${checkbox} **${ac.id}**: ${ac.description}${priority}${testable}\n`;
-            }
-            body += '\n';
-        }
-        else {
-            body += `*No acceptance criteria defined*\n\n`;
-        }
-        body += `---\n\n`;
-        // Tasks (linked to increment!)
-        body += `## Implementation Tasks\n\n`;
-        if (content.tasks.length > 0) {
-            const completed = content.tasks.filter((t) => t.status).length;
-            const total = content.tasks.length;
-            const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
-            body += `Progress: ${completed}/${total} tasks complete (${percentage}%)\n\n`;
-            if (content.incrementId) {
-                if (repo) {
-                    body += `**Increment**: [${content.incrementId}](https://github.com/${repo}/tree/${branchName}/.specweave/increments/${content.incrementId})\n\n`;
-                }
-                else {
-                    body += `**Increment**: ${content.incrementId}\n\n`;
-                }
-            }
-            for (const task of content.tasks) {
-                const checkbox = task.status ? '[x]' : '[ ]';
-                // Convert relative link to GitHub URL if repo is known
-                let taskLink = task.link;
-                if (repo && taskLink.startsWith('../../')) {
-                    const relativePath = taskLink.replace(/^\.\.\/\.\.\//, '.specweave/');
-                    taskLink = `https://github.com/${repo}/tree/${branchName}/${relativePath}`;
-                }
-                body += `- ${checkbox} [${task.id}: ${task.title}](${taskLink})\n`;
-            }
-            body += '\n';
-        }
-        else {
-            body += `*No tasks defined yet*\n\n`;
-        }
-        body += `---\n\n`;
-        body += `🤖 Auto-synced by SpecWeave User Story Sync`;
-        return body;
-    }
-    /**
-     * Extract feature ID from epic or path
-     */
-    extractFeatureId(epic, filePath) {
-        // Try epic first (e.g., "FS-031")
-        if (epic && epic.startsWith('FS-')) {
-            return epic;
-        }
-        // Extract from path: .../specs/default/FS-031/us-001-...md
-        const match = filePath.match(/FS-\d+/);
-        return match ? match[0] : 'FS-UNKNOWN';
-    }
-    /**
-     * Extract user story description (As a... I want... So that...)
-     */
-    extractUserStoryDescription(content) {
-        const asAMatch = content.match(/\*\*As a\*\*\s+([^\n]+)/);
-        const iWantMatch = content.match(/\*\*I want\*\*\s+([^\n]+)/);
-        const soThatMatch = content.match(/\*\*So that\*\*\s+([^\n]+)/);
-        if (asAMatch && iWantMatch && soThatMatch) {
-            return {
-                asA: asAMatch[1].trim(),
-                iWant: iWantMatch[1].trim(),
-                soThat: soThatMatch[1].trim(),
-            };
-        }
-        return null;
-    }
-    /**
-     * Extract acceptance criteria from content
-     */
-    extractAcceptanceCriteria(content) {
-        const criteria = [];
-        // Pattern: - [x] **AC-US4-01**: Description (P1, testable)
-        const acPattern = /- \[([ x])\] \*\*AC-US(\d+)-(\d+)\*\*:\s*([^(]+)(?:\(([^)]+)\))?/g;
-        let match;
-        while ((match = acPattern.exec(content)) !== null) {
-            const completed = match[1] === 'x';
-            const usNumber = match[2];
-            const acNumber = match[3];
-            const description = match[4].trim();
-            const metadata = match[5] || '';
-            criteria.push({
-                id: `AC-US${usNumber}-${acNumber}`,
-                description,
-                completed,
-                priority: metadata.includes('P1') ? 'P1' : metadata.includes('P2') ? 'P2' : '',
-                testable: metadata.includes('testable'),
-            });
-        }
-        return criteria;
-    }
-    /**
-     * Extract increment ID from Implementation section
-     */
-    extractIncrementId(content) {
-        // Pattern: **Increment**: [0031-external-tool-status-sync](...)
-        const match = content.match(/\*\*Increment\*\*:\s*\[([^\]]+)\]/);
-        return match ? match[1] : null;
-    }
-    /**
-     * Extract tasks for this user story from increment tasks.md
-     */
-    async extractTasks(content, incrementId, userStoryId) {
-        const tasks = [];
-        // Find increment folder
-        const incrementFolder = path.join(this.projectRoot, '.specweave', 'increments', incrementId);
-        if (!existsSync(incrementFolder)) {
-            console.warn(`   ⚠️  Increment folder not found: ${incrementId}`);
-            return [];
-        }
-        const tasksPath = path.join(incrementFolder, 'tasks.md');
-        if (!existsSync(tasksPath)) {
-            console.warn(`   ⚠️  tasks.md not found in ${incrementId}`);
-            return [];
-        }
-        // Read tasks.md
-        const tasksContent = await readFile(tasksPath, 'utf-8');
-        // Extract task links from user story's Implementation section
-        // Format: - [T-008: Create Status Sync Engine](link#t-008-create-status-sync-engine)
-        const taskLinkPattern = /- \[([T-\d]+):\s*([^\]]+)\]/g;
-        let match;
-        while ((match = taskLinkPattern.exec(content)) !== null) {
-            const taskId = match[1]; // e.g., "T-008"
-            const taskTitle = match[2].trim();
-            // Find task in tasks.md to get completion status
-            // Pattern: ### T-008: Create Status Sync Engine ... **Status**: [x]
-            const taskPattern = new RegExp(`###\\s+${taskId}:\\s*([^\\n]+)[\\s\\S]*?\\*\\*Status\\*\\*:\\s*\\[([x\\s])\\]`, 'i');
-            const taskMatch = tasksContent.match(taskPattern);
-            const isCompleted = taskMatch ? taskMatch[2] === 'x' : false;
-            // Build link to task in tasks.md
-            const taskAnchor = taskId.toLowerCase() + '-' + taskTitle.toLowerCase().replace(/[^\w\s-]/g, '').replace(/\s+/g, '-');
-            const link = `../../increments/${incrementId}/tasks.md#${taskAnchor}`;
-            tasks.push({
-                id: taskId,
-                title: taskTitle,
-                status: isCompleted,
-                link,
-            });
-        }
-        return tasks;
-    }
-    /**
-     * Extract highest priority from acceptance criteria
-     * Priority order: P1 > P2 > P3
-     */
-    extractPriorityFromACs(acceptanceCriteria) {
-        if (acceptanceCriteria.length === 0) {
-            return null;
-        }
-        // Check for P1 first (highest priority)
-        if (acceptanceCriteria.some(ac => ac.priority === 'P1')) {
-            return 'P1';
-        }
-        // Then P2
-        if (acceptanceCriteria.some(ac => ac.priority === 'P2')) {
-            return 'P2';
-        }
-        // Then P3
-        if (acceptanceCriteria.some(ac => ac.priority === 'P3')) {
-            return 'P3';
-        }
-        return null; // No priority found
-    }
-    /**
-     * Detect GitHub repository from git remote
-     * Returns "owner/repo" format
-     */
-    async detectGitHubRepo() {
-        try {
-            const { execFileNoThrow } = await import('../../../../../src/utils/execFileNoThrow.js');
-            const result = await execFileNoThrow('git', ['remote', 'get-url', 'origin']);
-            if (result.exitCode !== 0 || !result.stdout) {
-                return null;
-            }
-            const remoteUrl = result.stdout.trim();
-            // Parse GitHub URL
-            // Formats: git@github.com:owner/repo.git or https://github.com/owner/repo.git
-            const githubMatch = remoteUrl.match(/github\.com[:/](.+\/.+?)(?:\.git)?$/);
-            if (githubMatch) {
-                return githubMatch[1]; // "owner/repo"
-            }
-            return null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-//# sourceMappingURL=user-story-content-builder.js.map