1. Sources we monitor
Only public, login-free primary sources are eligible for verified events:
- Official API documentation and deprecation pages
- Official product or developer change logs
- Official migration guides and lifecycle tables
- Official GitHub Releases from a provider-owned repository
Community posts, news coverage and social posts may help discovery but cannot verify a record. We do not bypass authentication, CAPTCHA, robots directives, rate limits, access controls or IP blocks.
2. Two different records
| Record | Meaning | Publish rule |
|---|---|---|
official_announcement | The provider explicitly states a change, date, replacement or lifecycle status in a primary source. | May be marked verified after a human-readable evidence check. |
detected_diff | A watched public page changed between two stored snapshots. | Remains detected or needs_review until the changed text supports a normalized event. |
3. Verification states
- Verified: the normalized claim, provider, affected surface and dates are supported by the linked primary source.
- Needs review: evidence exists but timing, scope or replacement is ambiguous.
- Detected: a mechanical difference was found; it is not yet an announcement.
4. Severity rules
| Severity | Rule of thumb |
|---|---|
| Critical | A dated shutdown or removal that can make production requests fail, or a migration deadline inside 30 days. |
| High | A breaking request/response behavior, enforced replacement, pricing change with material unit impact, or a dated shutdown inside 90 days. |
| Medium | A model alias migration, longer-range deprecation or behavior change that needs planned validation. |
| Low | Long-range lifecycle information or a low-impact operational change that should remain on the roadmap. |
Severity describes operational urgency, not model quality or provider reliability. A provider changing a date triggers re-verification and may change severity.
5. Deadline calculation
Countdowns use the published calendar date and UTC day boundaries. When a provider says “earliest,” “tentative,” or “not sooner than,” the event retains that qualification in its summary. Missing dates remain missing; they are never inferred.
6. Future automated pipeline
- Cloudflare Cron triggers a bounded list of public source fetches.
- A Worker stores response metadata and content hashes in D1.
- Deterministic comparison creates a
detected_diffcandidate. - Grok Bot may classify the diff and draft a summary, but cannot approve facts.
- A verification step promotes supported candidates to
verified. - Workers enqueue eligible subscriptions; Resend, webhook and Slack adapters deliver alerts.
Mechanical scheduling, fetching, storage and delivery remain deterministic infrastructure responsibilities. AI is limited to classification and summarization.