Typed read models for the orchestration registry.
Purpose
-------
Provide stable dataclasses for registry reader APIs and native CLI output.
Responsibilities
----------------
- Represent queue history and plan lifecycle events without exposing raw JSON.
- Represent compact plan, actor, and orchestration status projections.
- Keep read-model types dependency-light and immutable.
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
L2 - lifecycle events
L3 - semantic details
L4 - deep tracing
Contracts
---------
- Dataclasses are frozen and safe to return from reader functions.
- Payload mappings are already decoded from canonical JSON by readers.
Dependencies
------------
- dataclasses (immutable record types)
- typing (read-model payload annotations)
- oc_diagnostics (structured debug logging via _dbg)