# MANIFEST: commonmark
updated:     2026-08-15T20:28:18+00:00
state:       approved
blocks:      9
planning_feedback: |
  analyze-display_name applied ARCHITECTURE.md
  analyze-short_description applied ARCHITECTURE.md

applied: ARCHITECTURE.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,ARCHITECTURE_compact.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Block-Leafs.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Block-Lists.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Block-Quotes.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Conformance-Verification.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Inline-Basics.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Inline-Emphasis.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Inline-HTML-Autolinks.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,FEATURE-Inline-Links-Images.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,cmark.py=d4f70c531e6f0f7357a425bec12143cbc18a4690,common.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,full_test.sh=d4f70c531e6f0f7357a425bec12143cbc18a4690,normalize.py=d4f70c531e6f0f7357a425bec12143cbc18a4690,python.md=d4f70c531e6f0f7357a425bec12143cbc18a4690,spec.txt=d4f70c531e6f0f7357a425bec12143cbc18a4690,spec_tests.py=d4f70c531e6f0f7357a425bec12143cbc18a4690
applied_specs: |
  ARCHITECTURE.md sha256=7ba2aff46307f65e2850fd6267ab488fd9b951d6b7901dc417540bd4a48e0c33 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-1 applied_at=2026-08-15T20:34:50+00:00 build_sha256=991a357c4a52dc40387eb682f7103586fcf07ff918653663369c927e0a0f1cdc
  ARCHITECTURE_compact.md sha256=f3408e05a97e9dc22ebae2ef8bf928907c13d7a21c08d05eb3a9835f0d748876 commit=- applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=f3408e05a97e9dc22ebae2ef8bf928907c13d7a21c08d05eb3a9835f0d748876
  FEATURE-Block-Leafs.md sha256=e5bc93bbfc292f37d4f342e7df381fa6ba08c69a182ed918e260a88b72aa1aee commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-2 applied_at=2026-08-15T20:57:14+00:00 build_sha256=6653a046f805ec8600292e0f98a0296739dcab60e696d286d94d837c8f519b4a
  FEATURE-Block-Lists.md sha256=203a17e8a51a25be222ed72b2332c2adf7d88475bdd63a458599b7bc5ec5958d commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-4 applied_at=2026-08-15T21:12:20+00:00 build_sha256=c96c7c13d86df7bb134486b9950910d3b99f72e3100e5a9ae2a06370f20808dc
  FEATURE-Block-Quotes.md sha256=422a8a8dd27fc95c1824401ae22ab7da4deaf37e54626424dfb4cf3e1839cbb7 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-3 applied_at=2026-08-15T21:01:25+00:00 build_sha256=eb27d47916437bc02204a345fad8eb3bc3656fc1af3b583bb4484c2f3cc922c5
  FEATURE-Conformance-Verification.md sha256=b2bccd10a6736a0c48d74f2537929893c367fc3484f05968f4cbb0de51b44167 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=56b55b2737757d2a81b4cc8dee3d70e210db8536e196a3ec1c30f191bbfae487
  FEATURE-Inline-Basics.md sha256=f552fc60ed072e6110c9a3d2a4f54dc5b2d321b60c9d4f722efc2e65633643f1 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-5 applied_at=2026-08-15T21:23:45+00:00 build_sha256=b153567b499ceb6738012cad8e317945d749def92457d7bf9b96e17f9cfbb90d
  FEATURE-Inline-Emphasis.md sha256=c92b4f8bcfb861a6195430b731e56ecea7f8f6cc3123029c5db44fb6c9bdf97f commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-6 applied_at=2026-08-15T21:26:31+00:00 build_sha256=fcd4cd316195ccbe89dd04c286ee7572b63c8bf4f06586086551f1223955cf04
  FEATURE-Inline-HTML-Autolinks.md sha256=f6c98a2ca756b9f4f1b05d932b3eab25733183f4c177977afc90b45623d1db56 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-8 applied_at=2026-08-15T21:37:47+00:00 build_sha256=c0d5b0591bca64b9adbb07a96408824953822e79d47d8a8d73a1e69f8cd73a8d
  FEATURE-Inline-Links-Images.md sha256=dc30416a9ca818760a9acb200ab356d1676b7915a768e830836fb135e697521f commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-7 applied_at=2026-08-15T21:33:30+00:00 build_sha256=be094b0ec931d2d87d3a68efb583ea333f8b66c5dadf87b408a8ed5e6bbd0608
  cmark.py sha256=c5fb45e7c64fd7670b2a3c49a151e46f4af9d0ad3004bedb37ecf9cdc34d2f00 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=c5fb45e7c64fd7670b2a3c49a151e46f4af9d0ad3004bedb37ecf9cdc34d2f00
  full_test.sh sha256=5b634a1c78117313283acceda8faad9de02b594e54949439c73697b058941a93 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=5b634a1c78117313283acceda8faad9de02b594e54949439c73697b058941a93
  normalize.py sha256=94a9dd253907e3dab7c02fc11e934f06112dcf0f3804255d09d732c8c7c4b5f4 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=94a9dd253907e3dab7c02fc11e934f06112dcf0f3804255d09d732c8c7c4b5f4
  spec.txt sha256=43fad3e0ac5190a3b0bc6a41f7b1a853201a26ec2e6b74871f5d96239a8c34cf commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=43fad3e0ac5190a3b0bc6a41f7b1a853201a26ec2e6b74871f5d96239a8c34cf
  spec_tests.py sha256=9db1ea4a3ee79c5ec74eebc09c5985eb252427e8d9d19ef45e5cc3f2ae410855 commit=3d3a77de79cbfa430b2ce6b1ca06c8ec05f028b7 applied_by=block-9 applied_at=2026-08-15T21:43:34+00:00 build_sha256=9db1ea4a3ee79c5ec74eebc09c5985eb252427e8d9d19ef45e5cc3f2ae410855
## story 1: Provide the executable standard-input/standard-output interface.
id: interface-001
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-1.md
summary: Provide the executable standard-input/standard-output interface.
type: foundational
kind: capability
phase: 1
block: 1
implements: ARCHITECTURE.md
covers: INTERFACE-001
context: cmark.py
stack: common.md, python.md
stack_mode: builder
size: 7338
provides: executable commonmark
instructions: |
  Create the executable commonmark at the application root. It must read UTF-8 Markdown
  from standard input and write rendered HTML to standard output using only Python 3
  standard-library facilities and the parser implementation built by subsequent stories.
  Preserve process exit behavior and avoid third-party Markdown implementations.
acceptance: yes
state: closed/implemented
scope: target

## story 2: Parse CommonMark leaf blocks and link reference definitions.
id: block-001
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-2.md
summary: Parse CommonMark leaf blocks and link reference definitions.
type: service
kind: capability
phase: 2
block: 2
implements: FEATURE-Block-Leafs.md
covers: BLOCK-001
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 59149
budget: over-target
provides: leaf block parsing, link reference definitions
consumes: executable commonmark
instructions: |
  Implement block parsing for thematic breaks, ATX headings, setext headings, indented
  code blocks, fenced code blocks, HTML blocks, paragraphs, blank lines, and link
  reference definitions. Build block structure before inline rendering and preserve
  reference definitions for later inline resolution. Run the supplied conformance runner
  only against the owned leaf-block sections.
acceptance: yes
depends: interface-001
state: closed/implemented
scope: target

## story 3: Parse nested block quotes and their contained blocks.
id: block-002
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-3.md
summary: Parse nested block quotes and their contained blocks.
type: service
kind: capability
phase: 2
block: 3
implements: FEATURE-Block-Quotes.md
covers: BLOCK-002
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 59055
budget: over-target
provides: block quote parsing
consumes: executable commonmark, leaf block parsing
instructions: |
  Implement block quote markers, nesting, blank lines, lazy paragraph continuation,
  empty quotes, and contained block parsing according to the CommonMark block algorithm.
  Run the supplied conformance runner only against the Block quotes section.
acceptance: yes
depends: interface-001, block-001
state: closed/implemented
scope: target

## story 4: Parse lists, list items, nesting, laziness, and tightness.
id: block-003
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-4.md
summary: Parse lists, list items, nesting, laziness, and tightness.
type: service
kind: capability
phase: 2
block: 4
implements: FEATURE-Block-Lists.md
covers: BLOCK-003
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 59082
budget: over-target
provides: list parsing, list-item parsing, list tightness
consumes: executable commonmark, leaf block parsing, block quote parsing
instructions: |
  Implement bullet and ordered lists, marker widths, nesting, continuation and lazy
  lines, empty items, block content, list interruption, delimiter changes, and tight
  versus loose rendering. Run the supplied conformance runner only against the List
  items and Lists sections.
acceptance: yes
depends: interface-001, block-001, block-002
state: closed/implemented
scope: target

## story 5: Parse escapes, entities, code spans, line breaks, and literal text.
id: inline-001
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-5.md
summary: Parse escapes, entities, code spans, line breaks, and literal text.
type: service
kind: capability
phase: 3
block: 5
implements: FEATURE-Inline-Basics.md
covers: INLINE-001
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 59180
budget: over-target
provides: inline escapes, entity references, code spans, hard breaks, soft breaks
consumes: executable commonmark, block structure
instructions: |
  Implement inline parsing for backslash escapes, HTML and numeric character references,
  code spans, hard line breaks, soft line breaks, replacement of U+0000, and literal
  textual content. Run the supplied conformance runner only against the owned inline
  sections: Backslash escapes, Entity and numeric character references, Code spans,
  Hard line breaks, Soft line breaks, and Textual content.
acceptance: yes
depends: interface-001, block-001, block-002, block-003
state: closed/implemented
scope: target

## story 6: Parse emphasis and strong emphasis with the delimiter-run algorithm.
id: inline-002
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-6.md
summary: Parse emphasis and strong emphasis with the delimiter-run algorithm.
type: service
kind: capability
phase: 3
block: 6
implements: FEATURE-Inline-Emphasis.md
covers: INLINE-002
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 58888
budget: over-target
provides: emphasis parsing, strong-emphasis parsing
consumes: executable commonmark, block structure, inline basics
instructions: |
  Implement the CommonMark delimiter-run algorithm for emphasis and strong emphasis,
  including intraword rules, Unicode punctuation and whitespace behavior, nesting,
  precedence, unmatched delimiters, and interaction with tighter inline constructs.
  Run the supplied conformance runner only against Emphasis and strong emphasis.
acceptance: yes
depends: interface-001, block-001, block-002, block-003, inline-001
state: closed/implemented
scope: target

## story 7: Parse inline and reference links together with images.
id: inline-003
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-7.md
summary: Parse inline and reference links together with images.
type: service
kind: capability
phase: 3
block: 7
implements: FEATURE-Inline-Links-Images.md
covers: INLINE-003
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 58962
budget: over-target
provides: inline links, reference links, images
consumes: executable commonmark, link reference definitions, inline basics
instructions: |
  Implement inline, full-reference, collapsed-reference, and shortcut links and images,
  including destinations, titles, escaping, nested brackets, reference-label
  normalization, duplicate-definition precedence, link restrictions, and image alt text.
  Run the supplied conformance runner only against Links and Images.
acceptance: yes
depends: interface-001, block-001, block-002, block-003, inline-001
state: closed/implemented
scope: target

## story 8: Parse autolinks and raw HTML inline constructs.
id: inline-004
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-8.md
summary: Parse autolinks and raw HTML inline constructs.
type: service
kind: capability
phase: 3
block: 8
implements: FEATURE-Inline-HTML-Autolinks.md
covers: INLINE-004
context: spec.txt, spec_tests.py, cmark.py, normalize.py, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 58928
budget: over-target
provides: URI autolinks, email autolinks, raw HTML
consumes: executable commonmark, block structure, inline basics
instructions: |
  Implement URI and email autolinks and raw HTML tags, comments, processing
  instructions, declarations, and CDATA. Respect precedence with code spans, links,
  and emphasis, and preserve valid raw HTML in the rendered output. Run the supplied
  conformance runner only against Autolinks and Raw HTML.
acceptance: yes
depends: interface-001, block-001, block-002, block-003, inline-001
state: closed/implemented
scope: target

## story 9: Run the complete supplied CommonMark conformance suite.
id: verify-001
finding: ADVISORY: implemented, not verified — no governed acceptance command covers this story. Declare one in ACCEPTANCE.json to gate it.
evidence: evidence/block-9.md
summary: Run the complete supplied CommonMark conformance suite.
type: service
kind: test harness
phase: 4
block: 9
implements: FEATURE-Conformance-Verification.md
covers: VERIFY-001
accepts: st-001
context: spec.txt, spec_tests.py, cmark.py, normalize.py, full_test.sh, ARCHITECTURE_compact.md
stack: common.md, python.md
stack_mode: consumer
size: 59364
budget: over-target
provides: complete CommonMark conformance verification
consumes: executable commonmark, all parser capabilities
instructions: |
  Stage the supplied conformance assets unchanged and run sh sources/full_test.sh from
  the completed application root. This is the sole unfiltered full-suite verification
  story. Do not modify or reinterpret the supplied scoring entry point or its assets.
acceptance: yes
depends: interface-001, block-001, block-002, block-003, inline-001, inline-002, inline-003, inline-004
state: closed/implemented
scope: target