Strategic expansion plan for signature platform capabilities that differentiate Spanda as the Safety, Verification, Readiness, Assurance, Diagnosis, Recovery, Trust, and Continuity platform for autonomous systems.
This document extends — does not replace —
platform-maturity-roadmap.md. Every item composes existing
engines (spanda-readiness, spanda-assurance, spanda-capability, spanda-hardware,
spanda-security, spanda-audit, replay, simulation) rather than duplicating them.
Principle: Lean core. Heavy implementations ship as packages. Contracts and CLI live in focused crates.
Related: roadmap.md · product-strategy.md · feature-status.md · platform-maturity-roadmap.md
Last updated: 2026-07-02
These six capabilities define Spanda’s market identity. Protect them in every release decision.
| # | Capability | What it means | Current home |
|---|---|---|---|
| 1 | Safety-Typed AI | ActionProposal cannot reach actuators; only SafeAction from safety.validate() can. Compile-time and runtime enforced. |
spanda-typecheck, spanda-safety, runtime gate |
| 2 | Mission Contracts | Missions as verifiable first-class entities with guarantees, constraints, assumptions, invariants, and objectives. | spanda-contract (Stable) |
| 3 | Readiness Engine | Weighted go/no-go scoring across health, verify, safety, trust, and mission achievability. | spanda-readiness (Stable) |
| 4 | Continuity & Takeover | Checkpoint resume, delegation, succession, safety-gated takeover across robots and fleet. | spanda-assurance continuity (Stable) |
| 5 | Trust Framework | Composite trust scoring across packages, hardware, configuration, identity, and safety integrity. | spanda-trust (Stable) |
| 6 | Explainability & Audit Trail | Why did the system decide X? Decision → evidence → safety check → action, with trace replay. | spanda-explain, spanda-decision (Stable) |
| Question | Answered by |
|---|---|
| Can this mission run? | Mission Contracts + Readiness + spanda verify |
| Can this robot safely perform this mission? | Safety-Typed AI + Safety Coverage + safety { } |
| Does the hardware satisfy the required capabilities? | spanda verify + capability traceability |
| Is the system healthy enough to deploy? | Readiness Engine + Health Framework |
| Can it run safely? | Safety-Typed AI + Safety Coverage |
| Can it recover? | Recovery Coverage + Recovery Framework |
| Can it continue? | Continuity & Takeover |
| Who can take over when a robot or fleet member fails mid-mission? | Continuity & Takeover + Succession Planning |
| Can it be trusted? | Trust Framework + Certification Packs |
| Why should this deployment be trusted? | Trust Framework + Readiness + Assurance evidence |
| Why did it behave this way? | Explainability + Decision Audit Trail |
| What happened when something failed? | Diagnosis Engine + Replay + Decision Audit Trail |
| What evidence supports deployment? | Certification Packs + Assurance Cases |
| Horizon | Timeline | Areas |
|---|---|---|
| NOW | 0–3 months (v0.5+) | Mission Contracts, Explainability, Decision Audit Trail, Safety Coverage, Recovery Coverage |
| NEXT | 3–6 months (v0.6) | What-If Analysis, Mission Risk Analysis, Readiness Forecasting, Trust Graph, Scorecards |
| LATER | 6–12 months (v0.7–v1.0) | Digital Mission Twin, Certification Packs, Mission Time Travel Enhancements, Human/Robot Teaming, Autonomous Governance |
| # | Area | CLI (target) | Crate | Status |
|---|---|---|---|---|
| 1 | Mission Contracts | spanda contract verify, spanda mission verify (extended) |
spanda-contract |
Stable |
| 2 | Explainability | spanda explain <file>, spanda explain mission.trace |
spanda-explain |
Stable |
| 3 | Decision Audit Trail | embedded in traces; spanda audit decisions |
spanda-decision |
Stable |
| 4 | Safety Coverage | spanda safety-coverage <file> |
extends spanda-readiness |
Stable |
| 5 | Recovery Coverage | spanda recovery-coverage <file> |
extends spanda-assurance |
Stable |
| # | Area | CLI (target) | Crate | Status |
|---|---|---|---|---|
| 6 | What-If Analysis | spanda what-if <file> |
spanda-whatif |
Stable |
| 7 | Mission Risk Analysis | spanda risk <file> |
spanda-risk |
Stable |
| 8 | Readiness Forecasting | spanda readiness forecast |
extends spanda-readiness |
Stable |
| 9 | Trust Graph | spanda trust-graph <file> |
spanda-graph + spanda-trust |
Stable |
| 10 | Scorecards | spanda score <file> |
spanda-score |
Stable |
Control Center REST /v1/analytics/* and gRPC GetAnalytics* RPCs (proto semver from GET
/v1/version — currently 1.0.14) expose NEXT analytics with REST parity.
LATER analytics REST
/v1/analytics/{mission-twin,certification-pack,time-travel,human-teaming,governance} and gRPC
GetAnalyticsMissionTwin, GetAnalyticsCertificationPack, GetAnalyticsTimeTravel,
GetAnalyticsHumanTeaming, GetAnalyticsGovernance (proto 1.0.7) mirror CLI parity; Analytics
tab in Control Center UI loads all nine panels.
| # | Area | CLI (target) | Crate | Status |
|---|---|---|---|---|
| 11 | Digital Mission Twin | spanda twin mission |
extends spanda-readiness twin |
Stable |
| 12 | Certification Packs | spanda certify pack [--bundle] |
CLI bundle composer + spanda-certify |
Stable |
| 13 | Mission Time Travel | spanda replay <trace> --at <ts> --inspect <facets> |
extends spanda-runtime replay |
Stable |
| 14 | Human/Robot Teaming | spanda team verify |
extends spanda-readiness teaming |
Stable |
| 15 | Autonomous Governance | spanda governance <file> [--policy] |
spanda-policy |
Stable |
Showcases: examples/showcase/{mission_twin,certify/deployment_bundle,human_robot,governance}/;
time travel uses differentiation/decision_trail/. Smoke: scripts/later_differentiation_smoke.sh;
demo: spanda demo later. Promotion gate: scripts/differentiation_promotion_gate.sh.
Goal: Make missions verifiable first-class entities.
Language constructs:
mission WarehousePatrol {
guarantees:
all_checkpoints_visited;
safety:
no_collision;
continuity:
auto_takeover;
constraint max_duration = 2 h;
assumption gps_available;
invariant battery_level > 20%;
objective visit_all_zones;
}
Core types: MissionContract, MissionGuarantee, MissionConstraint, MissionAssumption,
MissionInvariant, MissionObjective.
Verify: guarantees, assumptions, constraints, completion requirements.
Integrates with: spanda verify, Readiness (mission verify), Assurance (assurance_case),
Continuity (continuity_policy).
See mission-contracts.md.
Goal: Explain autonomous behavior — static analysis and trace-backed decisions.
Core types: ExplanationEngine, DecisionExplanation, MissionExplanation,
SafetyExplanation, RecoveryExplanation.
CLI:
spanda explain mission.trace
spanda explain rover.sd
spanda explain readiness --file rover.sd
Output: Decision, Reason, Evidence, Alternatives Considered, Safety Rules Applied.
Integrates with: Assurance diagnosis, Readiness failures, Replay traces, Audit records.
Extends platform-maturity Area 7. See explainability.md.
Goal: Trace every important decision through the operational stack.
Core types: DecisionRecord, DecisionEvidence, DecisionTimeline, DecisionChain.
Trace chain:
Mission → Decision → Evidence → Safety Check → Action
Integrates with: Mission trace replay (--record), spanda-audit, Assurance evidence,
Telemetry store.
Emitted automatically during run/sim when SPANDA_DECISION_TRACE=1. Consumed by spanda
explain and spanda replay --at.
Goal: Maintain a digital representation of mission state — progress, health, readiness, risks, recovery status.
Core types: MissionTwin, MissionStateModel, MissionRiskModel, MissionForecast.
Integrates with: Existing twin blocks, Readiness twin module, Telemetry store, What-If (NEXT),
Replay (LATER).
Extends local digital twin — not a cloud SaaS. Heavy forecasting backends ship as packages.
See digital-mission-twin.md (LATER).
Goal: Predict mission outcomes under failure scenarios.
CLI:
spanda what-if mission.sd
spanda what-if mission.sd --scenario gps_failure
Scenarios: GPS failure, battery failure, connectivity loss, robot failure, fleet failure, swarm failure, provider failure, package failure.
Output: Impact, Risk, Recovery Plan, Probability (heuristic v1; package ML backends optional).
Integrates with: Recovery planner, Assurance resilience, Sim fault injection, Readiness degradation model.
See what-if-analysis.md (NEXT).
Goal: Assess deployment risk before field operation.
Core types: MissionRiskAssessment, MissionRiskScore, MissionRiskFactor.
CLI:
spanda risk mission.sd
spanda risk mission.sd --json
Output: Risk Score, Risk Contributors, Recommended Mitigations.
Integrates with: Readiness, Safety Coverage, Recovery Coverage, Trust Framework, spanda
verify.
See mission-risk-analysis.md (NEXT).
Goal: Coverage reporting for safety scenarios.
Core types: SafetyCoverageReport, SafetyScenario, CoverageGap.
CLI:
spanda safety-coverage rover.sd
Scenarios evaluated: Obstacle avoidance, GPS failure, battery failure, connectivity failure, provider failure, takeover failure, recovery failure.
Output per scenario: Covered · Partially Covered · Uncovered.
Integrates with: Safety auditor, simulate_compatibility, Recovery policies, Continuity
policies, Readiness safety factor.
See safety-coverage.md.
Goal: Measure recovery readiness against known failure modes.
Core types: RecoveryCoverageReport, RecoveryScenario, RecoveryGap.
CLI:
spanda recovery-coverage rover.sd
Output: Known Failures, Recovery Plans, Coverage %, Missing Recovery Paths.
Integrates with: recovery_policy, Recovery planner, Assurance resilience, Chaos
(platform-maturity Area 8).
See recovery-coverage.md.
Goal: Predict future readiness and time-based degradation.
Core types: ReadinessHistory, ReadinessForecast, ReadinessPrediction.
CLI:
spanda readiness forecast rover.sd
spanda readiness trends # history from .spanda/readiness-history.json
Evaluates: Current readiness, future readiness, projected risks, time-based degradation.
Extends readiness-trends.md (platform-maturity Area 10).
Goal: Visualize trust relationships across the deployment stack.
Core types: TrustGraph, TrustDependency, TrustPath.
Chain:
Mission → Capability → Hardware → Package → Provider → Trust Score
CLI:
spanda trust-graph rover.sd
spanda trust-graph rover.sd --format mermaid
Composes dependency-graphs.md (Area 2) with trust-framework.md (Area 11).
Goal: Generate deployment-ready evidence bundles.
Core types: CertificationPack, CertificationEvidence, ComplianceEvidence.
CLI:
spanda certify rover.sd
spanda certify rover.sd --bundle deployment-evidence.zip
Bundle includes: Verification evidence, Safety evidence, Readiness evidence, Assurance evidence, Trust evidence, Traceability evidence.
Extends existing certify metadata and spanda certify prove. Templates, not accredited
certifications.
See certification-packs.md (LATER).
Goal: Replay mission state at any point in time.
Core types: MissionTimeTravel, HistoricalMissionState, TimelineExplorer.
CLI:
spanda replay mission.trace --at 2026-06-24T14:32:00Z
spanda replay mission.trace --at 14:32:00 --inspect decisions|health|readiness|safety
Capabilities: Inspect state, decisions, health, readiness, safety at timestamp.
Extends replay.md v3 traces with decision snapshots. Consumes Decision Audit Trail.
See mission-time-travel.md (LATER).
Goal: Support collaborative autonomy with verified approval and escalation paths.
Core types: HumanApproval, HumanOverride, HumanEscalation, HumanReview.
Example:
mission Patrol {
requires approval Operator;
escalation on critical_fault -> Supervisor;
}
Verify: Approval path, escalation path, fallback path.
Builds on existing requires approval, SPANDA_OPERATOR_APPROVAL, and Recovery approval hooks.
See human-robot-teaming.md (LATER).
Goal: Policy-driven operational rules for autonomous systems.
Core types: GovernancePolicy, OperationalPolicy, MissionPolicy, RiskPolicy.
Example:
policy NightOps {
no_operation_after 22:00;
max_speed = 2 m/s;
}
Extends policy-engine.md (platform-maturity Area 5). Verify-time first; runtime enforcement in LATER phase.
Goal: Executive-level platform assessment.
Core types: Scorecard, SafetyScore, ReadinessScore, TrustScore, ResilienceScore,
AssuranceScore, RiskScore.
CLI:
spanda score rover.sd
spanda score rover.sd --json --format markdown
Output: Category scores, overall score, recommendations.
Pure composition layer — no duplicate scoring logic. See scorecards.md.
flowchart TB
subgraph core ["Lean core (contracts + CLI)"]
CTR["spanda-contract"]
EXP["spanda-explain"]
DEC["spanda-decision"]
WIF["spanda-whatif"]
RSK["spanda-risk"]
SCR["spanda-score"]
end
subgraph extends ["Extends existing crates"]
RDY["spanda-readiness"]
ASR["spanda-assurance"]
CER["spanda-certify"]
GRP["spanda-graph"]
TRS["spanda-trust"]
POL["spanda-policy"]
end
subgraph stable ["Stable engines (reuse)"]
HW["spanda-hardware"]
CAP["spanda-capability"]
SEC["spanda-security"]
AUD["spanda-audit"]
RPL["replay / telemetry"]
end
SD[".sd source + traces"] --> core & extends
core --> extends & stable
extends --> stable
core --> CLI["spanda-cli"]
extends --> CLI
| Subsystem | Impact | Risk | Mitigation |
|---|---|---|---|
| Parser / AST | mission { } contract blocks; policy { } (LATER) |
Medium | Opt-in keywords; experimental gate in docs |
| Type checker | Contract rule types; policy types | Low | New decl kinds; SafeAction gate unchanged |
spanda-readiness |
Safety/recovery coverage, forecast, scorecard composition | Medium | Additive APIs only |
spanda-assurance |
Recovery coverage, decision evidence, contract verify | Medium | Compose existing planners |
spanda-verify |
Contract + coverage hooks | Low | New flags; default behavior identical |
| Replay / telemetry | Decision records, time-travel snapshots | Medium | Trace format version field |
| Runtime | Decision emission, human approval paths | Medium | Feature flags; off by default |
| Packages | ML forecast backends, secure-boot attestation | Low | Package-only |
check, verify, readiness, sim, replay behavior unchanged.killer_demo, continuity_smoke, cargo test --workspace) pass after each phase.extern python / packages)| Component | Core | Package | Notes |
|---|---|---|---|
| Mission contract syntax + static verify | ✓ spanda-contract |
Parser, AST, typecheck | |
| Contract runtime enforcement | ✓ interpreter hooks | Lightweight guards | |
| Explainability (static) | ✓ spanda-explain |
Composes diagnostics | |
| Explainability (trace decisions) | ✓ spanda-decision |
Trace format in core | |
| Decision audit trail emission | ✓ runtime + audit | ||
| Safety / recovery coverage analysis | ✓ readiness + assurance | Scenario catalog in core | |
| What-if scenario engine | ✓ spanda-whatif |
Heuristic v1 in core | |
| What-if ML probability | spanda-whatif-ml |
Optional ONNX backend | |
| Mission risk scoring | ✓ spanda-risk |
||
| Readiness forecast (heuristic) | ✓ spanda-readiness |
||
| Readiness forecast (learned) | spanda-readiness-ml |
Package backend | |
| Trust graph visualization | ✓ spanda-graph |
||
| Trust attestation (TPM, secure boot) | spanda-trust-jetson, spanda-trust-pi |
Vendor-specific | |
| Scorecard rollup | ✓ spanda-score |
Pure composition | |
| Digital mission twin (local) | ✓ readiness twin | ||
| Digital mission twin (cloud sync) | spanda-twin-cloud crate + /v1/twins/* |
Stable | |
| Certification pack export | ✓ spanda-certify |
||
| Compliance profile templates | ✓ spanda-compliance |
Industry packs as packages | |
| Mission time travel | ✓ replay extensions | ||
| Human approval UI | spanda-approval-console |
Web/console package | |
| Autonomous governance runtime | ✓ spanda-policy |
Verify-time first | |
| GPS spoofing cross-check | spanda-spoofing-gps |
Per platform-maturity |
Every roadmap area integrates with the platform engines. ✓ = primary integration; ○ = secondary.
| Area | Readiness | Assurance | Diagnosis | Recovery | Trust | Health | Continuity | Mission Verify | Cap Verify | HW Verify | Simulation | Replay | Audit | Traceability |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mission Contracts | ✓ | ✓ | ○ | ○ | ○ | ○ | ✓ | ✓ | ✓ | ✓ | ○ | ○ | ✓ | ✓ |
| Explainability | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ○ | ✓ | ○ | ✓ | ✓ | ✓ |
| Decision Audit Trail | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ○ | ○ | ○ | ✓ | ✓ | ✓ | ✓ |
| Safety Coverage | ✓ | ✓ | ○ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ |
| Recovery Coverage | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| What-If Analysis | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ○ | ✓ |
| Mission Risk Analysis | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ |
| Readiness Forecasting | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ○ | ✓ | ○ | ○ | ○ | ✓ | ✓ | ○ |
| Trust Graph | ✓ | ○ | ○ | ○ | ✓ | ○ | ○ | ✓ | ✓ | ✓ | ○ | ○ | ✓ | ✓ |
| Scorecards | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Digital Mission Twin | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ○ | ✓ | ✓ | ✓ | ✓ |
| Certification Packs | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ✓ |
| Mission Time Travel | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ | ○ | ○ | ○ | ✓ | ✓ | ✓ | ✓ |
| Human/Robot Teaming | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ○ | ○ | ✓ | ✓ | ○ |
| Autonomous Governance | ✓ | ✓ | ○ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ○ | ✓ | ✓ |
spanda-contract → spanda-ast, spanda-readiness, spanda-assurance, spanda-capability, spanda-hardware
spanda-explain → spanda-assurance, spanda-readiness, spanda-hardware, spanda-decision
spanda-decision → spanda-audit, spanda-assurance
spanda-whatif → spanda-assurance, spanda-readiness, spanda-hardware, spanda-interpreter (inject)
spanda-risk → spanda-readiness, spanda-contract, spanda-assurance
spanda-score → spanda-readiness, spanda-assurance, spanda-risk, spanda-trust
spanda-graph → spanda-ast, spanda-capability, spanda-trust (trust-graph mode)
Coverage analysis extends spanda-readiness and spanda-assurance — no new crates for
safety/recovery coverage.
| Document | Action | When |
|---|---|---|
| differentiation-roadmap.md | Created (this file) | Now |
| roadmap.md | Add Differentiation section | Now |
| product-strategy.md | Signature capabilities section | Now |
| feature-status.md | Planned differentiation matrix | Now |
| Document | Area | Horizon |
|---|---|---|
| mission-contracts.md | Mission Contracts | NOW |
| explainability.md | Explainability | NOW (exists) |
| decision-audit-trail.md | Decision Audit Trail | NOW |
| safety-coverage.md | Safety Coverage | NOW |
| recovery-coverage.md | Recovery Coverage | NOW |
| what-if-analysis.md | What-If Analysis | NEXT |
| mission-risk-analysis.md | Mission Risk Analysis | NEXT |
| readiness-trends.md | Readiness Forecasting | NEXT (exists) |
| trust-framework.md + dependency-graphs.md | Trust Graph | NEXT |
| scorecards.md | Scorecards | NEXT (exists) |
| digital-mission-twin.md | Digital Mission Twin | LATER |
| certification-packs.md | Certification Packs | LATER |
| mission-time-travel.md | Mission Time Travel | LATER |
| human-robot-teaming.md | Human/Robot Teaming | LATER |
| policy-engine.md | Autonomous Governance | LATER (exists) |
When each area ships: CHANGELOG.md, feature-status.md, getting-started.md (if demo-worthy),
docs/README.md, and README.md signature section.
spanda demo differentiation (NOW phase exit criteria)Single scripted demo covering the five NOW areas on examples/showcase/differentiation/:
| Step | Command | Audience sees |
|---|---|---|
| 1 | Show mission WarehousePatrol { guarantees: … } |
Verifiable mission contract in source |
| 2 | spanda contract verify warehouse.sd |
Guarantee/constraint/assumption report |
| 3 | spanda safety-coverage warehouse.sd |
Scenario coverage matrix |
| 4 | spanda recovery-coverage warehouse.sd |
Recovery path coverage % |
| 5 | spanda sim warehouse.sd --record + inject fault |
Decision trail in trace |
| 6 | spanda explain mission.trace |
Decision, reason, evidence, safety rules |
| Example | Demonstrates | Horizon |
|---|---|---|
examples/showcase/differentiation/warehouse_patrol.sd |
Mission Contracts + coverage | NOW |
examples/showcase/differentiation/decision_trail/ |
Decision audit + explain | NOW |
examples/showcase/what_if/gps_failure.sd |
What-if GPS failure | NEXT |
examples/showcase/risk/deployment_risk.sd |
Mission risk score | NEXT |
examples/showcase/forecast/degradation.sd |
Readiness forecast | NEXT |
examples/showcase/trust_graph/rover.sd |
Trust dependency graph | NEXT |
examples/showcase/scorecard/executive.sd |
Executive scorecard | NEXT |
examples/showcase/mission_twin/patrol.sd |
Digital mission twin | LATER |
examples/showcase/certify/deployment_bundle/ |
Certification pack export | LATER |
examples/showcase/time_travel/incident/ |
Replay at timestamp | LATER |
examples/showcase/human_robot/approval_escalation.sd |
Human approval paths | LATER |
| Script | Covers |
|---|---|
scripts/differentiation_smoke.sh |
contract verify, safety-coverage, recovery-coverage, explain, decision trail audit/explain |
scripts/what_if_smoke.sh |
what-if scenarios (NEXT) |
scripts/risk_smoke.sh |
mission deployment risk score (NEXT) |
scripts/readiness_forecast_smoke.sh |
readiness forecast horizons (NEXT) |
scripts/trust_graph_smoke.sh |
trust-weighted dependency graph (NEXT) |
scripts/scorecard_smoke.sh |
score rollup (NEXT) |
| Persona | NOW value | NEXT value | LATER value |
|---|---|---|---|
| Robotics engineer | Mission contracts in CI; safety/recovery coverage gaps before deploy | What-if failure scenarios; risk score in PR checks | Time-travel incident debug |
| Safety engineer | Verifiable guarantees; safety coverage report | Risk contributors + mitigations | Certification evidence bundle |
| Ops / fleet manager | Explainability on traces; decision audit | Readiness forecast; trust graph | Digital mission twin dashboard |
| Executive / PM | — | Scorecard with recommendations | Governance policies + certify pack |
Week 1: spanda check + verify (existing)
Week 2: spanda contract verify + safety-coverage in CI ← NOW unlock
Week 3: spanda explain on mission traces ← NOW unlock
Month 2: spanda risk + what-if in release gate ← NEXT unlock
Month 3: spanda score for stakeholder reviews ← NEXT unlock
Month 6: spanda certify bundle for field deployment ← LATER unlock
| Capability | Before | After differentiation |
|---|---|---|
| Mission verifiability | mission verify (achievability) |
Full contract with guarantees/constraints |
| Post-incident explanation | spanda diagnose (root cause) |
Decision chain with evidence and alternatives |
| Deploy confidence | Readiness score | Coverage matrices + risk score + scorecard |
| Trust narrative | Audit records (local) | Trust graph + certification packs |
| Executive story | Fragmented CLI reports | Single spanda score rollup |
| Risk | Mitigation |
|---|---|
| Overlap with platform-maturity roadmap | Explicit composition; cross-links in both docs |
| Contract syntax complexity | Start with 5 constructs; expand from user feedback |
| False confidence from heuristic what-if | Label probabilities as estimates; require human review |
| Certification pack liability | Mark as evidence templates, not accredited certs |
| Trace format churn | Version field on decision records; backward-compatible replay |
| Deliverable | Tests |
|---|---|
mission { } contract syntax + AST |
Parser golden fixtures |
spanda contract verify |
Contract pass/fail CI |
| Safety coverage report | Scenario matrix golden JSON |
| Recovery coverage report | Coverage % golden JSON |
| Decision record emission in traces | Trace schema v3 tests |
spanda explain (static + trace) |
Fixture explanations |
Exit met (v0.5.0): spanda demo differentiation + scripts/differentiation_smoke.sh green.
| Deliverable | Tests |
|---|---|
spanda what-if |
Scenario injection tests |
spanda risk |
Risk score golden JSON |
spanda readiness forecast |
History + forecast fixtures |
spanda trust-graph |
Mermaid golden output |
spanda score |
Scorecard composition tests |
Exit met (Stable, v0.5.0): All five NEXT pillars promoted — see stable-hardening guides for what-if, mission-risk, readiness-forecast, trust-graph, and scorecards.
| Deliverable | Tests |
|---|---|
| Digital mission twin | spanda twin mission + patrol showcase |
spanda certify pack --bundle |
Bundle evidence manifest |
spanda replay --at |
Time-travel snapshot tests + golden trace |
| Human approval verify paths | spanda team verify |
| Autonomous governance | spanda governance + policy blocks |
Exit met (Stable, v0.7): All five LATER pillars promoted — see stable-hardening guides for
mission time travel, digital mission twin, certification packs, human/robot teaming, and autonomous
governance; scripts/later_differentiation_stable_promotion_gate.sh + CI
later-differentiation-stable-gates.