Skip to content

Fail the build when a published URL is no longer built - #107

Merged
bits-bytes-nn merged 1 commit into
mainfrom
review-r14
Oct 16, 2026
Merged

bits-bytes-nn merged 1 commit into
mainfrom
review-r14

Conversation

@bits-bytes-nn

Copy link
Copy Markdown
Owner

Fifth round of adversarial review.

  • Published URLs. A post's URL is built from date: and categories. Changing either (scholar-lens correcting a paper date, or a post moved to a new topic) moved the URL, and legacy_urls.rb builds the old /paper%20reviews/… stub from the current values, so it moved too. Both indexed URLs 404'd with every gate green (verified: GraphRAG date: 2024-04-24 → 04-25 on a scratch copy).
    • script/published-urls.txt lists the 65 URLs posts are published under today (36 posts, 28 legacy stubs, one explicit redirect_from).
    • script/check-plugin-output.rb (run by validate-site.sh) fails when a listed URL is no longer built as a page or a redirect stub; the scratch copy now fails on both URLs.
    • --record adds the built posts' URLs and stubs, to run after a post merges. Unlisted posts are not checked, so a scholar-lens PR adding a post still passes.
  • The agentic-patterns post (ko and en) put its two hand-written lightbox links in a separate agentic-patterns gallery, so the arrows skipped the post's other figures; they now share post-images.

scholar-lens: no change needed. Optionally, have it note in its PR that the new URL should be recorded.

No change to _data/post_conventions.yml and no new lint rule.

Checks: all five gates pass on a fresh build.

A post's URL comes from its date and categories, and legacy_urls.rb's stub
follows the current values, so an edit to either sent both indexed URLs to a
404 with every gate green. script/published-urls.txt lists every URL posts
have been published under; check-plugin-output.rb fails when one is no longer
built as a page or redirect stub, and --record adds new ones.

The agentic-patterns post's two hand-written lightbox links were in their own
gallery, so the arrows skipped the post's other figures.
@bits-bytes-nn
bits-bytes-nn merged commit 891cc2f into main Oct 16, 2026
3 checks passed
@bits-bytes-nn
bits-bytes-nn deleted the review-r14 branch October 16, 2026 15:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant