Skip to content

[Backend] Add a contract blueprint deprecation and ownership model #253

Description

@grantfox-oss

Problem

As a community-maintained registry grows, blueprints will inevitably become stale (contract upgraded, original author unreachable) or contested (two contributors submit conflicting interpretations of the same contract's events). There's currently no described mechanism for who can update an existing blueprint, how staleness is flagged, or how conflicts are resolved — this becomes a real governance gap as the registry scales past a handful of contracts.
Proposed work

Add an owner/maintainers field (GitHub usernames) and status field (active, needs-review, deprecated) to the blueprint schema (building on the versioning from Issue #23).
Define a lightweight policy in CONTRIBUTING.md: how a non-owner proposes a correction, how staleness gets flagged (tying into the fixture-drift detection from Issue #29), and a timeout after which an unresponsive owner's blueprint can be taken over.
Surface blueprint status/ownership in the dashboard provenance badge from Issue #27.

Acceptance criteria

Schema supports ownership/status without breaking existing blueprints (sensible defaults for missing fields).
Policy document covers at least: correction proposal, staleness flagging, unresponsive-owner handoff.
At least one real existing blueprint is updated to use the new fields as a working example.

Metadata

Metadata

Assignees

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions