[LuSilber]

Test specifications move into the test sources as codelinks one-line comments, like the implementation needs. Test results come from sphinx-test-reports' test-report directive again, which ubc 0.39 now reads as well.

Draft: CI can't pass until the dependency stack below is pinned.

Changes, one commit each

1. Drop get_rst. ubc 0.39 warns about the key, and False is already its default.
2. Test specifications as one-liners.
   • The 30 specs change from @rst .. test:: blocks to // @need <GTest name>, <id>, test, [<tests>] comments in a new tests codelinks project.
   • Each component page shows them in ## Verification via src-trace.
   • codelinks follows each variant's #ifdef branches using the test-kit build's compile database.
3. Test results through the test-report directive.
   • SPL_TEST_RESULTS_AS_NEEDS is turned OFF, and a [test_reports] table is shared by both readers.
   • The extension registers the result types and fields, so the hand-declared copies are removed.
   • results is now a sphinx-needs 9 derived link: each spec links to the test cases whose case matches.
4. Parameterised specs link every instance.
   • A derived link only matches names exactly, so Suite/Test.Case/* can't match its instances.
   • Each spec now names its cases in test_cases, separated by \,.
   • The field is a string because ubc drops codelinks list fields that aren't link types. The derived link splits strings on commas, so two instance names containing a comma were renamed.

Need-level comparison with CI run 42134750198 (d351c44, Disco and Spa test reports)

• Same as CI:
  • The testfile, testsuite and testcase IDs.
  • Every spec's results links, including the parameterised ones (TS_LC-003: 3, TS_MCK-001: 7, TS_FC-001: 4, TS_FC-100: 4).
• Changed:
  • A spec's docname is now its component page.
  • Specs get a remote-url.
  • Results have is_import set to false.
• Removed:
  • REQ_37 and REQ_58 (see open points).
  • Disco's integration-test results, only because that test can't build on macOS. CI will have them.

Verification (local, macOS)

• test_ubproject_config.py: 29 passed.
• Docs gate: the 38 component-report cells outside Disco pass in both readers, strict.
• Not run locally: the Disco and whole-variant report cells (AppleClang and hammocking).

Open points before this can merge

• spl-core pin: this needs a useblocks spl-core with sphinx-needs >=9.2,<10, sphinx-test-reports >=4,<5, and the extension loaded as sphinx_test_reports (prototyped on branch feat/sphinx-test-reports-4 from ce62088, not pushed yet).
• SPLed's own dependencies: bump to sphinx-codelinks >=2.1,<3, then update poetry.lock. The AGENTS.md pin paragraph needs updating too.
• REQ_37 / REQ_58: sphinx-needs 9 refuses these two untitled entries from the ubConnect ReqIF export. This fails Sphinx's strict build for variant-level docs; ubc already skipped them.
• The gate doesn't compare test-report fields: it only compares fields declared in ubproject.toml. Because of that, errors differs between the readers unnoticed: -1 in Sphinx, 0 in ubc.
• Follow-up: ub-test-reports should split a GTest instance into case_parameter, so test_cases can be removed. The task has been handed to the rollout session.

🤖 Generated with Claude Code