Performance Optimizer v2.5 PRO — Advanced Multi-Stack Analyzer

NOT SonarQube. This is an enterprise static performance & latency intelligence engine.
Targeted Runtimes: Angular (14–19+), React (17–19+) & Next.js, Node.js & Seneca.js, SQL / Database Indexes, and AWS Serverless.
Zero external dependencies — runs in <0.05s with Python 3.7+ standard library.

🌐 Live Interactive Web Portal & Diagnostic Scanner: https://ravik27280.github.io/Performance-Optimizer/

⚡ Installation & CLI Setup

Install locally or as an editable package for global terminal access:

# Clone the repository
git clone https://github.com/Ravik27280/Performance-Optimizer.git
cd Performance-Optimizer

# Install package globally / in virtual environment
pip install -e .

# Verify CLI installation
perf-optimizer --help

🚀 Quick Start Examples

# 1. Scan current repository / monorepo
perf-optimizer --project .

# 2. Scan separate frontend and backend directories
perf-optimizer --frontend ./angular-app --backend ./node-api

# 3. Enforce CI/CD Quality Gate (Exit 1 on critical issues or score < 75)
perf-optimizer --project . --fail-on critical --min-score 75

# 4. Generate HTML dashboard, JSON audit, and PR Markdown summary
perf-optimizer --project . --json --markdown-summary pr_summary.md --output report.html

# 5. Alternatively, run directly with python (zero pip packages required)
python optimizer.py --project . --verbose

📊 Output Formats

• performance_report.html — Interactive executive dashboard with code diff previews, ROI impact calculations, and dark/light modes.
• performance_report.json — Machine-readable audit data with exact line numbers and defect categories for custom tooling.
• pr_summary.md — Markdown report table designed for automated Pull Request comments in GitHub Actions and GitLab CI.

🤖 GitHub Actions CI/CD Integration

Create .github/workflows/perf-audit.yml to automatically run audits on every Pull Request:

name: Performance Quality Gate

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Install Performance Optimizer
        run: pip install -e .
      - name: Run Performance Audit
        run: |
          perf-optimizer --project . --fail-on critical --min-score 75

🛡️ CLI Flags & Options

🔇 Inline Rule Suppression

Suppress false positives or accepted trade-offs directly in code:

// Angular / TypeScript / JavaScript
// perf-ignore ANG001
@Component({ ... })

// Node.js
// perf-ignore NODE001
const bootConfig = fs.readFileSync('boot.json', 'utf8');

// SQL / Schema
-- perf-ignore SQL004
CREATE TABLE temp_session ( ... );

🔍 What It Detects (Performance-Specific)

Angular / Modern Frontend (Angular 16–19+)

React & Next.js (React 17–19+)

Node.js / Seneca / Express Backend

SQL / RDS / Database

AWS / Serverless / Cloud Infrastructure

📈 Scoring Engine

• Asymptotic Logarithmic Curve: Avoids artificial zero-score cliffs; accurately reflects true performance health for codebases of any size.
• Architectural Layer Weights: $$\text{Overall} = 40% \text{Frontend} + 30% \text{Backend} + 20% \text{Database} + 10% \text{Infra}$$
• Priority Rank: Calculated via $\text{Impact} / \max(\text{Effort}, 1)$ to prioritize high-impact, low-effort wins.

🧪 Automated Testing

Run the included unit test suite:

python -m unittest discover -s tests -p "test_*.py" -v