diff --git a/docs/comprehension-history.md b/docs/comprehension-history.md index 8c0bc38..c7a53cc 100644 --- a/docs/comprehension-history.md +++ b/docs/comprehension-history.md @@ -24,3 +24,28 @@ Inherited architect, decided by: - `src/markdown/parse/markdown-to-adf.ts:113` `readBlock`: branches name the claim (`claims.alerts`, `claims.taskMarkers`) - `src/index.ts:5` exports: flavour names say which file to open - `src/markdown/portable/conventions.ts:3` `flavourClaims`: cost, all three flavours' rows live under `portable/` + +## 2026-10-09T00:56:04Z, PR #19 at 5fc877e, against 9519606 + +Ruling: better + +| Seat | Vote | +|---|---| +| Mid A | better | +| Inherited architect | better | + +Mid A, decided by: + +- `src/markdown/portable/conventions.ts:8` `flavourClaims`: one table says what each flavour reads; every gate reads a named field +- `src/markdown/portable/task-ids.ts:7` `mintTaskIds`: one pass, no carried set crossing modules +- `src/index.ts:5` exports: each name says which markdown it means +- `src/markdown/parse/markdown-to-adf.ts:161` `quoteNode`: no reach into the portable writer's reduction +- `src/markdown/portable/conventions.ts:20` `ReadClaims`: cost, `directiveNode` leans on a type in another file + +Inherited architect, decided by: + +- `src/markdown/portable/task-ids.ts:6` `mintTaskIds`: the retry loop and the parser-filled set are gone +- `src/markdown/parse/markdown-to-adf.ts:26` `Reading`: no hidden state; branches name the feature they gate +- `src/markdown/portable/conventions.ts:8` `flavourClaims`: cost, the table for all three flavours lives under `portable/` +- `src/markdown/emit/line-escaping.ts:92` `escapeClaims`: directive escaping under the flag the parser checks +- `src/markdown/emit/adf-to-markdown.ts:146` `spellPortableBlock`: no hard-coded lossless title