Skip to content

Docs claim more verification than the receipts show #95

Open

Description

@hyperpolymath

The 2026-11-17 estate survey found the items below in this repository. Each one was confirmed by a second, independent check against the file and line shown, at the default-branch head the survey read. The policy is metadatastician/standards 3-practice/PROOF-POLICY.adoc (estate AFFIRMATION ethos: report faithfully, no overclaim).

1. overclaim (medium)

README and EXPLAINME say the Idris2 ABI is a 'Formally verified health state machine' whose dependent types 'prove ... state transition validity', but no workflow type-checks the Idris2 package (the only mention is a comment) and the file's own caveat says generation from the specs is not done.

Evidence

  • README.adoc:49: * ABI (Idris2): src/interface/abi/*.idr — Formally verified health state machine, monitor protocol, panel protocol.
  • EXPLAINME.adoc:41: == Idris2 ABI: Formally Verified Health State Machine

Policy basis: PROOF-POLICY §5 and claim-needs-receipts.

Suggested fix: Add an idris2 --build job and cite its run, or reword to 'specified in Idris2 (not CI-checked)'.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationDocs, prose, diagrams, READMEs, ADRs

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions