Function runTests

tests/snippet-validation.test.cjs:595–765

* Main test runner

()

 * Main test runner
 */
async function runTests() {
  log('=================================', 'info');
  log('Documentation Snippet Validation', 'info');
  log('=================================\n', 'info');

  // Load cache
  fileCache = loadCache();

  if (specificFile) {
    log(`Testing specific file: ${specificFile}\n`, 'info');
  } else if (clearCache) {
    log('Cache cleared - testing all files\n', 'info');
  } else if (testAll) {
    log('Testing all files (cache ignored)\n', 'info');
  } else {
    const cachedCount = Object.keys(fileCache).length;
    if (cachedCount > 0) {
      log(`Found cache with ${cachedCount} previously tested files\n`, 'info');
    }
  }

  log(`Searching for documentation files in: ${DOCS_BASE_DIR}`, 'info');

  let docFiles = findDocFiles();

  // Filter to specific file if requested
  if (specificFile) {
    const absolutePath = path.isAbsolute(specificFile)
      ? specificFile
      : path.join(process.cwd(), specificFile);
    docFiles = docFiles.filter(f => f === absolutePath);
    if (docFiles.length === 0) {
      log(`Error: File not found: ${specificFile}`, 'error');
      process.exit(1);
    }
  }

  log(`Found ${docFiles.length} documentation files\n`, 'info');

  // Group files by cached status
  const filesToTest = [];
  const cachedPassedFiles = [];

  for (const file of docFiles) {
    if (isFileCached(file, fileCache)) {
      cachedPassedFiles.push(file);
      cachedFiles++;
    } else {
      filesToTest.push(file);
    }
  }

  if (cachedPassedFiles.length > 0) {
    log(`Skipping ${cachedPassedFiles.length} files (already passed, unchanged)`, 'dim');
  }

  if (filesToTest.length === 0) {
    log('\n✅ All files already tested and passing!', 'success');