Skip to content

Commit 2fda402

Browse files
committed
docs: session 73 — record sessions 70-72 in CHANGELOG + README
Mirrors the post-v0.8.3 audit-coverage extension into the canonical audit-pack documentation surface. CHANGELOG.md - New [Unreleased] subsection "Added — sessions 70-72" with per-session breakdowns: * Session 70 — audit-coverage runbook (new `docs/audit-coverage-runbook.md` for external review firms). * Session 71 — AUDIT.md release entries for v0.8.2 + v0.8.3, top-of-file pointer to the runbook. * Session 72 — `powers_of` 9th shared primitive + 5 proptest + first consumer migration in mosaic-hyperplonk::kzg. - Running tally: shared-primitive count now 9 (was 8 at v0.8.3 release). README.md - Property-test coverage row updated: * Session range bumped 36-66 → 36-72. * Lib test total 544 → 549 (+5 powers_of proptests in session 72). * "+147 proptest + shared-primitive coverage" → "+152 proptest + 9 shared primitives lifted" reflecting the running primitive count. - New row "Audit runbook" linking the session-70 runbook so reviewers find it from the README Status table directly, without going through AUDIT.md. No code changes — documentation pass only, completes the audit-pack mirror of sessions 70-72.
1 parent c30112c commit 2fda402

2 files changed

Lines changed: 42 additions & 1 deletion

File tree

CHANGELOG.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Added — sessions 70-72 (post-v0.8.3)
11+
12+
#### Session 70 — audit-coverage runbook
13+
`docs/audit-coverage-runbook.md` — entry point for an external
14+
review firm that wants to reproduce the Mosaic audit-coverage
15+
matrix locally and extend it with their own tests. Covers:
16+
- Coverage matrix at v0.8.3 with per-surface session ranges.
17+
- Local-reproduce recipes (property tests, BPF CU bench, host
18+
criterion bench, fuzz harnesses).
19+
- Extension recipes (add a new property test, fuzz harness,
20+
bench, shared primitive).
21+
- Three explicit caveats about what the coverage does NOT pin
22+
(real prover output, full Phase-3 cryptographic soundness,
23+
chunked dispatch integration).
24+
25+
#### Session 71 — AUDIT.md release entries
26+
Recorded both v0.8.2 and v0.8.3 release milestones in AUDIT.md
27+
with per-release scope, findings, and lib-test counts. Top-of-
28+
file pointer to `docs/audit-coverage-runbook.md` so external
29+
reviewers find the local-reproduce workflow immediately.
30+
31+
#### Session 72 — `powers_of` 9th shared primitive + first consumer
32+
`mosaic_zk_primitives::field::powers_of` lifts the multi-poly
33+
batched-opening ν-powers accumulator loop that surfaces in
34+
HyperPlonk session 3e, Halo2 session 17, and Nova Spartan
35+
session 22.
36+
37+
+5 proptest tests (mosaic-zk-primitives lib total 74 → 79):
38+
- prop_powers_of_length / prop_powers_of_first_is_one /
39+
prop_powers_of_recurrence / prop_powers_of_one_is_all_ones
40+
- prop_powers_of_matches_pow — closed-form cross-check against
41+
`fr_pow_u64`. The soundness invariant that justifies the lift.
42+
43+
First consumer migration: `mosaic_hyperplonk::kzg` replaces an
44+
inline 11-step accumulator loop with `powers_of(&nu, 12)`. 82
45+
hyperplonk lib tests still pass; byte-identical refactor.
46+
47+
After session 72 the shared-primitive count is **9 helpers** in
48+
mosaic-zk-primitives.
49+
1050
### Planned beyond v0.8.3-shared-primitive-lift
1151

1252
- Fixture-driven differential testing for the four Phase-3 bodies

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,8 @@ frozen CU budgets.
5656
| `mosaic-chunked` instruction handlers | ✅ Production ||
5757
| Reference Solana program | ✅ 319 KB SBF ELF (30.4% of 1 MB cap; 12 cryptographic gates wired) ||
5858
| Differential test harness (arkworks + snarkjs fixture) | ✅ Production (Groth16 + PLONK; Phase-3 extension tracked) ||
59-
| Property-test coverage (proptest, sessions 36-66) | ✅ 544 lib tests across 12 crates (+147 proptest + shared-primitive coverage in audit-coverage sweep) ||
59+
| Property-test coverage (proptest, sessions 36-72) | ✅ 549 lib tests across 12 crates (+152 proptest + 9 shared primitives lifted in audit-coverage sweep) ||
60+
| Audit runbook |[`docs/audit-coverage-runbook.md`](docs/audit-coverage-runbook.md) — reproduce + extend recipes for external review firms ||
6061
| BPF CU regression bench (`bpf-bench`) | ✅ 7 systems: Groth16 (single + batch), KZG-PLONK, HyperPlonk, Halo2, Nova, FRI-STARK ||
6162
| Host criterion bench (wall-clock baseline) | ✅ 5 systems: Groth16, HyperPlonk, Halo2, Nova, FRI-STARK ||
6263
| Fuzz harnesses (sessions 54-59) | ✅ 23 targets across all 6 production verifiers (5 proof-bytes + 5 vk-bytes + 5 public-inputs + 5 combined-slot for PLONK + 4 Phase-3, plus 3 original Groth16) ||

0 commit comments

Comments
 (0)