Skip to content

Commit a3aed7d

Browse files
committed
docs(spec): the liveness README's author-warning section states the verdict model the lint ships
A dead, live-elsewhere or experimental ledger row warns its author on its own; authorWarn only opts a planned row in. Every warning shows the row's authorHint or the verdict's default hint, never the note. Rule 1 is restated for the verdict, rule 2 for any materialized schema default, and the coverage paragraph names the walk's real reach. Two sentences elsewhere in the README that tied a dead row's warning to authorWarn are corrected. Claude-Session: https://claude.ai/code/session_01UtnxvdiN376GF3sgXwAw4d Co-authored-by: Claude <noreply@anthropic.com>
1 parent 535d1d2 commit a3aed7d

2 files changed

Lines changed: 82 additions & 31 deletions

File tree

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
"@objectstack/spec": patch
3+
---
4+
5+
Liveness ledger README: the "Author warnings" section now describes the model the liveness lint ships. A `dead`, `live-elsewhere` or `experimental` verdict warns on its own, and `authorWarn` only opts a `planned` row in.
6+
7+
Clause-②: no
8+
9+
- The section said warnings were opt-in per ledger row, and that only `experimental` warned without the marker. That stopped being true when the lint made a `dead` or `live-elsewhere` verdict warn on its own. The section now has one table of which verdicts warn, and under which rule id.
10+
- `authorHint` no longer "falls back to `note`". Every warning shows the row's `authorHint`, or else the verdict's default hint. The `note` never reaches an author.
11+
- Rule 1 now talks about the verdict, not the marker. Grading a row `dead`, `live-elsewhere` or `experimental` warns every author who sets the key, and fails their `os lint --strict` / `os validate --strict` run. No marker keeps it quiet, so a benign display key is measured against the designer-previews ruling before it is graded `dead`.
12+
- Rule 2 (booleans) now covers any key whose schema default materializes. It no longer points at an `_authorWarnSkipped` marker, which no ledger carries.
13+
- The coverage paragraph states the walk's real reach: the types it visits, one level of `children`, and that a governed type it does not visit warns no author through this lint.
14+
- Two sentences elsewhere in the README said a `dead` row needs `authorWarn` to warn. Both are corrected the same way.
15+
- ⛔ Documentation only: no ledger row, schema, export or lint behaviour changes.

0 commit comments

Comments
 (0)