[JarryShaw]

• Searched for similar pull requests
• Followed the coding style
• make test passes, and a test case covers the change
• Changelog entry: N/A — centralised in docs(changelog): shared 1.5.0 changelog — long-lived, merges last (#610, #616, #617, #618, #620) #657

What is the purpose of your pull request?

• docs — documentation only

---

Description

Part of #1103, round 6: the sixth whole-repo prose pass over every tests/ directory except protocols, vendor, const and integration: tests/project, foundation, corekit, cli, dumpkit, interface, toolkit, utilities and the root modules.

• Seeds: the pre-design: write down what belongs in the all extra, and why #910 engine set in test_conventions_doc_claims, and the two pre-fix condition texts in test_release_gates. Also the third-party Sphinx roles.py and rfc8200.txt line citations, now by name, and the counts in tests/project docstrings.
• Change-relative narrative is stated as current or conditional behaviour: "before the fix", "as before", "since/until #NNN", "earlier revision", "first draft", "Round 2/3" and "pre-toolkit: pyshark link-type resolution silently returns a wrong DLT for ppp, null, lapd and raw #843".
• Counts: dropped where they counted registrars, sentinels, sites, legs or siblings. Two unpinned measurements in _raised_names and test_rfc_anchor_fragments went with them. Commit-pinned measurements stay.
• Stale claims:
  • "Three properties" where four are listed.
  • The 3.10/3.14 host claims.
  • "ubuntu-latest moves to 26.04".
  • Stale KNOWN_DEFECTS text.
  • A broken role continuation.
• References: :issue: becomes #NNN in 9 places, since tests are not rendered.
• Scope: comments and docstrings only. With docstrings stripped, all 136 files have the same AST as main.
• Tests run:
  • The text-reading tests give 190 passed.
  • The changed tests/project and root modules, plus every test_docs_*, give 1571 passed.
  • The other changed modules give 941 passed.
• Untouched: test names, labels and messages, which are code; the *_parses_as_python_3_8 docstrings (test(project): ast feature_version=(3, 8) accepts 3.9–3.12 syntax, so the util floor tests under-check #2206); GH-NNN.
• Overlap: ci(compat): compile the 3.8-floor util scripts on the 3.8 leg (#2206) #2214 shares test_ktlo_legs_stay_green_1672.py, and git merge-tree merges the two cleanly.

[JarryShaw]

Review: GOOD TO GO at b0721967b (Sonnet).

• Accuracy: 13 large files and 8 sampled files were read in full, with no claim changed. "These properties" (four are listed), the ubuntu-latest and host-interpreter rewrites, and the pre-design: write down what belongs in the all extra, and why #910 and pre-fix seeds are all faithful.
• Dropped unpinned counts: correct under the no-counts rule, and the conclusions stay. Re-derived: pcapkit/ has 2 Attribute raise targets and no Subscript. Commit-pinned measurements all survive (f4f94bcad, run 38325136710, job 118912680486).
• AST guard: OK on 136 files. No banned tokens or :issue: roles in the added lines.
• Tests: 74 non-project files give 1119 passed. The tests/project files give 1472 passed and 16 failed, with 4 errors. All the failures and errors are in five files that run workflow shell steps (gnu_timeout_2020, graalpy_shards_1963, resource_monitor_1740, superseded_runs_1938, sweeps_on_latest_only_1732). Those same failures and errors occur on origin/main on this host, so they are host-environment failures, not caused by this PR.
• Not blocking: an awkward "from before ci: divide and simplify the workflows into scripts, shared heads and smaller files #1967" in test_ktlo_legs_stay_green_1672.

[github-actions]

Coverage: 91.56% (unit tier, Python 3.15, b0721967b, Unit Tests run success)

Package	Statements	Missed	Branches	Partial	Cover
pcapkit (top level)	104	4	20	2	95.16%
pcapkit/const	19599	881	2618	867	92.11%
pcapkit/corekit	2589	74	816	37	96.51%
pcapkit/dumpkit	282	3	102	3	98.44%
pcapkit/foundation	2994	23	1038	25	98.81%
pcapkit/interface	138	4	52	3	96.32%
pcapkit/protocols	17433	218	4584	185	98.15%
pcapkit/toolkit	869	36	298	10	95.20%
pcapkit/utilities	504	7	146	5	98.15%
pcapkit/vendor	4432	1988	1018	167	51.87%

Per-file detail: the coverage-html artifact of this run.

[JarryShaw]

Ready to merge at b0721967b. Part of #1103 (round 6).

• Review: Sonnet GOOD TO GO, first round.
• CI: all checks complete, Required checks passed SUCCESS, 0 failed.
• KTLO: 12 legs, no warnings.
• Ordering: merged into main and run. project: 2298 tests, foundation: 740 and corekit: 924, 0 failures.
• Conflicts: none against the current main. ci(compat): compile the 3.8-floor util scripts on the 3.8 leg (#2206) #2214 shares test_ktlo_legs_stay_green_1672.py, and git merge-tree merges the two cleanly.