Skip to content

Commit 140517f

Browse files
committed
tests/interaction: document TRANSPORT_SPEC_VERSIONS as a grid filter in README
The era-axis section claimed only arm_exclusions / added_in / removed_in filter the grid, but compute_cells() also drops cells for transports era-locked via TRANSPORT_SPEC_VERSIONS (currently sse to 2025-11-25). Add it to the filter list and to the new-spec-revision checklist.
1 parent daf7108 commit 140517f

1 file changed

Lines changed: 9 additions & 2 deletions

File tree

tests/interaction/README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,9 +163,13 @@ What admits or excludes a cell:
163163
closes, grep for the reason string to find every cell to re-admit.
164164
- **`known_failures`** keep a cell in the grid but mark it as a strict xfail — the test runs and
165165
must fail; an unexpected pass fails the suite.
166+
- **`TRANSPORT_SPEC_VERSIONS`** era-locks a transport to a subset of spec versions (currently only
167+
`sse` is locked to `2025-11-25`). A `(transport, version)` cell is dropped if the version is not
168+
in the transport's entry; transports absent from the map serve every spec version. This is the
169+
mechanism for cutting an entire transport off from a new revision (or admitting it).
166170
- **`transports`** is descriptive metadata for the non-`connect` transport-specific suites under
167-
`transports/` and does **not** drive cell generation. Only `arm_exclusions`, `added_in`, and
168-
`removed_in` filter the grid.
171+
`transports/` and does **not** drive cell generation. Only `arm_exclusions`, `added_in`,
172+
`removed_in`, and `TRANSPORT_SPEC_VERSIONS` filter the grid.
169173
- **`supersedes` / `superseded_by`** link a retired entry to its replacement. `test_coverage.py`
170174
enforces that links are bidirectional and versioned: the retired entry carries `removed_in`, the
171175
replacement carries `added_in`.
@@ -183,6 +187,9 @@ When a new spec revision lands:
183187
Behaviour that survives unchanged needs nothing beyond a re-audit of its `source` URL.
184188
4. For requirements that cannot run on the new era's path, add an `arm_exclusions` entry with the
185189
appropriate `ArmExclusionReason`.
190+
5. Review `TRANSPORT_SPEC_VERSIONS`: any era-locked transport will not produce cells on the new
191+
version unless its entry is extended (or removed); add an entry for any transport the new
192+
revision retires.
186193

187194
## Writing a test
188195

0 commit comments

Comments
 (0)