From afd392421409af43179188626c6b691f90ebd987 Mon Sep 17 00:00:00 2001
From: codex <codex@phimproject.com>
Date: Fri, 31 Jul 2026 15:51:52 +0300
Subject: [PATCH] docs: record pilot runner exit-code limitation

---
 docs/evidence/p-rec-annot-real-smoke.json | 3 ++-
 docs/pilots/p-rec-annot-real-smoke.md     | 2 ++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/evidence/p-rec-annot-real-smoke.json b/docs/evidence/p-rec-annot-real-smoke.json
index faa15a0..9b23ccb 100644
--- a/docs/evidence/p-rec-annot-real-smoke.json
+++ b/docs/evidence/p-rec-annot-real-smoke.json
@@ -8,6 +8,7 @@
   "startupNetloadCount": 1,
   "processStarted": true,
   "processId": 9960,
+  "launcherRunnerExitCode": null,
   "assemblyLoadedFromVersionedPackage": true,
   "commands": { "PHP_REC_ANNOT": true, "PXP-AAV": true, "PXP-OA": true },
   "drawingType": "NotOrtho",
@@ -24,5 +25,5 @@
   "previousPointerRestored": true,
   "legacyFilesModified": null,
   "productionDeployment": false,
-  "notes": ["Legacy local sentinel files were absent; hashes were not available.", "Session records terminal RolledBack state; historic intermediate states were not persisted."]
+  "notes": ["The background process exit code was not captured by the launcher host.", "Legacy local sentinel files were absent; hashes were not available.", "Session records terminal RolledBack state; historic intermediate states were not persisted."]
 }
diff --git a/docs/pilots/p-rec-annot-real-smoke.md b/docs/pilots/p-rec-annot-real-smoke.md
index af30ff0..66c3075 100644
--- a/docs/pilots/p-rec-annot-real-smoke.md
+++ b/docs/pilots/p-rec-annot-real-smoke.md
@@ -6,4 +6,6 @@ The manual runtime checkpoint confirmed `PHP_REC_ANNOT`, `PXP-AAV`, and `PXP-OA`
 
 After normal Plant shutdown, automatic rollback completed. No `acad.exe` remained. Startup scripts, staging contents, package pointers and activated version were absent; the activation snapshot was retained. The checked local legacy Application files were absent, so no before/after hashes were available.
 
+The background runner exit code was not captured by its `Start-Process` host. The persisted terminal state and the post-run `pilot status` command both reported `RolledBack`.
+
 Known plugin defect: `PLANT_PROJECT_DISPLAY_NAME_EMPTY`. Plant context was found but displayed an empty project name. Impact was diagnostic/UI-only for this Smoke pilot; write protection and command execution were unaffected. Follow-up: inspect `PlantApplication.CurrentProject` metadata and distinguish absent display name from false-positive project detection.