Metadata-Version: 2.4
Name: devluxe
Version: 0.2.0
Summary: Governed AI project doc-kit validator — check CLAUDE.md, AGENTS.md, governance.yaml and the decision log as a CI gate.
Project-URL: Homepage, https://github.com/katterskillsawmill/devluxe
Project-URL: Repository, https://github.com/katterskillsawmill/devluxe
Author: Dane Anthony Cooper
License: MIT
License-File: LICENSE
Keywords: agents-md,ai-governance,ci,claude,developer-tools,devluxe,doc-kit
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
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# devluxe

> **Status: early development (v0.2, quiet release).** Published to claim the namespace
> with a real, working tool; APIs may change without notice until v1.0. Not yet announced.

**Governed AI project doc-kit validator** (Python). Check that a repo's AI
agent contract — `CLAUDE.md`, `AGENTS.md`, `governance.yaml`,
`.ai-notes/devtrack.md` — exists, is complete, and stays honest. The
scaffolding counterpart (`init`) ships in the npm package of the same name.

```bash
pip install devluxe
devluxe check .            # structural validation
devluxe check . --gate     # strict line-count floors
```

| Check | What it validates |
|---|---|
| required files | all four kit files exist and are non-empty |
| incomplete-markers | zero unfinished-work tokens anywhere in the kit |
| required sections | `## Purpose` + `## DO NOT` (CLAUDE), `## Forbidden` (AGENTS) |
| governance keys | `schema_version`, `metadata`, `guardrails`, `verification` |
| `--gate` floors | CLAUDE ≥100 · ARCHITECTURE ≥150 · BLUEPRINT ≥150 · PRD ≥100 lines |

Exit codes: `0` pass · `1` named failures · `2` usage error.
Zero runtime dependencies; Python ≥ 3.10; importable API: `from devluxe import check`.

## CI usage

```yaml
- run: pip install devluxe && devluxe check .
```

## Scope (honest)

v0.2 = `check` only, deliberately: scaffolding lives in the npm CLI
(`npx devluxe init`); this package is the validate-anywhere gate for
Python-first pipelines. Both packages share one rule table and one version.

## License

MIT © Dane Anthony Cooper
