grimoire-kit 3.4.4__tar.gz → 3.16.0__tar.gz

{grimoire_kit-3.4.4 → grimoire_kit-3.16.0}/.gitignore

@@ -74,6 +74,8 @@ _grimoire-output/.tool-resolver/
 _grimoire-output/agent-debugger.html
 _grimoire-output/hpe-dashboard.html
 _grimoire-output/pheromone-board.json
+_grimoire-output/Grimoire_TRACE.md
+_grimoire/_memory/*.sqlite3
 .grimoire-memory/
 .grimoire-twin/
 framework/memory/session-state.md

{grimoire_kit-3.4.4 → grimoire_kit-3.16.0}/CHANGELOG.md

@@ -7,6 +7,180 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
 
 ## [Unreleased]
 
+## [3.16.0] - 2026-06-26
+
+### Changé
+
+- **Purge emoji — sortie terminal (étape 3, finale)** — Balayage déterministe de toute la
+  sortie CLI : `framework/tools/*.py`, le SDK `src/grimoire/**` et les tests (126 fichiers,
+  ~1900 occurrences).
+  - Glyphes de statut → marqueurs ASCII maison : `✅✔✓`→`[OK]`, `❌✖✗`→`[x]`, `⚠`→`[!]`,
+    `ℹ`→`[i]`, pastilles de sévérité `🔴`→`[!!]` / `🟡🟠`→`[!]` / `🟢`→`[ok]` / `🔵`→`[i]`,
+    `🚫⛔🛑`→`[STOP]`.
+  - Emojis purement décoratifs (en-têtes de section, icônes de catégorie) supprimés.
+  - Symboles typographiques conservés (flèches `→ ← ↑ ↓`, tirets, points de suite) — ce ne
+    sont pas des emojis.
+  - Ternaires devenus identiques après strip remédiés (markers distincts : `[fix]`, `[sem]`/
+    `[lex]`, `[~]`/`[+]`, `[+]`/`[-]`), échelle de santé `dashboard` re-distinguée
+    (`[ok]`/`[~]`/`[!]`/`[!!]`).
+  - Correctif de parsing : `antifragile-score._count_contradictions` ne dépend plus d'un
+    glyphe `⏳` supprimé (active = non-résolu).
+  - Suite complète verte : 5996 passed, 4 skipped ; ruff clean.
+
+### Corrigé (release/hygiène)
+
+- **Pipeline release robuste** — `release.yml` génère désormais `RELEASE_NOTES.md` en
+  best-effort depuis la trace puis **retombe systématiquement sur `git log`** si le fichier
+  est absent ou vide (corrige l'échec v3.15.0 où `cat RELEASE_NOTES.md` plantait).
+- **Artefacts générés dé-trackés** — `_grimoire-output/Grimoire_TRACE.md` et
+  `_grimoire/_memory/*.sqlite3` retirés du suivi git et ajoutés au `.gitignore` (ils avaient
+  été inclus par erreur via `git add -A` en v3.15.0, ce qui faussait le workflow release).
+
+## [3.15.0] - 2026-06-26
+
+### Supprimé / Changé
+
+- **Purge BMAD — résidu complet** — Tout le code fonctionnel et l'outillage sont débarrassés de la marque/layout `_bmad` :
+  - `agent-lint.py` retargeté de `_bmad/*/agents/` vers `_grimoire/*/agents/` (variable `grimoire_dir`, manifeste, messages) ;
+  - `observatory.py` ne supporte plus le layout `_bmad-output` / `BMAD_TRACE.md` (Grimoire uniquement) ; tests alignés ;
+  - `github-cc-check.yml.tpl` (framework + copie déployée) rebrandé « Grimoire Completion Contract », chemin `_grimoire/_config/custom/cc-verify.sh`, hint `grimoire init` ;
+  - `bug-finder.py` ignore désormais `.grimoire-rnd` (était `.bmad-rnd`, nom obsolète) ;
+  - docstrings/commentaires/aides nettoyés : `grimoire-setup.py`, `agent-test.py`, `skill-validator.py` ;
+  - `grimoire-completion.zsh` : suppression de l'alias `bmad`/`compdef` et de `bmad-master` ;
+  - `.github/CODEOWNERS`, `.vscode/settings.json` (`git.branchPrefix`), `.vscode/snippets` (préfixes `grimoire-*`), `examples/web-app-todo`, `tests/smoke-test.sh`, `tests/run-coverage.sh`, `_grimoire/_memory/requirements-full.txt` : rebrand `_grimoire`.
+  - **Conservé** : la citation de BMAD-METHOD comme framework de référence dans `docs/agentic-standard-benchmark-corpus-2026Q2.md` (provenance/attribution, pas un usage interne).
+
+## [3.14.0] - 2026-06-25
+
+### Changé
+
+- **Purge emoji — terminal & exemples docs (étape 2)** — `framework/tools/context-guard.py` : `status_icon`/`role_icon` renvoient des marqueurs texte maison (`[OK]`/`[WARN]`/`[CRIT]`, `[agent]`/`[mem]`…) au lieu d'emojis (un SVG ne s'affiche pas en terminal) ; `test_python_tools` aligné. Exemples docs `creating-agents`/`archetype-guide` : emojis `icon:` → noms d'icônes maison / texte.
+- **BMAD retiré de l'outil shell legacy** — `framework/tools/grimoire-setup.py` ne synchronise plus `_bmad/{bmm,core,cis,tea,bmb}` (suppression `MODULE_CONFIGS`/`check_config_file`/`apply_config_file`) ; propage l'identité vers `project-context.yaml` + `.github/copilot-instructions.md`. `grimoire.sh` inchangé. `test_grimoire_setup` aligné. **Reste** : références `_bmad`/« BMAD » résiduelles dans ~10 autres outils framework (scanners) + emojis dans les `print()` framework — sweep dédié.
+
+## [3.13.0] - 2026-06-25
+
+### Changé
+
+- **BMAD retiré de `grimoire setup` (SDK)** — `grimoire setup` ne synchronise plus les configs de modules `_bmad/{bmm,core,cis,tea,bmb}/config.yaml` (taxonomie legacy que le scaffold actuel ne crée plus) ; il propage l'identité utilisateur (source `project-context.yaml`) vers `.github/copilot-instructions.md` uniquement. Docstrings (`app.py`, `project.py`) et docs (getting-started, grimoire-yaml-reference, onboarding) nettoyés de la marque « BMAD » (« BMad Master » → « Grimoire Master »). Noms de modules internes (bmm/core/cis/tea/bmb) conservés. **Reste à traiter** : l'outil shell legacy `framework/tools/grimoire-setup.py` (+ `grimoire.sh`, test non-CI) — décision standalone vs délégation SDK.
+
+## [3.12.0] - 2026-06-25
+
+### Changé
+
+- **Icônes maison pour les champs `icon:` (zéro emoji) — étape 1 de la purge emoji** — les valeurs `icon:` des archétypes, agents et de la taxonomie `agent_forge` ne sont plus des emojis Unicode mais des **noms d'icônes maison** (réf `docs/assets/icons/*.svg` : `server`, `shield-pulse`, `sparkle`, `plug`, `flask`, `wrench`, `network`, `chart`, `clipboard`, `bolt`, `grimoire`, `hexagon`, `temple`, `microscope`, `lightbulb`, `boomerang`, `seal`). 16 fichiers DNA + taxonomie SDK & framework + tests alignés. Politique : aucun emoji Unicode, icônes maison uniquement.
+
+## [3.11.5] - 2026-06-25
+
+### Corrigé
+
+- **Review documentation web — couverture du standard agentique** — `index.md`, `concepts.md` et `cli-reference.md` couvrent désormais le standard agentique gouverné (fonctionnalité clé, concept dédié, groupe de commandes `grimoire standard …`), jusqu'ici absent de toute la doc cœur malgré v3.5–v3.11. Arbre d'architecture corrigé (mémoire : Weaviate/Neo4j/Qdrant). Emojis de diagramme (✅/🔴) remplacés par marques typographiques (✓/✗). Build `mkdocs --strict` propre ; nav 36/36 sans orphelin ni lien cassé.
+
+## [3.11.4] - 2026-06-25
+
+### Corrigé
+
+- **Icônes maison uniquement (zéro emoji Unicode)** — purge des emojis Unicode du README : marqueur expérimental → icône maison `flask.svg`, section SDK Python (`🐍`) → `server.svg`. Politique projet : aucun emoji Unicode dans la documentation, toutes les icônes sont des SVG maison (`docs/assets/icons/`).
+
+## [3.11.3] - 2026-06-25
+
+### Corrigé
+
+- **Passe d'honnêteté + maturité sur le README** — marqueurs « expérimental » (icône maison flask) sur les features exploratoires (Session Branching, Agent Darwinism, Stigmergy, Dream Mode, R&D Engine, les 15+ avancées) + légende de maturité ; reformulation des claims sur-vendus (« blockchain légère » → journal **hash-chaîné** sha256 ; « reinforcement learning » → **bandit ε-greedy** ; « Protocole BFT » → quorum ; « intelligence émergente » → coordination émergente) ; mise en avant du **standard agentique gouverné** comme différenciateur mûr. Aucune feature retirée — toutes sont réelles et testées.
+
+## [3.11.2] - 2026-06-25
+
+### Corrigé
+
+- **`framework/memory` : env var canonique `GRIMOIRE_*`** — la sélection de backend lit désormais `GRIMOIRE_QDRANT_URL`/`GRIMOIRE_OLLAMA_URL` (casse de l'écosystème) avec repli **rétro-compatible** sur l'ancienne casse `Grimoire_*` (helper `_env_url`). Corrige le non-respect silencieux des overrides d'environnement sans casser les setups existants. Couvert par `tests/unit/test_framework_memory_backends.py`.
+- **Durcissement lint `framework/memory`** — chaînage `raise … from None` sur les ré-émissions d'`ImportError` (B904), nettoyage `F401`/`RUF013`/`F541`/`E401`, `E741` reporté (script legacy non testé). Les patterns de probing tolérant aux pannes (`S110`/`S310`) sont conservés intentionnellement.
+
+## [3.11.1] - 2026-06-25
+
+### Corrigé
+
+- **Parcours getting-started complété** — ajout des sections « Adopter le standard agentique gouverné » (`grimoire standard needs/init/verify/audit/score/gate`) et « Portabilité multi-assistant » (entrypoints CLAUDE/AGENTS/GEMINI/.cursorrules + `.mcp.json`), absentes du guide de démarrage malgré les releases v3.5–v3.11.
+
+## [3.11.0] - 2026-06-25
+
+### Ajouté
+
+- **Page de référence des contrôles gouvernés** (`docs/governed-controls.md`) — les 36 patterns regroupés par catégorie (intention, profil minimal, artefact, checks clés), **générée** depuis `pattern-catalog.yaml` via `docs/gen-governed-controls.py` (source unique, zéro drift) et ajoutée à la navigation. Test anti-drift `test_governed_controls_doc_covers_all_patterns` : tout pattern de `capability-map.yaml` doit être documenté. Comble le manque de documentation par-contrôle (jusqu'ici seulement dans les YAML).
+
+## [3.10.2] - 2026-06-25
+
+### Corrigé
+
+- **Hygiène lint `framework/memory`** — corrections ruff *sans impact comportemental* (tri d'imports, f-strings sans placeholder, mode `open()` redondant) sur le bridge mémoire legacy. Les patterns intentionnels (probing backend `S110`/`S310`) et les items risqués à toucher en code non testé (`B904`/`E741`) restent en dette tracée.
+- **Flag : convention d'env var `framework/memory`** — le code lit `Grimoire_*` (casse mixte), divergente de `GRIMOIRE_*` (reste de l'écosystème) → un override `GRIMOIRE_QDRANT_URL` n'y est pas pris en compte. Cohérent dans tout `framework/memory` (legacy, non testé) ; **non corrigé** (casserait les setups existants) — signalé en code + backlog.
+
+## [3.10.1] - 2026-06-25
+
+### Corrigé
+
+- **Attribution de score des contrôles gouvernés** — les checks des contrôles ajoutés en v3.6–v3.8 sont désormais routés vers leur dimension de score naturelle (`compression.`→context_contract, `integrity.`→memory_policy, `cost.`→provider_policy, `council.`→decision_graph, `guardrail.`→rule_packs, `merge.`/`cluster.`/`env.`→ci_release_gate, `wsm.`/`flowdsl.`/`runtime.`/`k8s.`→orchestration_policy, `visual.`/`browser.`→evidence_gates, `privilege.`/`firewall.`/`workspace.`/`tools.blast_radius`→hook_registry, `promptver.`→observability_cockpit) au lieu du bucket générique `artifacts`. `grimoire standard score` reflète ainsi correctement ces contrôles. Aucun impact sur les profils par défaut (contrôles optionnels, non scaffoldés).
+
+## [3.10.0] - 2026-06-25
+
+### Ajouté
+
+- **`.mcp.json` portable généré par `grimoire init`** — enregistre le serveur MCP Grimoire via l'entrypoint console `grimoire-mcp` (OS-neutre, aucun chemin absolu codé en dur), lu par Claude Code, Cursor et autres clients MCP. Complète l'adaptivité multi-assistant : le MCP fonctionne out-of-the-box après `pip install 'grimoire-kit[mcp]'`. Non écrasé s'il existe déjà.
+
+## [3.9.0] - 2026-06-25
+
+### Ajouté
+
+- **Entrypoints multi-assistant portables** — `grimoire init` génère désormais, à côté de `.github/copilot-instructions.md`, des entrypoints `CLAUDE.md` (Claude Code, via import `@`), `AGENTS.md` (standard cross-tool : Codex et autres), `GEMINI.md` (Gemini CLI) et `.cursorrules` (Cursor), tous pointant vers le fichier canonique (source unique, zéro drift, non écrasés s'ils existent). Un projet Grimoire fonctionne ainsi avec Copilot, Claude, Codex, Gemini et Cursor sans configuration manuelle. Comble le gap d'adaptivité multi-assistant (jusqu'ici Copilot/VS Code-first + MCP uniquement).
+
+## [3.8.0] - 2026-06-25
+
+### Ajouté
+
+- **2 contrats déclaratifs (clôture du backlog déclaratif)** — `workflow-state-manifest` (machine à états de mission durable : états, transitions gardées, interrupts ; exécution déléguée à LangGraph/Conductor) et `k8s-agent-manifest` (contrat K8s déclaratif : CRD, resource limits, network allowlist, service account, OTel ; provider natif délégué à kagent). Catalogue de patterns **34 → 36** ; **`planned_capabilities` désormais vide** — tout le déclarable est implémenté, ne restent que les adapters runtime externes (LangGraph, kagent).
+
+### Corrigé
+
+- **README à jour** — badge de version corrigé (3.1.0 → 3.8.0) et ajout de la section « Standard agentique gouverné » (profils, 36 patterns, `verify`/`audit`/`score`/`gate`) qui manquait totalement malgré les releases v3.5–v3.7.
+- **CITATION.cff** — version et date alignées (3.1.0/2025 → 3.8.0/2026).
+
+## [3.7.0] - 2026-06-25
+
+### Ajouté
+
+- **8 contrats déclaratifs (lot benchmark v3.7)** — concrétisation des capacités `planned_capabilities` purement déclaratives, recette `capability-map` + template + `_verify_*` fail-closed + test : `workspace-isolation`, `policy-by-environment`, `browser-tool-contract`, `runtime-provider-contract`, `prompt-version-observability`, `cluster-action-dry-run`, `doc-to-graph-pipeline`, `flow-dsl-minimal`. Catalogue de patterns **26 → 34**. Chaque template vérifie *clean* (test paramétré `test_control_template_verifies_clean`). Promotion `planned_capabilities` → `mapped_capabilities` dans les profils concernés (controlled/orchestrated/governed/production) ; restent en `planned` les 2 sous-systèmes à adapter externe (`workflow-state-engine`/LangGraph, `kubernetes-agent-control-plane`/kagent).
+
+## [3.6.1] - 2026-06-25
+
+### Corrigé
+
+- **Cohérence capability-map ↔ profils** — `mapped_capabilities` de chaque profil ne référence plus que des patterns réels ; les capacités encore non implémentées sont déplacées dans un nouveau champ `planned_capabilities`. Les 11 contrôles v3.6.0 sont rattachés aux bons profils (ex. `agent-privilege-boundary`/`decision-council-gate` → governed, `prompt-injection-firewall`/`guardrail-contract` → controlled). Test garde-fou `test_profile_mapped_capabilities_are_real_patterns` (mapped ⊆ patterns ; planned ∩ patterns = ∅) — l'incohérence ne peut plus réapparaître.
+- **Vérificateur Completion Contract (`framework/cc-verify.sh`)** — résout désormais l'interpréteur du virtualenv projet (`.venv/bin/python`) pour pytest/ruff, avec fallback PATH et saut gracieux si indisponible (corrige un `ModuleNotFoundError` bloquant quand pytest n'est pas installé globalement).
+
+## [3.6.0] - 2026-06-25
+
+### Ajouté
+
+- **11 contrôles gouvernés benchmark-driven** — issus de la comparaison avec le corpus agentique de référence (37 projets), concrétisant des capacités jusqu'ici seulement nommées dans `profile-map.yaml` : `tool-blast-radius-limiter`, `agent-privilege-boundary` (ScrubTokenEnv controller/agent), `prompt-injection-firewall` (GOV-12), `remote-hygiene-guard` (GOV-13), `decision-council-gate` (GOV-14), `context-compression-gate`, `memory-integrity-validator`, `merge-lane-fault-classifier`, `llm-cost-registry` (coût + SLO CrashRate/UnhealthyRate), `guardrail-contract` (input/output/tool/model versionnés), `visual-evidence-gate` (QUA-12). Chacun : pattern (`capability-map.yaml` + `pattern-catalog.yaml`), artefact + template, vérification `_verify_*` fail-closed dans `grimoire standard verify`. Catalogue de patterns 15 → 26.
+- **Benchmark corpus & matrice d'écarts** — `docs/agentic-standard-benchmark-corpus-2026Q2.md` (22 patterns + 15 contrôles cibles vs couverture réelle) et `docs/travaux-inacheves-2026Q2.md` (backlog priorisé : v3.7.0+, Memory OS, R&D à porter, dette repo, branches/PR en attente).
+- **Rampe « commencer petit » pour l'installation par besoins** — le `needs-catalog.yaml` est désormais **tiéré** (`essential` / `advanced` / `enterprise`) avec un besoin de départ recommandé (`solo-prototyping`, marqué `▶`). `grimoire standard needs` regroupe les besoins par tier et affiche leur **empreinte** (profil · nombre de patterns · nombre de services externes) ; `grimoire standard needs --explain` révèle à la demande les patterns derrière chaque besoin (divulgation progressive). L'assistant `standard init --interactive` ordonne les besoins essentiels d'abord et pré-sélectionne le besoin recommandé (Entrée = recommandé). Documentation : section « Commencer petit (rampe progressive) » dans `docs/agentic-standard-install-by-needs.md`.
+
+### Changé
+
+- **Défaut minimal de `grimoire standard init`** — sans `--needs`/`--profile`, l'init scaffolde désormais le profil **`starter`** (au lieu de `orchestrated`), avec un rappel pour choisir par besoin. Le comportement résolu via `--needs`/`--pattern` est inchangé.
+
+## [3.5.0] - 2026-06-08
+
+### Ajouté
+
+- **Installation par besoins** — nouvelle couche d'installation custom : `grimoire standard needs`, `standard plan --needs ...`, `standard init --needs/--pattern/--memory/--interactive` et `standard doctor`. Deux fichiers déclaratifs (`framework/agentic-standard/capability-map.yaml`, `needs-catalog.yaml`) résolvent un besoin projet en profil + patterns + artefacts + extras technologiques, et écrivent un `install-manifest.yaml` auditable. Auto-install des extras opt-in via `--install-extras`.
+- **Parité patterns R8/R9/R10** — back-port dans les templates Kit des patterns `redis-hot-memory-soft-gate`, `governed-hook-gateway`, `skill-classification-matrix`, `governed-observability-cockpit`, des familles de règles `hooks`/`skills`/`observability`, du contrat `observability-policy.yaml`, de la taxonomie `managed_sources` et de la dimension de score `observability_cockpit`.
+- **Catalogue de patterns étendu (9 → 15)** — ajout de `code-graph-projection` (neo4j), `governed-agent-orchestration`, `governed-knowledge-indexing`, `mission-evidence-ledger`, `tool-mediation-gate` (mcp) et `provider-cost-slo`, câblés dans `capability-map.yaml` et `needs-catalog.yaml`.
+- **Memory OS cible** — portage du socle Weaviate + Neo4j + SQLite sidecar, migration Qdrant -> Weaviate/Neo4j, projections graph/vector, commandes `grimoire memory graph`, `memory vector`, `memory gate` et noyaux missions/evidence/policies/runtime/traces/bridges/evals.
+- **Standard Memory OS** — `grimoire standard init/verify/audit/score/gate` vérifie maintenant un contrat Memory OS cible : Redis hot memory, Weaviate mémoire sémantique durable, Neo4j projection graphe, SQLite sidecar/fallback et Qdrant en source legacy/migration uniquement.
+
+### Changé
+
+- **Détection mémoire** — `grimoire init --backend auto` privilégie désormais Weaviate quand il est disponible localement, conserve Qdrant comme fallback compatible (`qdrant-local`), puis Ollama et le backend local.
+
 ## [3.4.4] - 2026-05-29
 
 ### Corrigé

grimoire_kit-3.4.4/README.md → grimoire_kit-3.16.0/PKG-INFO

@@ -1,3 +1,72 @@
+Metadata-Version: 2.4
+Name: grimoire-kit
+Version: 3.16.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
+Project-URL: Documentation, https://guilhem-bonnet.github.io/Grimoire-kit/
+Project-URL: Changelog, https://github.com/Guilhem-Bonnet/Grimoire-kit/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Guilhem-Bonnet/Grimoire-kit/issues
+Author: Guilhem Bonnet
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,copilot,llm,mcp,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: rich>=13.0
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: chromadb<0.7,>=0.6; extra == 'all'
+Requires-Dist: mcp>=1.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'
+Requires-Dist: redis>=5.0; extra == 'all'
+Requires-Dist: sentence-transformers>=3.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: chromadb<0.7,>=0.6; extra == 'dev'
+Requires-Dist: mcp>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: neo4j>=5.0; extra == 'dev'
+Requires-Dist: ollama>=0.3; extra == 'dev'
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: qdrant-client>=1.9; extra == 'dev'
+Requires-Dist: redis>=5.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: sentence-transformers>=3.0; extra == 'dev'
+Provides-Extra: docs
+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>=1.0; extra == 'mcp'
+Provides-Extra: mempalace
+Requires-Dist: chromadb<0.7,>=0.6; extra == 'mempalace'
+Provides-Extra: neo4j
+Requires-Dist: neo4j>=5.0; extra == 'neo4j'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.3; extra == 'ollama'
+Provides-Extra: qdrant
+Requires-Dist: qdrant-client>=1.9; extra == 'qdrant'
+Requires-Dist: sentence-transformers>=3.0; extra == 'qdrant'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == 'redis'
+Provides-Extra: weaviate
+Requires-Dist: sentence-transformers>=3.0; extra == 'weaviate'
+Description-Content-Type: text/markdown
+
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.svg">
   <source media="(prefers-color-scheme: light)" srcset="docs/assets/banner-light.svg">
@@ -8,7 +77,7 @@
   <a href="https://github.com/Guilhem-Bonnet/Grimoire-kit/actions/workflows/ci-sdk.yml"><img src="https://img.shields.io/github/actions/workflow/status/Guilhem-Bonnet/Grimoire-kit/ci-sdk.yml?branch=main&style=for-the-badge&logo=github-actions&logoColor=white&label=CI" alt="CI"></a>
   <a href="https://pypi.org/project/grimoire-kit/"><img src="https://img.shields.io/pypi/v/grimoire-kit?style=for-the-badge&logo=pypi&logoColor=white&color=3775A9" alt="PyPI"></a>
   <a href="https://guilhem-bonnet.github.io/Grimoire-kit/"><img src="https://img.shields.io/badge/docs-online-8ca1ff?style=for-the-badge&logo=materialformkdocs&logoColor=white" alt="Docs"></a>
-  <a href="https://github.com/Guilhem-Bonnet/Grimoire-kit/releases"><img src="https://img.shields.io/badge/version-3.1.0-a371f7?style=for-the-badge&logo=github&logoColor=white" alt="Version"></a>
+  <a href="https://github.com/Guilhem-Bonnet/Grimoire-kit/releases"><img src="https://img.shields.io/badge/version-3.8.0-a371f7?style=for-the-badge&logo=github&logoColor=white" alt="Version"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-f0c674?style=for-the-badge" alt="License"></a>
   <a href="#-tests"><img src="https://img.shields.io/badge/tests-4430+-58a6ff?style=for-the-badge&logo=pytest&logoColor=white" alt="Tests"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.12+-3572A5?style=for-the-badge&logo=python&logoColor=white" alt="Python"></a>
@@ -97,9 +166,6 @@ Grimoire Kit déploie des **équipes d'agents IA** qui fonctionnent comme une vr
 # Installation via pipx (recommandé)
 pipx install grimoire-kit
 
-# Installation recommandée pour le moment
-pipx install grimoire-kit
-
 # Ou via pip dans un venv
 python3 -m venv .venv && source .venv/bin/activate
 pip install grimoire-kit
@@ -119,6 +185,58 @@ grimoire upgrade --dry-run   # aperçu
 grimoire upgrade             # exécuter
 ```
 
+> **Multi-assistant** — `grimoire init` génère des entrypoints portables
+> (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.cursorrules`) pointant vers
+> `.github/copilot-instructions.md` : le projet fonctionne avec Copilot, Claude Code,
+> Codex, Gemini CLI et Cursor sans duplication. Un `.mcp.json` enregistre aussi le
+> serveur MCP Grimoire (OS-neutre, via `grimoire-mcp`).
+
+
+### Installation par besoins (commencer petit)
+
+Plutôt que de tout activer, déclarez **ce que votre projet doit faire** : Grimoire
+résout le bon profil, les patterns à activer et les technologies à installer. On
+commence par l'essentiel, on grandit au besoin.
+
+```bash
+# 1. Voir les besoins, groupés par tier, avec leur empreinte (profil · patterns · services)
+grimoire standard needs
+
+# 2. Prévisualiser le plan d'un besoin sans rien écrire (profil + patterns + techno + pip)
+grimoire standard plan --needs solo-prototyping
+
+# 3. Scaffolder le projet pour ce besoin (point de départ minimal recommandé)
+grimoire standard init . --needs solo-prototyping
+
+# Assistant interactif : essentials d'abord, départ recommandé pré-sélectionné
+grimoire standard init . --interactive
+
+# Vérifier que les technologies optionnelles sont disponibles (dégradation sûre sinon)
+grimoire standard doctor
+```
+
+> Détails et matrice complète besoins → patterns → technologie :
+> [docs/agentic-standard-install-by-needs.md](docs/agentic-standard-install-by-needs.md).
+
+### <img src="docs/assets/icons/seal.svg" width="24" height="24" alt=""> Standard agentique gouverné (depuis v3.5)
+
+Le besoin choisi mappe sur un **profil** (`starter → controlled → orchestrated → governed → production`)
+qui active des **patterns gouvernés vérifiables** — **36 au catalogue** (sécurité, gouvernance, contexte,
+mémoire, observabilité, runtime, qualité…). Chaque pattern pose un artefact déclaratif
+(`_grimoire/standard/*.yaml`) et un contrôle *fail-closed* vérifié en continu :
+
+```bash
+grimoire standard verify   # artefacts présents + conformes au profil
+grimoire standard audit    # rapport de conformité
+grimoire standard score    # score de conformité multidimensionnel
+grimoire standard gate     # gate CI : échoue si une preuve obligatoire manque
+```
+
+Exemples de contrôles : blast-radius outil, séparation de privilèges controller/agent (ScrubTokenEnv),
+firewall d'injection de prompt, council de décision, intégrité mémoire, registre de coût LLM + SLO,
+contrat de guardrails (input/output/tool/model), preuve visuelle, isolation workspace, policy par
+environnement. Voir [docs/agentic-standard-integration.md](docs/agentic-standard-integration.md).
+
 <details>
 <summary><b>Installation classique (clone)</b></summary>
 
@@ -180,6 +298,10 @@ flowchart TB
 
 ## <img src="docs/assets/icons/sparkle.svg" width="28" height="28" alt=""> Features
 
+> **Maturité** : l'icône <img src="docs/assets/icons/flask.svg" width="14" height="14" alt=""> marque les features expérimentales / R&D (fonctionnent et testées, mais surface exploratoire) ; sans icône = cœur mûr.
+> Le différenciateur le plus mûr est le **[standard agentique gouverné](docs/governed-controls.md)** — 36 patterns
+> vérifiés (`grimoire standard verify` / `audit` / `score` / `gate`), cf. la section Quick Start ci-dessus.
+
 <table>
 <tr>
 <td align="center" width="33%">
@@ -214,7 +336,7 @@ L'orchestrateur décompose, **délègue en parallèle** à des sous-agents, et a
 </td>
 <td align="center">
 
-### <img src="docs/assets/icons/branch.svg" width="24" height="24" alt=""> Session Branching
+### <img src="docs/assets/icons/branch.svg" width="24" height="24" alt=""> Session Branching <img src="docs/assets/icons/flask.svg" width="18" height="18" alt="expérimental">
 
 Explorez plusieurs approches en parallèle — comme des branches Git, mais pour vos sessions d'agents. Diff, merge, cherry-pick.
 
@@ -237,23 +359,23 @@ Système immunitaire : détecte les anomalies, diagnostique, et propose des rép
 </td>
 <td align="center">
 
-### <img src="docs/assets/icons/dna.svg" width="24" height="24" alt=""> Agent Darwinism
+### <img src="docs/assets/icons/dna.svg" width="24" height="24" alt=""> Agent Darwinism <img src="docs/assets/icons/flask.svg" width="18" height="18" alt="expérimental">
 
 Sélection naturelle des agents : fitness multi-dimensionnelle, évolution par générations, leaderboard, hybridation.
 
 </td>
 <td align="center">
 
-### <img src="docs/assets/icons/network.svg" width="24" height="24" alt=""> Stigmergy
+### <img src="docs/assets/icons/network.svg" width="24" height="24" alt=""> Stigmergy <img src="docs/assets/icons/flask.svg" width="18" height="18" alt="expérimental">
 
-Coordination **indirecte** par phéromones numériques : émission, détection, amplification, évaporation. Intelligence émergente.
+Coordination **indirecte** par phéromones numériques : émission, détection, amplification, évaporation. Coordination émergente.
 
 </td>
 </tr>
 <tr>
 <td align="center">
 
-### <img src="docs/assets/icons/moon.svg" width="24" height="24" alt=""> Dream Mode
+### <img src="docs/assets/icons/moon.svg" width="24" height="24" alt=""> Dream Mode <img src="docs/assets/icons/flask.svg" width="18" height="18" alt="expérimental">
 
 Consolidation **hors-session** : croise mémoire, trace, décisions et failure museum pour produire des insights émergents.
 
@@ -267,21 +389,22 @@ Expose Grimoire comme serveur MCP local. Compatible **Cursor, Cline, Claude Desk
 </td>
 <td align="center">
 
-### <img src="docs/assets/icons/microscope.svg" width="24" height="24" alt=""> R&D Engine v2.1
+### <img src="docs/assets/icons/microscope.svg" width="24" height="24" alt=""> R&D Engine v2.1 <img src="docs/assets/icons/flask.svg" width="18" height="18" alt="expérimental">
 
-Innovation autonome : reinforcement learning, closed-loop reward, prototypage automatique, seed memory, gap-analysis.
+Boucle d'innovation : **bandit ε-greedy** à reward closed-loop, prototypage automatique, seed memory, gap-analysis.
 
 </td>
 </tr>
 </table>
 
 <details>
-<summary><b>Et bien plus encore... (15+ features avancées)</b></summary>
+<summary><b>Et bien plus encore... (15+ features avancées expérimentales)</b></summary>
 <br>
 
 | Feature | Description |
 |:--------|:-----------|
-| **Adversarial Consensus** | Protocole BFT : 3 votants + 1 avocat du diable pour les décisions critiques |
+| **Installation par besoins** | Déclarez le besoin du projet → profil, patterns et technos résolus ; commencer petit, grandir au besoin (`grimoire standard needs`) |
+| **Adversarial Consensus** | Quorum à 3 votants + 1 avocat du diable pour les décisions critiques |
 | **Anti-Fragile Score** | Mesure la résilience adaptative (recovery, learning velocity, signal trend) |
 | **Reasoning Stream** | Flux structuré : HYPOTHESIS, DOUBT, ASSUMPTION, ALTERNATIVE |
 | **Cross-Project Migration** | Exporte/importe learnings, rules, DNA, agents entre projets |
@@ -289,7 +412,7 @@ Innovation autonome : reinforcement learning, closed-loop reward, prototypage au
 | **Quantum Branch** | Timelines parallèles : fork, compare, merge de configurations alternatives |
 | **Time-Travel** | Archéologie temporelle : checkpoints, replay, restore, bisect |
 | **CRISPR** | Édition chirurgicale de workflows : scan, splice, excise, transplant |
-| **Decision Log** | Blockchain légère de décisions architecturales avec vérification d'intégrité |
+| **Decision Log** | Journal de décisions architecturales **hash-chaîné** (sha256, `prev_hash`) avec vérification d'intégrité |
 | **Mirror Agent** | Neurones miroirs : observation et transfert de patterns inter-agents |
 | **Sensory Buffer** | Mémoire sensorielle court terme à décroissance exponentielle |
 | **Self-Improvement Loop** | Analyse les patterns d'échec → améliore le framework automatiquement |
@@ -305,7 +428,7 @@ Innovation autonome : reinforcement learning, closed-loop reward, prototypage au
 
 <br>
 
-## 🐍 SDK Python (v3)
+## <img src="docs/assets/icons/server.svg" width="28" height="28" alt=""> SDK Python (v3)
 
 Le SDK v3 expose **toute la puissance de Grimoire** en tant que package Python installable :