Metadata-Version: 2.5
Name: cogext-compliance
Version: 0.1.0
Summary: Compliance checker for the COGEXT Commitment Standard v0.1
Project-URL: Homepage, https://cogextai.com/standard
Project-URL: Repository, https://github.com/yaminbinyoosuf/cogext-compliance
Author-email: Yamin / THRYVIX <hello@cogextai.com>
License: MIT
License-File: LICENSE
Keywords: accountability,ai-agents,commitments,compliance,standard
Classifier: Development Status :: 3 - Alpha
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
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# cogext-compliance

Check whether an AI agent implementation conforms to the
[COGEXT Commitment Standard v0.1](https://cogextai.com/standard).

## Install

```bash
pip install cogext-compliance
```

## Usage

Check a file and get a 0–100 compliance score:

```bash
cogext-compliance check path/to/your/agent.py
```

```
                        COGEXT Compliance Report
┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Requirement            ┃ Status  ┃ Score ┃ Matched                       ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Commitment Object      │ pass    │ 25.0  │ action, recipient, deadline   │
│ State Machine          │ partial │ 12.0  │ open, due                     │
└────────────────────────┴─────────┴───────┴───────────────────────────────┘

Score: 62.0/100 — not compliant (threshold 80)
```

Generate a Markdown badge for your README:

```bash
cogext-compliance badge path/to/your/agent.py
```

```
![COGEXT Compliance](https://img.shields.io/badge/COGEXT-62%2F100-orange)
```

Add `--threshold` to change the pass mark (default `80`).

## What it tests

Six requirements from the standard, weighted by importance:

| # | Requirement | Weight |
|---|---|---|
| 1 | Commitment Object | 25 |
| 2 | State Machine | 20 |
| 3 | Verifier Query | 20 |
| 4 | Evidence Protocol | 15 |
| 5 | Audit Receipt | 10 |
| 6 | Reliability Score | 10 |

> **Read this before you trust a score.** v0.1 is a **static keyword check**: it
> scans source text for the identifiers and vocabulary the standard requires. It
> does not execute your code, and it cannot tell whether your state machine
> actually enforces its transitions. A file that merely mentions `fulfilled`,
> `failed` and `expired` will score points for the State Machine requirement
> without implementing one. Treat a high score as a hint that the vocabulary is
> present, not as proof of conformance.

## Links

- Standard: https://cogextai.com/standard
- Adoption index: https://cogextai.com/index

## License

MIT — see [LICENSE](LICENSE).
