Skip to content

Document the hoglake wire contract in AGENT.md #140

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jghoman wants to merge 1 commit into
base: main
Choose a base branch
from
+13 −0
Open

Document the hoglake wire contract in AGENT.md #140

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions AGENT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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: <https://raw.githubusercontent.com/PostHog/hoglake/v1.0.0/server/src/main/resources/openapi/hoglake.yaml>
- 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

```
Expand Down
Loading