Run artifact

workspace/targets/commonmark/blueprint/FEATURE-CONFORMANCE-ASSETS.md

FEATURE: Conformance Assets

FieldValue
Version20260812 V1
DescriptionStages the supplied CommonMark conformance assets and supports bounded verification.
Depends OnFEATURE-RENDER-NORMALIZATION.md
Providesstaged conformance assets, bounded conformance verification
Consumesparser executable

Workflow

The build stages only spec.txt, spec_tests.py, cmark.py, and normalize.py at the runtime paths required by the supplied harness. INSTRUCTIONS.md remains planning context and is not staged.

Bounded verification invokes spec_tests.py with explicit section selectors. It never invokes an unfiltered suite. The harness uses the parser executable through its standard-input and standard-output contract.

Staged Assets

SourceRuntime destination
sources/spec.txtspec.txt
sources/spec_tests.pyspec_tests.py
sources/cmark.pycmark.py
sources/normalize.pynormalize.py

Programmatic Acceptance

Requires: executable=python3; scope=test

=== AC conformance-assets-leaf-scope ===
Intent: The staged conformance harness executes a selected leaf-block scope successfully.
Suite: scoped

import subprocess import sys

result = subprocess.run( [ sys.executable, "spec_tests.py", "--spec", "spec.txt", "--program", "./program", "--pattern", "^(Thematic breaks|ATX headings|Setext headings|Indented code blocks|Fenced code blocks|HTML blocks|Link reference definitions|Paragraphs|Blank lines)$", ], capture_output=True, text=True, ) print(result.stdout) print(result.stderr, file=sys.stderr) assert result.returncode == 0 === END AC conformance-assets-leaf-scope ===

=== AC conformance-assets-inline-scope ===
Intent: The staged conformance harness executes a selected inline scope successfully.
Suite: scoped

import subprocess import sys

result = subprocess.run( [ sys.executable, "spec_tests.py", "--spec", "spec.txt", "--program", "./program", "--pattern", "^(Code spans|Emphasis and strong emphasis|Links|Images|Autolinks|Raw HTML|Hard line breaks|Soft line breaks)$", ], capture_output=True, text=True, ) print(result.stdout) print(result.stderr, file=sys.stderr) assert result.returncode == 0 === END AC conformance-assets-inline-scope ===

User Acceptance

Guardrails