Convention du CHANGELOG.md¶
Cette page documente les règles d'écriture du fichier CHANGELOG.md à la racine du dépôt. Pour la consultation du changelog lui-même, voir la page Changelog.
Versionnement sémantique depuis 0.0.1¶
Kirexo suit le Versionnement Sémantique depuis la version 0.0.1. La version de référence est le tag Git seul (pas de fichier VERSION) : chaque tag de release MAJEUR.MINEUR.CORRECTIF (cf. Créer un tag de release) donne une section dans le CHANGELOG.md, dont le titre reprend la version et la date UTC de préparation :
Cette section est alimentée automatiquement par le skill /creer-tag, à partir des commits accumulés depuis la version précédente. La génération est déterministe (aucune rédaction par un LLM) : elle s'appuie sur la cible castor changelog:prepare, qui classe les sujets de commits par rubrique selon leur préfixe Conventional Commits. Voir Créer un tag de release.
Une section ne peut exister qu'une fois : changelog:prepare refuse d'écrire si un titre ## [<version>] est déjà présent dans le fichier.
Borne basse de la section¶
| Cas | Premier commit pris en compte |
|---|---|
| Au moins une version semver existe | Commit suivant la plus haute version semver (tri numérique par composante) |
Aucune version semver (section 0.0.1 uniquement) |
Commit suivant le dernier ancien tag horodaté YYYYMMDDHHMM |
| Aucun tag de release | Premier commit du dépôt |
Le repli sur le dernier tag horodaté évite de recopier dans la section 0.0.1 l'historique déjà consigné sous les sections horodatées. Il devient inatteignable dès que 0.0.1 existe.
Sections historiques figées¶
Deux familles de sections précèdent le versionnement sémantique. Elles restent figées telles quelles :
| Titre | Origine |
|---|---|
## [YYYYMMDDHHMM] — AAAA-MM-JJ |
Anciens tags de release horodatés (12 chiffres, UTC). Ces tags restent dans le dépôt Git mais ne sont plus jamais considérés comme des versions. |
## [étape-N] — … |
Ancien découpage par étape de cadrage (étape-N = clôture de l'étape N). |
Pourquoi les sections [étape-N] ont été renommées
Ces trois sections s'intitulaient à l'origine [0.1.0], [0.2.0] et [0.3.0], sans qu'aucun tag Git de ce nom n'existe. Elles seraient entrées en collision avec les futures vraies versions 0.1.0 à 0.3.0 : changelog:prepare aurait refusé la nouvelle section comme doublon, le script de release l'aurait crue déjà générée, les définitions de lien de référence [0.1.0]: … auraient transformé le futur titre en lien vers un tag inexistant, et mkdocs aurait produit deux ancres identiques. Seul le libellé a changé ; le contenu des sections est intact.
Correspondance préfixe → rubrique¶
changelog:prepare (via la classe App\Castor\Changelog\ChangelogGenerator dans castor/src/Changelog/ChangelogGenerator.php) classe chaque commit dans une rubrique d'après son préfixe conventionnel :
| Préfixe(s) Conventional Commits | Rubrique |
|---|---|
feat |
Ajouté |
fix |
Corrigé |
perf, refactor |
Modifié |
docs |
Documentation |
ci, build, chore, test, style |
Outillage & CI |
| (préfixe absent ou non reconnu) | Divers |
Les rubriques sont rendues dans cet ordre fixe, la rubrique de repli Divers en dernier ; seules les rubriques non vides apparaissent. Chaque puce reprend le sujet du commit débarrassé de son préfixe type(scope):, première lettre capitalisée.
Source de vérité et pipeline d'inclusion¶
Le changelog vit dans CHANGELOG.md à la racine du dépôt — c'est la seule version maintenue. La page docs/changelog.md se contente de l'inclure via la directive pymdownx.snippets :
<!--
Convention d'écriture de ce fichier : docs/reference/changelog.md
(page publiée : https://doc.kirexo.app/reference/changelog/).
Règle critique : PAS DE LIENS MARKDOWN RELATIFS. Ce fichier est inclus
dans docs/changelog.md via `--8<-- "CHANGELOG.md"` (pymdownx.snippets) ;
mkdocs résout alors les liens relatifs depuis docs/changelog.md, donc
un lien `docs/reference/foo.md` devient `docs/docs/reference/foo.md`
→ warning → strict mode → build cassé → conteneur docs en exit 1.
À la place, utiliser une URL absolue :
- GitLab (préféré, fonctionne aussi en lecture brute sur GitLab) :
https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/foo.md
- Doc publiée :
https://doc.kirexo.app/reference/foo/
-->
# Changelog
Toutes les évolutions notables du projet Kirexo sont consignées ici.
Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) et le projet suit le [Versionnement Sémantique](https://semver.org/lang/fr/) depuis la version `0.0.1`.
Chaque tag de release `MAJEUR.MINEUR.CORRECTIF` (cf. [Créer un tag de release](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/how-to/creer-un-tag-de-release.md)) donne une section `## [x.y.z] — AAAA-MM-JJ`, alimentée automatiquement par le skill `/creer-tag` à partir des commits depuis la version précédente. Les sections `[YYYYMMDDHHMM]` sont celles des **anciens tags horodatés**, et les sections `[étape-N]` celles de l'ancien découpage par étape de cadrage (`étape-N` = clôture de l'étape *N*) : toutes deux restent figées telles quelles.
## [0.0.1] — 2026-10-05
### Ajouté
- Ticket #269 - lot 2 — ajoute la cible docker:smoke-prod-image
- Ticket #269 - lot 1 — ajoute le smoke test HTTP de l'image prod
- Ticket #268 - lot 3 — partage un extracteur fiable des saisies utilisateur
- Ticket #268 - lot 2 — exige la couverture E2E dès l'analyse et au ship
- Ajoute creation-ticket, maillon 0 de la chaîne ticket
- Castor composer:validate, aligné sur la CI au flag près
- Étape 10 - lot 28 — rend la sélection souris au terminal
- Étape 10 - lot 26 — un certificat valide par worktree
- Étape 10 - lot 25 — amorce vendor/ depuis le dépôt principal
- Étape 10 - lot 23 — aucune panne silencieuse dans les commandes
- Étape 10 - lot 22 — entrer par le répertoire, partir de main
- Étape 10 - lot 21 — entrer dans un worktree sans y penser
- Étape 10 - lot 18 — entre dans un worktree en une commande
- Étape 10 - lot 13 — rend l'agent autonome du code au push
- Ticket #202 - lot 9 — rend l'IDE natif et les frontières explicites
- Ticket #202 - lot 7 — donne un cycle de vie complet aux worktrees
- Ticket #202 - lot 6 — route les worktrees derrière un proxy Caddy hôte unique
- Ticket #202 - lot 5 — fait dériver les singletons de la stack d'un seul identifiant
- Ticket #202 - lot 4 — loge le worker Messenger dans le conteneur php
- Ferme la sortie réseau par un proxy d'allowlist
- Étape 10 - lot 2 — isole l'espace Claude et le jeton GitLab
- Étape 10 - lot 1 — vérifie les invariants C1…C10 par leur effet
### Corrigé
- Ticket #275 - lot 1 — pilote la maintenance par les boucles vivantes
- Update dépendances non majeures
- Ticket #268 - lot 4 — garantit une seule boucle par programme
- Ticket #260 - lot 5 — rend l'image prod servable (assets, Graylog)
- Ticket #260 - lot 4 — retire le needs de docker:build-prod
- Ticket #260 - lot 3 — fait réellement tourner le garde-fou prod en MR
- Ticket #260 - lot 2 — injecte CLAUDE_API_KEY_CIPHER_KEY en production
- Update dépendances non majeures
- Rend create-branches compatible avec les worktrees
- Rend effectives trois règles deny sans effet
- Pose bypassPermissions par flag, plus par settings.local.json
- Bumpe Chromium sur la version présente dans Alpine v3.24
- Update dépendances non majeures
- Retire la clé dupliquée laissée par le rebase
- L'outillage de lot ne code plus le dépôt en dur
- Le gate de complétude distingue doublon et ship oublié
- Étape 10 - lot 34 — wt:claude et wt:shell sondent la sortie réseau
- Étape 10 - lot 33 — les singletons Compose s'ancrent sur le dépôt principal
- Étape 10 - lot 37 — Étape 10 - lot 34 — l'outillage de lot ne ment plus sur ce qu'il a fait
- Étape 10 - lot 29 — wt:destroy ne laisse plus de singleton parenté
- Étape 10 — une seule résolution de branche parente, partagée
- Étape 10 — wt:destroy survit à la suppression de son propre dossier
- Étape 10 - lot 27 — donne un certificat valide à chaque URL
- Étape 10 - lot 20 — rend le shell d'un worktree réellement interactif
- Étape 10 - lot 18bis — dit l'état réel et migre le proxy
- Étape 10 - lot 17 — C10 sonde les bons voisins
- Étape 10 - lot 16 — rend un worktree cassé réparable
- Étape 10 - lot 11 — répare le cycle de vie d'un worktree neuf
- Débloque le build sur le bump Chromium d'Alpine
- Rend visible la perte du proxy sortant
- Rend discriminantes des attentes que la lenteur masquait
- Répare glab et la propagation du jeton
### Modifié
- Étape 10 - lot 33 — l'outillage de preuve quitte var/ pour infra/dod
- Étape 10 - clôture — une seule résolution de branche parente
- Ticket #202 - lot 8 — sort du Dev Container et cloisonne les ressources
- Auto-héberge les polices au lieu de les charger chez Google
### Documentation
- Ticket #244 — évaluation des interactions
- Ticket #275 — évaluation des interactions
- Ticket #270 — évaluation des interactions
- Ticket #269 — évaluation des interactions
- Ticket #268 — évaluation des interactions
- Ticket #260 — évaluation des interactions
- Clôture — l'angle mort de la case 20 était structurel
- Clôture — la DoD et le journal en accord avec les faits
- Étape 10 - clôture — journal d'apprentissage et préflight réparé
- Étape 10 - clôture — case 16 prouvée, la DoD passe à 28/30
- Étape 10 - clôture — case 30 prouvée, la DoD passe à 26/30
- Étape 10 - clôture — case 15 : la cause est le wildcard du repli
- Étape 10 - clôture — cases 8 et 18 prouvées, piste TLS écartée
- Étape 10 - clôture — DoD hôte prouvée, deny-list T9
- Étape 10 - lot 22 — corrige un commentaire du supervisor
- Étape 10 - lot 19 — aligne le dépôt sur ce qu'il fait vraiment
- Actualise des commentaires laissés par la sortie du Dev Container
- Ticket #202 - lot 10 — solde la dette documentaire et prouve la DoD
### Outillage & CI
- Lock file maintenance
- Ticket #270 - lot 1 — republie l'image dev sur main, retire build-prod de main
- Ticket #269 - lot 3 — lance le smoke test HTTP avant le push de l'image prod
- Ticket #268 - lot 1 — stabilise les comparaisons bats triées
- Update willfarrell/autoheal:latest docker digest to 4ae1cb5
- Ticket #260 - lot 1 — exclut l'outillage IA de dev de l'image prod
- Monte Castor 1.8.1, glab 1.119.0 et Claude Code 2.1.282
- Update willfarrell/autoheal:latest docker digest to 2050a9d
- Update willfarrell/autoheal:latest docker digest to 3d5c946
- Update willfarrell/autoheal:latest docker digest to 16a5bff
- Update willfarrell/autoheal:latest docker digest to dbed027
- Update alpine:3.24 docker digest to 294b683
- Étape 10 - lot 14 — une allowlist par suite de tests
- Étape 10 - lot 12 — versionne les garde-fous Compose
- Étape 10 - lot 15 — authentifie Composer auprès de GitHub
- Actualise la deny-list et ouvre la suppression aux agents
### Divers
- Creer-tag : garde-fou sur le commit de origin/main, niveau par Claude
- Ticket #302 — Consigne l'évaluation des interactions dans apprentissage.md
- Update dependency phpstan/phpstan to ^2.2.17
- Ticket #302 - lot 17 — Aligne le dépôt sur PostgreSQL 18 et épingle FrankenPHP
- Update dépendances non majeures
- Ticket #302 - lot 16 — Rend le bundle installable avec PostgreSQL 18 et épingle Traefik
- Ticket #302 - lot 15 — Réduit l'installation à son gestalt, pour un lecteur qui connaît Docker
- Ticket #302 - lot 14 — Documente l'installation derrière un reverse proxy et teste Traefik
- Ticket #302 - lot 13 — Ajoute au site la page « Installer Kirexo » et son garde-fou
- Ticket #302 - lot 12 — Réécrit la documentation d'installation pour l'auto-hébergeur
- Update willfarrell/autoheal:latest Docker digest to 0476c57
- Ticket #302 - lot 11 — Stocke la règle de rédaction de la documentation d'installation
- Ticket #302 — Reformule la promesse du site vitrine
- Ticket #302 - lot 10 — Fait suivre le thème au panneau de connexion admin
- Ticket #302 - lot 9 — Étend /creer-tag pour mettre à jour le site vitrine à chaque release
- Ticket #302 - lot 8 — Vérifie l'accessibilité de la doc en CI (quality:docs-a11y)
- Ticket #302 - lot 7 — Habille la doc mkdocs au style de l'espace admin
- Ticket #302 - lot 6 — Publie le site vitrine depuis la CI (deploybase ou OVH)
- Ticket #302 — Remplace kirexo.fr par kirexo.app partout
- Ticket #302 - lot 5 — Ajoute castor site:check et exclut site/ et docs/ de l'image
- Ticket #302 - lot 4 — Rédige le contenu du site vitrine et ses pages annexes
- Ticket #302 - lot 3 — Ajoute la cible castor site:build du site vitrine statique
- Ticket #302 - lot 2 — Passe le projet sous licence AGPL-3.0-or-later
- Ticket #302 - lot 1 — Ajoute la sonde deploybase qui choisit l'hébergeur du site
- Consigne la clôture du ticket #298 dans apprentissage.md
- Ticket #298 - lot 3 — Borde les contrôles de l'espace utilisateur en --field-border
- Ticket #298 - lot 2 — Relève les bords et repères d'état des contrôles partagés
- Ticket #298 - lot 1 — Pose la gate de contraste des tokens et fonce --ink-3
- Relève les contrastes du design system au niveau RGAA AA
- Update postgres Docker tag to v18
- Ticket #244 - lot 13 — Reporte l'empreinte mesurée et corrige la création sans terminal
- Ticket #244 - lot 12 — Publie les ports du bundle sur toutes les interfaces par défaut
- Ticket #244 - lot 11 — Teste l'installation du bundle de bout en bout avant toute publication
- Ticket #244 - lot 10 — Construit l'image prod en amd64 et arm64 sur tag et signe le manifeste
- Ticket #244 - lot 9 — Publie le bundle d'installation en assets de release
- Ticket #244 - lot 8 — Passe au versionnement sémantique à partir de 0.0.1
- Ticket #244 - lot 7 — Rédige la procédure d'installation du bundle (install/README.md)
- Ticket #244 - lot 6 — Ajoute le bundle d'installation install/ (compose.yaml, .env.example)
- Ticket #244 - lot 5 — Contrôle les hôtes servis dans le diagnostic d'installation
- Ticket #244 - lot 4 — Refuse les secrets d'exemple et ajoute le diagnostic app:install:check
- Ticket #244 - lot 3 — Injecte les variables de production et configure le fuseau par TZ
- Ticket #244 - lot 2 — Ajoute un worker Messenger dédié et verrouille le planificateur
- Ticket #244 - lot 1 — Joue les migrations au démarrage du serveur via RUN_MIGRATIONS
- Ticket #245 — Consigne l'évaluation des interactions de clôture
- Ticket #245 - lot 8 — Couvre en E2E les parcours restants de la gestion des comptes
- Ticket #245 - lot 7 — Finalise design system, accessibilité et sans-JS des comptes
- Ticket #245 - lot 6 — Permet de supprimer définitivement un compte supprimé
- Ticket #245 - lot 5 — Permet de supprimer logiquement et de réintégrer un compte
- Ticket #245 - lot 4 — Efface toute présence publique d'un compte non actif
- Ticket #245 - lot 3 — Permet de désactiver et réactiver un compte depuis l'admin
- Ticket #245 - lot 2 — Livre le cycle complet des invitations de compte
- Ticket #245 - lot 1 — Pose le modèle de données de gestion des comptes
- Cadre l'étape 10 : sortie du Dev Container en 10 lots
- Lock file maintenance
- Update dépendances non majeures
- Lock file maintenance
- Update dépendances non majeures
- Résout les hooks Claude Code en chemin absolu
- Update dépendances non majeures
- Lock file maintenance
- Update dependency friendsofphp/php-cs-fixer to ^3.95.21
- Update dependency friendsofphp/php-cs-fixer to ^3.95.20
- Update dependency friendsofphp/php-cs-fixer to ^3.95.19
- Lock file maintenance
- Ticket #185 - clôture — Consigne l'évaluation des interactions
- Ticket #185 - lot 9 — Couvre en E2E le rendu de l'anatomie sur le site public
- Corrige la CVE-2026-53965 en passant mcp/sdk en 0.7.1
- Retrouve la MR d'un lot dont la branche s'écarte de la convention
- Ticket #185 - lot 8 — Corrige le placeholder du corps sur une ligne finissant par une espace
- Ticket #185 - lot 7 — Reflète les modifications non publiées sur le bouton republish
- Ticket #185 - lot 6 — Corrige le cadre du chapô coupé dans l'éditeur
- Ticket #185 - lot 5 — Documente l'anatomie d'un article (explication + how-to)
- Ticket #185 - lot 4 — Ajoute la titraille inline et l'inspecteur dans l'éditeur
- Ticket #185 - lot 3 — Rend l'anatomie de presse sur le site public, la carte et l'aperçu
- Ticket #185 - lot 2 — Élargit l'autosave à la titraille et gère le titre éditable
- Ticket #185 - lot 1 — Ajoute la titraille et le versionnage de l'anatomie d'article
- Update dependency phpunit/phpunit to ^13.3.1
- Update dépendances non majeures
- Lock file maintenance
- Update dependency league/commonmark to ^2.9.1
- Autorise l'invocation par le modèle des skills de ticket sous autonomie maximale
- Ticket #199 - clôture — Consigne l'évaluation des interactions
- Ticket #199 - lot 1 — Force l'autosave au Ctrl+S dans l'éditeur d'article
- Ticket #199 - outillage — Ajoute l'action press au skill demo-video
- Update dépendances non majeures
- Lock file maintenance
- Update dépendances non majeures
- Corrige les mentions de tag d'image obsolètes dans la doc
- Aligne l'image dev du devcontainer sur le tag -alpine
- Corrige 6 advisories DoS de league/commonmark (2.8.3 -> 2.9.0)
- Met à jour glab et claude-code du devcontainer (1.112.0 / 2.1.223)
- Fiabilise le titre dans le test E2E de duplication de theme
- Corrige le SIGPIPE de tools:version-check (curl 23 / exit 141)
- Ajoute un worker Messenger automatique en dev
- Corrige le 500 sur la bascule de plugin (double-submit)
- Installe Node via le paquet Alpine apk au lieu du tarball musl
- Durcis le téléchargement de Node musl contre le throttling CI
## [202608031433] — 2026-08-03
### Ajouté
- Étape 9 - lot 32 — rend les overrides HTML (en-tête/corps/pied) assainis
- Étape 9 - lot 31 — applique les 3 thèmes structurés au rendu public
- Étape 9 - lot 30 — applique le CSS custom au rendu public
- Étape 9 - lot 28 — publie/dépublie une page spéciale depuis la liste
- Étape 9 - lot 24 — sert les sites *.localhost dans le devcontainer
- Étape 9 - lot 23 — gate l'espace user + active le plugin dans la démo
- Étape 9 - lot 22 — gate le rendu public sur l'activation (global + user)
- Étape 9 - lot 14 — réglages du site — domaines et pages spéciales (13a)
- Étape 9 - lot 13 — réglages admin (compteurs + kill switch) et activation user
- Étape 9 - lot 12 — destinations par plugin et prévisualisation web
- Étape 9 - lot 11 — on-demand TLS Caddy désactivable et sonde de santé
- Étape 9 - lot 10 — CSS filtré, feuille externe et CSP stricte (9b)
- Étape 9 - lot 9 — sandbox et sanitizer du rendu personnalisé (9a)
- Étape 9 - lot 8 — rend le site public (home, pages, articles) avec SEO et cache
- Étape 9 - lot 7 — résout Host vers Site et isole le trafic multi-tenant
- Étape 9 - lot 6 — implémente le contrat et crée le Site à l'activation
- Étape 9 - lot 5 — pose le bundle web et ses entités Site/SiteDomain
- Étape 9 - lot 3 — active les plugins à deux niveaux avec verrou
- Étape 9 - lot 2 — diffuse ArticlePublished par transport de plugin
- Étape 9 - lot 1 — pose le contrat de diffusion et le registre par tag
- Démarre la stack complète à l'ouverture
### Corrigé
- Étape 9 - lot 27 — corrige le flash inter-onglets + aide dans l'onglet Apparence
- Étape 9 - lot 26 — un seul domaine par site + lien vers le site généré
- Étape 9 - lot 25 — retire le titre redondant en tête des contenus de démo
- Tolère le certificat HTTPS auto-signé du devcontainer
- Plafonne le hook Stop à 2 blocages consécutifs
- Alerte sur l'image dev pré-estampille au dashboard
### Modifié
- Étape 9 - lot 4 — remplace l'enum DiffusionPlatform par des clés
### Documentation
- Cadre le socle de plugins et le plugin web
### Outillage & CI
- Étape 9 - lot 21 — aligne le formulaire de page spéciale sur le hub
- Promeut les domaines locaux en baseline
### Divers
- Fiabilise le flash dans le test E2E de duplication de thème
- Met à jour les outils du devcontainer (castor, glab, node, claude)
- Étape 9 - clôture — évaluation de l'installation simple (lots 57-59)
- Étape 9 - lot 59 — Documente l'installation d'un plugin (how-to + référence)
- Étape 9 - lot 58 — Fais porter au bundle web sa ressource de routing
- Étape 9 - lot 57 — Rends le bundle web auto-portant pour sa config de conteneur
- Aligne la diffusion web sur le contrat et centralise l'autotag plugin
- Consolide les 6 migrations de l'étape 9 en une seule
- Étape 9 - clôture — apprentissage et retrait du garde-fou E-bis
- Étape 9 - lot 56 — Couvre en E2E le panneau capacités et le drag&drop des pages
- Applique la rétro implementer-lot et l'autoheal du conteneur docs
- Étape 9 - lot 55 — Corrige le libellé orphelin et l'autofocus de l'éditeur
- Étape 9 - lot 54 — Rends les thèmes joignables via un point d'extension du menu
- Étape 9 - lot 53 — Ajoute nofollow aux seuls liens externes des thèmes
- Étape 9 - lot 52 — Rends le mode sombre du site public opérant sans JavaScript
- Étape 9 - lot 51 — Finis les trois écrans signalés par le gate UI/UX
- Étape 9 - lot 50 — Ouvre la bibliothèque de thèmes aux utilisateurs
- Étape 9 - lot 49 — Fais de l'apparence d'un site un thème à part entière
- Étape 9 - lot 48 — Scope toute la configuration web au carnet
- Étape 9 - lot 46 — Aligne le rendu web sur le carnet de l'article
- Étape 9 - lot 45 — Groupe les brouillons sous les pages publiées
- Étape 9 - lot 44 — Configure le site carnet par carnet (entrée + création)
- Étape 9 - lot 43 — Rattache le site au carnet et rend le carnet obligatoire
- Étape 9 - lot 42 — Place les destinations sous l'article dans l'éditeur
- Étape 9 - lot 47 — Fiabilise le gate de couverture CI (SIGPIPE)
- Étape 9 - lot 41 — Sert le profiler sur les hosts de site en dev
- Étape 9 - lot 40 — Rend ronde la pastille de canal de l'admin plugins
- Étape 9 - lot 39 — Aligne le fil d'Ariane user sur « Mon espace »
- Étape 9 - lot 38 — Passe les destinations en switch avec aperçu extensible
- Étape 9 - lot 37 — Réordonne les pages spéciales par glisser-déposer
- Étape 9 - lot 36 — Fixe le flash d'onglet via un onglet actif lisible serveur
- Étape 9 - lot 35 — Autorise l'utilisateur à se retirer d'un plugin utilisé
- Étape 9 - lot 34 — Ajoute un fil d'Ariane de retour dans les réglages user
- Étape 9 - lot 33 — Emploie « Domaine » au singulier et l'action « Rattacher »
- Étape 9 - lot 20 — Fiabilise les formulaires et rend les éditeurs accessibles
- Étape 9 - lot 19 — Rend les onglets adressables et répare le feedback des flashes
- Étape 9 - lot 18 — Rend les écrans du plugin web atteignables et range leurs URLs
- Étape 9 - lot 17 — Style le site public et complète le hub de réglages
- Étape 9 - lot 16 — Documente l'écriture d'un plugin de diffusion
- Étape 9 - lot 15 — Ajoute la section apparence et le panneau des capacités du site
- Lock file maintenance
- Update renovate/renovate Docker tag to v44
- Update dépendances non majeures
- Update dependency phpstan/phpstan to ^2.2.6
- Update dependency phpunit/phpunit to ^13.2.5
- Update dépendances non majeures
- Update dependency symfonycasts/tailwind-bundle to v1
- Update dépendances non majeures
## [202607210830] — 2026-07-21
### Ajouté
- Étape 8 - lot 8 — header, retour Réglages, KPI filtrants
- Étape 8 - lot 7 — refond le dashboard en cockpit de conformité
- Étape 8 - lot 5 — aligne les écrans admin sur le DS et clarifie la conformité
- Étape 8 - lot 3 — fluidifie la navigation home app, /u et éditeur
- Étape 8 - lot 2 — unifie le menu utilisateur en disclosure sur les 3 espaces
### Corrigé
- Migre les règles de permission Write() vers Edit()
- Étape 8 - lot 6 — rend la déconnexion globale aux deux firewalls
- Étape 8 - lot 4 — rattache le nouvel article au carnet source
- Retire le plugin PHP bundlé de la liste JetBrains
### Documentation
- Journalise la clôture et versionne le cadrage
- Étape 8 - lot 1 — pose les patterns UI industrie et leur chargement
### Divers
- Ticket #5 — Monte Claude Code 2.1.211 → 2.1.216 (devcontainer)
- Ticket #5 — Consigne le bilan de clôture (apprentissage.md)
- Ticket #5 - lot 5 — Documente la migration Alpine (Diátaxis)
- Ticket #5 - lot 4 — Constate le gain CVE Alpine et allowliste le résiduel
- Ticket #5 - lot 3 — Migre le stage prod sur Alpine et durcit les CVE
- Ticket #5 - lot 2 — Migre le stage dev du devcontainer sur Alpine
- Ticket #5 - lot 1 — Migre l'image base FrankenPHP sur Alpine
- Ticket #100 — Journalise le bilan de clôture (apprentissage.md)
- Ticket #100 - lot 4 — Documente comment garder son devcontainer à jour
- Ticket #100 - lot 3 — Ajoute la cible castor devcontainer:refresh (host-only)
- Ticket #100 - lot 2 — Détecte une image dev périmée et alerte le dashboard
- Ticket #100 - lot 1 — Estampille l'image dev avec le SHA de build
- Ticket #99 — Outille la clôture et journalise l'apprentissage
- Ticket #99 - lot 5 — Corrige la capture et l'upload de /demo-video
- Ticket #99 - lot 4 — Documente la vidéo de démo et la config MCP Playwright
- Ticket #99 - lot 3 — Impose une vidéo de démo quand un .twig est touché
- Ticket #99 - lot 2 — Ajoute le skill /demo-video de capture reproductible
- Ticket #99 - lot 1 — Versionne le MCP Playwright dans .mcp.json
- Lock file maintenance
- Update dependency php to >=8.5.8
## [202607181752] — 2026-07-18
### Ajouté
- Affiche vitesse et accélération de conso quota
### Corrigé
- Assouplit la contrainte php à >=8.5
- Adapte les stubs mock à PHPUnit 13
### Outillage & CI
- Met à jour castor, glab, node et claude-code
### Divers
- Update dépendances non majeures
- Ticket #86 - clôture — bilan interactions (apprentissage.md)
- Update dependency phpunit/phpunit to v13
- Ticket #86 - lot 2 — Épingle Chromium 149 via snapshot pour fiabiliser les E2E
- Ticket #86 - lot 1 — Capture le log verbeux Chromium et durcit les flags E2E
- Update dependency typescript to v7
## [202607060654] — 2026-07-06
### Ajouté
- Ticket #45 - lot 7 — polish éditeur — drag Crepe, typo Bringhurst, mode focus, aperçu serveur
- Ticket #45 - lot 1 — thème de formulaire mappé sur le design-system
- Famille de skills « ticket » GitLab + raffinements outillage
- Étape 7 - lot 6 — cible castor monitor (métriques live via Ember)
- Étape 7 - lot 5 — analyse IA Claude asynchrone des articles publiés
- Étape 7 - lot 4 — vue contenu public et clé API Claude chiffrée
- Étape 7 - lot 3 — parcours d'écriture, autosave et corbeille
- Étape 7 - lot 2 — domaine, cycle de vie et révisions
- Étape 7 - lot 1 — fondations workflow/Mercure/scheduler
- Ajoute le skill /creer-tag (release + maj CHANGELOG)
- Versionne le CHANGELOG par tag de release
- Ajoute la cible tag:create pour déclencher une release
### Corrigé
- Ticket #45 - lot 2 — habillage DS + débloque CSRF périmé et double-bouton
- Update dépendances non majeures
- Update dépendances non majeures
- Update dépendances non majeures
- Problème récupération variable env ci gitlab
### Documentation
- Ticket #55 — clôture — bilan interactions
- Ticket #54 — clôture — bilan interactions
- Ticket #57 — clôture — bilan interactions
- Ticket #45 — clôture — bilan interactions étape 7
- Consigne l'évaluation de clôture dans apprentissage.md
- Cadre l'écriture d'article en 6 lots
- Documente le versionnement par tag et /creer-tag
### Outillage & CI
- Ticket #57 - lot 4 — allège la garde de lot et silence le ship
- Ticket #57 - lot 3 — gen-tasks.sh — garde-fou anti-clobber + mermaid réel
- Ticket #57 - lot 2 — fiabilise ticket-context.sh sur 0 fichier cité
- Ticket #57 - lot 1 — attente discriminante sur le h1 après navigation
- Ticket #45 - lot 6 — durcit l'outillage implementer-lot-ticket + analyser-ticket
- Ticket #45 - lot 5 — réconcilie design-system/screens.css avec la copie servie
- Ticket #45 - lot 4 — backfill CSS des écrans réglages, articles et analyse IA
- Ticket #45 - lot 3 — habille l'éditeur d'article et l'e-mail de réinitialisation
- Update dépendances non majeures
- Installe unzip pour des installs Composer fiables
- Update anchore/syft docker tag to v1.46.0
- Update dependency friendsofphp/php-cs-fixer to ^3.95.11
- Exception multi-lots, gate 80 %, testabilité, couverture
- Allège le contexte CLAUDE.md et fixe le quota du skill
### Divers
- Ticket #62 - clôture — bilan interactions (apprentissage.md)
- Câble la bascule d'onglets Actifs/Archivés et les états vides des carnets
- Ticket #62 - lot 10 — Rend l'isolation E2E structurelle et fiabilise l'auto-merge
- Ticket #62 - lot 9 — Ajoute la recherche globale d'articles par titre
- Ticket #62 - lot 8 — Ajoute l'archivage, la restauration et la suppression d'un carnet
- Ticket #62 - lot 7 — Ajoute la création et les réglages d'un carnet
- Ticket #62 - lot 6 — Ajoute la modale d'aperçu d'article
- Ticket #62 - lot 5 — Ajoute le fenêtrage paginé de la frise chronologique
- Ticket #62 - lot 4 — Rend la frise chronologique statique d'un carnet
- Ticket #62 - lot 3 — Rend la section carnet, son tri et son pliage
- Ticket #62 - lot 2 — Refond la page d'accueil de l'espace autour des carnets
- Ticket #62 - lot 1 — Introduit le modèle multi-carnets et migre les données
- Update dependency phpstan/phpstan-phpunit to ^2.0.18
- Ajoute le hook guard-rm et libère rm sous var/claude/
- Ticket #55 - lot 6 — Fiabilise ticket-context.sh et gen-tasks.sh
- Ticket #55 - lot 5 — Dé-duplique les SKILL.md et branche le chargement des règles
- Ticket #55 - lot 4 — Étend suggest-docs.sh (--docs/--rules) et allège CLAUDE.md
- Ticket #55 - lot 3 — Déporte tests, délégation, secrets et actions remote en fiches _shared
- Ticket #55 - lot 2 — Déporte patterns, design system et conventions en fiches _shared
- Ticket #55 - lot 1 — Cartographie les sujets de règles dans un index _shared
- Ticket #54 - lot 5 — Outille la préparation mécanique des tests (mass-sed) pour le test-writer
- Ticket #54 - lot 4 — Bascule ArticleAnalysis et Setting en PK UUIDv7, requirements v7 partout
- Ticket #54 - lot 3 — Bascule Article et ArticleRevision en PK UUIDv7 applicative
- Ticket #54 - lot 2 — Bascule User et ResetPasswordRequest en PK UUIDv7 applicative
- Ticket #54 - lot 1 — Ajoute symfony/uid et consolide les règles Doctrine en source unique
## [202606220820] — 2026-06-22
### Ajouté
- E-mails au design system (user/admin) + transport failed
- Connexion et réinitialisation au design system
- Header partagé et sélecteur de thème clair/sombre/système
- Étape 6 - lot 4 — dashboards et réglages d'accent au design system
- Étape 6 - lot 3 — connexion et accueil plateforme au design system
- Étape 6 - lot 2 — socle design system + accent d'instance (Setting)
- Étape 6 - lot 1 — fondations Article et prénom
### Corrigé
- Corrige le nom d'env du token github pour Renovate
- Régénère composer.lock + recrée la MR Renovate sur main
### Documentation
- Cadrage GitLab (design system, connexion, accueil)
### Outillage & CI
- Bump glab 1.103.0, Node 24.17.0, Claude Code 2.1.185
- Préflight de diagnostic du token github.com
- Clôture — apprentissage + outillage skills
## [202606150332] — 2026-06-15
### Ajouté
- Lot 10 — remember-me + rate limiter sur les logins
- Lot 9 — saisie du nouveau mot de passe (reset password)
- Lot 8 — demande de réinitialisation de mot de passe
- Lot 7 — composant Twig Header partagé
- Lot 6 — bascule admin↔user par jeton signé à usage unique
- Lot 5 — Voter UserDataVoter + dashboards user/admin
- Ajoute le Live Component de connexion email-first
- Configure les firewalls user/admin et les pages de login
- Ajoute la commande console app:user:create
- Pose la fondation utilisateur (User + repository)
### Corrigé
- Neutralise le mailer en env test (MAILER_DSN=null)
### Documentation
- Cadrer la sécurité Symfony et lier le ticket GitLab #14
- Aligne les commandes glab sur `glab ci run`
### Outillage & CI
- Conventions GitLab d'assignation/traçabilité + optims
- Trait réutilisable de login email-first en WebTestCase
- Patches friction implementer-lot (pré-vol, anti-parasites, rearm, rebase)
- Quota PHP 10, gotchas + checkpoints agents, rm tests/
- Update redis docker tag to v8
- Update rabbitmq docker tag to v4
- Update postgres docker tag to v18
- Update node.js to v24
- Déplace le gate branches du CI vers une vérif locale
- Ts:check lit la version TypeScript du package.json
- Ajoute GITHUB_COM_TOKEN pour régénérer composer.lock
- Restreint le scope des règles changes des jobs de test
- Update gcr.io/projectsigstore/cosign docker tag to v3
## [202606071913] — 2026-06-07
### Corrigé
- Échappe !<iid> qui cassait le chargement des skills
- Refresh OAuth, fuseau Paris et plugin Mermaid
### Outillage & CI
- Active l'auto-merge et l'auto-rebase des MR
- Update dependency typescript to v6
- Update docker docker tag to v29
### Divers
- Corrige le flag glab mr create (-F inexistant → -d)
- Ajoute les skills de cadrage d'étape, agents et doc associée
## [202606061525] — 2026-06-06
### Corrigé
- Pré-charge Composer via COPY --from au lieu de install-php-extensions @composer
## [202606061413] — 2026-06-06
### Corrigé
- Curl avec retries pour résister aux hoquets réseau CI
## [202606061256] — 2026-06-06
### Corrigé
- Renovate utilise binarySource: install pour régénérer composer.lock
## [202606060754] — 2026-06-06
### Corrigé
- Security:container-issue — revert GITLAB_TOKEN + format CVE
### Outillage & CI
- Purge linux-libc-dev de l'image (-22 CVE faux positifs)
## [202606052107] — 2026-06-05
### Corrigé
- Security:container-issue passe à CI_JOB_TOKEN + filtre Critical/High
### Modifié
- Skippe les jobs redondants sur la pipeline tag
### Outillage & CI
- Bump cosign v2.6.3 + syft v1.45.1 + alpine 3.22
## [202606051643] — 2026-06-05
### Corrigé
- Supply-chain en multi-stage COPY --from= (CDN GitHub KO)
- Image kirexo-supply-chain pour cosign + syft
### Documentation
- Ajoute la règle « actions remote = script obligatoire »
- Corrige la syntaxe glab ci run dans tag.yml
## [202606051059] — 2026-06-05
### Ajouté
- Pipeline GitLab CI complète — qualité, builds, security, releases, supply chain
- Task runner Castor, hooks Claude, harnais de tests, dépendances
- Push HTTPS via glab credential helper
### Corrigé
- Cache vendor/ corrompu (bump prefix v2 + chown dans build:vendor)
- Pré-chauffage ipset api.anthropic.com pour Claude Code
- Security:secret-gate filtre les placeholders publics de dev
- Chdir vers la racine pour résoudre les chemins relatifs
### Documentation
- Pipeline CI, déploiement, signature cosign, SBOM, audit, cleanup registry
### Outillage & CI
- Couvre ToolsUpgrader::isDocumentedArg() (pipeline 99.56% → 100%)
- Bump glab 1.101.0 + Claude Code 2.1.163, skip SHA256 dans la doc
- Ci:local exécute les jobs Docker en local
- Valider l'étape 4 et journaliser l'apprentissage
- Cadrage de l'étape 4 — pipeline GitLab CI complète
- Whitelister github.com et raw.githubusercontent.com
- Autoriser glab issue create/close/note
- Ajouter laravel/pao pour des sorties dev plus compactes
- Bump glab 1.99, node 24.16, claude-code 2.1.150
## [étape-3] — 2026-05-19
### Correctifs rétrospective étape 3 — 2026-05-18
- **Fusion `FirewallWhitelistStore` → `FirewallWhitelist`** : une seule classe `src/DevContainer/FirewallWhitelist.php` combine désormais la logique pure statique (`isValidDomain`, `parseDomainLines`, `isAlreadyCovered` + constantes `DOMAIN_REGEX`, `DEFAULT_BASELINE_PATH`, `DEFAULT_LOCAL_PATH`) et les méthodes d'instance d'I/O fichier (`readBaseline`, `readLocal`, `readLocalRejected`, `isInBaseline`, `isInLocal`, `appendLocal`, `removeFromLocal`). La méthode `parseLocal` est **renommée `parseDomainLines`** pour aligner la sémantique avec le helper bash `firewall_parse_domain_lines` (`.devcontainer/init-firewall.lib.sh`).
- **Extraction de logique pure dans `ToolsUpgrader`** : `selectFrankenphpCandidate()` (sélection de tag candidat pour l'image base FrankenPHP, comparaison de tuples `(franken-major, php-major, php-minor)` + exclusion régression PHP) et `buildDockerfileUrls()` (reconstruction des URLs des `RUN curl …` à partir des `ARG *_VERSION`). Permet la couverture unitaire de `fetch_frankenphp_drift()` et de la sous-étape `host:check` HEAD HTTP sans réseau.
- **Section « Ce que l'isolation ne protège pas »** ajoutée dans [`docs/explanation/devcontainer.md`](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/explanation/devcontainer.md) entre « Comment ça marche — flow réseau » et « Pourquoi NE PAS monter `/var/run/docker.sock` ». Deux limites assumées documentées : exfiltration via l'API Anthropic (les credentials lus dans `${HOME}/.claude/.credentials.json` peuvent partir dans le contenu d'une requête vers `api.anthropic.com` légitimement whitelisté — le RO empêche la persistance entre sessions, pas l'exfiltration en session) et contournement potentiel via DNS-over-HTTPS (préférer des FQDNs précis, pas des suffixes génériques de CDN).
- **Contrôle négatif documentaire** : `203.0.113.1` (IP RFC 5737 TEST-NET-3, garantie non routable) remplace `example.com` dans le tutoriel [Ouvrir Kirexo dans un Dev Container PHPStorm](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/tutorials/devcontainer-phpstorm.md). Reste proche du modèle de menace (filtrage par socket, pas seulement par résolution DNS) et évite qu'un domaine de test finisse par accident dans la whitelist.
- **Références obsolètes à `init-firewall.sh` pour l'ajout de domaine** corrigées : `.devcontainer/AGENTS.md` et `.devcontainer/whitelist.local.txt.dist` pointent désormais vers `baseline-domains.txt` (source de vérité versionnée de la baseline) et `castor devcontainer:whitelist-add`. La whitelist n'est plus inlinée dans `init-firewall.sh`.
- **`castor devcontainer:check-tools` / `upgrade-tools` étendus au drift de l'image base FrankenPHP** : interrogation de Docker Hub (`hub.docker.com/v2/repositories/dunglas/frankenphp/tags/`), warning non bloquant dans `upgrade-tools` (le bump cible une instruction `FROM`, pas un `ARG` — donc manuel), compté dans le `exit 2` de `--check`. Couvre indirectement les paquets apt et `install-php-extensions` livrés via la base.
- **`castor host:check` étendu de 3 à 5 sous-étapes** : ajout de **hadolint** sur le `Dockerfile` (`docker run --rm -i hadolint/hadolint:latest hadolint --failure-threshold error - < Dockerfile`, seules les erreurs sont bloquantes ; warnings et info remontés mais tolérés) et de **HEAD HTTP en parallèle** sur les URLs construites par `ToolsUpgrader::buildDockerfileUrls()` à partir des `ARG *_VERSION` (Castor, glab, tarball Node, `SHASUMS256.txt`). Détecte une release upstream supprimée/renommée avant un rebuild qui rejetterait silencieusement un fichier corrompu via `sha256sum -c`. Coût observé : ~0.8 s en cache, ~3.5 s au premier appel (pull de l'image hadolint).
- **Documentation Diátaxis mise à jour** :
- [`docs/reference/devcontainer.md`](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/devcontainer.md) : `parseLocal()` → `parseDomainLines()` dans la ligne `baseline-domains.txt`, nouvelle section « Surveillance de l'image base FrankenPHP » sous l'outillage.
- [`docs/reference/commandes-castor.md`](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/commandes-castor.md) : descriptions de `host:check` (5 sous-étapes), `check-tools` et `upgrade-tools` enrichies du volet image base FrankenPHP.
- [`docs/explanation/devcontainer.md`](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/explanation/devcontainer.md) : section « Ce que l'isolation ne protège pas ».
### Ajouté
- `CHANGELOG.md` racine au format Keep a Changelog, exposé dans la doc Diátaxis en complément de la nav existante.
- **Dev Container** dérivé de [`dunglas/symfony-docker`](https://github.com/dunglas/symfony-docker) :
- `.devcontainer/devcontainer.json`, `compose.devcontainer.yaml`, `post-create.sh`, `post-start.sh`.
- Stack complète accessible depuis l'IDE (PHPStorm 2024.1+ ou VS Code) sans installer PHP/Node/Composer côté hôte.
- Stratégie d'isolation **sans socket Docker monté** — `castor docker:*`, `cert:trust`, `doctor`, `docs:build` refusent de tourner depuis l'intérieur (cf. `assert_outside_container()` dans `castor.php`).
- **Pare-feu interne** (`init-firewall.sh`) restreignant le trafic sortant à une whitelist de domaines :
- Policies `OUTPUT/INPUT/FORWARD DROP` posées immédiatement après le flush.
- `dnsmasq` + `ipset allowed-domains` alimentés à la volée à chaque résolution DNS.
- Plage CIDR intra-stack unique `172.30.0.0/24` (réseau Docker custom `kirexo`) au lieu des trois RFC1918.
- Override local `whitelist.local.txt` (gitignored) concaténé à la baseline si présent.
- Smoke-tests post-reload : contrôle négatif **bloquant** sur `203.0.113.1` (RFC 5737), contrôles positifs **non bloquants** sur `gitlab.com` / `symfony.com` / `packagist.org` / `registry.npmjs.org`, résolution intra-stack **bloquante**.
- **Mode `bypassPermissions` Claude Code** activé par `post-create.sh` via création de `.claude/settings.local.json`, avec opt-out :
- One-shot par variable d'environnement `KIREXO_CLAUDE_BYPASS=0`.
- Persistant par marqueur fichier `.devcontainer/no-claude-bypass` (gitignored).
- **Embarquement direct de Node + Claude Code** dans le stage `frankenphp_dev` du `Dockerfile` (et non via les `features` du devcontainer) pour contourner un bug du pipeline JetBrains qui re-cible le stage `frankenphp_dev` sur un Dockerfile temporaire.
- **Vérification d'intégrité par SHA-256** sur les binaires Castor, glab et Node (ARG `*_VERSION` + `*_SHA256`). Claude Code repose sur le `dist.integrity` SRI sha512 du registre npm.
- **`autocomplete Castor` system-wide** dans le devcontainer via `/etc/bash.bashrc` (sourcing de `bash-completion` + `eval "$(castor completion bash)"`).
- **Logique pure testable** extraite dans `src/DevContainer/` :
- `FirewallWhitelist` — validation FQDN, parsing baseline, dédoublonnage.
- `ToolsUpgrader` — extraction et substitution d'`ARG` dans le `Dockerfile` et la doc.
- **Nouvelles cibles Castor** (cf. `docs/reference/commandes-castor.md`) :
- `castor devcontainer:upgrade-tools [--check|--apply]` — résout les `latest` (Castor via GitHub API, glab via GitLab API, Node majeure LTS via `nodejs/Release/schedule.json`, Node patch via `nodejs.org/dist/index.json`, Claude Code via npm registry), recalcule les SHA-256, met à jour le `Dockerfile` et la doc.
- `castor devcontainer:firewall-reload` — wrapper sur `sudo init-firewall.sh`, refuse l'hôte.
- `castor devcontainer:whitelist-add <domain>` / `whitelist-remove <domain>` — édite `whitelist.local.txt` puis recharge le pare-feu, avec validation FQDN et dédoublonnage.
- `castor devcontainer:doctor` — pendant interne de `castor doctor` (vérifie l'amorçage, dnsmasq, l'ipset, FrankenPHP sur `127.0.0.1`, la résolution intra-stack, les migrations à jour).
- `castor devcontainer:frankenphp-restart` — relance le supervisor FrankenPHP après bail-out ou kill manuel.
- `castor lint:shell` — `shellcheck` sur les scripts `.devcontainer/*.sh` et `.claude/hooks/*.sh`, intégrée à `castor lint`.
- **Supervisor FrankenPHP** (`frankenphp-supervisor.sh`) avec backoff exponentiel borné (`INITIAL_DELAY=2`, `MAX_DELAY=30`) et bail-out après 5 crashs consécutifs sans stabilisation (>60s).
- **Marqueurs d'amorçage** `.devcontainer/.bootstrap.{ok,failed}` écrits par `post-create.sh` et consultés en première ligne par `castor devcontainer:doctor`.
- **Tests unitaires** :
- `FirewallWhitelistTest` — validation FQDN, parsing baseline et locale, dédoublonnage.
- `ToolsUpgraderTest` — extraction et substitution d'ARG, calcul du diff de versions.
- `FirewallRegexConsistencyTest` — garde-fou contre le drift entre la regex bash (`DOMAIN_VALIDATION_REGEX`) et la regex PHP (`FirewallWhitelist::DOMAIN_REGEX`) : égalité textuelle + dataset croisé `preg_match` ↔ `[[ =~ ]]`.
- **Documentation Diátaxis** :
- Tutoriel : [Ouvrir Kirexo dans un Dev Container PHPStorm](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/tutorials/devcontainer-phpstorm.md).
- Guides : [Whitelister un domaine](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/how-to/whitelister-un-domaine.md), [Debugger le pare-feu](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/how-to/debugger-le-pare-feu-devcontainer.md), [Activer l'autocomplétion Castor sur l'hôte](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/how-to/activer-lautocompletion-castor.md).
- Référence : [Dev Container](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/devcontainer.md).
- Explication : [Choix d'isolation du Dev Container](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/explanation/devcontainer.md).
- `.devcontainer/whitelist.local.txt.dist` versionné comme modèle pour le fichier d'override local.
### Modifié
- `assert_outside_container()` (`castor.php`) accepte désormais une suggestion contextuelle d'alternative ; `castor doctor` et `castor docs:build` lancés depuis l'intérieur du devcontainer affichent une commande utilisable directement (`castor devcontainer:doctor` et `curl -sIf http://localhost:8000/` respectivement) en plus du refus.
- `Dockerfile` (stage `frankenphp_dev`) : ajout de `sudo`, `iptables`, `ipset`, `dnsmasq`, `jq`, `iproute2`, `ca-certificates`, `shellcheck`, `bash-completion`. Création d'un user `app` aligné sur l'UID/GID hôte.
- `frankenphp/Caddyfile` : ajout de `skip_install_trust` au bloc global pour empêcher Caddy de tenter d'installer sa CA racine dans le trust store du conteneur (qui exigerait `sudo`).
- `compose.override.yaml` : définition d'un réseau Docker custom `kirexo` (`172.30.0.0/24`) + build args `USER_ID`/`GROUP_ID`.
### Sécurité
- `bypassPermissions` Claude Code rendu acceptable par l'addition de deux barrières structurelles : isolation filesystem (le conteneur ne voit que `/app`) + isolation réseau (pare-feu iptables sur whitelist). Sans ces deux barrières, ne pas reproduire ce paramétrage.
- GitHub volontairement **exclu** de la whitelist : le projet est hébergé sur GitLab, et les binaires GitHub indispensables (Castor, glab) sont récupérés au **build de l'image** via le réseau hôte, pas au runtime depuis le conteneur.
- **Durcissements post-audit** (4 mécanismes ajoutés en seconde passe, cf. [Référence](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/devcontainer.md)) :
- **Surcharge RO ciblée** sur `${HOME}/.claude/.credentials.json`, `${HOME}/.claude/settings.json` et `${HOME}/.claude/CLAUDE.md` — un Claude éventuellement compromis dans le conteneur ne peut plus *réécrire* ces fichiers (exfiltration via la prochaine session côté hôte impossible). L'historique de conversations (`projects/`, `sessions/`, `history.jsonl`) reste en RW pour rester persisté côté hôte.
- **Bind-mount RO** sur `init-firewall.sh`, `init-firewall.lib.sh`, `baseline-domains.txt` et `firewall-healthcheck.sh` — un sous-processus malveillant ne peut plus réécrire les scripts puis attendre le prochain reload pour s'exécuter en root via le sudoers NOPASSWD. Pour modifier ces fichiers, redémarrer le devcontainer.
- `security_opt: ["no-new-privileges:true"]` — empêche un binaire setuid/setgid d'élever ses droits dans le conteneur.
- **Healthcheck enrichi** d'une 4e condition `sudo -n /app/.devcontainer/firewall-healthcheck.sh` (wrapper read-only qui vérifie `iptables -S OUTPUT | grep -q '^-P OUTPUT DROP'`). Détecte un `iptables -F` manuel oublié qui laissait jusqu'ici le pare-feu silencieusement ouvert avec dnsmasq encore vert.
### Ajouté (post-audit)
- **Tests bats** dans `tests/Bash/firewall/` (43 tests, 3 fichiers) — couvrent les fonctions pures `firewall_is_valid_domain`, `firewall_parse_domain_lines`, `firewall_is_already_covered`. Premier lot de tests shell du projet ; convention bats documentée dans `tests/Bash/firewall/README.md`.
- `.devcontainer/init-firewall.lib.sh` — fonctions pures extraites de `init-firewall.sh` pour permettre les tests bats sans NET_ADMIN. La regex `FIREWALL_DOMAIN_REGEX` y est définie en `readonly`, partagée avec `App\DevContainer\FirewallWhitelist::DOMAIN_REGEX` côté PHP.
- `.devcontainer/firewall-healthcheck.sh` — wrapper sudo read-only utilisé par le healthcheck Docker pour valider que la policy `OUTPUT DROP` est toujours posée.
- **Cible Castor `test:bash`** + intégration dans `castor test` et `castor all` (entre `test:unit` et `test:e2e`). Lance `bats --recursive tests/Bash/` dans le conteneur.
- **Pare-feu activé dans `post-create.sh`** (avant `castor install`) — la phase d'amorçage Composer/importmap/Tailwind est maintenant filtrée par la whitelist au lieu de tourner avec un réseau ouvert.
- **Mermaid** activé dans mkdocs (`pymdownx.superfences` + `custom_fences`) — diagrammes du flow réseau (DNS → dnsmasq → ipset → iptables, cas rejet, ordre d'exécution) ajoutés dans `docs/explanation/devcontainer.md`.
- **`bats`** ajouté au stage `frankenphp_dev` du Dockerfile (paquet Debian, v1.x).
- **Auto-relance de FrankenPHP** via le healthcheck Docker du service `php` (devcontainer) — rattrape le cas où PhpStorm zappe le `postStartCommand` en s'attachant à un conteneur déjà démarré. Logique déportée dans `.devcontainer/php-healthcheck.sh` (bind-mount RO, deny-list Claude), avec deux garde-fous (`pgrep frankenphp-supervisor.sh` + lockfile mtime `RELAUNCH_MIN_INTERVAL=30s`), détachement via `setsid -f` et audit dans `var/log/devcontainer/frankenphp.log`. Cf. [Référence — Auto-relance de FrankenPHP](https://gitlab.com/shaurifr/kirexo/-/blob/main/docs/reference/devcontainer.md#auto-relance-de-frankenphp).
### Modifié (post-audit)
- `castor.php` allégé (1602 → 868 lignes) : extraction des cibles `devcontainer:*` + helpers associés dans `castor/devcontainer.php`, importé via `Castor\import()`. Inventaire des cibles identique (46), comportement inchangé.
- `init-firewall.sh` refactoré pour sourcer `init-firewall.lib.sh` — suppression des deux boucles inlinées de parsing baseline/locale, validation FQDN déléguée à `firewall_is_valid_domain`. Sémantique inchangée.
- `Dockerfile` (stage `frankenphp_dev`) : sudoers étendu à un **second** script (`firewall-healthcheck.sh`) en NOPASSWD — auparavant seul `init-firewall.sh` était autorisé.
- `compose.devcontainer.yaml` : ajout `security_opt`, 3 bind-mounts RO `${HOME}/.claude/*`, 5 bind-mounts RO `.devcontainer/*` (dont `php-healthcheck.sh`), healthcheck déporté dans `php-healthcheck.sh` (4 conditions enchaînées + auto-relance FrankenPHP).
- `.devcontainer/AGENTS.md` : pointer explicite vers `/CLAUDE.md` comme source de vérité primaire, rappel du quota 5 fichiers PHP et de la délégation obligatoire aux sous-agents.
### Défaut connu (à corriger en suivi)
- **`FIREWALL_DOMAIN_REGEX` accepte les IPs littérales** : la regex actuelle laisse passer `1.2.3.4` comme FQDN valide (labels purement numériques autorisés). La doc dit le contraire. Découvert pendant l'écriture des tests bats — le test verrouille le comportement actuel avec un commentaire pointant l'inversion à faire le jour où on durcit la regex (côté lib **et** côté `FirewallWhitelist::DOMAIN_REGEX` PHP, sinon `FirewallRegexConsistencyTest` cassera).
## [étape-2] — Cadrage, outillage et documentation
### Ajouté
- `castor.php` à la racine — task runner Castor, source unique des cibles de qualité et de développement (`cs:fix`, `phpstan`, `lint`, `test:unit`, `test:e2e`, `qa`, `all`, …).
- Documentation [Diátaxis](https://diataxis.fr/) initiale publiée via `mkdocs-material` (service `docs` du compose).
- `mkdocs.yml` à la racine + image custom `mkdocs/Dockerfile` (plugins `git-revision-date-localized` et `social`).
- Sous-agents Claude Code dans `.claude/agents/` (`reviewer`, `test-writer`, `doc-writer`) avec hooks de délégation et de comptage de fichiers PHP de production.
## [étape-1] — Bootstrap
### Ajouté
- Bootstrap du projet à partir de [`dunglas/symfony-docker`](https://github.com/dunglas/symfony-docker) (FrankenPHP + Symfony + Docker Compose).
- Services Postgres, Redis, RabbitMQ, Typesense, Gotenberg, Mailpit ajoutés au compose.
- `CLAUDE.md` initial — cadrage technique, patterns d'architecture (CQRS, plugins isolés, Voters, Live Components, DTOs immuables, Repository pattern), règles de développement.
[étape-3]: https://gitlab.com/shaurifr/kirexo/-/compare/v0.2.0...v0.3.0
[étape-2]: https://gitlab.com/shaurifr/kirexo/-/compare/v0.1.0...v0.2.0
[étape-1]: https://gitlab.com/shaurifr/kirexo/-/tags/v0.1.0
La configuration mkdocs (cf. mkdocs.yml) étend base_path à la racine du projet pour permettre cette inclusion, et check_paths: true fait échouer le build si le snippet est introuvable.
Règle : pas de liens Markdown relatifs¶
Interdit dans CHANGELOG.md : tout lien Markdown relatif vers une page de la doc, par exemple [Référence](docs/reference/worktrees.md).
Pourquoi : après inclusion via --8<--, le rendu du lien est résolu par mkdocs relativement à la page hôte (docs/changelog.md), pas relativement à la racine du dépôt. Un lien docs/reference/worktrees.md pointe alors vers docs/docs/reference/worktrees.md qui n'existe pas. mkdocs émet un warning, et comme mkdocs.yml est en strict: true, le build échoue avec un exit code 1 — le conteneur kirexo-docs-1 ne démarre plus.
Alternatives valides¶
Par ordre de préférence dans le contexte du CHANGELOG.md :
-
URL GitLab absolue vers le fichier sur la branche
main— style en place dans leCHANGELOG.md(cf. liens vers les pages de doc dans la section Documentation Diátaxis de la section[étape-3]) :Avantage : le lien fonctionne aussi bien depuis la page mkdocs que depuis la vue GitLab du
CHANGELOG.md(où la doc n'est de toute façon pas rendue). C'est le style à adopter par défaut. -
URL absolue vers la doc publiée (
https://doc.kirexo.app/...) — utilisable une fois la doc déployée publiquement. Même propriété : fonctionne dans les deux contextes de lecture (GitLab et mkdocs). -
Lien externe absolu (RFC, doc d'un projet tiers, etc.) — sans contrainte particulière, c'est le seul cas où on peut écrire un lien de manière naturelle.
Rappel in situ¶
Un commentaire HTML en tête du CHANGELOG.md racine renvoie vers cette page. Il est invisible dans le rendu mkdocs comme dans le rendu GitLab, mais visible pour tout contributeur (humain ou agent) qui ouvre le fichier pour l'éditer. Ne pas le supprimer.