# MGF Standards Conformance — mgf-cloud-provision

> **Declared level.** **L2 — Standard** (declared 2026-06-18 at federation registration).
> **Status.** Phase-1a skeleton. The four CI gates + packaging/CI rules hold; the full per-rule audit (across the standards corpus) is **pending** — tracked below and completed as the library matures past skeleton.

Standards source of truth: `mgf-fed standards <topic>` (or `mgf-common standards`). This tracker records *this* repo's posture.

## Gate-level conformance (CI-enforced today)

| Rule | Status | Evidence |
|---|---|---|
| WF-01 runs on every push/PR (+tag/manual) | ✅ | `.woodpecker.yml` `when:` event list (generated). |
| WF-02 four gates CI-enforced | ✅ | `lint` (ruff), `typecheck` (mypy), `test-3.11/12/13` (pytest), `lint-imports` (import-linter). |
| WF-13 `.woodpecker.yml` is generation-current | ✅ | Generated by `mgf-fed scaffold` from the canonical template; `mgf-fed drift-check` is the gate. |
| DP-01 layering enforced | ✅ | `[tool.importlinter]` — `mgf.cloud_provision` forbids UI frameworks. |
| TS-06 coverage floor | ✅ | `[tool.coverage.report] fail_under = 80`; current 96 % (vs `FakeProvider`). |
| SC-01 secret scan | ✅ | gitleaks step + `.gitleaks.toml` (byte-exact from template). |
| SC-10 dependency CVE scan | ✅ | `vuln-scan` step (`pip-audit`, pip upgraded first). |
| PKG-06 Codeberg-only `mgf-*` resolution | ✅ | `[[tool.uv.index]] explicit = true` + `[tool.uv.sources]`. |
| EH-01/02 typed exceptions extend the federation base | ✅ | `ProvisionError`/`SpecError` extend `mgf.common.exceptions`. |
| AP-09 PEP 561 typed | ✅ | `py.typed` ships in the wheel (build step asserts it). |
| DOC-08 PUBLIC_API.json present + current | ✅ | `PUBLIC_API.json` + `tools/generate_public_api_json.py`. |

## Pending (post-skeleton)
- Full per-rule audit across the standards corpus (API_DESIGN, TESTING, OBSERVABILITY, RELEASING, …).
- First release (`0.1.0`) through the tag-driven publish flow → REL-* rows.
- Phase-1b feature work (live provider + cloud-init converge) + its conformance.

## History
| Date | Who | Change |
|---|---|---|
| 2026-06-18 | Bassam Alsanie + Claude | Federation registration: added to `MGF_LIBRARIES` (31 libraries, REL-13 GREEN), scaffolded generated CI + policy files, declared L2. Phase-1a skeleton. |
