Guidance for adopting the Unified Entity Model without breaking existing workflows.
Use spanda entity query, GET /v1/entities/query, or Control Center Entities when the
question spans robots, devices, packages, and humans. Keep domain APIs (/v1/devices, /v1/robots)
for authoring and pool operations.
Run the entity evaluation trio on critical paths:
spanda entity verify rover-001 --program mission.sd --dependencies
spanda entity readiness rover-001 --program mission.sd
spanda entity trust rover-001 --program mission.sd
Add new industry objects as EntityKind variants and projection in build_entity_registry. Keep
TOML source types authoritative.
Model depends_on, assigned_to, and participates_in edges so entity graph, traceability, and
verification dependency checks stay accurate.
Use POST /v1/entities/register for runtime overlay; POST /v1/entities/sync to persist durable
fragments. Do not edit generated registry JSON by hand.