OilProducts Bevy BRP Instrumentation
Overview
Instrument an existing Bevy app so deterministic BRP control and state-probe paths are available and testable.
Keep edits minimal, additive, and feature-gated so normal app behavior stays unchanged.
Workflow
- Enable Bevy remote support in the app.
- Add deterministic BRP methods for the required contract.
- Wire methods to existing game state systems with stable semantics.
- Validate capability discovery and deterministic flows through BRP scenario runs (for example with
bevy-eyes-on).
For the exact method list and behavior, read references/capability-contract.md.
For a practical implementation sequence, read references/implementation-workflow.md.
Guardrails
- Preserve existing controls and gameplay loops unless the task explicitly allows behavior changes.
- Return deterministic unavailability explicitly when a required capability is not implemented.
- Keep BRP exposure local-first for development (localhost endpoints).
- Add small integration checks for capability discovery and deterministic calls.
Validation
After instrumentation, verify deterministic paths with BRP scenario execution:
- At least one action call mutates state as expected.
- At least one probe call returns machine-readable state for gating (
until). - Frame-based wait/progression behaves deterministically when implemented.
- Screenshot capture succeeds after a state gate condition is met.
Use references/validation-checklist.md for a step-by-step validation pass.