scope frontend contracts to the feature, not to one file

93 test files read a single frontend source and asserted identifiers in it. The
MapWorkspace split showed what that costs: 24 tests went red for a move that
changed no behaviour at all. A contract belongs to the feature — a container,
its hooks, its domain layer — not to whichever file currently holds it.

232 read sites now resolve through read_feature(). The distinction that makes
this safe is direction: a *positive* contract ("this is wired") may widen,
because the identifier must still exist somewhere in the feature; a *negative*
one ("this component performs no transport") is a statement about one file, and
widening it would quietly weaken the check. The 73 single-file reads that
remain are exactly those, and a guard now enforces the rule for new tests.

Verified rather than assumed: of the 732 migrated positive assertions, 644 still
match exactly one module — as specific as before — and the other 86 already
spanned a container and its hook by nature. Two apparent misses are an artefact
of the checking regex reading an escaped newline literally.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Jens
2026-08-22 22:05:43 +02:00
co-authored by Claude Opus 5
parent a2a8775df1
commit 6572e4ad5f
95 changed files with 454 additions and 444 deletions
@@ -1,6 +1,7 @@
from __future__ import annotations
from pathlib import Path
from tests.frontend_contract import read_feature
ROOT = Path(__file__).resolve().parents[2]
@@ -11,7 +12,7 @@ def read(path: str) -> str:
def test_guided_detection_reuses_canonical_raster_and_detection_apis() -> None:
hook = read("frontend/src/hooks/useDetectionWorkflow.ts")
hook = read_feature("detection")
assert "prepareAndRunDetection" in hook
assert "datasetsApi.rasterTile" in hook
@@ -30,7 +31,7 @@ def test_guided_detection_reuses_canonical_raster_and_detection_apis() -> None:
def test_guided_detection_upload_uses_existing_dataset_persistence_boundary() -> None:
hook = read("frontend/src/hooks/useDetectionWorkflow.ts")
hook = read_feature("detection")
assert "uploadDetectionRaster" in hook
assert "datasetsApi.upload" in hook
@@ -41,8 +42,8 @@ def test_guided_detection_upload_uses_existing_dataset_persistence_boundary() ->
def test_detection_lab_hides_manifest_plumbing_and_exposes_map_first_result_flow() -> None:
lab = read("frontend/src/components/detection/DetectionLab.tsx")
app = read("frontend/src/App.tsx")
lab = read_feature("detection")
app = read_feature("shell")
assert "Gebouwen zoeken en op kaart tonen" in lab
assert 'aria-label="Luchtbeeld toevoegen"' in lab
@@ -56,8 +57,8 @@ def test_detection_lab_hides_manifest_plumbing_and_exposes_map_first_result_flow
def test_detection_qa_remains_persisted_and_primary_not_parallel() -> None:
lab = read("frontend/src/components/detection/DetectionLab.tsx")
hook = read("frontend/src/hooks/useDetectionWorkflow.ts")
lab = read_feature("detection")
hook = read_feature("detection")
assert 'aria-label="Kwaliteitscontrole gebouwdetectie"' in lab
assert "als kwaliteitscontrole in de database bewaard" in lab
@@ -68,7 +69,7 @@ def test_detection_qa_remains_persisted_and_primary_not_parallel() -> None:
def test_active_analysis_is_not_presented_as_the_underlying_source_dataset() -> None:
app = read("frontend/src/App.tsx")
app = read_feature("shell")
assert "analysisMapLayerActive && mapFeatureCollection" in app
assert "`${mapLayerLabel} · controle vereist`" in app