AGENTS.md@infrastructure/prose/analysis git:20260503.72c1838A

Immutable. This exact content is served forever at /api/v1/blob/1eda159d5847a1d8.

# `prose.analysis` submodule

## Role

Frozen dataclasses and pure helpers used by [`infrastructure/prose`](../):

| Module | Contents |
| --- | --- |
| `metrics.py` | Syllables, sentences, `compute_metrics` (Flesch, FKGL, Fog, …). |
| `structure.py` | Heading parse, outline, section depth. |
| `quality.py` | Passive voice, hedges, long sentences, Pandoc-ish `@cite` snippets. |

## Invariants

- **No `open()`, no sockets.** Same inputs → same outputs (deterministic).
- Changing a metric shape requires updating [`ManuscriptReport`](../report.py) builders and [`tests/infra_tests/prose/`](../../../tests/infra_tests/prose/).

## See also

- [`README.md`](README.md)
- [`../AGENTS.md`](../AGENTS.md)