test(validation): cover @vocab suppressing the coverage finding

[LukasGold]

Closes the one demand in #120 that had no test behind it, and corrects two comments the context.coverage split left stale.

Changes

• tests/data/oold/broken/vocab_covers_the_remainder.schema.json - new fixture. Byte-identical to missing_context_term.schema.json apart from $id, title, and one added @vocab, so the two are each other's control.
• test_vocab_suppresses_the_coverage_finding - asserts context.coverage stays OK, and that context.predicates reports mapped: 2, which is what proves @vocab mapped orphan rather than the check simply standing down.
• check_registry.py - the comment above the context.coverage CheckInfo opened "Deliberately cites no rule" three lines above rule="OOLD-SCH-21d7".
• test_pipeline.py - the same claim in the docstring of test_missing_context_term_warns_and_names_the_orphan_property.
• docs/maintaining-meta-schemas.md - the broken-fixtures table claims to map every file in broken/ to the check it trips, so the new fixture is listed. It is noted as a control, since it proves a check stays silent rather than fires, which the section's opening sentence did not previously allow for.

Why it matters

#120 (comment) required that the finding "must not fire at all when @vocab is declared". That was confirmed by an ad-hoc probe before the split of context.predicates into two checks, and never protected afterwards: no fixture in the corpus declared a @vocab at all, and the only @vocab in the suite asserted that the message text mentions it, which is a different claim. The permitted case was the one behaviour in that issue resting on nothing.

No production behaviour changes. The only non-test edit is a comment.

Verification

Rebased onto main at v0.18.3 and re-verified there, since the first run measured against a main that has since moved by five commits:

• full suite: 566 passed, 9 skipped, one more than main
• make check: clean
• uv run oold validate tests/data/oold --offline: PASS, 380 ok, 21 warnings, unchanged

The rebase conflicted in test_pipeline.py, where #142 added test_a_schema_with_no_context_warns_instead_of_failing_the_round_trip at the same place. Both tests are kept: one covers an absent @context, the other a declared @vocab, and they assert opposite outcomes on the same check. The check_registry.py comment fix applied unchanged, so the stale "Deliberately cites no rule" sentence is still the one on main.

Parity

Green: 6 passed against fresh clones of both references.

An earlier revision of this description claimed parity was broken on main. That was wrong and is retracted. Three parity tests did fail here, but the cause was a local ~/.cache/oold/meta/remote-main that was 15 days old and still declared x-oold-reverse-default-properties, removed upstream in OO-LD/oold-schema#152. oold meta fetch --force turned all three green with no change to this repository. main was never broken and CI was never at risk, since a fresh runner has no cache.

That the stale cache is silent is a real defect and is now #138. It is not this PR's to fix.

Refs #120. Does not close it: the severity question raised in #120 (comment) is still open.

One adjacent gap, flagged not fixed

That same table is also missing no_context, added to broken/ by #142. One row, and not this pull request's to write.

[github-actions]

Release preview

No version bump from the current commits (stays at v0.18.3). Use conventional commit types (feat, fix, ...) to trigger a release.

Changelog preview (truncated)

_{Preview via python-semantic-release and conventional commits.}

[github-actions]

📊 Benchmark Results

Click to see benchmark comparison

📊 Benchmark Comparison (threshold: 1.3x)
============================================================

➖ Unchanged (within threshold):
  ➖ test_simple_dict_document_store: 0.0017s → 0.0017s (+0.8%)
  ➖ test_sqlite_document_store: 0.0019s → 0.0019s (+0.4%)
  ➖ test_local_sparql_store: 0.0388s → 0.0384s (-0.9%)
  ➖ test_oneof_subschema: 0.0602s → 0.0597s (-0.9%)
  ➖ test_enum_docstrings: 0.0528s → 0.0502s (-4.9%)
  ➖ test_subclass_inheritance: 0.0539s → 0.0535s (-0.8%)
  ➖ test_class_hierarchy: 0.0516s → 0.0518s (+0.5%)
  ➖ test_core[v1]: 0.0392s → 0.0402s (+2.5%)
  ➖ test_core[v2]: 0.0445s → 0.0450s (+1.3%)
  ➖ test_schema_generation[v1]: 0.0017s → 0.0017s (-0.7%)
  ➖ test_schema_generation[v2]: 0.0028s → 0.0028s (+0.2%)
  ➖ test_simple_json: 0.0007s → 0.0007s (-1.8%)
  ➖ test_complex_graph: 0.0016s → 0.0016s (-0.9%)

============================================================
Summary: 0 regressions, 0 improvements, 13 unchanged
============================================================

✅ No significant performance regressions

Threshold: 1.3x (30% slower triggers a regression warning)

Note: Benchmarks are informational only and won't fail the build.

_{💡 Tip: Download the benchmark-results artifact for detailed JSON data}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[github-actions]

📊 Benchmark Results

Click to see benchmark comparison

📊 Benchmark Comparison (threshold: 1.3x)
============================================================

➖ Unchanged (within threshold):
  ➖ test_simple_dict_document_store: 0.0017s → 0.0017s (-1.4%)
  ➖ test_sqlite_document_store: 0.0018s → 0.0018s (-1.5%)
  ➖ test_local_sparql_store: 0.0387s → 0.0390s (+0.6%)
  ➖ test_oneof_subschema: 0.0592s → 0.0589s (-0.5%)
  ➖ test_enum_docstrings: 0.0497s → 0.0494s (-0.5%)
  ➖ test_subclass_inheritance: 0.0527s → 0.0529s (+0.5%)
  ➖ test_class_hierarchy: 0.0505s → 0.0513s (+1.5%)
  ➖ test_core[v1]: 0.0378s → 0.0381s (+0.8%)
  ➖ test_core[v2]: 0.0436s → 0.0445s (+2.0%)
  ➖ test_schema_generation[v1]: 0.0016s → 0.0016s (-0.5%)
  ➖ test_schema_generation[v2]: 0.0027s → 0.0028s (+0.6%)
  ➖ test_simple_json: 0.0007s → 0.0007s (+2.5%)
  ➖ test_complex_graph: 0.0016s → 0.0016s (+1.2%)

============================================================
Summary: 0 regressions, 0 improvements, 13 unchanged
============================================================

✅ No significant performance regressions

Threshold: 1.3x (30% slower triggers a regression warning)

Note: Benchmarks are informational only and won't fail the build.

_{💡 Tip: Download the benchmark-results artifact for detailed JSON data}

[github-actions]

📊 Benchmark Results

Click to see benchmark comparison

📊 Benchmark Comparison (threshold: 1.3x)
============================================================

⚠️  Performance Regressions:
  ❌ test_class_hierarchy: 0.0382s → 0.0559s (+46.4%, ratio: 1.46x)

➖ Unchanged (within threshold):
  ➖ test_simple_dict_document_store: 0.0013s → 0.0013s (+0.5%)
  ➖ test_sqlite_document_store: 0.0014s → 0.0014s (+0.9%)
  ➖ test_local_sparql_store: 0.0290s → 0.0290s (-0.0%)
  ➖ test_oneof_subschema: 0.0437s → 0.0438s (+0.0%)
  ➖ test_enum_docstrings: 0.0374s → 0.0388s (+3.8%)
  ➖ test_subclass_inheritance: 0.0400s → 0.0394s (-1.5%)
  ➖ test_core[v1]: 0.0277s → 0.0279s (+0.4%)
  ➖ test_core[v2]: 0.0375s → 0.0322s (-14.1%)
  ➖ test_schema_generation[v1]: 0.0014s → 0.0014s (+1.1%)
  ➖ test_schema_generation[v2]: 0.0022s → 0.0022s (+1.0%)
  ➖ test_simple_json: 0.0005s → 0.0005s (+2.2%)
  ➖ test_complex_graph: 0.0012s → 0.0012s (+2.2%)

============================================================
Summary: 1 regressions, 0 improvements, 12 unchanged
============================================================

⚠️  Regressions detected but not failing build (informational only)

Threshold: 1.3x (30% slower triggers a regression warning)

Note: Benchmarks are informational only and won't fail the build.

_{💡 Tip: Download the benchmark-results artifact for detailed JSON data}