API

One stable API

Read-only, versioned, deterministic. Authenticated with an API key; correct HTTP status codes; request IDs for correlation.

POST/composeCompose a versioned Knowledge Snapshot for a wine.

POST/compose/bulkCompose many wines in one request (async-ready).

POST/explainCausal mechanism graph for a descriptor (minimal|standard|debug).

GET/lookupFetch a Knowledge Snapshot by identity.

GET/searchSearch across descriptor/mechanism/identity/grape/region/style.

GET/healthReadiness + versions.

GET/capabilitiesCapability + version negotiation.