From 9972010230bc3892390306129e996a15722ab1a6 Mon Sep 17 00:00:00 2001 From: Simone Date: Sun, 17 May 2026 12:08:57 +0200 Subject: [PATCH] docs(phaseA): production venv install must be non-editable act_runner runs as LocalSystem; `pip install -e .` writes a .pth to a path LocalSystem can't resolve (N: user drive or a transient F:\CI\RunnerWork job dir), causing "No module named ci_orchestrator". Prescribe `pip install .` and warn about the cd target. Co-Authored-By: Claude Opus 4.7 --- plans/PhaseA-user-checklist.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/plans/PhaseA-user-checklist.md b/plans/PhaseA-user-checklist.md index 588e81d..f82fc6b 100644 --- a/plans/PhaseA-user-checklist.md +++ b/plans/PhaseA-user-checklist.md @@ -27,12 +27,24 @@ Il codice nuovo va installato nel venv che act_runner usa git pull ``` -- [x] Installare il package in editable nel venv di produzione: +- [x] Installare il package nel venv di produzione (**non editable**): ```powershell - & 'F:\CI\python\venv\Scripts\python.exe' -m pip install -e . + & 'F:\CI\python\venv\Scripts\python.exe' -m pip install . ``` + > ⚠️ **Non usare `pip install -e .` su questo host.** act_runner gira + > come `LocalSystem`. Un install editable scrive un `.pth` verso la + > sorgente; se il `cd` era in una dir di lavoro di act_runner + > (`F:\CI\RunnerWork\\hostexecutor`, transitoria) o sul drive + > utente `N:` (non risolto da LocalSystem), il runner fallisce con + > `No module named ci_orchestrator`. L'install regolare copia il + > package in `site-packages` su `F:` (accessibile a LocalSystem). + > Conseguenza: ogni modifica al codice richiede di ri-eseguire + > `pip install .` — è uno step di deploy. Assicurarsi che il `cd` del + > passo precedente punti alla copia git reale del repo, non a una dir + > sotto `F:\CI\RunnerWork`. + - [x] Smoke check rapido che la CLI risponda: ```powershell