[Bakhomious]

Step adf-blocks (plan row 63): the second half of the converter from #39. internal/adf now gives the blocks of the Atlassian Document Format their Markdown shape. Before this, they fell back to their plain content.

What changes

• Headings keep their level, kept between 1 and 6, and a heading without one gets level 1.
• Lists keep their nesting: an item's blocks stand on the lines under its marker, indented to it. An ordered list starts at its order, 0 included.
  • A task shows as - [ ] or - [x]. A block task item holds paragraphs, and a nested task list sits as it is under the item before it.
  • A decision shows as a bullet.
• Code blocks keep their language, in a fence of at least three backticks that their code can't end.
• Quotes and panels show as a quote. The panel's kind (info, warning…) drops, and an empty line inside keeps a bare >.
• Rules show as ---. Expands, which Jira shows folded, nested ones included, show their title in bold above their content.
• Tables become Markdown tables:
  • The first row is the header, since a Markdown table needs one.
  • Each row is as wide as the widest.
  • Each cell stays on one line, with <br> for a line break and \| for a |.
• Docs: decision 57 gains the blocks' rules. The status table: adf Done (feat(adf): render Jira's document format as Markdown #39), adf-blocks In review (feat(adf): give a ticket's blocks their Markdown shape #40).

Checks

• mise run check: green. Coverage 99.4%; internal/adf 100%.
• Golden tests: four new ADF documents (headings, lists, code and quotes, tables), and the rule and expands in blocks. A task list in inline now renders as one.
• Mutation probes: 52 mutants, all caught. They cover each block type's case, the separators between blocks, items, rows and cells, the prefix's trimming, the heading's clamps and default, the code fence's floor and language, the expand's title, a list's start, positions, markers, nesting and indents, and the table's header, padding, width and escapes. One survivor came up first: a nestedExpand without a title rendered the same through the fallback. Its test now has a title, and an untitled expand of its own tests the rest.
• Smoke run: the made-up ticket from feat(adf): render Jira's document format as Markdown #39, now with nested lists, a task list, a rule, a table and an expand, rendered through a throwaway test. Every block came out in its Markdown shape.

Not in this PR: jira (baton jira <KEY>), next. Two nudge asks are still open for it: the Keychain read's G204 handling, and a live check against one real ticket.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud