vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/utils/requirement-movement-operations.js

@@ -0,0 +1,450 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { getRequirementsPath } = require('./repo-helpers.cjs');
+const { logger } = require('./logger.cjs');
+const { addTryAgainPrefix, parseRequirementLine } = require('./requirement-parsing-helpers');
+
+/**
+ * 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
+ */
+async function promoteToVerified(reqPath, requirementTitle) {
+  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;
+
+          // 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;
+        }
+      }
+    }
+
+    if (requirementStartIndex === -1) {
+      return false;
+    }
+
+    // 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';
+    }
+
+    if (changelogContent.includes('## Verified Requirements')) {
+      changelogContent = changelogContent.replace(
+        '## Verified Requirements\n',
+        `## Verified Requirements\n${changelogEntry}\n`
+      );
+    } else {
+      changelogContent += `\n## Verified Requirements\n${changelogEntry}\n`;
+    }
+
+    await fs.writeFile(changelogPath, changelogContent);
+    await fs.writeFile(reqPath, lines.join('\n'));
+    return true;
+  } catch (error) {
+    throw new Error(`Failed to promote requirement to verified: ${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
+ */
+async function demoteFromVerifiedToTodo(reqPath, requirementTitle) {
+  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;
+
+    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;
+  } catch (error) {
+    throw new Error(`Failed to demote requirement from verified: ${error.message}`);
+  }
+}
+
+/**
+ * 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
+ */
+async function promoteTodoToVerify(reqPath, requirementTitle) {
+  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;
+    }
+
+    // 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, '');
+    }
+
+    await fs.writeFile(reqPath, updatedLines.join('\n'));
+    return true;
+  } catch (error) {
+    throw new Error(`Failed to promote requirement from TODO to TO VERIFY: ${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
+ */
+async function demoteVerifyToTodo(reqPath, requirementTitle, explanation = '') {
+  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)
+          });
+        }
+      }
+    }
+
+    if (requirementsToRemove.length === 0) {
+      return false;
+    }
+
+    // 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);
+    }
+
+    // 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);
+    }
+
+    // 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;
+      }
+    }
+
+    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;
+    }
+
+    // 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}`);
+  }
+}
+
+module.exports = {
+  promoteToVerified,
+  demoteFromVerifiedToTodo,
+  promoteTodoToVerify,
+  demoteVerifyToTodo
+};