Skip to content

docs(design): target AVE schema 1.1.0; mark the v1.2 plan superseded - #76

Open
chaksaray wants to merge 1 commit into
developfrom
docs/74-design-ave-1-1-0
Open

chaksaray wants to merge 1 commit into
developfrom
docs/74-design-ave-1-1-0

Conversation

@chaksaray

Copy link
Copy Markdown
Member

Closes #74

What and why

Maintainer decision in #71: the gate targets AVE schema 1.1.0. DESIGN.md 9 specified an AVE 1.2 that AVE never published.

Measured, aveproject/ave main and gate origin/develop, 2026-10-18/19:

dist/ave-records-latest.json      87 records, schema_version 1.1.0 for all, AIVSS spec 0.8
provenance_vector                 87/87; entry_class is a layer token (tool_response, server_card, ...), escalation data_to_instruction style
trifecta_profile                  77/87; requires + amplifies arrays
capability_mitigation             not in schema/ave-record-1.1.0.schema.json; 0/87 records
harden --ave                      reads mitigations/ave-mitigations.json (2 entries: manifest_stanza, review_status, reviewed_by, reviewed_at, rule_ids)
src/ reads provenance_vector / trifecta_profile   no (git grep: only tests/, scripts/)

Changes, DESIGN.md only:

  • Header: "Depends on: AVE schema 1.1.0 (aveproject/ave; see Section 9)"
  • 6.2: data.ave cites IDs whose mitigation stanza produced the blocking rule (Section 9.1)
  • 9: "AVE records: schema 1.1.0". The gate consumes AVE 1.1.0 and does not define or extend the AVE schema
  • 9.1: the fields the gate uses, by reference to AVE's schema; mitigation stanzas live in the gate's own mitigations map, with the shape of schemas/bawbel-ave-mitigations-v1.json; the gate does not consume provenance_vector or trifecta_profile at runtime
  • 9.2: marked superseded, with what happened. This also removes the last ave.bawbel.io string in the repo
  • 9.3: unchanged
  • 12, Open: how AVE entry_class tokens map to gate provenance classes. Not specified here, on purpose: that mapping is a design choice, not a fact

Not changed: Section 11 still cites BAWBEL_GATE_MITIGATIONS_SPEC.md Section 3, which is gitignored (.gitignore:2) and so not in the repository.

Governing spec

DESIGN.md section(s): header, 6.2, 9 (rewritten), 9.2 (superseded), 12.

Output contract

Verification

$ grep -n -E 'AVE schema >= 1\.2|ave\.bawbel\.io' DESIGN.md
(no output)

pytest                          -> 346 passed in 11.60s
pytest tests/property/ -x       -> 26 passed in 1.42s
pytest tests/replay/            -> 32 passed in 0.35s
pytest tests/test_m4_corpus.py  -> 10 passed in 0.17s   (approval budget)
pre-commit run --files DESIGN.md -> Passed
em dashes on added lines: 0

Checklist

🤖 Generated with Claude Code

Maintainer decision (#71): the gate consumes AVE records at schema
1.1.0, published by the independent AVE project. AVE never published
1.2: all 87 records are 1.1.0, provenance_vector and trifecta_profile
are optional 1.1.0 fields in different shapes, and capability_mitigation
is not in AVE.

Section 9 now states what the gate reads, by reference to the AVE
schema, and that mitigation stanzas live in gate's own mitigations map,
which harden --ave already reads. The mapping from AVE entry_class
tokens to gate provenance classes is an open question in Section 12.
9.2 is marked superseded with what happened. Header and 6.2 follow.

DESIGN.md only. The code change is #75.

Closes #74

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: chaksaray <chaksaray@gmail.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant