bmad-plus 0.12.2 → 0.13.0

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-09-08
+
+### Added
+- Registry-derived installation now delivers the common agent spine and all seven tool adapters from one renderer, with consistent pack facts and persistent execution settings.
+- Published-release discovery with `update-check` (JSON, refresh and offline modes), a 24-hour cache, and explicit project update policies. Notification is the default; automatic updates require an authorized semver range.
+- `update --latest` dispatches an exact validated package through npm, rechecks policy and ownership, refuses downgrades and wrong-version children, and requests instruction reload. All generated tool adapters include one check per session.
+- Managed-file hash inventories cover agents, skills, pack data and module files. Customized files are preserved; automatic updates refuse conflicts or incomplete legacy ownership. Updates are locked, backed up and recoverable with `update --restore <receipt-id> --yes`.
+
+### Security
+- Patch runtime `js-yaml` from 5.2.1 to 5.2.2 for [GHSA-pm4m-ph32-ghv5](https://github.com/advisories/GHSA-pm4m-ph32-ghv5). Production npm audit reports zero vulnerabilities for the validated lockfile.
+- Update and install destinations reject redirected paths; restore validates every backup before changing files and preserves subsequent local edits.
+
+### Fixed
+- Uninstall preserves project memory, settings, modified pack files, custom IDE instructions and nonempty output. Only identifiable BMAD+ files are removed after checking for symlinks/junctions; legacy installs may retain files whose ownership cannot be established.
+- Doctor and uninstall report invalid manifests with failure exit codes. Installation/removal without a terminal requires `--yes`; the npx launcher propagates child launch failures and signals.
+- MCP audit entry points validate identifiers and confine filesystem operations before deletion, cloning or metadata writes. Git URL validation is shared across audit and Git tools.
+- GitHub requests have connection/read timeouts. RAG ingestion uses the server interpreter and working directory without an undrained stderr pipe.
+
+### Quality
+- Distribution security audit explicitly checks production dependencies, matching its production-only install and the CI gate.
+- CI now blocks on pinned Ruff correctness checks and MCP tool, evaluation-backend and memory-bridge tests. SEO DNS/HTTP tests use offline fixtures.
+- JavaScript regression suite expanded to 709 tests in 31 suites, with all coverage thresholds passing. Python correctness-lint findings removed; mutable argument defaults replaced.
+- Source/npm contract verifies 64 installations, 168 generated adapters, complete managed-file hashes and offline update checks. npm execution with Windows path metacharacters is covered by a real offline process test.
+- Backlog projection completed with CLI safety, MCP hardening and Python-quality epics. Dependency modernization retains its existing decision gate.
+
 ## [0.12.2] - 2026-07-16
 
 ### Added — capabilities now actually delivered

package/README.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Augmented Multi-Agent AI Framework
 
-[![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.13.0-blue.svg)](CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
@@ -15,6 +15,8 @@
 
 ## 📋 Table of Contents
 
+Repository validation: **709 JavaScript tests** (`npm test`). Uninstall preserves project memory and customized files; use `--yes` for installation or removal without a terminal.
+
 - [Why BMAD+?](#-why-bmad-)
 - [Quick Start](#-quick-start)
 - [Architecture](#-architecture)
@@ -40,7 +42,7 @@ BMAD-METHOD is an excellent framework with 9 specialized agents. But for a solo
 | No automated pipeline | **Autopilot Mode**: idea → delivery |
 | Sequential execution | **Supervised parallelism** |
 | No persistent memory | **Cross-session brain** with project scanner |
-| 1-2 IDEs supported | **5 IDEs** with auto-detection |
+| 1-2 IDEs supported | **7 IDEs** with auto-detection |
 | 1 module | **9 modular packs** (Core, OSINT, Shield, Dev Studio, SEO, Memory...) |
 
 ---
@@ -163,6 +165,22 @@ Nexus automatically orchestrates everything with checkpoints for your approval.
 | `npx bmad-plus uninstall` | Remove BMAD+ from current project |
 | `npx bmad-plus autoconfig` | Smart project bootstrap — auto-detect, install, and configure |
 
+#### Framework updates
+
+The installed instructions ask the LLM to check once per session. Discovery uses a 24-hour cache; offline results remain unknown. Automatic updates require an explicit policy and unchanged managed files.
+
+For installations using 0.12.2 or earlier, load the new CLI once with `npx --yes bmad-plus@0.13.0 update --yes`. This explicit migration saves backups before replacing legacy files.
+
+```bash
+npx bmad-plus update-check --json
+npx bmad-plus update --latest --yes
+npx bmad-plus update-policy --mode auto --range "^0.13.0"
+npx bmad-plus update --latest --auto
+npx bmad-plus update-check --offline --json
+```
+
+Notification is the default. To stop checks, use `update-policy --mode off`. Customized agents and adapters are preserved; conflicts block automatic application. Older installations without file hashes require an explicit manual migration with backups. Each applied update reports a receipt; use `update --restore <receipt-id> --yes` to recover it, then reload the agent instructions.
+
 #### 🔬 Advanced Install Options
 
 ```bash
@@ -412,6 +430,8 @@ Give a project idea → Nexus orchestrates the complete pipeline:
 ```
 
 **Configurable checkpoints:**
+Configure `execution_mode` and `checkpoints` in `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
+
 - `require_approval` (🔴) — Pause, wait for approval
 - `notify_only` (🟡) — Notification, continues unless intervened
 - `auto` (🟢) — Continues automatically
@@ -432,15 +452,19 @@ The Orchestrator detects independent tasks and launches them in parallel:
 
 ## 🖥️ Supported IDEs
 
-The installer automatically detects IDEs and generates configs:
+The installer automatically detects IDEs and generates their adapters around a shared `AGENTS.md` instruction spine at the project root:
 
 | IDE | Config File | Detection |
 |-----|---------------|-----------|
 | Claude Code | `CLAUDE.md` | `.claude/` folder |
 | Gemini CLI | `GEMINI.md` | `.gemini/` folder |
-| Antigravity | `.gemini/` + `.agents/` | Antigravity Extension |
-| Codex CLI | `AGENTS.md` | `.codex/` folder |
-| OpenCode | `OPENCODE.md` | opencode config |
+| Antigravity | `GEMINI.md` | `.gemini/antigravity/` folder |
+| Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` folder |
+| Codex CLI | `.codex/AGENTS.md` | `.codex/` folder |
+| OpenCode | `.opencode/AGENTS.md` | `.opencode/` folder |
+| Aider | `CONVENTIONS.md` | `.aider.conf.yml` file |
+
+For Aider, add `read: CONVENTIONS.md` to `.aider.conf.yml` or run `/read CONVENTIONS.md` to load the generated instructions.
 
 ---
 
@@ -452,8 +476,12 @@ BMAD+/
 ├── readme-international/          ← Translated READMEs (fr, es, de)
 ├── CHANGELOG.md                   ← Version history
 ├── CLAUDE.md                      ← Claude Code Config
-├── GEMINI.md                      ← Gemini CLI Config
-├── AGENTS.md                      ← Codex CLI / OpenCode Config
+├── GEMINI.md                      ← Gemini CLI / Antigravity Config
+├── AGENTS.md                      ← Shared instruction spine
+├── .codex/AGENTS.md               ← Codex CLI adapter
+├── .opencode/AGENTS.md            ← OpenCode adapter
+├── .cursor/rules/bmad-plus.mdc    ← Cursor adapter
+├── CONVENTIONS.md                ← Aider adapter
 ├── .gitignore
 │
 ├── src/

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-plus",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "description": "BMAD+ — Augmented AI-Driven Development Framework with multi-role agents, autopilot, and parallel execution",
   "keywords": [
     "bmad",
@@ -34,13 +34,14 @@
     "install:bmad": "node tools/cli/bmad-plus-cli.js install",
     "update:bmad": "node tools/cli/bmad-plus-cli.js update",
     "doctor:bmad": "node tools/cli/bmad-plus-cli.js doctor",
-    "build": "node tools/build/generate.js --out tools/cli/lib/packs.js",
+    "build": "node tools/build/generate.js --out tools/cli/lib/packs.js --module-out src/bmad-plus/module.yaml",
     "build:check": "node tools/build/generate.js --check",
     "check:counts": "node tools/build/check-counts.js",
     "lint": "eslint tools/ tests/",
     "format": "prettier --write \"tools/**/*.js\" \"tests/**/*.js\"",
     "format:check": "prettier --check \"tools/**/*.js\" \"tests/**/*.js\"",
     "test": "jest --coverage",
+    "test:install-contract": "node tools/build/check-install-contract.js",
     "prepare": "husky || true",
     "uninstall:bmad": "node tools/cli/bmad-plus-cli.js uninstall"
   },
@@ -48,8 +49,9 @@
     "@clack/prompts": "^1.4.0",
     "commander": "^14.0.0",
     "fs-extra": "^11.3.6",
-    "js-yaml": "^5.2.1",
-    "picocolors": "^1.1.1"
+    "js-yaml": "^5.2.2",
+    "picocolors": "^1.1.1",
+    "semver": "^7.8.5"
   },
   "engines": {
     "node": ">=20.0.0"

package/readme-international/README.de.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Erweitertes Multi-Agent KI-Framework
 
-[![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.13.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 
@@ -15,6 +15,8 @@
 
 ## 📋 Inhaltsverzeichnis
 
+Repository-Prüfung: **709 JavaScript-Tests** (`npm test`). Die Deinstallation erhält den Projektspeicher und angepasste Dateien; für Installation oder Deinstallation ohne interaktives Terminal `--yes` verwenden.
+
 - [Warum BMAD+?](#-warum-bmad-)
 - [Schnellstart](#-schnellstart)
 - [Architektur](#-architektur)
@@ -41,7 +43,7 @@ BMAD-METHOD ist ein exzellentes Framework mit 9 spezialisierten Agenten. Für ei
 | Keine automatisierte Pipeline | **Autopilot-Modus**: Idee → Fertigstellung |
 | Sequentielle Ausführung | **Überwachte parallele Ausführung** |
 | Kein Upstream-Tracking | **Wöchentliches Monitoring** mit WhatsApp |
-| 1-2 unterstützte IDEs | **5 IDEs** mit automatischer Erkennung |
+| 1-2 unterstützte IDEs | **7 IDEs** mit automatischer Erkennung |
 
 ---
 
@@ -163,6 +165,22 @@ Nexus orchestriert alles automatisch mit Checkpoints für deine Genehmigung.
 | `npx bmad-plus uninstall` | BMAD+ vom aktuellen Projekt entfernen |
 | `npx bmad-plus autoconfig` | Intelligentes Bootstrap — Auto-Erkennung, Installation und Konfiguration |
 
+#### Framework aktualisieren
+
+Die installierten Anweisungen bitten das LLM um eine Prüfung pro Sitzung. Das Ergebnis wird 24 Stunden zwischengespeichert; offline bleibt die veröffentlichte Version unbekannt. Automatische Updates erfordern eine ausdrückliche Richtlinie und unveränderte verwaltete Dateien.
+
+Für Installationen mit 0.12.2 oder älter einmal die neue CLI mit `npx --yes bmad-plus@0.13.0 update --yes` laden. Diese ausdrückliche Migration sichert vorhandene Dateien vor dem Ersetzen.
+
+```bash
+npx bmad-plus update-check --json
+npx bmad-plus update --latest --yes
+npx bmad-plus update-policy --mode auto --range "^0.13.0"
+npx bmad-plus update --latest --auto
+npx bmad-plus update-check --offline --json
+```
+
+Standardmäßig werden Updates nur gemeldet. Mit `update-policy --mode off` lassen sich Prüfungen deaktivieren. Angepasste Agenten und Adapter bleiben erhalten; Konflikte blockieren automatische Updates. Ältere Installationen ohne Prüfsummen brauchen eine ausdrückliche manuelle Migration mit Sicherungen. Jedes Update meldet eine Sicherungskennung; `update --restore <receipt-id> --yes` stellt sie wieder her. Danach die Agentenanweisungen neu laden.
+
 #### 🔬 Erweiterte Installationsoptionen
 
 ```bash
@@ -423,6 +441,8 @@ Eine Projektidee eingeben → Nexus orchestriert die komplette Pipeline:
 ```
 
 **Konfigurierbare Checkpoints:**
+Konfiguriere `execution_mode` und `checkpoints` in `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
+
 - `require_approval` (🔴) — Pause, WhatsApp-Benachrichtigung, warten
 - `notify_only` (🟡) — Benachrichtigung, wird fortgesetzt, sofern nicht eingegriffen wird
 - `auto` (🟢) — Wird automatisch fortgesetzt
@@ -441,15 +461,19 @@ Eine Projektidee eingeben → Nexus orchestriert die komplette Pipeline:
 
 ## 🖥️ Unterstützte IDEs
 
-Das Installationsprogramm erkennt IDEs automatisch und generiert Konfigurationen:
+Das Installationsprogramm erkennt IDEs automatisch und generiert ihre Adapter mit `AGENTS.md` im Projektstamm als gemeinsame Anweisungsdatei:
 
 | IDE | Konfigurationsdatei | Erkennung |
 |-----|---------------|-----------|
 | Claude Code | `CLAUDE.md` | `.claude/` Ordner |
 | Gemini CLI | `GEMINI.md` | `.gemini/` Ordner |
-| Antigravity | `.gemini/` + `.agents/` | Antigravity-Erweiterung |
-| Codex CLI | `AGENTS.md` | `.codex/` Ordner |
-| OpenCode | `OPENCODE.md` | opencode-Konfiguration |
+| Antigravity | `GEMINI.md` | `.gemini/antigravity/` Ordner |
+| Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` Ordner |
+| Codex CLI | `.codex/AGENTS.md` | `.codex/` Ordner |
+| OpenCode | `.opencode/AGENTS.md` | `.opencode/` Ordner |
+| Aider | `CONVENTIONS.md` | Datei `.aider.conf.yml` |
+
+Für Aider ergänze `read: CONVENTIONS.md` in `.aider.conf.yml` oder führe `/read CONVENTIONS.md` aus, um die generierten Anweisungen zu laden.
 
 ---
 
@@ -473,8 +497,12 @@ BMAD+/
 ├── readme-international/          ← Übersetzungen in andere Sprachen
 ├── CHANGELOG.md                   ← Versionshistorie
 ├── CLAUDE.md                      ← Claude Code Konfiguration
-├── GEMINI.md                      ← Gemini CLI Konfiguration
-├── AGENTS.md                      ← Codex CLI / OpenCode Konfiguration
+├── GEMINI.md                      ← Gemini CLI / Antigravity Konfiguration
+├── AGENTS.md                      ← Gemeinsame Anweisungsdatei
+├── .codex/AGENTS.md               ← Codex CLI Adapter
+├── .opencode/AGENTS.md            ← OpenCode Adapter
+├── .cursor/rules/bmad-plus.mdc    ← Cursor Adapter
+├── CONVENTIONS.md                ← Aider Adapter
 ├── .gitignore
 │
 ├── src/
@@ -565,6 +593,7 @@ BMAD+/
 | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — Root-Adapter aus dem Registry adoptiert, Memory über MCP, provider-neutrales Eval-Gateway; 333 Tests |
 | **0.12.1** | 2026-07-12 | 🧩 **Portfolio-Brain** — memory-init Brain-Erkennung behoben, Monitor auf google-genai SDK migriert, Versions-Sync |
 | **0.12.2** | 2026-07-16 | 🚚 **Fähigkeiten ausgeliefert** — SEO-Toolkit in-pack ausgeliefert (funktioniert von npm), OSINT-Rechtsgrundlagen-Gate auf jedem Pfad, Monitor rebuildbar, Crawler-SSRF geschlossen, mcp-server + CLI Testabdeckung; 483 Tests |
+| **0.13.0** | 2026-09-08 | Kontrollierte Updates, geschützte Agenten, wiederherstellbare Sicherungen und Registry-basierte Installation; 709 Tests |
 
 Siehe [CHANGELOG.md](../CHANGELOG.md) für vollständige Details.
 

package/readme-international/README.es.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
 
-[![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.13.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 
@@ -15,6 +15,8 @@
 
 ## 📋 Tabla de contenidos
 
+Validación del repositorio: **709 tests JavaScript** (`npm test`). La desinstalación conserva la memoria del proyecto y los archivos personalizados; utiliza `--yes` para instalar o desinstalar sin un terminal interactivo.
+
 - [¿Por qué BMAD+?](#-por-qué-bmad-)
 - [Inicio Rápido](#-inicio-rápido)
 - [Arquitectura](#-arquitectura)
@@ -41,7 +43,7 @@ BMAD-METHOD es un excelente framework con 9 agentes especializados. Pero para un
 | Sin pipeline automatizado | **Modo Autopilot**: idea → entrega |
 | Ejecución secuencial | **Paralelismo supervisado** |
 | Sin seguimiento upstream | **Monitorización semanal** con WhatsApp |
-| 1-2 IDEs soportados | **5 IDEs** con auto-detección |
+| 1-2 IDEs soportados | **7 IDEs** con auto-detección |
 
 ---
 
@@ -163,6 +165,22 @@ Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu
 | `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
 | `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
 
+#### Actualizaciones del framework
+
+Las instrucciones instaladas piden al LLM una comprobación por sesión. El resultado se conserva durante 24 horas; sin conexión, la versión publicada permanece desconocida. Las actualizaciones automáticas requieren una política explícita y archivos administrados sin cambios locales.
+
+Para instalaciones con 0.12.2 o anterior, carga una vez el nuevo CLI con `npx --yes bmad-plus@0.13.0 update --yes`. Esta migración explícita guarda copias de seguridad antes de reemplazar los archivos antiguos.
+
+```bash
+npx bmad-plus update-check --json
+npx bmad-plus update --latest --yes
+npx bmad-plus update-policy --mode auto --range "^0.13.0"
+npx bmad-plus update --latest --auto
+npx bmad-plus update-check --offline --json
+```
+
+El modo predeterminado solo avisa. Para desactivar las comprobaciones: `update-policy --mode off`. Se conservan los agentes y adaptadores personalizados; los conflictos bloquean el modo automático. Las instalaciones antiguas sin huellas requieren una migración manual explícita con copias de seguridad. Cada actualización muestra un identificador; utiliza `update --restore <receipt-id> --yes` para restaurarla y vuelve a cargar las instrucciones.
+
 #### 🔬 Opciones de instalación avanzadas
 
 ```bash
@@ -427,6 +445,8 @@ Introduce una idea → Nexus gestionará todo:
 ```
 
 **Puntos de control (checkpoints) configurables:**
+Configura `execution_mode` y `checkpoints` en `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
+
 - `require_approval` (🔴) — Pausa, notifica por WhatsApp, espera
 - `notify_only` (🟡) — Notifica, continúa (a menos que el usuario intervenga)
 - `auto` (🟢) — Totalmente automático
@@ -447,15 +467,19 @@ El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
 
 ## 🖥️ IDE Soportados
 
-El instalador detecta automáticamente el IDE actual para generar la configuración nativa que conecte a BMAD+:
+El instalador detecta automáticamente los IDE y genera sus adaptadores con una base de instrucciones común en `AGENTS.md`, en la raíz del proyecto:
 
-| IDE | Archivo de Config. | Detección (carpeta) |
+| IDE | Archivo de Config. | Detección |
 |-----|---------------|-----------|
 | Claude Code | `CLAUDE.md` | `.claude/` |
 | Gemini CLI | `GEMINI.md` | `.gemini/` |
-| Antigravity | `.gemini/` + `.agents/` | Antigravity Extensión |
-| Codex CLI | `AGENTS.md` | `.codex/` |
-| OpenCode | `OPENCODE.md` | Opciones de opencode |
+| Antigravity | `GEMINI.md` | `.gemini/antigravity/` |
+| Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` |
+| Codex CLI | `.codex/AGENTS.md` | `.codex/` |
+| OpenCode | `.opencode/AGENTS.md` | `.opencode/` |
+| Aider | `CONVENTIONS.md` | Archivo `.aider.conf.yml` |
+
+Para Aider, añade `read: CONVENTIONS.md` a `.aider.conf.yml` o ejecuta `/read CONVENTIONS.md` para cargar las instrucciones generadas.
 
 ---
 
@@ -488,8 +512,12 @@ BMAD+/
 ├── readme-international/          ← Versiones traducidas (es, fr, de)
 ├── CHANGELOG.md                   ← Versiones de proyecto
 ├── CLAUDE.md                      ← Config IDE: Claude
-├── GEMINI.md                      ← Config IDE: Gemini
-├── AGENTS.md                      ← Config IDE: Codex / Opencode
+├── GEMINI.md                      ← Config Gemini CLI / Antigravity
+├── AGENTS.md                      ← Base de instrucciones común
+├── .codex/AGENTS.md               ← Adaptador Codex CLI
+├── .opencode/AGENTS.md            ← Adaptador OpenCode
+├── .cursor/rules/bmad-plus.mdc    ← Adaptador Cursor
+├── CONVENTIONS.md                ← Adaptador Aider
 ├── .gitignore
 │
 ├── src/
@@ -580,6 +608,7 @@ BMAD+/
 | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters raíz adoptados desde el registry, memoria vía MCP, gateway eval multi-proveedor; 333 tests |
 | **0.12.1** | 2026-07-12 | 🧩 **Cerebro portfolio** — fix de detección de cerebro memory-init, monitor migrado al SDK google-genai, sincronización de versión |
 | **0.12.2** | 2026-07-16 | 🚚 **Capacidades entregadas** — toolkit SEO embarcado in-pack (funciona desde npm), gate de base legal OSINT en cada ruta, monitor reconstruible, SSRF del crawler cerrado, cobertura de tests mcp-server + CLI; 483 tests |
+| **0.13.0** | 2026-09-08 | Actualizaciones controladas, agentes protegidos, copias restaurables e instalación derivada del registro; 709 tests |
 
 Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
 

package/readme-international/README.fr.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Framework Multi-Agent IA Augmenté
 
-[![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.13.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 
@@ -15,6 +15,8 @@
 
 ## 📋 Table des matières
 
+Validation du dépôt : **709 tests JavaScript** (`npm test`). La désinstallation conserve la mémoire du projet et les fichiers personnalisés ; utilisez `--yes` pour installer ou désinstaller sans terminal interactif.
+
 - [Pourquoi BMAD+ ?](#-pourquoi-bmad-)
 - [Quick Start](#-quick-start)
 - [Architecture](#-architecture)
@@ -41,7 +43,7 @@ BMAD-METHOD est un excellent framework avec 9 agents spécialisés. Mais pour un
 | Pas de pipeline automatisé | **Mode Autopilot** : idée → livraison |
 | Exécution séquentielle | **Parallélisme supervisé** |
 | Pas de suivi upstream | **Monitoring hebdomadaire** avec WhatsApp |
-| 1-2 IDE supportés | **5 IDE** avec détection automatique |
+| 1-2 IDE supportés | **7 IDE** avec détection automatique |
 
 ---
 
@@ -163,6 +165,22 @@ Nexus orchestre tout automatiquement avec des checkpoints pour ton approbation.
 | `npx bmad-plus uninstall` | Supprimer BMAD+ du projet actuel |
 | `npx bmad-plus autoconfig` | Bootstrap intelligent — détection auto, installation et configuration |
 
+#### Mises à jour du framework
+
+Les instructions installées demandent au LLM une vérification par session. Le résultat est conservé 24 heures ; hors connexion, la version publiée reste inconnue. Les mises à jour automatiques exigent une politique explicite et des fichiers gérés sans modification locale.
+
+Pour les installations en 0.12.2 ou antérieures, chargez une fois le nouveau CLI avec `npx --yes bmad-plus@0.13.0 update --yes`. Cette migration explicite sauvegarde les anciens fichiers avant leur remplacement.
+
+```bash
+npx bmad-plus update-check --json
+npx bmad-plus update --latest --yes
+npx bmad-plus update-policy --mode auto --range "^0.13.0"
+npx bmad-plus update --latest --auto
+npx bmad-plus update-check --offline --json
+```
+
+Le mode par défaut signale les mises à jour. Pour désactiver les vérifications : `update-policy --mode off`. Les agents et adaptateurs personnalisés sont conservés ; les conflits bloquent le mode automatique. Les anciennes installations sans empreintes exigent une migration manuelle explicite avec sauvegardes. Chaque mise à jour fournit un identifiant de sauvegarde ; utilisez `update --restore <receipt-id> --yes` pour la restaurer, puis rechargez les instructions des agents.
+
 #### 🔬 Options d'installation avancées
 
 ```bash
@@ -427,6 +445,8 @@ Donnez une idée projet → Nexus orchestre le pipeline complet :
 ```
 
 **Checkpoints configurables :**
+Configurez `execution_mode` et `checkpoints` dans `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
+
 - `require_approval` (🔴) — Pause, notification WhatsApp, attente
 - `notify_only` (🟡) — Notification, continue sauf intervention
 - `auto` (🟢) — Continue automatiquement
@@ -447,15 +467,19 @@ L'Orchestrateur détecte les tâches indépendantes et les lance en parallèle :
 
 ## 🖥️ IDE Supportés
 
-L'installeur détecte automatiquement les IDE et génère les configs :
+L'installeur détecte automatiquement les IDE et génère leurs adaptateurs autour d'un socle d'instructions commun `AGENTS.md` à la racine du projet :
 
 | IDE | Fichier Config | Détection |
 |-----|---------------|-----------|
 | Claude Code | `CLAUDE.md` | Dossier `.claude/` |
 | Gemini CLI | `GEMINI.md` | Dossier `.gemini/` |
-| Antigravity | `.gemini/` + `.agents/` | Extension Antigravity |
-| Codex CLI | `AGENTS.md` | Dossier `.codex/` |
-| OpenCode | `OPENCODE.md` | Config opencode |
+| Antigravity | `GEMINI.md` | Dossier `.gemini/antigravity/` |
+| Cursor | `.cursor/rules/bmad-plus.mdc` | Dossier `.cursor/` |
+| Codex CLI | `.codex/AGENTS.md` | Dossier `.codex/` |
+| OpenCode | `.opencode/AGENTS.md` | Dossier `.opencode/` |
+| Aider | `CONVENTIONS.md` | Fichier `.aider.conf.yml` |
+
+Pour Aider, ajoutez `read: CONVENTIONS.md` dans `.aider.conf.yml` ou lancez `/read CONVENTIONS.md` pour charger les instructions générées.
 
 ---
 
@@ -488,8 +512,12 @@ BMAD+/
 ├── readme-international/          ← Traductions en autres langues
 ├── CHANGELOG.md                   ← Historique des versions
 ├── CLAUDE.md                      ← Config Claude Code
-├── GEMINI.md                      ← Config Gemini CLI
-├── AGENTS.md                      ← Config Codex CLI / OpenCode
+├── GEMINI.md                      ← Config Gemini CLI / Antigravity
+├── AGENTS.md                      ← Socle d'instructions commun
+├── .codex/AGENTS.md               ← Adaptateur Codex CLI
+├── .opencode/AGENTS.md            ← Adaptateur OpenCode
+├── .cursor/rules/bmad-plus.mdc    ← Adaptateur Cursor
+├── CONVENTIONS.md                ← Adaptateur Aider
 ├── .gitignore
 │
 ├── src/
@@ -580,6 +608,7 @@ BMAD+/
 | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters racine adoptés depuis le registry, mémoire via MCP, gateway eval multi-provider ; 333 tests |
 | **0.12.1** | 2026-07-12 | 🧩 **Cerveau portfolio** — fix détection de cerveau memory-init, monitor migré vers le SDK google-genai, sync version |
 | **0.12.2** | 2026-07-16 | 🚚 **Capacités livrées** — toolkit SEO embarqué in-pack (fonctionne depuis npm), gate base légale OSINT sur tout chemin, monitor reconstructible, SSRF crawler fermé, couverture de tests mcp-server + CLI ; 483 tests |
+| **0.13.0** | 2026-09-08 | Mises à jour contrôlées, agents protégés, sauvegardes restaurables et installation issue du registre ; 709 tests |
 
 Voir [CHANGELOG.md](../CHANGELOG.md) pour le détail complet.
 

package/src/bmad-plus/agents/agent-orchestrator/SKILL.md

@@ -65,6 +65,8 @@ Focuses on: end-to-end pipeline management, agent sequencing, checkpoint managem
    - Run full code review → UX review → documentation
    - 🔴 CHECKPOINT: Wait for user approval before finalization
 
+Read `execution_mode` and `checkpoints` from `_bmad/config.yaml` before starting the pipeline. The checkpoint keys are `discovery`, `architecture`, `story`, and `delivery`.
+
 **Checkpoint behavior** (configurable):
 - `require_approval` (🔴 STOP): Pause and wait for user input. Notify via WhatsApp if configured.
 - `notify_only` (🟡 INFO): Send notification, continue unless user intervenes within timeout.