solidjs / solid / 34880295542

71%

main: 89%

push

github

docs(signals): rules index, async spec reorganized by topic, superseded text separated from live rules (#3432)

* docs(signals): rules index — every cited rule ID resolves; recover the stage-3 node-shape sections

Source comments in @solidjs/signals cite rule IDs from six vocabularies:
A<n> (spec), V<n> (fixed violations), INV-<n> (invariants), RUL-<n> (store
rulings), R<n> (rules-mining — five files that EACH number from R1, so a
bare R<n> is ambiguous five ways) and §<n> (design sections). Six citations
resolved to nothing: §11b, §12, §12b, §12c, §12d, §12e were entries in the
Stage-3 increment log of DESIGN-PATCH-CHANNEL.md — the patch-channel journal
that was carried into the monorepo only from §17 and deleted with the
feature (d6011192) — and INV-8 was a retired invariant whose definition
had gone with its mechanism.

- docs/NODE-SHAPE.md: the stage-3 node-shape decisions restored under their
  original numbers — §11b presence bits, §12 cold-field extension, §12b
  zombie pair + plain-commit fast drain, §12c what stays in the core
  literal (recovered from packages/solid-signals/DESIGN-PATCH-CHANNEL.md at
  3a505c7a); §12d staged-rewrite fast path and §12e signal-literal diet
  reconstructed from the code comments that cite them, marked as such.
- INTERNALS-ASYNC-STATE.md: INV-8 entry (RETIRED 2026-07-07b) recording
  what the hold-provenance invariant proved before revert targets were
  eliminated, so invariants.ts's citation resolves.
- docs/RULES-INDEX.md (generated): 305 rules across the six vocabularies
  with status (live / ruled / amended / superseded / retired / fixed /
  promoted), definition site, and src/test citation counts; R-ids
  namespaced CS/OL/OS/PJ/RS without renumbering (comments qualify with
  core/opt/proj/snap; a bare R<n> resolves to the citing module's file,
  else core-store); tier ids promoted into A-rules ("(was B1)") resolve to
  the row they became.
- scripts/rules-index.mjs generates it; --check fails on any src/ ci... (continued)

519 of 790 branches covered (65.7%)

Branch coverage included in aggregate %.

772 of 1007 relevant lines covered (76.66%)

15.01 hits per line