Metadata-Version: 2.4
Name: cgd-verify
Version: 0.1.1
Summary: Quick verification for Clarity-Gated Document (.cgd) files - returns pass/fail for CI/CD pipelines
Project-URL: Homepage, https://github.com/frmoretto/clarity-gate
Project-URL: Repository, https://github.com/frmoretto/clarity-gate
Project-URL: Documentation, https://github.com/frmoretto/clarity-gate/blob/main/docs/FILE_FORMAT_SPEC.md
Project-URL: Issues, https://github.com/frmoretto/clarity-gate/issues
Author-email: Francesco Marinoni Moretto <francesco@fmmconsulting.it>
License-Expression: CC-BY-4.0
Keywords: ai-safety,cgd,ci-cd,clarity-gate,epistemic,llm,rag,validator,verify
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Documentation
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Requires-Dist: cgd-validator>=0.1.1
Description-Content-Type: text/markdown

# cgd-verify

Quick pass/fail verification for Clarity-Gated Document (`.cgd`) files — optimized for CI/CD pipelines.

[![PyPI version](https://badge.fury.io/py/cgd-verify.svg)](https://pypi.org/project/cgd-verify/)
[![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)

## When to Use

| Tool | Use Case |
|------|----------|
| **cgd-verify** | CI/CD pipelines, git hooks, quick checks |
| **cgd-validator** | Detailed reports, debugging, development |

## Installation

```bash
pip install cgd-verify
```

## CLI Usage

```bash
# Quick check - exit 0 if valid, exit 1 if invalid
cgd-verify document.cgd

# Multiple files
cgd-verify docs/*.cgd

# Silent mode (only exit code, no output)
cgd-verify document.cgd --silent
```

## In CI/CD

```yaml
# GitHub Actions
- run: pip install cgd-verify && cgd-verify docs/*.cgd

# Pre-commit hook
cgd-verify $(git diff --cached --name-only -- '*.cgd')
```

## Python API

```python
# Re-exports everything from cgd-validator
from cgd_verify import validate, is_valid, detect

if is_valid(content):
    print('Valid')
```

## Related

- [cgd-validator](https://pypi.org/project/cgd-validator/) - Detailed validation with warnings
- [sot-verify](https://pypi.org/project/sot-verify/) - Quick verification for .sot files
- [Clarity Gate](https://github.com/frmoretto/clarity-gate) - Full ecosystem

## License

CC BY 4.0
