Metadata-Version: 2.4
Name: devtrust-repox
Version: 0.4.0
Summary: Codebase architecture model that AI tools and other DevTrust products consume.
Project-URL: Homepage, https://github.com/AbdullahBakir97/DevTrust
Project-URL: Repository, https://github.com/AbdullahBakir97/DevTrust
Project-URL: Documentation, https://github.com/AbdullahBakir97/DevTrust/tree/main/src/products/01-repo-xray/code#readme
Project-URL: Changelog, https://github.com/AbdullahBakir97/DevTrust/blob/main/src/products/01-repo-xray/code/CHANGELOG.md
Project-URL: Issues, https://github.com/AbdullahBakir97/DevTrust/issues
Author: Abdullah Bakir
License-Expression: Apache-2.0
Keywords: ai,codebase-analysis,developer-tools,mcp,repo-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Requires-Dist: pathspec>=1.0.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: rich>=13.9.0
Requires-Dist: tree-sitter-language-pack<1.0,>=0.4.0
Requires-Dist: tree-sitter>=0.23.0
Requires-Dist: typer>=0.15.0
Description-Content-Type: text/markdown

# Repo X-ray

> One artifact. Every AI tool understands your repo the same way.

Repo X-ray analyzes a codebase and produces a single, structured architecture artifact (`.repox/architecture.json` + `.repox/architecture.md`) that any AI tool can consume — Cursor, Claude Code, Copilot, custom agents, or downstream DevTrust products.

For the full product spec, see [`../PRODUCT.md`](../PRODUCT.md).

---

## v0.0.1 — what works today

- `repox build [PATH]` — walks a repo, classifies files by language, identifies likely entry points, emits both `architecture.json` and `architecture.md`.
- `repox version` — prints the installed version.
- Honors `.gitignore` via [pathspec](https://pypi.org/project/pathspec/).
- Beautiful terminal output via [rich](https://rich.readthedocs.io/).

## Roadmap (matches the master plan)

- **v0.1** — language coverage extends to TS/JS, Python, Go, Rust; basic dependency graph from manifests; convention extraction (naming patterns, error handling).
- **v0.2** — call graph via tree-sitter; module-boundary inference.
- **v0.3** — incremental updates (`repox update`); MCP server.
- **v0.5** — public release with CI integration (GitHub Action).
- **v1.0** — stable artifact format, language coverage to Java, C#, Ruby.

## Install

From the monorepo root:

```powershell
# uv (recommended) — installs all workspace members
uv sync --all-groups

# pip
pip install -e .
```

## Use

```powershell
# Analyze the current directory
repox build

# Analyze a specific repo
repox build C:\Users\you\some-repo

# Print version
repox version
```

Output lands in `.repox/architecture.json` and `.repox/architecture.md` at the analyzed repo root.

## Layout

```
code/
├── pyproject.toml
├── README.md
├── src/
│   └── repox/
│       ├── __init__.py
│       ├── __main__.py        Allows `python -m repox`
│       ├── cli.py             Typer-based CLI entry point
│       ├── models.py          Pydantic data models (Architecture, FileInfo, etc.)
│       ├── analyzer.py        Tree walk, language detection, entry-point detection
│       └── output.py          JSON + Markdown writers
└── tests/
    ├── __init__.py
    ├── conftest.py
    └── test_smoke.py
```

## License

Apache-2.0. See `LICENSE` at the monorepo root.
