specweave 0.18.0 → 0.20.0

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

@@ -0,0 +1,301 @@
+/**
+ * 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
+     */
+    async buildIssueBody(githubRepo) {
+        const content = await this.parse();
+        let body = '';
+        // Extract priority from ACs (highest priority wins)
+        const priority = this.extractPriorityFromACs(content.acceptanceCriteria);
+        // Detect GitHub repo from git remote if not provided
+        const repo = githubRepo || await this.detectGitHubRepo();
+        // Header with metadata
+        if (repo) {
+            body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/_features/${content.featureId})\n`;
+        }
+        else {
+            body += `**Feature**: ${content.featureId}\n`;
+        }
+        body += `**Status**: ${content.frontmatter.status}\n`;
+        if (priority) {
+            body += `**Priority**: ${priority}\n`;
+        }
+        body += `\n---\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/develop/${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/develop/.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/develop/${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

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

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

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

@@ -0,0 +1,83 @@
+/**
+ * User Story Issue Builder - Creates GitHub issue content for individual User Stories
+ *
+ * Architecture (Universal Hierarchy):
+ * - Feature (FS-033) → GitHub Milestone
+ * - User Story (US-001) → GitHub Issue (this builder creates the body)
+ * - Tasks (T-001, T-002) → Checkboxes in issue body
+ *
+ * Key Features:
+ * - Reads single us-*.md file
+ * - Extracts acceptance criteria as checkboxes
+ * - Maps tasks from increment's tasks.md
+ * - Generates GitHub issue body with proper formatting
+ */
+export declare class UserStoryIssueBuilder {
+    private userStoryPath;
+    private projectRoot;
+    private featureId;
+    private repoOwner?;
+    private repoName?;
+    private branch?;
+    constructor(userStoryPath: string, projectRoot: string, featureId: string, repoInfo?: {
+        owner: string;
+        repo: string;
+        branch?: string;
+    });
+    /**
+     * Build GitHub issue body for a single User Story
+     *
+     * Format:
+     * - User Story statement
+     * - Acceptance Criteria (checkboxes)
+     * - Tasks (checkboxes)
+     * - Links (Feature, Increment, Spec file)
+     */
+    buildIssueBody(): Promise<{
+        title: string;
+        body: string;
+        labels: string[];
+        userStoryId: string;
+        status?: string;
+    }>;
+    /**
+     * Read User Story frontmatter
+     */
+    private readUserStoryFrontmatter;
+    /**
+     * Extract "As a... I want... So that..." statement
+     */
+    private extractUserStoryStatement;
+    /**
+     * Extract Acceptance Criteria with AC-IDs and checkbox state
+     */
+    private extractAcceptanceCriteria;
+    /**
+     * Extract tasks from user story's ## Tasks section (NEW architecture)
+     *
+     * Previously: Read from increment tasks.md (LEGACY)
+     * Now: Read from user story's ## Tasks section directly
+     *
+     * This enables project-specific tasks with completion tracking per user story.
+     */
+    private extractTasks;
+    /**
+     * LEGACY: Extract tasks from increment's tasks.md (backward compatibility)
+     *
+     * Used as fallback when user story file doesn't have ## Tasks section.
+     */
+    private extractTasksLegacy;
+    /**
+     * Build complete issue body
+     */
+    private buildBody;
+    /**
+     * Build labels for the issue
+     */
+    private buildLabels;
+    /**
+     * Capitalize first letter
+     */
+    private capitalize;
+}
+//# sourceMappingURL=user-story-issue-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-story-issue-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/user-story-issue-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8BH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAGtB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAU7D;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAkCF;;OAEG;YACW,wBAAwB;IAWtC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmBjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqDjC;;;;;;;OAOG;YACW,YAAY;IAsC1B;;;;OAIG;YACW,kBAAkB;IAyFhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAmKjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}