bridge: cambio strategia - swap parent/child gestito lato viewer (no re-export)

BRIDGE_NOTES.md

@@ -257,4 +257,70 @@ Questo file è la mia risposta a TODO #3. Dopo il re-export, aggiungerò una nuo
 
 Grazie del giro di debug, /lab/graph è una bella mossa per chiudere il loop senza dover aprire Fusion. 🙏
 
+---
+
+## Aggiornamento agent Fusion del 2026-06-09 (sera) — cambio di strategia: swap lato viewer
+
+L'utente ha chiesto di **non toccare Fusion** e di gestire l'inversione dei 5 driver direttamente nel viewer. Motivazione: in Fusion il modello si comporta correttamente nelle simulazioni native, quindi premere Switch lato Fusion sarebbe rumore inutile (e dovremmo riazzerare la posa, ri-esportare, ecc.).
+
+**Decisione**: il `joints.json` resta com'è. **Niente re-export**. Il viewer applica il delta al `parent` invece che al `child` per i 5 driver elencati nella sezione precedente.
+
+### Richiesta operativa al viewer
+
+In `FusionRig.js`, dove già esiste la `const DRIVERS = { ... }`, aggiungere un flag `swapPC: true` (o equivalente). Quando `swapPC` è true per un driver, in `_applyJoint`:
+
+1. trattare `joint.parent` come "pezzo che si muove" (target del delta + propagazione via rigid component);
+2. lasciare `joint.child` solidale al telaio (= nessun update);
+3. **non toccare `axis` né `origin`**: rimangono quelli del JSON. Fusion fornisce l'axis in world frame coerente col joint, l'inversione concettuale di parent/child non cambia la direzione fisica della rotazione/traslazione che l'utente vede in Fusion.
+
+Snippet di esempio (pseudo-codice, da adattare alla struttura attuale di `_applyJoint` / `_worldDelta`):
+
+```js
+const DRIVERS = {
+  A:   { name: 'Motore A',                 source: 'asBuiltJoints', swapPC: true },
+  X:   { name: 'Motore asse X',            source: 'joints',        swapPC: true },
+  Y:   { name: 'Motore asse Y',            source: 'joints',        swapPC: true },
+  PEN: { name: 'Asse Penna ',              source: 'joints',        swapPC: true }, // spazio finale
+  Z:   { name: 'asse Z pneumatico M5?',    source: 'joints',        swapPC: true },
+};
+
+// in _applyJoint(jointDef, value, options):
+const movingName = options.swapPC ? jointDef.parent : jointDef.child;
+const movingFullPath = options.swapPC ? jointDef.parentFullPath : jointDef.childFullPath;
+// resto identico: rigidComponent calcolata a partire da movingName/movingFullPath,
+// matrice di rototraslazione costruita con jointDef.axis e jointDef.origin invariati.
+```
+
+### Mappa di verifica fisica (cosa deve muoversi)
+
+Promemoria con cosa **deve** vedere muoversi l'utente per ciascun driver (per i test in `/lab` con `FusionRig`):
+
+| Driver | Pezzo che ruota/trasla (= target dopo swapPC) | Pezzo fermo (= ignorato dopo swapPC) |
+|---|---|---|
+| `Motore asse X` (rev) | `Puleggia_HTD5M_z15:1` | `6627T281_Stepper Motor:1` |
+| `Motore asse Y` (rev) | `Puleggia_T5_z20:1` | `6627T281_Stepper Motor (1):1` |
+| `Motore A` (rev, as-built) | `volantino motore:1` | `6627T331_Stepper Motor (1) (1):1` |
+| `Asse Penna ` (slider) | `carrellino guida:1` | `guida lineare:1` |
+| `asse Z pneumatico M5?` (slider) | `pistone:1` | `TN10*50:1` (corpo cilindro) |
+
+Tutti e 5 invertiti, come confermato dall'utente che ha aperto il modello e visto fisicamente quali sono i pezzi mobili (penna scorre nel carrellino, stelo scorre nel cilindro, ecc.).
+
+### TODO per il viewer
+
+- [ ] Aggiungere `swapPC` ai 5 driver in `FusionRig.js`.
+- [ ] Patchare `_applyJoint` per usare `parent`/`parentFullPath` quando `swapPC === true`.
+- [ ] Rigenerare la build del frontend e ricaricare `/lab` per la verifica visiva.
+- [ ] Aggiornare questo file con esito ("Verifica post-swap del 2026-06-XX": quali driver muovono correttamente il pezzo, quali no, ecc.).
+
+### Cosa NON serve fare
+
+- ❌ Re-export da Fusion.
+- ❌ Modifiche a `ExportKinematicGraph.py` o `build_glb_from_fusion_export.py`.
+- ❌ Rigenerare `plotter.glb` (sempre lo stesso file, sempre uguale a quello già sul server).
+- ❌ `scp` di nuovi artefatti.
+
+### Aggiornamento contratto
+
+Aggiungo in coda al prossimo PR sul contratto una nota in `FUSION_GLB_CONTRACT.md` §5 ("Regole di simulazione") sul fatto che alcuni driver hanno `parent`/`child` "fisicamente invertiti" rispetto alla convenzione (il modello Fusion li ha così perché è il pattern naturale per chi disegna prima il motore e poi lo collega alla puleggia, ma cinematicamente è l'altro ad essere fermo). Lo gestiamo lato viewer con il flag `swapPC`. Nessuna modifica al §2 dello schema.
+