detective

Detective is a forensic code analysis tool that visualizes and analyzes TypeScript-based architecture to uncover hidden patterns, coupling, and hotspots in your codebase. It helps teams understand their project structure, identify architectural issues, and align team boundaries with code organization.

Key Features

• Project Structure Visualization — Provides an overview of modules, domains, and layers to understand code organization.
• Change Coupling Analysis — Reveals which modules are frequently changed together, indicating hidden architectural coupling.
• Team/Code Alignment Analysis — Shows whether team structures align with module and domain boundaries.
• Hotspot Detection — Identifies complex, frequently changed files with higher bug risk using a calculated hotspot score.
• Git Log Integration — Analyzes commit history to derive insights about code evolution and team contributions.
• Configurable Analysis — Supports custom entry points, team definitions, aliases, and filtering of git logs and files.

Philosophy

Detective applies forensic analysis techniques to code architecture, treating the codebase as a crime scene to uncover hidden patterns and improve maintainability through data-driven insights.