Skip to content

fix(gates): require .deed, not the deprecated .a2ml - #21

Merged
hyperpolymath merged 1 commit into
mainfrom
fix/deed-gate-grammar
Sep 21, 2026
Merged

hyperpolymath merged 1 commit into
mainfrom
fix/deed-gate-grammar

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

What breaks today

dogfood-gate.yml counts .a2ml files and nothing else, so a repo whose only manifest is a
.deed document gets ::warning::No .a2ml manifest files found, and the summary step is
skipped by the same predicate. The gate is checking for a grammar the estate has deprecated.

Authority for the new wording

  • deed-ecosystem/README.adoc: "The DEED format name and .deed extension are final, not A2ML."
  • rsr-template-repo ships rsr-template-repo_chora.deed and bootstraps with just repo-init;
    the removed a2mliser init instruction points at neither.
  • hyperpolymath/accessibility-everywhere already carries this exact migrated form, so this PR
    converges a stale copy rather than introducing a new convention.

Deliberately not touched

  • .machine_readable/*.a2ml and any gate reading a real retained file: their own README scopes
    the rename away from "retained A2ML v1 material". Rewriting those inputs would fail gates that
    currently pass.
  • validate-a2ml.sh hook filenames and the validator's own Validate A2ML Manifests step name
    (names, not grammars).

Part of the estate-wide .deed gate migration, 2026-09-21.

The guard counted `.a2ml` files only, so a repo carrying just a `.deed` document was told it had
no manifest at all:

  - find \. -name '\*\.a2ml' -not -path '\./\.git/\*'
  + find . -type f \( -name '*.a2ml' -o -name '*.deed' \) -not -path './.git/*'

The validator already reads both grammars; the caller's predicate was the bug. Wording follows the
estate's own migrated copy and `deed-ecosystem/README.adoc`: `.deed` is final, `.a2ml` is legacy and
no longer authored, and the template bootstraps with `just repo-init` (so the `a2mliser init`
instruction is removed). Retained `.machine_readable/*.a2ml` inputs are untouched.
@coderabbitai

coderabbitai Bot commented Sep 21, 2026 •

Copy link
Copy Markdown

Review Change StackReview Change Stack

Understand this PR’s impact

Explore downstream dependencies and potential security impact with Blast Radius.

View blast radius →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 83440ecc-d3da-42cc-aeb9-b22ad7849d06

📥 Commits

Reviewing files that changed from the base of the PR and between f29f793 and b0a808c.

📒 Files selected for processing (1)
  • .github/workflows/dogfood-gate.yml

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

📜 Recent review details
⏰ Context from checks skipped due to timeout. (13)
  • GitHub Check: scan / shell-secrets
  • GitHub Check: scan / gitleaks
  • GitHub Check: scan / rust-secrets
  • GitHub Check: GitGuardian Security Checks
  • GitHub Check: analyze (actions, none)
  • GitHub Check: Julia 1.11 - ubuntu-latest
  • GitHub Check: Julia 1.11 - macos-latest
  • GitHub Check: Julia 1.10 - ubuntu-latest
  • GitHub Check: Validate A2ML manifests
  • GitHub Check: Validate eclexiaiser manifest
  • GitHub Check: Validate K9 contracts
  • GitHub Check: Groove manifest check
  • GitHub Check: Empty-linter (invisible characters)
🔇 Additional comments (1)
.github/workflows/dogfood-gate.yml (1)

36-36: LGTM!

Also applies to: 39-39, 56-56, 58-58, 63-63, 319-319, 373-373


📝 Summary

Summary by CodeRabbit

  • Changes
    • Compliance checks now use 0-AI-MANIFEST.deed as the primary manifest format.
    • Validation and summary reporting recognise manifest files with either .deed or .a2ml extensions.
    • .a2ml remains supported as a legacy format and is no longer presented as the preferred authoring format.
    • Updated warnings, scorecard labels and workflow summaries clarify the required .deed manifest.

Walkthrough

The dogfood gate now treats .deed manifests as primary and .a2ml manifests as legacy. Detection, validation messages, scanned-file counts, and scorecard reporting reflect both formats.

Changes

Manifest compliance

Layer / File(s) Summary
Manifest detection and validation messages
.github/workflows/dogfood-gate.yml
Manifest detection now counts .deed and .a2ml files. Warnings identify 0-AI-MANIFEST.deed as required and .a2ml as legacy.
Scorecard manifest reporting
.github/workflows/dogfood-gate.yml
The scorecard accepts either manifest format. Its table labels the check as a DEED manifest check.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Bug fix

Suggested reviewers: metadatastician

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description explains the defect, rationale, and scope, but it does not use the required Summary, Changes, RSR Quality Checklist, Testing, or Screenshots sections. It also provides no test results … Update the description to use the repository template. Add Summary and Changes sections, complete the RSR Quality Checklist, describe the tests run and their results, and add screenshots or terminal output if applicable.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely identifies the main change: requiring .deed manifests instead of deprecated .a2ml manifests in the gates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Description check

Explanation

The description explains the defect, rationale, and scope, but it does not use the required Summary, Changes, RSR Quality Checklist, Testing, or Screenshots sections. It also provides no test results or checklist status.

  • Fix all pre-merge checks with AI

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit checks the manifest gate,
DEED files now define the state.
Old A2ML files still pass,
While scorecards name the newer class.
Hop by hop, the workflow’s clear.

Comment @coderabbitai help to get the list of available commands.

@hyperpolymath
hyperpolymath merged commit d923697 into main Sep 21, 2026
12 of 16 checks passed
@hyperpolymath
hyperpolymath deleted the fix/deed-gate-grammar branch September 21, 2026 11:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant