vibecodingmachine-core 2026.2.20-438 → 2026.2.26-1739

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

@@ -0,0 +1,367 @@
+/**
+ * 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
+ */
+
+// 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');
+
+// 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;
+
+/**
+ * Get comprehensive requirement system information
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} System information
+ */
+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()
+    };
+  }
+}
+
+/**
+ * Initialize requirements system
+ * @param {string} repoPath - Repository path
+ * @returns {Promise<Object>} Initialization result
+ */
+async function initializeRequirementsSystem(repoPath) {
+  try {
+    const result = {
+      success: false,
+      actions: [],
+      warnings: [],
+      errors: []
+    };
+
+    // 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');
+    }
+
+    // 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);
+    }
+
+    // Create backup
+    const backupPath = await backupRequirementsFile(repoPath);
+    if (backupPath) {
+      result.actions.push(`✅ Backup created: ${backupPath}`);
+    }
+
+    // Clean up old backups
+    const cleanedCount = await cleanupBackupFiles(repoPath);
+    if (cleanedCount > 0) {
+      result.actions.push(`🗑️ Cleaned up ${cleanedCount} old backup files`);
+    }
+
+    result.success = true;
+    return result;
+
+  } catch (error) {
+    return {
+      success: false,
+      actions: [],
+      warnings: [],
+      errors: [`Initialization failed: ${error.message}`]
+    };
+  }
+}
+
+/**
+ * Get requirement workflow status
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Workflow status
+ */
+async function getWorkflowStatus(repoPath = null) {
+  try {
+    const status = await getCurrentStatus(repoPath);
+    const stage = getStatusStage(status);
+    const isDone = isStatusDone(status);
+    const nextStatus = getNextStatus(status);
+    const stats = await getRequirementStatistics(getRequirementsFilePath(repoPath));
+
+    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) {
+    return {
+      error: error.message,
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+
+/**
+ * Advance requirement workflow to next status
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Result of advancement
+ */
+async function advanceWorkflow(repoPath = null) {
+  try {
+    const currentStatus = await getCurrentStatus(repoPath);
+    const nextStatus = getNextStatus(currentStatus);
+
+    if (!nextStatus) {
+      return {
+        success: false,
+        message: 'Already at DONE status or invalid current status',
+        currentStatus,
+        nextStatus: null
+      };
+    }
+
+    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) {
+    return {
+      success: false,
+      message: `Error advancing workflow: ${error.message}`,
+      error: error.message
+    };
+  }
+}
+
+/**
+ * Get requirement health check
+ * @param {string} repoPath - Repository path (optional)
+ * @returns {Promise<Object>} Health check results
+ */
+async function getHealthCheck(repoPath = null) {
+  try {
+    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
+    };
+
+    // 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;
+    }
+
+    // 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;
+    }
+
+    // Check status
+    if (!statusSummary.current) {
+      health.issues.push('No current status set');
+      health.recommendations.push('Set a current status');
+      health.score -= 10;
+    }
+
+    // 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;
+    }
+
+    // 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;
+    }
+
+    // Determine final status
+    if (health.score >= 90) {
+      health.status = 'healthy';
+    } else if (health.score >= 70) {
+      health.status = 'warning';
+    } else {
+      health.status = 'critical';
+    }
+
+    return health;
+
+  } catch (error) {
+    return {
+      status: 'error',
+      issues: [`Health check failed: ${error.message}`],
+      recommendations: ['Check file permissions and paths'],
+      score: 0,
+      error: error.message
+    };
+  }
+}
+
+// Export everything
+module.exports = {
+  // Parser utilities
+  DEFAULT_INSTRUCTION_TEXT,
+  getOrdinalSuffix,
+  addTryAgainPrefix,
+  parseRequirementLine,
+  extractRequirementTitle,
+  isRequirementMatch,
+  parseRequirementBlock,
+  findRequirementBlock,
+  findAllRequirementsInSection,
+  validateRequirementFormat,
+  formatRequirementForDisplay,
+
+  // Movement operations
+  promoteToVerified,
+  demoteFromVerifiedToTodo,
+  promoteTodoToVerify,
+  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
+};