Release v0.5.1

Release 0.5.1

✨ Highlights

• Added: Test Coverage Implementation Phase 3: Linting agent coverage — Replaced the linting agent stub with a deterministic helper surface for lint target parsing, rule selection, findings grouping, report formatting, config loading, cache isolation, and async orchestration. Added a focused Jest suite that covers parsing, selection ordering, invalid config handling, malformed findings, empty-input handling, and repository-wide lint/test validation. (#935)
• Added: Test Coverage Implementation Phase 2: Metrics agent coverage — Added a pure, testable metrics-agent helper module with repository-level aggregation, issue and pull request metric calculations, markdown/CSV report generation, date-range filtering, and multi-repository support. Added a focused Jest suite that covers the collection, aggregation, reporting, and error-handling paths for scripts/agents/metrics.agent.js. (#934)
• Added: Plugin Pack Waves: WordPress 10-plugin catalogue and AI readiness assessor planning set — Expanded .github/projects/active/plugin-pack-waves/ from legacy wave scaffolding into a complete WordPress-focused planning pack with a ten-plugin catalogue (P01-P10), issue draft files, OpenSpec strict proposal inputs, execution controls (ISSUE_EXECUTION_PLAN.md, ISSUE_REGISTER.md, RUN_LOG.md), and linked GitHub issues #940 through #950, including the new WP AI Readiness Assessor task for WordPress site readiness evaluation. (#951)

⚠️ Breaking Changes

This release contains 1 breaking change(s):

• Awesome GitHub Site: Duplicate Route Collision Fix — Removed duplicate /references route caused by website/src/pages/references.astro conflicting with website/src/pages/references/index.astro. The build now generates 62 pages with no route collision warnings. Workflow updated with --legacy-peer-deps flag for npm ci to resolve @astrojs/svelte compatibility with Astro 5.18.2.

Please review any migration notes and update your code accordingly.

📋 Changes

✨ Added

• Test Coverage Implementation Phase 3: Linting agent coverage — Replaced the linting agent stub with a deterministic helper surface for lint target parsing, rule selection, findings grouping, report formatting, config loading, cache isolation, and async orchestration. Added a focused Jest suite that covers parsing, selection ordering, invalid config handling, malformed findings, empty-input handling, and repository-wide lint/test validation. (#935)
• Test Coverage Implementation Phase 2: Metrics agent coverage — Added a pure, testable metrics-agent helper module with repository-level aggregation, issue and pull request metric calculations, markdown/CSV report generation, date-range filtering, and multi-repository support. Added a focused Jest suite that covers the collection, aggregation, reporting, and error-handling paths for scripts/agents/metrics.agent.js. (#934)
• Plugin Pack Waves: WordPress 10-plugin catalogue and AI readiness assessor planning set — Expanded .github/projects/active/plugin-pack-waves/ from legacy wave scaffolding into a complete WordPress-focused planning pack with a ten-plugin catalogue (P01-P10), issue draft files, OpenSpec strict proposal inputs, execution controls (ISSUE_EXECUTION_PLAN.md, ISSUE_REGISTER.md, RUN_LOG.md), and linked GitHub issues #940 through #950, including the new WP AI Readiness Assessor task for WordPress site readiness evaluation. (#951)
• Awesome GitHub Site Phase 06: Wapuu mascot system — Added a reusable WapuuHero Astro component with a canonical page-type mapping, copied the three confirmed Wapuu assets into website/public/assets/wapuus/, and wired the learn, cookbook, tools, and catalogue hero sections to render the correct mascot with responsive hiding at ≤860px and decorative accessibility attributes. (#864)
• Awesome GitHub Site Phase 07: Catalogue list pages with filter bar and Wapuu hero — Replaced the old catalogue index with a spec-aligned /c/[cat] route, added the shared Wapuu hero component, introduced tag-chip filtering with AND logic, and surfaced the category type note and install-action cards for all eight catalogue pages. (#866, #867)
• Awesome GitHub Site Phase 05: Homepage all 5 blocks wired to live data — Rebuilt the homepage with the spec-aligned hero, live catalogue counts, feature strip, and Cook+Learn cards. Added the typed catalogue exports used by the homepage counts, copied the Wapuu assets into website/public/assets/wapuus/, and added an onboarding/ alias that redirects to getting-started/ for the primary CTA. (#861, #862)
• Awesome GitHub Site Phase 13: Search command palette — Site-wide ⌘K search palette (website/src/components/SearchPalette.astro + website/src/scripts/search.js) added to AwesomeGithubLayout. Build-time JSON index of all catalogue items serialised into a data-items attribute. Empty query shows 7 Popular items; typed query uses multi-word AND substring matching across name, description, tags, and category (capped at 12 results). Keyboard navigation (↑↓ arrow keys, Enter to open result, Escape to close, Tab focus-trap between input, close button, and result items). Fully accessible: role="dialog", aria-modal, aria-selected, focus returns to trigger on dismiss. (#764, #889)
• Awesome GitHub Site Phase 11: Tools page + Phosphor Icons sitewide — Standalone /c/tools.astro with astropuu Wapuu hero, section nav pills (AI Defaults, Scripts, Schemas, Config & Setup), and a build-time Phosphor icon loader (website/src/lib/phosphor.ts) using createRequire for robust package resolution. Updated Icon.astro with ph: prefix routing to load any Phosphor icon at SSG time. Migrated item card and type badge styles into global.css for reuse across catalogue and tools pages. Updated all category, nav, learn, and home icons to Phosphor equivalents sitewide. (#885, #886)
• Awesome GitHub Site Phase 02: CSS Token Layer + Global Styles — Established the complete CSS foundation for the Awesome GitHub site. Added website/src/styles/site-tokens.css with app-specific surface tokens (--panel, --panel-2, --hair), font stacks, radius/shadow/transition scales, and color-scheme declarations for both light and dark themes. Added website/src/styles/global.css with container system (.wrap 1320px, .wrap-prose 820px), section rhythm via clamp(), button system (.btn-primary, .btn-ghost, .btn-soft, .icon-btn) with :focus-visible rings and browser-compat fallbacks, breadcrumb, kbd chip, burger breakpoints, .md prose styles, and scroll-motion accessibility guard. Fixed BaseLayout.astro CSS import order and corrected localStorage theme key to ag-theme. (#852, #853)
• Awesome GitHub Site: UI Redesign — Dark Mode, Navigation & Responsive Layout — Complete navigation and UI overhaul. Added desktop Browse mega-dropdown with 4-column category grid (hover/click open, keyboard Escape dismiss, focus-out close). Added full-height mobile drawer sliding from right with backdrop overlay, scroll-lock, and inert guard. Fixed dark-mode nav header (was showing light background). Added fluid responsive CSS tokens for spacing and font sizes across breakpoints. Improved accessibility: Disclosure pattern (aria-expanded/aria-controls, no role="menu"), aria-pressed on theme toggle buttons, inert on closed drawer, nav z-index raised above drawer so hamburger stays accessible. (#847, #845)
• Awesome GitHub Site: Phosphor Icon System — Replaced all emoji icons (🤖 📖 💬 ✨ 🛡️ ⚙️ 🧩 🔧 🗺️ ✅ 📚 🍳 ☀️ 🌙) with Phosphor SVG icons via a new Icon.astro component that reads from @phosphor-icons/core at build time — zero runtime JS. Covers catalogue type icons, learning track icons, getting-started cards, cookbook placeholder, and theme toggle buttons. (#844, #843)

🐛 Fixed

• Awesome GitHub Site: NotFound Page Accessibility Improvement — Added aria-hidden="true" attribute to decorative Wapuu-Astropuu image in the NotFound component (learn.jsx) to improve WCAG 2.2 AA+ accessibility compliance. Empty alt text combined with aria-hidden ensures screen readers properly skip decorative content.
• Awesome GitHub Site: Duplicate Route Collision Fix — Removed duplicate /references route caused by website/src/pages/references.astro conflicting with website/src/pages/references/index.astro. The build now generates 62 pages with no route collision warnings. Workflow updated with --legacy-peer-deps flag for npm ci to resolve @astrojs/svelte compatibility with Astro 5.18.2.

📦 Installation

...

Release v1.0.0

[1.0.0] - 2026-06-23

Added

• Issue automation hardening — Expanded checklist-finalisation.yml to auto-tick Steps / Checklist and Acceptance Criteria sections on issue close (previously only DoR/DoD were covered). Added enforce-close-guard job to template-enforcement.yml: issues closed as "completed" that are missing DoR/DoD sections or still carry status:needs-more-info are automatically re-opened with an explanation comment. Activated issues.agent.js apply mode — the workflow now writes status:needs-triage, priority:normal, and a detected type:* label to newly opened issues when those label categories are not already present; updated issues.yml permissions from issues: read to issues: write. (#1014)

• GitHub Merge Queue support — Added merge_group: types: [checks_requested] trigger to checks.yml, validate-pr-template.yml, and main-branch-guard.yml so required status checks fire correctly inside GitHub's Merge Queue. Skipped branch-name validation for merge_group runs and updated the changed-files comparison to use merge-queue SHAs. Added merge_queue rule (ALLGREEN grouping, 60-minute check timeout) to both develop and main branch rulesets. (PR #1008, Issue #1008)

• Mermaid WCAG 2.2 AA colour contrast validation — Added scripts/validation/validate-mermaid-colour-contrast.js which checks every style declaration in Mermaid diagrams against a pre-verified WCAG 2.2 AA palette (minimum 4.5:1 contrast ratio). The validator supports --changed-files scoping for CI efficiency, flags unparseable hex values as errors, strips inline %% comments before parsing, and generates a dated markdown report under .github/reports/mermaid/. Added npm run validate:mermaid-contrast script. Updated .github/workflows/validate-mermaid-pr.yml to run all three diagram checks (syntax, accessibility, contrast) on every PR that modifies .md/.mdx files, posting a consolidated status comment. Updated instructions/mermaid.instructions.md with the approved seven-role WCAG AA palette and required structure. Fixed all existing diagram style declarations across README.md, docs/AGENT_CREATION.md, profile/README.md, scripts/README.md, tests/README.md, and .github/ISSUE_TEMPLATE/README.md to use the approved palette triples (fill, color, stroke). (#977, #976)

Fixed

• Dependabot auto-merge unblocked — Fixed Mergify configuration that prevented all dependabot PRs from being automatically merged: consolidated the redundant security/non-security rules into one, replaced the invalid approve: action with review: type: APPROVE (which satisfies branch-protection review requirements), and added a dependabot-automerge.yml GitHub Actions backup workflow that approves and enables squash auto-merge via workflow_run when CI passes on a dependabot PR. (#1020, relates to #968)

• Release agent hardening — Fixed four bugs in scripts/agents/release.agent.js: (1) regex escape \\d+ → \d+ in getMergedPRs so PR numbers are correctly extracted from git log; (2) automated release PR body now includes all three sections (## Linked issues & merged PRs, ## Changelog, ### Checklist (Global DoD / PR)) required by the main-branch-guard; (3) createReleasePR (shell provider) now writes the body to a temp file and uses --body-file to avoid shell injection from backtick-containing markdown; (4) corrected Husky v9 command from npx husky run pre-commit to npx lint-staged. Added full test suites for changelogUtils.cjs, validate-main-branch-pr.cjs, and release.agent.js (ESM subprocess pattern); rewrote the stub in validate-changelog.test.js with real CLI and integration tests. Clarified the develop → release/vX.Y.Z → main flow in the release issue template. (#1018, #968)

Changed

• Release issue template rewrite (v2.0.0) — Rewrote .github/ISSUE_TEMPLATE/18-release.md with step-by-step release initiation commands, changelog validation steps, dry-run and live release instructions, explicit squash-merge warning, open PR tracking section, rollback commands, and expanded Definition of Ready/Done. Aligns template with the release process documented in issue #968. (#1021, #968)

• Frontmatter standardisation across issue templates, docs, and validation — Normalised markdown issue templates to use name + about, aligned the frontmatter schema and validation scripts with the GitHub-supported template contract, and updated the issue-creation workflow plus related docs, instructions, and prompts to match the canonical template layout. (#1016, #1012, #1015)

• Automation governance for Dependabot PRs and branding footers — Stopped the metadata sync flow from auto-creating a milestone for each Dependabot PR, switched footer detection to the canonical branding config with tail-aware matching, and backfilled branded markdown footers across the repository. Updated the related CI, workflow, and documentation surfaces to keep the behaviour durable. (#1010, #1013)

• Metadata governance automation for issues and pull requests — Added and hardened the GitHub automation that assigns project items, milestones, assignees, issue/PR relationships, project field values, and labelling behaviour for new issues and pull requests. Also updated the related docs, workflow guards, and test coverage to match the current codebase. (#974)

• Community health audit — PR templates, governance docs, and README alignment — Completed a comprehensive audit of all community health files: updated WCAG version references from 2.1 to 2.2 AA in pr_bug.md, pr_chore.md, pr_ci.md, and pr_dep_update.md; added 15 missing branch-prefix rows to the default pull_request_template.md quick-selector table to align with PULL_REQUEST_TEMPLATE/config.yml; expanded AGENTS.md issue template list from 10 to 23 entries and added Saved Replies section; expanded CLAUDE.md issue template list to match; fixed template count, range, and parity note in .github/custom-instructions.md; completely rewrote .github/workflows/README.md with an accurate inventory of all 27 real workflows (removed 4 phantom workflow references); updated .github/README.md version date; added 20 missing files to .github/SAVED_REPLIES/README.md; added template index table to .github/ISSUE_TEMPLATE/README.md; replaced generic category list with the 9 actual YAML file inventory in .github/DISCUSSION_TEMPLATE/README.md; updated docs/ISSUE_CREATION_GUIDE.md to 25-template parity and corrected label values. (#966)

Fixed

• Mermaid validator hardened to reject accTitle/accDescr placed before diagram type — Added a guard in scripts/validation/validate-mermaid-accessibility.js that rejects any Mermaid block where accTitle or accDescr appears before the diagram type declaration (e.g. flowchart TD). Corrected all 20 affected diagrams across 9 files (.github/instructions/.archive/frontmatter.instructions.md, .github/instructions/.archive/tests.instructions.md, .github/reports/mermaid/diagram-validation-2025-12-11.md, CONTRIBUTING.md, docs/HUSKY_PRECOMMITS.md, instructions/automation.instructions.md, instructions/documentation-formats.instructions.md, instructions/linting.instructions.md, instructions/quality-assurance.instructions.md) to place the diagram type first. 60/60 diagrams are now compliant.

• Mermaid YAML front-matter converted to inline accessibility syntax — Replaced all Mermaid --- YAML front-matter blocks (unsupported by GitHub's renderer) with inline accTitle and accDescr attributes placed directly after the diagram type declaration. Affected files: .github/ISSUE_TEMPLATE/README.md, .github/README.md, .github/prompts/update-mermaid-diagrams.prompt.md, .github/reports/audits/2026-06-03-file-organisation-migration-plan-673.md, .vscode/README.md, docs/AGENT_CREATION.md, docs/CANONICAL_CONFIGS_GUIDE.md. Updated scripts/validation/validate-mermaid-accessibility.js to ignore .claude/** worktree directories and use a regex for accDescr { block detection. Updated instructions/mermaid.instructions.md to explicitly forbid YAML front-matter syntax. Closes #991. (#995)

• label-sync.js crash on YAML-ambiguous hex color values — YAML parses bare hex strings such as 8957E5 (parsed as scientific notation 895700000) and 007580 (parsed as integer 7580) as numbers, causing labelObj.color.replace is not a function in the Unified Labeling workflow. Quoted all affected color: values in .github/labels.yml and added String() coercion in scripts/agents/includes/label-sync.js as defence-in-depth. (#995)

• Repository-wide Mermaid accessibility and contrast coverage — Added accTitle and accDescr to every Mermaid diagram in the repository, updated the Mermaid prompt/instructions/workflo...

v0.5.0

Release summary

This release closes out the v0.5.0 readiness work from PR #776 and finalises the repo for tagging.

Fixed

• Aligned release metadata across VERSION, package.json, and package-lock.json.
• Fixed repo-wide frontmatter and schema issues in the WCEU 2026 content set and active site-planning docs.
• Corrected release documentation and changelog entries for the v0.5.0 cut.
• Stabilised the release-agent MCP test so it works against the current repo version.

Validation

• npm ci
• npm run validate:plugins
• npm run validate:links
• npm run validate:workflows
• npm run validate:frontmatter
• npm run lint:md
• npm test -- --runInBand

v0.4.0

What's Changed

• Add automation governance and release strategy doc by @ashleyshaw in #7
• CodeRabbit Generated Unit Tests: Add tests for docs, PR templates, and CHANGELOG; remove examples/ dir by @coderabbitai[bot] in #9
• 📝 Add docstrings to chore/add-pr-templates-add-docs by @coderabbitai[bot] in #10
• Update default PR Templates by @ashleyshaw in #8
• Release v0.3.0: maintenance, docs & meta updates by @ashleyshaw in #201
• Refactor/291 292 GitHub boundary by @ashleyshaw in #324
• feat: initialize portable AI plugin restructuring project with comprehensive epic, batch, and issue planning documentation. by @ashleyshaw in #322
• Add portable AI source folder READMEs by @ashleyshaw in #323
• Codex/ash refactor by @ashleyshaw in #325
• chore: add explicit accessibility and security PR checklists and align saved replies by @Copilot in #369
• Chore/wider skills governance cleanup by @ashleyshaw in #376
• Copilot/automatically merge pr 373 by @ashleyshaw in #377
• [WIP] Migrate CI scripts from bash to JavaScript with measurable improvements by @Copilot in #336
• [WIP] Add accessibility and security checklists to PR templates and docs by @Copilot in #332
• chore(deps): bump ip-address from 10.1.0 to 10.2.0 by @dependabot[bot] in #372
• [WIP] Expand .coderabbit.yml with WP-docs improvements and revalidate by @Copilot in #335
• [WIP] Audit reusable .github assets for clarity on usage by @Copilot in #334
• chore(deps): bump dompurify from 3.3.0 to 3.4.5 by @dependabot[bot] in #378
• chore(deps): bump basic-ftp from 5.0.5 to 5.3.1 by @dependabot[bot] in #379
• docs: Add plugin-structure instructions, CLAUDE.md, clean up scratch file, and resolve merge conflicts by @Copilot in #370
• [WIP] Conduct audit of governance and change management documentation by @Copilot in #331
• [WIP] Audit review of CONTRIBUTING.md for quick start and flow clarity by @Copilot in #333
• chore(deps): bump lodash, @stoplight/spectral-cli, @stoplight/spectral-core and @stoplight/spectral-functions by @dependabot[bot] in #380
• chore(deps-dev): bump @typescript-eslint/eslint-plugin from 6.21.0 to 8.60.0 by @dependabot[bot] in #381
• chore(deps-dev): bump @babel/core from 7.28.5 to 7.29.7 by @dependabot[bot] in #389
• chore(deps-dev): bump @babel/preset-typescript from 7.28.5 to 7.29.7 by @dependabot[bot] in #388
• chore(deps-dev): bump @typescript-eslint/parser from 6.21.0 to 8.60.0 by @dependabot[bot] in #387
• chore(deps-dev): bump @babel/plugin-transform-runtime from 7.28.5 to 7.29.7 by @dependabot[bot] in #386
• chore(deps-dev): bump @babel/runtime from 7.28.4 to 7.29.7 by @dependabot[bot] in #385
• fix(ci): stabilise workflows for v0.4.0 release by @ashleyshaw in #390
• chore(deps-dev): bump @babel/preset-react from 7.27.1 to 7.29.7 by @dependabot[bot] in #382

New Contributors

• @coderabbitai[bot] made their first contribution in #9

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[0.3.0] - 2025-12-18

Maintenance

• Repository maintenance: metrics snapshot updates, documentation and script syncs, and archive moves (#64c3662, #aa66dc6, #dd5b55f).

[0.2.0] - 2025-12-18

Added

• Comprehensive meta agent (meta.agent.js) for unified front matter, badge, human reference, and footer automation (renamed from branding agent)
• Unified labeling agent (labeling.agent.js) replacing split status/type/standardization agents
• Extended README management with support for dynamic header/footer insertion and frontmatter validation
• Footer schema configuration (footer.schema.json) and header schema for consistent presentation
• Enhanced frontmatter validation across all .md files in repository
• Support for multiple footer variants with deterministic selection via seeding
• Emoji support in README headings for improved visual hierarchy
• Mermaid diagram preservation in all README updates
• Batch processing capabilities for efficient multi-file updates

Changed

• Updated all README files with emoji-enhanced headings for better visual hierarchy
• Migrated frontmatter across core documentation to unified frontmatter.schema.json standard
• Reorganized .github/agents/ structure with shared utilities in includes/ subdirectory
• Consolidated badge management under meta agent (deprecated badges.agent.js)
• Unified header/footer handling under meta agent (deprecated header-footer.agent.js)
• Standardized YAML frontmatter metadata across all documentation files
• Enhanced README file templates with proper frontmatter structure
• Updated version numbers for all core README files to reflect latest changes

Deprecated

• badges.agent.js - Use meta.agent.js instead for unified badge/header/footer management
• header-footer.agent.js - Use meta.agent.js instead for unified automation

Documentation

• Added comprehensive meta agent specification in .github/agents/meta.agent.md
• Updated unified labeling agent documentation with latest configuration options
• Created detailed README templates for nested project directories
• Enhanced footer-content.json with multiple funky footer variants
• Documented footer schema validation and implementation
• Added examples for frontmatter validation across file types
• Created inline documentation for all agent helper functions

Fixed

• Corrected frontmatter schema validation errors in documentation files
• Fixed missing created_date fields in core README files
• Resolved inconsistent emoji usage across headings
• Fixed footer text alignment and markdown formatting
• Corrected references paths in frontmatter to use relative paths consistently
• Fixed mermaid diagram formatting in README files

Performance

• Optimized README file updates with batch multi-replace operations
• Improved footer selection performance with deterministic seeding
• Enhanced memory efficiency in meta agent for large file batches