Skip to content

Stop pinning README bytes in reviewed contract history - #132

Merged
irvineoy merged 1 commit into
mainfrom
codex/drop-readme-contract-pins
Oct 27, 2026
Merged

irvineoy merged 1 commit into
mainfrom
codex/drop-readme-contract-pins

Conversation

@irvineoy

Copy link
Copy Markdown
Collaborator

tests/reviewed_contract_history.py stores exact inverse records for reviewed task-contract edits. The older migration tests use them to restore a task file's original bytes, which proves that later PRs changed task contracts only through reviewed edits.

Only the config.yaml, workload and kernel-source records feed those tests. The 48 README records — 45 in TRITON_DEVICE_BOUNDARY_FILES and 3 in ATTENTION_SAMPLING_COVERAGE_FILES — were checked only by their own self-test, which froze the README text. Every documentation edit to these tasks therefore required regenerated records; #127 listed this as a known limitation.

Changes

  • Remove the 48 README records. All 45 config records and the 2 workload/kernel-source records stay unchanged.
  • Remove the README-only composition step from historical_triton_device_boundary_file.
  • Add a test asserting that only contract files remain pinned, and rename the per-record self-test to match its scope.

No task file, harness, workload, tolerance or timing changes. No GPU validation is needed.

Validation

  • The ten test files that use the reviewed history: 2,813 passed.
  • With a line temporarily appended to tasks/triton2triton/vllm/triton_bmm/README.md, the same 2,813 tests still pass. Before this change, the README pin self-test rejected that edit.

The reviewed-history records let the older migration tests prove that a
task's current files reproduce their original bytes after reviewed edits.
Only the config, workload and kernel-source records feed those tests. The
48 README records were checked by nothing but their own self-test, so every
documentation edit to these tasks required regenerated records.

Drop the README records and the README-only composition step, keep every
contract record, and assert that only contract files remain pinned.
@irvineoy
irvineoy merged commit 81c41f3 into main Oct 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant