Diagno 🔍

Universal diagnostic tool for development workflows with explainable AI capabilities.

Diagno provides intelligent code analysis, security scanning, and performance diagnostics with real pattern detection and smart heuristics.

✨ Features

• 🔒 Security Analysis: Detect hardcoded secrets, XSS vulnerabilities, injection flaws
• ⚡ Performance Analysis: Identify inefficient patterns, nested loops, optimization opportunities
• 📊 Code Quality: Complexity metrics, maintainability scoring, style analysis
• 🏥 Health Scoring: Overall project health assessment (0-100 scale)
• 📈 Multiple Formats: Console, JSON, HTML, Markdown reporting
• 🎯 Smart Detection: Context-aware analysis with low false positive rates

🚀 Quick Start

Installation

npm install -g @a-r3/diagno

Basic Usage

# Analyze current directory
diagno analyze .

# Quick health check
diagno check --detailed

# Generate HTML report
diagno analyze src/ --output html --file report.html

📚 Documentation

• Comprehensive User Guide - Complete usage instructions and examples
• Evolution Plan - Future roadmap and intelligence development
• Changelog - Version history and updates

🔧 Commands & Options

Core Commands

• diagno analyze <path> - Comprehensive code analysis
• diagno check - Quick project health check
• diagno scan - Legacy compatibility (same as analyze)

Key Options

• --output <format> - Output format: console, json, html, markdown
• --file <path> - Save report to file
• --verbose - Detailed analysis output
• --extensions <list> - File types to analyze
• --detailed - Extended health check information

📊 Current Status (v1.5.16)

✅ Production Ready - Real analysis with intelligent pattern detection
✅ Global CLI - Available via npm with diagno command
✅ Multi-format Output - Console, JSON, HTML, Markdown reports
✅ Smart Detection - Security, performance, and quality analysis
✅ Health Metrics - Comprehensive project assessment

Intelligence Level: ⭐⭐⭐⭐☆ (4/5)

🛠️ Advanced Usage

# Custom file types and verbose output
diagno analyze . --extensions .js,.ts,.vue --verbose

# JSON output for CI/CD integration
diagno analyze src/ --output json --file results.json

# Health check with detailed issue breakdown
diagno check --detailed

📈 Evolution Roadmap

Current (v1.5.x): Smart pattern detection with real analysis
Next (v1.6.x): Enhanced context-aware analysis and configuration
Future (v2.x): AI-powered code understanding and predictive analysis

See Evolution Plan for detailed roadmap.

🤝 Contributing

Diagno is designed for extensibility:

• Add patterns in src/patterns/
• Create analyzers in src/analyzers/
• Implement reporters in src/reporters/

📄 License

MIT License - see LICENSE file for details.

🔗 Links

• npm Package: @a-r3/diagno
• Documentation: User Guide
• Roadmap: Evolution Plan

Diagno - Making code analysis intelligent, one pattern at a time. 🎯