Metadata-Version: 2.4
Name: tracebisect
Version: 0.0.1a0
Summary: Git bisect for AI agent traces
Project-URL: Homepage, https://github.com/tracebisect/tracebisect
Project-URL: Repository, https://github.com/tracebisect/tracebisect
Project-URL: Issues, https://github.com/tracebisect/tracebisect/issues
Author: TraceBisect contributors
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,llm,observability,opentelemetry,pytest
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
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
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: colorama>=0.4.6
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Requires-Dist: types-colorama>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# TraceBisect

Git bisect for AI agent traces.

TraceBisect is a local-first command-line tool for comparing two AI agent traces,
finding the first meaningful behavioral divergence, and exporting a pytest
regression test so the failure does not return.

This repository is currently in alpha scaffold state.

## Install

```bash
pip install tracebisect
```

## Current Alpha Commands

- `tracebisect --version` — prints the package version.
- `tracebisect demo` — prints a static preview of the v1.3 money-shot output.
- `tracebisect ingest`, `tracebisect record`, `tracebisect diff`,
  `tracebisect export-pytest` — alpha stubs. They parse the locked CLI
  signatures from spec section 4.2 but exit with code 2 and an
  "alpha — not implemented yet" message until V1 lands.

## V1 Scope

V1 will ship:

- OpenTelemetry/OpenInference and native `.tbtrace` ingestion
- trace alignment
- first-divergence detection
- terminal diff rendering
- pytest regression-test export with fresh CI capture

V1 will not ship a dashboard, SaaS service, vendor-native importers, or git
history bisection.

See [spec/production-spec.md](spec/production-spec.md) for the locked product
specification.

