Skip to content

Add Desvela ARD Registry to reference implementations - #18

Open
mrenzo20 wants to merge 2 commits into
ards-project:mainfrom
mrenzo20:add-desvela-registry
Open

Add Desvela ARD Registry to reference implementations#18
mrenzo20 wants to merge 2 commits into
ards-project:mainfrom
mrenzo20:add-desvela-registry

Conversation

@mrenzo20

@mrenzo20 mrenzo20 commented Aug 25, 2026

Copy link
Copy Markdown

Adds the Desvela ARD Registry to the reference implementations, alongside Hugging Face, GitHub, Cisco, Ora, and ANS.

Updated for v0.91: the entry now names /.well-known/ard.json, and everything below was re-verified against the v0.91 conformance suite.

What's distinct: it indexes the open web rather than a single platform's own resources. The crawl covers the Tranco top-100K for ard.json, its predecessor ai-catalog.json, llms.txt, agents.md, agent-card.json, mcp.json, and AI-bot robots.txt directives, refreshed weekly. Findings are published monthly at desvela.ai/census with the methodology in the open (canary requests against non-existent paths to exclude catch-all servers, apex-domain scope, subdomains out of scope).

Implements the full protocol surface:

  • POST /searchquery.text, filter.type, pageToken
  • POST /explore (spec §7.3) — facet aggregation
  • Remote MCP at POST /mcp (Streamable HTTP), with a free preflight(domain) tool and a watch(domain, webhook_url) tool that delivers a signed webhook when a domain's agent-facing surfaces change

Verified against the spec's own conformance suite, all three PASS with 0 critical errors and 0 warnings:

conformance-test publisher desvela.dev          → PASS
conformance-test publisher desvela.ai           → PASS
conformance-test registry https://registry.desvela.dev → PASS

One note that may be useful beyond this entry. When v0.91 moved the canonical path, the tempting change on our side was to swap the ai-catalog.json column for an ard.json one. We kept both instead. The census is a month-over-month series and the count of ARD publishers in the top-100K is still single digits, so a swap would have rendered as a collapse in adoption that belonged to our crawler rather than to the web. Each surface now carries the date it entered the census, so a zero before that date reads as not measured rather than nobody published. Anyone else tracking adoption across this version boundary will hit the same thing.

Disclosure: I run this registry.

v0.91 moved the canonical path to /.well-known/ard.json, so the entry now
names it. Desvela serves it and emits rel="ard".

Also lists the two surfaces added on 19 Aug (agent-card.json, mcp.json), which
the original text predated, and explains why both manifest paths are counted
separately instead of one replacing the other.

Re-verified against the v0.91 conformance suite: publisher desvela.dev PASS,
publisher desvela.ai PASS, registry https://registry.desvela.dev PASS — 0
critical errors, 0 warnings on all three.
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