Skip to content

Fix sitemap social preview images#172

Merged
WalksWithASwagger merged 1 commit into
mainfrom
codex/issue-171-og-images
Jul 13, 2026
Merged

Fix sitemap social preview images#172
WalksWithASwagger merged 1 commit into
mainfrom
codex/issue-171-og-images

Conversation

@WalksWithASwagger

Copy link
Copy Markdown
Owner

Summary

  • add the existing homepage fallback image to the 28 sitemap pages that lacked og:image
  • add matching twitter:image metadata across all 45 sitemap pages while preserving all 17 existing page-specific Open Graph values
  • extend the index-hygiene checker with sitemap-backed social-image validation and five focused regression cases

Why

The production crawl found all 45 sitemap URLs indexable, but 28 pages had no social-preview image. Because this is a static site with page-owned <head> markup, the smallest coherent fix touches each sitemap HTML page directly.

The checker treats punkrockai.com and www.punkrockai.com as the same canonical site host family so the existing page-specific values remain byte-for-byte unchanged. Relative URLs, non-canonical protocols or ports, foreign hosts, missing tags, and mismatched Twitter images fail.

Acceptance Self-Check

  • 45/45 sitemap pages have one absolute same-site og:image
  • 17/17 existing page-specific og:image values are preserved
  • the existing https://www.punkrockai.com/public/slides/neither-are-we.webp fallback is added only to the 28 prior gaps
  • 45/45 twitter:image values match their Open Graph image
  • the fallback exists locally and returned 200 image/webp in local HTTP smoke
  • titles, descriptions, canonicals, H1s, routes, sitemap membership, page copy, and interactive behavior are unchanged

Verification

  • npm run seo:index-hygiene
  • npm run check
  • focused checker tests: 5 passed
  • local HTTP smoke: 45/45 sitemap pages returned 200 text/html; all 13 unique referenced images returned 200 image/*
  • fallback smoke: 200 image/webp, 75,474 bytes
  • metadata-only invariant: 17 preserved, 28 fallbacks added, 45 matching Twitter images, 73 HTML additions, 0 HTML deletions
  • git diff --check

Scope

The diff is 48 files and 285 insertions / 1 deletion: 45 static sitemap HTML files plus the existing checker, one focused test file, and the package test script. The issue explicitly requires full sitemap coverage. No deployment or Search Console, GA4, or DNS changes were performed.

Closes #171

Add the existing Punk Rock AI fallback only where Open Graph images were missing, and mirror every sitemap page image for Twitter. Extend index hygiene with canonical-site URL enforcement and focused regression tests.
@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
punkrockai Ready Ready Preview, Comment Jul 13, 2026 5:33am

Request Review

@github-actions

Copy link
Copy Markdown

Agentic PR Review

Verdict: needs-human

Checks:

  • Linked issue via Closes #...: yes
  • Issue acceptance criteria found: 6
  • PR verification section present: yes
  • PR acceptance self-check present: yes
  • Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

@github-actions github-actions Bot added the needs-human Agentic automation stopped for human judgment. label Jul 13, 2026
@WalksWithASwagger
WalksWithASwagger marked this pull request as ready for review July 13, 2026 05:36
@WalksWithASwagger
WalksWithASwagger merged commit 30c2160 into main Jul 13, 2026
5 checks passed
@github-actions

Copy link
Copy Markdown

Agentic PR Review

Verdict: needs-human

Checks:

  • Linked issue via Closes #...: yes
  • Issue acceptance criteria found: 6
  • PR verification section present: yes
  • PR acceptance self-check present: yes
  • Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

@WalksWithASwagger
WalksWithASwagger deleted the codex/issue-171-og-images branch July 13, 2026 05:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-human Agentic automation stopped for human judgment.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[SEO] Add Open Graph images to every Punk Rock AI sitemap page

1 participant