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 6ba9bc2
Browse filesBrowse the repository at this point in the historyBrowse files
test(signals): every live A-rule is cited by a test; pin A4 directly
Second gate in scripts/rules-index.mjs --check (run by
tests/rules-index.test.ts): every A-rule not superseded must be cited by
ID from at least one test file. The spec's "Pinned by" column was prose —
a renamed or deleted pin was caught by nothing. Nine A-rules had pins that
never carried the ID (A3 A4 A5 A6 A8 A10 A11 A12 A27); the describe/it
names of those pins now do. A10 was cited in src/ and by no test, which
the earlier "uncited anywhere" list missed.
A4 (a custom equals is never invoked with undefined prev on first commit)
was only covered implicitly — every comparator in equals-comparator-errors
dereferences prev unguarded and the first commit succeeds. It now has a
direct pin that records the comparator's calls: none on first commit, one
with the committed prev on the next write.
Co-authored-by: Cursor <[email protected]>
Copy file name to clipboardExpand all lines: packages/signals/docs/RULES-INDEX.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
22
22
23
23
| vocabulary | rules | cited in src | cited in tests | cited nowhere |
24
24
|---|---|---|---|---|
25
-
| A | 27 | 9 |18|8|
25
+
| A | 27 | 9 |27|0|
26
26
| V | 5 | 2 | 5 | 0 |
27
27
| B | 5 | 0 | 5 | 0 |
28
28
| C | 4 | 0 | 3 | 1 |
@@ -47,16 +47,16 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
47
47
|---|---|---|---|---|---|
48
48
| A1 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:195`| — | onCleanup.test.ts×2 transitionEntanglement.test.ts×4 |[ruled 2026-07-06] Effect error interception is compute-phase only — `EffectBundle.error` intercepts compute-phase errors only; effect-phase throws escalate to the nearest error boundary (halt if none… |
49
49
| A2 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:203`| — | onCleanup.test.ts×2 |[ruled] Unhandled compute-phase errors in user effects are logged and skipped — Compute-phase errors in _user_ effects without a handler are logged and the run is skipped; the system keeps running. |
50
-
| A3 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:211`| — |—|[ruled] Comparator throws are compute-phase errors — Errors thrown by a user `equals` comparator behave exactly like compute-phase errors (boundary-containable; loud halt without a boundary). |
51
-
| A4 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:219`| — |—|[ruled] A custom `equals` never sees `undefined` prev on first commit — A custom `equals` is never invoked with `undefined` previous value on a node's first commit. |
52
-
| A5 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:227`| — |—|[ruled] An error escaping every boundary halts the system — An error escaping every boundary permanently halts the system with `REACTIVITY_HALTED`; later writes log "Update ignored". |
53
-
| A6 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:235`| — |—|[ruled]`ASYNC_OUTSIDE_LOADING_BOUNDARY` is warn-only — `ASYNC_OUTSIDE_LOADING_BOUNDARY` is a warn-only diagnostic; an `Errored` above must not swallow it and must not show its fallback for a pending. |
50
+
| A3 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:211`| — |equals-comparator-errors.test.ts×1|[ruled] Comparator throws are compute-phase errors — Errors thrown by a user `equals` comparator behave exactly like compute-phase errors (boundary-containable; loud halt without a boundary). |
51
+
| A4 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:219`| — |equals-comparator-errors.test.ts×1|[ruled] A custom `equals` never sees `undefined` prev on first commit — A custom `equals` is never invoked with `undefined` previous value on a node's first commit. |
52
+
| A5 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:227`| — |errorHalt.test.ts×1|[ruled] An error escaping every boundary halts the system — An error escaping every boundary permanently halts the system with `REACTIVITY_HALTED`; later writes log "Update ignored". |
53
+
| A6 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:235`| — |enforceLoadingBoundary.test.ts×1|[ruled]`ASYNC_OUTSIDE_LOADING_BOUNDARY` is warn-only — `ASYNC_OUTSIDE_LOADING_BOUNDARY` is a warn-only diagnostic; an `Errored` above must not swallow it and must not show its fallback for a pending. |
54
54
| A7 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:85`| — | spec-async-semantics.test.ts×2 |[ruled] Resolved async never reads `[false, undefined]` — After an async memo resolves, `[isPending(x), latest(x)]` is `[false, resolvedValue]` — never `[false, undefined]`. |
55
-
| A8 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:93`| — |—|[ruled, amended in place 2026-07-07]`isPending(() => latest(x))` follows `x`'s own async only — verdicts are per-channel — (**re-ruled 2026-07-07c** — was "tracks the transition the same as `isPendin… |
55
+
| A8 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:93`| — |createMemo.test.ts×1|[ruled, amended in place 2026-07-07]`isPending(() => latest(x))` follows `x`'s own async only — verdicts are per-channel — (**re-ruled 2026-07-07c** — was "tracks the transition the same as `isPendin… |
56
56
| A9 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:101`| — | spec-async-semantics.test.ts×3 |[ruled, amended in place 2026-07-07] Store leaves behind a firewall report the firewall's new-question refetch — `isPending` on a store leaf behind a firewall reports the firewall's refetch like any a… |
57
-
| A10 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:109`| invariants.ts×1 |—|[ruled]`[isPending(x), x()]` is atomic within one scope — `[isPending(x), x()]` read in one scope is atomic: a reader that observed the fresh value must not see `pending === true` for it. |
58
-
| A11 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:51`| — |—|[ruled] Sync derivations of held sources are visible through `latest()`/`isPending()` — Sync derivations of transition-held sources are visible through `latest()`/`isPending()` (held sync recompute is… |
59
-
| A12 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:117`| — |—|[ruled, amended in place] Resting optimistic nodes report pending like a plain memo — A resting optimistic node reports pending via exactly the causes a plain async memo does (A19) — a reverting optim… |
57
+
| A10 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:109`| invariants.ts×1 |createMemo.test.ts×1 latest-isPending-consistency.test.ts×1|[ruled]`[isPending(x), x()]` is atomic within one scope — `[isPending(x), x()]` read in one scope is atomic: a reader that observed the fresh value must not see `pending === true` for it. |
58
+
| A11 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:51`| — |latest-isPending-consistency.test.ts×1|[ruled] Sync derivations of held sources are visible through `latest()`/`isPending()` — Sync derivations of transition-held sources are visible through `latest()`/`isPending()` (held sync recompute is… |
59
+
| A12 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:117`| — |createOptimistic.test.ts×2 spec-async-semantics.test.ts×1|[ruled, amended in place] Resting optimistic nodes report pending like a plain memo — A resting optimistic node reports pending via exactly the causes a plain async memo does (A19) — a reverting optim… |
60
60
| A13 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:125`| async.ts×1 | spec-async-semantics.test.ts×7 |[ruled 2026-07-06 (promoted from B1)] Resting optimistic ≡ plain async memo at every checkpoint — (was B1) A resting optimistic node (no active override) is observationally identical to a plain async … |
61
61
| A14 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:133`| — | spec-async-semantics.test.ts×2 |[ruled, amended in place 2026-07-06 (promoted from B2)] Companion nodes get child lanes that do not merge with the owner — (was B2) `isPending`/`latest` companion nodes get child lanes that do not mer… |
62
62
| A15 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:167`| core.ts×2 lanes.ts×1 scheduler.ts×1 | lane-hold-on-observation.test.ts×1 reveal-carve-out.test.ts×2 spec-async-semantics.test.ts×2 stale-read-uninitialized-cross-transition.test.ts×1 treeshake.test.ts×3 |[ruled 2026-07-06 (promoted from B3)] Transition entanglement is graph-driven; lanes settle as one reveal — (was B3) Transition entanglement is graph-driven: writes whose async work is observed by a s… |
@@ -71,7 +71,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
71
71
| A24 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:77`| — | optimistic-undefined-override.test.ts×1 reveal-gating-contract.test.ts×1 spec-async-semantics.test.ts×2 |[ruled 2026-07-13] Question-scoped pending: pending iff a value change is in flight or an `affects()` mark is live — (**ruled 2026-07-13** — supersedes A20/A21; the converged model from the #2844/#272… |
72
72
| A25 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:185`| — | uninitialized-visibility.test.ts×3 |[ruled 2026-07-16] A derived store's seed is a draft, never an observable value — (**ruled 2026-07-16**, #2897) **A derived store's seed is a draft, never an observable value.** The seed exists for th… |
73
73
| A26 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:59`| scheduler.ts×1 | action-await-contract.test.ts×2 |[ruled 2026-07-17] An ambient transaction window is one flush; parking is flush-driven — (**ruled 2026-07-17**, #2913; **enforcement hardened 2026-08-31**, #3141 — parking is flush-driven, and a trans… |
74
-
| A27 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:177`| — |—|[ruled 2026-08-10] The commit-#0 loading window is loading-class and verdict-quiet — (**ruled 2026-08-10**) **The commit-#0 loading window is loading-class and verdict-quiet.** A node born committed v… |
74
+
| A27 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:177`| — |loading-value.test.ts×2|[ruled 2026-08-10] The commit-#0 loading window is loading-class and verdict-quiet — (**ruled 2026-08-10**) **The commit-#0 loading window is loading-class and verdict-quiet.** A node born committed v… |
75
75
## V — fixed violations
76
76
77
77
| id | status | defined | cited in src | cited in tests | statement (at definition) |
0 commit comments