Metadata-Version: 2.4
Name: sot-verify
Version: 0.1.0
Summary: Quick verification for Source of Truth (.sot) 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,ci-cd,clarity-gate,epistemic,rag,sot,source-of-truth,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: sot-validator>=0.1.0
Description-Content-Type: text/markdown

# sot-verify

Quick pass/fail verification for Source of Truth (`.sot`) files — optimized for CI/CD pipelines.

[![PyPI version](https://badge.fury.io/py/sot-verify.svg)](https://pypi.org/project/sot-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 |
|------|----------|
| **sot-verify** | CI/CD pipelines, git hooks, quick checks |
| **sot-validator** | Detailed reports, debugging, development |

## Installation

```bash
pip install sot-verify
```

## CLI Usage

```bash
# Quick check - exit 0 if valid, exit 1 if invalid
sot-verify project.sot

# Multiple files
sot-verify docs/*.sot

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

## In CI/CD

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

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

## Python API

```python
# Re-exports everything from sot-validator
from sot_verify import validate, is_valid, detect

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

## Related

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

## License

CC BY 4.0
