Follow-up from PR #124 review (thread on packages/blocks/README.md). The README + scaffolded AGENTS.md tell agents each block ships README/API/DESIGN/CHANGELOG, but gen-block-docs.mjs only mirrors whatever *.md a package happens to have (today: core lacks DESIGN.md; hosting & pipeline lack API.md and DESIGN.md). PR #124 softened the wording to 'where present' (option a). Durable fix (option b): have gen-block-docs.mjs assert the promised files exist (or emit a stub) so the documented contract can't drift from what actually ships.
Follow-up from PR #124 review (thread on packages/blocks/README.md). The README + scaffolded AGENTS.md tell agents each block ships README/API/DESIGN/CHANGELOG, but gen-block-docs.mjs only mirrors whatever *.md a package happens to have (today: core lacks DESIGN.md; hosting & pipeline lack API.md and DESIGN.md). PR #124 softened the wording to 'where present' (option a). Durable fix (option b): have gen-block-docs.mjs assert the promised files exist (or emit a stub) so the documented contract can't drift from what actually ships.