cogext-compliance

Check whether an AI agent implementation conforms to the COGEXT Commitment Standard v0.1.

Install

pip install cogext-compliance

Usage

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

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:

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:

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.