Skip to content

Docs claim more verification than the receipts show #403

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 presents proven modules as 'Integrated' with 'Formally proven correctness', but docs/PROVEN_INTEGRATION.adoc marks the modules Planned and lists 'Add proven-rust to Cargo.toml' as an open item. The proofs would live in another repo (proven) in any case.

Evidence

  • README.adoc:543: Academic Workflow Suite integrates with the https://github.com/hyperpolymath/proven[proven library] - a formally verified, crashproof library
  • README.adoc:575: * Mathematical Guarantees: Formally proven correctness
  • docs/PROVEN_INTEGRATION.adoc:23: | Planned
  • docs/PROVEN_INTEGRATION.adoc:368: * [ ] Add proven-rust to Cargo.toml

Policy basis: A claim that relies on another repo's proofs must say so. 'Verified' needs current receipts, and none exist for the integration.

Suggested fix: Retitle the section 'Planned proven integration'. Drop the 'Guarantees' table and the 'Formally proven correctness' benefit until the dependency lands. After that, attribute the proofs to proven.

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