3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-19 14:45:44 +01:00

Answer architecture round 6: each block is held to the bound as it is built, the reader's ask takes the engine guard, and the chunk ships under a worse comprehension ruling by the maintainer's call, with item 110 to fill the memo in one place

This commit is contained in:
2026-10-13 00:39:39 +02:00
committed by Lillem4n
parent 6f518dab93
commit 7caa8237f0
10 changed files with 120 additions and 64 deletions
+53
View File
@@ -627,3 +627,56 @@ Inherited architect, decided by:
- Locality, Shape: `src/markdown/emit/block-directive-spelling.ts:27` `spellBlockDirectiveOpener`: the opener's layout is known here and in `spellDirectiveOpener`
- Shape: `src/markdown/portable/adf-to-portable-markdown.ts:231` `reduceCodeBlock`: an ADF-to-ADF reducer carries a markdown length bound through a callback
- Navigation: `src/markdown/length-bound.ts:41` `withinEngineLimits`: a too-long refusal leads straight to one small, well-named module
## 2026-10-12T19:45:45Z, PR #36 at 1f4551a, against 7a27f6b
Ruling: worse
Fell: Locality. Under the floor of 7.0: Locality 5.13, so the same ruling counts as worse.
| Seat | Navigation | Locality | Shape | Self-sufficiency | Overall |
|---|---|---|---|---|---|
| Mid A | better | worse | better | same | same |
| Inherited architect | better | worse | better | same | same |
| Seat | Navigation | Locality | Shape | Self-sufficiency | Overall |
|---|---|---|---|---|---|
| Junior A | 6.5 | 5 | 6 | 5.5 | 5.5 |
| Mid A | 7 | 5 | 6 | 5 | 5.5 |
| Maintainability senior | 7 | 5.5 | 6.5 | 6 | 6 |
| Inherited architect | 6.5 | 5 | 5.5 | 6.5 | 5.5 |
| Mean | 6.75 | 5.13 | 6.00 | 5.75 | 5.63 |
Mid A, decided by:
- Locality: `src/markdown/emit/adf-to-markdown.ts:114` `commonMarkSpelling`: the memo is filled here and read-and-deleted in `readableBlock`, a write-once, read-once protocol whose order is set in another module
- Locality: `src/markdown/emit/adf-to-markdown.ts:52` `writeMarkdown`: one rule, output past `longestMarkdown` is refused, is checked in six places with different triggers
- Navigation, Shape: `src/markdown/length-bound.ts:1` `tooLong`: a too-long refusal leads to one small module holding the bound, its message and the engine guard
- Shape: `src/canonical-json.ts:23` `canonicalJsonPieces`: a generator replaces a boolean-returning callback, and both readers become plain loops
- Shape, Locality: `src/markdown/portable/adf-to-portable-markdown.ts:128` `portableSequence`: a refused spelling is returned where it is produced, and each block carries its own path
- Shape: `src/markdown/emit/inline-line.ts:235` `emitLeaf`: one content-or-text check, and the path is built only to refuse
Inherited architect, decided by:
- Locality: `src/markdown/emit/adf-to-markdown.ts:114` `commonMarkSpelling`: filling and consuming the memo split across an exported predicate and a private reader, a consume-once protocol among three callers
- Locality: `src/markdown/emit/adf-to-markdown.ts:52` `writeMarkdown`: one bound enforced at five sites in four files, and a new builder has nothing nearby saying whether it needs a check
- Navigation, Shape: `src/markdown/length-bound.ts:1` `withinEngineLimits`: an output-too-long symptom leads straight to a module named for it
- Navigation: `src/markdown/parse/markdown-to-adf.ts:47` `readDocument`: the parse takes the same guard as both writers
- Shape: `src/canonical-json.ts:23` `canonicalJsonPieces`: plain loops replace a boolean-returning callback
- Shape: `src/markdown/emit/inline-line.ts:235` `emitLeaf`: both leaf emitters return a plain emission, the path built only on refusal
Junior A, hardest first:
- Locality: `src/markdown/emit/adf-to-markdown.ts:114` `commonMarkSpelling`: a mutable memo shared by three walks, deleted on read and rebased by depth
Mid A, hardest first:
- Locality: `src/markdown/emit/adf-to-markdown.ts:125` `readableBlock`: shared mutable state with no single owner, parse and emit coupled both ways
Maintainability senior, hardest first:
- Locality: `src/markdown/emit/adf-to-markdown.ts:114` `commonMarkSpelling`: the parser and the portable reducer call into the emitter and share a reference-keyed, delete-on-read memo
Inherited architect, would restructure first:
- Locality: `src/markdown/emit/adf-to-markdown.ts:126` `readableBlock`: the memo is mutated and deleted across parse, emit and portable, and the length bound is applied at five sites
+26 -21
View File
@@ -604,17 +604,22 @@ A four-seat comprehension panel scored the project under the floor of 7. Its sco
| Mean | 6.88 | 5.63 | 6.25 | 5.63 | 6.00 |
Panels on near-identical code scored overall means of 5.75 to 6.00, and a seat moves ±0.5 between
runs. The maintainer shipped under a fall twice after three rounds: the move to GitHub,
2026-10-04, whose chunk changed only comments in `src/`; and item 78, 2026-10-07, whose three runs
fell below the run before it on Navigation, Locality and Shape while the overall held. Item 94,
2026-10-10, also shipped after three rounds: a definitions-only paragraph leaves no block, so ending
the list it follows takes state carried across lines, and every design read worse on Locality while
the overall held; the scores at 6182ba6 were Junior 5.5, Mid 5.5, Senior 6 and Architect 5.5, mean
5.63. Item 56, still open, is to give that state one owner. Items 85 and 86, 2026-10-11, shipped
after three rounds under a fall the seats laid on item 93's `splitPath` and `splitPlace`, which
place a refused block's path by replaying `splitTaskList` on stand-in nodes; both seats read the
chunk's own image builder as a gain. The scores at be23835 were Junior 6.5, Mid 6, Senior 6 and
Architect 6, mean 6.13. `todo.md` item 102 is to place that path without the replay.
runs. The maintainer shipped under a fall twice after three rounds: the move to GitHub, 2026-10-04,
whose chunk changed only comments in `src/`; and item 78, 2026-10-07, whose three runs fell below
the run before it on Navigation, Locality and Shape while the overall held. Item 94, 2026-10-10,
also shipped after three rounds: a definitions-only paragraph leaves no block, so ending the list it
follows takes state carried across lines, and every design read worse on Locality while the overall
held; the scores at 6182ba6 were Junior 5.5, Mid 5.5, Senior 6 and Architect 5.5, mean 5.63. Item
56, still open, is to give that state one owner. Items 85 and 86, 2026-10-11, shipped after three
rounds under a fall the seats laid on item 93's `splitPath` and `splitPlace`, which place a refused
block's path by replaying `splitTaskList` on stand-in nodes; both seats read the chunk's own image
builder as a gain. The scores at be23835 were Junior 6.5, Mid 6, Senior 6 and Architect 6, mean
6.13. `todo.md` item 102 is to place that path without the replay. Item 106, 2026-10-13, shipped
after three rounds under a worse ruling, the maintainer's call: both paired seats read the overall
as the same, but Locality fell to a mean of 5.13, laid on the spelling memo the chunk splits between
the CommonMark ask, which fills it, and the walk, which drops each entry as it reads it. The scores
at 1f4551a were Junior 5.5, Mid 5.5, Senior 6 and Architect 5.5. `todo.md` item 110 is to fill and
read the memo in one place.
## Properties on a fixed seed
@@ -669,17 +674,17 @@ Every writer, and the reader's CommonMark ask, refuses markdown longer than 2^29
converts alike everywhere. A writer first refuses a document whose text alone passes the bound: the
lossless writer spells every character of it, and the portable reduction refuses on the caller's
text, edge whitespace and all, since merging that text first could build past the bound. The
builders join as they always did, and the writer's result and the CommonMark ask's spelling are held
to the bound once built. V8 stops at the bound itself and SpiderMonkey at its own longest string,
and `withinEngineLimits` refuses both throws as the same `tooLong`, so every engine answers alike.
The carry's two-space JSON, which indents every value its depth over, stops at the bound unbuilt
(`joinedWithin`). A deep list or quote re-indents its whole text at each level before the bound
refuses it (`todo.md` item 109).
builders join plain strings, and each block, the writer's result and the CommonMark ask's spelling
are held to the bound as they are built. V8 throws building the same string past the bound,
SpiderMonkey past its own longest string, and `withinEngineLimits` refuses both throws as the same
`tooLong`, so every engine stops at the same block with the same answer. The carry's two-space JSON,
which indents every value its depth over, stops at the bound unbuilt (`joinedWithin`). A deep list
or quote re-indents its whole text at each level before the bound refuses it (`todo.md` item 109).
JavaScriptCore builds up to its own longest string, 2^31 − 1, before the check. A throw past that,
past any engine's longest array, or JavaScriptCore's `Out of memory`, which also reports a heap
running short, is refused with the engine's message. `todo.md` item 108 bounds the line's own
memory.
JavaScriptCore builds a joined block up to its own longest string, 2^31 − 1, before the check. A
throw past that, past any engine's longest array, or JavaScriptCore's `Out of memory`, which also
reports a heap running short, is refused with the engine's message. `todo.md` item 108 bounds the
line's own memory.
## Nothing recurses unbounded