Skip to content

docs(tests): stop calling pull requests issues in test prose - #1006

Merged
JarryShaw merged 1 commit into
mainfrom
docs/719-tests-attribution-sweep
Oct 3, 2026
Merged

JarryShaw merged 1 commit into
mainfrom
docs/719-tests-attribution-sweep

Conversation

@JarryShaw

Copy link
Copy Markdown
Owner

Please follow the guide below

What is the purpose of your pull request?

  • docs — documentation only

Description of your pull request and other information

Accuracy sweep for #719: nine places in tests/ call a pull request an issue. Each number was resolved with gh api rather than guessed, and the house form already used elsewhere in tests/ — "GitHub pull request #N" — is what replaces it.

File:line # really said
foundation/registry/test_protocols.py:535 815 PR issue
corekit/test_enum_lookup_reparent_930_unit.py:5 921 PR issue
corekit/test_fields_numbers_port_option_no_mint_unit.py:235 764 PR issue
corekit/test_sentinel_exports_unit.py:237 906 PR issue
project/test_conventions_doc_claims.py:805 936 PR issue
protocols/schema/test_enum_schema_registry_unit.py:383 721 PR issue
test_docstring_contract.py:4 501 PR issue
utilities/test_exceptions_excepthook.py:440 983 PR issue
protocols/test_dispatch_default_resolution_unit.py:8 425 / 428 issue / PR "issues #425/#428"

The sweep extracted 2,190 #NNN sites over 353 distinct numbers by tokenize token kind, resolved all 350 numbers at or above 300 (230 issues, 120 pull requests), and read every flagged line before changing it. Numbers below 300 are packet-diagram labels, counts and widths, and were left alone.

Two sites that look wrong and are not, left untouched: test_final_enforcement.py:121 describes a pull request that implemented issue #778, and const/test_const_ethertype_862_unit.py:212 describes PR #865's review of issue #862's fix. Both are accurate as written.

Citation markup is unchanged — tests/ is deliberately outside #989's :issue:/:pr: conversion, and GH-nnn is untouched.

Prose only: ast.dump with every docstring blanked is identical to main in all 9 files, and the diff is 9 lines for 9 lines. The 9 modules run together give 155 passed / 1 skipped / 340 subtests / 0 failures on this branch and byte-for-byte the same on main.

@JarryShaw JarryShaw added docs Pull requests that change documentation only (docs: subject prefix) review: pending No verdict for the current head - never reviewed, or the head moved since the last one labels Oct 3, 2026
@JarryShaw

Copy link
Copy Markdown
Owner Author

NEEDS CHANGES at 19cd484d3 — opus cross-review, a different model from the sonnet agent that authored the diff. Eight of the nine fixes are right and well-evidenced. One introduced a worse error than it removed, and separately I have a correction of my own to make.

The defect — tests/protocols/test_dispatch_default_resolution_unit.py:8. It now reads "the defect GitHub issue #425 and pull request #428 fixed at this layer". An issue does not fix a defect; it reports one. #425 is the bug report ("Option, chunk and block registries leak on lookup miss"), and #428's body opens by closing it. The original issues #425/#428 fixed was a single compound reference whose only error was of kind — splitting the kinds apart dropped #425 into the sentence's own "X fixed at layer L" template and made it assert something false. Being fixed: …the defect GitHub issue #425 reported and pull request #428 fixed at this layer….

Correcting myself: I attributed five identity failures to a pytest-randomly ordering artefact. That plugin is not installed. Measured just now — randomly, pytest_randomly, xdist and pytest_subtests are all absent from the venv, -p randomly dies with No module named 'randomly', and pyproject.toml sets no addopts. So -p no:randomly pinned nothing and my mechanism was fiction. What survives is the part that was measured: 155 passed / 1 skipped / 340 subtests / 0 failures, identical on 326a0e5ae and 19cd484d3, and the branch cannot cause those failures because it is docstring-and-comment-only — ast.dump identical in all 9 files and all 1,176 non-docstring string constants identical in order. The order-dependence itself is already tracked by #981 and #674.

The review also strengthened the headline case: #815's body defers to #801, but the maintainer's ruling is in #815's own comment thread and was implemented at e683be072 — so the ruling does live on the pull request and the fix is right. The two untouched sites are confirmed correct: #788 is the PR that implemented issue #778, and #865 is the PR that reviewed issue #862's fix.

Coverage, by a method independent of mine: a raw-text scan over all 224 test modules found 598 kind-adjacent references and no other wrong one, and no number below 349 carries an adjacent kind word, so the sub-300 cutoff hid nothing.

@JarryShaw JarryShaw added review: needs-changes Cross-review at the current head says changes are required; see the verdict comment and removed review: pending No verdict for the current head - never reviewed, or the head moved since the last one labels Oct 3, 2026
…issue (#719)

- Nine citations in tests/ called a pull request "GitHub issue"
  (#921, #764, #906, #815, #936, #721, #501, #983) or lumped PR #428 in
  with issue #425; each now names the right kind.
- test_dispatch_default_resolution_unit: issue #425 reported the registry
  leak and PR #428 fixed it, so the sentence says "reported" and "fixed"
  instead of crediting the issue with the fix.
- Prose only: docstrings and comments, no assertion or logic touched.
@JarryShaw
JarryShaw force-pushed the docs/719-tests-attribution-sweep branch from 19cd484 to 141d4de Compare October 3, 2026 13:44
@JarryShaw JarryShaw added review: pending No verdict for the current head - never reviewed, or the head moved since the last one and removed review: needs-changes Cross-review at the current head says changes are required; see the verdict comment labels Oct 3, 2026
@JarryShaw

Copy link
Copy Markdown
Owner Author

Fixed at 141d4debf — one line, and I verified it is the only change from 19cd484d3.

-defect GitHub issue #425 and pull request #428 fixed at this layer and #560 fixed at the schema
+defect GitHub issue #425 reported and pull request #428 fixed at this layer, and #560 fixed at the schema

#560 confirmed a pull request, so "#560 fixed at the schema layer" is accurate as it stands. Still 9 files, 9 insertions, 9 deletions, one commit on 326a0e5ae, ast.dump identical to main in all 9 files with the non-docstring string constants matching in order, and the nine modules together give 155 passed / 1 skipped / 340 subtests / 0 failures.

While checking the surrounding context I resolved the module docstring's own opening citation: #574 is an issue ("Memoise the default ModuleDescriptor on a registry miss"), so "Regression tests for GitHub issue #574" on line 1 is already correct and stays.

Label back to review: pending — the head moved, so the earlier verdict no longer tracks it. A delta review is running.

@JarryShaw

Copy link
Copy Markdown
Owner Author

GOOD TO GO at 141d4debf — opus delta round. The corrected sentence is true and unambiguous, and the review established the part I could not: #560 really did fix the schema layer — its body adds an _EnumRegistry whose __missing__ returns the default without writing, and #428's own "deliberately not fixed" list names that schema-side follow-up as out of its scope. So all three roles hold: #425 reported, #428 fixed this layer, #560 fixed the schema layer.

On the wording: "pull request #428" is an explicit new subject between "reported" and "fixed", so "reported" cannot bind to both — the only available parse is the intended one.

Also confirmed: delta is one line, whole change still 9 files / 9 / 9, ast.dump identical to main in all nine with non-docstring string constants matching in order and count, nine modules together 155 passed / 1 skipped / 340 subtests / 0 failures, #574 on line 1 is an issue, and line 13's "pull request #563" is correct — #563 is a PR.

Two non-blocking items, and I am correcting one of them before anyone relies on it.

@JarryShaw JarryShaw added review: good-to-go Cross-review at the current head says ready; CI state is separate and removed review: pending No verdict for the current head - never reviewed, or the head moved since the last one labels Oct 3, 2026
@JarryShaw

Copy link
Copy Markdown
Owner Author

Ready to merge at 141d4debf — CI complete: 69 CheckRun legs green, 3 skipped, 0 failures, 0 in flight, mergeStateStatus CLEAN. The opus delta verdict stands at this head; nothing has been pushed since.

Yours to merge. The two items I left out are recorded rather than dropped: line 8 is 105 characters in a file that already has 12 other lines over 80 and no line-length linter, and the #425-versus-#421 lineage question is noted on #719 for the next pass over that file.

@JarryShaw
JarryShaw merged commit 79fce29 into main Oct 3, 2026
73 checks passed
@JarryShaw
JarryShaw deleted the docs/719-tests-attribution-sweep branch October 3, 2026 17:04
@JarryShaw JarryShaw removed the review: good-to-go Cross-review at the current head says ready; CI state is separate label Oct 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Pull requests that change documentation only (docs: subject prefix)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant