Skip to content

Commit 37e8496

Browse files
Dmitrii Vasilevclaude
andcommitted
docs(tri): W425 issue + NOW setup (#1374, wave-loop-425)
- Update .trinity/current-issue.md with W425 goal, plan, acceptance criteria - Prepend W424 close-out and W425 setup to docs/NOW.md Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 5d55d4c commit 37e8496

3 files changed

Lines changed: 94 additions & 47 deletions

File tree

.trinity/current-issue.md

Lines changed: 42 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
# Wave Loop 426 — FPGA boot-evidence next variant (physical CCLK / XADC readout / formal fallback)
1+
# Wave Loop 425 — FPGA board evidence / relay gate / PVT falsification
22

3-
**Issue:** #1376
4-
**Branch:** `wave-loop-426`
5-
**Milestone:** Continue the FPGA boot-evidence line from Wave Loop 425.
3+
**Issue:** #1374
4+
**Branch:** `wave-loop-425`
5+
**Milestone:** Continue the FPGA boot-evidence line from W424.
66

77
---
88

99
## Goal
1010

11-
Wave 425 hardened the FPGA CLI and formal model while the bench was blocked
12-
(P12 unwired, no relay gate). Wave 426 executes the first available variant from
13-
`docs/reports/FPGA_LOOP_COOPERATION_W426_2026-07-05.md`.
11+
Wave 424 hardened the FPGA tooling around instrument import, PVT context, CSV
12+
voltage units, and non-blocking auto-continue. Wave 425 must produce real
13+
boot evidence by executing the first available variant:
1414

1515
1. **Variant A (preferred when bench becomes available):**
1616
- Confirm P12 is wired to a logic-analyzer channel.
@@ -21,35 +21,35 @@ Wave 425 hardened the FPGA CLI and formal model while the bench was blocked
2121
- Document frequencies/duty cycles and PVT context in
2222
`fpga/HARDWARE_SSOT.md` §3.6.21.
2323

24-
2. **Variant B (if board is reachable or external capture available):**
25-
- Add real XADC readout to `tri fpga boot-log` / `cclk-sweep` / `cold-por`
26-
over the existing JTAG path, so JSON `xadc` has `source: "xadc"` and live
27-
temp/vccint/vccaux values.
28-
- Alternatively, import at least one external CSV/VCD capture end-to-end.
29-
- Run dry-run cold-POR boot-log for OSCFSEL 6/7 variants with
30-
`--pvt-context`.
31-
- Document the recipe in `fpga/HARDWARE_SSOT.md` §3.6.21.
32-
33-
3. **Variant C (fallback if bench still blocked):**
34-
- Extend the PVT formal model with an operating-rectangle grid theorem or a
35-
measured-CCLK link theorem for every OSCFSEL 0–7 variant.
36-
- Land one safe gen-verilog #1245 sub-fix from the remaining 7 failures, if
37-
narrow and regression-free; otherwise explicitly defer.
38-
- Harden `tri fpga` JSON schema / decision-tree output.
39-
- Refresh `docs/reports/T27_VS_FORMAL_HDL_2026.md` if new 2026 competitor
40-
developments surface.
24+
2. **Variant B (if hardware is partial):**
25+
- Import a real or representative CCLK/CSV/VCD capture with
26+
`--pvt-worstcase` validation.
27+
- Run `tri fpga boot-log --dry-run` or `cclk-sweep --dry-run` for OSCFSEL
28+
6/7 with `--pvt-context`.
29+
- Document the import recipe and PVT-context checklist in
30+
`fpga/HARDWARE_SSOT.md`.
31+
32+
3. **Variant C (fallback if bench still fully blocked):**
33+
- Implement or defer real XADC readout in `tri fpga boot-log` / `cclk-sweep`.
34+
- Land the next safe gen-verilog #1245 sub-fix if one is narrow and
35+
regression-free; otherwise explicitly defer.
36+
- Harden boot-log / cold-por / cclk-sweep JSON schema and update the
37+
competitor snapshot.
4138

4239
---
4340

4441
## Decomposed plan
4542

43+
See `docs/reports/FPGA_LOOP_COOPERATION_W425_2026-07-05.md`.
44+
4645
| Step | File(s) | Deliverable |
4746
|------|---------|-------------|
48-
| 1 | `cli/tri/src/fpga.rs` or `proofs/lean4/Trinity/TernaryFPGABoot.lean` or `bootstrap/src/compiler.rs` | Variant A capture import, B XADC readout/capture import, or C formal/gen-verilog hardening |
49-
| 2 | `fpga/HARDWARE_SSOT.md` / `docs/reports` | Updated protocol or comparison note |
50-
| 3 | `docs/reports/*` | W426 report, evidence, W427 cooperation |
51-
| 4 | `.trinity/experience.md` | W426 learnings |
52-
| 5 | git/PR | squash-merge to `master`, close issue, open #? for W427 |
47+
| 1 | `cli/tri/src/fpga.rs` | Variant A capture import, B dry-run + PVT context, or C XADC/schema hardening |
48+
| 2 | `proofs/lean4/Trinity/TernaryFPGABoot.lean` | New measured theorems or PVT helpers |
49+
| 3 | `fpga/HARDWARE_SSOT.md` | Updated capture / import / PVT protocol |
50+
| 4 | `docs/reports/*` | W425 report, evidence, W426 cooperation |
51+
| 5 | `.trinity/experience.md` | W425 learnings |
52+
| 6 | git/PR | squash-merge to `master`, close #1374, open next issue for W426 |
5353

5454
---
5555

@@ -62,15 +62,14 @@ Wave 425 hardened the FPGA CLI and formal model while the bench was blocked
6262
- [ ] AC-A4: Cold-POR SPI flash boot for OSCFSEL 6/7 is documented with STAT reads.
6363

6464
### Bundle B
65-
- [ ] AC-B1: Real XADC readout lands, OR at least one external capture is imported end-to-end.
66-
- [ ] AC-B2: The import/readout path exposes no unhandled unit, voltage-unit, or noise cases.
67-
- [ ] AC-B3: Dry-run boot-log artifacts exist for OSCFSEL 6/7 and include PVT/XADC context.
65+
- [ ] AC-B1: At least one real or representative capture is imported end-to-end and passes `--validate`.
66+
- [ ] AC-B2: Dry-run boot-log / cclk-sweep artifacts include PVT/XADC context fields for OSCFSEL 6/7.
67+
- [ ] AC-B3: `fpga/HARDWARE_SSOT.md` documents the import recipe and PVT-context checklist.
6868

6969
### Bundle C
70-
- [ ] AC-C1: At least one new PVT grid / envelope / OSCFSEL-link theorem is added and builds.
71-
- [ ] AC-C2: One safe gen-verilog #1245 sub-fix lands without increasing the 7-failure yosys smoke count, or is explicitly deferred if unsafe.
72-
- [ ] AC-C3: `boot-log` / `cold-por` / `cclk-sweep` tooling is measurably more robust or better documented.
73-
- [ ] AC-C4: Competitor snapshot is updated if any new 2026 developments are found.
70+
- [ ] AC-C1: Real XADC readout is implemented or a documented deferral explains why it remains placeholder.
71+
- [ ] AC-C2: `gen-verilog-yosys-smoke` failure count does not increase; any deferred #1245 sub-fix is explained.
72+
- [ ] AC-C3: Boot-log / cold-por / cclk-sweep JSON schema is measurably more robust or better documented.
7473

7574
### Invariant checks
7675
- [ ] `./scripts/tri test` parse/typecheck/gen/seal-verify phases pass.
@@ -82,19 +81,18 @@ Wave 425 hardened the FPGA CLI and formal model while the bench was blocked
8281
## PR
8382

8483
- Target: `master`
85-
- PR: to open after work
86-
- Body: `Closes #1376`
87-
- Report: `docs/reports/WAVE_LOOP_426_REPORT.md`
88-
- Evidence: `docs/reports/FPGA_LOOP_EVIDENCE_W426_YYYY-MM-DD.md`
89-
- Cooperation W427: `docs/reports/FPGA_LOOP_COOPERATION_W427_YYYY-MM-DD.md`
84+
- Body: `Closes #1374`
85+
- Report: `docs/reports/WAVE_LOOP_425_REPORT.md`
86+
- Evidence: `docs/reports/FPGA_LOOP_EVIDENCE_W425_2026-07-05.md`
87+
- Cooperation W426: `docs/reports/FPGA_LOOP_COOPERATION_W426_2026-07-05.md`
9088

9189
---
9290

9391
## Default variant
9492

95-
Execute **Variant A** if P12 is wired and the analyzer is ready.
96-
Otherwise execute **Variant B** if the board is reachable for real XADC readout
97-
or an external capture is available.
93+
Execute **Variant A** if P12 is wired and a logic analyzer is available.
94+
Otherwise try **Variant B** if an external capture or partial board access is
95+
available.
9896
Otherwise fall back to **Variant C**.
9997

10098
---

.trinity/current_task/activity.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1464,7 +1464,7 @@
14641464
- **Commit:** docs(w420): set W420 issue number to #1361 and record W419 PR #1360 (Closes #1357, Refs #1361)
14651465
- **Files:** .trinity/current-issue.md,.trinity/experience.md,cli/tri/src/fpga.rs,docs/NOW.md,docs/reports/FPGA_LOOP_COOPERATION_W420_2026-07-05.md,docs/reports/FPGA_LOOP_EVIDENCE_W419_2026-07-05.md,docs/reports/WAVE_LOOP_419_REPORT.md,fpga/HARDWARE_SSOT.md,proofs/lean4/Trinity/TernaryFPGABoot.lean
14661466

1467-
## 2026-07-05T07:39:42Z — wave-loop-426
1468-
- **Commit:** feat(igla): Wave Loop 425 — OSCFSEL 0–7 sweep, PVT worst-case envelope theorems (closes #1374)
1469-
- **Files:** .trinity/current-issue.md
1467+
## 2026-07-05T07:14:41Z — wave-loop-425
1468+
- **Commit:** chore(tri): update session log and commit count after W424 close-out
1469+
- **Files:** .trinity/current-issue.md,docs/NOW.md
14701470

docs/NOW.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,52 @@
1+
# NOW — Wave Loop 424 close-out / Wave Loop 425 setup (2026-07-01)
2+
3+
Last updated: 2026-07-01
4+
5+
## Wave Loop 424 — FPGA tooling hardening, PVT context, CSV voltage units, non-blocking continue (Closes #1371)
6+
7+
- Branch: `wave-loop-424`
8+
- Issue: #1371
9+
- PR: #1373
10+
- Report: `docs/reports/WAVE_LOOP_424_REPORT.md`
11+
- Evidence: `docs/reports/FPGA_LOOP_EVIDENCE_W424_2026-07-05.md`
12+
- Cooperation W425: `docs/reports/FPGA_LOOP_COOPERATION_W425_2026-07-05.md`
13+
14+
### What landed
15+
- `cli/tri/src/fpga.rs`
16+
- Non-blocking `wait_for_continue` helper for `--wait-seconds` in `boot-log`,
17+
`cold-por`, and `cclk-sweep`.
18+
- CSV voltage-unit scaling (`--csv-voltage-unit v|mv`) before threshold detection.
19+
- Optional `--pvt-context` JSON embedding in boot-log / cold-por / cclk-sweep.
20+
- Default CCLK sweep expanded to OSCFSEL 0..7.
21+
- `proofs/lean4/Trinity/TernaryFPGABoot.lean`
22+
- `ProcessCorner` decidability, equality, `severity`, and
23+
`worse_than_iff_severity_le` helpers.
24+
- `docs/reports/T27_VS_FORMAL_HDL_2026.md`
25+
- Refreshed date and W423–W424 boot-evidence differentiator note.
26+
27+
### Not done (blocked on hardware)
28+
- Real P12 CCLK capture for `OSCFSEL=6/7` — P12 unwired, DLC10 cable missing.
29+
- Real relay cold-POR gate — no relay board / USB power switch available.
30+
- Real XADC readout in CLI still deferred (`xadc.source: "not_read"`).
31+
32+
### Verification
33+
- `cargo test -p tri`: **PASS** (93 tests).
34+
- `lake build Trinity.TernaryFPGABoot`: **PASS**.
35+
- `./scripts/tri test`: parse/typecheck/gen/seal phases **PASS**; 7 pre-existing
36+
`gen-verilog-yosys-smoke` failures tied to #1245 (`let` destructuring, tuple
37+
returns, ROM arrays, CORDIC) and not introduced by this wave.
38+
39+
## Wave Loop 425 — FPGA board evidence / relay gate / PVT falsification (#1374)
40+
41+
- Branch: `wave-loop-425`
42+
- Issue: #1374
43+
- Goal: execute Variant A (real P12 CCLK capture + cold-POR flash sweep), Variant
44+
B (partial-bench import + PVT context dry-run), or Variant C (XADC/schema
45+
hardening + safe gen-verilog sub-fix / deferral).
46+
- Cooperation variants: `docs/reports/FPGA_LOOP_COOPERATION_W425_2026-07-05.md`.
47+
48+
---
49+
150
# NOW — Wave Loop 419 close-out / Wave Loop 420 setup (2026-07-05)
251

352
Last updated: 2026-07-05

0 commit comments

Comments
 (0)