update-ard-port
Installation
SKILL.md
Update the ARD port
Lighthouse vendors a JavaScript port of the upstream ARD conformance tester. When
upstream changes, the port must be brought back to 1:1 parity while preserving the
Lighthouse-specific adaptations listed in third-party/ard/README.md.
What lives where
| Upstream (ards-project/ard-spec) | Lighthouse | Notes |
|---|---|---|
conformance/bin/conformance-test → validate_manifest and helpers |
third-party/ard/ard.js |
ConformanceTester (validate_manifest, run_json_schema_validation, add_error/warning/info), parse_media_type, classify_media_type, format_schema_error. Keep upstream snake_case names and word-for-word message text. |
spec/schemas/ard-entry.schema.json |
third-party/ard/spec/schemas/ard-entry.schema.json |
Must stay byte-identical to upstream. |
| (generated) | third-party/ard/schema-validator.js |
Precompiled Ajv standalone validator, built by build/build-ard-schema.js (yarn build-ard-schema). Never hand-edit. |
spec/ard.md §5.1 Discovery Mechanisms (+ resolve_publisher in the script) |
core/gather/gatherers/agentic/ard.js |
Candidate order: robots.txt agentmap → <link rel="ard"> → Link header → /.well-known/ard.json → legacy ai-catalog equivalents. Source names in Artifacts.ArdDiscoverySource (types/artifacts.d.ts). |
| severity / scoring (Lighthouse-only) | core/audits/agentic/ard-schema.js |
errors → score 0; warnings/legacy/broken-link → 0.9; clean → 1. infos are not surfaced. |
| pinned SHA + reviewed hashes + deviation list | third-party/ard/README.md |
**Pinned Commit SHA** and the **Reviewed Upstream Files** SHA-256 lines are parsed/written by the update script. Never edit the hashes by hand — they are the proof that the port was reviewed against that exact upstream content. |