baldart 3.21.1 → 3.21.2

package/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to BALDART will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.21.2] - 2026-05-26
+
+Aggiunto un livello di automazione che intercetta il drift fra la skill `/baldart-update` (v3.21.0+) e le sorgenti CLI che essa replica in chat. La skill replica **5 decision point fissi** del comando `npx baldart update`; quando una release tocca `src/commands/update.js` (nuovi prompt), `src/utils/hooks.js` (nuove entry in `HOOK_REGISTRY`), o `framework/templates/baldart.config.template.yml` (nuove top-level key), la skill può silenziosamente disallinearsi. Il bug v3.21.0 → v3.21.1 (`git -C .framework fetch` errato) è già stato un esempio del problema: la skill prometteva un pattern che il test live ha smentito. Senza un meccanismo di alert, futuri drift sarebbero individuabili solo per accidente.
+
+### Added — Drift detection script
+
+- **[scripts/check-update-skill-drift.js](scripts/check-update-skill-drift.js)**: Node script standalone (no dipendenze) che misura:
+  - Numero di prompt interattivi in `src/commands/update.js` (regex `await confirm(` + `inquirer.prompt(`).
+  - Numero di entry attive in `HOOK_REGISTRY` di `src/utils/hooks.js` (linee `id: 'baldart-...'` non commentate).
+  - Elenco delle top-level key in `framework/templates/baldart.config.template.yml`.
+  Confronta con i valori attesi salvati nel marker `<!-- DRIFT-CHECK ... -->` dentro lo SKILL.md della skill, e stampa un report human-readable. Exit code sempre 0 — drift è warning, non errore: la decisione finale resta umana.
+
+### Added — Marker DRIFT-CHECK nello SKILL.md
+
+- **[framework/.claude/skills/baldart-update/SKILL.md](framework/.claude/skills/baldart-update/SKILL.md)**: HTML comment in cima (subito dopo il frontmatter) con i conteggi/key attesi e il campo `last_verified` (versione in cui l'allineamento è stato confermato). Il marker è invisibile al consumer (HTML comment) ma viene letto dallo script.
+
+### Added — GitHub Actions workflow
+
+- **[.github/workflows/check-update-skill-drift.yml](.github/workflows/check-update-skill-drift.yml)**: workflow CI triggered su tre eventi:
+  - `push tags: v*.*.*` (ogni release).
+  - `pull_request` su `main` con paths filter sui file rilevanti (update.js, hooks.js, config template, SKILL.md, drift script).
+  - `workflow_dispatch` (lancio manuale).
+  Esegue lo script e annota eventuali drift come GitHub warnings (`::warning::`). Job non blocca mai il merge / la release.
+
+### Schema change propagation
+
+Nessuna nuova chiave in `baldart.config.yml`, nessuna modifica al CLI. La modifica è puramente CI/dev tooling.
+
+### Versioning rationale
+
+PATCH (3.21.1 → 3.21.2) per la decision tree di [MAINTAINING.md](MAINTAINING.md): tooling interno, nessun cambio di behaviour CLI, nessun consumer-facing impact. Il marker HTML nello SKILL.md è invisibile al consumer.
+
+### Verification
+
+Eseguito localmente: `node scripts/check-update-skill-drift.js` riporta baseline attuale `update_js_prompts=6, hook_registry_entries=3, config_template_top_level_keys=[features, git, identity, lsp, paths, stack, tools, version]` e "No drift detected" — coerente col marker `last_verified: v3.21.2`.
+
 ## [3.21.1] - 2026-05-26
 
 Fix del Step 0 e Step 1 della skill `/baldart-update` introdotta in v3.21.0. La prima release usava `git -C .framework fetch origin main` per il pre-flight check del numero di commit ahead — pattern **sbagliato** perché `.framework/` è un git subtree all'interno del repo consumer, non un git repo separato: i comandi `git` eseguiti con `-C .framework` ricadono sul `.git` del consumer e fetcherebbero il remote del CONSUMER (es. `github.com/antbald/mayo`), non quello di BALDART. Bug individuato durante test live su `mayo` (l'output mostrava `Da https://github.com/antbald/mayo  * branch  main -> FETCH_HEAD` invece di BALDART).

package/VERSION

@@ -1 +1 @@
-3.21.1
+3.21.2

package/framework/.claude/skills/baldart-update/SKILL.md

@@ -4,6 +4,21 @@ description: "Guidance for updating BALDART framework to the latest version in a
 contamination_scan: skip
 ---
 
+<!--
+DRIFT-CHECK
+This block is read by scripts/check-update-skill-drift.js (triggered by
+.github/workflows/check-update-skill-drift.yml on push tag v*.*.* and
+pull_request). When any of the numbers below changes against the actual
+sources, a warning is surfaced in the workflow run. The decision whether
+this skill needs an update is left to a human reviewer.
+
+update_js_prompts: 6
+hook_registry_entries: 3
+config_template_top_level_keys: features,git,identity,lsp,paths,stack,tools,version
+last_verified: v3.21.2
+-->
+
+
 # /baldart-update — Update framework in this consumer
 
 Guide the user through an update of the BALDART framework inside their

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baldart",
-  "version": "3.21.1",
+  "version": "3.21.2",
   "description": "Claude Agent Framework - Reusable framework for coordinating AI agents and humans in software projects",
   "bin": {
     "baldart": "./bin/baldart.js"