gbu-accessibility-package 3.12.1 → 3.13.0

package/cli.js

@@ -1,28 +1,20 @@
 #!/usr/bin/env node
 
-/**
- * Accessibility Fixer CLI
- * Command line interface for the accessibility fixer tool
- */
-
-const AccessibilityFixer = require('./lib/fixer.js');
+const { AccessibilityChecker } = require('./index.js');
 const chalk = require('chalk');
-const path = require('path');
 
-// Parse command line arguments
 const args = process.argv.slice(2);
 const options = {
   directory: '.',
   language: 'ja',
-  backupFiles: false, // Default to false for faster processing
-  dryRun: false,
   help: false,
   version: false,
-  cleanupOnly: false,
-  comprehensive: false, // Keep for backward compatibility
+  dryRun: false,
+  comprehensive: false,
   altOnly: false,
   langOnly: false,
   roleOnly: false,
+  ariaLabelOnly: false,
   formsOnly: false,
   nestedOnly: false,
   buttonsOnly: false,
@@ -30,27 +22,42 @@ const options = {
   landmarksOnly: false,
   headingsOnly: false,
   dlOnly: false,
+  linksCheckOnly: false,
   brokenLinksOnly: false,
+  missingResourcesOnly: false,
+  gtmCheckOnly: false,
+  checkMetaOnly: false,
+  fullReport: false,
   unusedFilesOnly: false,
   unusedFilesListOnly: false,
-  deleteUnusedFilesFromList: false,
   deadCodeOnly: false,
   fileSizeOnly: false,
   listFile: 'unused-files-list.txt',
-  // Enhanced alt options
+  reportOutput: null,
   enhancedAlt: false,
-  altCreativity: 'balanced', // conservative, balanced, creative
+  altCreativity: 'balanced',
   includeEmotions: false,
-  strictAltChecking: false,
-  // Advanced features options
-  autoFixHeadings: false,
-  fixDescriptionLists: true
+  strictAltChecking: false
+};
+
+const removedFlags = {
+  '--backup': 'Source file backups were removed because the package no longer edits files.',
+  '--no-backup': 'Backups are no longer needed because the package is check/report-only.',
+  '--cleanup-only': 'Cleanup mode was removed because it modified source files.',
+  '--fix-meta': 'Meta auto-fix was removed. Use --check-meta to review issues.',
+  '--meta-fix': 'Meta auto-fix was removed. Use --check-meta to review issues.',
+  '--delete-unused-files': 'File deletion was removed. Use --unused-files-list to export a review list instead.',
+  '--auto-fix-headings': 'Heading auto-fix was removed. Use --headings-only to review issues instead.'
 };
 
-// Parse arguments
-for (let i = 0; i < args.length; i++) {
+for (let i = 0; i < args.length; i += 1) {
   const arg = args[i];
-  
+
+  if (removedFlags[arg]) {
+    console.error(chalk.red(`❌ ${removedFlags[arg]}`));
+    process.exit(1);
+  }
+
   switch (arg) {
     case '--help':
     case '-h':
@@ -62,27 +69,20 @@ for (let i = 0; i < args.length; i++) {
       break;
     case '--directory':
     case '-d':
-      options.directory = args[++i];
+      options.directory = args[i + 1];
+      i += 1;
       break;
     case '--language':
     case '-l':
-      options.language = args[++i];
-      break;
-    case '--backup':
-      options.backupFiles = true;
-      break;
-    case '--no-backup':
-      options.backupFiles = false;
+      options.language = args[i + 1];
+      i += 1;
       break;
     case '--dry-run':
       options.dryRun = true;
       break;
-    case '--cleanup-only':
-      options.cleanupOnly = true;
-      break;
     case '--comprehensive':
     case '--all':
-      options.comprehensive = true; // Keep for backward compatibility
+      options.comprehensive = true;
       break;
     case '--alt-only':
       options.altOnly = true;
@@ -136,10 +136,6 @@ for (let i = 0; i < args.length; i++) {
     case '--meta-check':
       options.checkMetaOnly = true;
       break;
-    case '--fix-meta':
-    case '--meta-fix':
-      options.fixMetaOnly = true;
-      break;
     case '--full-report':
     case '--report':
     case '--excel-report':
@@ -147,7 +143,8 @@ for (let i = 0; i < args.length; i++) {
       break;
     case '-o':
     case '--output':
-      options.reportOutput = args[++i];
+      options.reportOutput = args[i + 1];
+      i += 1;
       break;
     case '--unused-files':
       options.unusedFilesOnly = true;
@@ -155,11 +152,9 @@ for (let i = 0; i < args.length; i++) {
     case '--unused-files-list':
       options.unusedFilesListOnly = true;
       break;
-    case '--delete-unused-files':
-      options.deleteUnusedFilesFromList = true;
-      break;
     case '--list-file':
-      options.listFile = args[++i];
+      options.listFile = args[i + 1];
+      i += 1;
       break;
     case '--dead-code':
       options.deadCodeOnly = true;
@@ -168,17 +163,12 @@ for (let i = 0; i < args.length; i++) {
     case '--size-check':
       options.fileSizeOnly = true;
       break;
-    case '--auto-fix-headings':
-      options.autoFixHeadings = true;
-      break;
-    case '--no-fix-dl':
-      options.fixDescriptionLists = false;
-      break;
     case '--enhanced-alt':
       options.enhancedAlt = true;
       break;
     case '--alt-creativity':
-      options.altCreativity = args[++i];
+      options.altCreativity = args[i + 1];
+      i += 1;
       break;
     case '--include-emotions':
       options.includeEmotions = true;
@@ -189,555 +179,276 @@ for (let i = 0; i < args.length; i++) {
     default:
       if (!arg.startsWith('-')) {
         options.directory = arg;
+      } else {
+        console.error(chalk.red(`❌ Unknown option: ${arg}`));
+        process.exit(1);
       }
   }
 }
 
-// Show help
+function showHelp() {
+  console.log(chalk.blue(`
+GBU Accessibility Checker
+
+Usage: gbu-a11y [options] [directory]
+
+This package now runs in check/report-only mode.
+Source files are never modified.
+
+Core options:
+  -d, --directory <path>      Target directory (default: current directory)
+  -l, --language <lang>       Language context for checks (default: ja)
+  --dry-run                   Optional legacy flag; check-only mode is always enabled
+  -h, --help                  Show this help message
+  -v, --version               Show version number
+
+Check modes:
+  --comprehensive, --all      Run the default comprehensive check set
+  --alt-only                  Check alt text issues only
+  --lang-only                 Check HTML lang issues only
+  --role-only                 Check role attribute issues only
+  --aria-label-only           Check aria-label issues only
+  --forms-only                Check form label issues only
+  --nested-only               Check nested interactive controls only
+  --buttons-only              Check button naming issues only
+  --links-only                Check accessible link name issues only
+  --landmarks-only            Check landmark issues only
+  --headings-only             Check heading structure only
+  --dl-only                   Check description list structure only
+  --links-check               Check external links and local missing resources
+  --broken-links              Check broken external links only
+  --404-resources             Check missing local resources only
+  --gtm-check                 Check Google Tag Manager installation only
+  --check-meta                Check meta tags and OGP issues only
+  --unused-files              Check unused files only
+  --unused-files-list         Export unused files to a text report
+  --dead-code                 Check dead CSS and JavaScript only
+  --file-size                 Check file sizes only
+  --full-report               Generate the comprehensive Excel report
+  -o, --output <file>         Custom output path for --full-report
+  --list-file <file>          Custom output path/name for --unused-files-list
+
+Enhanced alt checks:
+  --enhanced-alt              Enable deeper alt text analysis
+  --alt-creativity <mode>     conservative | balanced | creative
+  --include-emotions          Include emotional/contextual alt suggestions
+  --strict-alt                Enable stricter alt quality rules
+
+Removed editing features:
+  --backup, --no-backup
+  --cleanup-only
+  --fix-meta, --meta-fix
+  --delete-unused-files
+  --auto-fix-headings
+
+Examples:
+  gbu-a11y
+  gbu-a11y --alt-only ./src
+  gbu-a11y --links-check ./public
+  gbu-a11y --unused-files-list --list-file reports/unused-files.txt
+  gbu-a11y --full-report -o reports/accessibility-report.xlsx
+`));
+}
+
+function printSummary(label, result) {
+  if (!result) {
+    return;
+  }
+
+  if (Array.isArray(result)) {
+    const issueCount = result.filter((item) => (
+      item.status === 'issue-found'
+      || item.status === 'fixed'
+      || (typeof item.issues === 'number' && item.issues > 0)
+    )).length;
+    const cleanCount = result.filter((item) => item.status === 'clean' || item.status === 'no-change').length;
+    const errorCount = result.filter((item) => item.status === 'error').length;
+
+    console.log(chalk.blue(`\n📌 ${label}`));
+    console.log(`   Files with findings: ${issueCount}`);
+    console.log(`   Clean files: ${cleanCount}`);
+    console.log(`   Errors: ${errorCount}`);
+    return;
+  }
+
+  if (result.filePath) {
+    console.log(chalk.blue(`\n📌 ${label}`));
+    console.log(`   Report: ${result.filePath}`);
+    return;
+  }
+
+  if (typeof result.unusedCount === 'number') {
+    console.log(chalk.blue(`\n📌 ${label}`));
+    console.log(`   Unused files found: ${result.unusedCount}`);
+    return;
+  }
+
+  if (typeof result.deletedCount === 'number') {
+    console.log(chalk.blue(`\n📌 ${label}`));
+    console.log(`   Files flagged from list: ${result.deletedCount}`);
+    console.log('   Note: preview only, no files were deleted.');
+    return;
+  }
+
+  if (result.brokenLinks || result.missingResources) {
+    printSummary(`${label} - Broken Links`, result.brokenLinks);
+    printSummary(`${label} - Missing Resources`, result.missingResources);
+    return;
+  }
+
+  const nestedEntries = Object.entries(result).filter(([, value]) => Array.isArray(value));
+  if (nestedEntries.length > 0) {
+    console.log(chalk.blue(`\n📌 ${label}`));
+
+    for (const [key, value] of nestedEntries) {
+      const issueCount = value.filter((item) => (
+        item.status === 'issue-found'
+        || item.status === 'fixed'
+        || (typeof item.issues === 'number' && item.issues > 0)
+      )).length;
+      const errorCount = value.filter((item) => item.status === 'error').length;
+      console.log(`   ${key}: ${issueCount} files with findings, ${errorCount} errors`);
+    }
+  }
+}
+
 if (options.version) {
   const packageJson = require('./package.json');
-  console.log(chalk.blue(`🔧 GBU Accessibility Package v${packageJson.version}`));
+  console.log(`GBU Accessibility Checker v${packageJson.version}`);
   process.exit(0);
 }
 
 if (options.help) {
-  console.log(chalk.blue(`
-🔧 Accessibility Fixer CLI
-
-Usage: node cli.js [options] [directory]
-
-Options:
-  -d, --directory <path>    Target directory (default: current directory)
-  -l, --language <lang>     Language for lang attribute (default: ja)
-  --backup                 Create backup files
-  --no-backup              Don't create backup files (default)
-  --dry-run                Preview changes without applying
-  --comprehensive, --all   Run comprehensive fixes (same as default)
-  --cleanup-only           Only cleanup duplicate role attributes
-  --alt-only               Fix alt attributes + cleanup
-  --lang-only              Fix HTML lang attributes + cleanup
-  --role-only              Fix role attributes + cleanup
-  --aria-label-only        Fix aria-label attributes + cleanup
-  --forms-only             Fix form labels + cleanup
-  --buttons-only           Fix button names + cleanup
-  --links-only             Fix link names + cleanup
-  --landmarks-only         Fix landmarks + cleanup
-  --headings-only          Analyze heading structure (no auto-fix)
-  --links-check            Check for broken links and 404 resources (no auto-fix)
-  --broken-links           Check for broken external links only (no auto-fix)
-  --404-resources          Check for missing local resources only (no auto-fix)
-  --gtm-check              Check Google Tag Manager installation (no auto-fix)
-  --check-meta             Check meta tags and Open Graph Protocol (no auto-fix)
-  --fix-meta               Auto-fix missing meta tags and OGP tags
-  --full-report            Generate comprehensive Excel report (all checks)
-  -o, --output <file>      Output path for Excel report (use with --full-report)
-  --unused-files           Check for unused files in project (no auto-fix)
-  --unused-files-list      Create unused-files-list.txt from detected unused files
-  --delete-unused-files    Delete all files listed in unused-files-list.txt
-  --list-file <file>       Custom list file name/path inside target directory
-  --dead-code              Check for dead code in CSS and JavaScript (no auto-fix)
-  --file-size, --size-check Check file sizes and suggest optimizations (no auto-fix)
-  --enhanced-alt           Use enhanced alt attribute analysis and generation
-  --alt-creativity <mode>  Alt text creativity: conservative, balanced, creative (default: balanced)
-  --include-emotions       Include emotional descriptors in alt text
-  --strict-alt             Enable strict alt attribute quality checking
-  -h, --help               Show this help message
-  -v, --version            Show version number
-
-Enhanced Alt Features:
-  --enhanced-alt           Comprehensive alt attribute analysis with:
-                          • Image type classification (decorative, functional, complex, etc.)
-                          • Content quality checking (length, redundancy, generic text)
-                          • Context-aware alt text generation
-                          • Multi-language vocabulary support
-                          • Brand and emotional context integration
-                          • Technical image description (charts, graphs)
-
-Alt Creativity Modes:
-  conservative            Simple, factual descriptions
-  balanced               Context-aware with moderate creativity (default)
-  creative               Rich descriptions with emotions and brand context
-
-Examples:
-  node cli.js                          # Comprehensive fixes (no backup by default)
-  node cli.js --comprehensive          # Comprehensive fixes (same as default)
-  node cli.js --alt-only               # Fix alt attributes + cleanup
-  node cli.js --forms-only             # Fix form labels + cleanup
-  node cli.js --buttons-only           # Fix button names + cleanup
-  node cli.js --links-only             # Fix link names + cleanup
-  node cli.js --landmarks-only         # Fix landmarks + cleanup
-  node cli.js --headings-only          # Analyze heading structure only
-  node cli.js --links-check            # Check for broken links and 404s
-  node cli.js --broken-links           # Check for broken external links only
-  node cli.js --404-resources          # Check for missing local resources only
-  node cli.js --gtm-check              # Check Google Tag Manager installation
-  node cli.js --check-meta             # Check meta tags and Open Graph Protocol
-  node cli.js --fix-meta               # Auto-fix missing meta tags and OGP
-  node cli.js --fix-meta --dry-run     # Preview meta tag fixes
-  node cli.js --full-report            # Generate comprehensive Excel report
-  node cli.js --full-report ./project -o report.xlsx  # Custom output path
-  node cli.js --unused-files           # Check for unused files in project
-  node cli.js --unused-files-list      # Create ./unused-files-list.txt
-  node cli.js --delete-unused-files    # Delete files listed in ./unused-files-list.txt
-  node cli.js --delete-unused-files --dry-run  # Preview files that would be deleted
-  node cli.js --dead-code              # Check for dead CSS and JavaScript code
-  node cli.js --file-size              # Check file sizes and suggest optimizations
-  node cli.js --cleanup-only           # Only cleanup duplicate roles
-  node cli.js ./src                    # Fix src directory (comprehensive)
-  node cli.js -l en --dry-run ./dist   # Preview comprehensive fixes in English
-  node cli.js --backup ./public       # Comprehensive fixes with backups
-  node cli.js --enhanced-alt           # Use enhanced alt attribute analysis
-  node cli.js --enhanced-alt --alt-creativity creative  # Creative alt text generation
-  node cli.js --enhanced-alt --include-emotions         # Include emotional context
-  node cli.js --strict-alt --enhanced-alt              # Strict quality checking
-
-Features:
-  ✅ Alt attributes for images
-  ✅ Lang attributes for HTML
-  ✅ Role attributes for accessibility
-  ✅ Context-aware text generation
-  ✅ Automatic backups
-`));
+  showHelp();
   process.exit(0);
 }
 
+const selectedModes = [
+  'comprehensive',
+  'altOnly',
+  'langOnly',
+  'roleOnly',
+  'ariaLabelOnly',
+  'formsOnly',
+  'nestedOnly',
+  'buttonsOnly',
+  'linksOnly',
+  'landmarksOnly',
+  'headingsOnly',
+  'dlOnly',
+  'linksCheckOnly',
+  'brokenLinksOnly',
+  'missingResourcesOnly',
+  'gtmCheckOnly',
+  'checkMetaOnly',
+  'fullReport',
+  'unusedFilesOnly',
+  'unusedFilesListOnly',
+  'deadCodeOnly',
+  'fileSizeOnly'
+].filter((key) => options[key]);
+
+if (selectedModes.length > 1) {
+  console.error(chalk.red('❌ Please select only one check mode at a time.'));
+  process.exit(1);
+}
+
+const checker = new AccessibilityChecker({
+  language: options.language,
+  enhancedAltMode: options.enhancedAlt,
+  altCreativity: options.altCreativity,
+  includeEmotions: options.includeEmotions,
+  strictAltChecking: options.strictAltChecking
+});
+
+async function run() {
+  console.log(chalk.blue('🔍 GBU Accessibility Checker'));
+  console.log(chalk.gray(`Target: ${options.directory}`));
+  console.log(chalk.gray('Mode: check/report only (source files remain unchanged)'));
 
-// Helper function to show completion message with backup info
-function showCompletionMessage(options, mode = 'sửa lỗi') {
   if (options.dryRun) {
-    console.log(chalk.cyan('\n💡 Đây là chế độ xem trước. Sử dụng không có --dry-run để áp dụng thay đổi.'));
-  } else {
-    console.log(chalk.green(`\n🎉 ${mode} hoàn tất thành công!`));
-    if (options.backupFiles) {
-      console.log(chalk.gray('   📁 Đã tạo file backup với đuôi .backup'));
-      console.log(chalk.gray('   💡 Sử dụng --no-backup để tắt backup trong các lần chạy sau'));
-    } else {
-      console.log(chalk.blue('   ⚡ Không tạo file backup (mặc định để xử lý nhanh hơn)'));
-      console.log(chalk.gray('   💡 Sử dụng --backup để bật tính năng backup để an toàn'));
-    }
+    console.log(chalk.gray('Note: --dry-run is now redundant because check-only mode is always enabled.'));
   }
-}
 
-// Main function
-async function main() {
-  console.log(chalk.blue('🚀 Đang khởi động Accessibility Fixer...'));
-  console.log(chalk.gray(`Thư mục: ${path.resolve(options.directory)}`));
-  console.log(chalk.gray(`Ngôn ngữ: ${options.language}`));
-  console.log(chalk.gray(`Backup: ${options.backupFiles ? 'Có' : 'Không'}`));
-  console.log(chalk.gray(`Chế độ: ${options.dryRun ? 'Xem trước (Preview)' : 'Áp dụng thay đổi'}`));
   console.log('');
 
-  const fixer = new AccessibilityFixer({
-    language: options.language,
-    backupFiles: options.backupFiles,
-    dryRun: options.dryRun,
-    enhancedAltMode: options.enhancedAlt,
-    altCreativity: options.altCreativity,
-    includeEmotions: options.includeEmotions,
-    strictAltChecking: options.strictAltChecking,
-    autoFixHeadings: options.autoFixHeadings,
-    fixDescriptionLists: options.fixDescriptionLists
-  });
-
-  try {
-    // Handle Full Report mode first
-    if (options.fullReport) {
-      console.log(chalk.blue('📊 Đang tạo báo cáo toàn diện...'));
-      await fixer.generateFullReport(options.directory, options.reportOutput);
-      return;
-    }
-    
-    // Handle different modes - All modes now include cleanup
-    if (options.cleanupOnly || options.altOnly || options.langOnly || options.roleOnly || options.ariaLabelOnly ||
-        options.formsOnly || options.nestedOnly || options.buttonsOnly || options.linksOnly || options.landmarksOnly || 
-        options.headingsOnly || options.dlOnly || options.linksCheckOnly || options.brokenLinksOnly || options.missingResourcesOnly || options.gtmCheckOnly || options.checkMetaOnly || options.fixMetaOnly || options.unusedFilesOnly || options.unusedFilesListOnly || options.deleteUnusedFilesFromList || options.deadCodeOnly || options.fileSizeOnly) {
-      // Individual modes - handle each separately, then run cleanup
-    } else {
-      // Default mode: Run comprehensive fix (all fixes including cleanup)
-      console.log(chalk.blue('🎯 Đang chạy sửa lỗi accessibility toàn diện...'));
-      const results = await fixer.fixAllAccessibilityIssues(options.directory);
-      
-      // Results already logged in the method
-      return;
-    }
-    
-    // Individual modes
-    if (options.cleanupOnly) {
-      // Only cleanup duplicate roles
-      console.log(chalk.blue('🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      
-      console.log(chalk.green(`\n✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Dọn dẹp');
-      return;
-      
-    } else if (options.cleanupOnly) {
-      // Only cleanup duplicate roles
-      console.log(chalk.blue('🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      
-      console.log(chalk.green(`\n✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Dọn dẹp');
-      return;
-      
-    } else if (options.altOnly) {
-      // Fix alt attributes + cleanup
-      console.log(chalk.blue('🖼️ Đang sửa thuộc tính alt + dọn dẹp...'));
-      const altResults = await fixer.fixEmptyAltAttributes(options.directory);
-      const altFixed = altResults.filter(r => r.status === 'fixed').length;
-      const totalAltIssues = altResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa thuộc tính alt trong ${altFixed} file (${totalAltIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa thuộc tính alt + dọn dẹp');
-      return;
-      
-    } else if (options.langOnly) {
-      // Fix lang attributes + cleanup
-      console.log(chalk.blue('📝 Đang sửa thuộc tính HTML lang + dọn dẹp...'));
-      const langResults = await fixer.fixHtmlLang(options.directory);
-      const langFixed = langResults.filter(r => r.status === 'fixed').length;
-      
-      console.log(chalk.green(`\n✅ Đã sửa thuộc tính lang trong ${langFixed} file`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa thuộc tính lang + dọn dẹp');
-      return;
-      
-    } else if (options.roleOnly) {
-      // Fix role attributes + cleanup
-      console.log(chalk.blue('🎭 Đang sửa thuộc tính role + dọn dẹp...'));
-      const roleResults = await fixer.fixRoleAttributes(options.directory);
-      const roleFixed = roleResults.filter(r => r.status === 'fixed').length;
-      const totalRoleIssues = roleResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa thuộc tính role trong ${roleFixed} file (${totalRoleIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa thuộc tính role + dọn dẹp');
-      return;
-      
-    } else if (options.ariaLabelOnly) {
-      // Fix aria-label attributes + cleanup
-      console.log(chalk.blue('🏷️ Đang sửa thuộc tính aria-label + dọn dẹp...'));
-      const ariaResults = await fixer.fixAriaLabels(options.directory);
-      const ariaFixed = ariaResults.filter(r => r.status === 'processed' && r.changes > 0).length;
-      const totalAriaIssues = ariaResults.reduce((sum, r) => sum + (r.changes || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa thuộc tính aria-label trong ${ariaFixed} file (${totalAriaIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa thuộc tính aria-label + dọn dẹp');
-      return;
-      
-    } else if (options.formsOnly) {
-      // Fix form labels + cleanup
-      console.log(chalk.blue('📋 Đang sửa nhãn form + dọn dẹp...'));
-      const formResults = await fixer.fixFormLabels(options.directory);
-      const formFixed = formResults.filter(r => r.status === 'fixed').length;
-      const totalFormIssues = formResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa nhãn form trong ${formFixed} file (${totalFormIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa nhãn form + dọn dẹp');
-      return;
-      
-    } else if (options.nestedOnly) {
-      // Fix nested interactive controls + cleanup
-      console.log(chalk.blue('🎯 Đang sửa các control tương tác lồng nhau + dọn dẹp...'));
-      const nestedResults = await fixer.fixNestedInteractiveControls(options.directory);
-      const nestedFixed = nestedResults.filter(r => r.status === 'fixed').length;
-      const totalNestedIssues = nestedResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa các control tương tác lồng nhau trong ${nestedFixed} file (${totalNestedIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa các control tương tác lồng nhau + dọn dẹp');
-      return;
-      
-    } else if (options.buttonsOnly) {
-      // Fix button names + cleanup
-      console.log(chalk.blue('🔘 Đang sửa tên button + dọn dẹp...'));
-      const buttonResults = await fixer.fixButtonNames(options.directory);
-      const buttonFixed = buttonResults.filter(r => r.status === 'fixed').length;
-      const totalButtonIssues = buttonResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa tên button trong ${buttonFixed} file (${totalButtonIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa tên button + dọn dẹp');
-      return;
-      
-    } else if (options.linksOnly) {
-      // Fix link names + cleanup
-      console.log(chalk.blue('🔗 Đang sửa tên link + dọn dẹp...'));
-      const linkResults = await fixer.fixLinkNames(options.directory);
-      const linkFixed = linkResults.filter(r => r.status === 'fixed').length;
-      const totalLinkIssues = linkResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa tên link trong ${linkFixed} file (${totalLinkIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa tên link + dọn dẹp');
-      return;
-      
-    } else if (options.landmarksOnly) {
-      // Fix landmarks + cleanup
-      console.log(chalk.blue('🏛️ Đang sửa landmark + dọn dẹp...'));
-      const landmarkResults = await fixer.fixLandmarks(options.directory);
-      const landmarkFixed = landmarkResults.filter(r => r.status === 'fixed').length;
-      const totalLandmarkIssues = landmarkResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa landmark trong ${landmarkFixed} file (${totalLandmarkIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa landmark + dọn dẹp');
-      return;
-      
-    } else if (options.headingsOnly) {
-      // Fix heading structure + cleanup
-      console.log(chalk.blue('📑 Đang sửa cấu trúc heading + dọn dẹp...'));
-      const headingResults = await fixer.fixHeadingStructure(options.directory);
-      const headingFixed = headingResults.filter(r => r.status === 'fixed').length;
-      const totalHeadingIssues = headingResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      const totalHeadingFixes = headingResults.reduce((sum, r) => sum + (r.fixes || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã xử lý heading trong ${headingResults.length} file (${totalHeadingIssues} vấn đề tìm thấy)`));
-      if (options.autoFixHeadings) {
-        console.log(chalk.green(`✅ Đã sửa ${totalHeadingFixes} vấn đề heading tự động`));
-      } else {
-        console.log(chalk.gray('💡 Sử dụng --auto-fix-headings để bật tính năng tự động sửa heading'));
-      }
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa cấu trúc heading + dọn dẹp');
-      return;
-      
-    } else if (options.dlOnly) {
-      // Fix description lists + cleanup
-      console.log(chalk.blue('📋 Đang sửa danh sách mô tả + dọn dẹp...'));
-      const dlResults = await fixer.fixDescriptionLists(options.directory);
-      const dlFixed = dlResults.filter(r => r.status === 'fixed').length;
-      const totalDlIssues = dlResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã sửa danh sách mô tả trong ${dlFixed} file (${totalDlIssues} vấn đề)`));
-      
-      // Run cleanup
-      console.log(chalk.blue('\n🧹 Đang dọn dẹp các thuộc tính role trùng lặp...'));
-      const cleanupResults = await fixer.cleanupDuplicateRoles(options.directory);
-      const cleanupFixed = cleanupResults.filter(r => r.status === 'fixed').length;
-      console.log(chalk.green(`✅ Đã dọn dẹp role trùng lặp trong ${cleanupFixed} file`));
-      
-      showCompletionMessage(options, 'Sửa danh sách mô tả + dọn dẹp');
-      return;
-      
-    } else if (options.linksCheckOnly) {
-      // Check broken links and 404 resources (backward compatibility)
-      console.log(chalk.blue('🔗 Đang kiểm tra link và tài nguyên toàn diện...'));
-      const linkResults = await fixer.checkBrokenLinks(options.directory);
-      const resourceResults = await fixer.check404Resources(options.directory);
-      const totalLinkIssues = linkResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      const totalResourceIssues = resourceResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã kiểm tra link trong ${linkResults.length} file (${totalLinkIssues} vấn đề link)`));
-      console.log(chalk.green(`✅ Đã kiểm tra tài nguyên trong ${resourceResults.length} file (${totalResourceIssues} vấn đề tài nguyên)`));
-      console.log(chalk.gray('💡 Vấn đề về link và tài nguyên cần xem xét thủ công và không thể tự động sửa'));
-      
-      showCompletionMessage(options, 'Kiểm tra link và tài nguyên');
-      return;
-      
-    } else if (options.brokenLinksOnly) {
-      // Check broken external links only 
-      console.log(chalk.blue('🔗 Đang kiểm tra link bên ngoài bị lỗi...'));
-      const linkResults = await fixer.checkBrokenLinks(options.directory);
-      const totalBrokenLinks = linkResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã kiểm tra link bên ngoài trong ${linkResults.length} file (${totalBrokenLinks} vấn đề)`));
-      console.log(chalk.gray('💡 Vấn đề link bị lỗi cần xem xét thủ công và không thể tự động sửa'));
-      
-      showCompletionMessage(options, 'Kiểm tra link bị lỗi');
-      return;
-      
-    } else if (options.missingResourcesOnly) {
-      // Check 404 resources only (missing local files)
-      console.log(chalk.blue('📁 Đang kiểm tra tài nguyên thiếu...'));
-      const resourceResults = await fixer.check404Resources(options.directory);
-      const totalMissingResources = resourceResults.reduce((sum, r) => sum + (r.issues || 0), 0);
-      
-      console.log(chalk.green(`\n✅ Đã kiểm tra tài nguyên cục bộ trong ${resourceResults.length} file (${totalMissingResources} vấn đề)`));
-      console.log(chalk.gray('💡 Vấn đề tài nguyên thiếu cần xem xét thủ công và không thể tự động sửa'));
-      
-      showCompletionMessage(options, 'Kiểm tra tài nguyên thiếu');
-      return;
-      
-    } else if (options.gtmCheckOnly) {
-      // Check Google Tag Manager installation only (no fixes)
-      console.log(chalk.blue('🏷️ Đang kiểm tra Google Tag Manager...'));
-      const gtmResults = await fixer.checkGoogleTagManager(options.directory);
-      const filesWithGTM = gtmResults.filter(r => r.gtmAnalysis?.hasGTM).length;
-      const filesWithIssues = gtmResults.filter(r => r.gtmAnalysis?.issues?.length > 0).length;
-      
-      console.log(chalk.green(`\n✅ Phân tích hoàn tất: Tìm thấy ${filesWithGTM} file có GTM`));
-      if (filesWithIssues > 0) {
-        console.log(chalk.yellow(`⚠️ ${filesWithIssues} file có vấn đề về cài đặt GTM`));
-      }
-      console.log(chalk.gray('💡 GTM cần có cả <script> trong <head> và <noscript> sau <body>'));
-      
-      showCompletionMessage(options, 'Kiểm tra GTM');
-      return;
-      
-    } else if (options.checkMetaOnly) {
-      // Check meta tags only (no fixes)
-      console.log(chalk.blue('🏷️ Đang kiểm tra meta tags và Open Graph Protocol...'));
-      await fixer.checkMetaTags(options.directory);
-      
-      showCompletionMessage(options, 'Kiểm tra meta tags');
-      return;
-      
-    } else if (options.fixMetaOnly) {
-      // Fix meta tags
-      console.log(chalk.blue('🔧 Đang tự động sửa meta tags...')); 
-      await fixer.fixMetaTags(options.directory, { dryRun: options.dryRun, backup: options.backupFiles });
-      
-      showCompletionMessage(options, 'Sửa meta tags');
-      return;
-      
-    } else if (options.unusedFilesOnly) {
-      // Check unused files only (no fixes, no cleanup)
-      console.log(chalk.blue('🗂️ Đang kiểm tra file không sử dụng...'));
-      const unusedResults = await fixer.checkUnusedFiles(options.directory);
-      const totalUnusedFiles = unusedResults.unusedCount;
-      
-      if (totalUnusedFiles === 0) {
-        console.log(chalk.green(`\n✅ Không tìm thấy file không sử dụng! Tất cả ${unusedResults.totalFiles} file đều được tham chiếu đúng cách.`));
-      } else {
-        console.log(chalk.green(`\n✅ Phân tích hoàn tất: Tìm thấy ${totalUnusedFiles} file không sử dụng trong tổng số ${unusedResults.totalFiles} file`));
-        console.log(chalk.gray(`📊 ${unusedResults.referencedFiles} file được tham chiếu, ${totalUnusedFiles} file có thể không sử dụng`));
-      }
-      console.log(chalk.gray('💡 Phát hiện file không sử dụng dựa trên heuristic - khuyến nghị xem xét thủ công'));
-      
-      showCompletionMessage(options, 'Kiểm tra file không sử dụng');
-      return;
-
-    } else if (options.unusedFilesListOnly) {
-      console.log(chalk.blue('📝 Đang tạo danh sách file không sử dụng...'));
-      const listResults = await fixer.generateUnusedFilesList(options.directory, options.listFile);
-
-      console.log(chalk.green(`\n✅ Đã tạo file list: ${listResults.outputPath}`));
-      console.log(chalk.gray(`📊 ${listResults.unusedCount} path đã được ghi vào list`));
-      console.log(chalk.gray('💡 Danh sách dùng path tương đối so với thư mục target và có thể dùng lại với --delete-unused-files'));
-      return;
-
-    } else if (options.deleteUnusedFilesFromList) {
-      console.log(chalk.blue('🗑️ Đang xóa file theo danh sách unused files...'));
-      const deleteResults = await fixer.deleteUnusedFilesFromList(options.directory, options.listFile, {
-        dryRun: options.dryRun
-      });
-
-      console.log(chalk.green(`\n✅ ${options.dryRun ? 'Đã mô phỏng xóa' : 'Đã xử lý xóa'} ${deleteResults.deletedCount} file từ list`));
-      console.log(chalk.gray(`📄 File list: ${deleteResults.listPath}`));
-
-      if (deleteResults.missingCount > 0) {
-        console.log(chalk.yellow(`⚠️ ${deleteResults.missingCount} file trong list không còn tồn tại`));
-      }
+  let result;
+  let label;
 
-      if (deleteResults.skippedCount > 0) {
-        console.log(chalk.yellow(`⚠️ ${deleteResults.skippedCount} entry bị bỏ qua vì không an toàn hoặc không hợp lệ`));
-      }
+  if (options.altOnly) {
+    label = 'Alt Text Check';
+    result = await checker.checkAltText(options.directory);
+  } else if (options.langOnly) {
+    label = 'Lang Check';
+    result = await checker.checkLang(options.directory);
+  } else if (options.roleOnly) {
+    label = 'Role Check';
+    result = await checker.checkRoles(options.directory);
+  } else if (options.ariaLabelOnly) {
+    label = 'Aria Label Check';
+    result = await checker.checkAriaLabels(options.directory);
+  } else if (options.formsOnly) {
+    label = 'Form Label Check';
+    result = await checker.checkForms(options.directory);
+  } else if (options.nestedOnly) {
+    label = 'Nested Control Check';
+    result = await checker.checkNestedControls(options.directory);
+  } else if (options.buttonsOnly) {
+    label = 'Button Check';
+    result = await checker.checkButtons(options.directory);
+  } else if (options.linksOnly) {
+    label = 'Accessible Link Name Check';
+    result = await checker.checkLinks(options.directory);
+  } else if (options.landmarksOnly) {
+    label = 'Landmark Check';
+    result = await checker.checkLandmarks(options.directory);
+  } else if (options.headingsOnly) {
+    label = 'Heading Check';
+    result = await checker.checkHeadings(options.directory);
+  } else if (options.dlOnly) {
+    label = 'Description List Check';
+    result = await checker.checkDescriptionLists(options.directory);
+  } else if (options.linksCheckOnly) {
+    label = 'Link and Resource Check';
+    result = await checker.checkLinksAndResources(options.directory);
+  } else if (options.brokenLinksOnly) {
+    label = 'Broken External Link Check';
+    result = await checker.checkBrokenLinks(options.directory);
+  } else if (options.missingResourcesOnly) {
+    label = 'Missing Resource Check';
+    result = await checker.check404Resources(options.directory);
+  } else if (options.gtmCheckOnly) {
+    label = 'GTM Check';
+    result = await checker.checkGoogleTagManager(options.directory);
+  } else if (options.checkMetaOnly) {
+    label = 'Meta Tag Check';
+    result = await checker.checkMetaTags(options.directory);
+  } else if (options.fullReport) {
+    label = 'Full Report';
+    result = await checker.generateFullReport(options.directory, options.reportOutput);
+  } else if (options.unusedFilesOnly) {
+    label = 'Unused File Check';
+    result = await checker.checkUnusedFiles(options.directory);
+  } else if (options.unusedFilesListOnly) {
+    label = 'Unused File List Export';
+    result = await checker.generateUnusedFilesList(options.directory, options.listFile);
+  } else if (options.deadCodeOnly) {
+    label = 'Dead Code Check';
+    result = await checker.checkDeadCode(options.directory);
+  } else if (options.fileSizeOnly) {
+    label = 'File Size Check';
+    result = await checker.checkFileSizes(options.directory);
+  } else {
+    label = 'Comprehensive Check';
+    result = await checker.runComprehensiveChecks(options.directory);
+  }
 
-      if (options.dryRun) {
-        console.log(chalk.cyan('\n💡 Đây là chế độ xem trước. Chạy lại không kèm --dry-run để xóa thật.'));
-      } else {
-        console.log(chalk.gray('💡 File list được giữ nguyên để bạn có thể đối chiếu sau khi xóa'));
-      }
-      return;
-      
-    } else if (options.deadCodeOnly) {
-      // Check dead code only (no fixes, no cleanup)
-      console.log(chalk.blue('☠️ Đang kiểm tra mã không sử dụng...'));
-      const deadCodeResults = await fixer.checkDeadCode(options.directory);
-      const totalDeadCode = deadCodeResults.length;
-      
-      console.log(chalk.green(`\n✅ Đã kiểm tra mã không sử dụng (${totalDeadCode} vấn đề tiềm ẩn)`));
-      console.log(chalk.gray('💡 Phân tích mã không sử dụng dựa trên heuristic - khuyến nghị xem xét thủ công'));
-      
-      showCompletionMessage(options, 'Kiểm tra mã không sử dụng');
-      return;
-      
-    } else if (options.fileSizeOnly) {
-      // Check file sizes only (no fixes, no cleanup)
-      console.log(chalk.blue('📏 Đang phân tích kích thước file...'));
-      const sizeResults = await fixer.checkFileSizes(options.directory);
-      const totalLargeFiles = sizeResults.largeFiles.length;
-      
-      console.log(chalk.green(`\n✅ Đã phân tích ${sizeResults.totalFiles} file (${totalLargeFiles} file có kích thước lớn)`));
-      console.log(chalk.gray('💡 Phân tích kích thước file dựa trên best practices phổ biến'));
-      
-      showCompletionMessage(options, 'Phân tích kích thước file');
-      return;
-    }
+  printSummary(label, result);
 
-  } catch (error) {
-    console.error(chalk.red('❌ Đã xảy ra lỗi:'), error.message);
-    process.exit(1);
-  }
+  console.log(chalk.green('\n✅ Check completed.'));
 }
 
-// Run the CLI
-main();
+run().catch((error) => {
+  console.error(chalk.red(`\n❌ ${error.message}`));
+  process.exit(1);
+});