Repository navigation
Commit d1a0cfe
committed
docs(adr): generated README index, one status-line spelling, shared numbers cited by stem
docs/adr/README.md is now generated by scripts/adr-index.mjs from the records
themselves: status keyword, number, title, date, supersedes / superseded-by,
read from ONE status-line spelling (`**Status**: `). 17 records that spelled
the line another way (`- **Status:**`, `## Status`, `- **状态**:`) are
normalized to it; nothing else in them changes. The four numbers carried by
more than one file (0006 by three versions of one decision; 0010, 0019, 0057
by two unrelated decisions each) are listed side by side in the index and
cross-referenced in each record's header. Nothing is renumbered or moved
(AGENTS.md Prime Directive 13).
check-adr-anchors.mjs becomes unambiguous on those four: a citation may name
the record by its filename stem (`ADR-0057-system-data-lifecycle-and-retention`,
`ADR-0006-project-environment-split.v4`), which resolves to exactly one record;
a stem that names none is an error, a bare number keeps its existing meaning.
The 36 stem-qualified citations in the tree all resolve.
The index script carries a --self-test (46 assertions, 7 pinned batteries) and
is called REPORT-ONLY from the existing lint ADR step via `pnpm adr:index:report`:
a stale index or an unreadable record is a warning annotation, never a red
(maintainer ruling A: 门禁不加). `pnpm adr:index` regenerates.
ui/docs/adr (objectui's own sequence, #26080) is registered in the root index
under the `ui-` prefix with its files untouched; a citation keeps the
`ObjectUI ADR-NNNN` spelling. docs/adr/PRIORITIZATION.md, self-declared retired,
is removed; the one rule it still carried (status hygiene on landing an
implementation) lives in the index's Conventions block, and ADR-0110's pointer
to it now names the README.
Claude-Session: https://claude.ai/code/session_01WGufzgAZv5vcb4H6qvqBAM
Co-authored-by: Claude <noreply@anthropic.com>1 parent 07586f5 commit d1a0cfe
33 files changed
Lines changed: 1436 additions & 84 deletions
File tree
- .github/workflows
- docs/adr
- scripts
- pm
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
604 | 604 | | |
605 | 605 | | |
606 | 606 | | |
| 607 | + | |
| 608 | + | |
| 609 | + | |
| 610 | + | |
| 611 | + | |
| 612 | + | |
| 613 | + | |
| 614 | + | |
| 615 | + | |
| 616 | + | |
| 617 | + | |
607 | 618 | | |
608 | 619 | | |
609 | 620 | | |
610 | | - | |
| 621 | + | |
| 622 | + | |
| 623 | + | |
| 624 | + | |
611 | 625 | | |
612 | 626 | | |
613 | 627 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
| 6 | + | |
6 | 7 | | |
7 | 8 | | |
8 | 9 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
4 | 5 | | |
5 | 6 | | |
6 | 7 | | |
| |||
0 commit comments