grimoire-kit 3.4.0__tar.gz → 3.4.2__tar.gz

{grimoire_kit-3.4.0 → grimoire_kit-3.4.2}/.gitignore

@@ -32,6 +32,7 @@ Thumbs.db
 # Virtual environments
 venv/
 .venv/
+.venv-release/
 env/
 
 # Secrets (never commit)

{grimoire_kit-3.4.0 → grimoire_kit-3.4.2}/CHANGELOG.md

@@ -7,6 +7,16 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
 
 ## [Unreleased]
 
+## [3.4.2] - 2026-03-30
+
+### Corrigé
+
+- **Init mémoire: durcissement non-interactif** — la réutilisation auto d'un setup détecté valide désormais la reachability (Qdrant/Ollama) avant sélection backend.
+- **Secrets: non persistance dans project-context.yaml** — `qdrant_api_key` détectée n'est plus écrite automatiquement dans la configuration projet; usage recommandé via variable d'environnement.
+- **Init YAML: échappement des remplacements sed** — les URLs injectées sont échappées pour éviter la corruption YAML quand des caractères spéciaux sont présents.
+- **Backend Qdrant: compat env vars** — prise en charge de `GRIMOIRE_QDRANT_API_KEY` en plus de `Grimoire_QDRANT_API_KEY`.
+- **README: rendu architecture GitHub** — suppression du wrapper HTML autour du diagramme Mermaid pour un rendu fiable sur GitHub.
+
 ### Ajouté
 
 - **CLI: A1 — `--debug` / `-D` flag global** — Expose GRIMOIRE_DEBUG en flag CLI (à la ruff/uv). Fonctionne aussi via `GRIMOIRE_DEBUG=1` env var. Active les tracebacks complets via Rich. Message d'erreur mis à jour : « Use --debug or set GRIMOIRE_DEBUG=1 » (Round 37)

{grimoire_kit-3.4.0 → grimoire_kit-3.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: grimoire-kit
-Version: 3.4.0
+Version: 3.4.2
 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
@@ -190,52 +190,41 @@ pip install -e ".[dev]"
 
 ## <img src="docs/assets/icons/temple.svg" width="28" height="28" alt=""> Architecture
 
-<table>
-<tr><td>
-
 ```mermaid
-graph TB
-    subgraph VISION["TEAM VISION"]
-        PM["PM"]
-        AN["Analyst"]
-        UX["UX Designer"]
-    end
-
-    subgraph BUILD["TEAM BUILD"]
-        DEV["Dev"]
-        ARCH["Architect"]
-        QA["QA"]
-        SM["Scrum Master"]
-    end
-
-    subgraph OPS["TEAM OPS"]
-        INFRA["Infra"]
-        SEC["Security"]
-        MON["Monitoring"]
-    end
-
-    subgraph ENGINE["GRIMOIRE ENGINE"]
-        MEM["Semantic Memory"]
-        TOOLS["93+ Tools"]
-        PROTO["Protocols"]
-        HEAL["Self-Healing"]
-    end
-
-    VISION -- "Delivery Contract" --> BUILD
-    BUILD -- "Delivery Contract" --> OPS
-    ENGINE -.- VISION
-    ENGINE -.- BUILD
-    ENGINE -.- OPS
-
-    style VISION fill:#1a1040,stroke:#a371f7,color:#c9d1d9
-    style BUILD fill:#0d2818,stroke:#3fb950,color:#c9d1d9
-    style OPS fill:#2d1a02,stroke:#d29922,color:#c9d1d9
-    style ENGINE fill:#0d1117,stroke:#58a6ff,color:#c9d1d9
+flowchart TB
+  subgraph VISION[TEAM VISION]
+    PM[PM]
+    AN[Analyst]
+    UX[UX Designer]
+  end
+
+  subgraph BUILD[TEAM BUILD]
+    DEV[Dev]
+    ARCH[Architect]
+    QA[QA]
+    SM[Scrum Master]
+  end
+
+  subgraph OPS[TEAM OPS]
+    INFRA[Infra]
+    SEC[Security]
+    MON[Monitoring]
+  end
+
+  subgraph ENGINE[GRIMOIRE ENGINE]
+    MEM[Semantic Memory]
+    TOOLS[93+ Tools]
+    PROTO[Protocols]
+    HEAL[Self-Healing]
+  end
+
+  VISION -- Delivery Contract --> BUILD
+  BUILD -- Delivery Contract --> OPS
+  ENGINE -. support .-> VISION
+  ENGINE -. support .-> BUILD
+  ENGINE -. support .-> OPS
 ```
 
-</td></tr>
-</table>
-
 **Règle fondamentale** : aucune team ne commence sans un **Delivery Contract** signé de la team précédente. Zéro handoff informel.
 
 <br>

{grimoire_kit-3.4.0 → grimoire_kit-3.4.2}/README.md

@@ -135,52 +135,41 @@ pip install -e ".[dev]"
 
 ## <img src="docs/assets/icons/temple.svg" width="28" height="28" alt=""> Architecture
 
-<table>
-<tr><td>
-
 ```mermaid
-graph TB
-    subgraph VISION["TEAM VISION"]
-        PM["PM"]
-        AN["Analyst"]
-        UX["UX Designer"]
-    end
-
-    subgraph BUILD["TEAM BUILD"]
-        DEV["Dev"]
-        ARCH["Architect"]
-        QA["QA"]
-        SM["Scrum Master"]
-    end
-
-    subgraph OPS["TEAM OPS"]
-        INFRA["Infra"]
-        SEC["Security"]
-        MON["Monitoring"]
-    end
-
-    subgraph ENGINE["GRIMOIRE ENGINE"]
-        MEM["Semantic Memory"]
-        TOOLS["93+ Tools"]
-        PROTO["Protocols"]
-        HEAL["Self-Healing"]
-    end
-
-    VISION -- "Delivery Contract" --> BUILD
-    BUILD -- "Delivery Contract" --> OPS
-    ENGINE -.- VISION
-    ENGINE -.- BUILD
-    ENGINE -.- OPS
-
-    style VISION fill:#1a1040,stroke:#a371f7,color:#c9d1d9
-    style BUILD fill:#0d2818,stroke:#3fb950,color:#c9d1d9
-    style OPS fill:#2d1a02,stroke:#d29922,color:#c9d1d9
-    style ENGINE fill:#0d1117,stroke:#58a6ff,color:#c9d1d9
+flowchart TB
+  subgraph VISION[TEAM VISION]
+    PM[PM]
+    AN[Analyst]
+    UX[UX Designer]
+  end
+
+  subgraph BUILD[TEAM BUILD]
+    DEV[Dev]
+    ARCH[Architect]
+    QA[QA]
+    SM[Scrum Master]
+  end
+
+  subgraph OPS[TEAM OPS]
+    INFRA[Infra]
+    SEC[Security]
+    MON[Monitoring]
+  end
+
+  subgraph ENGINE[GRIMOIRE ENGINE]
+    MEM[Semantic Memory]
+    TOOLS[93+ Tools]
+    PROTO[Protocols]
+    HEAL[Self-Healing]
+  end
+
+  VISION -- Delivery Contract --> BUILD
+  BUILD -- Delivery Contract --> OPS
+  ENGINE -. support .-> VISION
+  ENGINE -. support .-> BUILD
+  ENGINE -. support .-> OPS
 ```
 
-</td></tr>
-</table>
-
 **Règle fondamentale** : aucune team ne commence sans un **Delivery Contract** signé de la team précédente. Zéro handoff informel.
 
 <br>

grimoire_kit-3.4.2/framework/copilot/instructions/grimoire-project.instructions.md

@@ -0,0 +1,104 @@
+---
+description: "Conventions du projet Grimoire. Chargé automatiquement pour tous les fichiers. Apply when: agent activation, memory files, project context, grimoire workflows, any project file."
+applyTo: "**"
+---
+
+# Conventions Grimoire — {{project_name}}
+
+## Contexte Projet
+
+Ce projet utilise **Grimoire Kit** — une plateforme d'agents IA composables.
+
+### Règle fondamentale
+
+Avant toute action, charger :
+- `{project-root}/_grimoire/_memory/shared-context.md` — contexte du projet
+- `{project-root}/_grimoire/_memory/config.yaml` — `user_name` et `communication_language`
+
+### Structure clé
+
+| Dossier | Rôle |
+|---------|------|
+| `_grimoire/_config/custom/agents/` | Agents IA internes (persona + instructions) |
+| `.github/agents/` | Wrappers VS Code Copilot (auto-générés) |
+| `.github/prompts/` | Workflows disponibles via `/` dans Copilot Chat |
+| `_grimoire/_memory/` | Mémoire persistante inter-sessions |
+| `_grimoire-output/` | Outputs des agents (lecture seule) |
+
+## Conventions de Communication
+
+- Toujours répondre en {{language}} (configuré dans `_grimoire/_memory/config.yaml`)
+- S'adresser à l'utilisateur par son prénom (`user_name` dans config)
+- Éviter le jargon technique non nécessaire
+
+## Mémoire Partagée
+
+- **decisions-log.md** — logguer toute décision architecturale significative
+- **failure-museum.md** — documenter les erreurs résolues pour éviter la récidive
+- **shared-context.md** — source de vérité sur le projet (toujours à jour)
+
+## Agents et Routing
+
+- L'agent `concierge` est le point d'entrée unique — il route vers les spécialistes
+- Les agents communiquent via `_grimoire/_memory/handoff-log.md`
+- Chaque agent doit charger `_grimoire/_config/custom/agent-base.md` au démarrage
+
+## Anti-patterns
+
+- ❌ Ne jamais deviner des informations non présentes dans `shared-context.md`
+- ❌ Ne jamais modifier les fichiers dans `.github/agents/` manuellement
+- ❌ Ne jamais supposer le stack technique — le lire depuis `project-context.yaml`
+- ❌ Ne jamais commiter des secrets ou tokens
+
+## Workflows Rapides
+
+| Prompt | Usage |
+|--------|-------|
+| `/grimoire-session-bootstrap` | Reprendre le travail après une pause |
+| `/grimoire-health-check` | Vérifier la santé du projet |
+| `/grimoire-dream` | Consolidation et insights hors-session |
+| `/grimoire-pre-push` | Validation avant push |
+| `/grimoire-changelog` | Générer les notes de version |
+| `/grimoire-status` | Tableau de bord rapide |
+| `/grimoire-self-heal` | Réparer les problèmes courants |
+
+## Guide des Workflows
+
+### Pour bien démarrer
+
+1. **Premier accès** → `/grimoire-session-bootstrap` (charge contexte)
+2. **Vérification rapide** → `/grimoire-health-check` (diagnostique)
+3. **Pendant le travail** → `/grimoire-status` (vue d'ensemble)
+4. **Avant commit** → `/grimoire-pre-push` (validation)
+5. **Fin de journée** → `/grimoire-dream` (insights)
+
+### En cas de problème
+
+- Erreur pas claire → `/grimoire-health-check`
+- Système cassé → `/grimoire-self-heal`
+- Besoin de contexte → charger `_grimoire/_memory/shared-context.md`
+
+## Activation d'un Agent
+
+Quand un agent est activé, il doit suivre ce protocole :
+
+1. ✅ **Charger le contexte** : `_grimoire/_memory/shared-context.md`
+2. ✅ **Charger la config** : `_grimoire/_memory/config.yaml`
+3. ✅ **Charger agent-base** : `_grimoire/_config/custom/agent-base.md`
+4. ✅ **Suivre les instructions** : de ce fichier exactement
+5. ✅ **Appliquer la persona** : jamais sortir de rôle
+
+## Complétion Contract
+
+Avant chaque commit, valider :
+
+```bash
+bash _grimoire/_config/custom/cc-verify.sh
+```
+
+Cela vérifie :
+- ✅ Contexte à jour
+- ✅ Memory cohérente
+- ✅ Pas de secrets
+- ✅ Decisions loggées
+- ✅ Failures documentées

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-changelog.prompt.md

@@ -0,0 +1,57 @@
+---
+description: 'Génère un CHANGELOG structuré depuis git history et les décisions Grimoire'
+agent: 'agent'
+tools: ['read', 'execute']
+---
+
+Génère un CHANGELOG structuré pour le projet Grimoire :
+
+## 1. Collecte git
+
+```bash
+cd {project-root} && git log --oneline --no-merges -30 --pretty=format:"%h %ad %s" --date=short
+```
+
+## 2. Décisions Grimoire
+
+Lis `{project-root}/_grimoire/_memory/decisions-log.md` pour les décisions architecturales récentes.
+
+## 3. Version actuelle
+
+Lis `{project-root}/project-context.yaml` pour récupérer le nom du projet.
+Si un fichier `version.txt` ou `pyproject.toml` existe, extraire la version actuelle.
+
+## 4. CHANGELOG existant
+
+Si `{project-root}/CHANGELOG.md` existe, lis les 30 premières lignes pour comprendre le format utilisé.
+
+## 5. Génération
+
+Génère un CHANGELOG au format **Keep a Changelog** (https://keepachangelog.com) :
+
+```markdown
+# Changelog
+
+## [Unreleased]
+
+### Added
+- ...
+
+### Changed
+- ...
+
+### Fixed
+- ...
+
+### Security
+- ...
+```
+
+Règles de formatage :
+- Regroupe les commits par type (feat, fix, chore, etc.)
+- Traduis les messages Conventional Commits en langue naturelle (français)
+- Inclus les décisions architecturales importantes de `decisions-log.md`
+- Ne mets que les changements significatifs (pas les chores de style)
+- Formate les références de commits en `[abc1234]`
+
+Propose la mise à jour de `{project-root}/CHANGELOG.md` avec le contenu généré.

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-dream.prompt.md

@@ -0,0 +1,63 @@
+---
+description: 'Dream Mode — consolidation hors-session, patterns cross-domaine, insights émergents'
+agent: 'agent'
+tools: ['read', 'search']
+---
+
+Lance un cycle de Dream Mode — consolidation et analyse hors-session.
+
+## 1. Collecte des sources
+
+Lis les fichiers suivants :
+- `{project-root}/_grimoire/_memory/decisions-log.md` — décisions architecturales
+- `{project-root}/_grimoire/_memory/failure-museum.md` — erreurs et résolutions
+- `{project-root}/_grimoire/_memory/shared-context.md` — contexte global
+- Les 5 derniers fichiers de `{project-root}/_grimoire/_memory/agent-learnings/` (si le dossier existe)
+
+## 2. Analyse des patterns
+
+Identifie :
+- **Patterns récurrents** : quelles erreurs ou décisions se répètent ?
+- **Dette technique** : quels problèmes sont contournés plutôt que résolus ?
+- **Opportunités d'amélioration** : où le projet pourrait être simplifié ?
+- **Connaissances émergentes** : quelles leçons nouvelles se dégagent ?
+
+## 3. Cross-domaine
+
+Cherche des connexions non évidentes entre :
+- Les patterns de code et les patterns d'organisation
+- Les décisions techniques et les objectifs business
+- Les erreurs passées et les risques futurs
+
+## 4. Rapport de Dream
+
+Produis un rapport structuré :
+
+```
+🌙 DREAM REPORT — [date]
+════════════════════════════════
+
+📊 PATTERNS DÉTECTÉS
+---
+[liste des patterns récurrents]
+
+💡 INSIGHTS
+---
+[insights cross-domaine non évidents]
+
+🌱 SEEDS (idées à incuber)
+---
+[idées prometteuses à explorer]
+
+⚠️  ALERTES
+---
+[risques ou dettes techniques à adresser]
+
+📝 RECOMMANDATIONS PRIORITAIRES
+---
+1. [action 1]
+2. [action 2]
+3. [action 3]
+```
+
+Sauvegarde le rapport dans `{project-root}/_grimoire-output/dream-journal.md` (crée ou append).

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-health-check.prompt.md

@@ -0,0 +1,62 @@
+---
+description: 'Health check complet du projet Grimoire — agents, mémoire, config, intégrité'
+agent: 'agent'
+tools: ['read', 'search', 'execute']
+---
+
+Health check complet du projet Grimoire en 5 points :
+
+## 1. Configuration
+
+Vérifie `{project-root}/project-context.yaml` :
+- Le fichier existe et est valide YAML
+- Il contient `project.name`, `user.name`, `memory.backend`
+
+## 2. Agents
+
+Vérifie `{project-root}/.github/agents/` :
+- Compte les fichiers `.agent.md` présents
+- Vérifie que chaque fichier a un frontmatter YAML avec `description:`
+- Signale les agents sans description ou avec frontmatter invalide
+
+## 3. Mémoire
+
+Vérifie les fichiers dans `{project-root}/_grimoire/_memory/` :
+- `shared-context.md` — présent et non vide ?
+- `decisions-log.md` — présent ?
+- `failure-museum.md` — messages d'erreurs récurrents à résoudre ?
+- `config.yaml` — `user_name` et `communication_language` configurés ?
+
+Lis les 20 premières lignes de `failure-museum.md` pour identifier des erreurs non résolues.
+
+## 4. Structure
+
+Vérifie que les dossiers essentiels existent :
+- `.github/agents/` — agents VS Code Copilot
+- `.github/prompts/` — prompts VS Code Copilot
+- `_grimoire/_config/custom/agents/` — agents Grimoire internes
+- `_grimoire-output/` — outputs de travail
+
+## 5. Git
+
+```bash
+cd {project-root} && git status --short && git log --oneline -5
+```
+
+Présente un **rapport de santé** :
+```
+╔══════════════════════════════╗
+║ Grimoire Health Check         ║
+╚══════════════════════════════╝
+
+✅/⚠️/❌  Configuration    ...
+✅/⚠️/❌  Agents           X agents actifs
+✅/⚠️/❌  Mémoire          ...
+✅/⚠️/❌  Structure        ...
+✅/⚠️/❌  Git              ...
+
+Score global : X/5
+
+Actions prioritaires :
+1. ...
+```

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-pre-push.prompt.md

@@ -0,0 +1,56 @@
+---
+description: 'Validation pre-push — intégrité agents, qualité code, mémoire, tests si disponibles'
+agent: 'agent'
+tools: ['read', 'search', 'execute']
+---
+
+Checklist de validation avant push Grimoire :
+
+## 1. Intégrité des agents
+
+Vérifie que les fichiers agents sont cohérents :
+```bash
+cd {project-root} && for f in .github/agents/*.agent.md; do echo "--- $f ---"; head -5 "$f"; done
+```
+
+Chaque agent doit avoir :
+- Un frontmatter YAML avec `description:`
+- Au moins une instruction de chargement du fichier interne
+
+## 2. Configuration projet
+
+Vérifie que `project-context.yaml` est valide :
+```bash
+cd {project-root} && python3 -c "import yaml; yaml.safe_load(open('project-context.yaml'))" && echo "YAML OK" || echo "YAML INVALIDE"
+```
+
+## 3. Mémoire cohérente
+
+Vérifie que la mémoire n'a pas de données corrompues :
+- `_grimoire/_memory/config.yaml` — YAML valide ?
+- `_grimoire/_memory/shared-context.md` — non vide ?
+
+## 4. Tests (si présents)
+
+Si un dossier `tests/` existe :
+```bash
+cd {project-root} && python3 -m pytest tests/ -q --tb=line -x 2>/dev/null || echo "Tests non disponibles"
+```
+
+## 5. Lint (si configuré)
+
+Si `pyproject.toml` ou `ruff.toml` existe :
+```bash
+cd {project-root} && python3 -m ruff check . --statistics -q 2>/dev/null || echo "Ruff non configuré"
+```
+
+## 6. Git diff
+
+```bash
+cd {project-root} && git diff --stat HEAD 2>/dev/null | head -20
+```
+
+Présente un résumé :
+- ✅ **Prêt à push** — tous les checks passent
+- ❌ **Bloquant** — liste des problèmes critiques à corriger
+- ⚠️  **Avertissements** — points d'attention non bloquants

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-self-heal.prompt.md

@@ -0,0 +1,64 @@
+---
+description: 'Auto-diagnostic et réparation Grimoire — identifie et corrige les problèmes courants'
+agent: 'agent'
+tools: ['read', 'search', 'execute', 'edit']
+---
+
+Diagnostique et tente de réparer les problèmes du projet Grimoire.
+
+## 1. Scan des problèmes
+
+Vérifie les points suivants et liste les problèmes trouvés :
+
+### Configuration
+- `project-context.yaml` existe et est un YAML valide ?
+- `_grimoire/_memory/config.yaml` contient `user_name` et `communication_language` ?
+
+### Agents
+- `.github/agents/` existe et contient des `.agent.md` ?
+- Les fichiers agents ont tous un frontmatter YAML avec `description:` ?
+- Les agents dans `.github/agents/` pointent vers des fichiers existants dans `_grimoire/_config/custom/agents/` ?
+
+### Mémoire
+- `_grimoire/_memory/shared-context.md` existe et n'est pas vide ?
+- Pas de fichiers JSON malformés dans `_grimoire/_memory/` ?
+
+### Structure
+- `_grimoire/_config/custom/agents/` contient des agents ?
+- `_grimoire-output/` existe ?
+
+## 2. Triage des problèmes
+
+Pour chaque problème trouvé, classifie-le :
+- 🔴 **CRITIQUE** — bloque le fonctionnement des agents
+- 🟡 **AVERTISSEMENT** — dégrade l'expérience mais ne bloque pas
+- 🔵 **INFO** — amélioration possible
+
+## 3. Réparations automatiques
+
+Pour les problèmes **critiques** simples, propose et applique :
+- Créer un `shared-context.md` vide si manquant
+- Ajouter un frontmatter YAML minimal à un agent sans description
+- Créer les dossiers manquants
+
+Pour les problèmes complexes, fournis des instructions précises à l'utilisateur.
+
+## 4. Rapport
+
+```
+🔧 GRIMOIRE SELF-HEAL REPORT
+════════════════════════════
+
+Problèmes trouvés : [n]
+  🔴 Critiques   : [n]
+  🟡 Avertissements : [n]
+  🔵 Infos       : [n]
+
+Réparations appliquées : [n]
+  ✅ [action appliquée]
+  ...
+
+Actions manuelles requises :
+  1. [instruction précise]
+  ...
+```

grimoire_kit-3.4.2/framework/copilot/prompts/grimoire-session-bootstrap.prompt.md

@@ -0,0 +1,38 @@
+---
+description: 'Bootstrap une nouvelle session Grimoire — contexte projet, historique, état git, santé'
+agent: 'agent'
+tools: ['read', 'search', 'execute']
+---
+
+Bootstrap une nouvelle session de travail Grimoire en 4 étapes :
+
+## 1. Contexte projet
+
+Lis `{project-root}/_grimoire/_memory/shared-context.md` pour comprendre le projet (nom, stack, conventions). Si absent, signale-le.
+
+## 2. Historique récent
+
+Lis `{project-root}/_grimoire/_memory/decisions-log.md` (section "Décisions récentes") et `{project-root}/_grimoire/_memory/session-state.md`. Identifie :
+- Ce qui a été accompli récemment
+- Ce qui était prévu mais non terminé
+- Les décisions architecturales majeures
+
+## 3. État git
+
+```bash
+cd {project-root} && git log --oneline -10 && git status --short
+```
+
+## 4. Santé du projet
+
+Vérifie que les fichiers clés existent :
+- `{project-root}/project-context.yaml`
+- `{project-root}/_grimoire/_config/agent-manifest.csv`
+- `{project-root}/.github/agents/` (au moins un fichier `.agent.md`)
+
+Présente un résumé concis en français :
+- **Projet** : nom, type, stack
+- **Dernières actions** : 3-5 décisions/changements récents
+- **État git** : commits récents, fichiers modifiés
+- **Santé** : ✅ tout OK ou ⚠️ problèmes détectés
+- **Prochaine étape suggérée** : action prioritaire basée sur le contexte