Skip to main content

Capabilities

Every vagary-core capability, generated from its versioned OpenAPI contract β€” endpoints, auth, servers, schemas, and sellable product faces. The contract IS the source of truth.

πŸ“„οΈ Capability reference

Every vagary-core capability, generated from its versioned OpenAPI contract (contracts//v1/openapi.yaml). Each page lists the capability's endpoints, auth, key schemas, and (where it exists) its sellable product face. Public access is via the consolidated API gateway β€” the edge at api. (api.vagarylabs.com master / api.vagaryvoice.cloud voice / api.vagarylife.com life), NOT internal container URLs. This is the master contract authority β€” a capability's page can only be changed by changing its shipped contract.

πŸ“„οΈ Billing & metering

Usage metering + multi-rail billing as a shared capability β€” one account buys across products. METERING multi-rail (Dodo/PayPal/crypto/Razorpay; Stripe DORMANT), subscriptions, invoices, dunning. Metering NEVER blocks a product runtime (queue + reconcile). Payment secrets resolved server-side (Infisical), never in body/DB/logs. SELLER OF RECORD differs by rail (ADR-110 D3) we are the seller and our tax is added. stripe is retained but DORMANT β€” it cannot settle for an India LLP (no PA-CB licence; invite-only) and refuses every charge/refund/capture with 422 regardless of credentials (ADR-110 D4).

πŸ“„οΈ Identity (OIDC)

The fleet identity provider β€” one OIDC issuer for all products, so a single account authenticates across the fleet (the cross-product SSO the census found impossible). Signs RS256/JWKS; per-brand realms. Consolidates the 19-service platform auth + voice + bellring (C3). The signing key is resolved server-side and NEVER present in a repo, a consumer, or a facade. Status Phase 1 ETL β†’ G0 gate β†’ Phase 2 repoint-with-fallback β†’ Phase 3 per-consumer deletes (voice last).

πŸ“„οΈ Observability

Shared observability instrumentation standard (Track H1). Defines the two unauthenticated, tailnet-scoped exposition endpoints every service serves (GET /metrics Prometheus text; GET /health liveness), the Fix-157 label-cardinality/PII policy that is a MANDATORY SDK default, the structured-log JSON schema, and the OTLP tracing env contract. ZERO new store — emits to the existing substrate one-pane (Prometheus/VictoriaMetrics · Alloy→Loki · Tempo/OTLP · GlitchTip). Full policy: standard.md.