v0.3.0 — the world-model release

pip install -U trio-retina

The state layer of the world-model stack — now with shipped latent producers and a front-to-back demo, a CLI, a typed package, and a pre-launch hardening pass.

Added

• Latent producers ship — DinoV2Embedder (per-object entity.vec) and VJepa2Embedder (scene-level ws.scene): bring any encoder, out comes one standardized WorldState. pip install 'trio-retina[dino]' / [vjepa].
• The world-model stack, end to end — swap the encoder (YOLO · DINOv2 · V-JEPA 2 → same schema), a small transformer imagines the future off that state, front+back compose through one standard (examples/world_model/, BENCHMARK.md). Flagship soccer demo: real footage → WorldState → predicted player runs.
• retina CLI — retina demo / run / validate / bench (stdlib-only).
• Typed package (py.typed) + concise __repr__s; sample assets (retina.sample_events() / sample_video()); deeper docs (concepts · cookbook · cli · extend · faq).

Fixed (pre-launch hardening)

• WorldState.from_frame no longer crashes on extra vec/scene keys; LineRule pending-state leak + debounce/direction edge cases; schema.validate rejects bool-as-number / bad box / non-object input; Detection.from_supervision short-class_name IndexError; WebhookSink rejects non-http(s) schemes.

Changed

• [all] now includes matplotlib; honesty/wording fixes across docs.

Full notes: CHANGELOG.md