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

[WalksWithASwagger]

Context

A production crawl on 2026-07-12 checked all 45 Punk Rock AI sitemap URLs:

• every URL returned 200
• every page had a title, description, canonical, and one H1
• no sitemap URL emitted noindex
• 28 sitemap pages lacked og:image, concentrated in widgets plus /decisions, /signal, and /workshop

This is a social-preview and discoverability quality gap, not an indexability failure.

Scope

• Give every sitemap-listed HTML page a valid absolute og:image.
• Prefer an existing page-specific asset where one is clearly owned by the page.
• Use one existing canonical Punk Rock AI fallback image where no page-specific asset exists.
• Add matching Twitter image metadata or prove the platform fallback contract.
• Extend the existing index-hygiene checker instead of adding a disconnected audit script.

Acceptance Criteria

• Every sitemap URL has a valid absolute og:image.
• Every referenced asset returns 200 with an image content type.
• Existing page-specific preview images are preserved.
• Twitter image metadata resolves to the same owned preview asset.
• Titles, descriptions, canonicals, H1s, routes, and sitemap entries remain unchanged.
• Production crawl reports zero missing social-preview images after deployment.

Tests/Evals

• Extend scripts/check-index-hygiene.mjs to fail when a sitemap-listed HTML page lacks og:image or uses a malformed/non-absolute URL.
• Add focused fixture coverage for missing, malformed, fallback, and existing page-specific images.
• Keep all existing index-hygiene assertions green.

Verification

• Run npm run seo:index-hygiene.
• Run npm run check.
• Run a local HTTP smoke test and review the rendered metadata diff.
• After deployment, crawl all 45 production sitemap URLs and verify each image asset returns 200 with an image content type.

Agent Instructions

• Work from a clean worktree based on current origin/main.
• Preserve unrelated changes and existing page-specific images.
• Extend the existing checker and project conventions.
• Commit, push, open a draft PR, and comment here with commands and results.
• Do not merge or deploy from the worker lane.

Out of Scope

• New image generation.
• Page-copy changes.
• Canonical, sitemap, title, description, or route changes.
• Interactive behavior changes.
• Broad schema or structured-data work.

Related to WalksWithASwagger/kk-kb#2027.

[github-actions]

Agentic issue quality gate failed: missing sections: Context, Tests/Evals, Verification, Agent Instructions, Out of Scope; acceptance criteria must include markdown checkboxes

[github-actions]

Agentic dev loop started on branch codex/issue-171-seo-add-open-graph-images-to-every-punk-rock-ai with provider noop.

[github-actions]

Agentic dev loop failed: No ready label found

[WalksWithASwagger]

Implemented in draft PR #172: #172

Counts:

• 45 sitemap HTML pages checked
• 17 existing page-specific og:image values preserved exactly
• 28 prior gaps filled with the existing neither-are-we.webp fallback
• 45 matching twitter:image values
• 0 social-preview image issues from the extended index-hygiene checker

Verification:

• npm run seo:index-hygiene passed
• npm run check passed, including 5 focused index-hygiene tests and 14 existing agentic tests
• local HTTP smoke returned 200 text/html for 45/45 sitemap routes
• all 13 unique referenced images returned 200 image/*
• fallback returned 200 image/webp and exists locally
• metadata-only diff invariant confirmed 73 HTML additions and 0 HTML deletions
• git diff --check passed

Commit: 0f804fdb0ac30be43657a98a73e539b168e98687

No manual deployment or Search Console, GA4, or DNS changes were made.

[WalksWithASwagger]

Production verification, 2026-07-12:\n\n- sitemap.xml returns 200 with 45 URLs\n- 45/45 sitemap pages return final HTTP 200\n- 45/45 emit both og:image and twitter:image\n- 45/45 use the same image for both tags\n- 13 unique image URLs all return HTTP 200 with an image/* content type\n\nThe stale needs-human label has been removed. No Search Console removal or resubmission was performed.