You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit dbaeb81
Browse filesBrowse the repository at this point in the historyBrowse files
docs(agents): say a production source change runs the unit suite locally
Under "Interpret selection", state that related tests replace only provider integration and
that a production source change also runs the unit suite, because some unit gates read sources
as text. To stay within the agent-docs budget, three lists become sentences and two sentences
that repeat tool output are removed.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Copy file name to clipboardExpand all lines: docs/agents/testing.md
+8-26Lines changed: 8 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,21 +10,14 @@
10
10
Serialized validation requires macOS or Linux.
11
11
On Windows, use plan mode or focused checks.
12
12
Both broad commands and heavy `pnpm gate` ids acquire the same host lock.
13
-
Wait for the owner to finish, or cancel your waiter with Ctrl-C.
13
+
Wait for the owner to finish.
14
14
Do not add lock wrappers. Do not delete lock files.
15
-
A wait ends after two hours. Nested validation fails immediately.
15
+
A wait ends after two hours.
16
16
Focused tests do not lock. Avoid subprocess-heavy tests beside a broad gate.
17
17
18
-
The runner prints progress and a receipt path. The receipt contains:
18
+
The runner prints progress and a receipt path. The receipt contains refs, checkout state, command logs, exits, skips, and Vitest results.
19
19
20
-
- Refs.
21
-
- Checkout state.
22
-
- Command logs.
23
-
- Exits.
24
-
- Skips.
25
-
- Vitest results.
26
-
27
-
Execution stops at the first failure. Unexecuted checks remain `not-run`.
20
+
Execution stops at the first failure.
28
21
29
22
-`pnpm check:affected`: compact plan.
30
23
-`pnpm check:affected --verbose`: plan with selection reasons.
@@ -47,15 +40,9 @@ Do not reduce selection to get a pass.
47
40
48
41
Read required-check status on the PR.
49
42
The receipt lists skipped checks and owners in `results[].reason`.
50
-
GitHub owns:
51
-
52
-
- Full coverage.
53
-
- Native builds.
54
-
- Device lanes.
55
-
- Provider integration.
56
-
- Compatibility that uses history.
57
-
58
-
Related tests do not replace those obligations.
43
+
GitHub owns full coverage, native builds, device lanes, provider integration, and compatibility that uses history.
44
+
Locally, related tests replace only provider integration.
45
+
A production source change also runs the unit suite (about 3 minutes), because some unit gates read sources as text.
59
46
Check the Integration Tests and Coverage jobs at the actual PR head.
60
47
For docs-only changes, run the selected documentation checks.
61
48
Do not add tests that assert prose.
@@ -73,12 +60,7 @@ Never call a failing gate passed.
73
60
| Base comparison unavailable or inconclusive | Record the missing tool/device/evidence and next action. | Blocked, cause unproven. An authorized draft can record this. |
74
61
| Failure source fixed, environment repaired, or new upstream commit contains the fix | Run the failing check. Then run the affected gate on the current head. | Replace blocked status only with new evidence. |
75
62
76
-
Match failures by:
77
-
78
-
- Check.
79
-
- Location.
80
-
- Diagnostic code.
81
-
- Assertion.
63
+
Match failures by check, location, diagnostic code, and assertion.
82
64
83
65
Until a named owner or issue accepts the blocker, the implementing agent owns diagnosis.
0 commit comments