QuinntyneBrown.Complex.Cli 1.0.0

Complex

A code repository complexity analyzer CLI tool that analyzes git repositories and generates comprehensive reports with complexity scores and team size estimates.

Features

• Multi-Language Support - Analyzes C#/.NET, TypeScript/Angular, Python, and C++ projects
• Multi-Repository Analysis - Analyze multiple repositories in a single run with comma-separated URLs
• Complexity Scoring - Scores based on lines of code, file count, technology stack, and file type diversity
• Team Size Estimation - Estimates recommended team size per project and across repositories
• Comprehensive Reports - Generates detailed Markdown reports with per-project breakdowns
• Plugin Architecture - Extensible language support through analyzer plugins

Installation

As a .NET Global Tool (Recommended)

dotnet tool install -g Complex.Cli

As a .NET Local Tool

dotnet new tool-manifest # if you don't have one already
dotnet tool install Complex.Cli

Build from Source

git clone https://github.com/QuinntyneBrown/Complex.git
cd Complex
dotnet build

Quick Start

Analyze a Single Repository

complex analyze --url https://github.com/dotnet/aspnetcore

Analyze Multiple Repositories

Pass a comma-separated list of URLs to analyze several repositories in one run:

complex analyze --url "https://github.com/dotnet/aspnetcore,https://github.com/angular/angular,https://github.com/pallets/flask"

Custom Output Path

complex analyze --url https://github.com/dotnet/aspnetcore --output reports/aspnetcore-analysis.md

Help

complex --help
complex analyze --help

CLI Reference

complex analyze [options]

Options:
  -u, --url <url>       URL of the git repository to analyze.
                         Supports comma-separated URLs for multi-repo analysis.
                         (Required)
  -o, --output <path>   Output path for the analysis report.
                         (Default: ./analysis-report.md)
  -?, --help            Show help and usage information

Report Structure

Single Repository Report

• Executive Summary - Total projects, complexity score, team size, technologies
• Project Analysis - Per-project metrics, technologies, file distribution, complexity assessment
• Recommendations - Team organization, technology standardization, code quality guidance

Multi-Repository Report

• Executive Summary - Aggregate metrics across all repositories
• Repository Comparison - Side-by-side comparison table
• Per-Repository Details - Full breakdown for each repository
• Cross-Repository Recommendations - Shared patterns and standardization advice

Complexity Scoring

Complexity is calculated per project:

Complexity Levels

Team Size Estimation

• Base: 1 developer per 10,000 lines of code
• Complexity adjustment: +1 at score > 100, +1 at > 200, +2 at > 500
• Technology adjustment: +1 when technology count > 5

Supported Languages

Architecture

Complex/
├── src/
│   ├── Complex.Cli/                    # CLI application
│   │   ├── Commands/                   # Command definitions
│   │   ├── Models/                     # Data models
│   │   └── Services/                   # Core services
│   ├── Complex.Abstractions/           # Plugin interfaces
│   ├── Complex.Plugin.DotNet/          # .NET analyzer
│   ├── Complex.Plugin.TypeScript/      # TypeScript/Angular analyzer
│   ├── Complex.Plugin.Python/          # Python analyzer
│   └── Complex.Plugin.Cpp/             # C++ analyzer
├── docs/                               # User guides
├── CONTRIBUTING.md                     # Contribution guidelines
└── README.md

Technology Stack

• CLI Framework: System.CommandLine
• Dependency Injection: Microsoft.Extensions.DependencyInjection
• Logging: Microsoft.Extensions.Logging
• Git Operations: LibGit2Sharp
• Target Framework: .NET 9.0

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Documentation

• Getting Started
• CLI Reference
• Report Interpretation Guide
• Plugin Development
• Architecture Overview

License

This project is licensed under the MIT License - see the LICENSE file for details.