maturity-engine/tests/test_layer_conformance.py
tegwick 30236955c6 Apply GH-DEC-2026-017: INTENT.md governs, the sidecar is derived, no version
- Remove standard_version from layer.yaml and INTENT.md frontmatter (§5, A12).
- Mark layer.yaml derived: true, derived_from: INTENT.md (§1, A11).
- Checker and tests change in the same commit: standard_version is no longer
  a required key (it is now rejected in either form), the derived marking is
  required, both layer values are checked against the closed four-token
  vocabulary, and the two forms are compared after an ASCII case fold (A9).
  A disagreement surviving the fold is reported as a finding.
- Nothing re-spelled: INTENT.md keeps "Engine", layer.yaml keeps "engine".

Scope check (§9.5 / GH-DEC-2026-017 §4): maturity-engine does not score
layer declarations anywhere. scoring.py grades gap-register conformance
states, and seed gaps concern capabilities, not §11 declarations, so no
non-§4 repository is graded. No scoring change required.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 63291@bnt-lap001
Assistant-Session: 8bd77868-ca68-4f49-bb1e-d539ecc0d703
2026-09-21 07:35:40 +02:00

114 lines
3.6 KiB
Python

from __future__ import annotations
import re
import subprocess
import sys
from pathlib import Path
import pytest
yaml = pytest.importorskip("yaml")
ROOT = Path(__file__).resolve().parents[1]
SCRIPT = ROOT / "scripts" / "check_layer_conformance.py"
DECL = ROOT / "layer.yaml"
INTENT = ROOT / "INTENT.md"
def _fold(value: object) -> str:
return str(value).strip().encode("ascii", "ignore").decode().lower()
def _intent_frontmatter() -> dict:
match = re.match(r"^---\n(.*?)\n---\n", INTENT.read_text(), re.DOTALL)
assert match
return yaml.safe_load(match.group(1))
def _run(*args: str) -> subprocess.CompletedProcess[str]:
return subprocess.run(
[sys.executable, str(SCRIPT), *args],
capture_output=True,
text=True,
)
def test_declaration_exists_and_declares_engine_pip():
assert DECL.exists()
data = yaml.safe_load(DECL.read_text())
assert data["repository"] == "maturity-engine"
assert _fold(data["layer"]) == "engine"
assert _fold(data["role"]) == "pip"
assert data["framework"] == "netkingdom-security-layer-model"
assert "pep_stance" not in data or not data.get("pep_stance")
def test_intent_md_carries_the_governing_layer_key():
"""GH-DEC-2026-017 §1: the INTENT.md frontmatter key is the declaration."""
assert _fold(_intent_frontmatter()["layer"]) == "engine"
def test_sidecar_is_marked_derived_and_names_its_source():
data = yaml.safe_load(DECL.read_text())
assert data["derived"] is True
assert data["derived_from"] == "INTENT.md"
def test_frontmatter_agrees_with_layer_yaml_once_case_is_folded():
"""A11 agreement, A9 fold. Deliberately a fold, not an equality: an
equality would silently demand the re-spelling the ruling declined."""
meta = _intent_frontmatter()
data = yaml.safe_load(DECL.read_text())
assert _fold(meta["layer"]) == _fold(data["layer"])
assert _fold(meta["role"]) == _fold(data["role"])
def test_both_layer_values_are_in_the_closed_vocabulary():
vocabulary = {"taxonomy", "tooling", "engine", "staff"}
assert _fold(_intent_frontmatter()["layer"]) in vocabulary
assert _fold(yaml.safe_load(DECL.read_text())["layer"]) in vocabulary
def test_no_declaration_carries_a_standard_version():
"""GH-DEC-2026-017 §5 / A12."""
assert "standard_version" not in yaml.safe_load(DECL.read_text())
assert "standard_version" not in _intent_frontmatter()
def test_no_tooling_contacts_or_pep():
data = yaml.safe_load(DECL.read_text())
assert data["tooling_contacts"] == []
for entries in data["declared_shapes"].values():
assert entries == []
clients = {item["id"] for item in data["non_tooling_clients"]}
assert "state-hub-work-records" in clients
assert "sqlite-own-store" in clients
def test_catalog_entry_matches_section_4():
data = yaml.safe_load(DECL.read_text())
owns = " ".join(data["catalog_entry"]["owns"])
assert "graded progression" in owns
assert "gap register" in owns
assert "capability readiness" in owns
def test_checker_passes_on_the_real_tree():
result = _run()
assert result.returncode == 0, result.stderr
def test_checker_catches_an_openbao_client(tmp_path, monkeypatch):
import importlib.util
spec = importlib.util.spec_from_file_location("check_layer_conformance", SCRIPT)
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
fake_src = tmp_path / "src" / "maturity_engine"
fake_src.mkdir(parents=True)
(fake_src / "oops.py").write_text("import hvac\n")
monkeypatch.setattr(module, "SRC", fake_src)
hits = module.scan()
assert hits
assert hits[0][1] == "hvac"