JSPM

  • Created
  • Published
  • Downloads 41
  • Score
    100M100P100Q72102F
  • License MIT

Universal repository diagnostic and security scanning tool with explainable AI

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@a-r3/diagno) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Diagno 🔍

    npm version License: MIT

    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

    🔧 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.


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