DOCS / UWA V1 RELEASE CONTRACT SELF-HOSTED GATEWAY
Development & contributing
Build reproducibly with Go 1.27.3+, run conformance suites and generate SBOMs.
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 devNo 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.pyCI 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.