proof-aware-crypto-tooling-.../notebooks
mrwulf aff1c32fc5 notebooks + README: wire the teaching stack to the newest edge
Audit: are the zero-to-hero notebooks current and macOS-runnable, and
does the README present the new teaching surfaces and CLI well?

Verified by execution: all 14 notebooks run headlessly cell-by-cell,
offline, pure-Python (zero shell magics), degrading gracefully where
Lean/built binaries are absent — before AND after these edits. That is
also the macOS answer: no GNU userland is touched by any cell.

Gaps found and closed:
- README's notebook list stopped at 10; notebook 11 (the customer's
  eye view) now listed.
- No notebook knew the cockpit era existed. Three pointer cells added:
  00 (course map: the three-track teaching stack — notebooks = code
  track, lab manual = role track, guide = reference), 10 (see the
  wallet you built through the cockpit; --demo and --wallet forms),
  11 (the Inspect instrument is this notebook's recomputation, живой).
- README: cockpit command block now shows --demo, --wallet, --port/
  --host variants; curriculum section names the teaching stack and the
  notebooks' offline/runnable contract.

Suite 144 green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 18:15:57 +02:00
..
00_course_map.ipynb notebooks + README: wire the teaching stack to the newest edge 2026-07-21 18:15:57 +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
04_proof_hygiene_and_boundaries.ipynb
05_third_party_attestation_provider.ipynb REAL EVIDENCE: guarded replay of all four repos, attested, logged, dogfooded 2026-07-06 14:54:48 +02:00
06_merkle_transparency_logs.ipynb Mirrored lectures 6a/6b: the authenticated structure, drawn and domain-separated 2026-07-06 15:26:32 +02:00
06a_provider_build_the_log.ipynb Mirrored lectures 6a/6b: the authenticated structure, drawn and domain-separated 2026-07-06 15:26:32 +02:00
06b_agent_verify_inclusion.ipynb publish assets: sync the fail-open time bomb; llms/course/test docs refreshed (doc audit 2026-07-19) 2026-07-19 13:10:55 +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 Lecture 9: dogfood now bidirectional (sign mode + provider self-inclusion); notebooks README course list updated 2026-07-06 15:27:16 +02:00
10_verified_custody_wallet.ipynb notebooks + README: wire the teaching stack to the newest edge 2026-07-21 18:15:57 +02:00
11_the_customers_eye_view.ipynb notebooks + README: wire the teaching stack to the newest edge 2026-07-21 18:15:57 +02:00
README.md curriculum: lecture 11 - the customer's-eye view (requirements card, wish-meets-supply, grow-the-supply) 2026-07-07 22:16:05 +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,
  • the mirrored provider/agent domain split (6a: one provider builds and dogfood-signs the log; 6b: many agents verify inclusion in ~25 lines, no Lean),
  • 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,
  • the verified-custody wallet (warden): a quorum boundary of four proven forks, the signing firewall, and the agent-native MCP surface,
  • the customer's-eye view: the allowed-axioms list as a requirements card you own and could write yourself, and what happens when your card is stricter than the supply,
  • 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.