specweave 0.14.0 → 0.15.0

package/dist/src/core/specs/spec-parser.js

@@ -0,0 +1,276 @@
+/**
+ * Spec Parser
+ *
+ * Advanced parsing utilities for spec.md files
+ * Extracts user stories, acceptance criteria, increments, etc.
+ *
+ * @module spec-parser
+ */
+import matter from 'gray-matter';
+export class SpecParser {
+    /**
+     * Parse complete user story including acceptance criteria
+     */
+    static parseUserStory(markdown, usId) {
+        // Pattern: **US-001**: As a X, I want Y so that Z
+        const usPattern = new RegExp(`\\*\\*${usId}\\*\\*:\\s*(.+?)(?=\\n|$)`, 'g');
+        const match = usPattern.exec(markdown);
+        if (!match) {
+            return null;
+        }
+        const title = match[1].trim();
+        const acceptanceCriteria = this.parseAcceptanceCriteria(markdown, usId);
+        // Determine status from AC completion
+        let status = 'todo';
+        if (acceptanceCriteria.length > 0) {
+            const completedCount = acceptanceCriteria.filter(ac => ac.status === 'done').length;
+            if (completedCount === acceptanceCriteria.length) {
+                status = 'done';
+            }
+            else if (completedCount > 0) {
+                status = 'in-progress';
+            }
+        }
+        // Try to extract priority (look for P1, P2, P3 markers)
+        let priority = 'P1';
+        const priorityMatch = markdown.match(new RegExp(`${usId}[\\s\\S]{0,200}?\\(P([123])\\)`));
+        if (priorityMatch) {
+            priority = `P${priorityMatch[1]}`;
+        }
+        return {
+            id: usId,
+            title,
+            status,
+            priority,
+            acceptanceCriteria
+        };
+    }
+    /**
+     * Parse all user stories from markdown
+     */
+    static parseAllUserStories(markdown) {
+        const stories = [];
+        // Find all US-XXX patterns
+        const usPattern = /\*\*US-(\d+)\*\*:/g;
+        const matches = markdown.matchAll(usPattern);
+        const processedIds = new Set();
+        for (const match of matches) {
+            const usId = `US-${match[1]}`;
+            if (processedIds.has(usId)) {
+                continue; // Skip duplicates
+            }
+            processedIds.add(usId);
+            const story = this.parseUserStory(markdown, usId);
+            if (story) {
+                stories.push(story);
+            }
+        }
+        return stories;
+    }
+    /**
+     * Parse acceptance criteria for a user story
+     */
+    static parseAcceptanceCriteria(markdown, usId) {
+        const criteria = [];
+        // Extract the number from US-001 → 001
+        const usNumber = usId.replace('US-', '');
+        // Pattern: - [ ] **AC-001-01**: Description
+        // or: - [x] **AC-001-01**: Description
+        const acPattern = new RegExp(`- \\[([x ])\\] \\*\\*AC-${usNumber}-(\\d+)\\*\\*:\\s*(.+?)(?=\\n|$)`, 'g');
+        const matches = markdown.matchAll(acPattern);
+        for (const match of matches) {
+            const isDone = match[1] === 'x';
+            const acNumber = match[2];
+            const description = match[3].trim();
+            // Try to extract priority and testability markers
+            // Example: (P1, testable)
+            const metaMatch = description.match(/\(([^)]+)\)/);
+            let priority;
+            let testable;
+            if (metaMatch) {
+                const meta = metaMatch[1];
+                if (meta.includes('P1'))
+                    priority = 'P1';
+                if (meta.includes('P2'))
+                    priority = 'P2';
+                if (meta.includes('P3'))
+                    priority = 'P3';
+                if (meta.includes('testable'))
+                    testable = true;
+                if (meta.includes('not testable'))
+                    testable = false;
+            }
+            // Remove metadata from description
+            const cleanDescription = description.replace(/\s*\([^)]+\)\s*$/, '').trim();
+            criteria.push({
+                id: `AC-${usNumber}-${acNumber}`,
+                description: cleanDescription,
+                status: isDone ? 'done' : 'todo',
+                priority,
+                testable
+            });
+        }
+        return criteria;
+    }
+    /**
+     * Parse increment references from markdown
+     */
+    static parseIncrementReferences(markdown) {
+        const increments = [];
+        // Look for increment table
+        // Example: | **0001-core-framework** | ✅ Complete | 2025-10-15 | Initial CLI |
+        const tablePattern = /\|\s*\*\*(\d{4}-[\w-]+)\*\*\s*\|\s*([✅❌⏳])?\s*(\w+)\s*\|\s*([0-9-]+)?\s*\|\s*(.+?)\s*\|/g;
+        const matches = markdown.matchAll(tablePattern);
+        for (const match of matches) {
+            const id = match[1];
+            const statusIcon = match[2];
+            const statusText = match[3].toLowerCase();
+            const completedAt = match[4] || undefined;
+            const notes = match[5]?.trim() || undefined;
+            let status;
+            if (statusText.includes('complete') || statusIcon === '✅') {
+                status = 'complete';
+            }
+            else if (statusText.includes('progress') || statusText.includes('active') || statusIcon === '⏳') {
+                status = 'in-progress';
+            }
+            else if (statusText.includes('abandon') || statusText.includes('cancel') || statusIcon === '❌') {
+                status = 'abandoned';
+            }
+            else {
+                status = 'planned';
+            }
+            // Try to extract which user stories this increment implemented
+            // Look for patterns like "Implements: US-001, US-002"
+            const userStories = [];
+            const usRefPattern = /US-\d+/g;
+            const usMatches = notes?.matchAll(usRefPattern);
+            if (usMatches) {
+                for (const usMatch of usMatches) {
+                    userStories.push(usMatch[0]);
+                }
+            }
+            increments.push({
+                id,
+                status,
+                completedAt,
+                userStories,
+                notes
+            });
+        }
+        return increments;
+    }
+    /**
+     * Extract frontmatter from markdown
+     */
+    static extractFrontmatter(markdown) {
+        try {
+            const parsed = matter(markdown);
+            return parsed.data;
+        }
+        catch (error) {
+            console.error('Error parsing frontmatter:', error);
+            return {};
+        }
+    }
+    /**
+     * Extract overview section
+     */
+    static extractOverview(markdown) {
+        const overviewMatch = markdown.match(/##\s+Overview\s+([\s\S]*?)(?=\n##\s+|\n---\s+|$)/);
+        return overviewMatch ? overviewMatch[1].trim() : '';
+    }
+    /**
+     * Extract external references section
+     */
+    static extractExternalReferences(markdown) {
+        const refs = {};
+        // Look for external references section
+        const extRefSection = markdown.match(/##\s+External References\s+([\s\S]*?)(?=\n##\s+|\n---\s+|$)/);
+        if (extRefSection) {
+            const content = extRefSection[1];
+            // GitHub Project: URL or ID
+            const githubMatch = content.match(/GitHub Project:\s*(.+)/);
+            if (githubMatch) {
+                refs.github = githubMatch[1].trim();
+            }
+            // Jira Epic: URL or Key
+            const jiraMatch = content.match(/Jira Epic:\s*(.+)/);
+            if (jiraMatch) {
+                refs.jira = jiraMatch[1].trim();
+            }
+            // ADO Feature: URL or ID
+            const adoMatch = content.match(/(?:ADO|Azure DevOps) Feature:\s*(.+)/);
+            if (adoMatch) {
+                refs.ado = adoMatch[1].trim();
+            }
+        }
+        return refs;
+    }
+    /**
+     * Calculate overall progress
+     */
+    static calculateProgress(userStories) {
+        if (!userStories || userStories.length === 0) {
+            return {
+                totalUserStories: 0,
+                completedUserStories: 0,
+                inProgressUserStories: 0,
+                todoUserStories: 0,
+                percentComplete: 0
+            };
+        }
+        const completed = userStories.filter(us => us.status === 'done').length;
+        const inProgress = userStories.filter(us => us.status === 'in-progress').length;
+        const todo = userStories.filter(us => us.status === 'todo').length;
+        return {
+            totalUserStories: userStories.length,
+            completedUserStories: completed,
+            inProgressUserStories: inProgress,
+            todoUserStories: todo,
+            percentComplete: Math.round((completed / userStories.length) * 100)
+        };
+    }
+    /**
+     * Find user stories by status
+     */
+    static filterUserStories(userStories, status, priority) {
+        let filtered = userStories;
+        if (status) {
+            filtered = filtered.filter(us => us.status === status);
+        }
+        if (priority) {
+            filtered = filtered.filter(us => us.priority === priority);
+        }
+        return filtered;
+    }
+    /**
+     * Find user story by ID
+     */
+    static findUserStory(userStories, usId) {
+        return userStories.find(us => us.id === usId);
+    }
+    /**
+     * Update user story status in markdown
+     */
+    static updateUserStoryStatus(markdown, usId, newStatus) {
+        // This is a simple implementation - in reality we'd update all AC checkboxes
+        // For 'done', check all boxes for this US
+        // For 'in-progress', check some boxes
+        // For 'todo', uncheck all boxes
+        if (newStatus === 'done') {
+            // Find all AC for this US and check them
+            const usNumber = usId.replace('US-', '');
+            const acPattern = new RegExp(`- \\[ \\] \\*\\*AC-${usNumber}-(\\d+)\\*\\*:`, 'g');
+            return markdown.replace(acPattern, `- [x] **AC-${usNumber}-$1**:`);
+        }
+        else if (newStatus === 'todo') {
+            // Uncheck all AC for this US
+            const usNumber = usId.replace('US-', '');
+            const acPattern = new RegExp(`- \\[x\\] \\*\\*AC-${usNumber}-(\\d+)\\*\\*:`, 'g');
+            return markdown.replace(acPattern, `- [ ] **AC-${usNumber}-$1**:`);
+        }
+        return markdown; // in-progress doesn't change markdown directly
+    }
+}
+//# sourceMappingURL=spec-parser.js.map

package/dist/src/core/specs/spec-parser.js.map

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

package/dist/src/core/sync/bidirectional-engine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Bidirectional Sync Engine
+ *
+ * Handles synchronization between SpecWeave increments and external systems
+ * (GitHub, Jira, ADO) in both directions with conflict detection and resolution.
+ *
+ * Features:
+ * - Bidirectional sync (to-external, from-external, both)
+ * - Conflict detection (field-level granularity)
+ * - Interactive conflict resolution
+ * - Change tracking (detect what changed since last sync)
+ * - Reorganization detection (moved issues, split/merged stories)
+ */
+import { SyncProvider } from '../types/sync-profile';
+export type SyncDirection = 'to-external' | 'from-external' | 'bidirectional';
+export type ConflictResolution = 'prefer-local' | 'prefer-external' | 'manual' | 'prompt';
+export interface SyncState {
+    /** Increment metadata */
+    incrementId: string;
+    title: string;
+    status: string;
+    /** External metadata */
+    externalId?: string;
+    externalKey?: string;
+    externalUrl?: string;
+    /** Sync state */
+    lastSyncAt?: string;
+    lastLocalChange?: string;
+    lastExternalChange?: string;
+    /** Content hashes (for change detection) */
+    localHash?: string;
+    externalHash?: string;
+    /** Linked items (user stories, tasks, etc.) */
+    linkedItems?: Record<string, string>;
+}
+export interface FieldChange {
+    field: string;
+    localValue: any;
+    externalValue: any;
+    lastSyncValue?: any;
+}
+export interface Conflict extends FieldChange {
+    resolution?: 'local' | 'external' | 'merged';
+    mergedValue?: any;
+}
+export interface ChangeSet {
+    /** Changes to sync to external */
+    toExternal: FieldChange[];
+    /** Changes to sync from external */
+    fromExternal: FieldChange[];
+    /** Conflicts (both sides changed) */
+    conflicts: Conflict[];
+}
+export interface SyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    changes: ChangeSet;
+    conflictsResolved: number;
+    errors: string[];
+}
+export declare class BidirectionalSyncEngine {
+    private provider;
+    private projectRoot;
+    constructor(provider: SyncProvider, projectRoot?: string);
+    /**
+     * Main sync orchestrator
+     */
+    sync(incrementId: string, direction: SyncDirection, conflictResolution?: ConflictResolution): Promise<SyncResult>;
+    /**
+     * Detect changes in both local and external state
+     */
+    private detectChanges;
+    /**
+     * Fetch local state from increment files
+     */
+    private fetchLocalState;
+    /**
+     * Fetch external state from Jira/GitHub/ADO
+     */
+    private fetchExternalState;
+    /**
+     * Resolve conflicts interactively or automatically
+     */
+    private resolveConflicts;
+    /**
+     * Interactive conflict resolution prompt
+     */
+    private promptConflictResolution;
+    /**
+     * Apply changes to external system
+     */
+    private applyToExternal;
+    /**
+     * Apply changes to local increment
+     */
+    private applyToLocal;
+    /**
+     * Load sync state from metadata
+     */
+    private loadSyncState;
+    /**
+     * Update sync state in metadata
+     */
+    private updateSyncState;
+    /**
+     * Print sync summary
+     */
+    private printSyncSummary;
+}
+//# sourceMappingURL=bidirectional-engine.d.ts.map

package/dist/src/core/sync/bidirectional-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidirectional-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/bidirectional-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMrD,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7C,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1B,oCAAoC;IACpC,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qCAAqC;IACrC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;gBADX,QAAQ,EAAE,YAAY,EACtB,WAAW,GAAE,MAAsB;IAG7C;;OAEG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,EACxB,kBAAkB,GAAE,kBAA6B,GAChD,OAAO,CAAC,UAAU,CAAC;IA2FtB;;OAEG;YACW,aAAa;IAuD3B;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,wBAAwB;IAiDtC;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,YAAY;IA2C1B;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,eAAe;IAmC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}