specweave 1.0.593 → 2.0.3

package/plugins/specweave/lib/hooks/update-tasks-md.ts

@@ -1,489 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * SpecWeave Tasks.md Auto-Updater
- *
- * Automatically updates tasks.md completion status after TodoWrite completes tasks.
- *
- * Usage:
- *   node dist/hooks/lib/update-tasks-md.js <incrementId>
- *
- * Example:
- *   node dist/hooks/lib/update-tasks-md.js 0006-llm-native-i18n
- *
- * What it does:
- * 1. Reads tasks.md for the given increment
- * 2. Finds recently completed tasks from TodoWrite
- * 3. Updates "[ ]" to "[x]" for completed tasks
- * 4. Updates "Status: ⏳ Pending" to "Status: [x] Completed"
- * 5. Recalculates progress percentage
- * 6. Writes back to tasks.md
- *
- * @author SpecWeave Team
- * @version 1.0.0
- */
-
-import { existsSync, promises as fs } from 'fs';
-import path from 'path';
-
-interface TaskMatch {
-  taskId: string;
-  lineNumber: number;
-  currentStatus: 'pending' | 'in_progress' | 'completed';
-}
-
-interface TaskConsistencyFix {
-  taskId: string;
-  lineNumber: number;
-  action: 'add-complete-marker' | 'remove-complete-marker';
-  currentLine: string;
-}
-
-/**
- * Main function - update tasks.md for given increment
- */
-async function updateTasksMd(incrementId: string): Promise<void> {
-  try {
-    console.log(`\n🔄 Updating tasks.md for increment: ${incrementId}`);
-
-    // 1. Validate increment exists
-    const incrementDir = path.join(process.cwd(), '.specweave', 'increments', incrementId);
-    if (!existsSync(incrementDir)) {
-      console.error(`❌ Increment directory not found: ${incrementDir}`);
-      process.exit(1);
-    }
-
-    const tasksPath = path.join(incrementDir, 'tasks.md');
-    if (!existsSync(tasksPath)) {
-      console.error(`❌ tasks.md not found: ${tasksPath}`);
-      process.exit(1);
-    }
-
-    // 2. Read tasks.md
-    const originalContent = await fs.readFile(tasksPath, 'utf-8');
-    const lines = originalContent.split('\n');
-
-    console.log(`📖 Read tasks.md (${lines.length} lines)`);
-
-    // 3. Parse task completion status
-    const tasks = parseTaskStatus(lines);
-    console.log(`📋 Found ${tasks.length} tasks`);
-
-    // 4. Get recently completed tasks and consistency fixes
-    const { completedTasks, fixes } = detectCompletedTasks(lines);
-
-    // 4a. Apply consistency fixes FIRST (if any)
-    let updatedContent = originalContent;
-    let autoFixedCount = 0;
-
-    if (fixes.length > 0) {
-      console.log(`🔧 Auto-fixing ${fixes.length} task consistency issue(s)...`);
-      updatedContent = applyConsistencyFixes(originalContent, fixes);
-      autoFixedCount = fixes.length;
-      console.log('✅ Task consistency auto-fixed');
-    }
-
-    if (completedTasks.length === 0 && fixes.length === 0) {
-      console.log('✅ No new task completions or consistency fixes needed');
-      return;
-    }
-
-    if (completedTasks.length > 0) {
-      console.log(`🎯 Detected ${completedTasks.length} completed task(s):`, completedTasks);
-    }
-
-    // 5. Update task status in content
-
-    for (const taskId of completedTasks) {
-      updatedContent = markTaskComplete(updatedContent, taskId);
-    }
-
-    // 6. Recalculate progress
-    const updatedLines = updatedContent.split('\n');
-    const totalTasks = countTotalTasks(updatedLines);
-    const completedCount = countCompletedTasks(updatedLines);
-    const progress = Math.round((completedCount / totalTasks) * 100);
-
-    console.log(`📊 Progress: ${completedCount}/${totalTasks} (${progress}%)`);
-
-    // 7. Update header with new progress
-    updatedContent = updateProgressHeader(updatedContent, completedCount, totalTasks, progress);
-
-    // 8. Write back to tasks.md
-    await fs.writeFile(tasksPath, updatedContent, 'utf-8');
-
-    console.log(`✅ Updated ${tasksPath}`);
-    if (autoFixedCount > 0) {
-      console.log(`🔧 Auto-fixed ${autoFixedCount} consistency issue(s)`);
-    }
-    console.log(`   Completed: ${completedCount}/${totalTasks}`);
-    console.log(`   Progress: ${progress}%\n`);
-
-  } catch (error) {
-    console.error('❌ Error updating tasks.md:', error);
-    process.exit(1);
-  }
-}
-
-/**
- * Parse task status from lines
- */
-function parseTaskStatus(lines: string[]): TaskMatch[] {
-  const tasks: TaskMatch[] = [];
-  const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+(.+)/; // Matches "### T-001: Task Name" or "### T-001-DISCIPLINE:"
-
-  lines.forEach((line, index) => {
-    const match = line.match(taskPattern);
-    if (match) {
-      const taskId = match[1];
-
-      // Look ahead for status line
-      let status: 'pending' | 'in_progress' | 'completed' = 'pending';
-
-      for (let i = index + 1; i < Math.min(index + 5, lines.length); i++) {
-        const nextLine = lines[i];
-        if (nextLine.includes('**Status**:')) {
-          if (nextLine.includes('[x] Completed')) {
-            status = 'completed';
-          } else if (nextLine.includes('⏳ Pending') || nextLine.includes('[ ] Pending')) {
-            status = 'pending';
-          } else if (nextLine.includes('🔄 In Progress') || nextLine.includes('in_progress')) {
-            status = 'in_progress';
-          }
-          break;
-        }
-      }
-
-      tasks.push({
-        taskId,
-        lineNumber: index,
-        currentStatus: status,
-      });
-    }
-  });
-
-  return tasks;
-}
-
-/**
- * Detect which tasks are completed (STRICT VALIDATION)
- *
- * Detection strategies (ALL must be true):
- * 1. Task header has "✅ COMPLETE" marker AND
- *    all implementation checkboxes are marked [x]
- * 2. OR: Task header has "Status: [x] Completed" (legacy format)
- *
- * This prevents inconsistencies where header says COMPLETE but checkboxes
- * are unchecked. Both must match for a task to be considered complete.
- *
- * @see .specweave/increments/0037/reports/ULTRATHINK-COMPLETE-MARKER-VS-CHECKBOXES.md
- */
-function detectCompletedTasks(lines: string[]): { completedTasks: string[]; fixes: TaskConsistencyFix[] } {
-  const completedTasks: string[] = [];
-  const fixes: TaskConsistencyFix[] = [];
-  const warnings: string[] = [];
-  const taskPattern = /^###\s+(T-\d+[-A-Z]*):?\s+(.+)/;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const taskMatch = line.match(taskPattern);
-
-    if (!taskMatch) continue;
-
-    const taskId = taskMatch[1];
-    const taskTitle = taskMatch[2];
-    const hasCompleteMarker = taskTitle.includes('✅ COMPLETE');
-
-    // Get implementation section
-    const taskEndIndex = findNextTaskStart(lines, i + 1);
-    const implementationSection = findImplementationSection(lines, i, taskEndIndex);
-
-    let allCheckboxesComplete = false;
-    if (implementationSection) {
-      allCheckboxesComplete = checkAllCheckboxesComplete(implementationSection);
-    }
-
-    // STRICT VALIDATION: Require BOTH header AND checkboxes to match
-    if (hasCompleteMarker && implementationSection) {
-      if (allCheckboxesComplete) {
-        // ✅ CONSISTENT: Header says COMPLETE and all checkboxes checked
-        if (!completedTasks.includes(taskId)) {
-          completedTasks.push(taskId);
-        }
-      } else {
-        // ⚠️  INCONSISTENT: Header says COMPLETE but checkboxes incomplete - AUTO-FIX
-        fixes.push({
-          taskId,
-          lineNumber: i,
-          action: 'remove-complete-marker',
-          currentLine: line
-        });
-        warnings.push(`${taskId}: Header has ✅ COMPLETE but not all checkboxes checked`);
-      }
-      continue;
-    }
-
-    // If no implementation section, remove COMPLETE marker (can't verify)
-    if (hasCompleteMarker && !implementationSection) {
-      fixes.push({
-        taskId,
-        lineNumber: i,
-        action: 'remove-complete-marker',
-        currentLine: line
-      });
-      warnings.push(`${taskId}: Header has ✅ COMPLETE but no implementation section to verify`);
-      continue;
-    }
-
-    // Warn if checkboxes all complete but header missing marker - AUTO-FIX
-    if (!hasCompleteMarker && implementationSection && allCheckboxesComplete) {
-      fixes.push({
-        taskId,
-        lineNumber: i,
-        action: 'add-complete-marker',
-        currentLine: line
-      });
-      warnings.push(`${taskId}: All checkboxes checked but header missing ✅ COMPLETE`);
-      // Still count as complete (checkboxes are source of truth for work done)
-      if (!completedTasks.includes(taskId)) {
-        completedTasks.push(taskId);
-      }
-      continue;
-    }
-
-    // Strategy 2: Check for "Status: [x] Completed" (legacy format)
-    for (let j = i + 1; j < Math.min(i + 10, taskEndIndex); j++) {
-      const statusLine = lines[j];
-      if (statusLine.includes('**Status**:') && statusLine.includes('[x] Completed')) {
-        if (!completedTasks.includes(taskId)) {
-          completedTasks.push(taskId);
-        }
-        break;
-      }
-    }
-  }
-
-  // Report warnings if any
-  if (warnings.length > 0) {
-    console.warn('\n⚠️  Task Consistency Warnings:');
-    warnings.forEach(w => console.warn(`   ${w}`));
-    console.warn('');
-  }
-
-  return { completedTasks, fixes };
-}
-
-/**
- * Apply task consistency fixes to content
- */
-function applyConsistencyFixes(content: string, fixes: TaskConsistencyFix[]): string {
-  const lines = content.split('\n');
-
-  // Apply fixes (process in reverse order to preserve line numbers)
-  for (const fix of fixes.reverse()) {
-    const line = lines[fix.lineNumber];
-
-    if (fix.action === 'remove-complete-marker') {
-      // Remove ✅ COMPLETE from header
-      const fixed = line.replace(/\s*✅\s*COMPLETE\s*/g, '');
-      lines[fix.lineNumber] = fixed;
-    } else if (fix.action === 'add-complete-marker') {
-      // Add ✅ COMPLETE to header (before any trailing spaces)
-      const fixed = line.trim() + ' ✅ COMPLETE';
-      lines[fix.lineNumber] = fixed;
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Find the next task header start index
- */
-function findNextTaskStart(lines: string[], startIndex: number): number {
-  const taskPattern = /^###\s+T-\d+/;
-
-  for (let i = startIndex; i < lines.length; i++) {
-    if (taskPattern.test(lines[i])) {
-      return i;
-    }
-  }
-
-  return lines.length;
-}
-
-/**
- * Find the Implementation section within a task
- */
-function findImplementationSection(lines: string[], taskStartIndex: number, taskEndIndex: number): string[] | null {
-  let inImplementation = false;
-  const implementationLines: string[] = [];
-
-  for (let i = taskStartIndex; i < taskEndIndex; i++) {
-    const line = lines[i];
-
-    if (line.includes('**Implementation**:')) {
-      inImplementation = true;
-      continue;
-    }
-
-    if (inImplementation) {
-      // Stop at next section header (**, ---, or ###)
-      if (line.trim().startsWith('**') && !line.startsWith('- [')) {
-        break;
-      }
-      if (line.trim().startsWith('---')) {
-        break;
-      }
-      if (line.trim().startsWith('###')) {
-        break;
-      }
-
-      implementationLines.push(line);
-    }
-  }
-
-  return implementationLines.length > 0 ? implementationLines : null;
-}
-
-/**
- * Check if all checkboxes in implementation section are complete
- */
-function checkAllCheckboxesComplete(implementationLines: string[]): boolean {
-  const checkboxes = implementationLines.filter(line => line.includes('- ['));
-
-  if (checkboxes.length === 0) {
-    return false; // No checkboxes = can't determine completion
-  }
-
-  // All checkboxes must be [x], none can be [ ]
-  const allComplete = checkboxes.every(line => line.includes('- [x]'));
-  const noneIncomplete = checkboxes.every(line => !line.includes('- [ ]'));
-
-  return allComplete && noneIncomplete;
-}
-
-/**
- * Mark a specific task as complete
- */
-function markTaskComplete(content: string, taskId: string): string {
-  let updated = content;
-
-  // Pattern: "**Status**: [ ] Pending" or "**Status**: ⏳ Pending"
-  const statusPattern = new RegExp(
-    `(###\\s+${taskId.replace(/[-]/g, '\\-')}[^\\n]*[\\s\\S]*?\\*\\*Status\\*\\*:)\\s*\\[?\\s*\\]?\\s*⏳?\\s*Pending`,
-    'i'
-  );
-
-  updated = updated.replace(statusPattern, '$1 [x] Completed');
-
-  return updated;
-}
-
-/**
- * Count total tasks
- */
-function countTotalTasks(lines: string[]): number {
-  let count = 0;
-  const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+/;
-
-  for (const line of lines) {
-    if (taskPattern.test(line)) {
-      count++;
-    }
-  }
-
-  return count;
-}
-
-/**
- * Count completed tasks
- *
- * Recognizes multiple completion indicators:
- * 1. "✅ COMPLETE" marker in task header
- * 2. "**Status**: [x] Completed" line
- * 3. All implementation checkboxes marked [x]
- */
-function countCompletedTasks(lines: string[]): number {
-  let count = 0;
-  const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+(.+)/;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const taskMatch = line.match(taskPattern);
-
-    if (taskMatch) {
-      const taskTitle = taskMatch[2];
-
-      // Strategy 1: Check for ✅ COMPLETE marker in header
-      if (taskTitle.includes('✅ COMPLETE')) {
-        count++;
-        continue;
-      }
-
-      // Strategy 2: Check for Status: [x] Completed
-      let found = false;
-      for (let j = i + 1; j < Math.min(i + 10, lines.length); j++) {
-        const nextLine = lines[j];
-        if (nextLine.includes('**Status**:') && nextLine.includes('[x] Completed')) {
-          count++;
-          found = true;
-          break;
-        }
-      }
-
-      if (found) continue;
-
-      // Strategy 3: Check if all implementation checkboxes are [x]
-      const taskEndIndex = findNextTaskStart(lines, i + 1);
-      const implementationSection = findImplementationSection(lines, i, taskEndIndex);
-
-      if (implementationSection) {
-        const allCheckboxesComplete = checkAllCheckboxesComplete(implementationSection);
-        if (allCheckboxesComplete) {
-          count++;
-        }
-      }
-    }
-  }
-
-  return count;
-}
-
-/**
- * Update progress header
- */
-function updateProgressHeader(content: string, completed: number, total: number, progress: number): string {
-  let updated = content;
-
-  // Update "**Completed**: X"
-  updated = updated.replace(/\*\*Completed\*\*:\s*\d+/, `**Completed**: ${completed}`);
-
-  // Update "**Progress**: X%"
-  updated = updated.replace(/\*\*Progress\*\*:\s*\d+%/, `**Progress**: ${progress}%`);
-
-  // Update "**Total Tasks**: X"
-  updated = updated.replace(/\*\*Total Tasks\*\*:\s*\d+/, `**Total Tasks**: ${total}`);
-
-  return updated;
-}
-
-// CLI entry point
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
-
-if (isMainModule) {
-  const incrementId = process.argv[2];
-
-  if (!incrementId) {
-    console.error('❌ Usage: update-tasks-md <incrementId>');
-    console.error('   Example: update-tasks-md 0006-llm-native-i18n');
-    process.exit(1);
-  }
-
-  updateTasksMd(incrementId).catch((error) => {
-    console.error('❌ Fatal error:', error);
-    process.exit(1);
-  });
-}
-
-export { updateTasksMd };

package/plugins/specweave/lib/hooks/us-completion-orchestrator.js

@@ -1,169 +0,0 @@
-#!/usr/bin/env node
-import { USCompletionDetector } from "../../../../dist/src/core/us-completion-detector.js";
-import { LivingDocsSync } from "../../../../dist/src/core/living-docs/living-docs-sync.js";
-import { USSyncThrottle } from "../../../../dist/src/core/us-sync-throttle.js";
-import { consoleLogger } from "../vendor/utils/logger.js";
-import { spawn } from "child_process";
-import { existsSync } from "fs";
-import * as path from "path";
-async function triggerUserStoryCompleteHook(incrementId, usId, projectRoot) {
-  const hookPaths = [
-    path.join(projectRoot, "plugins/specweave/hooks/post-user-story-complete.sh"),
-    path.join(projectRoot, ".claude/hooks/post-user-story-complete.sh")
-  ];
-  let hookPath = null;
-  for (const p of hookPaths) {
-    if (existsSync(p)) {
-      hookPath = p;
-      break;
-    }
-  }
-  if (!hookPath) {
-    console.log(`   \u2139\uFE0F  post-user-story-complete.sh hook not found (skipping external sync)`);
-    return;
-  }
-  return new Promise((resolve, reject) => {
-    const hookProcess = spawn("bash", [hookPath, incrementId, usId], {
-      cwd: projectRoot,
-      env: {
-        ...process.env,
-        SPECWEAVE_INCREMENT_ID: incrementId,
-        SPECWEAVE_USER_STORY_ID: usId
-      },
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    let stdout = "";
-    let stderr = "";
-    hookProcess.stdout.on("data", (data) => {
-      stdout += data.toString();
-    });
-    hookProcess.stderr.on("data", (data) => {
-      stderr += data.toString();
-    });
-    hookProcess.on("close", (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Hook exited with code ${code}: ${stderr || stdout}`));
-      }
-    });
-    hookProcess.on("error", (error) => {
-      reject(new Error(`Hook spawn failed: ${error.message}`));
-    });
-    setTimeout(() => {
-      hookProcess.kill("SIGTERM");
-      reject(new Error("Hook timed out after 30s"));
-    }, 3e4);
-  });
-}
-async function syncCompletedUserStories(incrementId) {
-  try {
-    console.log(`
-\u{1F3AF} [6/6] Detecting completed user stories for ${incrementId}...`);
-    const projectRoot = process.cwd();
-    const throttle = USSyncThrottle.getInstance({ projectRoot });
-    if (throttle.shouldSkipSync(incrementId)) {
-      const timeSinceLastSync = throttle.getTimeSinceLastSync(incrementId);
-      const secondsRemaining = Math.ceil((6e4 - timeSinceLastSync) / 1e3);
-      console.log(`\u23ED\uFE0F  US sync throttled (last sync ${Math.floor(timeSinceLastSync / 1e3)}s ago)`);
-      console.log(`   \u2139\uFE0F  Sync will be available in ${secondsRemaining}s`);
-      console.log(`   \u{1F4A1} Manual sync: sw:sync-progress ${incrementId}`);
-      return {
-        success: true,
-        message: "Sync throttled",
-        throttled: true,
-        skipped: true
-      };
-    }
-    const detector = new USCompletionDetector(projectRoot, {
-      logger: consoleLogger
-    });
-    const newlyCompleted = await detector.getNewlyCompletedUSs(incrementId);
-    if (newlyCompleted.length === 0) {
-      console.log("\u2705 No newly completed user stories detected (no sync needed)");
-      return {
-        success: true,
-        newlyCompleted: [],
-        message: "No new completions"
-      };
-    }
-    console.log(`
-\u{1F389} DETECTED ${newlyCompleted.length} NEWLY COMPLETED USER STORIES:`);
-    for (const us of newlyCompleted) {
-      console.log(`   ${us.usId}: ${us.title} (${us.completedACs}/${us.totalACs} ACs complete)`);
-    }
-    const allCompletions = await detector.detectCompletions(incrementId);
-    await detector.saveCompletionState(incrementId, allCompletions);
-    console.log(`
-\u{1F4DA} Syncing living docs for ${incrementId}...`);
-    const livingDocsSync = new LivingDocsSync(projectRoot, {
-      logger: consoleLogger
-    });
-    const syncResult = await livingDocsSync.syncIncrement(incrementId);
-    if (syncResult.success) {
-      console.log(`\u2705 Living docs synced successfully`);
-      console.log(`   Feature: ${syncResult.featureId}`);
-      console.log(`   Files updated: ${syncResult.filesCreated.length + syncResult.filesUpdated.length}`);
-      console.log(`
-\u{1F4E1} Triggering external tool updates for ${newlyCompleted.length} completed user stories...`);
-      for (const us of newlyCompleted) {
-        try {
-          await triggerUserStoryCompleteHook(incrementId, us.usId, projectRoot);
-          console.log(`   \u2705 ${us.usId}: External tool updated`);
-        } catch (hookError) {
-          console.warn(`   \u26A0\uFE0F  ${us.usId}: Hook failed (${hookError.message})`);
-        }
-      }
-      throttle.recordSync(incrementId);
-      console.log(`   \u23F1\uFE0F  Throttle recorded (next sync allowed in 60s)`);
-    } else {
-      console.warn(`\u26A0\uFE0F  Living docs sync had errors (see logs)`);
-      console.warn(`   Errors: ${syncResult.errors.join(", ")}`);
-    }
-    return {
-      success: true,
-      newlyCompleted: newlyCompleted.map((us) => ({
-        usId: us.usId,
-        title: us.title,
-        totalACs: us.totalACs,
-        completedACs: us.completedACs
-      })),
-      syncResult,
-      message: `${newlyCompleted.length} user stories synced`
-    };
-  } catch (error) {
-    console.error("\u274C Error in US completion orchestrator:", error.message);
-    return {
-      success: false,
-      error: error.message,
-      message: "Orchestrator error"
-    };
-  }
-}
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
-if (isMainModule) {
-  const incrementId = process.argv[2];
-  if (!incrementId) {
-    console.error("Usage: node us-completion-orchestrator.js <increment-id>");
-    console.error("Example: node us-completion-orchestrator.js 0053-safe-feature-deletion");
-    process.exit(1);
-  }
-  syncCompletedUserStories(incrementId).then((result) => {
-    if (result.success) {
-      console.log("\n\u2705 US completion orchestration completed successfully");
-      if (result.throttled) {
-        console.log("   (Throttled - no sync performed)");
-      }
-      process.exit(0);
-    } else {
-      console.error("\n\u274C US completion orchestration failed");
-      process.exit(1);
-    }
-  }).catch((error) => {
-    console.error("\n\u274C Fatal error:", error);
-    process.exit(1);
-  });
-}
-export {
-  syncCompletedUserStories
-};