Metadata-Version: 2.4
Name: harness-lens
Version: 0.0.1
Summary: Inspect coding-agent harness files in a repository.
Author: Cristian Camargo Filho
License-Expression: BSD-3-Clause
Project-URL: Homepage, https://github.com/harness-lens/harness-lens
Project-URL: Documentation, https://github.com/harness-lens/harness-lens#readme
Project-URL: Issues, https://github.com/harness-lens/harness-lens/issues
Project-URL: Repository, https://github.com/harness-lens/harness-lens
Keywords: agents,developer-tools,harness,linting
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest<10,>=8; extra == "test"
Provides-Extra: dev
Requires-Dist: build>=1.3; extra == "dev"
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: twine>=6; extra == "dev"
Dynamic: license-file

# HarnessLens

HarnessLens inspects coding-agent harness files in a repository. The first package is a small, functional preview: it discovers supported instruction files and provides a stable package and CLI foundation for the planned validator, metrics, history, and TUI.

## Installation

```bash
python -m pip install harness-lens
```

## Usage

Inspect the current repository:

```bash
harness-lens .
```

Emit JSON for scripts:

```bash
harness-lens . --json
```

The preview recognizes:

- `AGENTS.md`
- `CLAUDE.md`
- `GEMINI.md`
- `.github/copilot-instructions.md`
- files under `.cursor/rules/`

It searches nested repository directories while ignoring common generated and dependency directories.

## Project status

Version `0.0.1` is pre-alpha. It implements discovery only. Planned validation rules, metrics, historical comparisons, AI interpretation, and TUI are documented in [design decisions](docs/design-decisions.md).

## Development

```bash
python -m pip install -e ".[dev]"
python -m pytest
python -m build
python -m twine check --strict dist/*
```

Release setup lives in [publishing documentation](docs/publishing.md).

## License

BSD 3-Clause. See [LICENSE](LICENSE).

## Authors

HarnessLens was created by [cristiancmrg](https://github.com/cristiancmrg) and is maintained with contributions from the HarnessLens community.
