Commit 1b67f3a
docs(semantics): name what measures each target surface, not a snapshot of it
Section 11's target table gives a frozen baseline and an end state, and nothing
says how a reader finds the current value. The first version of this PR filled
that gap with a dated `Measured 2026-09-17` column. That was the wrong fix, for
two reasons this rework removes.
It was in the wrong place. The document map says Section 11 is the normative
delivery plan and that "dated progress entries do not amend normative sections",
and issue #4447 owns delivery status. A dated column inside the normative table,
carrying a note claiming it is not normative, argues with the maintenance
contract instead of following it.
It was also redundant work with a failure mode. Eight of the ten surfaces are
already printed by the drift smoke on every run -- `same_runtime_forks_semantic`,
`multi_value_twins`, one `<field>.py` / `<field>.ts` pair per legacy field,
`independently_maintained`. A hand-written column transcribes output a command
already produces, goes stale on the next merge, and invites exactly the error
the first version shipped: a merge-candidate count copied from a raw grouping
without the registry filter the surrounding numbers carry.
So the column now names the command and field that measure each surface, the
way Section 9 names a test for each claim, and carries no values at all. A
reader who wants the current state runs the command. Two surfaces honestly say
no counter exists: the `effective_action` slot split is a Q6 decision, and
merge candidates are only reachable through `merge_candidate_groups()` because
no command prints them yet. Where a capability is not on `main`, the cell says
which PR adds it rather than describing it as present.
Dated values stay in issue #4447, which the RFC already designates as the owner
of delivery status.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: song <22676124+songoow@users.noreply.github.com>1 parent 0a23e1c commit 1b67f3a
2 files changed
Lines changed: 45 additions & 24 deletions
File tree
- docs/architecture/rfcs
Lines changed: 24 additions & 12 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
848 | 848 | | |
849 | 849 | | |
850 | 850 | | |
851 | | - | |
852 | | - | |
853 | | - | |
854 | | - | |
855 | | - | |
856 | | - | |
857 | | - | |
858 | | - | |
859 | | - | |
860 | | - | |
861 | | - | |
862 | | - | |
| 851 | + | |
| 852 | + | |
| 853 | + | |
| 854 | + | |
| 855 | + | |
| 856 | + | |
| 857 | + | |
| 858 | + | |
| 859 | + | |
| 860 | + | |
| 861 | + | |
| 862 | + | |
| 863 | + | |
| 864 | + | |
| 865 | + | |
| 866 | + | |
| 867 | + | |
| 868 | + | |
| 869 | + | |
| 870 | + | |
| 871 | + | |
| 872 | + | |
| 873 | + | |
| 874 | + | |
863 | 875 | | |
864 | 876 | | |
865 | 877 | | |
| |||
Lines changed: 21 additions & 12 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
697 | 697 | | |
698 | 698 | | |
699 | 699 | | |
700 | | - | |
701 | | - | |
702 | | - | |
703 | | - | |
704 | | - | |
705 | | - | |
706 | | - | |
707 | | - | |
708 | | - | |
709 | | - | |
710 | | - | |
711 | | - | |
| 700 | + | |
| 701 | + | |
| 702 | + | |
| 703 | + | |
| 704 | + | |
| 705 | + | |
| 706 | + | |
| 707 | + | |
| 708 | + | |
| 709 | + | |
| 710 | + | |
| 711 | + | |
| 712 | + | |
| 713 | + | |
| 714 | + | |
| 715 | + | |
| 716 | + | |
| 717 | + | |
| 718 | + | |
| 719 | + | |
| 720 | + | |
712 | 721 | | |
713 | 722 | | |
714 | 723 | | |
| |||
0 commit comments