v0.6.0 - Fixer Engine, CLI, Docker Action

🛠️ a11y-fixer v0.6.0 — Fixer Engine, CLI, Docker Action

Accessibility audits for GitHub PRs, without SaaS lock-in.

This release marks a major milestone: the project has evolved from a Node-based MVP to a full Docker action with a CLI, fix suggestions engine, and production-ready infrastructure.

---

✨ What's new in v0.6.0

Fixer Engine (src/core/fixer.ts)

Generates concrete, actionable fix suggestions for accessibility violations with three fixability levels:

• auto — safe, deterministic code patches (e.g. fixing aria-labeledby → aria-labelledby)
• suggest — needs human review but provides replacement HTML (e.g. adding alt="" to images, wrapping content in <main>)
• explain — cannot be automated, provides detailed guidance (e.g. color contrast ratios)

Supports 8 violation types with code patches in unified diff format.

CLI (a11y-fixer)

Run audits and fixes from the command line:

a11y-fixer audit --url http://localhost:3000
a11y-fixer fix --url http://localhost:3000
a11y-fixer suggest --url http://localhost:3000 --output json

Docker Action

The action now runs inside a Playwright Docker container (mcr.microsoft.com/playwright:v1.61.1-jammy), ensuring browser compatibility across all runners. No more Playwright installation issues.

Production-ready Infrastructure

• Baseline cache via GitHub Actions artifacts — evolution comparison now works in production
• Octokit native API — PR comments and check statuses use @actions/github with gh CLI fallback
• Entry point guard — prevents accidental execution on import
• target_url input — supports http://host.docker.internal:3000 for Docker container access
• simple-git-hooks — pre-commit hook runs Biome + tests automatically

---

📈 Progress from v0.1.0 to v0.6.0

Version	Focus	Key Changes
v0.1.0	MVP: Core Engine	Config, diff analyzer, route resolver, Playwright + axe-core, PR comments
v0.4.0	Docker Action	Converted to Docker action for Playwright compatibility
v0.4.1	Execution Fix	Added run() invocation at module level
v0.5.0	Container Networking	target_url input, gh CLI updated
v0.5.1	PR Comment Fix	--repo flag for gh, GITHUB_TOKEN env var
v0.6.0	Fixer + CLI	Fix suggestions engine, CLI, GHA artifacts cache, octokit

---

🧪 Quality

• 115 tests across 11 test suites
• TypeScript strict mode
• Biome lint + format
• CI pipeline: typecheck → lint → tests → build
• Integration tests with real axe-core + Playwright
• Pre-commit hooks with simple-git-hooks

---

📚 Documentation

• README.md — quick start, config reference, CLI usage
• CHANGELOG.md — full version history
• docs/design/DESIGN.md — full configuration spec
• docs/ROADMAP.md — upcoming phases
• CONTRIBUTING.md — how to contribute
• examples/ — Next.js, React, Vue, Angular workflows

---

🔮 What's next

• AI-powered fix suggestions with your own API key
• GitHub Marketplace listing
• PR suggestion comments (apply fixes directly from the PR)

---

Full changelog: CHANGELOG.md