Repository navigation
feat: re-approval path for approve-rule with explicit changelog - #2453
WilcoFiers wants to merge 2 commits into
Conversation
Archive the previous approved rule and require explicit change entries when approving an updated rule. Co-authored-by: Cursor <cursoragent@cursor.com>
❌ Deploy Preview for act-rules failed.
|
Co-authored-by: Cursor <cursoragent@cursor.com>
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Workflow changelog forwarding is incomplete, and same-day re-approvals can overwrite archived snapshots.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 1
Open (2)
What changed in this PR
Adds re-approval support for ACT rules, including archived snapshots, changelog handling, focused tests, and CI coverage.
Changes:
- Archives prior approved rule versions.
- Parses explicit changelog entries from CLI flags or YAML.
- Updates version history and approval workflows.
- Adds tests and CI integration.
Unresolved issues include missing workflow changelog forwarding and same-day snapshot overwrite risk.
| File | Summary |
|---|---|
README.md |
Documents changelog inputs; workflow invocation remains incomplete. |
package.json |
Adds approval-script tests. |
.github/workflows/test.yml |
Runs approval-script tests in CI. |
.github/scripts/update-rule-versions.test.mjs |
Tests version updates and changelog parsing. |
.github/scripts/update-rule-versions.mjs |
Updates version history and archives snapshots; same-day collisions remain possible. |
.github/scripts/archive-rule-snapshot.test.mjs |
Tests archived snapshot rewriting. |
.github/scripts/archive-rule-snapshot.mjs |
Rewrites archived snapshot metadata. |
.github/scripts/approve-rule.mjs |
Integrates re-approval and changelog handling. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| file: `${currentIndex.isoDate}.md`, | ||
| url: `${ruleId}/${currentIndex.isoDate}/`, |
|
|
||
| This repository automatically pushes changes to rules to the [w3c/wcag-act-rules](https://github.com/w3c/wcag-act-rules/) repository. There is an "Approve rule" action available which can be triggered manually by an ACT Task Force facilitator, which will set a proposed rule to "approved". | ||
|
|
||
| Rule updates require an explicit changelog when using the approval script. Pass entries with repeated `--change "..."` flags, with `--changesFile path.yaml` containing a YAML list of strings, or with both. First-time approvals do not require a changelog. |
|
@WilcoFiers Before getting into reviewing this -- is there any reason we are removing the semiclons at the end fo each statement? Keeping them would make it for a much cleaner diff |


Summary
index.mdunder its ISO date--changeflags and/or a YAML--changesFileTest plan
npm run test:approve-rule(5 passed)npm test -- --runInBand(11 suites, 9704 tests passed)Closes act-rules/act-tools#64