larvit/adf-codec
3
0
Fork 0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-12 11:48:29 +01:00
Code Activity

Anchor each level of L, E and I in docs/score-anchors.md with two shipped items

Browse Source
This commit is contained in:
Lilleman auf Larv
2026-10-23 12:11:41 +02:00
committed by Lillem4n
parent ab3c07a23a
commit 6c8d7e2743
3 changed files with 52 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reading-cost.md
+4
View File
@@ -474,3 +474,7 @@ Read most (opens and searches):
## Reading cost, chunk e36f2dc3a5e8, finished 2026-10-23T08:46:00Z
315017 new input tokens before the first commit.
## Reading cost, chunk fc577244d095, finished 2026-10-23T10:08:26Z
89461 new input tokens before the first commit.
docs/score-anchors.md
+47
View File
@@ -0,0 +1,47 @@
# Score anchors
Shipped items that anchor each level of L, E and I in `todo.md` (`~/.claude/rules/todo-items.md`).
A level no shipped item shows has no row.
| Level | Items |
|---|---|
| L 1 | 90, 117 |
| L 2 | 102, 120 |
| L 3 | 114, 122 |
| L 4 | 43, 61 |
| E 1 | 62, 103 |
| E 2 | 71, 121 |
| E 3 | 61, 65 |
| I 1 | 92, 126 |
| I 2 | 120, 123 |
| I 3 | 49, 114 |
Why each sits at its level, with its chunk's lines changed as `score-outcomes` measures them:
- L 1, item 90 (6 lines in 2 files): the README's tagline and `package.json`'s description.
- L 1, item 117 (13 lines in 1 file): one decision's wording.
- L 2, item 102 (162 lines in 5 files): the portable task-list split, in its own component.
- L 2, item 120 (87 lines in 4 files): one loop in the block reader, by the linear-time pattern
items before it set.
- L 3, item 114 (145 lines in 15 files): every reader and both writers.
- L 3, item 122 (285 lines in 9 files): the inline reader, the portable writer and the image module.
- L 4, item 43 (3192 lines in 37 files): a new reader per markdown input, across `src/markdown/`.
- L 4, item 61 (547 lines in 9 files): a new pattern, the writer asking the reader how a line reads
back, across `emit/` and `parse/`.
- E 1, item 62: a move between directories, which the types, the tests and the import boundaries
fail on.
- E 1, item 103: one error code folded into another, which the types and the tests fail on.
- E 2, item 71: the README's comparison table, each cell checked by hand against the other package.
- E 2, item 121: a decision's text, which only a reader checks.
- E 3, item 61: its escape walk scans for an inline HTML terminator at every opener, quadratic in
the text; that shipped in 0.2.0 and item 96 fixed it after.
- E 3, item 65: inside a link's text, its reading drops an image's URL and title; that shipped in
0.2.0 and item 122 fixed it after.
- I 1, item 92: a working rule in `AGENTS.md`.
- I 1, item 126: the lint config, which only contributors run.
- I 2, item 120: one reader's speed on one list shape.
- I 2, item 123: link titles in one writer.
- I 3, item 49: how every reader parts lists, and the retired `!adf:listBreak` in every consumer's
stored markdown.
- I 3, item 114: a breaking change to code text in every reader, with a migration for stored
markdown.
todo.md
+1 -10
View File
@@ -12,7 +12,6 @@
| ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 125 | 0.3.0 | | | **Anchor each level of L, E and I in `docs/score-anchors.md` with two or three shipped items.** | 3 | 2 | 3 | 6 | 4 | code health by 2 | 8.7 |
| 130 | 0.3.0 | | | **Ship `adfToHtml`, writing paragraphs, headings, lists, quotes, code blocks, rules, hard breaks, external images and the marks CommonMark spells as semantic HTML, and every other node as a carry element showing its text.** | 3 | 2 | 2 | 5 | 6 | 3 by 6 | 2.1 |
| 131 | 0.3.0 | 130 | | **Ship `htmlToAdf`, reading back exactly what `adfToHtml` writes and refusing any other HTML as `unmappable-html`.** | 4 | 1 | 2 | 5 | 7 | 3 by 3 | 0.6 |
| 133 | 0.3.0 | 131 | | **Write mentions, emoji, dates, statuses and inline cards as semantic HTML in `adfToHtml` and read them back in `htmlToAdf`, in place of the carry element.** | 2 | 2 | 2 | 4 | 4 | 6 by 3 | 3.0 |
@@ -25,7 +24,7 @@
| 109 | 0.4.0 | | defect | **Spell nested lists and quotes in time linear in the markdown.** | 3 | 1 | 2 | 4 | 5 | 9 by 3 | 7.8 |
| 115 | 0.4.0 | | defect | **Build text holding no `border` mark in `losslessMarkdownToAdf`, and have `adfToLosslessMarkdown` carry text holding one.** | 2 | 1 | 2 | 3 | 3 | 4 by 3 | 4.6 |
| 91 | 0.4.0 | 95 | | **Spell an emphasis once across the code spans, an emphasis or link once across the hard breaks, dates, emoji, inline cards, mentions and statuses between two nodes it marks, and an emphasis across inline media, in both writers.** | 3 | 2 | 2 | 5 | 5 | 6 by 6 | 3.6 |
| 73 | 0.4.0 | 33, 91, 95, 109, 115, 125, 140 | | **Announce the package where someone needing an ADF converter already reads: JRACLOUD-77436, the Atlassian developer community and Stack Overflow's ADF-to-markdown questions.** | 1 | 2 | 2 | 3 | 2 | 3 by 8 | 16.9 |
| 73 | 0.4.0 | 33, 91, 95, 109, 115, 140 | | **Announce the package where someone needing an ADF converter already reads: JRACLOUD-77436, the Atlassian developer community and Stack Overflow's ADF-to-markdown questions.** | 1 | 2 | 2 | 3 | 2 | 3 by 8 | 16.9 |
| 45 | 0.4.0 | | defect | **Replace `isAdfDocument` with a reader returning `Result<AdfDocument>`.** | 2 | 1 | 3 | 4 | 3 | 1 by 2 | 13.1 |
| 68 | 0.4.0 | | defect | **Carry a non-text inline node holding `content` or `text`, a block holding `text`, and a leaf block holding `content`.** | 2 | 1 | 2 | 3 | 3 | 1 by 2 | 13.1 |
| 127 | 0.4.0 | | principle | **Hold what `entity-references.test.ts`, `json-text.test.ts` and `result.test.ts` check by asserting outcomes, so none reads source text.** | 2 | 2 | 1 | 3 | 3 | code health by 2 | 13.1 |
@@ -63,14 +62,6 @@
## Details
### 125. Anchor each level of L, E and I in `docs/score-anchors.md` with two or three shipped items.
`docs/score-anchors.md` does not exist, so no level has an anchor. Pick two or three shipped items
for E and I now, by each level's words and what followed each release, since no tool measures them.
L anchors need `score-outcomes` first. The maintainer's script, kept outside this repo, reads merge
commits, and this repo merges by rebase, which leaves none. Change the script in its own repo, as
AGENTS.md §7 says. Until then, judge each L by its words.
### 130. Ship `adfToHtml`, writing paragraphs, headings, lists, quotes, code blocks, rules, hard breaks, external images and the marks CommonMark spells as semantic HTML, and every other node as a carry element showing its text.
The first, limited HTML: the dialect (`docs/decisions.md` §The HTML dialect) specified for this set,