Hooks Claude Code¶
Référence des hooks shell utilisés par Kirexo pour encadrer les actions de Claude Code et de ses sous-agents. Cette page documente uniquement le quoi — événement, entrée, sortie, effets de bord. Pour le pourquoi (raison d'être de la délégation, biais d'auto-confirmation, mécanique du quota de fichiers PHP), voir la page d'explication Workflow des agents Claude.
.claude/settings.json enregistre six scripts sur quatre événements :
| Script | Événement | Matcher | Bloquant |
|---|---|---|---|
guard-delegation.sh |
PreToolUse |
Write\|Edit |
Oui (exit 2) |
guard-rm.sh |
PreToolUse |
Bash |
Oui (permissionDecision: deny) |
count-prod-php.sh |
PostToolUse |
Write\|Edit |
Non |
track-checklist.sh |
PostToolUse |
Bash\|Write\|Edit |
Non |
stop-checklist.sh |
Stop |
(aucun) | Oui, dans un seul cas (decision: block, plafonné) |
session-dashboard.sh |
SessionStart |
(aucun) | Indirectement (continue: false) |
Tous sont écrits en Bash et dépendent de jq pour lire le JSON reçu sur stdin — jq est un prérequis du projet.
Quatre d'entre eux sont détaillés ci-dessous. Les deux autres tiennent en une ligne : guard-rm.sh n'autorise un rm que si toutes ses cibles sont strictement sous var/claude/ (chemins résolus via realpath, à partir du toplevel git), refuse les commandes composées ou dynamiques et les chemins contenant .., et reste neutre partout ailleurs — le flux de permission normal tranche alors ; track-checklist.sh trace dans <dossier de session>/checklist-state.txt les étapes de la checklist de clôture réellement exécutées et invalide cet état dès qu'un fichier PHP ou d'infrastructure est modifié, stop-checklist.sh le relisant pour n'afficher que ce qui manque.
Le dossier d'état de session¶
Les hooks qui conservent un état entre deux appels n'écrivent pas à la racine de var/claude/, mais dans un dossier namespacé par worktree :
<worktree> vaut l'identifiant du worktree courant, ou main pour le dépôt principal — le même nom que celui sous lequel le proxy le route, cf. Le dépôt principal est un worktree nommé main. La résolution est portée par une source de vérité unique, .claude/hooks/lib/session-dir.sh, sourcée par les hooks concernés :
| Étape | Comportement |
|---|---|
| 1 | WT si elle est publiée dans l'environnement — elle l'est par compose.worktree.yaml, donc côté conteneur seulement. |
| 2 | Sinon, la valeur lue dans .env.worktree à la racine du projet. C'est le repli des sessions ouvertes depuis l'hôte, où WT n'existe pas. |
| 3 | Sinon, ou si la valeur contient autre chose que [a-z0-9_-], main. |
La validation de l'étape 3 n'est pas défensive par principe : la valeur devient un composant de chemin, et un WT=../autre s'échapperait de .session/ pour aller écrire dans l'espace d'un voisin.
Pourquoi ce namespace existe
var/claude est commun au dépôt principal et à tous les worktrees (un lien vers le dossier du dépôt principal, monté au même chemin absolu). Le cadrage des étapes gagne à être partagé ; l'état d'une session en cours, non : deux agents travaillant en parallèle s'écraseraient checklist, quota PHP, compteur de blocage et verdict de revue. Le raisonnement est dans Pourquoi l'agent pousse lui-même, et ce qui le retient.
Les fichiers concernés : checklist-state.txt, prod-php-files.txt, reviewer-verdict.txt, .stop-block-count, et les checkpoints test-writer-last.md / doc-writer-last.md. Dans le reste de cette page, « dossier de session » désigne ce chemin.
guard-delegation.sh¶
| Champ | Valeur |
|---|---|
| Fichier source | .claude/hooks/guard-delegation.sh |
| Événement Claude Code | PreToolUse |
| Matcher | Write\|Edit |
| Bloquant | Oui (exit 2) |
Rôle¶
Contrôle qui peut écrire où, avant que l'écriture n'ait lieu. Empêche le main Claude de créer des fichiers dans tests/ ou docs/, et limite chaque sous-agent à son périmètre.
Entrée¶
Le hook lit sur stdin un JSON dont les champs suivants sont consommés :
| Champ JSON | Usage |
|---|---|
tool_input.file_path |
Chemin absolu du fichier ciblé. Si vide ou hors de $PWD, le hook laisse passer. |
agent_type (ou subagent_type en repli) |
Identifie l'appelant : vide pour le main Claude, sinon reviewer, test-writer, doc-writer. |
tool_name |
Nom de l'outil (Write ou Edit). Utilisé pour le main Claude : Edit est autorisé dans tests/ et docs/ (pour les renommages et corrections de références), Write est refusé. |
Règles appliquées¶
agent_type |
Périmètre autorisé |
|---|---|
reviewer |
Uniquement var/claude/ (en pratique <dossier de session>/reviewer-verdict.txt), via la règle transverse ci-dessous. Tout autre chemin est refusé. |
test-writer |
Uniquement les chemins contenant /tests/ ou /src/DataFixtures/. |
doc-writer |
Uniquement les chemins contenant /docs/, plus le fichier mkdocs.yml à la racine. |
| (vide — main Claude) | Refus de Write dans tests/ ou docs/. Edit reste autorisé partout. |
| Autre sous-agent non répertorié | Fail-closed sur tests/ et docs/ ; tout le reste passe. |
Une règle transverse précède ce classement : toute écriture sous var/claude/ est autorisée, quel que soit l'appelant — c'est là que les sous-agents posent leur checkpoint de reprise et leur verdict. La comparaison porte sur les chemins résolus (realpath), parce que var/claude est un lien : une écriture peut arriver aussi bien par <worktree>/var/claude/… que par la cible du lien, et le verdict ne doit pas dépendre de la forme du chemin.
Sortie¶
exit 0— l'écriture est autorisée.exit 2— l'écriture est refusée. Un message explicatif est écrit surstderr(chemin refusé, raison du refus, action attendue).exit 2également sijqn'est pas installé.
Un avertissement est aussi écrit sur stderr si Claude Code n'est pas lancé depuis la racine du projet (absence de CLAUDE.md ou projet.md dans le CWD), sans pour autant bloquer.
Effets de bord¶
Aucun. Le hook lit, classe et tranche — il n'écrit rien sur disque.
count-prod-php.sh¶
| Champ | Valeur |
|---|---|
| Fichier source | .claude/hooks/count-prod-php.sh |
| Événement Claude Code | PostToolUse |
| Matcher | Write\|Edit |
| Bloquant | Non (informatif via systemMessage) |
Rôle¶
Comptabilise les fichiers PHP de production écrits par le main Claude pour faire respecter le plafond de 13 fichiers entre deux délégations au test-writer. Émet un avertissement préventif à 11/13 et un message d'arrêt à 13/13.
Définition d'un « fichier PHP de production »¶
Le hook ne comptabilise un chemin que si tous les critères suivants sont réunis :
- l'extension est
.php(ou le nom estbin/console) ; - le chemin est dans
src/,public/oubin/; - le chemin n'est pas dans
tests/nisrc/DataFixtures/; - le fichier n'est pas un fichier de tooling :
castor.php,.php-cs-fixer.dist.php,.php-cs-fixer.php,config/*,importmap.php.
Entrée¶
| Champ JSON | Usage |
|---|---|
tool_name |
Doit être Write ou Edit ; sinon le hook sort sans rien faire. |
agent_type (ou subagent_type) |
Discrimine main Claude (vide) et sous-agents (test-writer, reviewer). |
tool_input.file_path |
Chemin du fichier écrit. Filtré selon les critères ci-dessus. |
tool_input.content |
Lu uniquement quand agent_type=reviewer et que le chemin est un reviewer-verdict.txt (dans le dossier de session, ou à la racine de var/claude/ — l'ancien emplacement reste accepté) : la première ligne, débarrassée des espaces, est comparée à APPROVED. |
Règles de reset¶
Le compteur est remis à zéro dans deux cas :
agent_type=test-writeret chemin danstests/ousrc/DataFixtures/. Toute écriture (WriteouEdit) du test-writer dans cette zone reset le compteur, parce qu'elle marque une vague de tests produits — qu'il s'agisse d'un nouveau fichier ou de l'ajout d'assertions sur un test existant.agent_type=revieweret cheminreviewer-verdict.txt(dossier de session ou ancien emplacement à la racine devar/claude/) et contenu valantAPPROVED. Un verdictBLOCKEDne reset pas.
Les écritures effectuées par un sous-agent sont ignorées pour le comptage (seul le main Claude alimente le compteur).
Sortie¶
exit 0dans tous les cas — le hook n'est jamais bloquant.- À 11/13 ou plus : un objet JSON est écrit sur
stdoutavec un champsystemMessageinformatif (« 11/13 fichiers modifiés, pense à déléguer au test-writer dans les 2 prochains »). - À 13/13 ou plus : objet JSON avec
systemMessagecontenant la liste des fichiers suivis et un rappel de la checklist, plushookSpecificOutput.additionalContextinjecté dans le contexte de la session. - Lors d'un reset après verdict
APPROVED:systemMessageconfirme la réinitialisation du quota.
Effets de bord¶
| Fichier | Comportement |
|---|---|
<dossier de session>/prod-php-files.txt |
Liste dédupliquée des chemins PHP de production. Ajout en append (grep -Fxq empêche les doublons). Supprimé lors d'un reset. |
var/claude/.session/<worktree>/ |
Créé en mkdir -p au premier appel. Si la création ou l'écriture échoue (CWD hors racine, FS read-only, droits cassés), le hook fail-close proprement : avertissement sur stderr, exit 0, sans tracer. |
stop-checklist.sh¶
| Champ | Valeur |
|---|---|
| Fichier source | .claude/hooks/stop-checklist.sh (dispatcher) |
| Libs | .claude/hooks/lib/checklist-common.sh, checklist-container.sh, checklist-host.sh, stop-decision.lib.sh |
| Événement Claude Code | Stop |
| Matcher | (aucun — Stop n'a pas de matcher) |
| Bloquant | Oui, pour un seul jeton de décision (block:app-regression), et plafonné par BLOCK_CAP. Tout le reste est continue: true. |
Rôle¶
Rappelle la checklist de clôture (commandes Castor + délégations obligatoires) à chaque fin de tour, sonde la vitalité des services quand la session tourne dans le conteneur, et tranche entre trois régimes : blocage, avertissement, silence.
Le fichier lui-même n'est qu'un dispatcher : il détecte le contexte, source le sous-script correspondant, applique le plafond anti-boucle et émet le JSON. La logique de checklist vit dans le sous-script de contexte ; la décision vit dans une fonction pure à part.
Deux contextes, deux checklists¶
detect_context() (lib/checklist-common.sh) rend container si KIREXO_INSIDE_CONTAINER=1 ou si /.dockerenv existe, host sinon. Les mêmes critères que is_inside_container() côté PHP.
| Contexte | Sous-script | Checklist | Sonde de vitalité |
|---|---|---|---|
container |
lib/checklist-container.sh |
composer:validate, cs:fix, phpstan, lint, ts:check, doctrine:schema:validate, test:unit, test:bash, test:e2e — agrégat castor all |
Oui |
host |
lib/checklist-host.sh |
castor lint:shell, docker compose config -q — agrégat castor host:check |
Non (la stack peut légitimement être arrêtée) |
Le contexte host cible les fichiers que seul l'hôte modifie (Dockerfile, compose*.yaml, infra/**/*.sh, .claude/hooks/*.sh) et n'est jamais bloquant.
Entrée¶
Le hook lit stdin puis le jette (cat >/dev/null) — aucun champ du JSON n'est consommé. Tout est déduit de l'état du dépôt, des fichiers d'état et de deux sondes réseau :
| Source | Usage |
|---|---|
<dossier de session>/checklist-state.txt |
Étapes de la checklist réellement lancées dans la session (écrites par track-checklist.sh). Alimente TODO_COUNT. |
<dossier de session>/prod-php-files.txt |
Fichiers PHP de production tracés par count-prod-php.sh ; le compte et la liste sont injectés dans le message. |
git diff --name-only HEAD et git ls-files --others --exclude-standard |
Inventaire des fichiers modifiés et non suivis, filtré par quatre motifs distincts (voir ci-dessous). |
curl -fsI http://127.0.0.1/ |
Vitalité de FrankenPHP, en loopback dans le conteneur php. |
curl -fsI http://docs-int:8000/ |
Vitalité de mkdocs. docs-int et jamais le nom de service nu docs : php et docs partagent trois réseaux, une résolution de docs rendrait trois A records dont celui du réseau du proxy, où les flux entrants sont jetés — la sonde deviendrait intermittente. Si l'alias ne résout même pas, le message le distingue d'une panne : la stack tourne avec une définition antérieure et demande un castor docker:up côté hôte. |
Deux motifs supplémentaires produisent des rappels ciblés, indépendants de la checklist : .gitlab-ci.yml / .gitlab/ci/*.yml / renovate.json → castor ci:local ; composer.json ou composer.lock → castor audit.
dirty_runtime et dirty_prod : deux questions différentes¶
Ces deux inventaires ne se recouvrent pas, et les confondre est ce qui produisait des blocages injustifiés.
| Entrée | Motif | Question à laquelle elle répond |
|---|---|---|
dirty_runtime |
^src/.+\.php$, ^config/, ^templates/, ^assets/, ^public/, ^frankenphp/, ^\.env, ^composer\.(json\|lock)$, ^importmap\.php$ |
« la session peut-elle avoir cassé l'app ? » → pilote le blocage |
dirty_prod |
\.php$ (inventaire DIRTY_RELEVANT préexistant) |
« la session a-t-elle produit du PHP à vérifier ? » → pilote le rappel de checklist |
Un .php de test est dirty_prod sans être dirty_runtime : un fichier de test modifié n'a jamais fait tomber FrankenPHP. Inversement, un .env ou un fichier de frankenphp/ est dirty_runtime sans être un .php.
Table de décision¶
La décision est prise par stop_decision (lib/stop-decision.lib.sh), fonction pure qui écrit un jeton sur stdout et ne fait rien d'autre :
| # | Condition | Jeton |
|---|---|---|
| 1 | app_down et dirty_runtime |
block:app-regression |
| 2 | app_down sans dirty_runtime |
warn:infra-down |
| 3 | doc_down |
warn:infra-down — jamais bloquant |
| 4 | todo_count > 0 et dirty_prod |
warn:checklist |
| 5 | sinon | silent |
L'ordre d'évaluation fait partie du contrat (et il est verrouillé par des tests bats) : la règle 1 l'emporte sur la 3 — app cassée par la session et docs mort donnent un blocage — et la règle 3 l'emporte sur la 4 — une panne d'infra prime sur un rappel de checklist.
Les quatre premiers arguments valent 0 ou 1, le cinquième est un entier. Toute entrée vide ou non numérique dégrade en 0 : le pire cas de cette dégradation est un silence, jamais un faux blocage.
Hors silent, le message est toujours le même socle — checklist cochée ✅/❌, résumé castor all, rappels ciblés CI/audit s'ils sont dus, délégations obligatoires, quota PHP. Le jeton détermine le régime et le bloc de vitalité qui vient s'y ajouter :
| Jeton | Ce qui s'ajoute, et sous quel régime |
|---|---|
block:app-regression |
decision: block (via emit_block_capped). Bloc « Régression de vitalité détectée — clôture BLOQUÉE » : services en panne, fichiers tracés et git status, marche à suivre (suspecter les dernières modifications, lire var/log/supervisor/frankenphp.log, corriger, revalider). |
warn:infra-down |
continue: true. Bloc qui nomme l'action au lieu d'exiger une correction : castor supervisor:frankenphp-restart depuis le conteneur pour l'app (repli hôte : castor docker:up), docker compose restart docs côté hôte pour la doc, avec la mention que le conteneur docs n'est pas pilotable depuis l'agent. |
warn:checklist |
continue: true. Aucun bloc de vitalité — le socle seul. |
silent |
Aucune sortie, et le compteur de blocages est remis à zéro. Exception : si un rappel ciblé CI ou audit est dû, ce rappel est émis seul, précédé d'une ligne de contexte — le socle, lui, reste éteint. |
Pourquoi doc_down ne bloque jamais
Relancer le conteneur docs exige Docker, dont l'agent n'a pas le socket par conception (invariant de confinement C2). Un blocage sur ce motif exigeait une correction hors de portée, à chaque fin de tour, jusqu'au plafond. Le cas fréquent est d'ailleurs bénin : recharger mkdocs.yml fait tomber le process mkdocs serve, donc écrire de la documentation suffisait à déclencher l'alerte.
Plafond anti-boucle¶
Un blocage ne se répète pas indéfiniment sur la même intention de clôture :
| Élément | Valeur |
|---|---|
| Constante | BLOCK_CAP=2 (dans stop-checklist.sh) |
| Compteur | <dossier de session>/.stop-block-count — namespacé, pour qu'une session ne fasse pas plafonner celle d'un autre worktree |
| Incrément | À chaque blocage émis. |
| Dégradation | Au-delà du plafond, emit_block_capped émet un continue: true avec une ligne « blocage levé pour te rendre la main », sans remettre le compteur à zéro (sinon la même condition rouge rebloquerait deux fois au cycle suivant). |
| Reset | Quand un tour se termine sans blocage : sortie silencieuse, ou avertissement non bloquant. |
Le plafond est la seule mécanique de limitation du hook. Son périmètre s'est réduit avec la table de décision : il ne borne plus que block:app-regression, le motif « service d'infra arrêté » ne produisant plus de blocage à absorber.
Sortie¶
exit 0immédiat et silencieux sijqn'est pas installé, si le contexte détecté n'est nicontainernihost, ou si le sous-script n'a rien à dire.emit_continue—{"systemMessage": …, "continue": true}.emit_block—{"systemMessage": …, "decision": "block", "reason": …}, uniquement viaemit_block_capped.
Effets de bord¶
Le hook écrit et supprime <dossier de session>/.stop-block-count (compteur de blocages consécutifs). Rien d'autre : le reste de son travail est en lecture — tracker, état de checklist, git, et deux requêtes HEAD intra-stack.
session-dashboard.sh¶
| Champ | Valeur |
|---|---|
| Fichier source | .claude/hooks/session-dashboard.sh |
| Événement Claude Code | SessionStart |
| Matcher | (aucun — il tourne donc aussi pour une session ouverte depuis l'hôte) |
| Bloquant | SessionStart ne peut pas empêcher une session de s'ouvrir. Le hook peut en revanche émettre continue: false, qui arrête tout traitement par Claude après le hook. |
Rôle¶
Injecte dans le contexte de la session un dashboard d'état du projet, et porte le gate de confinement. Huit sections, dans l'ordre d'affichage :
- frontières hôte/conteneur — l'encart qui rappelle ce qui se lance ici et ce qui se lance côté hôte ;
- étape en cours — dernier fichier
Étapes/étape*.md, marqué(untracked → vraisemblablement en cours)ou(commitée); - fichiers PHP de production sans test correspondant sous
tests/; - quota PHP de production en cours (
<dossier de session>/prod-php-files.txt) ; - état de la checklist de clôture (
<dossier de session>/checklist-state.txt) ; - fraîcheur de l'image dev, déléguée à
infra/image/image-freshness.lib.shquand elle est lisible (dégradation silencieuse sinon) ; - alerte coredump, déléguée à
infra/coredump/coredump.lib.sh; - dépendances absentes — affichée quand
vendor/autoload_runtime.phpmanque ;
puis le gate de confinement — invariants C1…C10 —, qui peut remplacer tout le dashboard.
Chacune des trois sections déléguées à une bibliothèque suit le même patron défensif : lib illisible, fonction absente ou en échec ⇒ la section est simplement omise, jamais d'erreur remontée à la session.
Encart des frontières hôte/conteneur¶
Affiché en tête, et volontairement : l'agent doit connaître ses frontières avant de chercher pourquoi docker n'existe pas.
Le texte vient de motd_main (infra/motd/motd.lib.sh), la même fonction que le MOTD affiché à l'ouverture d'un shell interactif dans le conteneur (/etc/profile.d/kirexo-motd.sh). Une seule rédaction pour les deux surfaces, donc aucune dérive possible entre elles. L'encart nomme le worktree et sa branche, les commandes disponibles dans le conteneur, la portée de git commit / git push — autorisés depuis le conteneur, sauf main, les branches d'étape et les tags, un tag valant déploiement en production (cf. Pousser sur GitLab depuis un worktree) —, celles qui n'existent que côté hôte (castor wt:*, castor firewall:reload), les trois URLs du worktree et la règle de sortie réseau.
La section est omise hors conteneur (KIREXO_INSIDE_CONTAINER ≠ 1) : une session ouverte sur l'hôte n'a aucune de ces frontières.
Alerte coredump¶
coredump_alert scanne la racine du dépôt (profondeur 1) et rend, pour chaque coredump trouvé, un bloc 🧨 Coredump à la racine du dépôt : chemin, taille lisible, date, commande d'origine extraite de la note ELF NT_PRPSINFO, et la commande de suppression.
Cette commande est proposée, jamais exécutée — aucune fonction de la bibliothèque n'appelle rm, et le projet ne pose aucun ulimit -c : un coredump est la seule trace exploitable d'un segfault. Aucun core trouvé ⇒ aucune sortie. La marche à suivre est dans Exploiter un coredump.
Dépendances absentes¶
Le test porte sur vendor/autoload_runtime.php, le fichier exact que public/index.php requiert. Absent, la section s'ajoute au dashboard :
📦 Dépendances absentes : vendor/autoload_runtime.php introuvable.
FrankenPHP ne peut pas démarrer, et castor perd les classes App\Castor.
Depuis l'hôte : castor wt:up <ticket> — ici : composer install
Les deux remèdes sont donnés parce qu'ils ne s'exécutent pas du même côté : la stack se pilote depuis l'hôte (invariant C2), l'installation se fait dans le conteneur. Sans cette section, le seul indice de la panne était un bloc « couverture des tests » calculé sur zéro fichier de production — qui n'oriente vers rien. Fichier présent ⇒ aucune sortie.
Ce hook ne mesure jamais la santé de la stack
Le gate de confinement qui suit peut refuser une session ; cette section, jamais. Une stack morte ne doit pas empêcher d'ouvrir la session qui vient la réparer — cf. Réparer un worktree dont la stack ne démarre plus.
Entrée¶
| Champ JSON | Usage |
|---|---|
permission_mode |
Mode de permission de la session. Champ non garanti sur tous les événements : s'il est absent ou vide, repli sur la variable d'environnement KIREXO_CLAUDE_BYPASS_ACTIVE — 1 vaut bypassPermissions, toute autre valeur comme son absence valent « autre mode ». Seule la valeur bypassPermissions peut armer le gate. |
source |
Origine de la session : startup, resume, clear, fork — et compact, qui neutralise le gate (une compaction survient au milieu d'un travail en cours). |
Pourquoi le repli ne lit plus .claude/settings.local.json
Ce fichier ne porte plus de permissions.defaultMode : Claude Code ignore un mode venu d'un fichier que le dépôt contrôle, et le mode est désormais posé par castor wt:claude sur la ligne de commande. Le repli est donc la variable que cette même cible publie dans la session.
Conséquence à connaître : un claude lancé à la main depuis castor wt:shell ne reçoit pas la variable. Le repli vaut alors « autre mode » — ce qui est exact, cette session n'a pas le bypass —, et le gate se contente d'alerter au lieu de refuser.
Gate de confinement¶
Trois étapes, dans un ordre qui compte :
- Détection du contexte, avant toute exécution. Si
KIREXO_INSIDE_CONTAINERne vaut pas1et que/.dockerenvest absent, le verdict estskip-host: le contrat décrit le conteneur de l'agent, pas le poste de travail. Le hook n'émet alors jamaiscontinue: false. La détection est écrite en dur dans le script —.claude/hooks/lib/checklist-common.shn'est pas sourcé ici. - Appel direct du script Bash —
bash infra/confinement/check.sh --format=json, soustimeout 25quandtimeoutest disponible. Ni Castor, ni PHP, nivendor/: le gate doit fonctionner quand le bootstrap a échoué. - Lecture du verdict dans le champ
.verdictdu JSON rendu. Script absent, illisible, en dépassement de temps ou JSON invalide → verdictunavailable.
verdict |
permission_mode |
Sortie |
|---|---|---|
skip-host |
quelconque | Ligne informative « profil container non applicable (session hôte) » ajoutée au dashboard. Jamais de continue: false. |
pass |
quelconque | Bloc 🔒 Confinement ajouté au dashboard, avec le résumé du contrôle, la liste des avertissements et celle des dettes en attente. |
fail ou unavailable |
bypassPermissions, et source ≠ compact |
{"continue": false, "stopReason": …, "systemMessage": …} puis exit 0. La raison nomme les invariants en échec et renvoie vers castor confinement:check et .claude/skills/_shared/confinement.md. Le dashboard n'est pas émis. |
fail ou unavailable |
tout autre mode, ou source = compact |
Bloc ⚠ Confinement rouge dans le dashboard et dans systemMessage. Jamais bloquant. |
Sortie¶
exit 0immédiat et silencieux sijqn'est pas installé.- Cas nominal : objet JSON avec
hookSpecificOutput.hookEventName = "SessionStart"ethookSpecificOutput.additionalContextcontenant le dashboard, injecté dans le contexte dès le premier prompt. - Confinement rouge hors
bypassPermissions: même objet, plus un champsystemMessage. - Confinement rouge en
bypassPermissions(hors compaction) : objet{"continue": false, "stopReason": …, "systemMessage": …}à la place du dashboard. decision: blockethookSpecificOutput.permissionDecisionne sont jamais émis : ils ne sont pas supportés sur cet événement.
Effets de bord¶
Une seule écriture : le mkdir -p du dossier de session, effectué par la résolution kirexo_session_dir() avant la lecture du tracker et de la checklist. Pour le reste, le hook lit (Étapes/, src/, tests/, var/claude/, les libs de MOTD, de fraîcheur d'image et de coredump, le script de confinement) et écrit uniquement sur stdout. En particulier, la détection d'un coredump ne supprime rien. Le contrôle de confinement qu'il déclenche est lui-même sans effet de bord — les tentatives d'écriture y sont faites en O_APPEND de zéro octet, et jamais sur un chemin qui n'est pas déjà un fichier régulier (cf. castor confinement:check et Modèle de menace et contrat de confinement).