Skip to content

fix(readme): replace flat verification badge with honest Rocq badge - #38

Merged
avrabe merged 1 commit into
mainfrom
fix/readme-badge-honesty
Jul 21, 2026
Merged

fix(readme): replace flat verification badge with honest Rocq badge#38
avrabe merged 1 commit into
mainfrom
fix/readme-badge-honesty

Conversation

@avrabe

@avrabe avrabe commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Summary

  • The README carried a flat green "Formally Verified" badge, but the repo is Bazel/Nix plumbing wiring Rocq 9.0 + rocq-of-rust into builds — the only .v proof in the tree is an example (examples/rust_to_rocq/point_proofs.v), not a proof about the rules themselves.
  • Replaces it with a technique-named "Rocq" badge, matching the precedent set by sibling rules_lean (no flat verification badge).

Closes #36

🤖 Generated with Claude Code

https://claude.ai/code/session_011MptgyfLZuHYCbfpq1zDey

The repo carries no mechanized proofs about its own rules (only an
example proof in examples/rust_to_rocq/point_proofs.v), so the flat
green badge overstated the repo's verification status.

Closes #36

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011MptgyfLZuHYCbfpq1zDey
@avrabe
avrabe merged commit 9240ff5 into main Jul 21, 2026
8 checks passed
@avrabe
avrabe deleted the fix/readme-badge-honesty branch July 21, 2026 18:21
avrabe added a commit that referenced this pull request Jul 21, 2026
)

* docs: gate README claims against live evidence (claim-verification)

Audited this repo's load-bearing claims after the badge fix (#36/#38) and
the Gappa/Flocq/Coq-Interval toolchain feature (#37/#41):

- Found the footer tagline still carried the retired flat-verification
  overclaim ("formally verified WebAssembly toolchain for safety-critical
  systems") -- the same overclaim #36 fixed in the badge, just relocated,
  and factually wrong on top (this repo has nothing to do with
  WebAssembly). Replaced with an accurate description.
- Toolchain Contents table and Examples section were stale after #41 --
  didn't mention Flocq/Coq-Interval/Coquelicot/Gappa or
  examples/gappa_proof. Updated both.
- Added claims.yaml + tools/claim_check.py (the claim-verification skill's
  reference implementation): each load-bearing README claim is bound to a
  predicate re-derived from the actual source (file-exists, count-min,
  count-max on the retired overclaims) rather than trusted as prose.
- Wired `claim-check` into CI as its own job: a stale or overclaiming
  README now fails the build the same way an un-kernel-checked proof
  fails a rocq_proof_test.

All 5 claims pass against current main: `python3 tools/claim_check.py
claims.yaml` -> 5/5.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011MptgyfLZuHYCbfpq1zDey

* fix(ci): use --break-system-packages for pip install in claim-check job

The self-hosted smithy runners are Debian/python3.12 with PEP 668's
externally-managed-environment guard, which refuses a bare pip install.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011MptgyfLZuHYCbfpq1zDey

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
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.

README "Formally Verified" badge flattens the Rocq toolchain

1 participant