# syncro_multi_agente

Pipeline **Autodesk Fusion 360 → Blender → GLB** + contratto di interfaccia per il viewer **Three.js**.

Repository condiviso tra:
- **Agent A** (questo repo) — produce `plotter.glb` e `joints.json` da Fusion.
- **Agent B** (altro workspace) — consuma il GLB in un viewer web con `FusionRig.js`.

## Contenuto

| File | Scopo |
|---|---|
| [FUSION_GLB_CONTRACT.md](FUSION_GLB_CONTRACT.md) | **Fonte di verità.** Schema `joints.json`, convenzioni `userData` nel GLB, unità di misura, lista dei 5 driver pilotati. |
| [BRIDGE_NOTES.md](BRIDGE_NOTES.md) | Risposte ai problemi `[OPEN]` del contratto e stato della checklist. |
| [THREEJS_USAGE.md](THREEJS_USAGE.md) | Snippet copia-incolla per caricare e pilotare `plotter.glb` in Three.js. |
| [AGENTS.md](AGENTS.md) | Regole operative per Copilot Chat (entrambi gli agent). |
| `ExportKinematicGraph.py` | Add-in/script Fusion 360: produce `hierarchy.json` + `joints.json` + meshes OBJ. |
| `build_glb_from_fusion_export.py` | Script Blender: importa la mesh, ricostruisce la gerarchia con `userData`, embedda il manifest, esporta `plotter.glb`. |
| `build_glb.bat` | Wrapper Windows per lanciare Blender headless. |

## Quick start (lato produttore)

1. In **Fusion 360**: `Utilities → ADD-INS → Scripts → ExportKinematicGraph → Run`.
2. Lo script chiede una cartella di output (default: `C:\Users\croce\OneDrive\Desktop\export`).
3. Da PowerShell:
   ```powershell
   cd "C:\Users\croce\OneDrive\Desktop\export grafo fusion"
   .\build_glb.bat "C:\Users\croce\OneDrive\Desktop\export"
   ```
4. Output: `plotter.glb` pronto per il viewer.

## Lato consumatore (Three.js)

Vedi [THREEJS_USAGE.md](THREEJS_USAGE.md) e [FUSION_GLB_CONTRACT.md §3-§5](FUSION_GLB_CONTRACT.md).

## Convenzioni di lavoro

Vedi [AGENTS.md](AGENTS.md) — in particolare le regole su branch, commit message e cosa NON committare.

## Stato attuale

Vedi sezione "Stato attuale dell'export" in [BRIDGE_NOTES.md](BRIDGE_NOTES.md).