specweave 0.21.2 → 0.22.0

package/dist/src/core/increment/spec-sync-manager.js

@@ -0,0 +1,496 @@
+/**
+ * SpecSyncManager - Automatic synchronization of plan.md and tasks.md when spec.md changes
+ *
+ * Purpose: Maintain consistency in spec-driven development by automatically regenerating
+ * downstream artifacts (plan.md, tasks.md) when the source of truth (spec.md) is modified.
+ *
+ * This enforces the SpecWeave principle: spec.md is the source of truth, all other files derive from it.
+ *
+ * @module spec-sync-manager
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { MetadataManager } from './metadata-manager.js';
+export class SpecSyncManager {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.incrementsDir = path.join(projectRoot, '.specweave', 'increments');
+    }
+    /**
+     * Detect if spec.md was modified after plan.md or tasks.md
+     *
+     * @param incrementId - Increment to check (e.g., "0039-ultra-smart-next-command")
+     * @returns Detection result with modification times and reasoning
+     */
+    detectSpecChange(incrementId) {
+        const incrementDir = path.join(this.incrementsDir, incrementId);
+        const specPath = path.join(incrementDir, 'spec.md');
+        const planPath = path.join(incrementDir, 'plan.md');
+        const tasksPath = path.join(incrementDir, 'tasks.md');
+        // Check if spec.md exists
+        if (!fs.existsSync(specPath)) {
+            return {
+                specChanged: false,
+                specModTime: 0,
+                planModTime: 0,
+                tasksModTime: 0,
+                incrementId,
+                reason: 'spec.md does not exist'
+            };
+        }
+        // Get modification times
+        const specStat = fs.statSync(specPath);
+        const specModTime = specStat.mtimeMs;
+        // If plan.md doesn't exist, no sync needed (planning phase)
+        if (!fs.existsSync(planPath)) {
+            return {
+                specChanged: false,
+                specModTime,
+                planModTime: 0,
+                tasksModTime: 0,
+                incrementId,
+                reason: 'plan.md does not exist yet (planning phase)'
+            };
+        }
+        const planStat = fs.statSync(planPath);
+        const planModTime = planStat.mtimeMs;
+        // Check if tasks.md exists
+        const tasksModTime = fs.existsSync(tasksPath)
+            ? fs.statSync(tasksPath).mtimeMs
+            : 0;
+        // Spec changed if it's newer than plan.md
+        const specChanged = specModTime > planModTime;
+        return {
+            specChanged,
+            specModTime,
+            planModTime,
+            tasksModTime,
+            incrementId,
+            reason: specChanged
+                ? `spec.md modified after plan.md (spec: ${new Date(specModTime).toISOString()}, plan: ${new Date(planModTime).toISOString()})`
+                : 'spec.md has not changed since plan.md was created'
+        };
+    }
+    /**
+     * Get the currently active increment ID
+     *
+     * @returns Active increment ID or null if none active
+     */
+    getActiveIncrementId() {
+        try {
+            const activeIncrements = MetadataManager.getActive();
+            if (activeIncrements.length === 0) {
+                return null;
+            }
+            // Return the first active increment (should only be 1 due to WIP limits)
+            return activeIncrements[0].id;
+        }
+        catch (error) {
+            console.error('Error getting active increment:', error);
+            return null;
+        }
+    }
+    /**
+     * Extract manual annotations from markdown content
+     *
+     * Detects HTML comments with keywords: MANUAL NOTE, TODO, NOTE
+     *
+     * @param content - Markdown content to analyze
+     * @param filePath - File path for context
+     * @returns Array of manual annotations
+     */
+    extractManualAnnotations(content, filePath) {
+        const annotations = [];
+        const lines = content.split('\n');
+        lines.forEach((line, index) => {
+            // Match HTML comments with manual keywords
+            const commentMatch = line.match(/<!--\s*(MANUAL NOTE|TODO|NOTE):\s*([^>]+)\s*-->/);
+            if (commentMatch) {
+                const keyword = commentMatch[1];
+                const text = commentMatch[2].trim();
+                annotations.push({
+                    type: keyword === 'MANUAL NOTE' ? 'note' : keyword.toLowerCase(),
+                    line: index + 1,
+                    content: text,
+                    context: this.getLineContext(lines, index)
+                });
+            }
+        });
+        return annotations;
+    }
+    /**
+     * Get surrounding context for a line (3 lines before and after)
+     *
+     * @param lines - All file lines
+     * @param lineIndex - Index of target line
+     * @returns Context string
+     */
+    getLineContext(lines, lineIndex) {
+        const start = Math.max(0, lineIndex - 3);
+        const end = Math.min(lines.length, lineIndex + 4);
+        return lines.slice(start, end).join('\n');
+    }
+    /**
+     * Prepare regeneration context for plan.md and tasks.md
+     *
+     * @param incrementId - Increment ID
+     * @returns Regeneration context with all necessary information
+     */
+    prepareRegenerationContext(incrementId) {
+        const incrementDir = path.join(this.incrementsDir, incrementId);
+        const specPath = path.join(incrementDir, 'spec.md');
+        const planPath = path.join(incrementDir, 'plan.md');
+        const tasksPath = path.join(incrementDir, 'tasks.md');
+        // Verify spec.md exists
+        if (!fs.existsSync(specPath)) {
+            return null;
+        }
+        // Read spec content
+        const specContent = fs.readFileSync(specPath, 'utf-8');
+        // Read old plan and tasks if they exist
+        const oldPlanContent = fs.existsSync(planPath)
+            ? fs.readFileSync(planPath, 'utf-8')
+            : undefined;
+        const oldTasksContent = fs.existsSync(tasksPath)
+            ? fs.readFileSync(tasksPath, 'utf-8')
+            : undefined;
+        // Extract manual annotations from plan.md
+        const manualAnnotations = oldPlanContent
+            ? this.extractManualAnnotations(oldPlanContent, planPath)
+            : [];
+        return {
+            incrementId,
+            specPath,
+            planPath,
+            tasksPath,
+            specContent,
+            oldPlanContent,
+            oldTasksContent,
+            manualAnnotations
+        };
+    }
+    /**
+     * Generate diff between old and new plan.md
+     *
+     * @param oldContent - Original plan.md content
+     * @param newContent - Regenerated plan.md content
+     * @returns Diff summary with line changes
+     */
+    generatePlanDiff(oldContent, newContent) {
+        const oldLines = oldContent.split('\n');
+        const newLines = newContent.split('\n');
+        const changes = [];
+        // Simple line-based diff
+        const maxLines = Math.max(oldLines.length, newLines.length);
+        for (let i = 0; i < maxLines; i++) {
+            const oldLine = oldLines[i] || '';
+            const newLine = newLines[i] || '';
+            if (oldLine !== newLine) {
+                if (!oldLine) {
+                    changes.push(`+ Line ${i + 1}: ${newLine}`);
+                }
+                else if (!newLine) {
+                    changes.push(`- Line ${i + 1}: ${oldLine}`);
+                }
+                else {
+                    changes.push(`~ Line ${i + 1}: ${oldLine} → ${newLine}`);
+                }
+            }
+        }
+        return changes;
+    }
+    /**
+     * Parse task completion status from tasks.md
+     *
+     * Extracts which tasks and subtasks are completed
+     *
+     * @param tasksContent - tasks.md content
+     * @returns Array of task completion records
+     */
+    parseTaskCompletion(tasksContent) {
+        const completions = [];
+        const lines = tasksContent.split('\n');
+        let currentTask = null;
+        lines.forEach((line, index) => {
+            // Match task headers: ## T-001: Task name
+            const taskHeaderMatch = line.match(/^##\s+(T-\d+):/);
+            if (taskHeaderMatch) {
+                // Save previous task if exists
+                if (currentTask) {
+                    completions.push(currentTask);
+                }
+                // Start new task
+                currentTask = {
+                    taskId: taskHeaderMatch[1],
+                    completed: false,
+                    subtasks: []
+                };
+            }
+            // Match subtasks: - [x] or - [ ]
+            const subtaskMatch = line.match(/^-\s+\[(x| )\]\s+(.+)$/);
+            if (subtaskMatch && currentTask) {
+                const isCompleted = subtaskMatch[1] === 'x';
+                const text = subtaskMatch[2].trim();
+                currentTask.subtasks.push({
+                    text,
+                    completed: isCompleted,
+                    line: index + 1
+                });
+                // Mark task as completed if all subtasks are completed
+                if (currentTask.subtasks.every(s => s.completed)) {
+                    currentTask.completed = true;
+                }
+            }
+        });
+        // Add last task
+        if (currentTask) {
+            completions.push(currentTask);
+        }
+        return completions;
+    }
+    /**
+     * Generate diff between old and new tasks.md
+     *
+     * @param oldContent - Original tasks.md content
+     * @param newContent - Regenerated tasks.md content
+     * @returns Diff summary with task changes
+     */
+    generateTasksDiff(oldContent, newContent) {
+        const changes = [];
+        // Extract task IDs from both versions
+        const oldTaskIds = (oldContent.match(/^## (T-\d+):/gm) || []).map(h => h.replace(/^## (T-\d+):/, '$1'));
+        const newTaskIds = (newContent.match(/^## (T-\d+):/gm) || []).map(h => h.replace(/^## (T-\d+):/, '$1'));
+        // Find added tasks
+        const addedTasks = newTaskIds.filter(id => !oldTaskIds.includes(id));
+        if (addedTasks.length > 0) {
+            changes.push(`+ Added ${addedTasks.length} tasks: ${addedTasks.join(', ')}`);
+        }
+        // Find removed tasks
+        const removedTasks = oldTaskIds.filter(id => !newTaskIds.includes(id));
+        if (removedTasks.length > 0) {
+            changes.push(`- Removed ${removedTasks.length} tasks: ${removedTasks.join(', ')}`);
+        }
+        // Find preserved tasks
+        const preservedTasks = oldTaskIds.filter(id => newTaskIds.includes(id));
+        if (preservedTasks.length > 0) {
+            changes.push(`~ Preserved ${preservedTasks.length} tasks: ${preservedTasks.join(', ')}`);
+        }
+        return changes;
+    }
+    /**
+     * Apply completion status from old tasks to new tasks
+     *
+     * Matches tasks by ID and text similarity, preserves completed checkboxes
+     *
+     * @param newTasksContent - Regenerated tasks.md content
+     * @param oldCompletions - Completion status from old tasks.md
+     * @returns Updated tasks.md content with completion status preserved
+     */
+    applyTaskCompletion(newTasksContent, oldCompletions) {
+        const lines = newTasksContent.split('\n');
+        let currentTaskId = null;
+        const updatedLines = lines.map(line => {
+            // Track current task
+            const taskHeaderMatch = line.match(/^##\s+(T-\d+):/);
+            if (taskHeaderMatch) {
+                currentTaskId = taskHeaderMatch[1];
+                return line;
+            }
+            // Update subtask completion status
+            const subtaskMatch = line.match(/^(-\s+)\[(x| )\]\s+(.+)$/);
+            if (subtaskMatch && currentTaskId) {
+                const prefix = subtaskMatch[1];
+                const text = subtaskMatch[3].trim();
+                // Find old completion for this task
+                const oldTask = oldCompletions.find(t => t.taskId === currentTaskId);
+                if (oldTask) {
+                    // Find matching subtask by text similarity
+                    const matchingSubtask = oldTask.subtasks.find(s => this.isTextSimilar(s.text, text));
+                    if (matchingSubtask && matchingSubtask.completed) {
+                        // Preserve completion status
+                        return `${prefix}[x] ${text}`;
+                    }
+                }
+            }
+            return line;
+        });
+        return updatedLines.join('\n');
+    }
+    /**
+     * Check if two text strings are similar (for matching subtasks)
+     *
+     * Uses simple comparison: exact match or contains
+     *
+     * @param text1 - First text
+     * @param text2 - Second text
+     * @returns True if texts are similar
+     */
+    isTextSimilar(text1, text2) {
+        const normalized1 = text1.toLowerCase().trim();
+        const normalized2 = text2.toLowerCase().trim();
+        // Exact match
+        if (normalized1 === normalized2) {
+            return true;
+        }
+        // Check if one contains the other (for renamed but similar tasks)
+        if (normalized1.includes(normalized2) ||
+            normalized2.includes(normalized1)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Synchronize plan.md and tasks.md based on spec.md changes
+     *
+     * This method:
+     * 1. Detects if spec.md changed
+     * 2. Prepares regeneration context
+     * 3. Returns context for Claude Code to invoke Architect Agent
+     * 4. Preserves manual annotations
+     * 5. Logs changes to metadata
+     *
+     * @param incrementId - Increment to sync
+     * @param skipSync - Skip sync even if spec changed (user override)
+     * @returns Sync result with regeneration context
+     */
+    async syncIncrement(incrementId, skipSync = false) {
+        const detection = this.detectSpecChange(incrementId);
+        // No sync needed if spec hasn't changed
+        if (!detection.specChanged) {
+            return {
+                synced: false,
+                reason: detection.reason,
+                planRegenerated: false,
+                tasksRegenerated: false,
+                changes: []
+            };
+        }
+        // User requested skip
+        if (skipSync) {
+            return {
+                synced: false,
+                reason: 'Sync skipped by user (--skip-sync flag)',
+                planRegenerated: false,
+                tasksRegenerated: false,
+                changes: []
+            };
+        }
+        // Perform sync
+        const changes = [];
+        try {
+            changes.push('spec.md detected as modified');
+            // Prepare regeneration context
+            const context = this.prepareRegenerationContext(incrementId);
+            if (!context) {
+                return {
+                    synced: false,
+                    reason: 'Failed to prepare regeneration context',
+                    planRegenerated: false,
+                    tasksRegenerated: false,
+                    changes
+                };
+            }
+            changes.push('Regeneration context prepared');
+            if (context.manualAnnotations.length > 0) {
+                changes.push(`Found ${context.manualAnnotations.length} manual annotations to preserve`);
+            }
+            // Log sync event to metadata
+            this.logSyncEvent(incrementId, detection);
+            return {
+                synced: true,
+                reason: 'Spec changed, regeneration context prepared',
+                planRegenerated: false, // Will be set by command after agent invocation
+                tasksRegenerated: false, // Will be set by command after agent invocation
+                changes,
+                regenerationContext: context
+            };
+        }
+        catch (error) {
+            return {
+                synced: false,
+                reason: 'Sync failed',
+                planRegenerated: false,
+                tasksRegenerated: false,
+                changes,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Log sync event to increment metadata
+     *
+     * @param incrementId - Increment ID
+     * @param detection - Detection result
+     */
+    logSyncEvent(incrementId, detection) {
+        try {
+            const metadataPath = path.join(this.incrementsDir, incrementId, 'metadata.json');
+            if (!fs.existsSync(metadataPath)) {
+                return;
+            }
+            const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf-8'));
+            // Add sync log entry
+            if (!metadata.syncEvents) {
+                metadata.syncEvents = [];
+            }
+            metadata.syncEvents.push({
+                timestamp: new Date().toISOString(),
+                type: 'spec-change-detected',
+                specModTime: detection.specModTime,
+                planModTime: detection.planModTime,
+                tasksModTime: detection.tasksModTime,
+                reason: detection.reason
+            });
+            // Keep only last 10 sync events
+            if (metadata.syncEvents.length > 10) {
+                metadata.syncEvents = metadata.syncEvents.slice(-10);
+            }
+            fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+        }
+        catch (error) {
+            console.error('Failed to log sync event:', error);
+        }
+    }
+    /**
+     * Check if spec sync is needed for the active increment
+     *
+     * @returns Detection result or null if no active increment
+     */
+    checkActiveIncrement() {
+        const activeId = this.getActiveIncrementId();
+        if (!activeId) {
+            return null;
+        }
+        return this.detectSpecChange(activeId);
+    }
+    /**
+     * Get human-readable sync status message
+     *
+     * @param detection - Detection result
+     * @returns Formatted message for user
+     */
+    formatSyncMessage(detection) {
+        if (!detection.specChanged) {
+            return ''; // No message needed
+        }
+        const specTime = new Date(detection.specModTime).toLocaleString();
+        const planTime = new Date(detection.planModTime).toLocaleString();
+        return `⚠️  SPEC CHANGED - SYNC REQUIRED
+
+Increment: ${detection.incrementId}
+
+📝 spec.md was modified AFTER plan.md was created:
+  - spec.md: ${specTime}
+  - plan.md: ${planTime}
+
+🔄 Automatic sync will regenerate:
+  1. plan.md (using Architect Agent)
+  2. tasks.md (using test-aware-planner)
+
+⚡ Task completion status will be preserved
+
+💡 To skip sync: Add --skip-sync flag to your command
+📖 Learn more: /specweave:help sync`;
+    }
+}
+//# sourceMappingURL=spec-sync-manager.js.map

package/dist/src/core/increment/spec-sync-manager.js.map

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

package/dist/src/core/increment/status-auto-transition.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Status Auto-Transition Module
+ *
+ * Automatically transitions increment status based on file activity:
+ * - When spec.md created → status = PLANNING (if not already set)
+ * - When tasks.md created → status = ACTIVE (if currently PLANNING)
+ * - When first task marked in-progress → status = ACTIVE (if not already)
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+/**
+ * Auto-transition increment status based on file activity
+ *
+ * Transition Rules:
+ * 1. PLANNING → ACTIVE: When tasks.md created or first task in-progress
+ * 2. BACKLOG → PLANNING: When spec.md created (resume planning)
+ * 3. Any status → ACTIVE: When first task in-progress (override)
+ *
+ * @param incrementId - Increment ID to check
+ * @param triggerFile - File that triggered the check (optional, for logging)
+ * @returns true if status was transitioned, false otherwise
+ */
+export declare function autoTransitionStatus(incrementId: string, triggerFile?: string): boolean;
+/**
+ * Auto-transition based on specific file creation
+ *
+ * This is called by file watchers or post-write hooks
+ *
+ * @param incrementId - Increment ID
+ * @param createdFile - File that was just created
+ */
+export declare function onFileCreated(incrementId: string, createdFile: string): void;
+/**
+ * Check if increment should auto-transition to ACTIVE
+ *
+ * Used by /specweave:do command before execution
+ */
+export declare function shouldTransitionToActive(incrementId: string): boolean;
+/**
+ * Validate and fix "planned" vs "planning" inconsistency
+ *
+ * Legacy increments may have "planned" status (not in enum).
+ * This migrates them to "planning" (valid enum value).
+ */
+export declare function migrateLegacyStatuses(): number;
+//# sourceMappingURL=status-auto-transition.d.ts.map

package/dist/src/core/increment/status-auto-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-auto-transition.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/status-auto-transition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmDH;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAgCvF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAS5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAuBrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAwC9C"}