@soulbatical/tetra-dev-toolkit 1.20.11 → 1.20.13

package/bin/tetra-test-audit.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+/**
+ * Tetra Test Audit — Discover test coverage gaps across a Tetra project.
+ *
+ * Scans FeatureConfigs, routes, frontend pages, and test files to find:
+ *   - Features without CRUD tests
+ *   - API endpoints without auth wall tests
+ *   - Frontend pages without e2e specs
+ *   - CI pipeline gaps
+ *
+ * Usage:
+ *   tetra-test-audit                          # Audit current project
+ *   tetra-test-audit --path /path/to/project  # Audit specific project
+ *   tetra-test-audit --json                   # JSON output for CI
+ *   tetra-test-audit --ci                     # GitHub Actions annotations
+ *   tetra-test-audit --strict                 # Fail on any gap
+ *
+ * Exit codes:
+ *   0 = all critical checks pass (or no gaps in --strict mode)
+ *   1 = gaps found
+ */
+
+import { program } from 'commander'
+import chalk from 'chalk'
+import {
+  runTestCoverageAudit,
+  formatReport,
+  formatReportJSON,
+  formatCIAnnotations,
+} from '../lib/audits/test-coverage-audit.js'
+
+program
+  .name('tetra-test-audit')
+  .description('Audit test coverage gaps across a Tetra project')
+  .version('1.0.0')
+  .option('--path <dir>', 'Project root directory (default: cwd)')
+  .option('--json', 'JSON output for CI')
+  .option('--ci', 'GitHub Actions annotations for failures')
+  .option('--strict', 'Fail on any gap (default: only fail on critical gaps like missing auth tests)')
+  .action(async (options) => {
+    try {
+      const projectRoot = options.path || process.cwd()
+
+      if (!options.json) {
+        console.log(chalk.gray('\n  Scanning project...'))
+      }
+
+      const report = await runTestCoverageAudit(projectRoot)
+
+      // Output
+      if (options.json) {
+        console.log(formatReportJSON(report))
+      } else {
+        console.log(formatReport(report, chalk))
+
+        if (options.ci) {
+          const annotations = formatCIAnnotations(report)
+          if (annotations) {
+            console.log(annotations)
+          }
+        }
+      }
+
+      // Exit code
+      const { summary } = report
+      if (options.strict) {
+        // Strict: fail on any gap
+        process.exit(summary.totalGaps > 0 ? 1 : 0)
+      } else {
+        // Default: only fail on critical gaps (missing auth wall tests)
+        process.exit(summary.criticalGaps > 0 ? 1 : 0)
+      }
+    } catch (err) {
+      console.error(chalk.red(`\n  ERROR: ${err.message}\n`))
+      if (!options.json) {
+        console.error(chalk.gray(`  ${err.stack}`))
+      }
+      process.exit(1)
+    }
+  })
+
+program.parse()