Skip to content

v0.3.0

Release Date: 2026-06-06

Highlights

  • OpenACR Support - Machine-readable accessibility conformance reports in GSA OpenACR format

Overview

This release adds support for OpenACR (Open Accessibility Conformance Report), a machine-readable format for accessibility conformance reports developed by the GSA. OpenACR is based on the VPAT (Voluntary Product Accessibility Template) format and provides structured, machine-processable accessibility documentation.

What's New

OpenACR Report Format

Generate accessibility reports in OpenACR format for automated processing and compliance documentation:

# CLI usage
agent-a11y audit https://example.com --format openacr -o report.yaml

# HTTP API
curl http://localhost:8080/api/v1/audits/{id}/openacr

API Endpoint

New endpoint GET /api/v1/audits/{id}/openacr for exporting audit results as OpenACR:

Parameter Default Description
format yaml Output format: yaml or json
product_name URL Product name override
product_version - Product version
author_name agent-a11y Author name
author_email - Author email
vendor_name - Vendor company name
catalog auto Catalog ID (e.g., 2.5-edition-wcag-2.2-508-en)

Go Library

import "github.com/plexusone/agent-a11y/report"

// Generate OpenACR with custom options
openACRReport, err := report.GenerateOpenACR(result, report.OpenACROptions{
    ProductName:    "My Application",
    ProductVersion: "1.0.0",
    AuthorName:     "Accessibility Team",
    AuthorEmail:    "a11y@example.com",
    CatalogID:      "2.5-edition-wcag-2.2-508-en",
})

Available Catalogs

The following GSA catalogs are supported:

Catalog Description
2.5-edition-wcag-2.2-508-en WCAG 2.2 + Section 508 (default for 2.2)
2.5-edition-wcag-2.1-508-en WCAG 2.1 + Section 508 (default for 2.1)
2.5-edition-wcag-2.0-508-en WCAG 2.0 + Section 508 (default for 2.0)

Bug Fixes

  • Fixed job ID generation to use crypto/rand instead of timestamp-based IDs, ensuring uniqueness on fast systems

Test Coverage

  • Added comprehensive API endpoint tests (18 tests) covering all handlers
  • Added OpenACR conversion tests for catalog selection and adherence level mapping

Dependencies

Dependency Version Change
openacr-go v0.1.0 New
omnillm v0.15.4 Updated
MCP SDK v1.6.1 Updated

Installation

go install github.com/plexusone/agent-a11y/cmd/agent-a11y@v0.3.0

Documentation