proof-aware-crypto-tooling-.../notebooks
mrwulf 4a37da8fd9 Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood)
The notebooks now carry the same didactic contract as the companion book
(the "ratchet rule", stated in the course map): every load-bearing idea
runs twice - napkin scale, then real scale - and every pair is EXECUTABLE
in the notebook, not narrated.

- Lecture 1: the truth boundary updated to the proven four-tier apex,
  with the what-is-still-NOT-proven list (SHA-512, parsers, signing,
  wallets) given equal weight.
- Lecture 2: napkin/real scoring pair - a two-certificate toy card
  scored in your head, then the shipped sixteen-certificate R4 fixture
  through the same function, residual blockers and per-tier boundary
  axioms printed.
- Lecture 6: new split-view section. A runnable equivocation drill:
  pin a two-leaf view, grow it honestly with a consistency proof, then
  present a forged same-size root and watch the pin store name the
  attack. Real-scale pointers to --sth-store, log-consistency,
  log-audit, and the freshness policy; a new exercise asks students to
  construct the lie a size-only anchor check would miss.
- Lecture 7: the wallet gate now swings BOTH ways on real evidence -
  a partial card denied at R3, the shipped R4 card allowed - both
  runnable.
- Lecture 8 capstone: "design R4" became "audit R4": read the shipped
  card like an auditor, then design the R5 discharge plan (parser
  specs, verified SHA-512, signing-side, per-fork production-path
  mapping).
- NEW Lecture 9, "Eat Your Own Dogfood": the honest coverage ledger of
  the proven-path verifier; a napkin PEM decode (the fixed 12-byte
  Ed25519 SPKI prefix, read with your eyes) paired with the mechanical
  extraction; live backend dispatch; the fail-closed
  --require-verified-verifier policy; and the hybrid-PQC section -
  proven-classical Ed25519 plus a required-but-honest ML-DSA slot
  ("blockers get fixed; placeholders get trusted").

Every code cell of the changed notebooks was executed end-to-end before
committing (outputs stripped per house rules). 49/49 tests green with
the notebook inventory updated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 10:18:06 +02:00
..
00_course_map.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
01_threat_model_and_truth_boundary.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
02_claim_cards_and_risk_model.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
03_lean_replay_and_axiom_audit.ipynb add proof-aware crypto curriculum notebooks 2026-07-03 14:42:59 +02:00
04_proof_hygiene_and_boundaries.ipynb add proof-aware crypto curriculum notebooks 2026-07-03 14:42:59 +02:00
05_third_party_attestation_provider.ipynb add proof-aware crypto curriculum notebooks 2026-07-03 14:42:59 +02:00
06_merkle_transparency_logs.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
07_agent_consequences.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
08_capstone_research_program.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
09_dogfood_verified_crypto.ipynb Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00
README.md Curriculum: the ratchet rule, the four-tier reality, and lecture 9 (dogfood) 2026-07-06 10:18:06 +02:00

PACTA Curriculum Notebooks

This directory contains a zero-to-hero teaching sequence for proof-aware cryptographic tooling.

Start with 00_course_map.ipynb, then proceed in order. The notebooks are intentionally output-free in git. Run them from the repository root or from this directory; each notebook locates the repo root and imports pacta from src/.

The course teaches:

  • theorem-boundary thinking,
  • claim cards and residual risk,
  • Lean replay and axiom audit concepts,
  • proof hygiene,
  • third-party proof-check provider trust,
  • RFC 9162-style Merkle transparency logs,
  • receipt-gated agent consequences (including the R4 wallet gate, now reachable),
  • split-view defense: STH pinning, consistency enforcement, freshness, monitoring,
  • dogfood verified cryptography and the honest hybrid post-quantum posture,
  • research roadmaps from R4 evidence toward R5 assurance.

This curriculum is not financial advice, not a trading bot, and not a wallet-building guide. It is a training path for engineers and researchers who need to evaluate formal-verification-enhanced cryptographic tooling without overclaiming.