Index nested field topology and preserve generated metadata

[trissim]

What changed

• index immutable direct-child field paths when canonical flat state is extracted or restored
• expose direct-child and descendant queries from ObjectState
• centralize structural replacement and remove invalid partial-state fallbacks
• preserve declaration docs, module provenance, same-name qualnames, and runtime first-line metadata across every dataclass recreation boundary
• preserve inherited annotated validation through lazy and injected configuration types
• pin quality tools and make Ruff block fatal package errors plus diagnostics on Git-derived added lines, without a synchronized violation baseline
• report the historical Black and Mypy baselines explicitly as non-blocking until they are migrated
• release the change as 1.0.21

Why

ObjectState owns both flattened field topology and synthesized lazy/global configuration classes. Consumers should query its derived topology rather than repeatedly rescanning values, and generated classes should retain the documentation and validation semantics of their declaration owners.

Validation

• full ObjectState suite: 158 passed
• real OpenHCS global/pipeline/lazy config smoke: declaration docs preserved and invalid annotated values rejected
• full-package Ruff fatal gate: passed
• Git-derived added-line Ruff gate over 10 changed Python files: passed
• source and workflow diff checks: passed

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[augmentcode]

^{PR Risk Analyzer Agent🛡️}

👀 Human Input Needed
A pair-review briefing is ready for you.

→ Pair Review Briefing