Skip to content

Commit 2947e2a

Browse files
committed
docs(memory): log the uninstall control-root leak lessons
Two lessons from this fix: an assertion relaxed to entrench a leak instead of flagging it (test ! -e receipt.json standing in for the whole control root, justified by citing the code's own "preserved if non-empty" comment as if it were the contract), and the counter-intuitive root cause - an artifact written outside the receipt registry is orphaned by construction, not a non-recursive rmdir.
1 parent c2636ca commit 2947e2a

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

‎MEMORY/LESSON.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@
1212
- [2026-09-01 21:31] Pendant toute la refonte j'ai validé l'installeur au `tsc` + `bun test` (182 pass) sans jamais l'exécuter — or aucun de ces 182 tests ne franchit `install.sh`. Le seul test concluant a été un run réel avec `HOME=/tmp/fake ./install.sh --skip-env` : il a prouvé en 30 s les 24 plugins déployés, le receipt à 24 hashes, `fuse-global.mdc` posée, le loader qui démarre depuis sa destination et les 21 wrappers exécutables. → Un installeur se vérifie **en l'installant dans un HOME jetable**, jamais par lecture : `HOME=$(mktemp -d) ./install.sh [--dry-run]` est sans risque pour l'environnement réel et c'est le seul contrôle qui couvre le chemin d'entrée shell, les chemins construits et les artefacts copiés. À faire AVANT d'annoncer quoi que ce soit, pas après. Corollaire : dans ce genre de sandbox, `~/Library/Caches/bun/**` apparaît et n'est PAS une écriture de l'installeur — compter sous `~/.cursor/` uniquement avant de crier au bug.
1313
- [2026-09-01 22:02] Deux agents ont diagnostiqué le crash de `install.sh --project` sur `$HOME` vierge ; l'un a livré ses suites VERTES en pré-créant `~/.cursor/plugins/local` dans son propre test, avec un commentaire honnête « bug de production, hors de mon lot ». Vert au tableau de bord, défaut intact en production, et le contournement aurait survécu au commit. → Un agent cantonné à un lot de fichiers ne peut PAS corriger un défaut situé hors de son lot : quand son rapport dit « contourné dans le test », c'est une dette à ENCAISSER immédiatement au niveau du lead — corriger la source, puis RETIRER le contournement et re-mesurer. Un test qui pré-crée l'état que la production est censée créer ne teste plus rien.
1414
- [2026-09-01 22:02] Assertion « l'install projet n'écrit rien dans `$HOME` » en échec permanent : le coupable n'était pas l'installeur mais le cache de transpilation de **Bun** (`$HOME/Library/Caches/bun/@t@/*.pile` sur macOS, `~/.cache/bun` sur Linux), semé au premier `bun` lancé avec un HOME neuf. → Après un passage à Bun, tout test qui compare un instantané de `$HOME` doit neutraliser le runtime lui-même (`BUN_RUNTIME_TRANSPILER_CACHE_PATH=0`, vérifié par contrôle négatif) plutôt que d'élargir l'assertion : scoper à `$HOME/.cursor` affaiblit la garantie, neutraliser la conserve. Vaut pour toute migration de runtime — le nouvel interpréteur écrit chez l'utilisateur, l'ancien non.
15+
- [2026-09-01 22:52] `--uninstall` laissait 64 fichiers (`~/.cursor/.fusengine-global/scripts/**`) chez l'utilisateur, définitivement. Pire que le défaut : l'assertion de test avait été **relâchée pour l'entériner** — `test ! -e .fusengine-global` remplacé par le seul `receipt.json`, avec un commentaire citant le `/* preserved if non-empty */` du code comme s'il s'agissait du contrat. Un commentaire de code décrit ce que le code FAIT, il ne prouve pas que ce soit voulu. → Quand une assertion doit être affaiblie pour passer, la question n'est jamais « comment la formuler » mais « quel défaut suis-je en train de graver dans le contrat » ; le relâchement se remonte au propriétaire, il ne se commente pas. Corollaire appliqué ici : avant de réécrire une assertion de suppression, **lui donner des dents** en vérifiant d'abord que la chose à supprimer EXISTE (`test -d .../scripts` avant l'uninstall) — sinon `test ! -e` passe sur un répertoire jamais peuplé et ne teste rien.
16+
- [2026-09-01 22:52] Cause réelle, contre-intuitive : le `rmdirSync` non récursif n'était pas le bug. `receipt.json` est le registre de propriété (hash par plugin, `ruleHash`) et `scripts/` n'y figurait pas — écrit par `setup-runner.ts`, un module que le moteur de déploiement n'importe jamais. Aucun chemin de code ne pouvait donc le réclamer. → Sur un installeur transactionnel, un artefact déployé par un module hors du registre est **orphelin par construction** : lister les écritures RÉELLES sous le répertoire de contrôle (`find` après un install en HOME jetable) plutôt que de se fier au registre, qui ne connaît que ce que son propre module a écrit.
1517
- [2026-09-01 22:35] Premier run du CI rouge sur UN test (`zsh loader`, absent d'`ubuntu-latest`). Le vrai défaut était ailleurs : le cas `fish` du même fichier portait déjà `test.skipIf(!Bun.which("fish"))` et se **skippait silencieusement** en CI depuis toujours — un CI vert me l'aurait caché indéfiniment. → Une garde `skipIf(outil absent)` protège la machine du contributeur mais **supprime la couverture là où elle compte le plus**. Sur le runner, installer l'outil (`sudo apt-get install -y zsh fish` ; ni l'un ni l'autre n'est préinstallé sur Ubuntu 24.04) ET faire échouer le job sur tout `skip` — sinon la garde transforme un test mort en test vert. Corollaire d'API : `bun:test` n'a pas de skip par ligne dans `test.each` (oven-sh/bun#4469 ouverte) — passer par une boucle `for`, et vérifier la garde par contrôle négatif (PATH privé du binaire → `1 skip / 0 fail`, contre `1 fail` avant).
1618
- [2026-09-01 22:35] J'ai annoncé au proprio « `runSetup` n'écrit que sous `~/.cursor` » pour justifier un correctif — le challenger a mesuré des `append` dans `~/.zshrc` / `~/.bashrc` et un `conf.d/*.fish` (`shell-installers.ts:25,60,68-74`). Le correctif restait bon, mon argument était faux, et il minimisait ce qu'il évitait. → Un périmètre d'écriture s'énonce après un `grep` des primitives d'écriture du module (`writeFileSync`, `appendFileSync`, `spawn`), jamais d'après le nom des chemins qu'on a en tête. Se tromper « en faveur » de sa propre conclusion reste une erreur — et ici la vérité renforçait le correctif.
1719
- [2026-09-01 22:02] `tests/marketplace-sparse-install.test.sh` compare le worktree à `git archive HEAD` : un `git rm` non commité le fait échouer en ENOENT sur un fichier que HEAD contient encore — échec purement mécanique, sans rapport avec le défaut testé. → Face à une suite qui se réfère à HEAD, tout changement d'INDEX non commité est un faux échec : trancher dans un `git clone . /tmp/x` où l'on peut commiter localement, jamais en commitant sur la branche pour « voir si ça passe ».

0 commit comments

Comments
 (0)