vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

package/src/utils/requirement-movement.js

@@ -0,0 +1,312 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { logger } = require('./logger.cjs');
+const { parseRequirementLine } = require('./requirement-text-utils');
+
+/**
+ * Requirement movement and section management utilities
+ */
+
+/**
+ * Promote requirement to verified section
+ * @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 inRequirementsSection = false;
+    let inVerifiedSection = false;
+    let requirementLine = -1;
+    let verifiedInsertIndex = -1;
+    
+    // Find requirement and verified section
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      
+      // Track sections
+      if (line.includes('Requirements not yet completed')) {
+        inRequirementsSection = true;
+        inVerifiedSection = false;
+      } else if (line.includes('Verified by AI screenshot. Needs Human to Verify and move to CHANGELOG')) {
+        inRequirementsSection = false;
+        inVerifiedSection = true;
+        verifiedInsertIndex = i + 2; // After header and empty line
+      } else if (line.startsWith('# ') && !line.includes('Requirements not yet completed') && 
+                 !line.includes('Verified by AI')) {
+        inRequirementsSection = false;
+        inVerifiedSection = false;
+      }
+      
+      // Find the requirement to move
+      if (inRequirementsSection && line.includes(requirementTitle)) {
+        requirementLine = i;
+      }
+    }
+    
+    if (requirementLine === -1) {
+      logger.error(`❌ Requirement not found: ${requirementTitle}`);
+      return false;
+    }
+    
+    if (verifiedInsertIndex === -1) {
+      logger.error('❌ Verified section not found');
+      return false;
+    }
+    
+    // Move the requirement
+    const requirementText = lines[requirementLine];
+    lines.splice(requirementLine, 1); // Remove from original location
+    lines.splice(verifiedInsertIndex, 0, requirementText); // Insert in verified section
+    
+    // Write back to file
+    await fs.writeFile(reqPath, lines.join('\n'));
+    
+    logger.log(`✅ Promoted to verified: ${requirementTitle}`);
+    return true;
+  } catch (error) {
+    logger.error('❌ Error promoting to verified:', error);
+    return false;
+  }
+}
+
+/**
+ * Demote requirement from verified back to todo
+ * @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 repoPath = path.dirname(allnightDir); // Repository root
+    const changelogPath = path.join(repoPath, 'CHANGELOG.md');
+    
+    // First remove from CHANGELOG.md if present
+    if (await fs.pathExists(changelogPath)) {
+      const changelogContent = await fs.readFile(changelogPath, 'utf-8');
+      const changelogLines = changelogContent.split('\n');
+      
+      let changelogRequirementLine = -1;
+      for (let i = 0; i < changelogLines.length; i++) {
+        if (changelogLines[i].includes(requirementTitle)) {
+          changelogRequirementLine = i;
+          break;
+        }
+      }
+      
+      if (changelogRequirementLine !== -1) {
+        changelogLines.splice(changelogRequirementLine, 1);
+        await fs.writeFile(changelogPath, changelogLines.join('\n'));
+        logger.log(`✅ Removed from CHANGELOG.md: ${requirementTitle}`);
+      }
+    }
+    
+    // Now move from verified back to requirements section
+    const content = await fs.readFile(reqPath, 'utf-8');
+    const lines = content.split('\n');
+    
+    let inRequirementsSection = false;
+    let inVerifiedSection = false;
+    let requirementLine = -1;
+    let todoInsertIndex = -1;
+    
+    // Find requirement in verified section and todo section
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      
+      // Track sections
+      if (line.includes('Requirements not yet completed')) {
+        inRequirementsSection = true;
+        inVerifiedSection = false;
+        todoInsertIndex = i + 2; // After header and empty line
+      } else if (line.includes('Verified by AI screenshot. Needs Human to Verify and move to CHANGELOG')) {
+        inRequirementsSection = false;
+        inVerifiedSection = true;
+      } else if (line.startsWith('# ') && !line.includes('Requirements not yet completed') && 
+                 !line.includes('Verified by AI')) {
+        inRequirementsSection = false;
+        inVerifiedSection = false;
+      }
+      
+      // Find the requirement to move in verified section
+      if (inVerifiedSection && line.includes(requirementTitle)) {
+        requirementLine = i;
+      }
+    }
+    
+    if (requirementLine === -1) {
+      logger.error(`❌ Requirement not found in verified section: ${requirementTitle}`);
+      return false;
+    }
+    
+    if (todoInsertIndex === -1) {
+      logger.error('❌ Todo section not found');
+      return false;
+    }
+    
+    // Move the requirement
+    const requirementText = lines[requirementLine];
+    lines.splice(requirementLine, 1); // Remove from verified section
+    lines.splice(todoInsertIndex, 0, requirementText); // Insert in todo section
+    
+    // Write back to file
+    await fs.writeFile(reqPath, lines.join('\n'));
+    
+    logger.log(`✅ Demoted from verified to todo: ${requirementTitle}`);
+    return true;
+  } catch (error) {
+    logger.error('❌ Error demoting from verified to todo:', error);
+    return false;
+  }
+}
+
+/**
+ * Promote requirement from todo 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');
+    
+    let inRequirementsSection = false;
+    let inVerifySection = false;
+    let requirementLine = -1;
+    let verifyInsertIndex = -1;
+    
+    // Find requirement and verify section
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      
+      // Track sections
+      if (line.includes('Requirements not yet completed')) {
+        inRequirementsSection = true;
+        inVerifySection = false;
+      } else if (line.includes('Requirements ready for verification')) {
+        inRequirementsSection = false;
+        inVerifySection = true;
+        verifyInsertIndex = i + 2; // After header and empty line
+      } else if (line.startsWith('# ') && !line.includes('Requirements not yet completed') && 
+                 !line.includes('Requirements ready for verification')) {
+        inRequirementsSection = false;
+        inVerifySection = false;
+      }
+      
+      // Find the requirement to move
+      if (inRequirementsSection && line.includes(requirementTitle)) {
+        requirementLine = i;
+      }
+    }
+    
+    if (requirementLine === -1) {
+      logger.error(`❌ Requirement not found: ${requirementTitle}`);
+      return false;
+    }
+    
+    if (verifyInsertIndex === -1) {
+      logger.error('❌ Verify section not found');
+      return false;
+    }
+    
+    // Move the requirement
+    const requirementText = lines[requirementLine];
+    lines.splice(requirementLine, 1); // Remove from original location
+    lines.splice(verifyInsertIndex, 0, requirementText); // Insert in verify section
+    
+    // Write back to file
+    await fs.writeFile(reqPath, lines.join('\n'));
+    
+    logger.log(`✅ Promoted to verify: ${requirementTitle}`);
+    return true;
+  } catch (error) {
+    logger.error('❌ Error promoting to verify:', error);
+    return false;
+  }
+}
+
+/**
+ * Demote requirement from verify back to todo
+ * @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');
+    
+    let inRequirementsSection = false;
+    let inVerifySection = false;
+    let requirementLine = -1;
+    let todoInsertIndex = -1;
+    
+    // Find requirement in verify section and todo section
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      
+      // Track sections
+      if (line.includes('Requirements not yet completed')) {
+        inRequirementsSection = true;
+        inVerifySection = false;
+        todoInsertIndex = i + 2; // After header and empty line
+      } else if (line.includes('Requirements ready for verification')) {
+        inRequirementsSection = false;
+        inVerifySection = true;
+      } else if (line.startsWith('# ') && !line.includes('Requirements not yet completed') && 
+                 !line.includes('Requirements ready for verification')) {
+        inRequirementsSection = false;
+        inVerifySection = false;
+      }
+      
+      // Find the requirement to move in verify section
+      if (inVerifySection && line.includes(requirementTitle)) {
+        requirementLine = i;
+      }
+    }
+    
+    if (requirementLine === -1) {
+      logger.error(`❌ Requirement not found in verify section: ${requirementTitle}`);
+      return false;
+    }
+    
+    if (todoInsertIndex === -1) {
+      logger.error('❌ Todo section not found');
+      return false;
+    }
+    
+    // Move the requirement
+    let requirementText = lines[requirementLine];
+    
+    // Add explanation if provided
+    if (explanation) {
+      requirementText += ` (ISSUE: ${explanation})`;
+    }
+    
+    lines.splice(requirementLine, 1); // Remove from verify section
+    lines.splice(todoInsertIndex, 0, requirementText); // Insert in todo section
+    
+    // Write back to file
+    await fs.writeFile(reqPath, lines.join('\n'));
+    
+    logger.log(`✅ Demoted from verify to todo: ${requirementTitle}`);
+    return true;
+  } catch (error) {
+    logger.error('❌ Error demoting from verify to todo:', error);
+    return false;
+  }
+}
+
+module.exports = {
+  promoteToVerified,
+  demoteFromVerifiedToTodo,
+  promoteTodoToVerify,
+  demoteVerifyToTodo
+};

package/src/utils/requirement-parsing-helpers.js

@@ -0,0 +1,56 @@
+const { logger } = require('./logger.cjs');
+
+/**
+ * Get ordinal suffix for numbers (1st, 2nd, 3rd, 4th, etc.)
+ * @param {number} num - The number
+ * @returns {string} The ordinal suffix
+ */
+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\): (.+)$/);
+
+  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}`;
+  }
+}
+
+/**
+ * Parse requirement from markdown line
+ * @param {string} line - Markdown line (e.g., "- Requirement text")
+ * @returns {string} Requirement text without markdown prefix
+ */
+function parseRequirementLine(line) {
+  if (line.startsWith('- ')) {
+    return line.substring(2);
+  }
+  return line;
+}
+
+module.exports = {
+  getOrdinalSuffix,
+  addTryAgainPrefix,
+  parseRequirementLine
+};

package/src/utils/requirement-statistics.js

@@ -0,0 +1,200 @@
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const { getRequirementsPath } = require('./repo-helpers.cjs');
+const { logger } = require('./logger.cjs');
+const { parseRequirementLine } = require('./requirement-parsing-helpers');
+
+/**
+ * Requirement statistics and progress tracking utilities
+ */
+
+/**
+ * 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 [];
+    }
+
+    const content = await fs.readFile(changelogPath, 'utf8');
+    const lines = content.split('\n');
+    const requirements = [];
+    let inVerifiedSection = false;
+
+    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}%)`
+    };
+  } catch (error) {
+    logger.error('❌ Error getting project requirement stats:', error);
+    return null;
+  }
+}
+
+/**
+ * Get current requirement progress numbers
+ * @param {string} repoPath - Repository path
+ * @returns {Promise<Object>} Progress information
+ */
+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 };
+  }
+}
+
+module.exports = {
+  loadVerifiedFromChangelog,
+  getProjectRequirementStats,
+  getCurrentRequirementProgress
+};

package/src/utils/requirement-text-utils.js

@@ -0,0 +1,58 @@
+/**
+ * Text processing utilities for requirements
+ */
+
+/**
+ * Get ordinal suffix for numbers (1st, 2nd, 3rd, 4th, etc.)
+ * @param {number} num - The number
+ * @returns {string} The ordinal suffix
+ */
+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\): (.+)$/);
+
+  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}`;
+  }
+}
+
+/**
+ * Parse requirement from markdown line
+ * @param {string} line - Markdown line (e.g., "- Requirement text")
+ * @returns {string} Requirement text without markdown prefix
+ */
+function parseRequirementLine(line) {
+  if (line.startsWith('- ')) {
+    return line.substring(2);
+  }
+  return line;
+}
+
+module.exports = {
+  getOrdinalSuffix,
+  addTryAgainPrefix,
+  parseRequirementLine
+};