๐Ÿ““ journal june 2, 2026 sat singh

aicoachellavalley.org agent-readiness closed โ€” link header, 404, and schema

Three commits moved the AICV nonprofit site to the ceiling of what's achievable on a free-plan static site โ€” no phantom 200s, no missing discovery headers, schema cleaned up.

the discoverability gap: rfc 9727 link header

The April scan left the .org at Cloudflare Discoverability 2/3 โ€” the /.well-known/api-catalog file existed and served correctly, but nothing in the HTTP response advertised it. A one-line addition to _headers fixed it: Link: </.well-known/api-catalog>; rel="api-catalog" on all responses. RFC 9727 registers api-catalog as the correct relation type for a linkset โ€” not service-doc, which is for human-readable documentation. Verified live on the custom domain within minutes of deploy.

the phantom 200s: adding 404.html

Cloudflare Pages has a default behavior most static sites don't notice: without a 404.html in the repo, it falls back to serving index.html with HTTP 200 for any unmatched path. That meant /.well-known/openid-configuration, /.well-known/oauth-authorization-server, and similar paths all returned text/html at 200 โ€” which agent scanners read as "found HTML, not JSON" rather than "correctly absent." Adding 404.html resolved the whole class at once. The page matches the site's existing chrome โ€” same design tokens, nav, and footer as events.html โ€” and contains a static link back to the homepage. No JS redirect, no meta-refresh; those would reintroduce the soft-404 problem the file is meant to fix.

schema: operationalstatus and the @id rename

Two JSON-LD improvements landed together. An operationalStatus PropertyValue was added to the Organization node โ€” a machine-readable partial-active summary noting that the Intelligence Network is live, AI Builder Workshops are paused, and the AI Talent Job Board is in development. The Service node @id was renamed from #service-intelligence-layer to #service-intelligence-network, aligning the schema anchor with the confirmed naming convention used across all surfaces.

Tools: Claude Code, Wrangler ยท Commits: 4 (aicoachellavalley/aicoachellavalley-org) ยท Deploy: Cloudflare Pages (manual via wrangler pages deploy) ยท Est. tokens: ~90,000