bmad-plus 0.12.2 → 0.13.0

package/tools/build/generated-adapters/CONVENTIONS.md

@@ -28,16 +28,21 @@ To activate an agent, say its name or persona:
 - **Forge** (Architect-Dev) — Architecture + Development + Documentation
 - **Sentinel** (Quality) — QA + UX review
 - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
-- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
-- **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
-- **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
+- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
+- **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
+- **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
+- **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
+- **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
+- **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
+- **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
 - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
 - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
 - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
 - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
 - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
 - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
-- **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
+- **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
+- **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
 
 ## Skills
 
@@ -98,19 +103,27 @@ Agents MUST follow these behavioral principles:
 - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
 - `.agents/memory/context.md` — Update at session end with project state
 
+## Framework updates
+
+Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
+If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
+When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
+When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
+After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
+
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):
   - Core (required): 4 installer agents — Core agents & skills
   - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
   - Maker: 1 installer agent — Agent creation toolkit
-  - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
+  - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
   - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
   - Memory: 1 installer agent — Persistent cross-session memory
-  - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
+  - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
   - Backup: 1 installer agent — Backup & restore
   - Animated: 1 installer agent — Animated website agents
 

package/tools/build/generated-adapters/GEMINI.md

@@ -33,16 +33,21 @@ To activate an agent, say its name or persona:
 - **Forge** (Architect-Dev) — Architecture + Development + Documentation
 - **Sentinel** (Quality) — QA + UX review
 - **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution
-- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (if OSINT pack installed)
-- **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents
-- **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (derived counts: see Registry facts below)
+- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling (OSINT)
+- **Maker** (Agent Creator) — Design, build, validate, and package new BMAD+ agents (Maker)
+- **Shield** (GRC) — Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more (Shield)
+- **SEO Scout** (Technical Scanner) — Crawling + technical inspection + performance (SEO)
+- **SEO Chief** (Strategist & Reporter) — Scoring + strategy + reporting (SEO)
+- **SEO Judge** (Content & AI Analyst) — Content quality + structured data + GEO analysis (SEO)
+- **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs (Memory)
 - **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs (Dev Studio)
 - **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review (Dev Studio)
 - **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization (Dev Studio)
 - **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping (Dev Studio)
 - **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories (Dev Studio)
 - **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation (Dev Studio)
-- **Zecher** (זכר, Memory Guardian) — Memory Archivist — Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs
+- **Backup Manager** (Backup & Restore) — Timestamped backups, restoration, and rotation (Backup)
+- **Animated Website Creator** (Website Builder) — Video-driven scrolling websites (Animated)
 
 ## Skills
 
@@ -103,19 +108,27 @@ Agents MUST follow these behavioral principles:
 - `.agents/memory/patterns.md` — Write when a reusable pattern is validated
 - `.agents/memory/context.md` — Update at session end with project state
 
+## Framework updates
+
+Once per session, check the installed framework before starting project work. If this is the BMAD+ source checkout, use `node tools/cli/bmad-plus-cli.js update-check --json`; otherwise use `npx --no-install bmad-plus update-check --json` from the project root.
+If the command is unavailable or the result is off, unknown, offline or stale, continue the user task. Do not install a CLI just to perform this check or claim that an offline version is current.
+When `updateAvailable` is true and `canAutoApply` is true, run the same CLI with `update --latest --auto`. This follows the project update policy; it does not grant permission to expand that policy.
+When an update is available but automatic application is not eligible, explain the version and reason. An explicit request to update can be fulfilled with `update --latest --yes`; do not change the policy, overwrite customized files, or resolve conflicts without the user request covering that action.
+After a successful update, reread the project spine and relevant installed skills, or start a fresh session if the client cannot reload them. Respect preserved local instructions. Check only once even when several adapters include this section.
+
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.12.2 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):
   - Core (required): 4 installer agents — Core agents & skills
   - OSINT: 1 installer agent — OSINT & investigation — 2 compliance frameworks
   - Maker: 1 installer agent — Agent creation toolkit
-  - Shield: 1 installer agent — GRC compliance (25+ frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
+  - Shield: 1 installer agent — GRC compliance (26 frameworks) — 27 specialized agents, 11 workflows, 26 compliance frameworks
   - SEO: 3 installer agents — SEO audit & optimization — 1 compliance frameworks
   - Memory: 1 installer agent — Persistent cross-session memory
-  - Dev Studio: 1 installer agent — SDLC automation (6 agents, 56+ skills) — 6 sub-agents, 38 workflows
+  - Dev Studio: 1 installer agent — SDLC automation (6 agents, specialized workflows) — 6 sub-agents, 38 workflows
   - Backup: 1 installer agent — Backup & restore
   - Animated: 1 installer agent — Animated website agents
 

package/tools/build/module.template.yaml

@@ -0,0 +1,82 @@
+# Hand-authored project questions and compatibility. Pack facts are generated from registry.yaml.
+code: bmad-plus
+name: BMAD+ Streamlined AI-Driven Development
+description: Augmented BMAD framework with multi-role agents, autopilot mode, and parallel execution
+default_selected: true
+extends: bmm
+compatibility:
+  min_core_version: 6.0.0
+  max_core_version: 7.0.0
+  replaces_modules:
+    - bmm
+  keeps_core_skills: true
+install_packs:
+  prompt:
+    - Quels packs additionnels souhaites-tu installer ?
+    - Core est toujours inclus.
+  default: none
+  result: '{value}'
+project_name:
+  prompt: What is your project called?
+  default: '{directory_name}'
+  result: '{value}'
+user_skill_level:
+  prompt:
+    - What is your development experience level?
+    - This affects how agents explain concepts in chat.
+  default: expert
+  result: '{value}'
+  single-select:
+    - value: beginner
+      label: Beginner - Explain things clearly
+    - value: intermediate
+      label: Intermediate - Balance detail with speed
+    - value: expert
+      label: Expert - Be direct and technical
+execution_mode:
+  prompt:
+    - How do you want to work with BMAD+ agents?
+    - 'Manual: you call agents when needed. Autopilot: orchestrator manages everything.'
+  default: manual
+  result: '{value}'
+  single-select:
+    - value: manual
+      label: Manual - Call agents yourself
+    - value: autopilot
+      label: Autopilot - Orchestrator manages the pipeline
+    - value: hybrid
+      label: Hybrid - Autopilot with frequent checkpoints
+auto_role_activation:
+  prompt: Enable intelligent auto-activation of agent roles based on context?
+  default: 'true'
+  result: '{value}'
+  single-select:
+    - value: 'true'
+      label: Yes - Agents auto-switch roles when context demands it
+    - value: 'false'
+      label: No - Only switch roles when I explicitly ask
+parallel_execution:
+  prompt: Enable parallel multi-agent execution for independent tasks?
+  default: 'true'
+  result: '{value}'
+  single-select:
+    - value: 'true'
+      label: Yes - Run independent tasks in parallel
+    - value: 'false'
+      label: No - Sequential execution only
+planning_artifacts:
+  prompt: Where should planning artifacts be stored? (Discovery phase output)
+  default: '{output_folder}/discovery'
+  result: '{project-root}/{value}'
+implementation_artifacts:
+  prompt: Where should implementation artifacts be stored? (Build & Ship phase output)
+  default: '{output_folder}/build'
+  result: '{project-root}/{value}'
+project_knowledge:
+  prompt: Where should long-term project knowledge be stored?
+  default: docs
+  result: '{project-root}/{value}'
+directories:
+  - '{planning_artifacts}'
+  - '{implementation_artifacts}'
+  - '{project_knowledge}'

package/tools/cli/bmad-plus-cli.js

@@ -48,6 +48,9 @@ installCmd.action(install.action);
 const uninstallCmd = program
   .command('uninstall')
   .description('Remove BMAD+ from your project');
+for (const option of uninstall.options || []) {
+  uninstallCmd.option(...option);
+}
 uninstallCmd.action(uninstall.action);
 
 // Update command
@@ -112,7 +115,19 @@ for (const option of autoconfig.options || []) {
 }
 autoconfigCmd.action(autoconfig.action);
 
-program.parse(process.argv);
+// Version discovery and explicit per-project update policy.
+for (const modulePath of ['./commands/update-check', './commands/update-policy']) {
+  const command = require(modulePath);
+  const configured = program.command(command.command).description(command.description);
+  for (const option of command.options || []) configured.option(...option);
+  configured.action(command.action);
+}
+
+// Await asynchronous registry checks and updates before completing the CLI.
+program.parseAsync(process.argv).catch(error => {
+  console.error(`BMAD+: ${error.message}`);
+  process.exitCode = 1;
+});
 
 if (process.argv.slice(2).length === 0) {
   program.outputHelp();

package/tools/cli/commands/doctor.js

@@ -10,7 +10,8 @@ const fs = require('node:fs');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
 const { t } = require('../i18n');
-const { PACKS, EXPECTED_AGENTS } = require('../lib/packs');
+const { EXPECTED_AGENTS } = require('../lib/packs');
+const { readInstallManifest } = require('../lib/install-manifest');
 
 module.exports = {
   command: 'doctor',
@@ -39,8 +40,16 @@ module.exports = {
       return;
     }
 
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-    const lang = options.lang || manifest.uiLanguage || 'en';
+    let manifest;
+    try {
+      manifest = readInstallManifest(manifestPath);
+    } catch (err) {
+      const i = t(options.lang || 'en');
+      clack.log.error(i.manifest_invalid(err.message));
+      clack.outro(pc.red(i.manifest_repair));
+      process.exitCode = 1;
+      return;
+    }
     clack.log.success(`✅ Manifest found — v${manifest.version}`);
     passed++;
 
@@ -170,43 +179,6 @@ module.exports = {
       }
     }
 
-    // ── Check 9: PACKS ↔ module.yaml sync ──
-    checks++;
-    try {
-      const yaml = require('js-yaml');
-      const moduleYamlSrc = path.join(__dirname, '..', '..', '..', 'src', 'bmad-plus', 'module.yaml');
-      if (fs.existsSync(moduleYamlSrc)) {
-        const moduleContent = yaml.load(fs.readFileSync(moduleYamlSrc, 'utf8'));
-        const modulePackIds = Object.keys(moduleContent.packs || {});
-
-        // Use shared PACKS module instead of fragile regex on install.js source
-        const cliPackIds = Object.keys(PACKS);
-
-        // Find mismatches
-        const missingInCLI = modulePackIds.filter(p => !cliPackIds.includes(p));
-        const missingInModule = cliPackIds.filter(p => !modulePackIds.includes(p));
-
-        if (missingInCLI.length === 0 && missingInModule.length === 0) {
-          clack.log.success(`✅ PACKS ↔ module.yaml in sync (${modulePackIds.length} packs)`);
-          passed++;
-        } else {
-          if (missingInCLI.length > 0) {
-            clack.log.warn(`⚠️  Packs in module.yaml but missing from CLI PACKS: ${missingInCLI.join(', ')}`);
-          }
-          if (missingInModule.length > 0) {
-            clack.log.warn(`⚠️  Packs in CLI PACKS but missing from module.yaml: ${missingInModule.join(', ')}`);
-          }
-          warnings++;
-        }
-      } else {
-        clack.log.info(pc.dim('ℹ️  PACKS↔module.yaml check skipped (source not available in npx context)'));
-        passed++; // Not a failure — just unavailable
-      }
-    } catch (e) {
-      clack.log.info(pc.dim(`ℹ️  PACKS↔module.yaml check skipped: ${e.message}`));
-      passed++; // Graceful skip
-    }
-
     // ── Summary ──
     const summaryColor = errors > 0 ? pc.red : warnings > 0 ? pc.yellow : pc.green;
     const summaryIcon = errors > 0 ? '❌' : warnings > 0 ? '⚠️' : '✅';