Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mehen.ophi.dev/llms.txt

Use this file to discover all available pages before exploring further.

Headings produce a derived section tree that downstream metrics (MCC, Filler / Lazy Risk, Section Balance) read from. Every section has a heading level, byte/line range, parent/child IDs, word count, and per-section artifact and link counts.

​
Structure

Each section node carries: 
Section
├── heading_level   : 1..6
├── byte_range
├── line_range
├── parent_id, children_ids
├── word_count
├── artifact_counts : { code, table, image, diagram, math }
└── link_counts     : { internal, relative, external, broken }

​
Quality flags

mehen marks three structural smells on the section tree:
FlagTrigger
Heading skipDirect nesting jump (e.g., H1 → H4 without an intervening H2/H3).
Chunking smellAn H2 section that is oversized relative to the document’s p95 length.
Fragmentation smellA document flooded with very short H5/H6 nodes — over-decomposition.
These flags surface on the PR comment as advisory callouts.

​
How downstream metrics use the tree

  • MCC reads heading-level changes to charge nesting penalties.
  • Filler / Lazy Risk reads section sizes to detect “shallow big doc”.
  • Section Balance penalizes oversized sections at the 95th percentile.
  • Evidence Coverage computes per-section evidence anchor density.

​
References

​
See also