Skip to content

Make HTML the direct Markdown interchange - #1523

Merged
chubes4 merged 1 commit into
trunkfrom
fix/1189-markdown-html-contract
Sep 2, 2026
Merged

chubes4 merged 1 commit into
trunkfrom
fix/1189-markdown-html-contract

Conversation

@chubes4

@chubes4 chubes4 commented Sep 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • define HTML as the canonical interchange contract for format adapters
  • route Markdown-to-HTML and HTML-to-Markdown directly without a lossy WordPress block round trip
  • preserve the existing block conversion, result-envelope, and optional Markdown adapter contracts
  • retain League as the reference implementation for this prerequisite phase of Replace CommonMark with a Blocks Engine-owned Markdown parser #1189

Why

A shared Markdown codec can only replace third-party parsers safely once Markdown conversion has a direct, explicit HTML boundary. This also matches Intelligence/Data Machine content-format use and the HTML-first WordPress.com/Static Site Importer architecture.

Verification

  • composer test
  • 292 parity fixtures
  • clean-package installation proof
  • composer validate --strict --no-interaction
  • git diff --check

Follow-up


AI assistance disclosure: OpenAI gpt-5.6-sol via OpenCode inspected the cross-project architecture, refined the trackers, implemented and verified the change, and coordinated an attempted Homeboy Cook. Homeboy with OpenCode openai/gpt-5.6-terra validated provider readiness but failed before execution on component worktree resolution; Chris Huber authorized the direct local implementation and remains responsible for review.

@chubes4
chubes4 marked this pull request as ready for review September 2, 2026 20:19
@chubes4
chubes4 merged commit ae468ce into trunk Sep 2, 2026
10 checks passed
@chubes4
chubes4 deleted the fix/1189-markdown-html-contract branch September 2, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant