AGENTS.md

@@ -20,6 +20,7 @@ In `docs/decisions.md`:
 - Links
 - Ids stay site-local
 - Plain task ids come from position
+- A callout title keeps its link targets
 - The plain flavour's spellings
 - The HTML dialect
 - No runtime dependencies

docs/decisions.md

@@ -135,6 +135,14 @@ position in document order, unique within the document and minted with no host A
 rejecting a missing `localId` takes the document and the same markdown reads to the same ids every
 run.
 
+## A callout title keeps its link targets
+
+2026-09-29, the maintainer. Goal 5. Valid while an expand's `title` is a string. Lands with
+`todo.md` 41.
+
+`plainMarkdownToAdf` writes a link in a folded callout's title as its text and its target in
+parentheses: `> [!faq]- See [x](http://y)` reads to the title `See x (http://y)`.
+
 ## The plain flavour's spellings
 
 2026-09-14, panels 2026-09-25, the maintainer. Goal 5. Valid while GitHub's renderer is the one the

todo.md

@@ -18,10 +18,9 @@
 - **10f — Give task nodes read from plain markdown position ids.** Per `docs/decisions.md` §Plain
   task ids come from position, README §Plain markdown's `localId` bullet saying so. The id spelling
   is part of the chunk.
-- **41 — Keep a link's target when `plainMarkdownToAdf` reads a callout title.** Per Goal 5 a link
+- **41 — Keep a link's target when `plainMarkdownToAdf` reads a callout title.** Per
-  target is content, but `> [!faq]- See [x](http://y)` reads to an expand titled `See x`, the
+  `docs/decisions.md` §A callout title keeps its link targets; today `> [!faq]- See [x](http://y)`
-  target gone. Where the target goes is a gap in `docs/decisions.md`; candidate: the title keeps
+  reads to an expand titled `See x`, the target gone.
-  it as text, `See x (http://y)`.
 - **40 — Make `markdownToAdf(adfToMarkdown(doc))` deep-equal `doc` for every document it takes.**
   Today it holds for editor-normal documents only: two adjacent text nodes with the same marks
   merge, an empty `attrs`, `marks` or `content` drops, and `-0` reads back `0` — shapes pipelines