Skip to content

Commit 314aa4e

Browse files
Dmitrii Vasilevclaude
andcommitted
chore(trinity): point current-issue.md to W403 issue #1307 and add decomposed plan
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 5113f91 commit 314aa4e

2 files changed

Lines changed: 73 additions & 16 deletions

File tree

.claude/plans/wave-loop-403.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Wave Loop 403 — Decomposed Plan
2+
3+
**Issue:** #1307
4+
**Branch:** `trinity-rust-rings`
5+
**Goal:** Close the deferred physical CCLK measurement (Variant A), extend the
6+
Lean 4 formal model to bitstream configuration (Variant B), or add a
7+
physical-cable smoke path (Variant C).
8+
9+
---
10+
11+
## 1. Weak points
12+
13+
### 1.1 Physical blocker (Variant A)
14+
- **CCLK measurement still requires bench access.** Without a logic analyser /
15+
oscilloscope on pin P12, Variant A cannot close.
16+
17+
### 1.2 Formal gap (Variant B)
18+
- `TernaryFPGABoot.lean` models STAT decoding and the cold-POR decision tree,
19+
but does not yet link the canonical bitstream configuration (`IDCODE`,
20+
`SPI_BUSWIDTH`, `STARTUPCLK`, `OSCFSEL`) to the boot predicates.
21+
22+
### 1.3 Smoke-gate physical gap (Variant C)
23+
- `tri fpga smoke-gate` is board-less. A cable-connected SRAM load would catch
24+
bitstream regressions that static assertions miss, but it needs hardware.
25+
26+
---
27+
28+
## 2. Competitor scan
29+
30+
Same as W402: Sparkle HDL, Verilean, Sail, Kami, FIRRTL/Chisel, Clash,
31+
Bluespec. The closest formal-HDL threat remains **Verilean / Lean 4 HDL**;
32+
Variant B directly counters it by extending the t27 proof lattice into the
33+
FPGA-boot domain.
34+
35+
---
36+
37+
## 3. Cooperation variants
38+
39+
See `docs/reports/FPGA_LOOP_COOPERATION_2026-07-05.md` for the full three
40+
variants and acceptance criteria.
41+
42+
| Variant | Hardware needed | Primary deliverable |
43+
|---------|-----------------|---------------------|
44+
| A | logic analyser / oscilloscope | Measured CCLK frequency in `fpga/HARDWARE_SSOT.md` |
45+
| B | none | Lean 4 bitstream-config lemmas |
46+
| C | Digilent cable + board | Optional `--require-cable` SRAM smoke load |
47+
48+
---
49+
50+
## 4. Recommended next action
51+
52+
If hardware is available, execute **Variant A**. Otherwise execute **Variant
53+
B**.
54+
55+
---
56+
57+
*φ² + φ⁻² = 3 | TRINITY*

.trinity/current-issue.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,38 @@
1-
# Wave Loop 402 — FPGA: close AC5 physical CCLK measurement + follow-up hardening
1+
# Wave Loop 403 — FPGA: close physical CCLK measurement or extend formal/physical smoke coverage
22

3-
**Issue:** #1305
3+
**Issue:** #1307
44
**Branch:** `trinity-rust-rings`
5-
**Milestone:** W401 hardened the cold-POR protocol and added board-less CI guards.
6-
Now close the deferred AC5 (physical CCLK measurement on P12) or pursue one of the
7-
alternate cooperation variants.
5+
**Milestone:** W402 formalized the cold-POR decision tree in Lean 4. W403 should
6+
close the remaining physical AC or extend formal/physical smoke coverage.
87

98
---
109

1110
## Goal
1211

1312
1. Capture the actual CCLK frequency on pin P12 and record it in
1413
`fpga/HARDWARE_SSOT.md` (Variant A — default if hardware is available).
15-
2. OR encode the cold-POR / CCLK decision tree in Lean 4 (Variant B — no
16-
hardware required).
14+
2. OR extend the Lean 4 model with bitstream-configuration predicates
15+
(`STARTUPCLK`, `OSCFSEL`, `SPI_BUSWIDTH`) and link them to the decision trees
16+
(Variant B — no hardware required).
1717
3. OR extend `tri fpga smoke-gate` to optionally load the GF16 matrix into SRAM
1818
and assert `DONE=HIGH` when a cable is present (Variant C — stretch).
19-
4. Update close-out reports and open W403 cooperation variants.
19+
4. Update close-out reports and open W404 cooperation variants.
2020

2121
---
2222

2323
## Decomposed plan
2424

25-
See `.claude/plans/wave-loop-402.md` for the full work breakdown.
25+
See `.claude/plans/wave-loop-403.md` for the full work breakdown.
2626

2727
| Step | File(s) | Deliverable |
2828
|------|---------|-------------|
29-
| 1 | `.claude/plans/wave-loop-402.md` | Decomposed plan + weak-point + competitor scan |
29+
| 1 | `.claude/plans/wave-loop-403.md` | Decomposed plan + weak-point + competitor scan |
3030
| 2 | `fpga/HARDWARE_SSOT.md` (Variant A) | Measured CCLK frequency/duty cycle on P12 |
31-
| 3 | `proofs/lean4/Trinity/TernaryFPGABoot.lean` (Variant B) | Formal STAT/decision-tree lemmas |
31+
| 3 | `proofs/lean4/Trinity/TernaryFPGABoot.lean` (Variant B) | Bitstream-config lemmas |
3232
| 4 | `cli/tri/src/fpga.rs` (Variant C) | Optional cable-connected SRAM smoke load |
33-
| 5 | `docs/reports/*` | W402 report, evidence, W403 cooperation |
34-
| 6 | `.trinity/experience.md` | W402 learnings |
35-
| 7 | git/PR | squash-merge to `trinity-rust-rings`, close #1305, open #W403 |
33+
| 5 | `docs/reports/*` | W403 report, evidence, W404 cooperation |
34+
| 6 | `.trinity/experience.md` | W403 learnings |
35+
| 7 | git/PR | squash-merge to `trinity-rust-rings`, close #1307, open #W404 |
3636

3737
---
3838

@@ -41,12 +41,12 @@ See `.claude/plans/wave-loop-402.md` for the full work breakdown.
4141
- [ ] AC-A1 (Variant A): a physical CCLK trace is captured and the dominant
4242
frequency is recorded.
4343
- [ ] AC-A2 (Variant A): `fpga/HARDWARE_SSOT.md` §3.5 contains the measured value.
44-
- [ ] AC-B1 (Variant B): new Lean 4 module builds and links `STAT` decoding to the
44+
- [ ] AC-B1 (Variant B): new Lean 4 lemmas link canonical bitstream config to the
4545
documented decision trees.
4646
- [ ] AC-C1 (Variant C): `tri fpga smoke-gate --require-cable` reaches
4747
`DONE=HIGH` on the bench.
4848
- [ ] AC-D1: `./scripts/tri test` passes.
49-
- [ ] AC-D2: W402 report + evidence + W403 cooperation variants committed.
49+
- [ ] AC-D2: W403 report + evidence + W404 cooperation variants committed.
5050

5151
---
5252

0 commit comments

Comments
 (0)