specweave 1.0.464 → 1.0.466

package/dist/plugins/specweave/lib/vendor/generators/spec/task-parser.js

@@ -0,0 +1,300 @@
+/**
+ * Task Parser with US-Task Linkage Support
+ *
+ * Parses tasks.md files to extract task metadata including new US linkage fields:
+ * - userStory: US-ID this task implements (e.g., "US-001")
+ * - satisfiesACs: List of AC-IDs this task satisfies (e.g., ["AC-US1-01", "AC-US1-02"])
+ *
+ * Supports hierarchical task structure grouped by User Story.
+ */
+import { readFileSync } from 'fs';
+/**
+ * Parse task status from checkbox and status text
+ */
+function parseTaskStatus(checkbox, statusText) {
+    if (checkbox === 'x')
+        return 'completed';
+    if (statusText.includes('progress'))
+        return 'in_progress';
+    if (statusText.includes('transfer'))
+        return 'transferred';
+    if (statusText.includes('cancel'))
+        return 'canceled';
+    return 'pending';
+}
+/**
+ * Parse tasks.md and extract all tasks with US linkage
+ *
+ * @param tasksPath - Path to tasks.md file
+ * @returns Map of User Story ID → Tasks
+ * @throws Error if tasks.md cannot be read or is malformed
+ */
+export function parseTasksWithUSLinks(tasksPath) {
+    try {
+        const content = readFileSync(tasksPath, 'utf-8');
+        const tasks = {};
+        // Split content into lines for line number tracking
+        const lines = content.split('\n');
+        // Regex patterns for task parsing (T-029: Support E suffix for external IDs)
+        // Updated: Support 3+ digits for T-XXX and US-XXX (Y2K fix)
+        const taskHeaderRegex = /^###\s+(T-\d{3,}E?):\s*(.+)$/;
+        const userStoryRegex = /^\*\*User Story\*\*:\s*(US-\d{3,}E?)/;
+        const satisfiesACsRegex = /^\*\*Satisfies ACs\*\*:\s*(AC-US\d+E?-\d{2}(?:,\s*AC-US\d+E?-\d{2})*)/;
+        const statusRegex = /^\*\*Status\*\*:\s*\[([x ])\]\s*(\w+)/;
+        const priorityRegex = /^\*\*Priority\*\*:\s*(.+)/;
+        const estimatedEffortRegex = /^\*\*Estimated Effort\*\*:\s*(.+)/;
+        const dependenciesRegex = /^\*\*Dependencies\*\*:\s*(.+)/;
+        let currentTask = null;
+        let currentDescription = [];
+        let currentSection = 'none';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNumber = i + 1;
+            // Check for task header (### T-XXX: Title)
+            const taskHeaderMatch = line.match(taskHeaderRegex);
+            if (taskHeaderMatch) {
+                // Save previous task if exists
+                if (currentTask) {
+                    saveTask(tasks, currentTask, currentDescription);
+                }
+                // Start new task
+                currentTask = {
+                    id: taskHeaderMatch[1],
+                    title: taskHeaderMatch[2],
+                    status: 'pending',
+                    lineNumber
+                };
+                currentDescription = [];
+                currentSection = 'none';
+                continue;
+            }
+            // Skip if no current task
+            if (!currentTask)
+                continue;
+            // Parse task fields
+            const userStoryMatch = line.match(userStoryRegex);
+            if (userStoryMatch) {
+                currentTask.userStory = userStoryMatch[1];
+                continue;
+            }
+            const satisfiesACsMatch = line.match(satisfiesACsRegex);
+            if (satisfiesACsMatch) {
+                // Split comma-separated AC-IDs and trim whitespace
+                currentTask.satisfiesACs = satisfiesACsMatch[1]
+                    .split(',')
+                    .map(ac => ac.trim());
+                continue;
+            }
+            const statusMatch = line.match(statusRegex);
+            if (statusMatch) {
+                const checkbox = statusMatch[1];
+                const statusText = statusMatch[2].toLowerCase();
+                currentTask.status = parseTaskStatus(checkbox, statusText);
+                continue;
+            }
+            const priorityMatch = line.match(priorityRegex);
+            if (priorityMatch) {
+                currentTask.priority = priorityMatch[1];
+                continue;
+            }
+            const estimatedEffortMatch = line.match(estimatedEffortRegex);
+            if (estimatedEffortMatch) {
+                currentTask.estimatedEffort = estimatedEffortMatch[1];
+                continue;
+            }
+            const dependenciesMatch = line.match(dependenciesRegex);
+            if (dependenciesMatch) {
+                // Parse dependencies (T-001, T-002, T-1000, etc.)
+                currentTask.dependencies = dependenciesMatch[1]
+                    .split(',')
+                    .map(dep => dep.trim())
+                    .filter(dep => dep.match(/^T-\d{3,}$/));
+                continue;
+            }
+            // Track sections for description parsing
+            if (line.startsWith('**Description**:')) {
+                currentSection = 'description';
+                continue;
+            }
+            if (line.startsWith('**Implementation Steps**:')) {
+                currentSection = 'implementation';
+                continue;
+            }
+            if (line.startsWith('**Test Plan**:')) {
+                currentSection = 'test';
+                continue;
+            }
+            if (line.startsWith('**Files Affected**:')) {
+                currentSection = 'files';
+                currentTask.filesAffected = [];
+                continue;
+            }
+            // Collect description lines
+            if (currentSection === 'description' && line.trim() && !line.startsWith('**')) {
+                currentDescription.push(line.trim());
+            }
+            // Collect files affected
+            if (currentSection === 'files' && line.trim().startsWith('- `')) {
+                const filePath = line.trim().replace(/^- `(.+)`/, '$1');
+                if (currentTask.filesAffected) {
+                    currentTask.filesAffected.push(filePath);
+                }
+            }
+        }
+        // Save last task
+        if (currentTask) {
+            saveTask(tasks, currentTask, currentDescription);
+        }
+        return tasks;
+    }
+    catch (error) {
+        throw new Error(`Failed to parse tasks.md at ${tasksPath}: ${error}`);
+    }
+}
+/**
+ * Helper: Save task to tasks map, grouped by User Story
+ */
+function saveTask(tasks, task, description) {
+    // Set description
+    if (description.length > 0) {
+        task.description = description.join(' ');
+    }
+    // Group by User Story (or "unassigned" if no userStory field)
+    const usId = task.userStory || 'unassigned';
+    if (!tasks[usId]) {
+        tasks[usId] = [];
+    }
+    tasks[usId].push(task);
+}
+/**
+ * Validate task US and AC linkage
+ *
+ * @param task - Task to validate
+ * @param validUSIds - List of valid US-IDs from spec.md
+ * @param validACIds - List of valid AC-IDs from spec.md
+ * @returns Array of validation errors (empty if valid)
+ */
+export function validateTaskLinkage(task, validUSIds, validACIds) {
+    const errors = [];
+    // Validate userStory field
+    if (task.userStory) {
+        // Check format (US-XXX, 3+ digits)
+        if (!task.userStory.match(/^US-\d{3,}$/)) {
+            errors.push({
+                taskId: task.id,
+                field: 'userStory',
+                value: task.userStory,
+                message: `Invalid US-ID format: "${task.userStory}" (expected format: US-001 or US-1000)`,
+                suggestedFix: 'Use format: US-XXX where XXX is 3 or more digits'
+            });
+        }
+        // Check if US exists in spec.md
+        else if (!validUSIds.includes(task.userStory)) {
+            errors.push({
+                taskId: task.id,
+                field: 'userStory',
+                value: task.userStory,
+                message: `User Story ${task.userStory} not found in spec.md`,
+                suggestedFix: `Valid User Stories: ${validUSIds.join(', ')}`
+            });
+        }
+    }
+    // Validate satisfiesACs field
+    if (task.satisfiesACs && task.satisfiesACs.length > 0) {
+        for (const acId of task.satisfiesACs) {
+            // Check format (AC-USXX-YY)
+            if (!acId.match(/^AC-US\d+-\d{2}$/)) {
+                errors.push({
+                    taskId: task.id,
+                    field: 'satisfiesACs',
+                    value: acId,
+                    message: `Invalid AC-ID format: "${acId}" (expected format: AC-US1-01)`,
+                    suggestedFix: 'Use format: AC-USXX-YY where XX is US number, YY is AC number'
+                });
+                continue;
+            }
+            // Check if AC exists in spec.md
+            if (!validACIds.includes(acId)) {
+                errors.push({
+                    taskId: task.id,
+                    field: 'satisfiesACs',
+                    value: acId,
+                    message: `Acceptance Criteria ${acId} not found in spec.md`,
+                    suggestedFix: `Check spec.md for valid AC-IDs in this User Story`
+                });
+                continue;
+            }
+            // Check if AC belongs to correct User Story
+            if (task.userStory) {
+                const acUSNumber = extractUSNumberFromACId(acId);
+                const taskUSNumber = extractUSNumber(task.userStory);
+                if (acUSNumber !== taskUSNumber) {
+                    errors.push({
+                        taskId: task.id,
+                        field: 'satisfiesACs',
+                        value: acId,
+                        message: `AC ${acId} belongs to US-${String(acUSNumber).padStart(3, '0')}, but task is linked to ${task.userStory}`,
+                        suggestedFix: `Either link task to US-${String(acUSNumber).padStart(3, '0')} or use different AC-ID`
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Extract US number from AC-ID (AC-US1-01 → 1)
+ */
+function extractUSNumberFromACId(acId) {
+    const match = acId.match(/^AC-US(\d+)-\d{2}$/);
+    return match ? parseInt(match[1], 10) : -1;
+}
+/**
+ * Extract US number from US-ID (US-001 → 1, US-1000 → 1000)
+ */
+function extractUSNumber(usId) {
+    const match = usId.match(/^US-(\d{3,})$/);
+    return match ? parseInt(match[1], 10) : -1;
+}
+/**
+ * Get all tasks (flattened, not grouped by US)
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Array of all tasks
+ */
+export function getAllTasks(tasksByUS) {
+    return Object.values(tasksByUS).flat();
+}
+/**
+ * Count tasks by status
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Map of status → count
+ */
+export function countTasksByStatus(tasksByUS) {
+    const counts = {
+        pending: 0,
+        in_progress: 0,
+        completed: 0,
+        transferred: 0,
+        canceled: 0
+    };
+    for (const task of getAllTasks(tasksByUS)) {
+        counts[task.status]++;
+    }
+    return counts;
+}
+/**
+ * Calculate completion percentage
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Completion percentage (0-100)
+ */
+export function calculateCompletionPercentage(tasksByUS) {
+    const allTasks = getAllTasks(tasksByUS);
+    if (allTasks.length === 0)
+        return 0;
+    const completedTasks = allTasks.filter(t => t.status === 'completed').length;
+    return Math.round((completedTasks / allTasks.length) * 100);
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/plugins/specweave/lib/vendor/generators/spec/task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.js","sourceRoot":"","sources":["../../../../src/generators/spec/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAgElC;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,UAAkB;IAC3D,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,aAAa,CAAC;IAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,aAAa,CAAC;IAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,UAAU,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,GAAqB,EAAE,CAAC;QAEnC,oDAAoD;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,6EAA6E;QAC7E,4DAA4D;QAC5D,MAAM,eAAe,GAAG,8BAA8B,CAAC;QACvD,MAAM,cAAc,GAAG,sCAAsC,CAAC;QAC9D,MAAM,iBAAiB,GAAG,uEAAuE,CAAC;QAClG,MAAM,WAAW,GAAG,uCAAuC,CAAC;QAC5D,MAAM,aAAa,GAAG,2BAA2B,CAAC;QAClD,MAAM,oBAAoB,GAAG,mCAAmC,CAAC;QACjE,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;QAE1D,IAAI,WAAW,GAAgB,IAAI,CAAC;QACpC,IAAI,kBAAkB,GAAa,EAAE,CAAC;QACtC,IAAI,cAAc,GAAiE,MAAM,CAAC;QAE1F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;YAEzB,2CAA2C;YAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,eAAe,EAAE,CAAC;gBACpB,+BAA+B;gBAC/B,IAAI,WAAW,EAAE,CAAC;oBAChB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;gBACnD,CAAC;gBAED,iBAAiB;gBACjB,WAAW,GAAG;oBACZ,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;oBACtB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;oBACzB,MAAM,EAAE,SAAS;oBACjB,UAAU;iBACX,CAAC;gBACF,kBAAkB,GAAG,EAAE,CAAC;gBACxB,cAAc,GAAG,MAAM,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,0BAA0B;YAC1B,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,oBAAoB;YACpB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAClD,IAAI,cAAc,EAAE,CAAC;gBACnB,WAAW,CAAC,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;gBAC1C,SAAS;YACX,CAAC;YAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACxD,IAAI,iBAAiB,EAAE,CAAC;gBACtB,mDAAmD;gBACnD,WAAW,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC;qBAC5C,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBAEhD,WAAW,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAC3D,SAAS;YACX,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAChD,IAAI,aAAa,EAAE,CAAC;gBAClB,WAAW,CAAC,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBACxC,SAAS;YACX,CAAC;YAED,MAAM,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC9D,IAAI,oBAAoB,EAAE,CAAC;gBACzB,WAAW,CAAC,eAAe,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;gBACtD,SAAS;YACX,CAAC;YAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACxD,IAAI,iBAAiB,EAAE,CAAC;gBACtB,kDAAkD;gBAClD,WAAW,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC;qBAC5C,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;qBACtB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC1C,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACxC,cAAc,GAAG,aAAa,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAAE,CAAC;gBACjD,cAAc,GAAG,gBAAgB,CAAC;gBAClC,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACtC,cAAc,GAAG,MAAM,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAC3C,cAAc,GAAG,OAAO,CAAC;gBACzB,WAAW,CAAC,aAAa,GAAG,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YAED,4BAA4B;YAC5B,IAAI,cAAc,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9E,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;YAED,yBAAyB;YACzB,IAAI,cAAc,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACxD,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;oBAC9B,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,WAAW,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,KAAuB,EAAE,IAAU,EAAE,WAAqB;IAC1E,kBAAkB;IAClB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,8DAA8D;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC;IAE5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAU,EACV,UAAoB,EACpB,UAAoB;IAEpB,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,2BAA2B;IAC3B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,mCAAmC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,OAAO,EAAE,0BAA0B,IAAI,CAAC,SAAS,wCAAwC;gBACzF,YAAY,EAAE,kDAAkD;aACjE,CAAC,CAAC;QACL,CAAC;QACD,gCAAgC;aAC3B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,OAAO,EAAE,cAAc,IAAI,CAAC,SAAS,uBAAuB;gBAC5D,YAAY,EAAE,uBAAuB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,4BAA4B;YAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,KAAK,EAAE,cAAc;oBACrB,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,0BAA0B,IAAI,gCAAgC;oBACvE,YAAY,EAAE,+DAA+D;iBAC9E,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,gCAAgC;YAChC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,KAAK,EAAE,cAAc;oBACrB,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,uBAAuB,IAAI,uBAAuB;oBAC3D,YAAY,EAAE,mDAAmD;iBAClE,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,4CAA4C;YAC5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAErD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC;wBACV,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,KAAK,EAAE,cAAc;wBACrB,KAAK,EAAE,IAAI;wBACX,OAAO,EAAE,MAAM,IAAI,kBAAkB,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,2BAA2B,IAAI,CAAC,SAAS,EAAE;wBACnH,YAAY,EAAE,0BAA0B,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,yBAAyB;qBACrG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,SAA2B;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA2B;IAC5D,MAAM,MAAM,GAA+B;QACzC,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;KACZ,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,SAA2B;IACvE,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC7E,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/plugins/specweave/lib/vendor/sync/config.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Sync Config — Permission Presets & Config Validation
+ *
+ * ADR-0236: Named presets replace 8+ booleans.
+ * 4 presets: read-only, push-only, bidirectional, full-control
+ * With optional per-flag overrides.
+ */
+export type SyncPreset = 'read-only' | 'push-only' | 'bidirectional' | 'full-control';
+export interface SyncPermissions {
+    canRead: boolean;
+    canUpdateStatus: boolean;
+    canUpsert: boolean;
+    canDelete: boolean;
+}
+/** Legacy settings from the old boolean-based system */
+export interface LegacySyncSettings {
+    canUpsertInternalItems?: boolean;
+    canUpdateExternalItems?: boolean;
+    canUpdateStatus?: boolean;
+    autoSyncOnCompletion?: boolean;
+}
+export declare const PRESET_DEFAULTS: Record<SyncPreset, SyncPermissions>;
+/**
+ * Resolve effective permissions from preset + overrides + legacy settings.
+ *
+ * Priority: preset → overrides → effective
+ * If no preset, falls back to legacy boolean settings.
+ */
+export declare function resolvePermissions(preset?: SyncPreset, overrides?: Partial<SyncPermissions>, legacySettings?: LegacySyncSettings): SyncPermissions;
+export interface SyncConfigIssue {
+    type: 'contradiction' | 'warning' | 'failure';
+    message: string;
+    suggestedFix: string;
+}
+interface PartialSyncConfig {
+    enabled?: boolean;
+    settings?: {
+        canUpsertInternalItems?: boolean;
+        canUpdateExternalItems?: boolean;
+        canUpdateStatus?: boolean;
+        autoSyncOnCompletion?: boolean;
+    };
+    github?: {
+        enabled?: boolean;
+        owner?: string;
+        repo?: string;
+    };
+    jira?: {
+        enabled?: boolean;
+        domain?: string;
+        projectKey?: string;
+    };
+    ado?: {
+        enabled?: boolean;
+        organization?: string;
+        project?: string;
+    };
+    preset?: SyncPreset;
+    profiles?: Record<string, {
+        provider?: string;
+        config?: Record<string, unknown>;
+    }>;
+}
+interface PlatformSyncMetadata {
+    lastSyncResult?: string;
+    lastImportCount?: number;
+}
+/**
+ * Validate sync configuration for consistency and report issues.
+ */
+export declare function validateSyncConfigConsistency(config: PartialSyncConfig, syncMetadata?: Record<string, PlatformSyncMetadata>): SyncConfigIssue[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/plugins/specweave/lib/vendor/sync/config.js

@@ -0,0 +1,132 @@
+/**
+ * Sync Config — Permission Presets & Config Validation
+ *
+ * ADR-0236: Named presets replace 8+ booleans.
+ * 4 presets: read-only, push-only, bidirectional, full-control
+ * With optional per-flag overrides.
+ */
+// ---------------------------------------------------------------------------
+// Preset defaults
+// ---------------------------------------------------------------------------
+export const PRESET_DEFAULTS = {
+    'read-only': {
+        canRead: true,
+        canUpdateStatus: false,
+        canUpsert: false,
+        canDelete: false,
+    },
+    'push-only': {
+        canRead: false,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: false,
+    },
+    bidirectional: {
+        canRead: true,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: false,
+    },
+    'full-control': {
+        canRead: true,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: true,
+    },
+};
+// ---------------------------------------------------------------------------
+// Permission resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve effective permissions from preset + overrides + legacy settings.
+ *
+ * Priority: preset → overrides → effective
+ * If no preset, falls back to legacy boolean settings.
+ */
+export function resolvePermissions(preset, overrides, legacySettings) {
+    let base;
+    if (preset && PRESET_DEFAULTS[preset]) {
+        base = { ...PRESET_DEFAULTS[preset] };
+    }
+    else if (legacySettings) {
+        // Backward compat: map old booleans to new permissions
+        base = {
+            canRead: legacySettings.canUpdateExternalItems ?? true,
+            canUpdateStatus: legacySettings.canUpdateStatus ?? true,
+            canUpsert: legacySettings.canUpsertInternalItems ?? true,
+            canDelete: false, // legacy system had no delete
+        };
+    }
+    else {
+        // Default to read-only
+        base = { ...PRESET_DEFAULTS['read-only'] };
+    }
+    if (overrides) {
+        if (overrides.canRead !== undefined)
+            base.canRead = overrides.canRead;
+        if (overrides.canUpdateStatus !== undefined)
+            base.canUpdateStatus = overrides.canUpdateStatus;
+        if (overrides.canUpsert !== undefined)
+            base.canUpsert = overrides.canUpsert;
+        if (overrides.canDelete !== undefined)
+            base.canDelete = overrides.canDelete;
+    }
+    return base;
+}
+/**
+ * Validate sync configuration for consistency and report issues.
+ */
+export function validateSyncConfigConsistency(config, syncMetadata) {
+    const issues = [];
+    // Check: enabled=false with write flags=true
+    if (config.enabled === false && config.settings) {
+        const { canUpsertInternalItems, canUpdateExternalItems, canUpdateStatus } = config.settings;
+        if (canUpsertInternalItems || canUpdateExternalItems || canUpdateStatus) {
+            issues.push({
+                type: 'contradiction',
+                message: 'Sync is disabled but write permissions are enabled. The effective behavior is disabled (sync.enabled=false overrides all).',
+                suggestedFix: 'Either set sync.enabled=true to use the permissions, or set all permission flags to false.',
+            });
+        }
+    }
+    // Check: provider enabled but incomplete config (legacy format only)
+    // Skip these checks when the provider is configured via profiles instead
+    if (config.enabled !== false) {
+        const profileProviders = new Set(Object.values(config.profiles ?? {}).map((p) => p.provider).filter(Boolean));
+        if (config.github?.enabled && !config.github.owner && !config.github.repo && !profileProviders.has('github')) {
+            issues.push({
+                type: 'warning',
+                message: 'GitHub sync enabled but github.owner and github.repo are not configured.',
+                suggestedFix: 'Set sync.github.owner and sync.github.repo in config.json, or run /sw:sync-setup.',
+            });
+        }
+        if (config.jira?.enabled && !config.jira.domain && !profileProviders.has('jira')) {
+            issues.push({
+                type: 'warning',
+                message: 'JIRA sync enabled but jira.domain is not configured.',
+                suggestedFix: 'Set sync.jira.domain and sync.jira.projectKey in config.json.',
+            });
+        }
+        if (config.ado?.enabled && !config.ado.organization && !profileProviders.has('ado')) {
+            issues.push({
+                type: 'warning',
+                message: 'ADO sync enabled but ado.organization is not configured.',
+                suggestedFix: 'Set sync.ado.organization and sync.ado.project in config.json.',
+            });
+        }
+    }
+    // Check sync metadata for failures
+    if (syncMetadata) {
+        for (const [platform, meta] of Object.entries(syncMetadata)) {
+            if (meta.lastSyncResult === 'failed') {
+                issues.push({
+                    type: 'failure',
+                    message: `${platform} sync last result was "failed" with ${meta.lastImportCount ?? 0} imports.`,
+                    suggestedFix: `Check ${platform} credentials and configuration. Run /sw:sync-setup to reconfigure.`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=config.js.map

package/dist/plugins/specweave/lib/vendor/sync/config.js.map

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