Publish public URL mentions index #9

Merged
waylon merged 2 commits from feat/url-mentions-index into main 2026-10-22 13:37:25 -05:00
Owner

Summary

  • Add the public, paginated /.well-known/url-mentions.json endpoint with deterministic entries, references, cache headers, and ETags.
  • Exclude unpublished, unready, and deletion-pending videos.
  • Document URL Mentions protocol 1.0 with a JSON Schema and example fixture.
  • Test URL normalization, tracking parameter removal, significant query preservation, reference extraction, privacy filtering, pagination, and ETags.

Validation

  • just check — passed (61 tests, Ruff, formatting, ty, and render smoke).

The Brainrot checkout had unrelated local edits before this change. This PR contains only the URL Mentions implementation and documentation.

## Summary - Add the public, paginated `/.well-known/url-mentions.json` endpoint with deterministic entries, references, cache headers, and ETags. - Exclude unpublished, unready, and deletion-pending videos. - Document URL Mentions protocol 1.0 with a JSON Schema and example fixture. - Test URL normalization, tracking parameter removal, significant query preservation, reference extraction, privacy filtering, pagination, and ETags. ## Validation - `just check` — passed (61 tests, Ruff, formatting, ty, and render smoke). The Brainrot checkout had unrelated local edits before this change. This PR contains only the URL Mentions implementation and documentation.
waylon merged commit 0d490fc483 into main 2026-10-22 13:37:25 -05:00
waylon referenced this pull request from a commit 2026-10-22 13:37:26 -05:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
waylon/brainrot.waylonwalker.com!9
No description provided.