Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Evidence: OPERATOR-CONTRACT says audit sequence numbers restart, but the .seq companion keeps them

Open Beginner friendly
#1,647 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
rust

Research direction

Start by inspecting crates/registry-platform-audit/src/writer.rs to verify how the .seq companion determines the next sealed-segment number, then compare that behavior with the retention guidance in docs/site/src/content/docs/operate/retention-and-persistent-state.mdx. Update the audit-section sentence in products/evidence/OPERATOR-CONTRACT.md and retain the archive-keying advice only if the verified behavior supports it.

Written by the indexing model from the issue text.

Description

agent-ready area:docs area:evidence criticality:p3 documentation triage:needs-implementation

products/evidence/OPERATOR-CONTRACT.md (audit section) says: "Sequence numbers restart after retention has deleted every sealed file and the process restarts, so archives must not be keyed on the sealed file name alone." The shared writer now records the next sealed-segment number in a .seq companion (crates/registry-platform-audit/src/writer.rs), and docs/site/src/content/docs/operate/retention-and-persistent-state.mdx describes numbering that survives retention. Verify the writer's behavior and correct the contract sentence (and keep the archive-keying advice only if it still holds).

Found while writing the #1415 runbooks.

Dominant language
Rust
Stars
2
Forks
0
Avg merge
7h 46m
Merged PRs (30d)
199

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from registrystack/registry-stack

All issues in registrystack/registry-stack

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.