Examples
Service repos with explicit readiness
A service contract that keeps healthchecks, setup, and readiness visible.
copynew usersbasicstable2026-05-30
Recommended next
Typical signals
- service startup and healthchecks
- setup tasks for dependencies
- CI that validates the contract before deployment
- clear writable and protected paths
Example contract
ota.yamlyaml
version: 1metadata: ota: minimum_version: "1.6.26"project: name: platform-service description: Service repo with a typed launch and readiness boundaryexecution: default_context: host contexts: host: backend: nativesurfaces: api: kind: http label: Local API purpose: Developer-facing service endpoint visibility: public port: 8080 path: /health readiness: kind: http path: /health timeout: 10stasks: setup: command: exe: make args: - setup check: command: exe: make args: - check depends_on: - setup ci: aggregate: tasks: - check dev: launch: kind: command exe: make args: - serve depends_on: - setup runtime: kind: service surfaces: - apiworkflows: default: verify verify: intent: validation run: task: ci development: intent: local_development setup: task: setup run: task: dev readiness: surfaces: - apiagent: entrypoint: setup default_task: ci safe_tasks: - setup - check - ci verify_after_changes: - ci