> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal :** un dépôt autonome qui porte le brouillon de réponse de LibreDesk (base de connaissances, import, instructions communes, instance de test, tâches VS Code) et l'image Ollama + bge-m3 qui remplace LM Studio en production, éprouvée sur le poste de Maxime.
**Architecture :** on reprend de `~/Support-AI` le paquet `base_connaissances/` et ses tests (Python, bibliothèque standard seulement), on reconstruit une instance de test allégée (LibreDesk v2.9.0 + Mailpit, scripts de préparation partageant une session commune), on ajoute un dossier `ollama/` (Dockerfile qui embarque le modèle, compose, script de vérification) et des tâches VS Code. LibreDesk recalcule lui-même les vecteurs quand la configuration des embeddings change : aucun code de recalcul.
**Tech Stack :** Python 3.12 (stdlib, `unittest`), Docker / Docker Compose, Ollama, LibreDesk v2.9.0, VS Code (tâches, sous WSL).
- **Rien ne part chez un client.** Aucun code n'écrit dans une conversation de la production. Seule la préparation de l'instance de test crée des conversations ; son SMTP est Mailpit.
- **On ne recode pas LibreDesk** : ni son code, ni son conteneur, ni son reverse proxy. Configuration et API seulement. **Jamais d'écriture SQL** dans une base de LibreDesk (lecture SQL autorisée sur l'instance de test seulement).
-`base_connaissances/` ne parle à LibreDesk que par `/api/v1/ai/snippets` et `/api/v1/ai/snippets/{id}` ; jamais `/messages`, `/conversations`, `DELETE`, `automations`, `assistants` (test `test_garde_fou_base`).
- L'import simule par défaut ; il n'écrit qu'avec `--ecrire`. Il ne supprime jamais un extrait.
- Le corpus ne contient ni noms de stations (`BREITHORN, CLARIDEN, FLORIDA, JUNGFRAU, LENZSPITZE, MICHIGAN, NADELHORN, NEBRASKA, NIEDERHORN, NORDEND, SNCF01, SUSTENHORN, WILDSTRUBEL, VERMONT, WEISSHORN, MISSISSIPPI`), ni commandes d'outils, ni seuils provisoires, ni prénom interne (`Marc`).
- Image de base Ollama à une **version figée** (`ollama/ollama:<x.y.z>`, la dernière stable au moment de la construction, notée dans le Dockerfile), jamais `latest`. Modèle gardé chargé : `OLLAMA_KEEP_ALIVE=-1`.
- Port d'Ollama publié sur `127.0.0.1` par défaut ; une autre adresse seulement par la variable `OLLAMA_BIND`. Jamais `0.0.0.0` par défaut.
- Complétion de l'instance de test (comme la production) : fournisseur `openai`, `base_url``https://api.anthropic.com/v1`, modèle `claude-sonnet-5-5`, `max_tokens` 4096, `reasoning_effort``medium`, instructions = `base_connaissances/instructions.md`.
- Secrets dans `.env` (racine) et `instance-de-test/.env`, hors de git. Ne jamais afficher une clé.
- Commandes `python3`, `git`, `docker` lancées sous WSL (Ubuntu), depuis `~/Support-LibreDesk`. Tests : `python3 -m unittest discover -s tests -v`.
- Code, documents et messages de commit en français. Commits terminés par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
- Support-AI n'est ni modifié ni supprimé : on y lit seulement.
- Toute modification de la production (serveur, LibreDesk) : présentée à Maxime, faite par lui ou avec son accord explicite, un geste à la fois. Aucune tâche de ce plan ne touche la production ; le registre Gitea n'est poussé qu'avec l'accord de Maxime (Task 3, dernière étape).
## Review Focus
1.**Ollama arrêté pendant le recalcul** (conteneur tombé juste après le changement de configuration) : LibreDesk doit retenter chaque minute et finir par recalculer les 118 extraits une fois Ollama revenu. → Task 4, étape « panne pendant le recalcul ».
2.**Serveur sans accès à Internet** : l'image doit servir bge-m3 sans rien télécharger. → Task 3, `verifier.py` sur un réseau Docker `--internal`.
3.**Une tâche VS Code d'import lancée contre la production par erreur** : aucune tâche n'écrit en production sans adresse tapée et confirmation. → Task 5, `test_ecriture_production_demande_confirmation`.
4.**Le port d'Ollama ouvert sur toutes les interfaces** par un oubli de variable : le compose publie sur `127.0.0.1` par défaut. → Task 3, `test_port_lie_a_localhost_par_defaut`.
5.**`preparer.py` relancé sur une instance déjà préparée** : il doit s'arrêter avec un message clair, sans créer de doublon (boîte, agent). → Task 2, étape de vérification « deuxième passage ».
- [ ]**Step 1 : Copier les fichiers** listés ci-dessus et écrire `.gitignore` (contenu de la Structure).
- [ ]**Step 2 : Ajouter `"WEISSHORN", "MISSISSIPPI"` à `STATIONS` dans `tests/test_corpus.py`.**
- [ ]**Step 3 : Retirer des docstrings et commentaires toute mention de `support_diagnostic`, de « spec §… » de Support-AI ou de `generer.py`** (`grep -rn "support_diagnostic\|generer\|spec §" base_connaissances tests` ne rend rien ; remplacer « spec §x » par une référence au design de ce dépôt ou la supprimer).
- [ ]**Step 4 : Lancer les tests.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous OK (les 4 fichiers), 118 extraits lus par `test_corpus_present`.
- [ ]**Step 5 : Simulation d'import à vide.** Run : `LIBREDESK_URL=http://127.0.0.1:1 LIBREDESK_ADMIN_KEY=x LIBREDESK_ADMIN_SECRET=x python3 -m base_connaissances.importer`. Expected : échec réseau clair (aucune instance), pas d'écriture.
- [ ]**Step 6 : Commit** — `git add .gitignore base_connaissances tests docs/superpowers && git commit -m "Base de connaissances reprise de Support-AI : corpus, import, instructions, tests"` (le design et ce plan entrent dans ce premier commit).
-`session.py` : `B = "http://127.0.0.1:9100"` ; `connexion(mot_de_passe: str) -> None` ; `req(methode: str, chemin: str, corps: dict | None = None, timeout: int = 60) -> object` (rend `data`, `sys.exit` avec code et 300 premiers caractères en cas d'erreur HTTP, **n'affiche jamais le corps envoyé**). Reprend la connexion de `~/Support-AI/instance-de-test/preparer_ia.py` (cookie `Secure` désactivé, `csrf_token` fixé à `t0k3n`, en-tête `X-CSRFTOKEN`).
-`demarrer.sh <mot de passe System>` : si `config.toml` manque, le télécharge depuis `https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml` et y met une `encryption_key` aléatoire (commande de `~/Support-AI/docs/verifications.md`, « L'instance de test ») ; puis `LIBREDESK_SYSTEM_USER_PASSWORD=… docker compose -p ldtest up -d` ; attend que `GET /api/v1/settings/general` réponde (60 s max).
-`preparer.py <mot de passe System>` : crée la boîte e-mail « Test » (SMTP = Mailpit, configuration de `~/Support-AI/instance-de-test/preparer.py`), l'agent « Import base » (rôle `Admin`, e-mail `import@example.com`) et sa clé ; **écrase**`instance-de-test/.env` avec `LIBREDESK_URL=http://127.0.0.1:9100`, `LIBREDESK_ADMIN_KEY=…`, `LIBREDESK_ADMIN_SECRET=…`. Si une boîte « Test » existe déjà : `sys.exit("instance déjà préparée : docker compose -p ldtest down -v, puis demarrer.sh")` avant toute écriture. Ne crée ni étiquette, ni rôle « Agent IA », ni conversation.
-`configurer_ia.py <mot de passe System> <url des embeddings> <modèle> [clé]` (clé par défaut `ollama`) : `ANTHROPIC_API_KEY` lu dans l'environnement ; pour `completion` puis `embedding`, `POST /api/v1/ai/config/{type}/test` puis `PUT /api/v1/ai/config/{type}` (valeurs des Global Constraints) ; affiche `"{type} : test réussi, configuration enregistrée"`. Rejouable : c'est lui qui fait passer l'instance de LM Studio à Ollama.
-`essayer_brouillons.py [mot de passe System]` : repris de Support-AI, connexion par `session.py`, rapport dans `cases/essai-brouillons-<date>.md`.
-`empreintes.sh` : `docker exec ldtest_db psql -U libredesk -d libredesk -At -c "SELECT id, embedded_fingerprint FROM ai_knowledge_base WHERE enabled ORDER BY id"` — lecture seule.
- [ ]**Step 2 : Monter une instance neuve.** Run : `docker compose -p ldtest down -v; bash instance-de-test/demarrer.sh 'TestAdmin-2026!'`. Expected : l'interface répond sur `http://127.0.0.1:9100`.
- [ ]**Step 3 : Préparer.** Run : `python3 -I instance-de-test/preparer.py 'TestAdmin-2026!'`. Expected : `instance-de-test/.env` contient les trois variables.
- [ ]**Step 4 : Deuxième passage (Review Focus 5).** Run : la même commande. Expected : sortie « instance déjà préparée … », code ≠ 0, toujours une seule boîte « Test » (`GET /api/v1/inboxes`).
- [ ]**Step 5 : Configurer l'IA sur LM Studio, l'état de la production** (relais `socat` de `~/Support-AI/docs/verifications.md`, LM Studio lancé par Maxime). Run : `eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 -I instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://$GW:11234/v1 text-embedding-bge-m3 lm-studio`. Expected : deux « test réussi ». Si LM Studio n'est pas disponible : sauter cette étape et le noter ; la Task 4 passe alors d'une première URL d'Ollama à une seconde (l'alias réseau), ce qui prouve le même déclenchement.
- [ ]**Step 6 : Importer.** Run : `set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire`. Expected : `créés 118`. Rejoué : `inchangés 118`.
- [ ]**Step 7 : Commit** — `git add instance-de-test && git commit -m "Instance de test allégée : démarrage, préparation, configuration de l'IA, essai des brouillons"`.
- Image `exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:<version d'Ollama>-567m`, construite par `docker compose -f ollama/compose.yml build`. Le Dockerfile télécharge `bge-m3:567m` pendant la construction (serveur lancé en arrière-plan le temps d'un `ollama pull`) ; `ENV OLLAMA_HOST=0.0.0.0:11434 OLLAMA_KEEP_ALIVE=-1` ; `HEALTHCHECK` par `ollama list`.
-`compose.yml` : service `ollama`, `container_name: ollama-bge-m3`, `restart: unless-stopped`, port `"${OLLAMA_BIND:-127.0.0.1}:11434:11434"`.
-`compose.reseau.yml` (surcharge) : rattache le service au réseau externe `${RESEAU_LIBREDESK}` avec l'alias `ollama`. Localement `RESEAU_LIBREDESK=ldtest_libredesk` ; sur le serveur, le réseau de LibreDesk s'il est dans Docker.
-`ollama/verifier.py <base_url>` (stdlib) : `GET <base_url>/models` doit lister `bge-m3:567m` ; `POST <base_url>/embeddings {"model":"bge-m3:567m","input":"Quelle est l'autonomie de la batterie ?"}` doit rendre un vecteur de 1024 nombres. Affiche `OK bge-m3:567m, 1024 dimensions` et sort en 0 ; sinon un message qui dit ce qui manque, sort en 1. Fonction testable : `verifier(base_url: str) -> str` (lève `RuntimeError` avec le message).
- [ ]**Step 1 : Écrire les tests** dans `tests/test_ollama.py` (faux serveur `http.server` local, comme `faux_libredesk.py`) :
```python
deftest_modele_et_dimension_ok(self):# /models liste bge-m3:567m, /embeddings rend 1024 floats
self.assertIn("1024",verifier(self.url))
deftest_modele_absent(self):# /models sans bge-m3:567m
- [ ]**Step 7 : Lancement et redémarrage.** Run : `docker compose -f ollama/compose.yml up -d && sleep 10 && python3 ollama/verifier.py http://127.0.0.1:11434/v1`, puis `docker kill ollama-bge-m3 && sleep 15 && docker ps --filter name=ollama-bge-m3`. Expected : `OK …`, puis le conteneur est de nouveau `Up` (après un `docker kill`, `unless-stopped` relance). Puis `sudo service docker restart` (ou redémarrage de Docker Desktop) : conteneur relancé.
- [ ]**Step 9 (avec l'accord explicite de Maxime seulement) : pousser l'image au registre Gitea.** Maxime crée un jeton Gitea (portée `write:package`) et fait `docker login exchange.sensima.ch`. Run : `docker push exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:<tag>`. Expected : l'image apparaît dans Packages du compte. En cas de refus (taille, `413`) : noter l'erreur dans `docs/verifications.md` ; le repli `docker save | ssh … docker load` sera décrit dans `docs/production.md` (Task 6).
- [ ]**Step 1 : Relever les empreintes « avant ».** Run : `bash instance-de-test/empreintes.sh > /tmp/avant.txt && wc -l /tmp/avant.txt`. Expected : 118 lignes, aucune empreinte vide.
- [ ]**Step 2 : Lancer Ollama sur le réseau de l'instance.** Run : `RESEAU_LIBREDESK=ldtest_libredesk docker compose -f ollama/compose.yml -f ollama/compose.reseau.yml up -d && docker run --rm --network ldtest_libredesk -v "$PWD/ollama:/o:ro" python:3.12-alpine python /o/verifier.py http://ollama:11434/v1`. Expected : `OK bge-m3:567m, 1024 dimensions`.
- [ ]**Step 3 : Basculer l'instance sur Ollama.** Run : `python3 -I instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m`. Expected : deux « test réussi ».
- [ ]**Step 4 : Le recalcul.** Run : `docker logs ldtest_app 2>&1 | grep -E "embedding provider changed|reconciled embeddings"` puis `bash instance-de-test/empreintes.sh > /tmp/apres.txt`. Expected : « embedding provider changed, reindexing knowledge base » puis « reconciled embeddings … reindexed 118 » ; 118 lignes dans `apres.txt`, aucune empreinte vide, **aucune identique** à `avant.txt` (`comm -12 <(sort /tmp/avant.txt) <(sort /tmp/apres.txt)` vide).
- [ ]**Step 5 : Panne pendant le recalcul (Review Focus 1).** Repasser sur LM Studio (ou sur une URL d'Ollama différente, p. ex. `http://ollama-bge-m3:11434/v1`), puis : `docker stop ollama-bge-m3`, rebasculer sur `http://ollama:11434/v1`**sans** test (enregistrement direct : `configurer_ia.py` échouerait au test ; faire l'enregistrement par l'interface Admin → IA → Providers), attendre 2 min, `docker start ollama-bge-m3`, attendre 2 min. Expected : erreurs d'embedding dans les journaux pendant la panne, puis « reconciled embeddings … reindexed 118 » après le redémarrage ; empreintes toutes non vides.
- [ ]**Step 6 : L'essai des brouillons.** Run : `python3 -I instance-de-test/essayer_brouillons.py`. Expected : 5 brouillons `completed`, « Mailpit inchangé pendant la génération ». Comparer au rapport LM Studio (`~/Support-AI/cases/essai-brouillons-2026-11-11.md`) : appuyés sur la base de la même façon ; le faire juger par Maxime.
- [ ]**Step 7 : Consigner** dans `docs/verifications.md` : date, version d'Ollama, taille de l'image, extraits des journaux, résultat des empreintes, de la panne et de l'essai.
- [ ]**Step 8 : Commit** — `git add docs/verifications.md && git commit -m "Simulation : passage de LM Studio à Ollama, recalcul automatique vérifié"`.
- [ ]**Step 4 : Tests verts.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous PASS.
- [ ]**Step 5 : Essai dans VS Code** (WSL) : lancer `Tests`, puis `Import : simulation (instance de test)`. Expected : mêmes sorties qu'en ligne de commande ; `Import : ÉCRIRE (PRODUCTION)` avec `non` → « annulé ».
- [ ]**Step 6 : Commit** — `git add .vscode tests/test_taches.py && git commit -m "Tâches VS Code : tests, instance de test, Ollama, import (production avec confirmation)"`.
---
### Task 6 : la documentation et les gestes de production
**Files:**
- Create: `README.md` (remplace le fichier vide), `docs/production.md`
- Modify: `docs/verifications.md`
- [ ]**Step 1 : `README.md`** : à quoi sert le dépôt (le brouillon dans LibreDesk, Ollama) ; que Support-AI est archivé et n'est plus suivi ; « rien ne part chez un client » ; installation (`python3`, Docker, aucun paquet Python) ; les tâches VS Code ; les commandes équivalentes ; retoucher la base (corpus → import simulation → `--ecrire`) ; liens vers le design, `docs/production.md`, `docs/verifications.md`.
- [ ]**Step 2 : `docs/production.md`**, repris de `~/Support-AI/docs/production-libredesk-natif.md` : les gestes déjà faits restent cochés avec leur date (0 bis, 0 ter, 1 provisoire, 2, 3, 4, 5) ; le point 0 (relecture des 9 extraits « Savoir métier AIMsight ») reste ouvert ; le point « Plus tard : le programme Python sur Gitea » est retiré (abandonné le 2026-11-12). Puis la partie **Ollama**, étapes 3.1 à 3.7 du design (§6), chacune avec sa commande et sa vérification :
- 3.1 état des lieux, sans rien changer : `docker version`, `id` (groupe `docker`), `uname -m` (doit être `x86_64`), `docker ps --format '{{.Names}} {{.Image}} {{.Networks}}'`, `ip -brief addr`, `free -h`, `df -h /var/lib/docker`, `ss -ltnp`, la configuration de Caddy en lecture. **Point d'arrêt** et ses cas (design §5).
- 3.2 récupérer l'image (`docker pull` depuis le registre, ou repli `docker save … | ssh … docker load`), copier `ollama/compose.yml` (et `compose.reseau.yml` si LibreDesk est dans Docker), lancer avec `OLLAMA_BIND=<adresse interne>` ou `RESEAU_LIBREDESK=<réseau de LibreDesk>`.
- 3.3 `verifier.py` depuis l'hôte ou le réseau de LibreDesk ; depuis un téléphone en 4G, `http://46.14.212.91:11434` ne répond pas.
- 3.4 Admin → IA → Providers, Embeddings : valeurs des Global Constraints ; bouton de test, puis enregistrement.
- 3.6 « Generate reply » sur une vraie conversation, ne rien envoyer.
- 3.7 LM Studio n'est plus nécessaire.
- Retour en arrière ; « Au quotidien » (Ollama arrêté = brouillons sans base, sans alerte : `docker ps`, `verifier.py`) ; faiblesses connues reprises (sans celles qui concernent `generer.py` ou le programme Python).
- [ ]**Step 3 : `docs/verifications.md`** : y ajouter, au-dessus de la simulation (Task 4), les constats LibreDesk encore utiles repris de Support-AI (authentification, routes des extraits et de la configuration IA, `generate-reply` sans notes privées, assistants exclus, recalcul automatique avec les références au code v2.9.0, l'essai LM Studio du 2026-11-11 et le réseau WSL `mirrored`).
- [ ]**Step 4 : Relecture croisée.** Run : `grep -rn "support_diagnostic\|Agent IA\|tri:diagnostic\|generer.py" README.md docs/production.md docs/verifications.md`. Expected : aucune occurrence, sauf la mention « abandonné » dans `production.md`.
- [ ]**Step 5 : Tests.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous PASS.
- [ ]**Step 6 : Commit** — `git add README.md docs && git commit -m "Documentation : README, gestes de production avec Ollama, constats"`.