test: certify graph_engine gather/guard (C.6), find related BUG-006

Gather/padding/src_id<out_id guard certified via existing solid
pre-session tests (graph_engine_tb.v checks act_buffer contents via
hierarchical reference, not just final output; graph_engine_guard_tb.v
covers 4 adversarial cases incl. recovery).

BUG-006 (LOW severity): num_neurons_graph=0 shares BUG-005's exact
root cause (neuron_idx is a full 16-bit register, no guard), but
graph_engine's existing per-edge src_id<out_id guard incidentally
catches most garbage-data patterns fast (err at cycle 58 for a
non-trivial test pattern, vs. layer_sequencer's 21761-cycle full run
in BUG-005) -- not a designed protection for this case, so not closed
as a non-issue, but lower severity given the observed practical risk.
Not run to full 65536-iteration completion (impractical for this
campaign's time budget) -- limitation stated explicitly.

Full regression: 40/40 real tests pass, 1 new observational test.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013xXuuRUWZScuo1DeYJxs3v
This commit is contained in:
2026-09-04 14:52:52 +02:00
co-authored by Claude Sonnet 5
parent f81d7fa1b3
commit 6db44efcfd
21 changed files with 220 additions and 17 deletions
+19
View File
@@ -146,6 +146,25 @@ funzionale pratico), **INFO** (non un bug: gap di copertura, ambiguità document
BUG-003/004, qui il meccanismo esatto è stato individuato precisamente, non solo il
sintomo).
### BUG-006 (BASSA, stessa causa radice di BUG-005, protezione incidentale) — `num_neurons_graph=0` in `graph_engine.v`
- **Sintomo/causa radice**: identica struttura a BUG-005 — `neuron_idx`
(`rtl/graph_engine.v:159`) è un registro a 16 bit pieni, `num_neurons_graph=0` fa
avvolgere la condizione di terminazione a un valore (65535) che il contatore raggiunge
naturalmente. Nessun guard esplicito su `num_neurons_graph`.
- **Differenza da BUG-005**: `graph_engine` ha già un guard runtime per-edge
(`src_id>=out_id`/`out_id>=N_TOTAL``err`) che, **come effetto collaterale non
progettato per questo scopo**, cattura la maggior parte dei pattern di dati spazzatura
molto rapidamente — verificato con un pattern non banale: `err` a 58 cicli, non 65536.
`layer_sequencer.v` non ha alcuna protezione equivalente.
- **Evidenza**: `sim/graph_engine_bug006_zero_neurons_probe_tb.v` — finestra di 5000 cicli,
non fatto girare a completamento (limite dichiarato, vedi
`docs/validation/06-graph-engine.md` §6.2).
- **Impatto pratico**: basso ma non nullo — la protezione osservata è incidentale, non
garantita per ogni possibile contenuto PSRAM. Il buco strutturale è reale.
- **Stato**: **APERTO**, severità inferiore a BUG-005 per la protezione incidentale
osservata, non pienamente verificato su ogni pattern di dati possibile.
---
## Risolti