From 618917260990982daf8cf0a2d767addf6159e514 Mon Sep 17 00:00:00 2001 From: Jakob Homan Date: Fri, 11 Sep 2026 13:08:48 -0700 Subject: [PATCH] Document the hoglake wire contract in AGENT.md Pin the v1.0.0 OpenAPI spec URL, note the pyhoglake client, and record the exclude-newer carve-out needed when the dependency lands. --- AGENT.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENT.md b/AGENT.md index 890c7c5..1f7bea6 100644 --- a/AGENT.md +++ b/AGENT.md @@ -544,6 +544,19 @@ Prometheus metrics and health checks on port 8000 via a custom `http.server.HTTP | `opentelemetry-exporter-otlp-proto-http>=1.30` | OTLP/HTTP exporter — ships millpond logs to PostHog Logs when `POSTHOG_PROJECT_TOKEN` is set | | `opentelemetry-instrumentation-logging>=0.50b0,<0.64` | Ships the non-deprecated `LoggingHandler` (SDK 1.42 deprecated the `sdk._logs` one); ceiling bounds surprise since the handler's module path isn't the package's documented public surface | +## hoglake Wire Contract + +The upcoming hoglake integration consumes the catalog through +`pyhoglake` (PyPI, our client — PostHog/hoglake, `pyhoglake/`). The +wire contract is the server's OpenAPI spec, pinned per release tag: + +- v1.0.0: +- A live server also serves its own copy at `/openapi.yaml`. + +When the `pyhoglake` dependency lands here, the `[tool.uv]` +`exclude-newer` cooldown will exclude a fresh release; add a fixed-date +carve-out like the existing pyducklake one. + ## Project Structure ```