Skip to content

feat: add externally reproducible PromiseProof verification#1

Merged
AlexPaiva merged 7 commits into
mainfrom
feature/promiseproof-verify
Jul 21, 2026
Merged

feat: add externally reproducible PromiseProof verification#1
AlexPaiva merged 7 commits into
mainfrom
feature/promiseproof-verify

Conversation

@AlexPaiva

Copy link
Copy Markdown
Owner

What this adds

PromiseProof Verify exposes the unchanged deterministic authority layer through:

  • a repository-local external-evidence CLI;
  • evidence-bound JSON and Markdown reports;
  • complete report reproduction through promiseproof check;
  • hosted local-only Judge Mode at /verify/;
  • a semantic tamper that turns the sealed report stale and the verdict into BROKEN_PROMISE;
  • browser and CLI byte-identical report parity;
  • strict no-egress and hostile-input tests;
  • CI protection for the verifier core, real-pipeline equivalence, and hosted experience.

Trust boundaries

  • Exactly one supported contract family: activity-personalization/v1.
  • External evidence collection is not attested.
  • Binding proves the report matches the supplied evidence and the pinned evaluator source.
  • check re-runs the evaluator and compares the complete regenerated report.
  • No GPT-5.6 or Codex call participates in the verdict path.

Preserved

  • Canonical evaluator unchanged.
  • GPT-5.6 investigation unchanged.
  • Authentic Codex repair and patch digest unchanged.
  • Seeded-broken main behavior preserved.
  • Existing walkthrough and authority architecture preserved.

The check command re-runs the evaluator on the supplied evidence,
rebuilds the full report, and compares the whole canonicalized
document rather than trusting the embedded hashes. A report with the
right digest and fingerprint but a faked verdict no longer passes.

Works for single bundles and OFF/ON gates, with exit codes 0
reproduced, 4 mismatch, 3 invalid, 1 error. Adds 16 adversarial tests.
A no-network page that runs the same verifier modules as the CLI over
the passing OFF and ON example, opening on PASS with a bound report.
Tampering the OFF evidence adds one identifiable activity and receipt,
so the evaluator returns a broken promise and the sealed report stops
reproducing. Re-sealing binds the broken verdict, never a pass. It also
verifies bring-your-own bundles and downloads the report.

build:site now assembles /verify/ next to / and /walkthrough/. A
Playwright suite covers the load state, the absence of network traffic,
the tamper flip, and byte-identical browser and CLI reports.
Add a Try PromiseProof Verify section to the README that links the hosted Judge Mode and shows the init, gate, and check commands with their exit codes. Add ADOPTION.md, a developer guide covering the evidence envelope, the CLI, the report format, outcomes, binding semantics, trust boundaries, limits, and platforms. Add a compact bring-your-own-evidence section and a footer link on the landing page so the verifier is discoverable without changing the hero or walkthrough.
@AlexPaiva
AlexPaiva merged commit 4bb74a9 into main Jul 21, 2026
4 checks passed
@AlexPaiva
AlexPaiva deleted the feature/promiseproof-verify branch July 21, 2026 17:52
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.

1 participant