[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?

• fix — corrects a defect

---

Description

Closes #2164.

• Defect: util/run_unittest_leg.py's default stall dump, 1080s, is sized for unittest-ordering's 20-minute step. The project-tests step "Run tests/project and the root-level modules under plain unittest" is capped at 15 minutes and passed nothing, so a hang there is killed before the dump fires.
• Fix: that step passes --stall-dump 840. The script's docstring says a step with a shorter cap passes its own; its code is unchanged.
• Test: TestEveryStepDumpsBeforeItsCap in tests/project/test_run_unittest_leg_stall_dump.py. For every workflow step that runs the script, it resolves the dump the script would use (flag, then env at step/job/workflow level, then default) and asserts it is above 0 and below the step's or job's timeout-minutes. On main it fails with 1080.0 not less than 900.0.
• Checks: actionlint 1.7.12 is clean on unit-tests.yml. The tests/project files that name the workflow or script pass (807).
• Overlap: docs(repo): fifth whole-repo pass over the repository files (#1103) #2158 rewords another part of the same docstring. Whichever merges second needs a docstring-only rebase.

[JarryShaw]

Review: GOOD TO GO at 0f231fa26 (Sonnet): the step's 15-minute cap and the 1080s default are as described, the flag beats env and default in the script's argparse, the new test covers both steps that run the script and fails on main with 1080.0 not less than 900.0, and actionlint is clean.

[JarryShaw]

Ready to merge at 0f231fa26. Merging closes #2164.

• Review: Sonnet GOOD TO GO.
• CI: Required checks passed SUCCESS, 0 failed. Still open: the board's Sync Status.
• KTLO: 12 legs, no warnings.
• Ordering: project leg merged into main: 2289 tests, 0 failures.
• Overlap: docs(repo): fifth whole-repo pass over the repository files (#1103) #2158 rewords another hunk of the same util/run_unittest_leg.py docstring. Whichever merges second gets a docstring-only rebase.

[github-actions]

Coverage: 91.55% (unit tier, Python 3.15, 0f231fa26, Unit Tests run success)

Package	Statements	Missed	Branches	Partial	Cover
pcapkit (top level)	104	4	20	2	95.16%
pcapkit/const	19599	880	2618	866	92.12%
pcapkit/corekit	2589	75	816	37	96.48%
pcapkit/dumpkit	282	3	102	3	98.44%
pcapkit/foundation	2971	23	1036	25	98.80%
pcapkit/interface	138	4	52	3	96.32%
pcapkit/protocols	17418	219	4574	185	98.14%
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]

Rebased onto main after #2158 merged: 0f231fa26 → badfc34fd.

• Conflict: the stall-dump sentence in util/run_unittest_leg.py's docstring, which docs(repo): fifth whole-repo pass over the repository files (#1103) #2158 had reworded. I kept docs(repo): fifth whole-repo pass over the repository files (#1103) #2158's wording ("the unittest-ordering step's 20-minute cap") and added this PR's clause: a step with a shorter cap passes its own (fix(ci): project-tests' 15-minute cap kills run_unittest_leg.py before its 1080 s stall dump can fire #2164).
• Unchanged: the unit-tests.yml flag and the test. git range-diff shows only that docstring hunk moving.
• Checks: with docstrings stripped, the file's AST matches main. The stall-dump test and every tests/project file reading unit-tests.yml or the script pass, with the tier guard and the docstring contract (807).
• Old head: Sonnet GOOD TO GO, Required checks passed SUCCESS.

The patch changed only in a docstring line, but CI must re-run on the new head. A delta check follows.

[JarryShaw]

Review: GOOD TO GO at badfc34fd (Sonnet delta): after the rebase only the docstring hunk differs, it still matches the 20-minute step cap, and the stall-dump test plus actionlint both pass.