Runnable scripts and CI jobs that validate experimental Tier 3 capabilities and v0.5 beta P0 blockers. Phase 23 added platform wiring; Phase 24 extends v1.0-optional showcases; Phase 25 adds beta golden paths.
CI tiers: PRs gate on CI Fast; golden paths and smokes run on main via CI
Integration or CI Nightly (daily). Full job map:
ci-architecture.md.
See tier-3-experimental.md for feature status and tier-3-priority-plan.md for P0–P4 ordering.
| Capability | Script | CI job | Tier | Example |
|---|---|---|---|---|
| Killer demo | killer_demo_golden_path.sh | killer-demo-golden-path |
Integration | killer_demo.sd |
| Live AI (OpenAI mock/live) | live_ai_golden_path.sh | live-ai-golden-path |
Nightly | live_openai.sd |
ROS2 rclpy /cmd_vel |
ros2_golden_path.sh | ros2-golden-path |
Nightly | ros2_cmd_vel_ping.sd |
| Hosted registry install | registry_golden_path.sh | registry-golden-path |
Integration | spanda-openai, spanda-ros2 |
CI verify --json gate |
ci_verify_golden_path.sh | ci-verify-golden-path |
Integration | hardware_compatibility.sd |
| Python PyO3 in-process FFI | python_native_golden_path.sh | python-native-golden-path |
Nightly | ffi_python_extern.sd |
| Capability | Script | CI job | Tier | Example |
|---|---|---|---|---|
| All examples type-check | check_all_examples.sh | core-smokes |
Integration | examples/** |
| Robotics deploy/fleet | golden_path_deploy.sh | robotics-golden-path |
Integration | fleet_field_trial.sd |
| Live MQTT | mqtt_golden_path.sh | mqtt-golden-path |
Nightly | mqtt_live.sd |
| Twin cloud export (legacy) | twin_cloud_golden_path.sh | twin-cloud-stable-promotion-gate |
Nightly | twin_replay_golden.sd |
| Twin Cloud SaaS | twin_cloud_saas_smoke.sh | twin-cloud-golden-path |
Integration | patrol.sd |
| LLVM native codegen | llvm_golden_path.sh | llvm-golden-path |
Nightly | hello_world.sd |
| LLVM aarch64 (Jetson/Pi slice) | llvm_embedded_golden_path.sh | llvm-embedded-golden-path |
Nightly | hello_world.sd |
| C++ in-process FFI | cpp_native_golden_path.sh | cpp-native-golden-path |
Nightly | ffi_cpp_extern.sd |
| Ledger scaffold | ledger_golden_path.sh | ledger-golden-path |
Nightly | spanda-ledger |
| Self-host lexer | self_host_lexer_golden_path.sh | self-host-lexer-golden-path |
Nightly | lexer_keywords.sd |
| World model fusion | world_model_golden_path.sh | world-model-golden-path |
Nightly | world_model_patrol.sd |
Build the CLI once:
cargo build -p spanda-cli --release
export PATH="$PWD/target/release:$PATH"
Or match the PR gate:
./scripts/ci-fast.sh
Then run any script from the repo root:
./scripts/killer_demo_golden_path.sh # v0.5 beta flagship
./scripts/live_ai_golden_path.sh # OpenAI bridge mock path
./scripts/registry_golden_path.sh # file:// registry install
./scripts/ros2_golden_path.sh # requires ROS 2 Humble + rclpy
./scripts/world_model_golden_path.sh # no extra deps
./scripts/llvm_embedded_golden_path.sh # aarch64 triple when clang supports it
./examples/robotics/golden_path_deploy.sh
| Feature | Build flag | Runtime env |
|---|---|---|
| Live MQTT | --features live-mqtt |
SPANDA_LIVE_MQTT=1 |
| Live transport bundle | --features live-transport |
MQTT + WebSocket + DDS env vars |
| C++ in-process | --features cpp-native |
unset SPANDA_CPP_SUBPROCESS |
| LLVM codegen | --features llvm (default) |
clang on PATH |
| Guide | Topic |
|---|---|
| how-packages-work.md | spanda.toml, lock, vendor, spanda install / update |
| how-providers-work.md | Provider registry, traits, bootstrap |
| how-runtime-resolution-works.md | Import → dispatch → telemetry / replay |