Skip to content

feat(agent): resolve all Cloudflare Agent Readiness audit findings - #689

Merged
codercatdev merged 2 commits into
devfrom
feat/agent-readiness-complete
Oct 8, 2026
Merged

codercatdev merged 2 commits into
devfrom
feat/agent-readiness-complete

Conversation

@codercatdev

Copy link
Copy Markdown
Contributor

Summary

Resolves all 7 flagged findings from the isitagentready.com and Cloudflare Agent Readiness audit:


1. DNS for AI Discovery (DNS-AID) & DNSSEC

  • Published DNS-AID ServiceMode Records:
    • _a2a._agents.codingcat.dev. 3600 IN HTTPS 1 codingcat.dev. mandatory=alpn,port alpn=a2a port=443
    • _index._agents.codingcat.dev. 3600 IN HTTPS 1 codingcat.dev. alpn=h2,h3 port=443
    • _catalog._agents.codingcat.dev. 3600 IN TXT "url=https://codingcat.dev/.well-known/ai-catalog.json"
  • DNSSEC: Enabled on the codingcat.dev zone in Cloudflare. Verified active DoH resolution via Cloudflare 1.1.1.1.

2. RFC 9727 / RFC 9264 API Catalog (/.well-known/api-catalog)

  • Formatted as application/linkset+json with standard "linkset" array.
  • Included entries for /api/search, /api/mcp, /api/sponsorship, RSS feeds, each with anchor, service-desc (OpenAPI schema), service-doc (llms.txt), and status health checks.
  • Published OpenAPI 3.1 schema at /.well-known/openapi.json.

3. ARD (Agentic Resource Discovery) Capability Manifest (/.well-known/ai-catalog.json)

  • Implemented specVersion: "1.0", host with did:web:codingcat.dev, and entries for MCP server card, search API, and agent skills.
  • Strictly adheres to the spec requirement of exactly one of url or data per entry, with 2–5 representativeQueries.
  • Added Agentmap: https://codingcat.dev/.well-known/ai-catalog.json in robots.txt and <link rel="ai-catalog"> in <head>.

4. OAuth/OIDC Discovery Metadata

  • Published /.well-known/openid-configuration with issuer, authorization_endpoint, token_endpoint, jwks_uri, and supported scopes/grant types.
  • Published /.well-known/oauth-authorization-server with agent_auth block including skill, register_uri, and supported identity assertions (ID-JAG, verified_email, anonymous).
  • Added /.well-known/jwks.json.

5. OAuth Protected Resource Metadata (RFC 9728)

  • Published /.well-known/oauth-protected-resource specifying resource identifier, authorization server (https://codingcat.dev), scopes_supported, and bearer_methods_supported: ["header"].

6. Auth.md (/auth.md)

  • Published /auth.md in Markdown with H1 # CodingCat.dev auth.md.
  • Documented audience, scopes, bearer token usage, and registration endpoints (/agent/auth and /agent/claim).

7. WebMCP Implementation

  • Imperative: Registered search_content tool on page load via document.modelContext.registerTool() / navigator.modelContext.registerTool() with JSON Schema and AbortSignal.
  • Declarative: Added toolname="search_content", tooldescription, and toolparamdescription on <form> and inputs in SearchModal.astro and sponsorships.astro.

Verification

  • pnpm --filter @codingcatdev/site lint: 76 files checked, 0 errors.
  • pnpm --filter @codingcatdev/site typecheck: 137 files checked, 0 errors.
  • pnpm --filter @codingcatdev/site test:e2e: All 152 dual-track E2E tests passing.
  • pnpm --filter @codingcatdev/site build: Clean edge server build in 1.01s.

- RFC 9727 / RFC 9264 API Catalog: update /.well-known/api-catalog to application/linkset+json with linkset array
- ARD Spec & ai-catalog: add /.well-known/ai-catalog.json capability manifest with representativeQueries and Agentmap in robots.txt
- OpenAPI 3.1: publish /.well-known/openapi.json defining search, mcp, and sponsorship endpoints
- OAuth/OIDC Discovery: add /.well-known/openid-configuration and /.well-known/oauth-authorization-server with Auth.md agent_auth extension
- OAuth Protected Resource Metadata: add /.well-known/oauth-protected-resource (RFC 9728)
- Auth.md: add /auth.md with agent registration, audience, identity assertion, and token claiming docs
- WebMCP: implement document.modelContext.registerTool() on page load and declarative form attributes on SearchModal and sponsorships form
- Discovery Headers & Tags: expand RFC 8288 Link headers and head link tags
@vercel

vercel Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated
codingcat-dev Ignored Ignored Oct 8, 2026 9:19am UTC

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown

⚡ Cloudflare Worker Preview Ready!

Environment URL
PR Preview https://29f9de3d-codingcatdev-dev.codingcatdev.workers.dev
Dev Custom Domain https://dev.codingcat.dev
  • Worker Version ID: 29f9de3d-66d2-4db2-8304-8ba5e2f3b7ab
  • Protection: Restricted to @codingcat.dev accounts via Cloudflare Zero Trust Access

@codercatdev
codercatdev merged commit 484634f into dev Oct 8, 2026
4 checks passed
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