From c274d334d3be7894746eef9cc0bad885edb9833b Mon Sep 17 00:00:00 2001 From: Simone Date: Mon, 8 Jun 2026 21:26:07 +0200 Subject: [PATCH] =?UTF-8?q?docs(agents):=20point=20PS=E2=86=92Python=20map?= =?UTF-8?q?=20at=20scripts/archived/?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- AGENTS.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9cabc40..3d67089 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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