vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/utils/requirement-helpers.js

@@ -1,1267 +1,367 @@
-const fs = require('fs-extra');
-const path = require('path');
-const os = require('os');
-const { getRequirementsPath } = require('./repo-helpers.cjs');
-const { logger } = require('./logger.cjs');
-
-// Default instruction text
-const DEFAULT_INSTRUCTION_TEXT = 'Follow INSTRUCTIONS.md from .vibecodingmachine directory. CRITICAL: You MUST work through ALL status stages (PREPARE → ACT → CLEAN UP → VERIFY → DONE) and set the status to DONE in the REQUIREMENTS file before stopping. DO NOT stop working until the "🚦 Current Status" section shows "DONE". The VibeCodingMachine app is running in autonomous mode and depends on you completing the requirement fully.';
-
 /**
- * Get ordinal suffix for numbers (1st, 2nd, 3rd, 4th, etc.)
- * @param {number} num - The number
- * @returns {string} The ordinal suffix
+ * Requirement Helpers (Refactored)
+ * Main entry point for all requirement-related operations
+ * Original file was 1,267 lines, now split into focused modules under 555 lines each
  */
-function getOrdinalSuffix(num) {
-  const j = num % 10;
-  const k = num % 100;
-  if (j === 1 && k !== 11) {
-    return 'st';
-  }
-  if (j === 2 && k !== 12) {
-    return 'nd';
-  }
-  if (j === 3 && k !== 13) {
-    return 'rd';
-  }
-  return 'th';
-}
 
-/**
- * Add or increment TRY AGAIN prefix to requirement text
- * @param {string} requirementText - The requirement text
- * @returns {string} Requirement text with TRY AGAIN prefix
- */
-function addTryAgainPrefix(requirementText) {
-  const tryAgainMatch = requirementText.match(/^TRY AGAIN \((\d+)(?:st|nd|rd|th) time\): (.+)$/);
+// Import all sub-modules
+const requirementParser = require('./requirement-helpers/requirement-parser.js');
+const requirementMover = require('./requirement-helpers/requirement-mover.js');
+const requirementStatus = require('./requirement-helpers/requirement-status.js');
+const requirementFileOps = require('./requirement-helpers/requirement-file-ops.js');
 
-  if (tryAgainMatch) {
-    const currentCount = parseInt(tryAgainMatch[1]);
-    const baseRequirement = tryAgainMatch[2];
-    return `TRY AGAIN (${currentCount + 1}${getOrdinalSuffix(currentCount + 1)} time): ${baseRequirement}`;
-  } else {
-    return `TRY AGAIN (1st time): ${requirementText}`;
-  }
-}
+// Re-export parser utilities
+const {
+  DEFAULT_INSTRUCTION_TEXT,
+  getOrdinalSuffix,
+  addTryAgainPrefix,
+  parseRequirementLine,
+  extractRequirementTitle,
+  isRequirementMatch,
+  parseRequirementBlock,
+  findRequirementBlock,
+  findAllRequirementsInSection,
+  validateRequirementFormat,
+  formatRequirementForDisplay
+} = requirementParser;
+
+// Re-export movement operations
+const {
+  promoteToVerified,
+  demoteFromVerifiedToTodo,
+  promoteTodoToVerify,
+  demoteFromVerifyToTodo,
+  moveToCurrent,
+  getRequirementsInSection,
+  getRequirementStatistics
+} = requirementMover;
+
+// Re-export status management
+const {
+  extractCurrentStatus,
+  updateCurrentStatus,
+  getCurrentStatus,
+  isStatusDone,
+  isStatusInProgress,
+  getStatusStage,
+  validateStatus,
+  getNextStatus,
+  getPreviousStatus,
+  isValidStatusTransition,
+  getStatusHistory,
+  formatStatusForDisplay,
+  getStatusSummary
+} = requirementStatus;
+
+// Re-export file operations
+const {
+  getRequirementsFilePath,
+  requirementsFileExists,
+  createRequirementsFile,
+  readRequirementsFile,
+  writeRequirementsFile,
+  backupRequirementsFile,
+  getRequirementsFileStats,
+  validateRequirementsFile,
+  getAllRequirementsFiles,
+  cleanupBackupFiles
+} = requirementFileOps;
 
 /**
- * Parse requirement from markdown line
- * @param {string} line - Markdown line (e.g., "- Requirement text")
- * @returns {string} Requirement text without markdown prefix
+ * Get comprehensive requirement system information
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} System information
  */
-function parseRequirementLine(line) {
-  if (line.startsWith('- ')) {
-    return line.substring(2);
+async function getRequirementSystemInfo(repoPath = null) {
+  try {
+    const fileStats = await getRequirementsFileStats(repoPath);
+    const validation = await validateRequirementsFile(repoPath);
+    const statusSummary = await getStatusSummary(getRequirementsFilePath(repoPath));
+    const requirementStats = await getRequirementStatistics(getRequirementsFilePath(repoPath));
+    const allFiles = await getAllRequirementsFiles(repoPath || process.cwd());
+
+    return {
+      file: fileStats,
+      validation,
+      status: statusSummary,
+      statistics: requirementStats,
+      allFiles,
+      timestamp: new Date().toISOString()
+    };
+  } catch (error) {
+    return {
+      error: error.message,
+      timestamp: new Date().toISOString()
+    };
   }
-  return line;
 }
 
 /**
- * Move requirement from TO VERIFY section to VERIFIED (CHANGELOG)
- * @param {string} reqPath - Path to REQUIREMENTS file
- * @param {string} requirementTitle - Title of requirement to move
- * @returns {Promise<boolean>} Success status
+ * Initialize requirements system
+ * @param {string} repoPath - Repository path
+ * @returns {Promise<Object>} Initialization result
  */
-async function promoteToVerified(reqPath, requirementTitle) {
+async function initializeRequirementsSystem(repoPath) {
   try {
-    const content = await fs.readFile(reqPath, 'utf-8');
-    const lines = content.split('\n');
-    let inVerifySection = false;
-    let requirementStartIndex = -1;
-    let requirementEndIndex = -1;
-    const normalizedTitle = requirementTitle.trim();
-
-    // Find the requirement in TO VERIFY section (new ### format)
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-      const trimmed = line.trim();
-
-      // Check if we're entering TO VERIFY section (multiple variants)
-      if (trimmed.startsWith('##') && !trimmed.startsWith('###') &&
-        (trimmed.includes('TO VERIFY') || trimmed.includes('Verified by AI screenshot'))) {
-        inVerifySection = true;
-        continue;
-      }
-
-      // Check if we're leaving TO VERIFY section
-      if (inVerifySection && trimmed.startsWith('##') && !trimmed.startsWith('###')) {
-        inVerifySection = false;
-      }
-
-      // Look for requirement in TO VERIFY section (### header format)
-      if (inVerifySection && trimmed.startsWith('###')) {
-        const title = trimmed.replace(/^###\s*/, '').trim();
-        if (title === normalizedTitle || title.includes(normalizedTitle) || normalizedTitle.includes(title)) {
-          requirementStartIndex = i;
+    const result = {
+      success: false,
+      actions: [],
+      warnings: [],
+      errors: []
+    };
 
-          // Find the end of this requirement block
-          for (let j = i + 1; j < lines.length; j++) {
-            const nextLine = lines[j].trim();
-            if (nextLine.startsWith('###') || (nextLine.startsWith('##') && !nextLine.startsWith('###'))) {
-              requirementEndIndex = j;
-              break;
-            }
-          }
-          if (requirementEndIndex === -1) {
-            requirementEndIndex = lines.length;
-          }
-          break;
-        }
+    // Check if requirements file exists
+    if (!requirementsFileExists(repoPath)) {
+      result.actions.push('Creating requirements file...');
+      const created = await createRequirementsFile(repoPath);
+      if (created) {
+        result.actions.push('✅ Requirements file created');
+      } else {
+        result.errors.push('❌ Failed to create requirements file');
+        return result;
       }
+    } else {
+      result.actions.push('✅ Requirements file already exists');
     }
 
-    if (requirementStartIndex === -1) {
-      return false;
+    // Validate existing file
+    const validation = await validateRequirementsFile(repoPath);
+    if (!validation.isValid) {
+      result.warnings.push('⚠️ Requirements file has validation issues');
+      result.warnings.push(...validation.errors);
+    }
+    if (validation.warnings.length > 0) {
+      result.warnings.push('⚠️ Requirements file has warnings');
+      result.warnings.push(...validation.warnings);
     }
 
-    // Extract requirement block
-    const requirementBlock = lines.slice(requirementStartIndex, requirementEndIndex);
-    const extractedTitle = lines[requirementStartIndex].replace(/^###\s*/, '').trim();
-
-    // Remove requirement from TO VERIFY section
-    lines.splice(requirementStartIndex, requirementEndIndex - requirementStartIndex);
-
-    // Add to CHANGELOG.md
-    const allnightDir = path.dirname(reqPath);
-    const repoRoot = path.dirname(allnightDir);
-    const changelogPath = path.join(repoRoot, 'CHANGELOG.md');
-    const timestamp = new Date().toISOString().split('T')[0];
-    const changelogEntry = `- ${extractedTitle} (${timestamp})`;
-
-    let changelogContent = '';
-    if (await fs.pathExists(changelogPath)) {
-      changelogContent = await fs.readFile(changelogPath, 'utf-8');
-    } else {
-      changelogContent = '# Changelog\n\n## Verified Requirements\n\n';
+    // Create backup
+    const backupPath = await backupRequirementsFile(repoPath);
+    if (backupPath) {
+      result.actions.push(`✅ Backup created: ${backupPath}`);
     }
 
-    if (changelogContent.includes('## Verified Requirements')) {
-      changelogContent = changelogContent.replace(
-        '## Verified Requirements\n',
-        `## Verified Requirements\n${changelogEntry}\n`
-      );
-    } else {
-      changelogContent += `\n## Verified Requirements\n${changelogEntry}\n`;
+    // Clean up old backups
+    const cleanedCount = await cleanupBackupFiles(repoPath);
+    if (cleanedCount > 0) {
+      result.actions.push(`🗑️ Cleaned up ${cleanedCount} old backup files`);
     }
 
-    await fs.writeFile(changelogPath, changelogContent);
-    await fs.writeFile(reqPath, lines.join('\n'));
-    return true;
+    result.success = true;
+    return result;
+
   } catch (error) {
-    throw new Error(`Failed to promote requirement to verified: ${error.message}`);
+    return {
+      success: false,
+      actions: [],
+      warnings: [],
+      errors: [`Initialization failed: ${error.message}`]
+    };
   }
 }
 
 /**
- * Move requirement from VERIFIED (CHANGELOG) back to TODO with TRY AGAIN prefix
- * @param {string} reqPath - Path to REQUIREMENTS file
- * @param {string} requirementTitle - Title of requirement to move
- * @returns {Promise<boolean>} Success status
+ * Get requirement workflow status
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Workflow status
  */
-async function demoteFromVerifiedToTodo(reqPath, requirementTitle) {
+async function getWorkflowStatus(repoPath = null) {
   try {
-    // CHANGELOG.md should be at repository root, not in .vibecodingmachine directory
-    const allnightDir = path.dirname(reqPath); // .vibecodingmachine directory
-    const repoRoot = path.dirname(allnightDir); // repository root (one level up)
-    const changelogPath = path.join(repoRoot, 'CHANGELOG.md');
-
-    if (!(await fs.pathExists(changelogPath))) {
-      return false;
-    }
-
-    let changelogContent = await fs.readFile(changelogPath, 'utf-8');
-    const changelogLines = changelogContent.split('\n');
-    const updatedChangelogLines = [];
-    let requirementToMove = null;
-
-    for (const line of changelogLines) {
-      if (line.startsWith('- ')) {
-        const lineText = parseRequirementLine(line);
-        // Extract title part (before timestamp in parentheses)
-        const titleMatch = lineText.match(/^(.+?)\s*\([\d-]+\)$/);
-        const lineTitle = titleMatch ? titleMatch[1] : lineText;
-
-        // Check if this line matches the requirement title
-        // Handle both cases: requirementTitle might include timestamp or not
-        const reqTitleMatch = requirementTitle.match(/^(.+?)\s*\([\d-]+\)$/);
-        const reqTitleOnly = reqTitleMatch ? reqTitleMatch[1] : requirementTitle;
-
-        if (lineTitle === reqTitleOnly || lineTitle.includes(reqTitleOnly) || reqTitleOnly.includes(lineTitle)) {
-          requirementToMove = lineTitle;
-          continue;
-        }
-      }
-      updatedChangelogLines.push(line);
-    }
-
-    if (!requirementToMove) {
-      return false;
-    }
-
-    await fs.writeFile(changelogPath, updatedChangelogLines.join('\n'));
-
-    const content = await fs.readFile(reqPath, 'utf-8');
-    const lines = content.split('\n');
-    const updatedLines = [];
-    let foundTodoSection = false;
+    const status = await getCurrentStatus(repoPath);
+    const stage = getStatusStage(status);
+    const isDone = isStatusDone(status);
+    const nextStatus = getNextStatus(status);
+    const stats = await getRequirementStatistics(getRequirementsFilePath(repoPath));
 
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-
-      if (line.includes('## ⏳ Requirements not yet completed')) {
-        foundTodoSection = true;
-        updatedLines.push(line);
-        const requirementText = addTryAgainPrefix(requirementToMove);
-        updatedLines.push(`- ${requirementText}`);
-        continue;
-      }
-
-      updatedLines.push(line);
-    }
-
-    if (!foundTodoSection) {
-      updatedLines.push('## ⏳ Requirements not yet completed');
-      const requirementText = addTryAgainPrefix(requirementToMove);
-      updatedLines.push(`- ${requirementText}`);
-    }
-
-    await fs.writeFile(reqPath, updatedLines.join('\n'));
-    return true;
+    return {
+      current: status,
+      stage,
+      isDone,
+      nextStatus,
+      canProceed: !isDone && nextStatus !== null,
+      requirementsCount: stats.total,
+      todoCount: stats.todo,
+      verifyCount: stats.verify,
+      currentCount: stats.current,
+      timestamp: new Date().toISOString()
+    };
   } catch (error) {
-    throw new Error(`Failed to demote requirement from verified: ${error.message}`);
+    return {
+      error: error.message,
+      timestamp: new Date().toISOString()
+    };
   }
 }
 
 /**
- * Move requirement from TODO to TO VERIFY section
- * @param {string} reqPath - Path to REQUIREMENTS file
- * @param {string} requirementTitle - Title of requirement to move
- * @returns {Promise<boolean>} Success status
+ * Advance requirement workflow to next status
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Result of advancement
  */
-async function promoteTodoToVerify(reqPath, requirementTitle) {
+async function advanceWorkflow(repoPath = null) {
   try {
-    const content = await fs.readFile(reqPath, 'utf-8');
-    const lines = content.split('\n');
-
-    // Find the requirement block (### header format)
-    let requirementStartIndex = -1;
-    let requirementEndIndex = -1;
-    let inTodoSection = false;
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i].trim();
-
-      if (line.includes('## ⏳ Requirements not yet completed')) {
-        inTodoSection = true;
-        continue;
-      }
-
-      if (inTodoSection && line.startsWith('##') && !line.startsWith('###')) {
-        break;
-      }
-
-      if (inTodoSection && line.startsWith('###')) {
-        const title = line.replace(/^###\s*/, '').trim();
-        if (title && (title === requirementTitle || title.includes(requirementTitle) || requirementTitle.includes(title))) {
-          requirementStartIndex = i;
-          // Find the end of this requirement (next ### or ## header)
-          for (let j = i + 1; j < lines.length; j++) {
-            const nextLine = lines[j].trim();
-            if (nextLine.startsWith('###') || (nextLine.startsWith('##') && !nextLine.startsWith('###'))) {
-              requirementEndIndex = j;
-              break;
-            }
-          }
-          if (requirementEndIndex === -1) {
-            requirementEndIndex = lines.length;
-          }
-          break;
-        }
-      }
-    }
-
-    if (requirementStartIndex === -1) {
-      return false;
-    }
-
-    // Extract the requirement block
-    const requirementBlock = lines.slice(requirementStartIndex, requirementEndIndex);
-
-    // Remove the requirement from its current location
-    const updatedLines = [
-      ...lines.slice(0, requirementStartIndex),
-      ...lines.slice(requirementEndIndex)
-    ];
-
-    // Find or create TO VERIFY section
-    const verifySectionVariants = [
-      '## 🔍 TO VERIFY BY HUMAN',
-      '## 🔍 TO VERIFY',
-      '## TO VERIFY',
-      '## ✅ TO VERIFY',
-      '## ✅ Verified by AI screenshot'
-    ];
-
-    let verifyIndex = -1;
-    for (let i = 0; i < updatedLines.length; i++) {
-      if (verifySectionVariants.some(variant => updatedLines[i].includes(variant))) {
-        verifyIndex = i;
-        break;
-      }
-    }
-
-    if (verifyIndex === -1) {
-      // Create TO VERIFY section before CHANGELOG or at end
-      const changelogIndex = updatedLines.findIndex(line => line.includes('## CHANGELOG'));
-      const insertIndex = changelogIndex > 0 ? changelogIndex : updatedLines.length;
-      updatedLines.splice(insertIndex, 0, '', '## 🔍 TO VERIFY BY HUMAN', '');
-      verifyIndex = insertIndex + 1;
-    }
+    const currentStatus = await getCurrentStatus(repoPath);
+    const nextStatus = getNextStatus(currentStatus);
 
-    // Insert requirement block after section header
-    let insertIndex = verifyIndex + 1;
-    while (insertIndex < updatedLines.length && updatedLines[insertIndex].trim() === '') {
-      insertIndex++;
-    }
-    updatedLines.splice(insertIndex, 0, ...requirementBlock);
-    // Add blank line after if needed
-    if (insertIndex + requirementBlock.length < updatedLines.length && updatedLines[insertIndex + requirementBlock.length].trim() !== '') {
-      updatedLines.splice(insertIndex + requirementBlock.length, 0, '');
+    if (!nextStatus) {
+      return {
+        success: false,
+        message: 'Already at DONE status or invalid current status',
+        currentStatus,
+        nextStatus: null
+      };
     }
 
-    await fs.writeFile(reqPath, updatedLines.join('\n'));
-    return true;
+    const updated = await updateCurrentStatus(repoPath, nextStatus);
+    
+    return {
+      success: updated,
+      message: updated ? `Status advanced from ${currentStatus} to ${nextStatus}` : 'Failed to update status',
+      previousStatus: currentStatus,
+      currentStatus: nextStatus
+    };
   } catch (error) {
-    throw new Error(`Failed to promote requirement from TODO to TO VERIFY: ${error.message}`);
+    return {
+      success: false,
+      message: `Error advancing workflow: ${error.message}`,
+      error: error.message
+    };
   }
 }
 
 /**
- * Move requirement from TO VERIFY back to TODO section
- * @param {string} reqPath - Path to REQUIREMENTS file
- * @param {string} requirementTitle - Title of requirement to move
- * @param {string} explanation - Optional explanation of what went wrong
- * @returns {Promise<boolean>} Success status
+ * Get requirement health check
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Health check results
  */
-async function demoteVerifyToTodo(reqPath, requirementTitle, explanation = '') {
+async function getHealthCheck(repoPath = null) {
   try {
-    const content = await fs.readFile(reqPath, 'utf-8');
-    const lines = content.split('\n');
-
-    // Find ALL matching requirements in TO VERIFY section and remove them
-    // We'll collect all requirement blocks to remove, then process them
-    const requirementsToRemove = [];
-    let inVerifySection = false;
-
-    const verifySectionVariants = [
-      '## 🔍 TO VERIFY BY HUMAN',
-      '## 🔍 TO VERIFY',
-      '## TO VERIFY',
-      '## ✅ TO VERIFY',
-      '## ✅ Verified by AI screenshot. Needs Human to Verify and move to CHANGELOG',
-      '## ✅ Verified by AI screenshot'
-    ];
-
-    // First pass: find all matching requirements in TO VERIFY section
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-      const trimmed = line.trim();
-
-      // Check if this is a TO VERIFY section header
-      if (trimmed.startsWith('##') && !trimmed.startsWith('###')) {
-        const isToVerifyHeader = verifySectionVariants.some(variant => {
-          return trimmed === variant || trimmed.startsWith(variant) ||
-            (trimmed.includes('Verified by AI screenshot') && trimmed.includes('Needs Human to Verify'));
-        });
-
-        if (isToVerifyHeader) {
-          // Make sure it's not a VERIFIED section (without TO VERIFY)
-          if (!trimmed.includes('## 📝 VERIFIED') && !trimmed.match(/^##\s+VERIFIED$/i) && !trimmed.includes('📝 VERIFIED')) {
-            inVerifySection = true;
-            continue;
-          }
-        } else if (inVerifySection) {
-          // Check if we're leaving TO VERIFY section (hit a different section)
-          if (trimmed.includes('⏳ Requirements not yet completed') ||
-            trimmed.includes('## 📝 VERIFIED') ||
-            trimmed.includes('## ♻️ RECYCLED') ||
-            trimmed.includes('## 📦 RECYCLED') ||
-            trimmed.includes('## ❓ Requirements needing')) {
-            // We've left the TO VERIFY section
-            inVerifySection = false;
-          }
-        }
-      }
-
-      // Look for requirement in TO VERIFY section
-      if (inVerifySection && trimmed.startsWith('###')) {
-        const title = trimmed.replace(/^###\s*/, '').trim();
-        // Normalize titles for matching (handle TRY AGAIN prefixes)
-        const normalizedTitle = title.replace(/^TRY AGAIN \(\d+(st|nd|rd|th) time\):\s*/i, '').trim();
-        const normalizedRequirementTitle = requirementTitle.replace(/^TRY AGAIN \(\d+(st|nd|rd|th) time\):\s*/i, '').trim();
-
-        if (title && (title === requirementTitle ||
-          normalizedTitle === normalizedRequirementTitle ||
-          title.includes(requirementTitle) ||
-          requirementTitle.includes(title) ||
-          normalizedTitle.includes(normalizedRequirementTitle) ||
-          normalizedRequirementTitle.includes(normalizedTitle))) {
-          // Find the end of this requirement (next ### or ## header)
-          let requirementEndIndex = lines.length;
-          for (let j = i + 1; j < lines.length; j++) {
-            const nextLine = lines[j].trim();
-            if (nextLine.startsWith('###') || (nextLine.startsWith('##') && !nextLine.startsWith('###'))) {
-              requirementEndIndex = j;
-              break;
-            }
-          }
-
-          // Store this requirement to remove (we'll use the first one for moving to TODO)
-          requirementsToRemove.push({
-            start: i,
-            end: requirementEndIndex,
-            block: lines.slice(i, requirementEndIndex)
-          });
-        }
-      }
-    }
+    const fileStats = await getRequirementsFileStats(repoPath);
+    const validation = await validateRequirementsFile(repoPath);
+    const statusSummary = await getStatusSummary(getRequirementsFilePath(repoPath));
+    const stats = await getRequirementStatistics(getRequirementsFilePath(repoPath));
+
+    const health = {
+      status: 'healthy',
+      issues: [],
+      recommendations: [],
+      score: 100
+    };
 
-    if (requirementsToRemove.length === 0) {
-      return false;
+    // Check file existence
+    if (!fileStats.exists) {
+      health.status = 'critical';
+      health.issues.push('Requirements file does not exist');
+      health.recommendations.push('Create a requirements file');
+      health.score -= 50;
     }
 
-    // Use the first matching requirement for moving to TODO (with TRY AGAIN prefix)
-    const firstRequirement = requirementsToRemove[0];
-    const requirementBlock = [...firstRequirement.block];
-
-    // Update title with TRY AGAIN prefix
-    const originalTitle = requirementBlock[0].replace(/^###\s*/, '').trim();
-    const titleWithPrefix = addTryAgainPrefix(originalTitle);
-    requirementBlock[0] = `### ${titleWithPrefix}`;
-
-    // Add explanation to the requirement description if provided
-    if (explanation && explanation.trim()) {
-      // Find where to insert the explanation (after the title, before any existing content)
-      // Insert after first line (title) with a blank line and "What went wrong:" section
-      const explanationLines = [
-        '',
-        '**What went wrong (from previous attempt):**',
-        explanation.trim(),
-        ''
-      ];
-      requirementBlock.splice(1, 0, ...explanationLines);
+    // Check validation
+    if (!validation.isValid) {
+      health.status = 'warning';
+      health.issues.push('Requirements file has validation errors');
+      health.recommendations.push('Fix validation errors');
+      health.score -= 20;
     }
 
-    // Remove ALL matching requirements from TO VERIFY section (work backwards to preserve indices)
-    const updatedLines = [...lines];
-    for (let i = requirementsToRemove.length - 1; i >= 0; i--) {
-      const req = requirementsToRemove[i];
-      updatedLines.splice(req.start, req.end - req.start);
+    // Check status
+    if (!statusSummary.current) {
+      health.issues.push('No current status set');
+      health.recommendations.push('Set a current status');
+      health.score -= 10;
     }
 
-    // Find or create TODO section
-    let todoIndex = -1;
-    for (let i = 0; i < updatedLines.length; i++) {
-      if (updatedLines[i].includes('## ⏳ Requirements not yet completed')) {
-        todoIndex = i;
-        break;
-      }
+    // Check for stuck requirements
+    if (stats.verify > 10) {
+      health.issues.push('Many requirements waiting for verification');
+      health.recommendations.push('Review and verify pending requirements');
+      health.score -= 5;
     }
 
-    if (todoIndex === -1) {
-      // Create TODO section at the top (after initial headers)
-      const firstSectionIndex = updatedLines.findIndex(line => line.startsWith('##') && !line.startsWith('###'));
-      const insertIndex = firstSectionIndex > 0 ? firstSectionIndex : updatedLines.length;
-      updatedLines.splice(insertIndex, 0, '## ⏳ Requirements not yet completed', '');
-      todoIndex = insertIndex;
+    // Check file size
+    if (fileStats.size > 50000) { // 50KB
+      health.issues.push('Requirements file is large');
+      health.recommendations.push('Consider archiving old requirements');
+      health.score -= 5;
     }
 
-    // Insert requirement block after section header
-    let insertIndex = todoIndex + 1;
-    while (insertIndex < updatedLines.length && updatedLines[insertIndex].trim() === '') {
-      insertIndex++;
-    }
-    updatedLines.splice(insertIndex, 0, ...requirementBlock);
-    // Add blank line after if needed
-    if (insertIndex + requirementBlock.length < updatedLines.length && updatedLines[insertIndex + requirementBlock.length].trim() !== '') {
-      updatedLines.splice(insertIndex + requirementBlock.length, 0, '');
-    }
-
-    await fs.writeFile(reqPath, updatedLines.join('\n'));
-    return true;
-  } catch (error) {
-    throw new Error(`Failed to demote requirement from TO VERIFY to TODO: ${error.message}`);
-  }
-}
-
-/**
- * Load verified requirements from CHANGELOG.md
- * @param {string} repoPath - Repository root path
- * @returns {Promise<string[]>} List of verified requirement titles
- */
-async function loadVerifiedFromChangelog(repoPath) {
-  try {
-    const changelogPath = path.join(repoPath, 'CHANGELOG.md');
-    if (!(await fs.pathExists(changelogPath))) {
-      return [];
+    // Determine final status
+    if (health.score >= 90) {
+      health.status = 'healthy';
+    } else if (health.score >= 70) {
+      health.status = 'warning';
+    } else {
+      health.status = 'critical';
     }
 
-    const content = await fs.readFile(changelogPath, 'utf8');
-    const lines = content.split('\n');
-    const requirements = [];
-    let inVerifiedSection = false;
+    return health;
 
-    for (const line of lines) {
-      const trimmed = line.trim();
-
-      if (trimmed.includes('## Verified Requirements')) {
-        inVerifiedSection = true;
-        continue;
-      }
-
-      if (inVerifiedSection && trimmed.startsWith('##') && !trimmed.includes('Verified Requirements')) {
-        break;
-      }
-
-      // Collect items starting with "- " as verified requirements
-      if (inVerifiedSection && trimmed.startsWith('- ') && trimmed.length > 5) {
-        let reqText = trimmed.substring(2);
-        // Extract title part (before timestamp in parentheses if present)
-        const titleMatch = reqText.match(/^(.+?)\s*\([\d-]+\)$/);
-        if (titleMatch) {
-          reqText = titleMatch[1];
-        }
-        requirements.push(reqText.trim());
-      }
-    }
-
-    return requirements;
   } catch (error) {
-    logger.error('❌ Error loading verified requirements from CHANGELOG.md:', error);
-    return [];
-  }
-}
-
-/**
- * Get unified project requirement statistics (TODO, TO VERIFY, VERIFIED)
- * @param {string} repoPath - Repository root path
- * @returns {Promise<Object>} Statistics with counts and formatted percentages
- */
-async function getProjectRequirementStats(repoPath) {
-  try {
-    const hostname = os.hostname();
-    const { getRequirementsPath } = require('./repo-helpers.cjs');
-    const reqPath = await getRequirementsPath(repoPath, hostname);
-
-    let todoCount = 0;
-    let toVerifyCount = 0;
-    let verifiedCount = 0;
-    let clarificationCount = 0;
-    let recycledCount = 0;
-
-    if (reqPath && await fs.pathExists(reqPath)) {
-      const content = await fs.readFile(reqPath, 'utf8');
-      const lines = content.split('\n');
-      let currentSection = '';
-
-      const verifySectionVariants = [
-        '🔍 TO VERIFY BY HUMAN',
-        'TO VERIFY BY HUMAN',
-        '🔍 TO VERIFY',
-        'TO VERIFY',
-        '✅ Verified by AI screenshot',
-        'Verified by AI screenshot'
-      ];
-
-      const clarificationVariants = [
-        'NEEDING CLARIFICATION',
-        'Requirements that need information',
-        'need information'
-      ];
-
-      const recycledVariants = [
-        '♻️ Recycled',
-        'Recycled'
-      ];
-
-      for (const line of lines) {
-        const trimmed = line.trim();
-
-        if (trimmed.startsWith('###')) {
-          if (currentSection) {
-            // Remove ALL leading ### markers including spaces between them (handles "###", "### ###", "#### ####", etc.)
-            const requirementText = trimmed.replace(/^(#{1,}\s*)+/, '').trim();
-            // Filter out empty titles and package names
-            const packageNames = ['cli', 'core', 'electron-app', 'web', 'mobile', 'vscode-extension', 'sync-server'];
-            if (requirementText && requirementText.length > 0 && !packageNames.includes(requirementText.toLowerCase())) {
-              if (currentSection === 'todo') todoCount++;
-              else if (currentSection === 'toverify') toVerifyCount++;
-              else if (currentSection === 'clarification') clarificationCount++;
-              else if (currentSection === 'recycled') recycledCount++;
-            }
-          }
-        } else if (trimmed.startsWith('##') && !trimmed.startsWith('###')) {
-          if (trimmed.includes('⏳ Requirements not yet completed') ||
-            trimmed.includes('Requirements not yet completed')) {
-            currentSection = 'todo';
-          } else if (verifySectionVariants.some(v => trimmed.includes(v))) {
-            currentSection = 'toverify';
-          } else if (clarificationVariants.some(v => trimmed.includes(v))) {
-            currentSection = 'clarification';
-          } else if (recycledVariants.some(v => trimmed.includes(v))) {
-            currentSection = 'recycled';
-          } else {
-            currentSection = '';
-          }
-        }
-      }
-    }
-
-    // Load verified counts from CHANGELOG.md
-    const verifiedReqs = await loadVerifiedFromChangelog(repoPath);
-    verifiedCount = verifiedReqs.length;
-
-    const total = todoCount + toVerifyCount + verifiedCount + clarificationCount + recycledCount;
-    const todoPercent = total > 0 ? Math.round((todoCount / total) * 100) : 0;
-    const toVerifyPercent = total > 0 ? Math.round((toVerifyCount / total) * 100) : 0;
-    const verifiedPercent = total > 0 ? Math.round((verifiedCount / total) * 100) : 0;
-    const clarificationPercent = total > 0 ? Math.round((clarificationCount / total) * 100) : 0;
-    const recycledPercent = total > 0 ? Math.round((recycledCount / total) * 100) : 0;
-
     return {
-      todoCount,
-      toVerifyCount,
-      verifiedCount,
-      clarificationCount,
-      recycledCount,
-      total,
-      todoPercent,
-      toVerifyPercent,
-      verifiedPercent,
-      clarificationPercent,
-      recycledPercent,
-      todoLabel: `TODO (${todoCount} - ${todoPercent}%)`,
-      toVerifyLabel: `TO VERIFY (${toVerifyCount} - ${toVerifyPercent}%)`,
-      verifiedLabel: `VERIFIED (${verifiedCount} - ${verifiedPercent}%)`,
-      clarificationLabel: `CLARIFICATION (${clarificationCount} - ${clarificationPercent}%)`,
-      recycledLabel: `RECYCLED (${recycledCount} - ${recycledPercent}%)`
+      status: 'error',
+      issues: [`Health check failed: ${error.message}`],
+      recommendations: ['Check file permissions and paths'],
+      score: 0,
+      error: error.message
     };
-  } catch (error) {
-    logger.error('❌ Error getting project requirement stats:', error);
-    return null;
   }
 }
 
+// Export everything
 module.exports = {
+  // Parser utilities
+  DEFAULT_INSTRUCTION_TEXT,
   getOrdinalSuffix,
   addTryAgainPrefix,
   parseRequirementLine,
+  extractRequirementTitle,
+  isRequirementMatch,
+  parseRequirementBlock,
+  findRequirementBlock,
+  findAllRequirementsInSection,
+  validateRequirementFormat,
+  formatRequirementForDisplay,
+
+  // Movement operations
   promoteToVerified,
   demoteFromVerifiedToTodo,
   promoteTodoToVerify,
-  demoteVerifyToTodo,
-  // New shared functions
-  getCurrentRequirement,
-  getCurrentRequirementName,
-  getCurrentRequirementProgress,
-  isCurrentRequirementDone,
-  moveToNextRequirement,
-  createDefaultRequirementsFile,
-  getOrCreateRequirementsFilePath,
-  loadVerifiedFromChangelog,
-  getProjectRequirementStats,
-  DEFAULT_INSTRUCTION_TEXT
+  demoteFromVerifyToTodo,
+  moveToCurrent,
+  getRequirementsInSection,
+  getRequirementStatistics,
+
+  // Status management
+  extractCurrentStatus,
+  updateCurrentStatus,
+  getCurrentStatus,
+  isStatusDone,
+  isStatusInProgress,
+  getStatusStage,
+  validateStatus,
+  getNextStatus,
+  getPreviousStatus,
+  isValidStatusTransition,
+  getStatusHistory,
+  formatStatusForDisplay,
+  getStatusSummary,
+
+  // File operations
+  getRequirementsFilePath,
+  requirementsFileExists,
+  createRequirementsFile,
+  readRequirementsFile,
+  writeRequirementsFile,
+  backupRequirementsFile,
+  getRequirementsFileStats,
+  validateRequirementsFile,
+  getAllRequirementsFiles,
+  cleanupBackupFiles,
+
+  // High-level operations
+  getRequirementSystemInfo,
+  initializeRequirementsSystem,
+  getWorkflowStatus,
+  advanceWorkflow,
+  getHealthCheck
 };
-
-// --- Ported Functions from Electron App ---
-
-// Function to create a default requirements file
-function createDefaultRequirementsFile(repoPath) {
-  try {
-    const hostname = os.hostname();
-    // Use the core logic to find the .vibecodingmachine directory
-    // Note: This logic assumes we want to create it INSIDE the repo if it doesn't exist?
-    // Electron app logic was: path.join(repoPath, '.vibecodingmachine')
-    // We'll stick to that for creation.
-    const vibecodingmachineDir = path.join(repoPath, '.vibecodingmachine');
-
-    // Ensure .vibecodingmachine directory exists
-    if (!fs.existsSync(vibecodingmachineDir)) {
-      fs.mkdirSync(vibecodingmachineDir, { recursive: true });
-      logger.log('📁 Created .vibecodingmachine directory');
-    }
-
-    // Create hostname-specific requirements file
-    const requirementsFilePath = path.join(vibecodingmachineDir, `REQUIREMENTS-${hostname}.md`);
-
-    const defaultContent = `# 🌙 VibeCodingMachine – Requirements File
-
-This is a Markdown (.md) file.
-
-You should not need to modify this file, as VibeCodingMachine will modify it for you, but you can add requirements and move them around either here directly, or via AI.
-
-This file contains the requirements to complete the project. Each item in a list is a self contained requirement that should be able to stand on its own, and not require reference to other requirements. Each requirement starts in the section of requirements to complete, then it moved to the section with the current requirement being worked on. VibeCodingMachine will then, after implementing the requirement, move it to the completed requirements list in the CHANGELOG.md file, or to the section in this file for requirements that need attention. These will be available for you to review. They should have options to choose, and you decide which option to take, and VibeCodingMachine will work on that again the next time it is run.
-
-## RESPONSE FROM LAST CHAT
-
-### ONE LINE STATUS: READY
-
-### ONE LINE SUMMARY: New requirements file created
-
-### MULTILINE DETAILS: (1-20 lines max)
-
-**REQUIREMENT:**
-- Initial setup complete
-
-**ALL PHASES COMPLETED:**
-- ✅ Requirements file created
-- ✅ Ready for new requirements
-
-## 🔨 Current In Progress Requirement
-
-*No current requirement in progress*
-
-## 📋 Requirements to Complete
-
-*No requirements to complete*
-
-## ⚠️ Requirements That Need Attention
-
-*No requirements need attention*
-
-## ✅ Completed Requirements
-
-*No completed requirements yet*
-
----
-
-*This file was automatically created by VibeCodingMachine*
-`;
-
-    fs.writeFileSync(requirementsFilePath, defaultContent, 'utf8');
-    logger.log(`📄 Created default requirements file: ${requirementsFilePath}`);
-
-    return requirementsFilePath;
-  } catch (error) {
-    logger.error('❌ Error creating default requirements file:', error);
-    throw error;
-  }
-}
-
-// Function to get or create requirements file path
-async function getOrCreateRequirementsFilePath(repoPath) {
-  try {
-    const hostname = os.hostname();
-
-    // Use shared logic to find existing path first
-    let requirementsFilePath = await getRequirementsPath(repoPath, hostname);
-
-    if (requirementsFilePath && await fs.pathExists(requirementsFilePath)) {
-      return requirementsFilePath;
-    } else {
-      // Create a new hostname-specific requirements file
-      // We default to creating it inside the repo under .vibecodingmachine
-      requirementsFilePath = path.join(repoPath, '.vibecodingmachine', `REQUIREMENTS-${hostname}.md`);
-
-      const fs = require('fs-extra');
-      const defaultRequirementsContent = `# 🌙 VibeCodingMachine – Requirements File
-
-This is a Markdown (.md) file.
-
-You should not need to modify this file, as VibeCodingMachine will modify it for you, but you can add requirements and move them around either here directly, or via AI.
-
-This file contains the requirements to complete the project.  Each item in a list is a self contained requirement that should be able to stand on its own, and not require reference to other requirements.  Each requirement starts in the section of requirements to complete, then it moved to the section with the current requirement being worked on.  VibeCodingMachine will then, after implementing the requirement, move it to the completed requirements list in the CHANGELOG.md file, or to the section in this file for requirements that need attention.  These will be available for you to review.  They should have options to choose, and you decide which option to take, and VibeCodingMachine will work on that again the next time it is run.
-
-## RESPONSE FROM LAST CHAT
-
-### ONE LINE STATUS: 
-
-### ONE LINE SUMMARY: 
-
-### MULTILINE DETAILS: (1-20 lines max)
-
-## 🔨 Current In Progress Requirement
-
-- 
-
-## 🚦 Current Status
-
-PREPARE
-
-## ⏳ Requirements not yet completed
-
-- 
-
-## ✅ Verified by AI screenshot
-
-`;
-      fs.ensureDirSync(path.join(repoPath, '.vibecodingmachine'));
-      fs.writeFileSync(requirementsFilePath, defaultRequirementsContent, 'utf8');
-    }
-
-    return requirementsFilePath;
-  } catch (error) {
-    logger.error('❌ Error getting or creating requirements file path:', error);
-    throw error;
-  }
-}
-
-// Function to get current requirement being worked on
-async function getCurrentRequirement(repoPath) {
-  try {
-    const rPath = repoPath || process.cwd();
-    // Get the requirements file path (create if doesn't exist)
-    const requirementsFilePath = await getOrCreateRequirementsFilePath(rPath);
-
-    // Read the requirements file content
-    const content = await fs.readFile(requirementsFilePath, 'utf8');
-    const lines = content.split('\n');
-
-    // Look for the current in progress requirement
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].includes('## 🔨 Current In Progress Requirement')) {
-        // Look for the next requirement line
-        for (let j = i + 1; j < lines.length; j++) {
-          if (lines[j].trim().startsWith('- ')) {
-            let requirementText = lines[j].substring(2).trim();
-
-            // Extract the requirement title (remove FAILED prefix if present)
-            if (requirementText.startsWith('FAILED ')) {
-              const failedMatch = requirementText.match(/^FAILED \d+ TIMES?: (.+)$/);
-              if (failedMatch) {
-                requirementText = failedMatch[1];
-              }
-            }
-
-            // Extract just the title part (before the colon)
-            const colonIndex = requirementText.indexOf(':');
-            if (colonIndex !== -1) {
-              requirementText = requirementText.substring(0, colonIndex).trim();
-            }
-
-            // Remove markdown formatting
-            requirementText = requirementText.replace(/\*\*/g, '');
-
-            return `Working on: ${requirementText}`;
-          }
-        }
-        break;
-      }
-    }
-
-    return DEFAULT_INSTRUCTION_TEXT;
-  } catch (error) {
-    logger.error('❌ Error getting current requirement:', error);
-    return DEFAULT_INSTRUCTION_TEXT;
-  }
-}
-
-// Function to check if the current requirement status is DONE
-async function isCurrentRequirementDone(repoPath) {
-  try {
-    const rPath = repoPath || process.cwd();
-    const hostname = os.hostname();
-
-    // Use shared logic to find the file
-    const requirementsFilePath = await getRequirementsPath(rPath, hostname);
-
-    if (!requirementsFilePath || !(await fs.pathExists(requirementsFilePath))) {
-      return false;
-    }
-
-    // Read the requirements file content
-    const content = await fs.readFile(requirementsFilePath, 'utf8');
-    const lines = content.split('\n');
-
-    // First pass: check if "Current Status" section contains DONE
-    let inStatusSection = false;
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i].trim();
-
-      if (line.includes('## 🚦 Current Status')) {
-        inStatusSection = true;
-        continue;
-      }
-
-      // If we're in the status section
-      if (inStatusSection) {
-        // Hit another section header, exit
-        if (line.startsWith('##')) {
-          break;
-        }
-
-        // Check if this line contains DONE (case-insensitive, exact word match)
-        if (line) {
-          const upperLine = line.toUpperCase();
-          // Match DONE as a standalone word or at the start of the line
-          if (upperLine === 'DONE' || upperLine.startsWith('DONE:') || upperLine.startsWith('DONE ')) {
-            logger.log('✅ DONE status detected in Current Status section:', line);
-            return true;
-          }
-        }
-      }
-    }
-
-    // Second pass: check if "Current In Progress Requirement" section is empty
-    let inCurrentSection = false;
-    let foundRequirement = false;
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i].trim();
-
-      if (line.includes('## 🔨 Current In Progress Requirement')) {
-        inCurrentSection = true;
-        continue;
-      }
-
-      // If we're in the current section and hit another section header, exit
-      if (inCurrentSection && line.startsWith('##')) {
-        // If section was empty (no requirement found), it's done
-        if (!foundRequirement) {
-          logger.log('✅ Current requirement section is empty - considering as done');
-          return true;
-        }
-        break;
-      }
-
-      // Track if we found a requirement in the current section
-      if (inCurrentSection && line.startsWith('- ')) {
-        foundRequirement = true;
-      }
-    }
-
-    // If we found a requirement but no DONE status, it's not done yet
-    if (foundRequirement) {
-      logger.log('❌ Found requirement but status is not DONE');
-      return false;
-    }
-
-    // Default: not done
-    return false;
-  } catch (error) {
-    logger.error('❌ Error checking requirement status:', error);
-    return false;
-  }
-}
-
-// Shared function to move to next requirement (used by both IPC and auto mode)
-let isMovingToNextRequirement = false; // Prevent duplicate calls
-let lastMoveTime = 0; // Track when last move happened
-
-async function moveToNextRequirement(repoPath) {
-  const now = Date.now();
-  const rPath = repoPath || process.cwd();
-
-  // Prevent duplicate calls within 5 seconds
-  if (isMovingToNextRequirement || (now - lastMoveTime < 5000)) {
-    logger.log('⚠️ moveToNextRequirement already in progress or called too recently, skipping duplicate call');
-    return { success: false, error: 'Already moving to next requirement or called too recently' };
-  }
-
-  isMovingToNextRequirement = true;
-  lastMoveTime = now;
-
-  try {
-    logger.log('🔄 Moving to next requirement');
-
-    const hostname = os.hostname();
-    // Use shared logic
-    const requirementsFilePath = await getRequirementsPath(rPath, hostname);
-
-    if (!requirementsFilePath || !(await fs.pathExists(requirementsFilePath))) {
-      return { success: false, error: 'Requirements file not found' };
-    }
-
-    // Get auto mode config to check skipDisabled setting
-    let skipDisabled = false;
-    try {
-      const { getAutoConfig } = require('../../../cli/src/utils/config');
-      const autoConfig = await getAutoConfig();
-      skipDisabled = autoConfig.skipDisabled || false;
-    } catch (error) {
-      // If CLI config is not available, default to false
-      logger.log('⚠️ Could not get auto config, using skipDisabled = false');
-    }
-
-    // Read current content
-    const content = await fs.readFile(requirementsFilePath, 'utf8');
-    const lines = content.split('\n');
-
-    // Extract current requirement and remove from "Current In Progress"
-    let currentRequirement = null;
-    let inCurrentSection = false;
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].includes('## 🔨 Current In Progress Requirement')) {
-        inCurrentSection = true;
-        continue;
-      }
-      if (inCurrentSection && lines[i].trim().startsWith('- ')) {
-        currentRequirement = lines[i].substring(2).trim();
-        break;
-      }
-      if (inCurrentSection && lines[i].trim().startsWith('##')) {
-        break;
-      }
-    }
-
-    // Get first non-disabled requirement from "Requirements not yet completed"
-    let nextRequirement = null;
-    let inNotYetCompleted = false;
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].includes('## ⏳ Requirements not yet completed')) {
-        inNotYetCompleted = true;
-        continue;
-      }
-      if (inNotYetCompleted && lines[i].trim().startsWith('- ')) {
-        const requirementText = lines[i].substring(2).trim();
-        
-        // Check if requirement is disabled (starts with 'DISABLED:')
-        const isDisabled = requirementText.startsWith('DISABLED:');
-        
-        // Skip disabled requirements if skipDisabled is enabled
-        if (skipDisabled && isDisabled) {
-          logger.log(`⏭️  Skipping disabled requirement: ${requirementText}`);
-          continue;
-        }
-        
-        nextRequirement = requirementText;
-        break;
-      }
-      if (inNotYetCompleted && lines[i].trim().startsWith('##')) {
-        break;
-      }
-    }
-
-    if (!nextRequirement) {
-      return { success: false, error: 'No more requirements to process' };
-    }
-
-    // Count requirements in "not yet completed" (before moving)
-    let totalRequirementsNotYetCompleted = 0;
-    inNotYetCompleted = false;
-    for (const line of lines) {
-      if (line.includes('## ⏳ Requirements not yet completed')) {
-        inNotYetCompleted = true;
-        continue;
-      }
-      if (inNotYetCompleted && line.trim().startsWith('##')) {
-        break;
-      }
-      if (inNotYetCompleted && line.trim().startsWith('- ')) {
-        const requirementText = line.substring(2).trim();
-        const isDisabled = requirementText.startsWith('DISABLED:');
-        
-        // Don't count disabled requirements if skipDisabled is enabled
-        if (!skipDisabled || !isDisabled) {
-          totalRequirementsNotYetCompleted++;
-        }
-      }
-    }
-
-    // Count completed requirements in "Verified by AI" section
-    let completedCount = 0;
-    let inVerifiedSection = false;
-    for (const line of lines) {
-      if (line.includes('## ✅ Verified by AI screenshot')) {
-        inVerifiedSection = true;
-        continue;
-      }
-      if (inVerifiedSection && line.trim().startsWith('##')) {
-        break;
-      }
-      if (inVerifiedSection && line.trim().startsWith('- ')) {
-        completedCount++;
-      }
-    }
-
-    // Update the file: move current to "Verified by AI", move next to "Current In Progress"
-    const updatedLines = [];
-    inCurrentSection = false;
-    inNotYetCompleted = false;
-    inVerifiedSection = false;
-    let addedCurrentToVerified = false;
-    let addedNextToCurrent = false;
-    let removedNextFromNotYetCompleted = false;
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-
-      // Handle "Current In Progress Requirement" section
-      if (line.includes('## 🔨 Current In Progress Requirement')) {
-        inCurrentSection = true;
-        updatedLines.push(line);
-        updatedLines.push('');
-        updatedLines.push(`- ${nextRequirement}`);
-        updatedLines.push('');
-        addedNextToCurrent = true;
-        continue;
-      }
-
-      // Skip old current requirement and any text in the current section
-      if (inCurrentSection && !line.trim().startsWith('##')) {
-        // Skip lines until we hit the next section header
-        continue;
-      }
-      if (inCurrentSection && line.trim().startsWith('##')) {
-        inCurrentSection = false;
-        // Don't continue - we want to process this section header
-      }
-
-      // Handle "Current Status" section
-      if (line.includes('## 🚦 Current Status')) {
-        updatedLines.push(line);
-        updatedLines.push('');
-        updatedLines.push('PREPARE');
-        updatedLines.push('');
-
-        // Skip all old status lines until we hit the next section
-        let j = i + 1;
-        while (j < lines.length && !lines[j].trim().startsWith('##')) {
-          j++;
-        }
-        i = j - 1; // Set i to the line before the next section (loop will increment)
-        continue;
-      }
-
-      // Handle "Requirements not yet completed" section
-      if (line.includes('## ⏳ Requirements not yet completed')) {
-        inNotYetCompleted = true;
-        updatedLines.push(line);
-        continue;
-      }
-
-      // Remove the next requirement from "not yet completed"
-      if (inNotYetCompleted && line.trim().startsWith('- ') && !removedNextFromNotYetCompleted) {
-        const requirementText = line.substring(2).trim();
-        if (requirementText === nextRequirement) {
-          inNotYetCompleted = false;
-          removedNextFromNotYetCompleted = true;
-          continue; // Skip this line
-        }
-      }
-
-      // Handle "Verified by AI" section
-      if (line.includes('## ✅ Verified by AI screenshot')) {
-        inNotYetCompleted = false;
-        if (currentRequirement && !addedCurrentToVerified) {
-          // Check if this requirement is already in the verified section
-          const requirementAlreadyExists = updatedLines.some(existingLine =>
-            existingLine.includes(currentRequirement) && existingLine.trim().startsWith('- ')
-          );
-
-          if (!requirementAlreadyExists) {
-            updatedLines.push(line);
-            updatedLines.push('');
-            // Don't add date prefix - just add the requirement as-is to avoid nesting
-            updatedLines.push(`- ${currentRequirement}`);
-            updatedLines.push('');
-            addedCurrentToVerified = true;
-            continue;
-          } else {
-            logger.log(`⚠️ Requirement "${currentRequirement}" already exists in verified section, skipping duplicate`);
-            addedCurrentToVerified = true;
-          }
-        }
-        updatedLines.push(line);
-        continue;
-      }
-
-      updatedLines.push(line);
-    }
-
-    // Write updated content
-    await fs.writeFile(requirementsFilePath, updatedLines.join('\n'), 'utf8');
-
-    // Calculate current number:
-    // - We just completed 1 requirement (moved to "Verified by AI")
-    // - completedCount already includes previously completed requirements
-    // - So current number = completedCount + 1 (the one we just completed) + 1 (the new current one)
-    // - Which simplifies to: completedCount + 2
-    const currentNumber = completedCount + 2; // +1 for the one we just completed, +1 for the new current one we're starting
-
-    // Total requirements = completedCount + 1 (current) + totalRequirementsNotYetCompleted
-    const totalRequirements = completedCount + 1 + totalRequirementsNotYetCompleted;
-
-    logger.log(`✅ Moved to next requirement: ${nextRequirement}`);
-    logger.log(`📊 Progress: ${currentNumber}/${totalRequirements} (completed: ${completedCount + 1}, remaining: ${totalRequirementsNotYetCompleted - 1})`);
-    logger.log(`📝 Moved to requirement: ${nextRequirement}`);
-
-    return {
-      success: true,
-      nextRequirement: nextRequirement,
-      currentNumber: currentNumber,
-      totalRemaining: totalRequirementsNotYetCompleted - 1
-    };
-  } catch (error) {
-    logger.error('❌ Error moving to next requirement:', error);
-    return { success: false, error: error.message };
-  } finally {
-    // Always reset the flag, even if there was an error
-    isMovingToNextRequirement = false;
-  }
-}
-
-// Function to get current requirement progress numbers
-async function getCurrentRequirementProgress(repoPath) {
-  try {
-    const stats = await getProjectRequirementStats(repoPath);
-    if (!stats) {
-      return { currentNumber: 1, totalRequirements: 1 };
-    }
-
-    // currentNumber = verified + toVerify + 1 (the one we're on)
-    const currentNumber = stats.verifiedCount + stats.toVerifyCount + 1;
-    const totalRequirements = stats.total;
-
-    // Ensure currentNumber doesn't exceed total
-    const sanitizedCurrent = Math.min(currentNumber, totalRequirements || 1);
-
-    return { currentNumber: sanitizedCurrent, totalRequirements: totalRequirements || 1 };
-  } catch (error) {
-    logger.error('❌ Error getting current requirement progress:', error);
-    return { currentNumber: 1, totalRequirements: 1 };
-  }
-}
-
-// Function to get current requirement name only (without "Working on:" prefix)
-async function getCurrentRequirementName(repoPath) {
-  try {
-    const rPath = repoPath || process.cwd();
-    const hostname = os.hostname();
-
-    const requirementsFilePath = await getRequirementsPath(rPath, hostname);
-
-    if (!requirementsFilePath || !(await fs.pathExists(requirementsFilePath))) {
-      return null;
-    }
-
-    // Read the requirements file content
-    const content = await fs.readFile(requirementsFilePath, 'utf8');
-    const lines = content.split('\n');
-
-    // Look for the current in progress requirement
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].includes('## 🔨 Current In Progress Requirement')) {
-        // Look for the next requirement line
-        for (let j = i + 1; j < lines.length; j++) {
-          if (lines[j].trim().startsWith('- ')) {
-            let requirementText = lines[j].substring(2).trim();
-
-            // Remove markdown formatting (bold **)
-            requirementText = requirementText.replace(/\*\*/g, '');
-
-            // Return the full requirement text without any prefix
-            return requirementText;
-          }
-        }
-        break;
-      }
-    }
-
-    return null;
-  } catch (error) {
-    logger.error('❌ Error getting current requirement name:', error);
-    return null;
-  }
-}
-
-