Skip to content

Commit 194a13f

Browse files
docs(trials): align resume semantics with grader_error regrade path
Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 5603922 commit 194a13f

2 files changed

Lines changed: 8 additions & 4 deletions

File tree

docs/model-trial-taxonomy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ execution_error), no measurement failures. 3 = any measurement failure; dominate
3737
brigade run exit-3).
3838

3939
## Regrade
40-
brigade model trials regrade <output-dir> re-runs graders against stored run/final.txt (verified
40+
brigade model trial regrade <output-dir> re-runs graders against stored run/final.txt (verified
4141
against output_digest) without re-running seats. Resume treats grader_error as regradeable.
4242

4343
## grader_result.v1: exit_code removed

docs/phase-eval-cell-identity.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,9 +51,13 @@ exact payload keys and the resulting digest, so an accidental change fails CI.
5151
`execute --resume` rebuilds the plan from the current manifest and decides per
5252
cell from the recorded `cell.json`:
5353

54-
- `accepted`, `rejected`, `unscored`, `execution_error`, `adapter_error`,
55-
`grader_error` (the terminal states): the cell is **skipped**; the existing
56-
receipt stands.
54+
- `accepted`, `rejected`, `unscored`, `execution_error`, `adapter_error`
55+
(terminal, non-regradeable): the cell is **skipped**; the existing receipt
56+
stands.
57+
- `grader_error` (terminal, regradeable): graders are **re-run** against the
58+
stored `run/final.txt` (verified against `output_digest`); the seat is not
59+
re-executed. Use `brigade model trial regrade` for the same path outside
60+
resume.
5761
- `running`: the cell **re-runs as a new attempt**. `running` means the
5862
previous process died mid-run (or, without a lock, is still executing in
5963
another process). Resume treats it as a crash and starts the next attempt,

0 commit comments

Comments
 (0)