docs,config: aggiorna AGENTS.md, config.example, HOST-SETUP.md, checklist faseA e fix vari orchestrator (workstation, build, job, wait, winrm, test)

docs/HOST-SETUP.md

@@ -38,6 +38,7 @@ F:\CI\
 ├── keys\
 │   ├── ci_linux            # chiave privata SSH per Linux VMs (ed25519, no passphrase)
 │   └── ci_linux.pub        # chiave pubblica corrispondente
+├── config.toml             # configurazione Python orchestrator (ssh_key_path, ecc.)
 ├── act_runner\
 │   ├── act_runner.exe      # binario runner Gitea
 │   ├── config.yaml         # config runner (path, label, capacity)
@@ -139,6 +140,22 @@ Allo `Setup-Host.ps1` exit 0:
    ```
    Poi **provisiona il template VM Linux** — vedi [LINUX-TEMPLATE-SETUP.md](LINUX-TEMPLATE-SETUP.md)
 
+6. **Crea `F:\CI\config.toml`** — necessario affinché il Python orchestrator trovi la chiave SSH e le altre impostazioni:
+   ```powershell
+   Copy-Item N:\Code\Workspace\Local-CI-CD-System\config.example.toml F:\CI\config.toml
+   ```
+   Il file `config.example.toml` contiene già i path corretti per Windows (`F:\CI\...`). Modificare solo se si usa un `$CIRoot` diverso da `F:\CI`.
+
+   Valori chiave configurati:
+
+   | Chiave               | Valore default          | Scopo                                        |
+   | -------------------- | ----------------------- | -------------------------------------------- |
+   | `ssh_key_path`       | `F:/CI/keys/ci_linux`   | Chiave privata per SSH verso Linux guest     |
+   | `guest_cred_target`  | `BuildVMGuest`          | Target Windows Credential Manager (WinRM)    |
+   | `backend.type`       | `workstation`           | Backend VMware (solo `workstation` in Phase A) |
+
+   Le variabili d'ambiente `CI_SSH_KEY_PATH`, `CI_VMRUN_PATH`, `CI_GUEST_CRED_TARGET` sovrascrivono i valori del TOML se presenti.
+
 6. **Registra chiave SSH con Gitea**:
    - Gitea UI → User Settings → SSH Keys → Add Key
    - Chiave pubblica: `%USERPROFILE%\.ssh\id_rsa.pub`
@@ -162,6 +179,7 @@ Allo `Setup-Host.ps1` exit 0:
 | Snapshot name (Windows)   | `BaseClean`                                                  |
 | Snapshot name (Linux)     | `BaseClean-Linux`                                            |
 | SSH key (Linux VMs)       | `F:\CI\keys\ci_linux` (privata), `F:\CI\keys\ci_linux.pub`   |
+| Orchestrator config TOML  | `F:\CI\config.toml` (copia di `config.example.toml`)         |
 | Clone base dir            | `F:\CI\BuildVMs\`                                            |
 | Artifact dir              | `F:\CI\Artifacts\`                                           |
 | Log dir                   | `F:\CI\Logs\` (retention: 30 giorni)                         |
@@ -196,3 +214,4 @@ Task schedulati (vedi `scripts/Register-CIScheduledTasks.ps1` per il bootstrap):
 | Service `act_runner` non parte  | Check `F:\CI\act_runner\logs\stderr.log`                         |
 | `New-StoredCredential` fail     | Verifica modulo CredentialManager importato + scope corretto     |
 | Job CI fallisce su `Test-WSMan` | TrustedHosts host non include subnet VM, AllowUnencrypted=$false |
+| `wait-ready` SSH: `No authentication methods available` | `F:\CI\config.toml` mancante o `ssh_key_path` non configurato. Crea il file (vedi step 6) oppure passa `--ssh-key-path F:\CI\keys\ci_linux` |