Skip to content

Commit db5e680

Browse files
committed
docs: document ready-mode integrity checks
1 parent 33f322d commit db5e680

1 file changed

Lines changed: 7 additions & 2 deletions

File tree

docs/release-config-validation.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,10 @@ python tools/validate_release_config.py \
3333

3434
Ready mode additionally checks:
3535

36-
- required metadata and gate fields do not contain placeholders;
36+
- no placeholder string remains anywhere in the supplied record, including nested decision lists, evidence references, findings, and follow-through fields;
37+
- `metadata.version` is a stable token rather than free-form prose;
38+
- `metadata.evidence_cutoff` is a valid ISO date in `YYYY-MM-DD` form;
39+
- the decision includes a non-empty rationale;
3740
- at least one gate exists;
3841
- passing and not-applicable gates cite evidence;
3942
- not-applicable gates contain a scoped rationale;
@@ -44,6 +47,8 @@ Ready mode additionally checks:
4447
- deferred decisions identify evidence gaps;
4548
- do-not-release decisions identify a blocker or unresolved hard gate.
4649

50+
The version rule allows letters, digits, `.`, `_`, `+`, and `-`; it does not require semantic versioning. The purpose is to make the reviewed configuration identifiable and stable enough to compare with its evidence.
51+
4752
## Semantics
4853

4954
The configuration distinguishes:
@@ -71,7 +76,7 @@ The validator checks internal coherence. It does not determine whether:
7176
python -m unittest discover -s tests -v
7277
```
7378

74-
The tests cover blocker, condition, hard-gate, evidence, placeholder, deferred-decision, and duplicate-ID semantics.
79+
The tests cover blocker, condition, hard-gate, evidence, nested-placeholder, date, version, deferred-decision, and duplicate-ID semantics.
7580

7681
## Customization
7782

0 commit comments

Comments
 (0)