Unused Infrastructure: headings Array Never Consumed

[WesleyMFrederick]

Problem

The headings array is extracted from tokens but never consumed by production code.

Evidence

• Only referenced in test files (parser-output-contract.test.js, parsed-file-cache.test.js)
• CLI ast command dumps it but doesn't use it
• Documentation claims "available for future content aggregation" - speculative infrastructure

Cost

Extra token tree walk on every parse for unused data.

Recommendation

Option 1: Remove from output contract if no concrete consumer exists
Option 2: Document concrete planned consumer and timeline

Note from Technical Lead

[!danger] Technical Lead Note
The .headings[] array is not used by any other source code. It is referenced in test code. It could be used to create an AST of the document.

---

Source: Markdown Parser Implementation Guide - Legacy Tech Debt