bob repo reporter

The tool analyzes a repository and generates clear, easy-to-understand reports covering its structure, code health, potential risks, and development history. ### Key Features * *Repository Scanning* – Analyzes files, modules, programming languages, comments, TODOs, and project structure. * *Architecture Analysis* – Generates visual Mermaid diagrams showing the repository's folder/module structure and import dependencies. * *Code Health Audit* – Detects 11 common code-quality problems, including missing documentation, magic numbers, deep nesting, bare exceptions, mutable defaults, wildcard imports, debug prints, TODO density, long files, commented-out code, and missing function docstrings. * *Onboarding Reports* – Generates Markdown and HTML reports that highlight important files, project structure, risks, and recommended starting points for new developers. * *Release Notes Generator* – Analyzes Git history and organizes commits into release-note sections, including contributors, commit ranges, and breaking changes. * *CLI Interface* – Provides simple commands such as scan, arch, debt, and release-notes to access the different analysis features. ### Reliability & Testing The project includes Python compatibility improvements, optimized source-file handling, and an automated test suite containing *62 tests*, all currently passing. Overall, the project combines *repository understanding, architecture visualization, code-quality analysis, onboarding assistance, and release documentation* into one developer-focused tool.