Evidence: Block 2 · Service (block-2)

• block type: block
• date: 2026-08-12
• resulting state: closed/verified
• story points (combined assembled cost): 9298
• execution id: 20260812.172907.171Z-75e402c6

Stories built

• Implement the standard-input and standard-output parser entry point. (cli-entrypoint) [story]
• Define deterministic parser process errors and exit behavior. (cli-errors) [story]

Stacked context

• compass: COMPASS.md (SP 1263)
• implements: FEATURE-CLI-ENTRYPOINT.md (SP 459)
• context: cmark.py (SP 339)
• context: normalize.py (SP 1631)
• context: ARCHITECTURE.md (SP 749)
• stack: common_compact.md (SP 1179)
• stack: python_compact.md (SP 1534)
• implements: FEATURE-CLI-ERRORS.md (SP 448)
• context: spec_tests.py (SP 1609)

Build directory changes

• cmark
• parser/init.py
• parser/blocks.py
• parser/inlines.py
• renderer/html.py
• test_cli.py

Pre-build acceptance observation

• RED: cli-stdin-stdout (FEATURE-CLI-ENTRYPOINT.md)

intent: The executable renders Markdown supplied through standard input and exits successfully. return code: 1 stdout: <p># Hello</p> <p>world</p> stderr: Traceback (most recent call last): File "cli-stdin-stdout.py", line 13, in <module> assert result.stdout == "<h1>Hello</h1>\n<p>world</p>\n" ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ AssertionError

• GREEN (prepassed): cli-utf8 (FEATURE-CLI-ENTRYPOINT.md)

intent: The executable accepts UTF-8 Markdown and emits UTF-8 HTML. return code: 0

• GREEN (prepassed): cli-errors-success-contract (FEATURE-CLI-ERRORS.md)

intent: A successful invocation returns zero and keeps diagnostics off standard error. return code: 0

• GREEN (prepassed): cli-errors-stdout-integrity (FEATURE-CLI-ERRORS.md)

intent: The executable emits a complete HTML document result without diagnostic text in standard output. return code: 0

Post-build programmatic acceptance

• PASS: cli-stdin-stdout (FEATURE-CLI-ENTRYPOINT.md)

intent: The executable renders Markdown supplied through standard input and exits successfully. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0 stdout: <h1>Hello</h1> <p>world</p>

• PASS: cli-utf8 (FEATURE-CLI-ENTRYPOINT.md)

intent: The executable accepts UTF-8 Markdown and emits UTF-8 HTML. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

• PASS: cli-errors-success-contract (FEATURE-CLI-ERRORS.md)

intent: A successful invocation returns zero and keeps diagnostics off standard error. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

• PASS: cli-errors-stdout-integrity (FEATURE-CLI-ERRORS.md)

intent: The executable emits a complete HTML document result without diagnostic text in standard output. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

Build summary

RESULT: SUCCESS

FILES CHANGED:

• cmark
• parser/blocks.py
• parser/init.py
• parser/inlines.py
• renderer/html.py
• test_cli.py

SUMMARY: Implemented standard-input/output CLI handling, UTF-8 validation, deterministic stderr error reporting, heading and paragraph separation, and CLI regression tests.

Verification: 8 tests passed.

BLOCKERS:

• None