Metadata-Version: 2.4
Name: repo-archaeologist
Version: 0.1.0
Summary: A CLI tool that scans git repositories to find dead code, stale files, unused dependencies, and abandoned branches.
Author: Purabh
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tomli>=2.0.0; python_version < "3.11"
Requires-Dist: tomli-w>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"

# Repo Archaeologist

A CLI tool that scans git repositories to find dead code, stale files, unused dependencies, and abandoned branches.

## Installation

```bash
pip install repo-archaeologist
```

## Usage

```bash
# Scan a repository
repo-archaeologist scan /path/to/repo

# Generate a markdown report
repo-archaeologist scan /path/to/repo --format markdown --output report.md

# Scan only Python files
repo-archaeologist scan /path/to/repo --language python

# Show only high-risk findings
repo-archaeologist scan /path/to/repo --min-score 70

# Analyze abandoned branches only
repo-archaeologist branches /path/to/repo

# Analyze unused dependencies only
repo-archaeologist deps /path/to/repo
```

## Features

- **Dead Symbol Detection**: Find functions and classes that are never referenced
- **Stale File Detection**: Identify files untouched for months or years
- **Unused Dependency Detection**: Find packages declared but never imported
- **Abandoned Branch Detection**: Locate old, unmerged branches
- **Ownership Risk Analysis**: Identify files owned by a single contributor
- **Decay Scoring**: Rank findings by risk level (0-100)

## Supported Languages

- Python
- JavaScript/TypeScript

## License

MIT
