Documentation
DocumentationDevelopment & contributing
DOCS / UWA V1 RELEASE CONTRACT SELF-HOSTED GATEWAY

Development & contributing

Build reproducibly with Go 1.27.3+, run conformance suites and generate SBOMs.

ONE GATEWAYCoordinates → eligible provider → canonical responseWhy UWA
On this page 3 sections

#Local website build

The documentation website is a dependency-free Node 20+ static generator. From website/, run:

npm run check
npm run dev

No live gateway or external font request is needed to build or test the website.

#Gateway validation and SBOM generation

go mod verify
go test -race -count=1 ./...
go vet ./...
python3 scripts/check_no_llm_dependencies.py
python3 scripts/generate_sbom.py

CI workflows (.github/workflows/ci.yml) pin immutable action commits, run with read-only repository permissions, verify module checksums, and enforce zero LLM dependencies.

#Contribution standards

Document changes to providers, request contracts, licensing assumptions and runtime configuration; add regression tests in tests/; never log or expose upstream credentials. The repository is distributed under the MIT License (LICENSE).

Canonical contracts: docs/openapi.yaml (lean_v1) and docs/openapi.experimental.yaml · Verify against your build before production use.

Search local documentation. No external requests.

↑↓ to move · Enter to openESC to close