From eed1ac0290fb602ddfa75d12318f3427fdadb125 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sun, 20 Sep 2026 21:53:07 +0200 Subject: [PATCH] 29 - the spec stands: raw HTML routes through the element mapping --- todo.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/todo.md b/todo.md index c48462f..504735c 100644 --- a/todo.md +++ b/todo.md @@ -40,14 +40,16 @@ panel says the next reader pays for. 29 and 30 come from 17's prose pass (2026-09-20). 29 reads first because every goal is what a later ask is settled against, 19's included; 30 sits beside 25, the other chunk rereading AGENTS.md. -- [ ] **29 — Goal 3 names the whole of the exception (`0.2.0`).** README §Goals 3 says "the three - carve-outs and the one gap below are the whole of the exception", and §The guarantees says - "apart from the raw HTML below, with three carve-outs … and one gap". Raw HTML is a fourth - exception, the commonest one in markdown written elsewhere, and `unmappable-html` refuses it - today. Name it in the goal, or stop enumerating there. Settle at the same time whether the - goal is written for `0.2.0`, where the element mapping the error text promises could make - raw HTML convert — the answer decides which repair is the true one, so it is the - maintainer's. +- [ ] **29 — The README reads raw HTML as refused for good (`0.2.0`).** §Goals 3 says "the three + carve-outs and the one gap below are the whole of the exception" and §The guarantees says + "Raw HTML in markdown input is an error result", both reading as settled, where + `spec/flavour.md` §Raw HTML in input says the opposite: `markdownToAdf` routes each construct + through the foreign HTML element mapping, and only a construct without one is refused. The + spec stands — commonplace markdown is accepted, and every tool writes some HTML (the + maintainer, 2026-09-20). So rewrite the two README texts to name the exception that survives + 6 and 7, a construct outside the documented element set, and state it in one place, since + three already spell this one rule. `markdown-to-adf.ts:73` and `inline-content.ts:158` are + the whole of the refusal and already say "at this version"; 7 is what makes them route. - [ ] **30 — AGENTS.md says each thing once (`0.2.0`).** §15's ask protocol — name the class, cite the earlier asks of it, never "A or B?" — is the rule reviewers cite most and has no heading, two thirds down a 50-line section in a file with no index. Give it one. §15 also offers "the -- 2.52.0