kiln-cli 0.3.1__tar.gz → 0.3.2__tar.gz

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/CHANGELOG.md

@@ -5,6 +5,14 @@ changement visible (`- …`), cassants en tête. `kiln update` montre les entré
 qu'un projet passe ; la skill `base:version` rédige celle de la version qu'elle sort, sur la
 branche `release/vX.Y.Z`, avant sa première candidate.
 
+## v0.3.2 — 2026-10-16
+- `kiln adopt` fait suivre kiln à un repo existant, sans le régénérer ; le skill `adoption` trie avec l'utilisateur ce que la charte y trouve à redire, et l'ouverture de session le propose dans un repo à soi qui ne suit pas encore kiln.
+- Dérogations à la charte dans `kiln-waivers.toml`, avec un motif et une échéance croissante à chaque renouvellement : `kiln waive` les ajoute, renouvelle ou liste, `kiln update` épargne les fichiers figés et dit ce qu'il y aurait changé, `kiln status` compte celles de chaque repo.
+- Skill `relecture` : commits et diff d'une branche relus et rangés avant la fusion (`fusion` le lance), dépôt entier avant une version (`version` le lance) ; le hook `garde-branche` refuse un message de commit signé Claude.
+- Les questions de kiln en début de session suivent une politique commune : chaque « non » espace la suivante, chaque « oui » la rapproche.
+- `kiln --version` (#39, merci @SakarPaisen, première contribution extérieure).
+- Correctifs : `kiln update --all` dit « GitHub injoignable » en une ligne au lieu d'une trace Python, et un passage raté ne bloque plus le suivant avec un worktree laissé vide.
+
 ## v0.3.1 — 2026-10-16
 - **Cassant** : le suivi du travail passe en anglais, `docs/a-faire/` devient `docs/backlog/` (tickets `T-NN`, skill `base:backlog` à la place de `base:a-faire`) ; `kiln update` déplace l'ancien dossier.
 - Numérotation comme Claude Code : en 0.x, chaque version monte le correctif, cassante comprise ; la mineure ne monte que pour une étape (`kiln version --minor`). Une version est promue dès que la suivante est prête en candidate, sans délai d'attente.

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/CLAUDE.md

@@ -13,21 +13,21 @@ Où chercher, pour ne pas explorer ; à tenir à jour dans le commit qui ajoute,
 un dossier ou un module.
 
 - `src/kiln/` : la commande. `cli.py` (arguments) ; une commande par module : `new.py`,
-  `install.py`, `dev.py`, `check.py`, `settings.py` (`kiln set`, clés réglables), `update.py`,
+  `adopt.py` (`kiln adopt`, repo existant), `install.py`, `dev.py`, `check.py`, `settings.py` (`kiln set`, clés réglables), `waive.py` (`kiln waive`), `update.py`,
   `contract.py`, `release.py` (`kiln version`), `doctor.py` (diagnostic du poste et du repo), `fleet.py` (`status`, `update --all`) ; socle : `stack.py` (stack lue dans
   `.copier-answers.yml`), `template.py`, `deps.py`, `github.py`, `rules.py` (règles non
-  vérifiées), `statusline.py`, `versions.py` (tags, journal des versions), `banner.py` (bannière, écran d'accueil), `ui.py` (palette pierre et feu, étapes,
+  vérifiées), `statusline.py`, `versions.py` (tags, journal des versions), `frozen.py` (fichiers figés par `kiln-waivers.toml`, épargnés par `update`), `banner.py` (bannière, écran d'accueil), `ui.py` (palette pierre et feu, étapes,
   roue animée, bilan, succès, erreurs), `shell.py`, `config.py` (`~/.config/kiln/config.toml`).
 - `src/kiln/ci/` : `kiln ci` (CI rejouée sur le poste, verdict en note git) ;
   `src/kiln/charte/` : moteur de `charte` (`interdictions.py`, `cliquets.py`,
-  `outils_python.py`).
+  `outils_python.py`, `waivers.py` : dérogations de `kiln-waivers.toml`).
 - `copier.yml` : questions du modèle ; `template/` : le modèle (`CLAUDE.md.jinja`, chartes de
   `backend/` et `frontend/` par stack, `.claude/settings.json.jinja`, CI…) ; `macros.jinja`.
 - `plugins/` : plugins Claude Code, catalogue `.claude-plugin/marketplace.json` ; `base/`
-  (skills `worktree`, `fusion`, `version`, `nettoyage`, `backlog`, `maj-kiln`,
+  (skills `worktree`, `fusion`, `version`, `nettoyage`, `relecture` (commits et diff d'une branche avant la fusion, dépôt entier avant une version), `backlog`, `maj-kiln`, `adoption`,
   `report-to-kiln` (défaut de kiln remonté en issue ou PR), `token` (jeton d'un service dans
   `.<service>/`), `contribution` (PR d'un contributeur extérieur : sécurité, tri, revue,
-  fusion créditée) ; `hooks/` ; `scripts/statusline.py`),
+  fusion créditée) ; `hooks/` (dont `relances.py`, politique commune des questions de kiln) ; `scripts/statusline.py`),
   `pile-django/`, `pile-nuxt/`, `vps-podman/`, `stripe/`, `serena/`.
 - `.github/workflows/` : workflows réutilisables appelés par les repos générés, plus ceux de
   kiln (`kiln.yml` contrôles, `pypi.yml` publication du paquet `kiln-cli` au tag promu) ;
@@ -39,8 +39,9 @@ un dossier ou un module.
   promotion de version ; `docs/assets/` : images de la vitrine.
 - `tests/` : `test_modele.py` (rendu du modèle pour chaque stack), `test_cli.py` (la commande :
   accueil, erreurs, bilan, sorties hors terminal), `test_unites.py`,
-  `test_ci.py`, `test_flotte.py`, `test_deploiement.py`, `test_statusline.py` (choix du
-  poste et rendu du script), `test_plugins.py` (skills cités présents, nommés comme leur dossier).
+  `test_ci.py`, `test_flotte.py`, `test_waivers.py` (dérogations), `test_waive.py`, `test_deploiement.py`, `test_statusline.py` (choix du
+  poste et rendu du script), `test_plugins.py` (skills cités présents, nommés comme leur dossier), `test_garde_branche.py` (hook garde-branche), `test_adopt.py`,
+  `test_relances.py`, `test_hook_kiln_a_jour.py` ; `conftest.py` : config git du poste écartée, identité de test.
 
 ## Versions
 

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: kiln-cli
-Version: 0.3.1
+Version: 0.3.2
 Summary: Make Claude Code build production-grade repos, and keep them that way
 Project-URL: Homepage, https://github.com/antoine-tena/kiln
 Project-URL: Changelog, https://github.com/antoine-tena/kiln/blob/develop/CHANGELOG.md
@@ -61,7 +61,8 @@ keeps every repo you own current:
   per repo, small commits, merge only when the checks pass.
 - 📏 **`charte`** — a rule engine for things linters don't catch (no `pip`/`docker`, file-size
   ratchets, Django locks, personal-data patterns, coverage floors…), declared per repo in
-  `charte.toml`.
+  `charte.toml`. Disagree with a rule? `kiln waive` it in `kiln-waivers.toml`, with a reason and an
+  expiry that grows with each renewal (a week, a month, three months, six months).
 - 🤖 **Claude Code native** — every generated repo ships agent instructions and enables kiln's
   Claude Code plugins (branch guards, worktree/merge/release skills, status line).
 
@@ -154,13 +155,15 @@ make the opinions yours.
 | Command | What it does |
 |---|---|
 | `kiln new [dir]` | Questionnaire, generation, lockfiles, install, first commit on `main`, then `develop` where all work happens. |
+| `kiln adopt` | Bring an existing repo that kiln did not generate under kiln, on a work branch: `charte.toml` (size via `--size`, rules that apply anywhere, checked after each edit), `docs/backlog/` if missing, then the existing debt the charter finds. Never touches an existing file. |
 | `kiln install` | Set up a machine after a clone: tools, dependencies, `.env`, migrations, pre-commit. Re-runnable. |
 | `kiln dev` | Start the stack's dev servers, their output interleaved and prefixed by service in colour (`django │ …`); `--containers` runs everything in podman. |
 | `kiln check` | Ruff, mypy, pytest for each Python project, ESLint and type checks for the front, then `charte`. |
 | `kiln set [key=value…]` | Show or change the repo's settings (team, frameworks, podman…); the repo is re-rendered. |
+| `kiln waive [RULE\|file]` | Waive a kiln rule (`--paths`, `--reason`), or freeze a generated file so `kiln update` leaves it alone; `--renew` moves to the next tier (a week, a month, three months, six months). No argument: list the waivers. |
 | `kiln update` | Move to the latest kiln release (with a box listing what's new in each release crossed), compatible dependency upgrades, then checks. `--major`, `--no-template`, `--no-deps`. |
 | `kiln update --all` | Update every kiln repo in your code folder, one worktree each, merged only if checks pass. |
-| `kiln status` | Branch, clean tree, template release (`v0.3.2 → v0.3.5` when behind), stack — for every kiln repo. |
+| `kiln status` | Branch, clean tree, template release (`v0.3.2 → v0.3.5` when behind), waivers, stack — for every kiln repo, then the most waived rules across them. |
 | `kiln version` | In kiln's own repo: latest public release, candidates (age, adopting repos, ready to promote) and the number the next release should take. |
 | `kiln doctor` | Check the machine (git, uv, gh login, pnpm, podman, Java, pre-commit, kiln release, Claude plugin) and the current repo; each problem comes with the command that fixes it. Changes nothing. |
 | `kiln ci [commit]` | Replay the repo's GitHub CI locally against throwaway PostgreSQL/Redis, and push the verdict as a git note. |
@@ -195,7 +198,7 @@ claude plugin install base@kiln
 
 | Plugin | What's inside |
 |---|---|
-| `base` | Skills for the git workflow (`worktree`, `fusion` = merge, `version` = release, `nettoyage` = cleanup, `backlog`, `maj-kiln` = self-update), `report-to-kiln` (a kiln defect met in your repo becomes an issue or a PR, posted once you approve) `contribution` (an outside contributor's PR handled like a well-run open-source project: untrusted code read before anything runs, triage, review, a merge that credits them, nothing posted without your yes) and `token` (a service token pasted once into a git-ignored `.<service>/` folder, never shown); hooks that guard protected branches and files, check each edited file, and offer kiln updates at session start; a shared status line in four styles (`kiln set statusline=…`, or `aucune` / `perso` to keep your own); condensed command output with [rtk](https://github.com/rtk-ai/rtk). |
+| `base` | Skills for the git workflow (`worktree`, `fusion` = merge, `version` = release, `nettoyage` = cleanup, `relecture` = review of a branch's commits before they go public, and of the whole repo before a release, `backlog`, `maj-kiln` = self-update, `adoption` = bring an existing repo under kiln), `report-to-kiln` (a kiln defect met in your repo becomes an issue or a PR, posted once you approve) `contribution` (an outside contributor's PR handled like a well-run open-source project: untrusted code read before anything runs, triage, review, a merge that credits them, nothing posted without your yes) and `token` (a service token pasted once into a git-ignored `.<service>/` folder, never shown); hooks that guard protected branches and files, refuse a commit message signed by Claude, check each edited file, and ask at session start: kiln updates in kiln repos, adoption in your other repos ("Yes", "Later", "Never for this repo"), all paced by one goodwill score that each yes raises and each no lowers; a shared status line in four styles (`kiln set statusline=…`, or `aucune` / `perso` to keep your own); condensed command output with [rtk](https://github.com/rtk-ai/rtk). |
 | `pile-django` | Migrations, API regeneration, read-only PostgreSQL. |
 | `pile-nuxt` | Nuxt / Vue / Vitest skills, UI polish, screenshots on three phones and a desktop (Playwright). |
 | `vps-podman` | Deploy, production logs, production dumps. |

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/README.fr.md

@@ -30,12 +30,17 @@ Les plugins Claude Code vivent dans [`plugins/`](plugins/), catalogue `kiln`
 ([`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)) :
 
 - `base`, pour tous les projets, installé au niveau utilisateur : skills `worktree`, `fusion`,
-  `version` (release/vN, contrôle complet, annonce, main tagué, déploiement), `nettoyage`, `backlog`,
-  `maj-kiln` (l'outil kiln et ses plugins, puis le repo ouvert), `report-to-kiln` (un défaut de kiln remonté en issue ou en PR, avec l'accord de l'utilisateur), `contribution` (la PR d'un contributeur extérieur : code relu avant d'en rien lancer, tri, revue, fusion qui le crédite, rien publié sans accord) ; hooks garde de branche, fichiers protégés, contrôle du fichier
-  modifié, mise à jour proposée à l'ouverture de session (oui/non : l'outil kiln s'il est en
-  retard sur GitHub, puis le repo par `kiln update` ; un « non » repousse la question de 5, 10,
-  30 puis 50 sessions, après quoi désinstaller kiln ou délier le repo est proposé ;
-  `git config kiln-a-jour.desactive true` pour s'en passer), sorties de commandes condensées par [rtk](https://github.com/rtk-ai/rtk) quand il
+  `version` (release/vN, contrôle complet, annonce, main tagué, déploiement), `nettoyage`,
+  `relecture` (commits et diff d'une branche relus et rangés avant la fusion, dépôt entier avant une version), `backlog`,
+  `maj-kiln` (l'outil kiln et ses plugins, puis le repo ouvert), `adoption` (`kiln adopt` dans un repo existant, passif de la charte trié avec l'utilisateur), `report-to-kiln` (un défaut de kiln remonté en issue ou en PR, avec l'accord de l'utilisateur), `contribution` (la PR d'un contributeur extérieur : code relu avant d'en rien lancer, tri, revue, fusion qui le crédite, rien publié sans accord) ; hooks garde de branche (et refus d'un message de commit signé Claude), fichiers protégés, contrôle du fichier
+  modifié, questions à l'ouverture de session : dans un repo kiln, sa mise à jour (l'outil kiln s'il
+  est en retard sur GitHub, puis le repo par `kiln update` ; un « non » repousse la question de
+  5, 10, 30 puis 50 sessions, après quoi désinstaller kiln ou délier le repo est proposé) ; dans
+  un repo à soi qui ne suit pas kiln, son adoption (« Oui », « Plus tard », « Jamais pour ce
+  repo »), dès la 3e session, au plus une fois toutes les 10 sessions du poste. Toutes passent
+  par `relances.py` : une note de bienveillance du poste monte à chaque « oui » et baisse à
+  chaque « non », et étire ou raccourcit tous les délais (doublés au plus méfiant, de moitié au
+  plus enthousiaste) ; `git config kiln-a-jour.desactive true` pour s'en passer, sorties de commandes condensées par [rtk](https://github.com/rtk-ai/rtk) quand il
   est installé (`mise use -g github:rtk-ai/rtk`, sans `rtk init` : le hook est fourni ici) ; MCP context7 ; status line commune (`plugins/base/scripts/statusline.py`,
   en anglais, aux couleurs de kiln), posée par `kiln install` dans `~/.claude/settings.json` ; son
   style se choisit par poste : `kiln set statusline=sobre|bandeau|classique|classique-fond`,
@@ -84,16 +89,18 @@ système du poste (Linux, WSL ou macOS) et le garde dans `~/.config/kiln/config.
 | Commande | Rôle |
 |---|---|
 | `kiln new [dossier]` | Questionnaire (envergure, type de projet, stack conseillée, podman…), génération, verrous, installation, premier commit sur `main`, puis `develop` où tout le travail se fait. |
+| `kiln adopt` | Fait suivre kiln à un repo existant qu'il n'a pas généré, sur une branche de travail : `charte.toml` (envergure par `--size`, règles valables partout, vérifiées après chaque édition), `docs/backlog/` s'il n'existe pas, puis le passif que la charte relève. Ne touche à aucun fichier existant ; le repo apparaît dans `kiln status` comme adopté, `kiln update` le laisse. |
 | `kiln install` | Prépare un poste après un clone : outils (pre-commit avec pre-commit-uv, podman-compose), dépendances, `backend/.env`, migrations, pre-commit. Relançable. |
 | `kiln dev` | Lance les serveurs de la stack, leurs sorties entrelacées et préfixées par service en couleur (`django │ …`) ; `--containers` : toute la pile dans podman. |
 | `kiln check` | Ruff, mypy et pytest pour chaque projet Python, ESLint et les types côté front, puis la charte. |
 | `kiln ci [commit]` | Rejoue sur le poste la CI du `ci.yml` pour ce commit (défaut `HEAD`) et pose le verdict en note git sur origin, que le script de déploiement accepte comme une CI verte. `--statut` : le verdict seul. Voir « CI rejouée sur le poste ». |
 | `kiln contrat` | Django + Nuxt : exporte `openapi.json` depuis le code, puis régénère les types du front (`app/types/api.d.ts`). `kiln update` le fait aussi. |
+| `kiln waive [RÈGLE\|fichier]` | Déroge à une règle de kiln (`--paths`, `--reason`, `--upstream`), ou fige un fichier généré que `kiln update` ne touchera plus ; `--renew` passe au palier suivant (une semaine, un mois, trois mois, six mois), `--permanent` sans échéance. Sans argument : liste les dérogations. Voir [Moteur de charte](#moteur-de-charte). |
 | `kiln set` | Dans un repo : sans argument, affiche ses paramètres ; `kiln set clé=valeur…` les change (équipe, frameworks, podman, boussole…) : le repo est régénéré, un framework retiré emporte ses fichiers. Hors d'un repo, ou avec `--poste` : les réglages du poste (`systeme`, `proprietaire`, `equipe`, `dossier_code`, dans `~/.config/kiln/config.toml`). |
 | `kiln update` | Évolutions du modèle, mises à jour compatibles des dépendances, puis contrôles. `--major` : versions majeures comprises. `--no-template`, `--no-deps` pour n'en faire qu'une partie. |
 | `kiln update --all` | Tous les repos kiln du dossier de code (`~/code`, réglable par `dossier_code`) : pour chacun, un worktree depuis la branche d'intégration, la mise à jour, des commits de dix fichiers au plus, puis la fusion directe dans l'intégration (commit de fusion poussé) ; contrôles en échec, la branche est poussée sans être fusionnée. L'arbre principal ne change jamais de branche. |
 | `kiln doctor` | Diagnostic du poste (git, uv, gh connecté, pnpm, podman, Java, pre-commit, version de kiln, plugin Claude, configuration) et du repo courant (version du modèle, crochet pre-commit, dépendances, `backend/.env`) : ✓, ! à regarder ou ✗ bloquant, chaque fois avec la commande qui corrige. Ne modifie rien. |
-| `kiln status` | État des repos kiln du dossier de code : branche, arbre propre ou non, version du modèle (`v0.3.2 → v0.3.5` en retard), stack. |
+| `kiln status` | État des repos kiln du dossier de code : branche, arbre propre ou non, version du modèle (`v0.3.2 → v0.3.5` en retard), dérogations (`!` si l'une est échue), stack ; puis les règles dérogées, par nombre de repos. |
 | `kiln version` | Dans le dépôt de kiln : dernière version publique, candidates (âge, repos qui les ont adoptées, prêtes à promouvoir) et numéro de la prochaine. |
 | `charte` | Vérifie le repo contre son `charte.toml` (`charte --detail`, `charte types`, `charte couverture`). |
 
@@ -256,6 +263,27 @@ docstring de chaque règle. Règle propre à un repo : un module listé dans `re
 avec `verifier(depot, params) -> list[str]`. La liste des règles non vérifiées
 (`scripts/ci/charte-non-verifiee.txt`) est recalculée par kiln à chaque `set` et `update`.
 
+Dérogations : `kiln-waivers.toml` à la racine du repo (jamais réécrit par kiln) écarte une
+règle de tout le repo ou de certains chemins (`[[waiver]]` : `rule`, `paths`, `reason`, `by`,
+`since`, `until`, `renewals`). Une semaine au plus la première fois, puis un mois, trois mois,
+six mois à chaque renouvellement ; `until = "never"` pour un écart permanent, toujours affiché.
+`charte` liste les dérogations actives, prévient dans la seconde moitié de la période, et
+échoue sur une dérogation échue, mal formée, qui ne vise plus rien, ou qui porte sur une règle
+non dérogeable (`DONNEES-PERSO`, `SECRETS`, `PAS-SUR-MAIN`, `DEPENDANCES-FIGEES`).
+Une dérogation `file = "…"` (au lieu de `rule`) fige un fichier généré : `kiln update` et
+`kiln set` n'y touchent plus, et `kiln update` montre ce que kiln y a changé entre les deux
+versions, à reporter à la main ou à reprendre en levant la dérogation.
+
+```toml
+[[waiver]]
+rule = "TAILLE-FICHIER"
+paths = ["backend/app/import_x/*.py"]
+reason = "module repris tel quel du projet X, découpage prévu au T-31"
+by = "antoine"
+since = 2026-10-16
+until = 2026-10-23
+```
+
 ## Workflows réutilisables
 
 kiln est public : ses workflows servent à n'importe quel dépôt, quel que soit son compte

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/README.md

@@ -37,7 +37,8 @@ keeps every repo you own current:
   per repo, small commits, merge only when the checks pass.
 - 📏 **`charte`** — a rule engine for things linters don't catch (no `pip`/`docker`, file-size
   ratchets, Django locks, personal-data patterns, coverage floors…), declared per repo in
-  `charte.toml`.
+  `charte.toml`. Disagree with a rule? `kiln waive` it in `kiln-waivers.toml`, with a reason and an
+  expiry that grows with each renewal (a week, a month, three months, six months).
 - 🤖 **Claude Code native** — every generated repo ships agent instructions and enables kiln's
   Claude Code plugins (branch guards, worktree/merge/release skills, status line).
 
@@ -130,13 +131,15 @@ make the opinions yours.
 | Command | What it does |
 |---|---|
 | `kiln new [dir]` | Questionnaire, generation, lockfiles, install, first commit on `main`, then `develop` where all work happens. |
+| `kiln adopt` | Bring an existing repo that kiln did not generate under kiln, on a work branch: `charte.toml` (size via `--size`, rules that apply anywhere, checked after each edit), `docs/backlog/` if missing, then the existing debt the charter finds. Never touches an existing file. |
 | `kiln install` | Set up a machine after a clone: tools, dependencies, `.env`, migrations, pre-commit. Re-runnable. |
 | `kiln dev` | Start the stack's dev servers, their output interleaved and prefixed by service in colour (`django │ …`); `--containers` runs everything in podman. |
 | `kiln check` | Ruff, mypy, pytest for each Python project, ESLint and type checks for the front, then `charte`. |
 | `kiln set [key=value…]` | Show or change the repo's settings (team, frameworks, podman…); the repo is re-rendered. |
+| `kiln waive [RULE\|file]` | Waive a kiln rule (`--paths`, `--reason`), or freeze a generated file so `kiln update` leaves it alone; `--renew` moves to the next tier (a week, a month, three months, six months). No argument: list the waivers. |
 | `kiln update` | Move to the latest kiln release (with a box listing what's new in each release crossed), compatible dependency upgrades, then checks. `--major`, `--no-template`, `--no-deps`. |
 | `kiln update --all` | Update every kiln repo in your code folder, one worktree each, merged only if checks pass. |
-| `kiln status` | Branch, clean tree, template release (`v0.3.2 → v0.3.5` when behind), stack — for every kiln repo. |
+| `kiln status` | Branch, clean tree, template release (`v0.3.2 → v0.3.5` when behind), waivers, stack — for every kiln repo, then the most waived rules across them. |
 | `kiln version` | In kiln's own repo: latest public release, candidates (age, adopting repos, ready to promote) and the number the next release should take. |
 | `kiln doctor` | Check the machine (git, uv, gh login, pnpm, podman, Java, pre-commit, kiln release, Claude plugin) and the current repo; each problem comes with the command that fixes it. Changes nothing. |
 | `kiln ci [commit]` | Replay the repo's GitHub CI locally against throwaway PostgreSQL/Redis, and push the verdict as a git note. |
@@ -171,7 +174,7 @@ claude plugin install base@kiln
 
 | Plugin | What's inside |
 |---|---|
-| `base` | Skills for the git workflow (`worktree`, `fusion` = merge, `version` = release, `nettoyage` = cleanup, `backlog`, `maj-kiln` = self-update), `report-to-kiln` (a kiln defect met in your repo becomes an issue or a PR, posted once you approve) `contribution` (an outside contributor's PR handled like a well-run open-source project: untrusted code read before anything runs, triage, review, a merge that credits them, nothing posted without your yes) and `token` (a service token pasted once into a git-ignored `.<service>/` folder, never shown); hooks that guard protected branches and files, check each edited file, and offer kiln updates at session start; a shared status line in four styles (`kiln set statusline=…`, or `aucune` / `perso` to keep your own); condensed command output with [rtk](https://github.com/rtk-ai/rtk). |
+| `base` | Skills for the git workflow (`worktree`, `fusion` = merge, `version` = release, `nettoyage` = cleanup, `relecture` = review of a branch's commits before they go public, and of the whole repo before a release, `backlog`, `maj-kiln` = self-update, `adoption` = bring an existing repo under kiln), `report-to-kiln` (a kiln defect met in your repo becomes an issue or a PR, posted once you approve) `contribution` (an outside contributor's PR handled like a well-run open-source project: untrusted code read before anything runs, triage, review, a merge that credits them, nothing posted without your yes) and `token` (a service token pasted once into a git-ignored `.<service>/` folder, never shown); hooks that guard protected branches and files, refuse a commit message signed by Claude, check each edited file, and ask at session start: kiln updates in kiln repos, adoption in your other repos ("Yes", "Later", "Never for this repo"), all paced by one goodwill score that each yes raises and each no lowers; a shared status line in four styles (`kiln set statusline=…`, or `aucune` / `perso` to keep your own); condensed command output with [rtk](https://github.com/rtk-ai/rtk). |
 | `pile-django` | Migrations, API regeneration, read-only PostgreSQL. |
 | `pile-nuxt` | Nuxt / Vue / Vitest skills, UI polish, screenshots on three phones and a desktop (Playwright). |
 | `vps-podman` | Deploy, production logs, production dumps. |

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/docs/backlog/backlog.md

@@ -22,7 +22,7 @@ North star: **kiln v0.3.0 public, adopted by every generated repo**.
     Why, what to do (as a `- [ ]` checklist when there are several steps), where to look.
 
 - **ID** `T-NN`: stable, never reused, quoted as is in commits and branches (tickets opened
-  before 16 October 2026 were `AF-NN`, same number). **Next free: T-14.**
+  before 16 October 2026 were `AF-NN`, same number). **Next free: T-18.**
 - **Type**, one of: `bug` (something is broken); `improvement` (it works, it could work
   better); `idea` (nothing exists yet, to be explored); `task` (work that is neither: a release,
   a decision, a check).
@@ -41,39 +41,28 @@ North star: **kiln v0.3.0 public, adopted by every generated repo**.
 
 ## 🔴 Critical
 
-### T-01 · Promote v0.3.0, the first public release
+### T-14 · Promote v0.3.1, the first release on PyPI
 - **Type**: task
-- **Status**: blocked — waiting for a next candidate (no waiting period, antoine 2026-10-16)
-- **Opened**: 2026-10-15
+- **Status**: blocked — waiting for `v0.3.2-rc.1`
+- **Opened**: 2026-10-16
 - **Effort**: S · **Owner**: Claude · **Due**: —
-- **Origin**: move to semver and release candidates, 15 October 2026
-
-`v0.3.0-rc.1` (branch `release/v0.3.0`) is adopted by annway, sweep and vision. The rule
-(CLAUDE.md, "Versions") requires a next candidate ready, nothing more.
-`kiln version` says when it is ready.
-- [ ] Cut `v0.3.1-rc.1` from `develop` (gitleaks in CI, the `status` column, the `doctor` fix
-  are already there), then `kiln update --all`: annway must no longer conflict on `ci.yml`
-  (its gitleaks job is now in the template, identical).
-- [ ] As soon as `v0.3.1-rc.1` is out: tag `v0.3.0` on the commit of `v0.3.0-rc.1`, merge
-  `release/v0.3.0` into `main`, merge back into `develop`, then `kiln update --all`.
-- [ ] Check the public install: `uv tool install git+https://github.com/antoine-tena/kiln@main`
-  (the default branch stays `develop`, so install docs quote `@main`).
+- **Origin**: promotion of v0.3.0, 16 October 2026
+
+`v0.3.0` has no PyPI workflow: `kiln-cli` is first published when `v0.3.1` is promoted. The
+`PYPI_TOKEN` secret (environment `pypi`, account-wide token in `.pypi/token`) is set.
+- [ ] Cut `v0.3.2-rc.1` from `develop`; its `CHANGELOG.md` entry credits the first outside
+  contribution: `kiln --version` (#39, thanks @SakarPaisen). Then `kiln update --all`.
+- [ ] Promote `v0.3.1` (tag on the commit of `v0.3.1-rc.1`, merge into `main`, back into
+  `develop`), check the `pypi` run, then `uv tool install kiln-cli` on a clean machine.
+- [ ] Replace the account-wide token with one scoped to `kiln-cli`
+  (https://pypi.org/manage/project/kiln-cli/settings/), update the secret, delete the old one.
+- [ ] README (English and French): `uv tool install kiln-cli` as the main install.
 
 ## 🟠 Important
 
-### T-02 · Review PR #39 (`kiln --version`) from an outside contributor
-- **Type**: task
-- **Status**: todo
-- **Opened**: 2026-10-15
-- **Effort**: XS · **Owner**: Claude · **Due**: —
-- **Origin**: https://github.com/antoine-tena/kiln/pull/39 (issue #35)
-
-The displayed version now comes from `versions.installed_version()`: the PR must use it.
-Only antoine-tena merges a PR (CONTRIBUTING.md); answer quickly and say thanks.
-
 ### T-03 · Launch kiln publicly, then list it in the Claude Code directories
 - **Type**: task
-- **Status**: blocked — waiting for T-01, T-11 and T-06
+- **Status**: blocked — waiting for T-14 and T-06
 - **Opened**: 2026-10-15
 - **Effort**: S · **Owner**: antoine · **Due**: —
 - **Origin**: GitHub showcase, 15 October 2026; "Claude Code's workshop" positioning,
@@ -93,27 +82,6 @@ comes first. Posts are made by antoine, never without them; Claude drafts the te
   Code): https://clau.de/plugin-directory-submission — after T-06, French plugins are
   unlikely to get in.
 
-### T-11 · Publish kiln on PyPI as `kiln-cli`
-- **Type**: improvement
-- **Status**: todo
-- **Opened**: 2026-10-16
-- **Effort**: S · **Owner**: Claude (antoine for the PyPI account) · **Due**: —
-- **Origin**: distribution, 16 October 2026
-
-The name `kiln` is taken on PyPI; the package is `kiln-cli`, the command stays `kiln`. Only
-the command goes through PyPI: the template, plugins and workflows are still read from the git
-repo at the tag (Copier, Claude Code and GitHub Actions cannot read PyPI). Targets: macOS,
-Linux and Windows through WSL; native Windows is out of scope (antoine's call, 16 October
-2026).
-- [ ] Rename the distribution to `kiln-cli` in `pyproject.toml`, and add a `kiln-cli` command
-  (same entry point) so that `uvx kiln-cli new` works.
-- [ ] `installed_version()`, `kiln doctor` and `maj-kiln`: read the version and offer the
-  update through PyPI (`uv tool upgrade kiln-cli`), keeping the install from git.
-- [ ] Publishing workflow on the promotion tag, with trusted publishing (no token); antoine
-  creates the pending project on https://pypi.org/manage/account/publishing/
-- [ ] README (English and French): `uv tool install kiln-cli`, `uvx kiln-cli new`, and the line
-  "macOS, Linux, Windows via WSL".
-
 ### T-12 · Homebrew formula in an `antoine-tena/homebrew-kiln` tap
 - **Type**: improvement
 - **Status**: blocked — waiting for demand (an issue asking for it) or homebrew-core notability
@@ -222,7 +190,15 @@ has even when the repo edited it; its content is still in the last commit.
 
 plumbum or Copier fails if pytest runs in the main tree in the middle of a merge while a
 worktree exists: run the tests in a clean worktree, or make the template test independent of
-the tree's state.
+the tree's state. Seen again on 16 October 2026 (merge of `feat/relecture`, briefly filed as
+T-17): 97 tests fail with `fatal: No url found for submodule path
+'.claude/worktrees/chore-versions' in .gitmodules`; the same commit passes in a clean
+worktree. Lead to check: with a dirty template, Copier copies it and runs `git add -A`, which
+takes the nested worktrees as gitlinks; `.claude/worktrees/` is only ignored in
+`.git/info/exclude`, which the copy does not carry.
+- [ ] Reproduce, confirm the cause.
+- [ ] Fix: `.claude/worktrees/` in kiln's `.gitignore`, or tests that render from a clean
+  source (`vcs_ref="HEAD"` as in `test_deploiement.py`).
 
 ### T-10 · Interface polish
 - **Type**: improvement
@@ -237,6 +213,23 @@ the tree's state.
 
 ## ✅ Done
 
+- **2026-10-16** · T-16 · A failed `kiln update --all` leaves a worktree that blocks the next
+  run — a worktree with no change and no commit of its own is removed after the failure and
+  before the next run; one with work in it is kept and named (`fix/update-reseau`) · opened 2026-10-16
+- **2026-10-16** · T-15 · `kiln update --all` crashes with a Python traceback when GitHub is
+  unreachable — Copier's git failure becomes one line in the summary, "GitHub injoignable"
+  when the network is down (`fix/update-reseau`) · opened 2026-10-16
+- **2026-10-16** · T-11 · Publish kiln on PyPI as `kiln-cli` — distribution and `kiln-cli`
+  command, install source and update through PyPI, `pypi.yml` on the promotion tag, README;
+  the first upload is checked by T-14 · opened 2026-10-16
+
+- **2026-10-16** · T-01 · Promote v0.3.0, the first public release — `v0.3.1-rc.1` cut, then
+  `v0.3.0` tagged on the commit of `v0.3.0-rc.1`, merged into `main`, back into `develop`;
+  annway, sweep and vision moved to `v0.3.1-rc.1` (`kiln update --all`) · opened 2026-10-15
+- **2026-10-16** · T-02 · Review PR #39 (`kiln --version`) from an outside contributor —
+  reviewed with the new skill `base:contribution`, version computed only on demand (commit
+  pushed on top of the contributor's), merged (`b71f91a`), issue #35 closed; credit to add to
+  the next changelog entry (T-01) · opened 2026-10-15
 - **2026-10-16** · Backlog in English: `docs/a-faire/` becomes `docs/backlog/` (`backlog.md`,
   `rejected.md`, `urgent.md`), `T-NN` tickets with a type and an opening date, skill
   `base:backlog`, status line reading both formats, old trackers converted by `kiln update`

{kiln_cli-0.3.1 → kiln_cli-0.3.2}/plugins/base/hooks/garde-branche.py

@@ -1,5 +1,7 @@
 #!/usr/bin/env python3
-"""PreToolUse (Bash) : refuse un `git commit` sur une branche principale (main, master, develop).
+"""PreToolUse (Bash) : refuse un `git commit` sur une branche principale (main, master, develop),
+et un message de commit qui signe Claude (`Co-Authored-By: Claude`, `Claude-Session:`) :
+une fois poussé dans l'intégration, il ne s'efface plus.
 
 Seule exception : le commit qui conclut une fusion en cours (MERGE_HEAD présent), par exemple
 après la résolution d'un conflit de `git merge --no-ff`.
@@ -8,11 +10,13 @@ Un repo où l'on commite directement sur la branche principale s'en exempte par
 `git config garde-branche.desactive true`.
 """
 
+import contextlib
 import json
 import os
 import re
 import subprocess
 import sys
+from pathlib import Path
 
 PROTECTED_BRANCHES = {"main", "master", "develop"}
 
@@ -35,6 +39,21 @@ for part in re.split(r"&&|\|\||[;|\n]", cmd):
         c = re.findall(r"-C\s+(\S+)", m.group(1))
         targets.append(os.path.join(cwd, *(p.strip("'\"") for p in c)) if c else cwd)
 
+# Le message est dans la commande (-m, heredoc) ou dans un fichier (-F, --file).
+SIGNATURE = re.compile(r"co-authored-by:\s*claude|claude-session:", re.I)
+if targets:
+    message = cmd
+    for path in re.findall(r"(?:-F\s*|--file[=\s])(\S+)", cmd):
+        with contextlib.suppress(OSError):
+            message += Path(cwd, path.strip("'\"")).read_text()
+    if SIGNATURE.search(message):
+        print(
+            "Commit refusé : pas de Co-Authored-By: Claude ni de Claude-Session: "
+            "dans un message de commit. Les retirer.",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
 for target in targets:
     try:
         branch = subprocess.run(