@dev_innovations_labs/code-diagnostics

Enterprise-grade CSS & JavaScript diagnostics CLI designed to prevent broken builds, corrupted files, and CI/CD failures — standardized by Dev Innovations Labs.

This tool fails fast, fails clearly, and blocks bad code before it reaches production.

🚀 Why This Exists

Modern React / Node projects often break due to:

• Unclosed CSS block comments
• Stray */ tokens
• Accidental comment corruption during bulk edits
• Silent JavaScript syntax errors
• CRA / Vite / Webpack build crashes with unclear errors

code-diagnostics detects these issues before they reach:

• CI
• Production builds
• Releases

📦 What It Does

✅ CSS Diagnostics (Accurate & Vendor-Safe)

• Detects stray */ tokens
• Detects unbalanced /* ... */ blocks
• Skips vendor CSS by default (FontAwesome, Owl, etc.)
• Supports optional vendor scanning

❌ Does NOT flag:

• Valid comment body lines
• License headers
• Star-prefixed comment styles
• Valid CSS selectors (* {})

✅ JavaScript / TypeScript Diagnostics

• Detects syntax errors using Node VM
• Detects unbalanced block comments
• Reports exact line numbers & code
• Falls back to ESLint for deep validation

✅ CI & Git Safety

• Deterministic exit codes
• Pre-commit friendly
• GitHub Actions compatible
• Generates machine-readable diagnostics report

📁 Project Structure

tools/
├─ css-diagnostics.js
├─ js-diagnostics.js
├─ diagnose-all.js
├─ diagnostics-report.js
└─ safe-fix-comments.js

🛠 Installation

npm install @dev_innovations_labs/code-diagnostics --save-dev

Or run directly:

npx code-diagnostics

▶️ Basic Usage

npx code-diagnostics

Skip vendor CSS (default)

npx code-diagnostics --skip-vendor

Include vendor CSS

npx code-diagnostics --include-vendor

🧹 Safe Auto-Fix (CSS Comments Only)

npx code-diagnostics fix:comments

✔ Removes stray */
✔ Fixes broken comment endings
❌ Does NOT modify valid CSS or JS

📄 Diagnostics Report

After each run:

diagnostics-report.json

Includes:

• Timestamp
• CSS issues
• JS issues
• File, line & reason

🔒 Git Pre-Commit Hook

#!/bin/sh
npx code-diagnostics --skip-vendor || exit 1

🤖 GitHub Actions Example

- name: Run Code Diagnostics
  run: npx code-diagnostics --skip-vendor

🏷 CLI Commands

| Command | Description | |------|-------------| | code-diagnostics | Run full diagnostics | | --skip-vendor | Skip vendor CSS | | --include-vendor | Include vendor CSS | | fix:comments | Safe CSS auto-fix |

📜 License

MIT © Dev Innovations Labs