194 lines (150 loc) · 13.6 KB

Responsibility Matrix

Maps every major platform capability to its functional domain, existing services, entity integration, SDK/API, and Control Center surface. Use this matrix to avoid duplicate ownership and clarify contributor boundaries.

Architecture overview: cognitive-resilience-architecture.md · Domain definitions: functional-domains.md

Legend

Column	Meaning
Capability	User-visible or contributor-facing feature
Functional domain	Cognitive & Resilience responsibility owner
Platform services	Existing crates / modules (not duplicated)
Entity integration	Fields on `EntityRecord` / `EntityAutonomyProfile`
SDK / API	REST, gRPC, CLI, SDK client
Control Center	Tab or panel

Strategic Planning

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Mission planning	Strategic Planning	`spanda-mission-planning`, assurance	Mission entities	`spanda mission plan`, REST programs	Mission tab
Policy evaluation	Strategic Planning	`spanda-policy`, governance	`Entity.metadata`	`GET /v1/governance`, `GovernanceClient`	Governance tab
Deployment planning	Strategic Planning	`spanda-deploy`, readiness	`Entity.readiness`	`POST /v1/programs/readiness`	Readiness tab
Simulation planning	Strategic Planning	`spanda-sim`, digital twin	Twin entities	`POST /v1/programs/sim`	Simulation tab
Assurance cases	Strategic Planning	`spanda-assurance`	Capability traceability	`POST /v1/programs/assure`	Assurance tab
Resource planning	Strategic Planning	Fleet, device pool	Fleet parent-child graph	`GET /v1/fleet`	Fleet tab
Governance validation	Strategic Planning	`spanda-governance`	All entities	`POST /v1/governance/validate`	Governance tab
Damage-informed abort	Strategic Planning + Damage Risk	Mission planner + `spanda-autonomy`	`Entity.damage_risk`	Entity autonomy API	Cognitive & Resilience

Operational Coordination

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Fleet coordination	Operational Coordination	`spanda-fleet`, mesh	Fleet/swarm entities	`GET /v1/fleet`, fleet CLI	Fleet tab
Task scheduling	Operational Coordination	`spanda-runtime`, scheduler	Robot entities	Runtime telemetry	Telemetry tab
Delegation / takeover	Operational Coordination	Mission continuity	Human ↔ robot edges	Continuity APIs	Continuity tab
Distributed decisions	Operational Coordination	Decision engine	`local_decision_authority`	`/v1/decisions*`	Decisions tab
Swarm coordination	Operational Coordination	Fleet mesh	Swarm entities	Fleet orchestrate CLI	Fleet map
Mission execution	Operational Coordination	Interpreter, triggers	Mission lifecycle	`spanda run`, `spanda sim`	Mission tab
Recovery orchestration	Operational Coordination + Recovery	Recovery orchestrator	Recovery graph	`/v1/recovery/*`	Recovery tab

Reflex & Safety

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Emergency stop	Reflex & Safety	Runtime safety, kill switch	`Entity.reflexes`	`spanda reflex`, `ReflexClient`	Reflex Events panel
Kill switch	Reflex & Safety	`spanda-runtime` safety engine	Safety metadata	Language `kill_switch`	Security tab
Reflex decision layer	Reflex & Safety	Distributed decisions L0	Reflex summaries	`/v1/decisions` trace	Decisions tab
Reflex traces	Reflex & Safety	`spanda-autonomy` trace buffer	`Entity.reflexes.last_triggered_at`	`/v1/autonomy/reflex/traces`	Reflex Events panel
Runtime protection	Reflex & Safety	Safety types, `stop_if`	Health → reflex trigger	`spanda check`	Health tab
Protective shutdown	Reflex & Safety	Recovery + reflex	`Entity.damage_risk`	Recovery execute	Recovery tab

Homeostasis Engine

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Health monitoring	Homeostasis Engine	`spanda-readiness` entity health	`Entity.health_status`	`GET /v1/entities/{id}/health`	Health tab
Readiness scoring	Homeostasis Engine	`spanda-readiness`	`Entity.readiness_status`	`POST /v1/programs/readiness`	Readiness tab
Stability metrics	Homeostasis Engine	`spanda-autonomy::homeostasis`	`Entity.homeostasis`	`HomeostasisClient`, `/v1/autonomy/homeostasis`	Homeostasis panel
Drift detection	Homeostasis Engine	Homeostasis policy	`Entity.homeostasis.drift_signals`	`spanda homeostasis check`	Homeostasis panel
Auto-correction	Homeostasis Engine	Recovery hooks	Protective actions	Recovery recommend	Recovery tab
Scheduler telemetry	Homeostasis Engine	Runtime scheduler	Platform telemetry snapshot	Runtime context	Trends tab
Trust/readiness in stability	Homeostasis Engine	Entity projection	`Entity.trust`, readiness	Entity list filters	Entities tab

Platform Immunity

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Trust evaluation	Platform Immunity	`spanda-trust`	`Entity.trust_status`	Trust APIs	Security tab
Tamper detection	Platform Immunity	`spanda-tamper`	Metadata `tamper.detected`	Security audit CLI	Security tab
Device quarantine	Platform Immunity	`spanda-autonomy::immunity`	`Entity.immunity_status`	`ImmunityClient`, `/v1/autonomy/immunity`	Platform Immunity panel
Package trust	Platform Immunity	Package provenance	Package entities	Package verify	Security tab
Plugin isolation	Platform Immunity	`spanda-plugin`	Provider entities	Marketplace tab	Marketplace tab
Re-admission	Platform Immunity	Trust + verify	Lifecycle state	`POST /v1/entities/{id}/verify`	Provisioning tab
Policy violations	Platform Immunity	`spanda-policy`	Governance metadata	Governance validate	Governance tab

Sensory Fusion

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Multi-source fusion	Sensory Fusion	`spanda-autonomy::fusion`, `spanda-fusion`	`Entity.confidence`	`FusionClient`, `/v1/autonomy/fusion`	Entity autonomy
Conflict detection	Sensory Fusion	Confidence policy	`Entity.confidence.conflicts`	`spanda confidence report`	Diagnosis tab
Signal agreement	Sensory Fusion	Fusion types	`Entity.confidence.sources`	`spanda fusion check`	—
Readiness impact	Sensory Fusion + Homeostasis	Readiness engine	Readiness partial/degraded	Readiness API	Readiness tab
Diagnosis trigger	Sensory Fusion	`spanda-explain`	Incident entities	`POST /v1/programs/diagnose`	Diagnosis tab

Attention Engine

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Event prioritization	Attention Engine	`spanda-autonomy::attention`	`Entity.attention`	`AttentionClient`, `/v1/autonomy/attention`	Attention Queue panel
Alert suppression	Attention Engine	Habituation policy	`Entity.attention.suppressed_count`	`spanda alerts analyze`	Alerts tab
Critical-first routing	Attention Engine	Attention policy	Top priority on entity	gRPC `GetAutonomyAttention`	Attention Queue panel
Alert fatigue metrics	Attention Engine	`spanda-autonomy::habituation`	—	`spanda alerts fatigue-report`	Alerts tab
Mission event boost	Attention Engine	Attention + mission context	Mission entity link	Attention policy in `.sd`	Mission tab

Operational Memory

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Mission traces	Operational Memory	Replay store	`memory_refs.episodic`	`spanda replay`	Replay tab
Entity graph	Operational Memory	`spanda-config` graph	`memory_refs.semantic`	`GET /v1/entities/graph`	Entities tab
Recovery playbooks	Operational Memory	Recovery orchestrator	`memory_refs.procedural`	`/v1/recovery/playbooks`	Recovery tab
Decision history	Operational Memory	Decision traces	`memory_refs.episodic`	`/v1/decisions/traces`	Decisions tab
Knowledge graph	Operational Memory	`spanda-knowledge-model`	Semantic refs	Assurance APIs	Digital thread
Reflex rules	Operational Memory	Reflex catalog	`memory_refs.reflex`	`/v1/autonomy/reflex`	Reflex Events
Working context	Operational Memory	Mission runtime	`memory_refs.working`	`MemoryClient`, `/v1/autonomy/memory`	Mission tab

Adaptive Learning

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Recovery confidence	Adaptive Learning	`spanda-autonomy::adaptive_recovery`	`Entity.recovery_confidence`	`spanda recovery confidence`	Recovery Confidence panel
Strategy preference	Adaptive Learning	Recovery history stats	`preferred_strategy`	`/v1/recovery/recommend`	Recovery tab
Historical recommendations	Adaptive Learning	Recovery orchestrator	Recovery history	`/v1/recovery/history`	Recovery tab
Rule-based adaptation	Adaptive Learning	AdaptiveRecoveryPolicy	—	`spanda recovery learning-report`	—
Confidence updates	Adaptive Learning	Fusion + recovery bridge	`Entity.confidence` + recovery	Entity autonomy API	Cognitive & Resilience

Damage Risk Assessment

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
Harm-risk index	Damage Risk Assessment	`spanda-autonomy::damage_risk`	`Entity.damage_risk`	`RiskClient`, entity autonomy	Damage Risk panel
Protective actions	Damage Risk Assessment	Recovery + reflex	`protective_action` field	Recovery plan	Recovery tab
Mission abort signal	Damage Risk Assessment	Mission planner input	Risk index threshold	Mission verify	Mission tab
Operator risk	Damage Risk Assessment	Human entity health	Human health fields	Humans tab	Humans tab
Degraded mode trigger	Damage Risk Assessment	Operating modes	Lifecycle + risk	`degraded-modes` runtime	Health tab
Preventative maintenance	Damage Risk Assessment	Prognostics	Metadata signals	`spanda prognostics`	Trends tab

Maintenance & Optimization

Capability	Functional domain	Platform services	Entity integration	SDK / API	Control Center
OTA rollouts	Maintenance & Optimization	Fleet OTA	Firmware version fields	`/v1/ota`	OTA tab
Calibration windows	Maintenance & Optimization	`spanda-autonomy::maintenance`	Lifecycle scheduled	Maintenance mode types	—
Log rotation	Maintenance & Optimization	Telemetry store	—	Telemetry CLI	Telemetry tab
Backup	Maintenance & Optimization	Config snapshots	Config entities	Config tab	Config tab
Resource balancing	Maintenance & Optimization	Fleet scheduler	Fleet readiness	Fleet health	Fleet tab
Sleep / low-activity mode	Maintenance & Optimization	Maintenance module	Metadata	Preview CLI	—

Cross-domain interactions (integration tests)

Interaction	Domains involved	Test location
Reflex triggered by homeostasis drift	Reflex & Safety + Homeostasis	`crates/spanda-autonomy/tests/cognitive_resilience_integration.rs`
Fusion lowers readiness on conflict	Sensory Fusion + Homeostasis	same
Tamper triggers immunity quarantine	Platform Immunity + Trust	same
Attention ranks recovery events	Attention + Recovery	same
Memory refs link to replay traces	Operational Memory + Replay	same
Damage risk informs mission posture	Damage Risk + Strategic Planning	same
Adaptive recovery feeds orchestrator	Adaptive Learning + Recovery	same

Anti-patterns (do not duplicate)

Wrong	Right
New `RobotHealthRecord` parallel to Entity	Extend `EntityRecord` / autonomy profile
Separate immunity service crate	Use `spanda-autonomy::immunity` + trust/tamper
ML fusion pipeline in autonomy crate	Rule-based fusion now; ML via packages later
Brain-anatomy module names	Functional domain names only
Duplicate REST business logic in SDK	SDK clients wrap `/v1/*` endpoints