specweave 0.21.2 → 0.21.3

package/dist/src/core/living-docs/SpecDistributor.js

@@ -0,0 +1,216 @@
+/**
+ * SpecDistributor - Copy-Based Sync Implementation
+ *
+ * Distributes (copies) ACs and Tasks from increment spec.md/tasks.md
+ * to User Story files in living docs.
+ *
+ * This is the core of the copy-based sync paradigm where:
+ * - Increment files = source of truth
+ * - Living docs = copy for stakeholder visibility
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { detectProject } from './ProjectDetector.js';
+/**
+ * SpecDistributor - Handles copying ACs and Tasks to User Story files
+ */
+export class SpecDistributor {
+    /**
+     * Copy ACs and Tasks from increment to User Story files
+     *
+     * @param incrementPath - Path to increment folder (e.g., .specweave/increments/0037-feature)
+     * @param livingDocsPath - Path to living docs folder (e.g., .specweave/docs/public/user-stories)
+     */
+    async copyAcsAndTasksToUserStories(incrementPath, livingDocsPath) {
+        // 1. Read increment spec.md and tasks.md
+        const specPath = path.join(incrementPath, 'spec.md');
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        const specContent = await fs.readFile(specPath, 'utf-8');
+        const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+        // 2. Parse ACs and Tasks
+        const acs = this.parseAcceptanceCriteria(specContent);
+        const tasks = this.parseTasks(tasksContent);
+        // 3. Group ACs by User Story ID
+        const acsByUserStory = this.groupAcsByUserStory(acs);
+        // 4. For each User Story, update its file
+        for (const [userStoryId, userStoryAcs] of Object.entries(acsByUserStory)) {
+            // Detect projects from ACs
+            const projects = this.detectProjectsFromAcs(userStoryAcs);
+            // Filter ACs by project (if multiple projects exist)
+            const filteredAcs = userStoryAcs; // For now, include all ACs
+            // Filter Tasks by AC-IDs
+            const acIds = filteredAcs.map(ac => ac.id);
+            const filteredTasks = this.filterTasksByAcIds(tasks, acIds);
+            // Update User Story file
+            const userStoryPath = await this.findUserStoryFile(livingDocsPath, userStoryId);
+            if (userStoryPath) {
+                await this.updateUserStoryFile(userStoryPath, filteredAcs, filteredTasks);
+            }
+        }
+    }
+    /**
+     * Parse acceptance criteria from spec.md
+     */
+    parseAcceptanceCriteria(specContent) {
+        const acs = [];
+        const lines = specContent.split('\n');
+        // Match lines like: - [ ] AC-US1-01: Description
+        const acRegex = /^- \[([ x])\] (AC-[A-Z0-9]+-\d+):\s*(.+)$/;
+        for (const line of lines) {
+            const match = line.match(acRegex);
+            if (match) {
+                const completed = match[1] === 'x';
+                const id = match[2];
+                const description = match[3];
+                // Extract User Story ID from AC ID (e.g., AC-US1-01 -> US1)
+                const userStoryMatch = id.match(/AC-([A-Z0-9]+)-\d+/);
+                const userStoryId = userStoryMatch ? userStoryMatch[1] : '';
+                // Detect projects from description
+                const projectResult = detectProject(description);
+                acs.push({
+                    id,
+                    userStoryId,
+                    description,
+                    completed,
+                    projects: projectResult.projects,
+                    rawLine: line
+                });
+            }
+        }
+        return acs;
+    }
+    /**
+     * Parse tasks from tasks.md
+     */
+    parseTasks(tasksContent) {
+        const tasks = [];
+        const lines = tasksContent.split('\n');
+        let currentTask = null;
+        for (const line of lines) {
+            // Match task header: ### T-001: Title (P1)
+            const headerMatch = line.match(/^### (T-\d+):\s*(.+?)\s*\(P\d+\)$/);
+            if (headerMatch) {
+                // Save previous task
+                if (currentTask && currentTask.id) {
+                    tasks.push(currentTask);
+                }
+                // Start new task
+                currentTask = {
+                    id: headerMatch[1],
+                    title: headerMatch[2],
+                    completed: false,
+                    acIds: []
+                };
+                continue;
+            }
+            // Check for completion date
+            const completedMatch = line.match(/^\*\*Completed\*\*:\s*(.+)$/);
+            if (completedMatch && currentTask) {
+                currentTask.completed = true;
+                currentTask.completedDate = completedMatch[1];
+            }
+            // Extract AC IDs from task (e.g., **AC**: AC-US1-01, AC-US1-02)
+            const acMatch = line.match(/\*\*AC\*\*:\s*(.+)$/);
+            if (acMatch && currentTask) {
+                const acIds = acMatch[1].split(',').map(id => id.trim());
+                currentTask.acIds = acIds;
+            }
+        }
+        // Save last task
+        if (currentTask && currentTask.id) {
+            tasks.push(currentTask);
+        }
+        return tasks;
+    }
+    /**
+     * Group ACs by User Story ID
+     */
+    groupAcsByUserStory(acs) {
+        const grouped = {};
+        for (const ac of acs) {
+            if (!grouped[ac.userStoryId]) {
+                grouped[ac.userStoryId] = [];
+            }
+            grouped[ac.userStoryId].push(ac);
+        }
+        return grouped;
+    }
+    /**
+     * Detect projects from ACs
+     */
+    detectProjectsFromAcs(acs) {
+        const allProjects = new Set();
+        for (const ac of acs) {
+            if (ac.projects) {
+                ac.projects.forEach(p => allProjects.add(p));
+            }
+        }
+        return Array.from(allProjects);
+    }
+    /**
+     * Filter tasks by AC IDs
+     */
+    filterTasksByAcIds(tasks, acIds) {
+        return tasks.filter(task => {
+            // Include task if it implements any of the AC IDs
+            return task.acIds.some(acId => acIds.includes(acId));
+        });
+    }
+    /**
+     * Find User Story file by ID
+     */
+    async findUserStoryFile(livingDocsPath, userStoryId) {
+        try {
+            // Look for files matching pattern: US1.md, us1.md, US-1.md, etc.
+            const files = await fs.readdir(livingDocsPath);
+            const pattern = new RegExp(`^${userStoryId.toLowerCase()}(-|_)?.*\\.md$`, 'i');
+            const matchingFile = files.find(f => pattern.test(f));
+            if (matchingFile) {
+                return path.join(livingDocsPath, matchingFile);
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update User Story file with ACs and Tasks
+     */
+    async updateUserStoryFile(filePath, acs, tasks) {
+        let content = await fs.readFile(filePath, 'utf-8');
+        // Update ## Acceptance Criteria section
+        content = this.updateSection(content, '## Acceptance Criteria', acs.map(ac => {
+            const checkbox = ac.completed ? '[x]' : '[ ]';
+            return `- ${checkbox} **${ac.id}**: ${ac.description}`;
+        }));
+        // Update ## Implementation section (Tasks)
+        content = this.updateSection(content, '## Implementation', [
+            ...tasks.map(task => {
+                const checkbox = task.completed ? '[x]' : '[ ]';
+                const dateStr = task.completedDate ? ` (completed ${task.completedDate})` : '';
+                return `- ${checkbox} **${task.id}**: ${task.title}${dateStr}`;
+            }),
+            '',
+            '> **Note**: Task status syncs from increment tasks.md'
+        ]);
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    /**
+     * Update a section in markdown content
+     */
+    updateSection(content, sectionHeader, lines) {
+        const sectionRegex = new RegExp(`(${sectionHeader}\\n)(.*?)(\\n#{1,2} |$)`, 's');
+        const match = content.match(sectionRegex);
+        if (match) {
+            // Replace section content
+            const newSection = `${sectionHeader}\n\n${lines.join('\n')}\n\n`;
+            return content.replace(sectionRegex, newSection + '$3');
+        }
+        else {
+            // Append section at end
+            return content + `\n\n${sectionHeader}\n\n${lines.join('\n')}\n`;
+        }
+    }
+}
+//# sourceMappingURL=SpecDistributor.js.map

package/dist/src/core/living-docs/SpecDistributor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpecDistributor.js","sourceRoot":"","sources":["../../../../src/core/living-docs/SpecDistributor.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/ThreeLayerSyncManager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Three-Layer Bidirectional Sync Manager
+ *
+ * Manages synchronization between three layers:
+ * 1. GitHub Issues (stakeholder UI)
+ * 2. Living Docs User Stories (intermediate)
+ * 3. Increment spec.md + tasks.md (source of truth)
+ *
+ * Sync flows:
+ * - GitHub → Living Docs → Increment (checkbox changes from stakeholders)
+ * - Increment → Living Docs → GitHub (implementation updates)
+ */
+/**
+ * Sync direction
+ */
+export type SyncDirection = 'github-to-increment' | 'increment-to-github' | 'bidirectional';
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    /** Number of ACs synced */
+    acsSynced: number;
+    /** Number of tasks synced */
+    tasksSynced: number;
+    /** Conflicts detected (Increment always wins) */
+    conflictsResolved: number;
+    /** Tasks reopened due to missing code */
+    tasksReopened: number;
+    /** Errors encountered */
+    errors: string[];
+    /** Warnings */
+    warnings: string[];
+}
+/**
+ * ThreeLayerSyncManager - Handles bidirectional sync
+ */
+export declare class ThreeLayerSyncManager {
+    private distributor;
+    private codeValidator;
+    private completionPropagator;
+    constructor();
+    /**
+     * Sync GitHub Issues → Living Docs → Increment
+     *
+     * Handles checkbox changes from stakeholders in GitHub.
+     *
+     * @param githubIssueId - GitHub issue number
+     * @param incrementPath - Path to increment
+     * @param livingDocsPath - Path to living docs
+     */
+    syncGitHubToIncrement(githubIssueId: number, incrementPath: string, livingDocsPath: string): Promise<SyncResult>;
+    /**
+     * Sync Increment → Living Docs → GitHub
+     *
+     * Propagates implementation changes to stakeholders.
+     *
+     * @param incrementPath - Path to increment
+     * @param livingDocsPath - Path to living docs
+     */
+    syncIncrementToGitHub(incrementPath: string, livingDocsPath: string): Promise<SyncResult>;
+    /**
+     * Bidirectional sync with conflict resolution
+     *
+     * Increment always wins in conflicts (source of truth discipline).
+     */
+    syncBidirectional(incrementPath: string, livingDocsPath: string): Promise<SyncResult>;
+    /**
+     * Reopen task if code validation fails
+     *
+     * @param taskId - Task ID to reopen
+     * @param incrementPath - Path to increment
+     * @param reason - Reason for reopening
+     */
+    reopenTask(taskId: string, incrementPath: string, reason: string): Promise<void>;
+    /**
+     * Fetch GitHub issue checkbox states
+     */
+    private fetchGitHubCheckboxStates;
+    /**
+     * Parse checkbox states from GitHub issue body
+     */
+    private parseCheckboxStatesFromBody;
+    /**
+     * Find User Story file by GitHub issue number
+     */
+    private findUserStoryByGitHubIssue;
+    /**
+     * Find all markdown files recursively
+     */
+    private findMarkdownFiles;
+    /**
+     * Update AC checkbox in content
+     */
+    private updateAcCheckboxInContent;
+    /**
+     * Update Task checkbox in content
+     */
+    private updateTaskCheckboxInContent;
+    /**
+     * Sync Living Docs changes to Increment
+     */
+    private syncLivingDocsToIncrement;
+    /**
+     * Parse ACs from content
+     */
+    private parseAcsFromContent;
+    /**
+     * Parse Tasks from content
+     */
+    private parseTasksFromContent;
+    /**
+     * Update task completion in tasks.md file
+     */
+    private updateTaskCompletionInTasksFile;
+}
+//# sourceMappingURL=ThreeLayerSyncManager.d.ts.map

package/dist/src/core/living-docs/ThreeLayerSyncManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeLayerSyncManager.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/ThreeLayerSyncManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,eAAe;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgBD;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAuB;;IAQnD;;;;;;;;OAQG;IACG,qBAAqB,CACzB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;IA8DtB;;;;;;;OAOG;IACG,qBAAqB,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;IAoCtB;;;;OAIG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;IAYtB;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCtF;;OAEG;YACW,yBAAyB;IAYvC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA8BnC;;OAEG;YACW,0BAA0B;IAuBxC;;OAEG;YACW,iBAAiB;IAqB/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAMnC;;OAEG;YACW,yBAAyB;IAiCvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,+BAA+B;CAYxC"}