registrystack / registrystack/registry-stack

BReg evidence export: behaviorRevision omits the engine version and churns on unprojected columns

Open
#869 0 comments 0 reactions 0 assignees View on GitHub
area:breg criticality:p3 needs-jeremi-decision rust
Dominant language
Rust
Stars
2
Forks
0
Avg merge
2h 57m
Merged PRs (30d)
128

Description

The export manifest's `behaviorRevision` (`crates/registry-breg/src/evidence_source.rs`) is the digest of the canonical behaviour document. The review found two consequences:

- It carries no engine or protocol version, so a lookup change on the engine side leaves every fingerprint unchanged.
- A change to a stored column the export does not project still churns the revision.

Decide what the revision is meant to fingerprint (the projected contract as served by a named engine version is the natural reading), then either fold the engine version and the projection scope into the digest input, or document the current meaning in `products/evidence/reference/authoring-projects/SOURCE-EXPORT.md` so an operator knows when a changed revision matters.

Origin: review of PR #865.

Contributor guide

Open the contributing guide

Research direction

Start with crates/registry-breg/src/evidence_source.rs and the export manifest’s behaviorRevision digest, then read products/evidence/reference/authoring-projects/SOURCE-EXPORT.md for the documented contract. Define whether the fingerprint covers the projected contract and named engine or protocol version; done when the digest inputs reflect that scope or the documentation clearly states the current meaning and when revisions matter.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
backend-api-design
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.