From 5b2325af8c3a27e6c4edc90dd19c01d8586f203a Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Wed, 21 Oct 2026 11:28:08 +0200 Subject: [PATCH] File item 125 for the missing score anchors and the rule for changing outside tooling --- AGENTS.md | 3 +++ docs/decisions.md | 4 ++++ todo.md | 9 +++++++-- 3 files changed, 14 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3ce855b..f3696d4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -54,6 +54,7 @@ In `docs/decisions.md`: - Publish on a version bump - Docs describe the release being built - Plan items rank by `rank_todo.py`'s goal weights, code health first +- Until `docs/score-anchors.md` exists, L, E and I are judged by the levels' words - Posts announcing a release wait for its publish, and their drafts wait for the finished release - No schema validation - The gate runs on Deno and Bun @@ -170,6 +171,8 @@ Reserved for the maintainer whatever any rule here says: changing `version` in ` bump on `main` publishes, `docs/decisions.md` §Publish on a version bump — every release is the maintainer's) and the `NPM_TOKEN` secret. +Before you change a file outside this repo, check whether its directory is a git repo. If it is, change it through a branch and a PR there, as here. + ### Ask, don't guess Any choice where what the maintainer would pick is not near-certain gets asked. The confidence bar diff --git a/docs/decisions.md b/docs/decisions.md index da392ef..63c32e5 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -601,6 +601,10 @@ weighs 4 times its position weight. `todo.md`'s `## Scoring` keeps the formula and the bar, the lowest Score a non-exempt item may have. Both are the project's to tune: the maintainer confirmed the bar at 0.1 on 2026-10-21. +## Until `docs/score-anchors.md` exists, L, E and I are judged by the levels' words + +2026-10-21, the maintainer, agreeing to track the gap as `todo.md` item 125. An anchor is a shipped item that shows what a level looks like. `score-outcomes` measures only merge commits, and this repo merges by rebase, so it finds no shipped chunk to anchor a level with. L picks a worker's rung, and E + I the reviewers', so scores decide how carefully a change is checked. Serves code health. Valid while `docs/score-anchors.md` does not exist. + ## Posts announcing a release wait for its publish, and their drafts wait for the finished release 2026-10-21, the maintainer, asking for the choice that best reaches the goals. Serves Goal 3. diff --git a/todo.md b/todo.md index 871042c..2a9412a 100644 --- a/todo.md +++ b/todo.md @@ -6,7 +6,7 @@ `Bar = 0.1` -`Next ID = 125` +`Next ID = 126` ## Items @@ -20,11 +20,12 @@ | 123 | 0.3.0 | | defect | **Spell a link title holding a backslash, an entity reference or, in a table cell, a pipe, instead of dropping it.** | 3 | 1 | 2 | 4 | 3 | 7 by 2 | 13.1 | | 122 | 0.3.0 | | defect | **Keep an image's URL and title when a link's text holds the image, instead of dropping them.** | 3 | 1 | 2 | 4 | 5 | 7 by 4 | 10.5 | | 95 | 0.3.0 | | decision | **Find the code-span closers an escape forms, the mark runs a line cannot spell and the text `[` that opens link text by reading the line back, in place of `escapeClosedRuns`, `unspellableRuns` and `lastLinkClose` predicting them.** | 4 | 1 | 3 | 6 | 6 | code health by 7 | 10.2 | +| 125 | 0.3.0 | | decision | **Anchor each level of L, E and I in `docs/score-anchors.md` with shipped chunks that `score-outcomes` measures.** | 3 | 2 | 3 | 6 | 4 | code health by 2 | 8.7 | | 33 | 0.3.0 | | defect | **Emit a line in time linear in its mark runs, in `adfToLosslessMarkdown` and `adfToPortableMarkdown`.** | 3 | 1 | 2 | 4 | 5 | 9 by 3 | 7.8 | | 109 | 0.3.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.3.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.3.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.3.0 | 33, 59, 60, 62, 91, 92, 95, 102, 109, 115, 122, 123 | | **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.3.0 | 33, 59, 60, 62, 91, 92, 95, 102, 109, 115, 122, 123, 125 | | **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 | | 75 | 0.4.0 | | | **Make the generated-markdown property write block carries as `adf:` fences, canonical and hostile.** | 1 | 1 | 1 | 1 | 2 | code health by 2 | 17.4 | | 45 | 0.4.0 | | defect | **Replace `isAdfDocument` with a reader returning `Result`.** | 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,6 +128,10 @@ text. Only the property tests catch drift between these and the reader, and it h under the comprehension floor. Reading the line back costs one parse each time a line is tried. The run it carries may differ from today's, which changes lossless output (§The formats are API). +### 125. Anchor each level of L, E and I in `docs/score-anchors.md` with shipped chunks that `score-outcomes` measures. + +`docs/score-anchors.md` does not exist, so no level has an anchor. `score-outcomes`, the maintainer's script kept outside this repo, reads merge commits. This repo merges by rebase, which leaves none, so the script finds no finished chunk to anchor a level with. First make the script measure rebase merges. Change it in its own repo, by PR if that directory is a git repo. Then name two or three shipped items for each level, as the scoring rules say. Until this ships, judge each score by its level's words, as `docs/decisions.md` says. + ### 33. Emit a line in time linear in its mark runs, in `adfToLosslessMarkdown` and `adfToPortableMarkdown`. `adfToLosslessMarkdown` spends 28 s on one paragraph of 2000 × `un` plus `**-r**`: each run its