Provider Failure Mode Gallery¶
This gallery maps common provider failures to concrete fixture-backed signals. It is for issue triage and adapter review, not live-provider quality ranking.
Run the checkout-safe artifact generator:
uv run python scripts/demo_showcases.py run provider-failure-gallery \
--workspace-dir .worldforge/demo-showcases
Expected success signal: the command exits 0 and writes
provider-failure-gallery/provider-failure-gallery.json plus
provider-failure-gallery/provider-failure-gallery.md. First triage step: find the matching row,
run its first triage command, and attach only the safe artifact named by the row.
| Failure mode | Provider surface | Expected signal | Owner | First triage command | Safe artifact behavior |
|---|---|---|---|---|---|
| invalid prediction state | mock contract fixture | invalid world state contract failure |
adapter contributor | uv run pytest tests/test_provider_contracts.py -q |
attach provider contract JSON or Markdown only |
| unsafe provider event metadata | provider event conformance | secret material rejection before event sinks |
adapter contributor and security reviewer | uv run pytest tests/test_provider_contracts.py -q |
keep raw event logs local-only until redacted |
| score count mismatch | LeWorldModel score boundary | returned 2 score(s) for 3 candidate |
score adapter maintainer | uv run pytest tests/test_leworldmodel_provider.py -k score_count -q |
attach sanitized score metadata; do not attach tensors |
| malformed score request payload | LeWorldModel score boundary | four-dimensional validation error |
score adapter maintainer | uv run pytest tests/test_leworldmodel_provider.py -k malformed_payload -q |
attach tiny JSON fixtures only; keep host tensors local |
| embodied action translator missing | Cosmos-Policy policy boundary | provide action_translator |
prepared host owner | uv run worldforge provider info cosmos-policy |
attach config summaries and shape metadata, not observations |
| unsafe local/private endpoint | Cosmos-Policy configuration | local/private destination |
host runtime owner and security reviewer | uv run pytest tests/test_cosmos_policy_provider.py -k local_base_url -q |
do not attach private host names or bearer tokens |
| malformed json_numpy action shape | Cosmos-Policy response parser | action_dim must be 14 |
policy adapter maintainer | uv run pytest tests/test_cosmos_policy_provider.py -k json_numpy_action_dim -q |
attach bounded shape metadata only; do not attach observations |
| missing optional runtime package | prepared-host optional provider | unhealthy provider info with a setup hint | prepared host owner | uv run worldforge provider info gr00t |
attach runtime manifest and redacted provider info only |
| scaffold provider remains fail-closed | Genie scaffold contract | configured scaffold with no exercised operations | provider maintainer | uv run worldforge provider contract genie --format json |
attach contract output; do not claim real Genie integration |
Boundaries¶
- The gallery is checkout-safe. It does not call paid APIs, use credentials, install optional runtimes, or download checkpoints.
- Provider events, health output, issue bundles, and contract reports must stay sanitized before attachment.
- raw provider request bodies, signed URLs,
.envfiles, private checkpoints, and host-local payload paths remain local-only. - Scaffold providers are shown as failure boundaries. A fail-closed scaffold row is not evidence of a real provider integration.