Runtime Validate Live
Overview
Run live endpoint checks for runtime service behavior and summarize pass/fail signals that matter for go/no-go decisions.
Inputs
repo_root: repository path (run from this directory)base_url: runtime upstream URL (defaulthttps://oci-useast-arm-4.pigeon-justice.ts.net:8443/runtime-v1)- Optional coordinate overrides via environment:
RUNTIME_INTEGRATION_TRAFFIC_LAT,RUNTIME_INTEGRATION_TRAFFIC_LON,RUNTIME_INTEGRATION_TRAFFIC_RADIUS_NMRUNTIME_INTEGRATION_MRMS_LAT,RUNTIME_INTEGRATION_MRMS_LON,RUNTIME_INTEGRATION_MRMS_MIN_DBZ,RUNTIME_INTEGRATION_MRMS_MAX_RANGE_NM
Quick Start
- Run the integration test:
npm run test:integration:runtime
- If you want direct smoke checks without test harness:
bash "<path-to-skill>/scripts/smoke_runtime_endpoints.sh" "<base_url>"
- Report:
- endpoint status,
- key fields (
ready,sqsEnabled, aircraft count), - MRMS wire-format sanity (
AVMR, v2 header basics).
Validation Workflow
- Check local test harness.
- Run
npm run test:integration:runtimefirst.
- Run
- If tests fail, isolate by endpoint.
- Check
/healthz,/v1/meta,/v1/traffic/adsbx, and/v1/weather/volume.
- Check
- Validate invariants.
/healthzreturnsok./v1/metareturns JSON andready: true./v1/traffic/adsbxreturns JSON withaircraftarray and no upstream error string./v1/weather/volumereturnsapplication/vnd.approach-viz.mrms.v4and body withAVMRmagic.
- Summarize with actionable next step.
- Distinguish transient upstream/data gaps from code regressions.
Bundled Resource
scripts/smoke_runtime_endpoints.sh- Run independent smoke checks against a runtime base URL.
- Fail fast on bad HTTP status or malformed payload shape.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.