PR Custody

[codex] Add API change monitor detection layer

@sjd9021draftchecks n/achecks…codex/api-change-monitor-detection → next24 files · +5721 −0updated 1mo ago

▸Description

Why

We need a durable detection layer for monitoring API changes across toolkits before building downstream consumers such as Slack digests, dashboards, or automated agent triggers.

What

Adds a new watchdog.pipelines.api_change_monitor package for source discovery, Parallel monitor payloads, monitor polling, event normalization, and finding models.
Adds ClickHouse recording support for api_change_analysis_logs, including a draft DDL constant, dedupe check, and insert helper.
Documents the initial detection-layer architecture and ClickHouse table draft.
Adds focused tests for source discovery, Parallel payload generation, event normalization, and ClickHouse insert generation.

How to Test

uv run pytest watchdog/tests/test_api_change_monitor.py -q
uv run ruff check watchdog/pipelines/api_change_monitor watchdog/tests/test_api_change_monitor.py watchdog/clients/clickhouse/queries.py

Pre-Review Checklist

I have self-reviewed this PR

Notes

This does not run a ClickHouse migration or create any live Parallel monitors. The table DDL is present as a draft constant so the storage shape can be reviewed before applying infra changes.

loading diff…