From aa5748bcce9b769cc9873bef1334e651aee4755c Mon Sep 17 00:00:00 2001
From: Nicolas Cantu <nicolas.cantu@pm.me>
Date: Mon, 23 Mar 2026 16:17:19 +0100
Subject: [PATCH] docs(lecoffreio): add fixKnowledge import-v1 ssh_run quoting
 (force-add)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

**Etat initial**
- Fiche sous projects/lecoffreio/docs/ ignorée par .gitignore ; commit précédent n’incluait que le commentaire change-to-all-branches.sh.

**Motivation du changement**
- Versionner la fiche fixKnowledge pour traçabilité.

**Resolution**
- git add -f projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md

**Root cause**
- Pattern **/docs/** dans .gitignore ia_dev.

**Fonctionnalités impactées**
- Aucune.

**Code modifié**
- Aucun.

**Documentation modifiée**
- projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md

**Configurations modifiées**
- Aucune.

**Fichiers dans déploy modifiés**
- Aucun.

**Fichiers dans logs impactés**
- Aucun.

**Bases de données et autres sources modifiées**
- Aucune.

**Modifications hors projet**
- Aucune.

**fichiers dans .cursor/ modifiés**
- Aucun.

**fichiers dans .secrets/ modifiés**
- Aucun.

**nouvelle sous sous version dans VERSION**
- N/A

**CHANGELOG.md mise à jour (oui/non)**
- non
---
 .../import-v1-ssh-run-quoting-env-full.md     | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md

diff --git a/projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md b/projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md
new file mode 100644
index 0000000..ae21a2d
--- /dev/null
+++ b/projects/lecoffreio/docs/fixKnowledge/import-v1-ssh-run-quoting-env-full.md
@@ -0,0 +1,33 @@
+# import-v1.sh — erreur de syntaxe bash sur la vérification env-full
+
+## Problème
+
+Lors d’un déploiement test (`change-to-all-branches.sh` → `deploy.sh` → `import-v1.sh`), le script s’arrêtait avec :
+
+`import-v1.sh: ligne 591: erreur de syntaxe près du symbole inattendu « ( »`
+
+## Impacts
+
+- Échec de la phase post–Phase 1 (vérification `env-full-*-for-bdd-injection.txt` sur la cible).
+- Pas d’exécution de `setSettings` ni de la suite import V1 pour ce run.
+
+## Cause
+
+Guillemets doubles autour de `$APP_ROOT` et du message `[ERROR]` à l’intérieur de l’argument passé à `ssh_run`, alors que cet argument est lui-même délimité par des guillemets doubles : le shell local interprétait une fin de chaîne prématurée avant `(` dans le texte d’erreur.
+
+## Root cause
+
+Quoting incorrect pour une commande distante `bash -lc '...'` imbriquée dans une chaîne double-quotée locale ; incohérence avec les autres appels `ssh_run` du fichier (qui utilisent `\"` pour les chemins).
+
+## Corrections
+
+- Remplacement des segments `"$APP_ROOT/...` par `\"$APP_ROOT/...\"` et échappement du message `echo` dans `deploy/scripts_v2/import-v1.sh` (bloc vérification env-full).
+
+## Modalités de déploiement
+
+- Commit + push sur `test` du dépôt applicatif, puis `change-to-all-branches` et/ou `deploy-by-script-to.sh lecoffreio pprod|prod` selon le workflow habituel.
+
+## Modalités d’analyse
+
+- Reproduire en local sur le dépôt LeCoffre : `bash -n deploy/scripts_v2/import-v1.sh` (doit passer).
+- En cas d’échec distant distinct : vérifier présence réelle de `deploy/env-full-<env>-for-bdd-injection.txt` ou `.secrets/<env>/env-full-<env>-for-bdd-injection.txt` sur la cible et les logs `logs/deploy_*.log`.