specweave 0.18.1 → 0.20.0

package/dist/plugins/specweave-github/lib/progress-comment-builder.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 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
+ */
+interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    completed: boolean;
+    priority: string;
+    testable: boolean;
+}
+interface Task {
+    id: string;
+    title: string;
+    status: boolean;
+}
+export interface ProgressSummary {
+    totalACs: number;
+    completedACs: number;
+    percentage: number;
+    statusSummary: string;
+    completedCriteria: AcceptanceCriterion[];
+    remainingCriteria: AcceptanceCriterion[];
+    tasks: Task[];
+}
+export declare class ProgressCommentBuilder {
+    private userStoryPath;
+    private projectRoot;
+    constructor(userStoryPath: string, projectRoot?: string);
+    /**
+     * Build complete progress comment
+     */
+    buildProgressComment(incrementId: string): Promise<string>;
+    /**
+     * Calculate progress summary
+     */
+    calculateProgressSummary(): Promise<ProgressSummary>;
+    /**
+     * Format AC checkboxes (for inline display)
+     */
+    formatACCheckboxes(): string;
+    /**
+     * Format task checkboxes (for inline display)
+     */
+    formatTaskCheckboxes(): string;
+    /**
+     * Calculate progress percentage
+     */
+    calculateProgressPercentage(): Promise<number>;
+    /**
+     * Extract frontmatter from user story file
+     */
+    private extractFrontmatter;
+    /**
+     * Extract acceptance criteria from content
+     */
+    private extractAcceptanceCriteria;
+    /**
+     * Extract tasks from Implementation section
+     */
+    private extractTasks;
+}
+/**
+ * CLI entry point for generating progress comments
+ */
+export declare function main(): Promise<void>;
+export {};
+//# sourceMappingURL=progress-comment-builder.d.ts.map

package/dist/plugins/specweave-github/lib/progress-comment-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-comment-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/progress-comment-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,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;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IACzC,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IACzC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,aAAa,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB;IAKtE;;OAEG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsEhE;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,eAAe,CAAC;IAoC1D;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAM5B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAM9B;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpD;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2BjC;;OAEG;YACW,YAAY;CAgD3B;AAED;;GAEG;AACH,wBAAsB,IAAI,kBAezB"}

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

@@ -0,0 +1,237 @@
+/**
+ * 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
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Error generating progress comment:', error.message);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=progress-comment-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress-comment-builder.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/progress-comment-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAmC7B,MAAM,OAAO,sBAAsB;IAIjC,YAAY,aAAqB,EAAE,cAAsB,OAAO,CAAC,GAAG,EAAE;QACpE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEpD,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,SAAS;QACT,OAAO,IAAI,uCAAuC,WAAW,QAAQ,CAAC;QACtE,OAAO,IAAI,eAAe,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,QAAQ,qBAAqB,OAAO,CAAC,UAAU,QAAQ,CAAC;QAE5I,gCAAgC;QAChC,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,wCAAwC,CAAC;YACpD,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAC3C,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,OAAO,IAAI,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,GAAG,QAAQ,GAAG,QAAQ,IAAI,CAAC;YAC7E,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,oBAAoB;YACpB,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;YAExE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAO,IAAI,0CAA0C,CAAC;gBACtD,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;oBACpB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClD,OAAO,IAAI,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,QAAQ,QAAQ,IAAI,CAAC;gBACvE,CAAC;gBACD,OAAO,IAAI,IAAI,CAAC;YAClB,CAAC;YAED,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,iCAAiC,CAAC;gBAC7C,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;oBAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClD,OAAO,IAAI,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,GAAG,QAAQ,GAAG,QAAQ,IAAI,CAAC;gBAC7E,CAAC;gBACD,OAAO,IAAI,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;YAClE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YACxC,OAAO,IAAI,+BAA+B,cAAc,IAAI,UAAU,OAAO,CAAC;YAE9E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC7C,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,SAAS;QACT,OAAO,IAAI,SAAS,CAAC;QACrB,OAAO,IAAI,gCAAgC,CAAC;QAC5C,OAAO,IAAI,qCAAqC,WAAW,MAAM,CAAC;QAClE,OAAO,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEzD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB;QAC5B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,kBAAkB,GAAG,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC3C,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC9C,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAElF,2BAA2B;QAC3B,IAAI,aAAa,GAAG,aAAa,CAAC;QAClC,IAAI,YAAY,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC9C,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,2BAA2B;YAC3B,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;YACzE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YACjE,IAAI,WAAW,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,aAAa,GAAG,eAAe,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ;YACR,YAAY;YACZ,UAAU;YACV,aAAa;YACb,iBAAiB;YACjB,iBAAiB;YACjB,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,8CAA8C;QAC9C,2DAA2D;QAC3D,OAAO,EAAE,CAAC,CAAC,sCAAsC;IACnD,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,8CAA8C;QAC9C,2DAA2D;QAC3D,OAAO,EAAE,CAAC,CAAC,sCAAsC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,2BAA2B;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB;QAC9B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAErD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAyB,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,OAAe;QAC/C,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAE3C,2DAA2D;QAC3D,MAAM,SAAS,GACb,mEAAmE,CAAC;QAEtE,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;YACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEhC,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,QAAQ,QAAQ,IAAI,QAAQ,EAAE;gBAClC,WAAW;gBACX,SAAS;gBACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAC/G,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,OAAe;QACxC,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,mDAAmD;QACnD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,CAAC,sBAAsB;QACtC,CAAC;QAED,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAEtC,qBAAqB;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,WAAW,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,CACX,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,CAAC,uBAAuB;QACvC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAExD,oEAAoE;QACpE,MAAM,eAAe,GAAG,8BAA8B,CAAC;QACvD,IAAI,KAAK,CAAC;QAEV,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAElC,yCAAyC;YACzC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,OAAO,MAAM,kDAAkD,EAAE,GAAG,CAAC,CAAC;YACrG,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAE3D,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * 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
+     */
+    buildIssueBody(githubRepo?: 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-github/lib/user-story-content-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-story-content-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/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;;;;OAIG;IACG,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuG1D;;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"}