The Unified Entity Model is Spanda’s foundational abstraction: every managed object — robots, humans, devices, packages, providers, missions, and facilities — is an Entity with consistent identity, evaluation, and lifecycle semantics.
| Before | With Entity Model |
|---|---|
| Separate verify/readiness paths per kind | verify_entity, evaluate_entity_readiness, … |
| Fragmented Control Center navigation | Entities tab + domain pages |
| Ad-hoc dependency questions | Entity graph + query language |
Entity
├── Health (evaluate_entity_health)
├── Readiness (evaluate_entity_readiness)
├── Trust (evaluate_entity_trust)
├── Verification (verify_entity)
├── Relationships & graph traversal
└── Capabilities, lifecycle, security
CONFIG=crates/spanda-config/tests/fixtures/warehouse/spanda.toml
spanda entity list --config "$CONFIG"
spanda entity verify rover-001 --config "$CONFIG"
spanda entity readiness rover-001 --config "$CONFIG"
| Guide | Topic |
|---|---|
| entity-model.md | Core concepts and migration phases |
| entity-apis.md | REST and gRPC endpoint reference |
| entity-sdk.md | Rust, TypeScript, and Python clients |
| entity-registry.md | Registry projection and inventory |
| entity-graph.md | Graph traversal and impact analysis |
| entity-relationships.md | Relationship taxonomy |
| entity-query-language.md | Structured queries |
| entity-verification.md | verify_entity |
| entity-readiness.md | evaluate_entity_readiness |
| entity-health.md | evaluate_entity_health |
| entity-trust.md | evaluate_entity_trust |
| entity-best-practices.md | Adoption patterns |
| entity-migration-guide.md | Backward-compatible migration |
| entity-integration-report.md | Phase status report |
Runnable programs: examples/entity/
Existing /v1/robots, /v1/devices, /v1/fleets, spanda verify, and domain TOML schemas are
unchanged. Entity APIs are additive.