docs(agents): point PS→Python map at scripts/archived/

The shim mapping table now notes the .ps1 live in scripts/archived/
(frozen, lint-exempt, no live caller) and gains the Phase C host tools
(bench/smoke/validate host/creds set). Fix the "stays in PowerShell"
list: drop Test-CapacityBurnIn (archived) and the non-existent
Measure-CIBenchmark; keep retention/backup/template/e2e/Windows-side.
This commit is contained in:
2026-06-08 21:26:07 +02:00
parent 7f615333b6
commit c274d334d3
+17 -8
View File
@@ -84,9 +84,12 @@ per compatibilita' con Task Scheduler e caller esterni.
- Encoding stdio sempre UTF-8: i moduli Python lo assumono e
`runner/config.yaml` esporta `PYTHONIOENCODING=utf-8` ad act_runner.
**Mappatura script PowerShell → sotto-comando Python** (Fase A2/A3/A4):
**Mappatura script PowerShell → sotto-comando Python** (Fase A2/A3/A4 + C).
I `.ps1` qui sotto sono **archiviati** in `scripts/archived/` (congelati, esenti
da lint, nessun caller vivo — l'action Gitea chiama Python direttamente). Non
chiamarli né estenderli; vedi `scripts/archived/README.md`.
| PowerShell legacy (shim) | Python sub-command |
| PowerShell archiviato | Python sub-command |
| ----------------------------------- | ------------------------------------------ |
| `Wait-VMReady.ps1` | `python -m ci_orchestrator wait-ready` |
| `New-BuildVM.ps1` | `python -m ci_orchestrator vm new` |
@@ -98,13 +101,19 @@ per compatibilita' con Task Scheduler e caller esterni.
| `Watch-RunnerHealth.ps1` | `python -m ci_orchestrator monitor runner` |
| `Get-CIJobSummary.ps1` | `python -m ci_orchestrator report job` |
| `Invoke-CIJob.ps1` | `python -m ci_orchestrator job` |
| `Start-BurnInTest.ps1` / `-Linux` | `python -m ci_orchestrator bench run` |
| `Test-CapacityBurnIn.ps1` | `python -m ci_orchestrator bench run` |
| `Test-Smoke.ps1` | `python -m ci_orchestrator smoke run` |
| `Validate-HostState.ps1` | `python -m ci_orchestrator validate host` |
| `Set-CIGuestCredential.ps1` | `python -m ci_orchestrator creds set` |
Restano in PowerShell (girano sull'host fuori dal flusso CI o nel guest):
`Setup-Host.ps1`, `Register-CIScheduledTasks.ps1`, `Backup-CITemplate.ps1`,
`Invoke-RetentionPolicy.ps1`, `Measure-CIBenchmark.ps1`,
`Test-CapacityBurnIn.ps1`, tutti i `template/Deploy-*.ps1`,
`template/Prepare-*.ps1`, `template/Install-CIToolchain-*.ps1` e i
`tests/Test-*.ps1` di smoke locale.
Restano in PowerShell (girano sull'host Windows fuori dal flusso CI o nel guest,
non ancora portati): `Setup-Host.ps1`, `scripts/Register-CIScheduledTasks.ps1`,
`scripts/Backup-CITemplate.ps1`, `scripts/Invoke-RetentionPolicy.ps1`,
`scripts/Set-TemplateSharedFolders.ps1`, `scripts/Test-CIGuestWinRM.ps1`, gli
harness e2e `scripts/Test-E2E-Section3.3.ps1` / `Test-Ns7zipBuild-Linux.ps1` /
`Test-NsinnounpBuild*.ps1`, tutti i `template/Deploy-*.ps1`,
`template/Prepare-*.ps1`, `template/Install-CIToolchain-*.ps1`.
**Test gate**: coverage totale ≥90% (alzato in A5, poi a 90%). Nuovi moduli devono
includere unit test con mock; gli errori frequenti di questa stessa