Skip to content

Tighten v1.1.0 authority and validation surfaces#10

Open
GsCommand wants to merge 1 commit intomainfrom
codex/execute-strict-command-layer-checklist
Open

Tighten v1.1.0 authority and validation surfaces#10
GsCommand wants to merge 1 commit intomainfrom
codex/execute-strict-command-layer-checklist

Conversation

@GsCommand
Copy link
Copy Markdown
Contributor

Motivation

  • Remove ambiguity about which artifacts are authoritative and make the current release line explicit (v1.1.0).
  • Narrow card shape and validation to binding-critical fields so cards serve as protocol artifacts (not product copy).
  • Separate current vs legacy integrity surfaces and ensure dist-pin is treated as a derivative bundle, not a source of truth.
  • Remove stale/no-op tooling (TypeScript validation, mirror helpers) and tighten validation scripts to prevent drift.

Description

  • Define an explicit authority model in README.md and add authority metadata to meta/manifest.json, making v1.1.0 the single current line and classifying dist-pin/agent-cards/v1.1.0/ as a derivative release bundle.
  • Split checksums into scoped files: checksums-v1.1.0.txt (current) and checksums-v1.0.0.txt (legacy), remove checksums.txt, and update scripts/generate-checksums.mjs to support --profile current|legacy and produce/verify scoped checksum files.
  • Trim schemas/v1.1.0/agent.card.schema.json and all agents/v1.1.0/* cards to a minimal, binding-only shape (identity, owner, ens, version, status, class, implements, schemas, schemas_mirror, entry, updated_at), removing descriptive/capabilities/meta noise from the current line.
  • Make .well-known explicit pointer + frozen snapshot model by changing .well-known/agent.json into the current-pointer and .well-known/agent-cards-v1.1.0.json into the frozen-snapshot; update descriptor schema to require role and optional snapshot link.
  • Replace placeholder/legacy fields in agents/v1.0.0/*: removed unverifiable pgp_fingerprint claims, replaced fake IPFS mirror patterns with archival HTTP mirrors where applicable, and add archival_note to clearly mark v1.0.0 as archival.
  • Replace CI/validation surface: remove TypeScript no-op validator and other stale scripts, add targeted npm scripts in package.json (validate:current, validate:legacy, validate:checksums, validate:release) and make npm run validate run the current-line validation + checksums only.
  • Add strict cross-validation in scripts/validate-cards.mjs to enforce manifest ↔ card exact matching, dist-pin byte-for-byte parity, discovery pointer ↔ snapshot relationship, and release-time URL/x402 checks.

Testing

  • Ran npm install then npm run validate (which runs validate:current + checksum verification); result: all current-line validations passed (discovery, manifest↔cards, dist-pin parity).
  • Ran npm run validate:legacy; result: legacy checks passed and placeholders/PGP claims were removed or replaced with archival notes.
  • Ran node scripts/generate-checksums.mjs --profile current --verify (via npm run validate:checksums); result: checksums-v1.1.0.txt matches current artifacts.
  • Ran npm run validate:release (networked release-time checks); result: failed in this environment due to blocked outbound fetches (the validation logic is present and will succeed when run with network access against the published endpoints).

Codex Task

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant