Evidence: Block 12 · Service (block-12)

block type: block
date: 2026-08-12
resulting state: closed/verified
story points (combined assembled cost): 59451
execution id: 20260812.193447.205Z-ae61ce2f

Stories built

Render parsed block structure as CommonMark HTML. (render-blocks) [story]

Acceptance tooling authorization

FEATURE-RENDER-BLOCKS.md#render-blocks-suite: executable=python3; scope=test; authorization=existing Target environment
FEATURE-RENDER-BLOCKS.md#render-blocks-escaping: executable=python3; scope=test; authorization=existing Target environment

Reusable compacts

normalize_compact.md

Stacked context

compass: COMPASS.md (SP 1263)
implements: FEATURE-RENDER-BLOCKS.md (SP 551)
context: spec.txt (SP 51527)
context: spec_tests.py (SP 1609)
context: normalize.py (SP 1631)
context: ARCHITECTURE_compact.md (SP 116)
stack: common_compact.md (SP 1179)
stack: python_compact.md (SP 1534)

Build directory changes

parser/blocks.py
renderer/html.py
scoped-final.log
test_render_blocks.py

Pre-build acceptance observation

RED: render-blocks-suite (FEATURE-RENDER-BLOCKS.md)

intent: Block-level HTML rendering passes the complete owned conformance scope. return code: 1 stdout: Example 56 (lines 1010-1014) Thematic breaks -

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<p><em>-</em></p> +<p><em>-< em>< p>

Example 57 (lines 1019-1031) Thematic breaks

***

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<ul><li>foo</li></ul><hr><ul><li>bar</li></ul> +<ul><li>foo<hr></li><li>bar</li></ul>

Example 66 (lines 1167-1171) ATX headings # foo bar \baz\

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<h1>foo <em>bar</em> baz</h1> +<h1>foo <em>bar< baz< em> h1>

Example 80 (lines 1347-1356) Setext headings Foo bar =========

Foo bar ---------

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<h1>Foo <em>bar</em></h1><h2>Foo <em>bar</em></h2> +<h1>Foo <em>bar< em>< h1><h2>Foo <em>bar< em>< h2>

Example 81 (lines 1361-1368) Setext headings Foo bar baz ====

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<h1>Foo <em>bar baz</em></h1> +<h1>Foo <em>bar baz< em>< h1>

Example 82 (lines 1375-1382) Setext headings Foo bar baz ====

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<h1>Foo <em>bar baz</em></h1> +<h1>Foo <em>bar baz< em>< h1>

Example 94 (lines 1540-1548) Setext headings

---

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<ul><li>Foo</li></ul><hr> +<ul><li><h2>Foo</h2></li></ul>

Example 99 (lines 1606-1614) Setext headings

-----

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<ul><li>foo</li></ul><hr> +<ul><li><h2>foo</h2></li></ul>

Example 109 (lines 1777-1790) Indented code blocks

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<ol><li><p>foo</p><ul><li>bar</li></ul></li></ol> +<ol><li>foo<ul><li>bar</li></ul></li></ol>

Example 148 (lines 2429-2444) HTML blocks <table><tr><td> <pre> Hello,

_world_. </pre> </td></tr></table>

--- expected HTML +++ actual HTML @@ -1,3 +1,3 @@ <table><tr><td><pre> -Hello,<p><em>world</em>. -</pre></p></td></tr></table> +Hello,<p><em>world< < em>. pre></p></td></tr></table> +

Example 152 (lines 2504-2514) HTML blocks <DIV CLASS="foo">

Markdown

</DIV>

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<div class="foo"><p><em>Markdown</em></p></div> +<div class="foo"><p><em>markdown< em>< p></div>

Example 155 (lines 2543-2552) HTML blocks <div> foo

bar

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<div>foo<p><em>bar</em></p> +<div>foo<p><em>bar< em>< p>

Example 162 (lines 2629-2635) HTML blocks <div > not quoted text

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<div>not quoted text +<p><div</p><blockquote><p>not quoted text</p></blockquote>

Example 168 (lines 2707-2717) HTML blocks <del>

foo

</del>

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<del><p><em>foo</em></p></del> +<del><p><em>foo< em>< p> </del>

Example 169 (lines 2725-2729) HTML blocks <del>foo</del>

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<p><del><em>foo</em></del></p> +<p><del><em>foo< del em><></p>

Example 170 (lines 2731-2741) HTML blocks <del class="foo"> foo </del>

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<p><del class="foo"> <em>foo</em> </del></p> +<p><del class="foo"> <em>foo< < del em>></p>

Example 178 (lines 2878-2884) HTML blocks <style>p{color:red;}</style> foo

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<style>p{color:red;}</style><p><em>foo</em></p> +<style>p{color:red;}</style><p><em>foo< em>< p>

Example 179 (lines 2887-2893) HTML blocks bar baz

--- expected HTML +++ actual HTML @@ -1 +1 @@ -bar<p><em>baz</em></p> +bar<p><em>baz< em>< p>

Example 190 (lines 3090-3100) HTML blocks <div>

Emphasized text.

</div>

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<div><p><em>Emphasized</em> text.</p></div> +<div><p><em>emphasized< em> p text.<></div>

Example 228 (lines 3637-3643) Paragraphs aaa bbb

--- expected HTML +++ actual HTML @@ -1 +1 @@ -<p>aaa<br>bbb</p> +<p>aaa<br > bbb< p>

239 passed, 20 failed, 0 errored, 396 skipped stderr: Traceback (most recent call last): File "render-blocks-suite.py", line 11, in <module> assert result.returncode == 0 ^^^^^^^^^^^^^^^^^^^^^^ AssertionError

RED: render-blocks-escaping (FEATURE-RENDER-BLOCKS.md)

intent: Block rendering preserves structural nesting and escapes literal code content. return code: 1 stderr: Traceback (most recent call last): File "render-blocks-escaping.py", line 9, in <module> assert result.returncode == 0 ^^^^^^^^^^^^^^^^^^^^^^ AssertionError

Post-build programmatic acceptance

PASS: render-blocks-suite (FEATURE-RENDER-BLOCKS.md)

intent: Block-level HTML rendering passes the complete owned conformance scope. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0 stdout: 259 passed, 0 failed, 0 errored, 396 skipped

PASS: render-blocks-escaping (FEATURE-RENDER-BLOCKS.md)

intent: Block rendering preserves structural nesting and escapes literal code content. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

Build summary

<reusable-compact filename="normalize.py"> Provides normalize_html(html: str) -> str, normalizing insignificant HTML whitespace, attribute ordering, self-closing tags, and entity references for conformance comparison. Uses only Python standard-library modules. </reusable-compact>

RESULT: SUCCESS

FILES CHANGED:

parser/blocks.py
renderer/html.py
test_render_blocks.py

SUMMARY: Implemented block rendering fixes for raw HTML, thematic breaks, loose lists, headings, and escaped/generated HTML markup. Added regression tests. All 28 project tests pass; each declared block-scope section passes independently.

BLOCKERS:

Full suite remains non-green due pre-existing inline-scope failures and timeout outside this build block.