Files
light-heart-labs--dreamserver/ods/docs/BACKEND-CONTRACT.md
T
wehub-resource-sync 9e8f1bbeed
Dashboard / frontend (push) Failing after 0s
Dashboard / api (push) Failing after 0s
Lint PowerShell / powershell-lint (ubuntu-latest) (push) Failing after 1s
Python Lint / Lint Python with Ruff (push) Failing after 1s
ShellCheck / Lint shell scripts (push) Failing after 1s
Matrix Smoke / linux-smoke (push) Failing after 1s
Matrix Smoke / distro: cachyos (push) Failing after 15s
Matrix Smoke / distro: linux-mint-21.3 (push) Failing after 15s
Matrix Smoke / distro: debian-12 (push) Failing after 5m21s
Matrix Smoke / distro: fedora-41 (push) Failing after 4m56s
Matrix Smoke / distro: ubuntu-24.04 (push) Failing after 2m13s
Matrix Smoke / distro: rocky-9 (push) Failing after 10m39s
Matrix Smoke / distro: manjaro (push) Failing after 12m11s
Matrix Smoke / distro: opensuse-tw (push) Failing after 11m53s
Matrix Smoke / distro: archlinux (push) Failing after 20m3s
Matrix Smoke / distro: ubuntu-22.04 (push) Failing after 13m49s
Validate .env Schema / tier-1-env-validation (push) Successful in 52s
Validate .env Schema / tier-2-env-validation (push) Successful in 44s
Validate .env Schema / tier-3-env-validation (push) Successful in 52s
Validate .env Schema / tier-4-env-validation (push) Successful in 51s
Validate Extensions Catalog / Check catalog is up-to-date (push) Failing after 9m47s
Secret Scan / Scan for secrets (push) Failing after 21m4s
Validate Docker Compose / Validate Docker Compose files (push) Has been cancelled
Python Type Check / Type check with mypy (push) Has been cancelled
Validate .env Schema / tier-0-env-validation (push) Has been cancelled
Test Linux / integration-smoke (push) Has been cancelled
Lint PowerShell / powershell-lint (windows-latest) (push) Has been cancelled
Matrix Smoke / macos-smoke (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:31:33 +08:00

40 lines
1.1 KiB
Markdown

# Backend Runtime Contract
ODS now defines backend runtime behavior in contract files instead of hardcoded installer branches.
## Contract Files
- `config/backends/amd.json`
- `config/backends/nvidia.json`
- `config/backends/cpu.json`
- `config/backends/apple.json`
Each contract defines:
- LLM engine/service name
- public API port and health URL
- OpenClaw provider name + internal provider URL
## Loader
- `scripts/load-backend-contract.sh`
Example:
```bash
source lib/safe-env.sh
BACKEND_ENV="$(scripts/load-backend-contract.sh --backend amd --env)"
load_env_from_output <<< "$BACKEND_ENV"
echo "$BACKEND_PUBLIC_HEALTH_URL $BACKEND_PROVIDER_URL"
```
## Installer Integration
The modular installer loads backend contracts in `installers/lib/detection.sh` via `load_backend_contract()`. Contract values drive:
- runtime health-check endpoint selection (`installers/phases/12-health.sh`)
- OpenClaw provider wiring (`installers/phases/06-directories.sh`)
- LLM API summary endpoint (`installers/phases/13-summary.sh`)
See [INSTALLER-ARCHITECTURE.md](INSTALLER-ARCHITECTURE.md) for the full module map.