grimoire-kit 3.44.2__tar.gz → 3.46.0__tar.gz

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/CHANGELOG.md

@@ -7,6 +7,186 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
 
 ## [Unreleased]
 
+## [3.46.0] - 2026-09-12
+
+- **feat(policies): politiques temporelles par session sur la médiation d'outils — budgets, approbation préalable, refroidissement (#439).**
+  Point 3 de l'audit de positionnement 2026-09-12 : `PolicyRule` gagne quatre
+  clés optionnelles et rétrocompatibles (`tool_pattern`, `require_approval`,
+  `per_session`, `cooldown_after`, voir `_grimoire/standard/policies.yaml`),
+  validées au chargement (`GrimoirePolicyError` nommée sur clé inconnue). L'état
+  de session (compteurs, approbations, horodatages — jamais de secret ni de
+  contenu d'outil) vit dans `_grimoire-output/.runs/session-<id>.json`, écrit
+  atomiquement, remis à zéro à `SessionStart` ; un fichier absent ou corrompu
+  redevient une session neuve. La décision pure (règle + état → verdict) est
+  portée à l'identique en Python (`grimoire.policies.temporal`) et en Rust
+  (`rust/grimoire-policies-core`, `evaluate_temporal`), testée en parité ; le
+  hook `PreToolUse` reste sous +5 ms de surcoût mesuré. `grimoire policies
+  status` affiche les compteurs et budgets restants de la session — le
+  cockpit n'est pas dans ce lot.
+
+- **feat(hosts): un override d'agent peut désormais rester partiel (`extends: kit`) et signale sa dérive au lieu de figer silencieusement une copie (#427).**
+  Migration réelle 3.38.0 → 3.44.2 : quatre overrides en copie intégrale
+  n'avaient plus reçu une seule mise à niveau de leur agent depuis des mois,
+  `doctor` étant 22/22. Trois changements : (1) tout override écrit par un
+  chemin qui comprend le kit (cockpit, `grimoire agent override convert`)
+  enregistre `kit_source_hash:` (empreinte tronquée du fichier kit au moment
+  de l'écriture) ; `doctor` et le cockpit comparent cette empreinte à
+  l'actuelle et signalent en WARN (jamais FAIL) une dérive, avec un résumé
+  (sections de frontmatter ajoutées/retirées, delta du corps, ou champs
+  figés pour un override partiel), et en INFO une empreinte inconnue
+  (override antérieur à cette issue). (2) `extends: kit` dans le frontmatter
+  d'un override ne redéfinit plus que les champs qu'il liste
+  (`model_affinity`, `context`, `skills`, `tools`, `use_when`,
+  `dont_use_when`, `max_turns`, `description`, `tool_boundary`) — le corps et
+  le reste du frontmatter viennent du fichier kit de même nom, fusionnés
+  dans `hosts/collect.py` (dicts Python, avant tout appel au port Rust
+  optionnel — parité inchangée sous `GRIMOIRE_HOSTS_BACKEND=rust`) ; un
+  `extends: kit` sans agent kit de même nom refuse au chargement, nommant
+  l'agent. Le cockpit (assigner un skill, éditer une clause) écrit désormais
+  un override partiel dès qu'un agent kit du même nom existe, une copie
+  intégrale sinon. (3) `grimoire up` liste, après avoir rafraîchi le palier
+  kit, les overrides à revoir — sans jamais les toucher — et
+  `grimoire agent override convert <nom> [--dry-run]` convertit une copie
+  intégrale en override partiel équivalent, refusant (lignes citées) quand
+  le corps de la copie a divergé du kit plutôt que de fusionner du texte.
+
+- **feat(dispatch): coût par tâche résolue et pass^k, comptabilité continue et contrôle dans les gates (#442).**
+  Point 5 de l'audit de positionnement du 2026-09-12 : le kit dispatchait déjà des tâches en cascade sans jamais agréger en continu ce que ça coûte ni si ça marche de façon fiable — seules des campagnes d'évals manuelles (#308) répondaient à ces questions. `grimoire task dispatch`/`grimoire flow run --executor dispatch` écrivent maintenant un événement `dispatch.outcome` par cascade réellement tentée dans le journal de traces (classe, paliers tentés, coût total, verdict d'acceptance, résolu ou non — aucun contenu de prompt). Nouvelle commande `grimoire dispatch stats [--since 30d] [--json]`, sœur de `providers history` : coût par tâche résolue, taux d'escalade, part d'inexécutable (par classe et par fournisseur), et pass^k sur les nœuds rejoués (une série est « toute au vert » seulement si toutes ses exécutions ont résolu la tâche). Les agrégations pures vivent dans `rust/grimoire-traces-core/` (extension du sixième port), avec parité de test sous les deux backends. Le standard gagne le contrôle `dispatch.cost_slo` (pattern `provider-cost-slo`) : `INFO` faute de données, `WARN` en cas de dépassement (coût ou pass^k), `FAIL` uniquement si le projet déclare `dispatch_cost_slo.enforce: true` — jamais bloquant par défaut. Le cockpit n'est pas concerné par ce lot.
+
+- **feat(cockpit): timeline unifiée par tâche dans la vue de travail, l'export OTel de #322 devient une source lue plutôt qu'un mécanisme mort (#139).**
+  Audit de positionnement du 2026-09-12, point 2 : `TraceLedger.export_otel_jsonl`
+  produit des spans GenAI conformes depuis #322, mais rien ne les consommait —
+  `/api/otel` sert une pile d'événements différente (`blueprint_telemetry`,
+  `events.jsonl`), sans rapport avec le TraceLedger. `grimoire.missions.trace`
+  (déjà livré par #276) gagne une cinquième source, `otel` : si un export
+  existe à l'emplacement conventionnel (`<traces>/otel-export.jsonl`), ses
+  spans sont lus et corrélés par `grimoire.task_id` puis par `traceId`
+  partagé avec les spans enfants — jamais par heuristique textuelle. Deux
+  autres traces disparaissaient aussi en silence de la timeline avant ce
+  correctif : les dispatchs d'agent (`agent.dispatch`, `agent.miss`) et tout
+  futur fait du TraceLedger qui n'est ni un gate ni un appel d'outil — un
+  repli générique les reprend désormais sous la source `hooks`. Côté cockpit :
+  l'espace Exécuter (`web/workspace/spaces/executer.js`) ouvre la timeline
+  d'une tâche depuis sa carte (bouton « Voir la timeline »), la filtre par
+  source et par gravité, et détaille chaque ligne en accordéon ; l'espace
+  Observer (`observer.js`) y renvoie depuis un span qui porte
+  `grimoire.task_id`. Lecture seule (ADR-007) : aucune écriture, aucune
+  reconstruction d'événement absent — une tâche sans trace montre « aucun
+  événement » et nomme les sources lues. Tests : `tests/unit/missions/test_trace.py`
+  (corrélation par identifiants, dispatch non perdu, otel présent/absent),
+  `tests/unit/test_workspace_api.py`, `tests/e2e/test_workspace_lot4_spaces.py`
+  (dispatch et transition refusée visibles, filtre par source). Docs :
+  `docs/cli-reference.md`, `docs/serve-blueprints.md`,
+  `docs/audits/positionnement-2026-09-12.md` et
+  `framework/agentic-industry-reference.md` (section 10) mis à jour avec la
+  date de correction.
+
+- **feat(cockpit): suggestions de contenu par un petit modèle local (Ollama), toujours derrière l'IntelliSense déterministe de l'espace Source, jamais à sa place (#280).**
+  Voie 2 de #280, derrière la voie 1 (IntelliSense déterministe, PR #303) :
+  `project-context.yaml: source.assist.model` (vide par défaut, opt-in) plus
+  la même sonde qu'`grimoire providers audit` (`GET /api/tags`) décident si
+  le bouton **Suggérer** de l'éditeur Source apparaît — sinon l'interface ne
+  montre rien et ne tente rien. `GET /api/workspace/assist` (sans coût) rend
+  ce statut ; `POST /api/workspace/assist` (`src/grimoire/tools/source_assist.py`,
+  projet d'accueil seulement) appelle réellement le modèle en local
+  (`http://127.0.0.1:11434`, délai borné à 10 s), avec les identifiants du
+  paquet de langage (agents, skills, workflows, patterns) injectés dans le
+  prompt, et vérifie après coup tout identifiant cité par la réponse contre
+  ce même paquet — marqué « inconnu » plutôt que corrigé à la place de
+  l'utilisateur. Panneau d'aperçu dans l'éditeur (`Ctrl+Maj+Espace`, ou le
+  bouton) avec **Insérer**/**Ignorer** ; l'insertion passe par le même
+  chemin que la frappe clavier, la colorisation et les diagnostics se
+  recalculent dessus. Aucun fournisseur distant, aucune clé, aucune écriture
+  de fichier par la route. Garde de relecture : une URL Ollama résolue
+  (`OLLAMA_HOST`) hors bouclage (`127.0.0.1`, `::1`, `localhost`) est
+  refusée par défaut — `source.assist.allow_lan: true` l'autorise
+  explicitement.
+
+- **feat(mcp): migrer le pont MCP vers la révision de protocole 2026-07-28 (#436).**
+  Le plancher `mcp>=1.10,<3` laissait un résolveur retenir un SDK qui plafonne
+  à la révision 2025-11-25 (pas de `server/discover`, pas de mode sans état).
+  Relevé à `mcp>=2.0,<3` : à partir de 2.0.0, le SDK négocie 2026-07-28 par
+  défaut (`server/discover`, auto-dérivé des outils/prompts/ressources
+  enregistrés) tout en servant encore, sur la même connexion, un hôte qui ne
+  connaît que le handshake `initialize` (2025-06-18, 2025-11-25) —
+  `serve_dual_era_loop` côté SDK. Aucune ligne du pont
+  (`src/grimoire/mcp/server.py`) n'a dû changer : il ne câblait déjà ni
+  Roots, ni Sampling, ni Logging (les trois fonctionnalités que 2026-07-28
+  déprécie, retrait possible à partir de 2027-07-28), et ne garde aucun état
+  entre deux appels d'outil en dehors des fichiers du projet ciblé. Nouveaux
+  tests (`tests/unit/mcp/test_protocol_revision.py`) qui pilotent un vrai
+  `ClientSession` sur des flux en mémoire : négociation 2026-07-28 par
+  `server/discover`, compatibilité `initialize` à 2025-06-18 et 2025-11-25,
+  et absence d'état partagé entre deux connexions successives. Documentation
+  (`docs/mcp-integration.md`) et carte de correspondance
+  (`framework/agentic-industry-reference.md`, section 10) mises à jour.
+  Hors périmètre : transport HTTP/SSE, authentification, exposition réseau
+  distante — le pont reste stdio, en local.
+
+- fix(yaml): `grimoire upgrade` round-trippait `project-context.yaml` via un chargeur `safe` (aucune métadonnée de commentaire) puis un dumper round-trip — tous les commentaires du fichier disparaissaient silencieusement à chaque migration v2→v3 (#430).
+
+- fix(flows): `grimoire.runtime.kernel.create_instance` tronquait silencieusement `recipe_id`/`blueprint_id` aux 16 derniers caractères pour construire `wfi_id`/`run_id` (`WFI-...`) — deux blueprints partageant ce suffixe (par ex. `tasklib-hardening` perdait déjà son premier caractère) pouvaient obtenir le même `run_id` sur des kernels indépendants. L'identifiant complet est gardé tant qu'il tient dans une borne large (64 caractères) ; au-delà, il est raccourci et désambiguïsé par une empreinte de 8 hex de `sha256(recipe_id)` plutôt qu'une simple coupe. Les runs déjà persistés sous l'ancien format restent lisibles par `flow status`/`flow list` (#446).
+
+## [3.45.0] - 2026-09-12
+
+- **fix(flows): le gate de `flow run --executor dispatch` exécute l'acceptance structurée d'un node, pas seulement l'enveloppe (#428).**
+  Rejeu réel du 2026-09-11 (épic #307, lot 3) : un nœud V0 déclaré vert alors
+  que sa vraie suite `pytest` ne pouvait pas être collectée (dépendance
+  absente) — le gate ne vérifiait que la conformité de l'enveloppe JSON de
+  l'ouvrier au contrat de sortie, jamais le texte de l'acceptance. `node.acceptance`
+  accepte désormais, en plus du texte libre (rétrocompatible), une forme
+  structurée exécutable (`{"run": "...", "expect_exit": 0, "cwd": ".",
+  "timeout_s": 120, "expect_stdout_contains": "..."}`) ou une evidence
+  mécanique (`{"path_exists": "..."}`, `{"test": "..."}`) — validée au
+  chargement du blueprint (`blueprint_loader.py`), refus nommé sur une forme
+  inconnue. Le gate (`missions/dispatch.py`) exécute ces commandes après la
+  réponse de l'ouvrier et rend trois verdicts, jamais un quatrième :
+  exécutée-verte (succès), exécutée-rouge (échec, suit la cascade normale :
+  réessai/escalade), ou **acceptance inexécutable** (refus nommé — binaire
+  absent, `pytest` 5/4, erreur d'import dans la sortie — qui arrête la
+  cascade net, jamais un succès). `flow status` et le rapport de dispatch
+  montrent par nœud le statut d'acceptance (exécutée/inexécutable/jugée) et
+  la sortie tronquée à 2 Ko. **La classe V0 exige une acceptance
+  structurée** : un nœud dont le texte seul le classerait V0 mais qui n'en
+  déclare aucune est rétrogradé en V1 (cascade démarrant à `mid`, jamais
+  fermé sur la seule enveloppe — marqué à relire), avec un avertissement
+  nommé posé au chargement du blueprint et transmis à la fois au démarrage
+  de la cascade et au rapport, pour que `flow run` et `flow status`
+  s'accordent sur la même classe. Un nœud V1 **déclaré** (vocabulaire de
+  revue) garde le comportement actuel du kit, documenté sans être étendu.
+  Aucun changement côté port Rust des flows (`rust/grimoire-flows-core/`) :
+  seule `NodeContract.outputs` (pins) y traverse la frontière PyO3, inchangée
+  par ce correctif.
+
+- **feat(cockpit): le board de l'espace Exécuter montre le corps réel d'une tâche (description, garde-fous, dépendances) et les commandes d'intention restent gated par la preuve en multi-projet (#140).**
+  L'inspecteur de tâche affichait déjà les critères d'acceptation et les
+  preuves attendues ; il gagne des blocs Description, Garde-fous et
+  Dépendances, tirés du `MissionTask` du ledger — ce que `task-board.yaml`
+  n'a jamais su porter (ADR-005). `kanban.html` reste la vitrine statique et
+  gagne un lien vers le board vivant. Aucune écriture nouvelle : les
+  commandes de transition, le gate de preuve et la restriction au projet de
+  lancement du cockpit existaient déjà ; ce lot les couvre par des tests
+  dédiés (unitaires sur la route `/api/workspace/tasks/<id>/<action>` —
+  succès, refus nommant l'artefact manquant, refus hors projet de lancement —
+  et navigateur sur le critère d'acceptation à la lettre : une carte visée
+  vers *review* sans evidence pack est refusée avec l'artefact nommé, et le
+  board change quand on change de projet).
+
+- feat(traces): sixième port Rust optionnel du cœur du système d'artefact émergent — les agrégations du journal de traces (`TraceLedger.agent_dispatch_counts`/`.agent_miss_counts`/`.oldest_started_at`), la règle de fraîcheur (`compute_agent_freshness`, issue #396) et le déclencheur de propositions d'artefact (`grimoire.proposals` : nommage mécanique, résolution du porteur issue #402, décision de synchronisation seuil/refus issue #395/#394/#389) (issue #354). `rust/grimoire-traces-core/`, bascule `GRIMOIRE_TRACES_BACKEND=python|rust|auto` (lue indépendamment par `grimoire.traces.ledger` et `grimoire.proposals`, qui ne s'importent pas l'un l'autre), jobs CI `rust-traces / cargo` et `rust-traces / parity` dans `.github/workflows/rust-cores.yml`, roue toujours `py3-none-any`. Défaut trouvé par l'oracle Rust et corrigé dans cette même PR : `grimoire.traces.ledger._parse_iso` attrapait `ValueError` mais pas la `TypeError` non rattrapée levée ensuite par `datetime.now(tz=UTC) - datetime.fromisoformat(...)` sur un horodatage ISO-8601 *naïf* (sans décalage) — un journal JSONL édité à la main peut en porter un, et `compute_agent_freshness` revendique explicitement ne jamais lever sur un journal arbitraire ; corrigé en traitant un horodatage naïf comme UTC des deux côtés (même correctif que `grimoire_traces_core`, qui n'a jamais eu ce trou). Invariants de la doctrine rendus impossibles à violer par construction (clampés/exclus dans la fonction de décision elle-même, jamais par un appelant qui pourrait l'oublier) : seuil de proposition jamais sous 2, aucune proposition au premier non-choix, une proposition refusée ne revient que si son compte a doublé depuis le refus, la persona d'entrée est exclue de la recherche de porteur avant même de lire son `use_when`, le match de catégorie se fait par mot entier (limite de mot Unicode) et non par sous-chaîne. Corpus fixture de dix journaux JSONL réalistes (`tests/fixtures/traces_ledgers/`) et fuzz léger (200 enregistrements aléatoires) prouvant qu'aucune des fonctions d'agrégation/fraîcheur ne lève jamais, sous aucun backend, et qu'un champ de contenu libre (`prompt`/`request`) écrit à la main n'est jamais agrégé.
+
+- **fix(up): `identity` ne corrompt plus un scalaire commenté de `project-context.yaml` (#426).**
+  `cmd_setup._apply_project_context` réécrivait chaque ligne `user:` connue
+  avec une regex `.+` qui avalait tout le reste de la ligne — valeur *et*
+  commentaire inline — comme si c'était « la valeur », puis rewrappait ce
+  texte entier entre guillemets. `skill_level: "expert"  # beginner |
+  intermediate | expert` devenait `skill_level: ""expert"  # beginner |
+  intermediate | expert"` à chaque `grimoire up`, y compris quand la valeur
+  ne changeait pas — et cassait ensuite `grimoire doctor` (`GR002`, YAML
+  imparsable). Un nouveau `_split_scalar_and_comment` sépare correctement
+  le scalaire (quoté ou non) du commentaire qui le suit avant toute lecture
+  ou réécriture, et `_apply_project_context` recolle le commentaire original
+  après la nouvelle valeur au lieu de le jeter.
+
 ## [3.44.2] - 2026-09-11
 
 - **fix(hosts): `collect_agents` résout ses propres skills quand `known_skills` n'est pas fourni — `SessionStart` et le porteur de proposition ne plantent plus sur un agent à skills attachés (#423).**

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grimoire-kit
-Version: 3.44.2
+Version: 3.46.0
 Summary: Composable AI agent platform — personas, memory, workflows, and quality automation for any project.
 Project-URL: Homepage, https://github.com/Guilhem-Bonnet/Grimoire-kit
 Project-URL: Repository, https://github.com/Guilhem-Bonnet/Grimoire-kit
@@ -27,7 +27,7 @@ Requires-Dist: typer>=0.12
 Provides-Extra: all
 Requires-Dist: chromadb<0.7,>=0.6; extra == 'all'
 Requires-Dist: fastembed>=0.8; extra == 'all'
-Requires-Dist: mcp<3,>=1.10; extra == 'all'
+Requires-Dist: mcp<3,>=2.0; extra == 'all'
 Requires-Dist: neo4j>=5.0; extra == 'all'
 Requires-Dist: ollama>=0.3; extra == 'all'
 Requires-Dist: qdrant-client>=1.9; extra == 'all'
@@ -37,7 +37,7 @@ Provides-Extra: dev
 Requires-Dist: chromadb<0.7,>=0.6; extra == 'dev'
 Requires-Dist: fastembed>=0.8; extra == 'dev'
 Requires-Dist: hypothesis>=6.100; extra == 'dev'
-Requires-Dist: mcp<3,>=1.10; extra == 'dev'
+Requires-Dist: mcp<3,>=2.0; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: neo4j>=5.0; extra == 'dev'
 Requires-Dist: ollama>=0.3; extra == 'dev'
@@ -56,7 +56,7 @@ Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.25; extra == 'docs'
 Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
 Provides-Extra: mcp
-Requires-Dist: mcp<3,>=1.10; extra == 'mcp'
+Requires-Dist: mcp<3,>=2.0; extra == 'mcp'
 Provides-Extra: mempalace
 Requires-Dist: chromadb<0.7,>=0.6; extra == 'mempalace'
 Provides-Extra: neo4j

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/framework/agentic-industry-reference.md

@@ -588,42 +588,50 @@ conditions d'arrêt) sont des défauts de harness, pas de modèle.
 
 ## <img src="../docs/assets/icons/handshake.svg" width="28" height="28" alt=""> 10. Correspondance Grimoire ↔ industrie
 
-Statuts : **aligné** (même pratique, même niveau) ; **en avance** (Grimoire va plus
-loin que la pratique publiée) ; **à combler** (l'industrie a une pratique prouvée que
-Grimoire n'a pas encore, ou pas au même niveau).
+Mise à jour 2026-09-12, audit de positionnement (`docs/audits/positionnement-2026-09-12.md`),
+suite à la version 3.41.0 → 3.45.0. Statuts : **aligné** (même pratique, même
+niveau) ; **en avance** (Grimoire va plus loin que la pratique publiée) ; **à
+combler** (l'industrie a une pratique prouvée que Grimoire n'a pas encore, ou
+pas au même niveau). Un écart comblé ou partiellement comblé porte la
+référence de l'issue ou de la PR qui l'a fait bouger, conformément à la
+section 12.
 
 | Protocole ou mécanisme Grimoire | Équivalent industriel | Écart | Statut |
 |---|---|---|---|
 | SOG, point d'entrée unique et dispatch invisible (`orchestrator-gateway.md`) | Manager pattern OpenAI, Coordinator ADK, Harness Agent MAF | Même architecture ; Grimoire ajoute la détection de zones d'ombre et le batching de questions | aligné |
 | HUP, seuils de confiance vert/jaune/rouge (`honest-uncertainty-protocol.md`) | « Why language models hallucinate » (récompenser l'abstention) ; MAST FM-2.2 | Aucun éditeur n'expose un protocole équivalent côté agent ; l'industrie le traite à l'entraînement | en avance |
 | QEC, remontée groupée des questions (`question-escalation-chain.md`) | Elicitation MCP, `interrupt()` LangGraph, `request_confirmation` ADK, HITL OpenAI | Grimoire groupe les questions ; l'industrie les pose une à une | en avance |
-| CVTL, vérification croisée (`cross-validation-trust.md`) | Evaluator-optimizer, Writer/Reviewer séparés, Agent-as-a-Judge | Aligné sur la séparation générateur-évaluateur ; à outiller avec pass^k et coût par tâche | aligné |
+| CVTL, vérification croisée (`cross-validation-trust.md`) | Evaluator-optimizer, Writer/Reviewer séparés, Agent-as-a-Judge | Aligné sur la séparation générateur-évaluateur ; **pass^k livré** (`grimoire.evals.schemas.pass_hat_k`, amendement A3 du protocole d'évals, 2026-09-08) mais seulement au niveau campagne — aucune campagne ne l'a encore consommé et il n'est pas branché sur CVTL elle-même ; coût par tâche mesuré une fois à la main (rejeu dispatch, #307, 2026-09-11), jamais instrumenté | aligné |
 | PCE, débats productifs (`productive-conflict-engine.md`) | Multi-agent debate | La recherche montre un gain rarement supérieur à Self-Consistency à coût bien supérieur ; réserver PCE aux décisions, pas à la production | à cadrer |
 | AMN et SHP, maillage et huddles (`agent-mesh-network.md`, `selective-huddle-protocol.md`) | Agent teams Claude Code, Swarm Strands, handoffs | Aligné sur le plafond d'échanges P2P ; la limite de cinq échanges avant notification SOG répond à MAST FM-1.3 et FM-1.5 | aligné |
 | ARG, graphe de relations (`agent-relationship-graph.md`) | Graphe d'orchestration OpenAI, Graph ADK/Strands | Aligné ; Grimoire l'utilise pour le routage, l'industrie pour l'exécution | aligné |
-| ELSS, journal d'événements partagé (`event-log-shared-state.md`) | Checkpointers LangGraph, task ledger Magentic, mailbox agent teams | Aligné ; à projeter en spans OTel GenAI (`invoke_agent`, `execute_tool`) | à combler |
-| CC, Completion Contract (`cc-reference.md`, `cc-verify.sh`) | « Give Claude a check it can run », Stop hooks, Ralph loop | Aligné ; c'est la réponse directe à MAST FM-3.x | aligné |
-| Standard agentique : `evidence-gated-fsm`, `mission-evidence-ledger`, gates de preuve | Trace grading OpenAI, evals ADK, HAL | Grimoire exige la preuve avant clôture ; l'industrie évalue après coup | en avance |
-| `tool-mediation-gate`, `governed-hook-gateway`, registre de sûreté des hooks en mode shadow/canary/enforced | Cotation de risque par outil (OpenAI), Policy Cedar/Dogwood (AgentCore), OWASP Agent Control Standard | Même idée ; Dogwood ajoute des politiques temporelles par session (compteurs, budgets) que Grimoire n'a pas | à combler |
-| `provider-routing-contract`, `provider-cost-slo`, `model-routing.yaml` | Routing et cascades (FrugalGPT, RouteLLM), `effort` par sous-agent | Aligné sur le principe ; mesurer le coût par tâche résolue et le pass^k, pas seulement le SLO par fournisseur | à combler |
-| `governed-memory-policy`, composition mémoire, Mémoire OS | Memory Bank, AgentCore Memory, Letta, memory tool | Aligné ; ajouter la validation externe des écritures contre le memory poisoning (OWASP T1, ASI06) | à combler |
+| ELSS, journal d'événements partagé (`event-log-shared-state.md`) | Checkpointers LangGraph, task ledger Magentic, mailbox agent teams | **Export en spans OTel GenAI livré** (`TraceLedger.export_otel_jsonl`, un span `invoke_agent` par trace plus un `execute_tool` par appel d'outil, format semconv exact — #322, 2026-09-08). **Comblé le 2026-09-12** (#139) : `grimoire.missions.trace` corrèle par `task_id`/`traceId` le Mission Ledger, le TraceLedger (outils, gates, dispatch d'agent) et, s'il existe, l'export OTel lui-même, en CLI (`grimoire task trace`) comme dans le cockpit ; `grimoire task trace-export --format otel` reste une commande manuelle, mais son résultat est désormais lu, pas seulement produit | aligné |
+| CC, Completion Contract (`cc-reference.md`, `cc-verify.sh`) | « Give Claude a check it can run », Stop hooks, Ralph loop | Aligné ; **renforcé par #428** (3.45.0) : le gate de `flow run --executor dispatch` exécute désormais l'acceptance structurée d'un node, pas seulement la conformité de l'enveloppe JSON — corrige un faux vert réel trouvé par le rejeu #307 (nœud fermé vert alors que sa suite `pytest` ne s'exécutait pas) | aligné |
+| Standard agentique : `evidence-gated-fsm`, `mission-evidence-ledger`, gates de preuve | Trace grading OpenAI, evals ADK, HAL | Grimoire exige la preuve avant clôture ; l'industrie évalue après coup. Le gate d'acceptance structurée (#428) est la preuve la plus récente que l'exigence porte sur l'exécution réelle, pas la forme de la réponse | en avance |
+| `tool-mediation-gate`, `governed-hook-gateway`, registre de sûreté des hooks en mode shadow/canary/enforced | Cotation de risque par outil (OpenAI), Policy Cedar/Dogwood (AgentCore), OWASP Agent Control Standard | Même idée ; Dogwood ajoute des politiques temporelles par session (compteurs, budgets) que Grimoire n'a pas. Vérifié au code le 2026-09-12 (`grimoire/policies/`) : aucun compteur ni budget par session, intact | à combler |
+| `provider-routing-contract`, `provider-cost-slo`, `model-routing.yaml` | Routing et cascades (FrugalGPT, RouteLLM), `effort` par sous-agent | Aligné sur le principe. **Première mesure réelle faite** (#307, rejeu 2026-09-11, deux runs complets sur flow réel) : la cascade coûte 56,4 % du coût opus seul par nœud complété, contre 21,5 % projeté par la mesure isolée du lot 0 (#308) — l'écart venait du gate qui fermait vert sur la conformité d'enveloppe plutôt que sur l'acceptance réelle, corrigé par #428. Reste à combler : cette mesure est un rejeu ponctuel, pas une instrumentation continue du coût par tâche résolue | à combler |
+| `governed-memory-policy`, composition mémoire, Mémoire OS | Memory Bank, AgentCore Memory, Letta, memory tool | Aligné ; ajouter la validation externe des écritures contre le memory poisoning (OWASP T1, ASI06). Revérifié le 2026-09-12 (recherche `memory poisoning`/`validation externe` dans le code) : intact, aucun mécanisme trouvé | à combler |
 | `advanced-context-orchestrator`, `context-contract.yaml`, capsule de contexte PreCompact | Context engineering Anthropic, write/select/compress/isolate | Aligné ; la capsule PreCompact est une pratique que peu d'hôtes formalisent | en avance |
-| Agent Skills du kit (`.github/skills`, `skill-forge` avec gate qualité) | agentskills.io, `skills-ref validate`, SkillsBench | Aligné sur le format ; ajouter la validation `skills-ref` et un eval par skill (evals.json) | à combler |
-| Hooks Forge via gateway (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PreCompact, Subagent*, Stop) | Familles d'événements Claude Code, Codex, Gemini, Copilot, Kiro | Aligné ; les hôtes exposent désormais `TaskCreated`, `TaskCompleted`, `InstructionsLoaded`, `PostToolUseFailure` que la Forge n'exploite pas | à combler |
+| Agent Skills du kit (`.github/skills`, `skill-forge` avec gate qualité) | agentskills.io, `skills-ref validate`, SkillsBench | Aligné sur le format ; ajouter la validation `skills-ref` et un eval par skill (evals.json), toujours intact au 2026-09-12. Changement de contexte à noter : les archétypes ont été refaits (#375, #380, 3.42.0) et l'attachement d'un skill à son agent porteur est devenu la règle par défaut (#377/#372, doctrine `docs/artifact-doctrine.md`) — le nombre de skills transversaux a chuté, mais cela ne comble pas l'écart de validation | à combler |
+| Hooks Forge via gateway (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PreCompact, Subagent*, Stop) | Familles d'événements Claude Code, Codex, Gemini, Copilot, Kiro | **Partiellement comblé** : `PostToolUseFailure` et `SubagentStart` sont désormais des `HookEvent` exploités par le kit (#321, fusionné le 2026-09-08 dans l'après-midi, donc après la rédaction de cette référence le même jour) ; `TaskCreated`, `TaskCompleted` et `InstructionsLoaded` restent absents de `grimoire/hosts/events.py` au 2026-09-12 | à combler |
 | Persona d'entrée injectée par SessionStart | Aucun hôte ne sait démarrer dans un agent (constat 2026-08-29) | Pratique propre à Grimoire | en avance |
-| Pont MCP du kit (`grimoire` serveur MCP) | MCP 2026-07-28 stateless, MRTR, `server/discover`, headers `Mcp-Method` | Le kit cible une révision antérieure ; planifier la migration avant le retrait de Roots et Sampling (2027-07-28) | à combler |
-| Observabilité cockpit, `observability-policy.yaml` | OTel GenAI spans et métriques, Langfuse, Phoenix | Émettre les spans `invoke_agent` et `execute_tool` au format semconv pour brancher n'importe quel backend | à combler |
-| Sécurité : garde des surfaces de contrôle, patterns destructifs | Six patterns Beurer-Kellner, CaMeL, sandbox à deux phases | Ajouter un pattern Plan-Then-Execute explicite pour les tâches qui lisent du contenu externe ; documenter l'isolation d'exécution | à combler |
+| Pont MCP du kit (`grimoire` serveur MCP) | MCP 2026-07-28 stateless, MRTR, `server/discover`, headers `Mcp-Method` | **Comblé pendant la revue de cet audit** (issue #436, PR #437, 2026-09-12) : plancher `mcp>=2.0,<3`, `server/discover` négocie 2026-07-28 par défaut, `initialize` d'un hôte 2025-06-18/2025-11-25 toujours servi sur la même connexion, aucun état entre appels hors fichiers du projet — vérifié par test. Roots/Sampling/Logging jamais câblés, rien à retirer. Transport HTTP/SSE et OTel `_meta` restent hors périmètre | aligné |
+| Observabilité cockpit, `observability-policy.yaml` | OTel GenAI spans et métriques, Langfuse, Phoenix | **Émission livrée** : `otel_conventions.py` définit le vocabulaire semconv exact (`gen_ai.provider.name`, spans `invoke_agent`/`execute_tool`) et `TraceLedger.export_otel_jsonl` (#322) les produit réellement. **Consommation comblée le 2026-09-12** (#139) : `web/workspace/spaces/executer.js` (timeline par tâche, filtrable par source et gravité, drill-down depuis une carte du board) et `observer.js` (drill-down depuis un span qui porte `grimoire.task_id`) la consomment côté cockpit ; l'ancien `web/observability.html` (`framework/tools/observatory.py`) n'a pas bougé et reste hors périmètre de ce correctif | aligné |
+| Sécurité : garde des surfaces de contrôle, patterns destructifs | Six patterns Beurer-Kellner, CaMeL, sandbox à deux phases | Ajouter un pattern Plan-Then-Execute explicite pour les tâches qui lisent du contenu externe ; documenter l'isolation d'exécution. Revérifié le 2026-09-12 : intact, aucune occurrence trouvée | à combler |
 | Identité des agents | Entra Agent ID, SPIFFE, ID-JAG | Grimoire n'a pas d'identité par agent ; hors périmètre tant que les agents restent locaux | à suivre |
+| **Nouveau** — système émergent non-choix → proposition → acceptation (`grimoire.proposals`, `agent_miss_counts`, #394/#395/#402, 3.43.0/3.43.1) | Skills auto-écrits (section 9) : SkillsBench, ACE playbook évolutif | Grimoire propose sur un seuil mécanique de non-choix répétés (jamais 1), par gabarit sans appel LLM, avec acceptation humaine explicite obligatoire (`grimoire proposals accept`) ; l'industrie évalue des skills déjà écrits par un LLM (SkillsBench) ou consolide un playbook en continu à l'exécution (ACE). Aucun des deux ne fait du taux d'échec de dispatch un déclencheur de proposition — mécanisme distinct, pas un même pattern appliqué plus tôt | en avance |
+| **Nouveau** — règle de fraîcheur des agents (`compute_agent_freshness`, #396/#398, 3.43.0) | — | Aucun équivalent trouvé dans le corpus de sources de la section 11 : signale un agent non choisi depuis N jours (défaut 90), ne le retire ni ne le déprécie jamais automatiquement | en avance |
+| **Nouveau** — cœurs Rust optionnels comme oracle de correction, jamais de performance (#354 et ses six ports : `policies`, `schema/validator`, `hosts`, `flows`, `dispatch`, `traces`) | Differential testing / second implémentation comme oracle (pratique d'ingénierie reconnue, non nommée dans le corpus de sources listées section 11) | Mesuré (commentaire #354, 2026-09-11) : le cœur Rust est plus lent que le Python qu'il remplace sur les cinq micro-benchmarks, écart dans le bruit de mesure en macro — décision de Guilhem : conservé pour les défauts trouvés par le compilateur (sept corrigés à ce jour), pas pour la vitesse. Aucune roue publiée (assumé) | aligné (hors corpus) |
 
 Priorités issues de cette carte, à instruire comme issues produit dans le dépôt
 Grimoire-kit (jamais comme chantiers d'atelier) :
 
-1. Projection OTel GenAI des événements ELSS et du cockpit.
-2. Coût par tâche résolue et pass^k dans les gates de preuve.
-3. Validation externe des écritures mémoire.
-4. Migration du pont MCP vers la révision 2026-07-28.
-5. Politiques temporelles par session sur le tool-mediation-gate.
+1. Faire courir pass^k en continu et instrumenter le coût par tâche résolue directement dans les gates de preuve, pas seulement en campagne ponctuelle ou en rejeu manuel (#307).
+2. Validation externe des écritures mémoire.
+3. Politiques temporelles par session sur le tool-mediation-gate.
+4. Réparer #427 (un override d'agent en copie intégrale ne reçoit plus jamais les mises à niveau du kit, sans aucun signal de `doctor`) — promesse de personnalisation de la doctrine des artefacts non tenue par le code, distincte d'un écart face à l'industrie.
+
+(Migration du pont MCP vers la révision 2026-07-28 : comblée pendant la revue de cet audit, issue #436, PR #437, 2026-09-12. Cockpit branché sur l'export OTel et timeline unifiée par tâche : comblé le 2026-09-12, issue #139.)
 
 <img src="../docs/assets/divider.svg" width="100%" alt="">
 

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/framework/agentic-standard/templates/pattern-catalog.yaml

@@ -177,7 +177,7 @@ patterns:
     required_artifacts: ["llm-provider-registry.yaml"]
     rule_refs: ["provider.cost-budgeted"]
     hook_refs: []
-    check_refs: []
+    check_refs: ["dispatch.cost_slo"]
   - id: tool-blast-radius-limiter
     category: security
     maturity: starter

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/pyproject.toml

@@ -37,14 +37,20 @@ dependencies = [
 # fermée sur la 3 : une majeure non parue ne peut pas être déclarée compatible.
 # Lever la borne demande de porter le serveur sur l'API 2.x.
 #
-# Borne basse relevée à 1.10 : le serveur n'utilise plus seulement le décorateur
-# `tool()`, il déclare des `ToolAnnotations` (révision de protocole 2025-03-26)
-# et rend ses échecs francs en `CallToolResult` avec `structuredContent`
-# (révision 2025-06-18). Sous 1.10 ces deux surfaces n'existent pas ou pas
-# ensemble : `pip install grimoire-kit[mcp]` livrerait à nouveau un serveur qui
-# casse à l'import plutôt qu'à l'appel. La borne haute reste `<3`, pour la
-# raison ci-dessus.
-mcp = ["mcp>=1.10,<3"]
+# Borne basse relevée à 2.0 (issue #436, migration vers la révision de
+# protocole 2026-07-28) : `mcp` 1.x plafonne à la révision 2025-11-25
+# (`types.LATEST_PROTOCOL_VERSION == "2025-11-25"`, pas de
+# `server/discover`) — vérifié contre 1.30.0, la dernière 1.x publiée, pas
+# supposé. À partir de 2.0.0 (vérifié 2.0.0 à 2.2.0), le SDK sait déjà parler
+# 2026-07-28 : `server/discover` a un handler par défaut dans
+# `mcp.server.lowlevel.Server`, et le handshake `initialize` d'un hôte plus
+# ancien (2025-06-18, 2025-11-25) continue de fonctionner via
+# `serve_dual_era_loop` — aucune ligne du pont n'a dû changer pour ça. Sous
+# 2.0 le pont resterait fonctionnellement correct mais annoncerait une
+# révision que la spécification a déjà remplacée, et le jour du retrait de
+# Roots/Sampling (prévu à partir de 2027-07-28) découvrirait la dette d'un
+# coup. La borne haute reste `<3`, pour la raison ci-dessus.
+mcp = ["mcp>=2.0,<3"]
 # Les extras ci-dessous restent volontairement sans borne haute. Audit du
 # 2026-08-15, mené après la panne mcp : chacun n'est utilisé qu'à travers un
 # point d'entrée canonique de haut niveau, celui qui survit aux majeures.
@@ -208,6 +214,7 @@ ignore_missing_imports = true
 # third such core (issue #354): rust/grimoire-hosts-core/.
 # `grimoire_flows_core` is the fourth: rust/grimoire-flows-core/.
 # `grimoire_dispatch_core` is the fifth: rust/grimoire-dispatch-core/.
+# `grimoire_traces_core` is the sixth: rust/grimoire-traces-core/.
 [[tool.mypy.overrides]]
 module = [
     "grimoire_policies_core",
@@ -215,6 +222,7 @@ module = [
     "grimoire_hosts_core",
     "grimoire_flows_core",
     "grimoire_dispatch_core",
+    "grimoire_traces_core",
 ]
 ignore_missing_imports = true
 

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/registry/kit-file-hashes.json

@@ -1,6 +1,6 @@
 {
  "schema": "grimoire-kit-file-hashes/v1",
- "generated_for": "3.44.2",
+ "generated_for": "3.46.0",
  "digests": {
   "002d1e68ce00769ee09d1e94f4af260b952837f7d1557080c2fd505216c23ac0": {
    "version": "3.11.2",
@@ -1266,6 +1266,14 @@
    "version": "3.24.0",
    "path": "archetypes/platform-engineering/agents/platform-architect.md"
   },
+  "6050bce4a13ae354a04a63b368e173f612539aab2a1b918de37d84e459b3291d": {
+   "version": "3.46.0",
+   "path": "framework/agentic-industry-reference.md"
+  },
+  "607299dda9ae7b510bb36fc02f0bb8d114ecbe4f37b56c707c6dc8d0a6d9689d": {
+   "version": "3.46.0",
+   "path": "framework/agentic-standard/templates/pattern-catalog.yaml"
+  },
   "609134a13d67a6d84a5a0d9f58784e7ab57b0e3945652ff90a165347160e1fcd": {
    "version": "3.42.0",
    "path": "archetypes/platform-engineering/skills/platform-deploy-release.md"

grimoire_kit-3.46.0/rust/grimoire-traces-core/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["maturin>=1.7,<2"]
+build-backend = "maturin"
+
+[project]
+name = "grimoire-traces-core"
+version = "0.1.0"
+description = "Coeur Rust optionnel des agregations du journal de traces, de la regle de fraicheur et du declencheur de propositions (PyO3). Non publie sur PyPI — build local uniquement, voir CONTRIBUTING.md."
+requires-python = ">=3.12"
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3.12",
+    "Private :: Do Not Upload",
+]
+
+[tool.maturin]
+module-name = "grimoire_traces_core"

grimoire_kit-3.46.0/src/grimoire/__version__.py

@@ -0,0 +1 @@
+__version__ = "3.46.0"

{grimoire_kit-3.44.2 → grimoire_kit-3.46.0}/src/grimoire/cli/app.py

@@ -439,6 +439,29 @@ def doctor(
         for check_name, check_passed, check_detail in integrity_checks(target):
             _record(check_name, passed=check_passed, detail=check_detail)
 
+    # 4quinquies. Override drift (issue #427) — un override est une copie ou
+    # une extension du kit, jamais une garantie qu'il en reçoit encore les
+    # mises à jour. Jamais FAIL : une dette de personnalisation, pas une
+    # panne. Une entrée par override nommant l'agent et la section changée,
+    # pas un agrégat — c'est ce que le critère d'arrêt de l'issue demande.
+    with _timed_phase("override_drift"):
+        from grimoire.core.override_drift import describe_drift, project_override_drift
+
+        for drift in project_override_drift(target):
+            if drift.status == "fresh":
+                continue  # à jour : rien à signaler, pas de bruit sur chaque `doctor`
+            level, detail = describe_drift(drift)
+            drift_entry: dict[str, Any] = {
+                "name": f"override_drift_{drift.name}",
+                "passed": True,
+                "detail": detail,
+                "level": level,
+            }
+            results.append(drift_entry)
+            if fmt != "json":
+                tag = "[yellow]WARN[/yellow]" if level == "warn" else "[dim]○[/dim]"
+                console.print(f"  {tag}  {detail}")
+
     # 5. Config semantic validation
     if cfg:
         warnings = cfg.validate()
@@ -1001,7 +1024,10 @@ LazyTyperGroup.configure(
         "features": LazyGroupSpec("grimoire.cli.cmd_features", "features_app", rich_help_panel="Project"),
         "host": LazyGroupSpec("grimoire.cli.cmd_host", "host_app", rich_help_panel="Project"),
         "providers": LazyGroupSpec("grimoire.cli.cmd_providers", "providers_app", rich_help_panel="Project"),
+        "dispatch": LazyGroupSpec("grimoire.cli.cmd_dispatch", "dispatch_app", rich_help_panel="Project"),
+        "policies": LazyGroupSpec("grimoire.cli.cmd_policies", "policies_app", rich_help_panel="Project"),
         "proposals": LazyGroupSpec("grimoire.cli.cmd_proposals", "proposals_app", rich_help_panel="Agents"),
+        "agent": LazyGroupSpec("grimoire.cli.cmd_agent", "agent_app", rich_help_panel="Agents"),
         "web": LazyGroupSpec("grimoire.cli.cmd_web", "web_app", rich_help_panel="Data"),
     },
     commands={
@@ -1022,7 +1048,7 @@ LazyTyperGroup.configure(
         "repair",
         "memory", "hooks", "cadrage", "debugger", "dbg", "registry", "workflows",
         "wf", "standard", "ext", "blueprint", "flow", "cockpit", "task",
-        "stigmergy", "features", "host", "providers", "proposals", "web",
+        "stigmergy", "features", "host", "providers", "dispatch", "proposals", "agent", "web",
         "config", "completion", "self", "plugins",
     ],
 )

grimoire_kit-3.46.0/src/grimoire/cli/cmd_agent.py

@@ -0,0 +1,70 @@
+"""``grimoire agent`` — inspect and manage a project's own agent overrides.
+
+Only one command lives here today: ``agent override convert`` (issue #427),
+the migration path ``grimoire up`` names but never applies on its own (see
+``_step_override_review`` in :mod:`grimoire.cli.cmd_up`). Named as its own
+top-level group rather than folded into an existing one — ``registry`` reads
+the kit's own catalog, ``standard`` is the governed profile — because a
+project's agent overrides are neither.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+console = Console(stderr=True)
+
+agent_app = typer.Typer(help="Inspect and manage this project's agent overrides.")
+override_app = typer.Typer(help="Compare, convert and review agent overrides against the kit.")
+agent_app.add_typer(override_app, name="override")
+
+_convert_name_arg = typer.Argument(..., help="Agent name (the override file's stem).")
+_convert_path_opt = typer.Option(Path(), "--path", help="Project root.")
+_convert_dry_run_opt = typer.Option(
+    False, "--dry-run", help="Show the resulting partial override without writing it."
+)
+
+
+@override_app.command("convert")
+def convert(
+    name: str = _convert_name_arg,
+    path: Path = _convert_path_opt,
+    dry_run: bool = _convert_dry_run_opt,
+) -> None:
+    """Convert a full-copy override into the equivalent partial one.
+
+    A partial override (``extends: kit``) only redefines the frontmatter
+    fields that differ from the kit's own file — the body and every other
+    field stay live against future ``grimoire up`` runs. Refuses, naming the
+    lines that differ, when the override's body itself diverges from the
+    kit's: converting would otherwise silently drop a real customisation, and
+    this command never merges text.
+
+    [dim]Examples:[/dim]
+      [cyan]grimoire agent override convert ops-engineer --dry-run[/cyan]
+      [cyan]grimoire agent override convert ops-engineer[/cyan]
+    """
+    from grimoire.core.override_drift import OverrideConversionRefusedError, convert_override
+
+    target = path.resolve()
+    try:
+        result = convert_override(target, name, dry_run=dry_run)
+    except FileNotFoundError as exc:
+        console.print(f"[red]{exc}[/red]")
+        raise typer.Exit(1) from exc
+    except OverrideConversionRefusedError as exc:
+        console.print(f"[red]Refus :[/red] {exc}")
+        raise typer.Exit(1) from exc
+
+    fields_label = "aucun champ propre — juste `extends: kit`" if not result.fields else ", ".join(result.fields)
+
+    if dry_run:
+        console.print(f"[dim]dry-run — rien n'est écrit. Résultat pour « {name} » :[/dim]\n")
+        console.print(result.rendered)
+        console.print(f"\n[dim]Champs figés :[/dim] {fields_label}")
+    else:
+        console.print(f"[green]Converti :[/green] {result.override_ref}")
+        console.print(f"[dim]Champs figés :[/dim] {fields_label}")