health-checker

Project Health Checker

Run a comprehensive health check across the entire project. Auto-detect the tech stack and report results as a dashboard.

Detection Strategy

Scan the project root to identify components:

• go.mod — Go backend (use go vet, go test)
• package.json — Node.js/frontend (use tsc, npm test, npm run build)
• requirements.txt / pyproject.toml — Python (use mypy, pytest)
• Cargo.toml — Rust (use cargo check, cargo test)
• migrations/ — SQL migrations
• **/openapi.yaml / **/swagger.json — API spec
• docs/ — Documentation

Checks (run in parallel where possible)

1. Compilation Status

Auto-detect and run:

• Go: go vet ./... 2>&1 | head -10
• TypeScript: npx tsc --noEmit 2>&1 | head -10
• Python: mypy . 2>&1 | head -10 (if mypy installed)
• Rust: cargo check 2>&1 | head -10 Report: compiles clean / N errors

2. Test Status

Auto-detect and run:

• Go: go test ./... -count=1 -short 2>&1 | tail -10
• Node: npm test 2>&1 | tail -10 (if test script exists)
• Python: pytest --tb=no -q 2>&1 | tail -5
• Rust: cargo test 2>&1 | tail -10 Report: N tests pass / N failures

3. Stale TODOs

grep -rn "TODO\|FIXME\|HACK\|XXX" --include="*.go" --include="*.ts" --include="*.tsx" --include="*.py" --include="*.rs" --include="*.js" --include="*.jsx" . | grep -v node_modules | grep -v vendor | grep -v target

Report: count per category

4. API Spec Drift (if spec exists)

Compare registered routes against API spec file:

• Find route registration files
• Find OpenAPI/Swagger spec
• List endpoints in code but not in spec (undocumented)
• List endpoints in spec but not in code (stale) Report: N undocumented, N stale

5. Migration Consistency (if migrations exist)

# Check all up migrations have matching down migrations
for f in $(find . -path "*/migrations/*.up.sql" -o -path "*/migrations/*.up.*" 2>/dev/null); do
  down=$(echo "$f" | sed 's/\.up\./\.down\./');
  [ ! -f "$down" ] && echo "MISSING DOWN: $(basename $f)"
done

Report: N migration pairs, any missing rollbacks