bmad-plus 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to BMAD+ will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [0.4.3] — 2026-05-17
+
+### 🔧 CLI Commands + Security Hardening + UX Enhancements
+
+### Added
+- **`bmad-plus update`** — Update agents & skills while preserving config, IDE configs, and output directories
+- **`bmad-plus doctor`** — Check installation integrity (version, agents, configs, pack health)
+- **Internationalized `uninstall`** — Uses i18n system from install manifest language (10 languages)
+- **Credits at startup** — Author attribution displayed immediately when installer launches
+- **Enriched post-install guide** — CLI commands section + pack-specific usage examples in selected language
+- **i18n strings for update/uninstall/doctor** — EN, FR, ES, DE, PT-BR, RU, ZH, HE, JA, IT
+- **CLI guide strings** — `guide_cli_title`, `guide_examples_title`, pack examples for SEO/Backup/Animated/OSINT
+
+### Fixed
+- **Security** — Added `mcp-server/.env` to `.gitignore`, created `.env.example` template
+- **Manifest version** — Now reads from `package.json` dynamically (was hardcoded `0.4.0`)
+- **`module.yaml` sync** — Added missing SEO, Backup, Animated pack definitions
+- **`package.json` cleanup** — Removed `oveanet-pack` from `files[]` (already excluded by `.npmignore`)
+- **CI/CD reliability** — Removed `continue-on-error` from npm publish step
+- **Comment accuracy** — Updated "9 languages" → "10 languages" in install.js header
+- **Installer title** — Now reads version from `package.json` dynamically
+
+### Changed
+- **Dependencies** — Updated `@clack/prompts` 1.1.0 → 1.4.0, `fs-extra` 11.3.4 → 11.3.5
+- **npm scripts** — Added `update:bmad` and `doctor:bmad` scripts
+
+---
 
 ## [0.4.2] — 2026-03-19
 

package/README.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.2-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.3-blue.svg)](CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
@@ -425,6 +425,7 @@ BMAD+/
 | **0.4.0** | 2026-03-19 | 🏢 SEO Engine v2.1 — SKILL.md orchestrator, Google APIs, HTML reports, competitor benchmark, 50 tests, GSC + GA4 extensions |
 | **0.4.1** | 2026-03-19 |
 | **0.4.2** | 2026-03-19 |  Public packs  SEO/Backup/Animated agents now in npm package | 🌐 10-language CLI, CI/CD pipeline, `.npmignore`, `/deploy` workflow, security hardening |
+| **0.4.3** | 2026-05-17 | 🔧 `update` + `doctor` commands, i18n uninstall, enriched guide with CLI commands & examples, credits at startup, security hardening |
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-plus",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "BMAD+ — Augmented AI-Driven Development Framework with multi-role agents, autopilot, and parallel execution",
   "keywords": [
     "bmad",
@@ -27,19 +27,20 @@
     "tools",
     "src/bmad-plus",
     "osint-agent-package",
-    "oveanet-pack",
     "readme-international",
     "CHANGELOG.md"
   ],
   "scripts": {
     "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",
     "uninstall:bmad": "node tools/cli/bmad-plus-cli.js uninstall"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.0",
+    "@clack/prompts": "^1.4.0",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
-    "fs-extra": "^11.3.0",
+    "fs-extra": "^11.3.5",
     "js-yaml": "^4.1.0",
     "picocolors": "^1.1.1"
   },

package/readme-international/README.de.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Erweitertes KI-gestütztes Entwicklungs-Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.3-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.es.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Framework de Desarrollo Impulsado por IA Aumentada
 
-[![Version](https://img.shields.io/badge/version-0.4.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.3-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.fr.md

@@ -1,6 +1,6 @@
 # 🚀 BMAD+ — Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.2-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.3-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/src/bmad-plus/module.yaml

@@ -74,6 +74,35 @@ packs:
       - bmad-audit-scan
       - bmad-audit-report
 
+  seo:
+    name: "SEO Audit 360"
+    icon: "🔍"
+    description: "3 agents (Scout, Chief, Judge) + 6-phase audit + PageSpeed loop"
+    required: false
+    packDir: pack-seo
+    agents:
+      - seo-scout
+      - seo-chief
+      - seo-judge
+
+  backup:
+    name: "Universal Backup"
+    icon: "🗂️"
+    description: "Timestamped ZIP backup with smart exclusions"
+    required: false
+    packDir: pack-backup
+    agents:
+      - backup-agent
+
+  animated:
+    name: "Animated Website"
+    icon: "🎬"
+    description: "Luxury scroll-driven website from video"
+    required: false
+    packDir: pack-animated
+    agents:
+      - animated-website-agent
+
 install_packs:
   prompt:
     - "Quels packs additionnels souhaites-tu installer ?"

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

@@ -2,6 +2,7 @@
 
 /**
  * BMAD+ CLI — Main entry point
+ * Commands: install, uninstall, update, doctor
  */
 
 const { program } = require('commander');
@@ -22,6 +23,8 @@ if (process.stdin.isTTY) {
 // Register commands
 const install = require('./commands/install');
 const uninstall = require('./commands/uninstall');
+const update = require('./commands/update');
+const doctor = require('./commands/doctor');
 
 program
   .version(packageJson.version)
@@ -43,6 +46,26 @@ const uninstallCmd = program
   .description('Remove BMAD+ from your project');
 uninstallCmd.action(uninstall.action);
 
+// Update command
+const updateCmd = program
+  .command('update')
+  .description('Update BMAD+ agents and skills (preserves config)');
+
+for (const option of update.options || []) {
+  updateCmd.option(...option);
+}
+updateCmd.action(update.action);
+
+// Doctor command
+const doctorCmd = program
+  .command('doctor')
+  .description('Check BMAD+ installation integrity');
+
+for (const option of doctor.options || []) {
+  doctorCmd.option(...option);
+}
+doctorCmd.action(doctor.action);
+
 program.parse(process.argv);
 
 if (process.argv.slice(2).length === 0) {

package/tools/cli/commands/doctor.js

@@ -0,0 +1,175 @@
+/**
+ * BMAD+ Doctor Command
+ * Checks installation integrity and reports issues
+ *
+ * Author: Laurent Rochetta
+ */
+
+const path = require('node:path');
+const fs = require('node:fs');
+const clack = require('@clack/prompts');
+const pc = require('picocolors');
+const { t } = require('../i18n');
+
+module.exports = {
+  command: 'doctor',
+  description: 'Check BMAD+ installation integrity',
+  options: [
+    ['-d, --directory <path>', 'Project directory (default: current directory)'],
+  ],
+  action: async (options) => {
+    const projectDir = path.resolve(options.directory || process.cwd());
+    const packageJson = require('../../../package.json');
+
+    clack.intro(pc.bgBlue(pc.white(` BMAD+ Doctor v${packageJson.version} `)));
+
+    let checks = 0;
+    let passed = 0;
+    let warnings = 0;
+    let errors = 0;
+
+    // ── Check 1: Installation manifest ──
+    checks++;
+    const manifestPath = path.join(projectDir, '_bmad', '.bmad-plus-install.json');
+    if (!fs.existsSync(manifestPath)) {
+      clack.log.error('❌ BMAD+ is not installed in this directory');
+      clack.outro(pc.red('Run `npx bmad-plus install` first.'));
+      return;
+    }
+
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    clack.log.success(`✅ Manifest found — v${manifest.version}`);
+    passed++;
+
+    // ── Check 2: Version comparison ──
+    checks++;
+    if (manifest.version === packageJson.version) {
+      clack.log.success(`✅ Version up to date (v${manifest.version})`);
+      passed++;
+    } else {
+      clack.log.warn(`⚠️  Version mismatch: installed v${manifest.version} → latest v${packageJson.version}`);
+      clack.log.info('   Run `npx bmad-plus update` to upgrade');
+      warnings++;
+    }
+
+    // ── Check 3: Agent files ──
+    checks++;
+    const agentsDir = path.join(projectDir, '.agents', 'skills');
+    if (fs.existsSync(agentsDir)) {
+      const agentDirs = fs.readdirSync(agentsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name);
+      clack.log.success(`✅ ${agentDirs.length} agent/skill directories found`);
+      passed++;
+
+      // Check each expected agent from manifest packs
+      const expectedAgents = {
+        core: ['agent-strategist', 'agent-architect-dev', 'agent-quality', 'agent-orchestrator'],
+        osint: ['agent-shadow'],
+        maker: ['agent-maker'],
+        seo: ['pack-seo'],
+        backup: ['pack-backup'],
+        animated: ['pack-animated'],
+      };
+
+      for (const pack of (manifest.packs || ['core'])) {
+        const expected = expectedAgents[pack] || [];
+        for (const agent of expected) {
+          checks++;
+          const agentPath = path.join(agentsDir, agent);
+          if (fs.existsSync(agentPath)) {
+            passed++;
+          } else {
+            clack.log.warn(`⚠️  Missing agent: ${agent} (pack: ${pack})`);
+            warnings++;
+          }
+        }
+      }
+    } else {
+      clack.log.error('❌ No .agents/skills/ directory found');
+      errors++;
+    }
+
+    // ── Check 4: Config files ──
+    checks++;
+    const configPath = path.join(projectDir, '_bmad', 'config.yaml');
+    if (fs.existsSync(configPath)) {
+      clack.log.success('✅ config.yaml present');
+      passed++;
+    } else {
+      clack.log.error('❌ config.yaml missing');
+      errors++;
+    }
+
+    // ── Check 5: Module config ──
+    checks++;
+    const moduleYaml = path.join(projectDir, '_bmad', 'module.yaml');
+    if (fs.existsSync(moduleYaml)) {
+      clack.log.success('✅ module.yaml present');
+      passed++;
+    } else {
+      clack.log.warn('⚠️  module.yaml missing');
+      warnings++;
+    }
+
+    // ── Check 6: IDE configs ──
+    checks++;
+    const ideFiles = ['CLAUDE.md', 'GEMINI.md', 'AGENTS.md'].filter(f =>
+      fs.existsSync(path.join(projectDir, f))
+    );
+    if (ideFiles.length > 0) {
+      clack.log.success(`✅ ${ideFiles.length} IDE config(s): ${ideFiles.join(', ')}`);
+      passed++;
+    } else {
+      clack.log.warn('⚠️  No IDE config files found');
+      warnings++;
+    }
+
+    // ── Check 7: Output directories ──
+    checks++;
+    const outputDir = path.join(projectDir, '_bmad-output');
+    if (fs.existsSync(outputDir)) {
+      clack.log.success('✅ _bmad-output/ directory exists');
+      passed++;
+    } else {
+      clack.log.warn('⚠️  _bmad-output/ not found');
+      warnings++;
+    }
+
+    // ── Check 8: Skills integrity (SKILL.md exists in pack dirs) ──
+    if (manifest.packs && manifest.packs.includes('seo')) {
+      checks++;
+      const seoSkill = path.join(agentsDir, 'pack-seo', 'SKILL.md');
+      if (fs.existsSync(seoSkill)) {
+        clack.log.success('✅ SEO Engine SKILL.md present');
+        passed++;
+      } else {
+        clack.log.error('❌ SEO Engine SKILL.md missing — /seo audit will not work');
+        errors++;
+      }
+    }
+
+    // ── Summary ──
+    const summaryColor = errors > 0 ? pc.red : warnings > 0 ? pc.yellow : pc.green;
+    const summaryIcon = errors > 0 ? '❌' : warnings > 0 ? '⚠️' : '✅';
+
+    clack.note([
+      `${summaryIcon} ${passed}/${checks} checks passed`,
+      errors > 0 ? `❌ ${errors} error(s)` : null,
+      warnings > 0 ? `⚠️  ${warnings} warning(s)` : null,
+      '',
+      `📦 Version: v${manifest.version}`,
+      `📅 Installed: ${manifest.installed.split('T')[0]}`,
+      `🗣️  Language: ${manifest.language || 'N/A'}`,
+      `📦 Packs: ${(manifest.packs || ['core']).join(', ')}`,
+    ].filter(Boolean).join('\n'), '🩺 BMAD+ Health Report');
+
+    clack.outro(summaryColor(
+      errors > 0
+        ? 'Issues found — run `npx bmad-plus install` to fix'
+        : warnings > 0
+          ? 'Minor issues found — consider running `npx bmad-plus update`'
+          : 'Everything looks great! 🎉'
+    ));
+  },
+};

package/tools/cli/commands/install.js

@@ -1,7 +1,7 @@
 /**
  * BMAD+ Install Command
  * Installs agents, skills, and IDE configs into the current project
- * Supports 9 languages: EN, FR, ES, DE, PT-BR, RU, ZH, HE, JA
+ * Supports 10 languages: EN, FR, ES, DE, PT-BR, RU, ZH, HE, JA, IT
  *
  * Author: Laurent Rochetta
  */
@@ -118,7 +118,9 @@ module.exports = {
     const bmadSrc = path.join(__dirname, '..', '..', '..', 'src', 'bmad-plus');
 
     // ── Step 0: Language Selection ──
-    clack.intro(pc.bgCyan(pc.black(' BMAD+ Installer v0.4.2 ')));
+    const pkgJson = require('../../../package.json');
+    clack.intro(pc.bgCyan(pc.black(` BMAD+ Installer v${pkgJson.version} `)));
+    clack.log.info(pc.dim('✨ Created by Laurent Rochetta — github.com/lrochetta'));
 
     let lang = 'en';
     if (!options.yes) {
@@ -373,8 +375,9 @@ module.exports = {
     fsExtra.ensureDirSync(path.join(projectDir, 'docs'));
 
     // ── Step 8: Write install manifest ──
+    const pkgVersion = require('../../../package.json').version;
     const manifest = {
-      version: '0.4.0',
+      version: pkgVersion,
       uiLanguage: lang,
       installed: new Date().toISOString(),
       packs: selectedPacks,
@@ -431,6 +434,40 @@ module.exports = {
       i.guide_or_auto,
       '',
       `${i.guide_output}: _bmad-output/discovery/ & _bmad-output/build/`,
+      '',
+      '─'.repeat(50),
+      '',
+      `📦 ${i.guide_cli_title || 'CLI Commands'}:`,
+      `  npx bmad-plus install    ${i.guide_cli_install || '— Install agents & skills'}`,
+      `  npx bmad-plus update     ${i.guide_cli_update || '— Update agents (keeps config)'}`,
+      `  npx bmad-plus doctor     ${i.guide_cli_doctor || '— Check installation health'}`,
+      `  npx bmad-plus uninstall  ${i.guide_cli_uninstall || '— Remove BMAD+ from project'}`,
+    );
+
+    // Add pack-specific examples
+    const examples = [];
+    if (selectedPacks.includes('seo')) {
+      examples.push(`  ${i.guide_example_seo || '🔍 SEO: "/seo audit https://example.com"'}`);
+    }
+    if (selectedPacks.includes('backup')) {
+      examples.push(`  ${i.guide_example_backup || '🗂️  Backup: "/backup create" → ZIP timestamped'}`);
+    }
+    if (selectedPacks.includes('animated')) {
+      examples.push(`  ${i.guide_example_animated || '🎬 Animated: "/animated build hero.mp4"'}`);
+    }
+    if (selectedPacks.includes('osint')) {
+      examples.push(`  ${i.guide_example_osint || '🔍 OSINT: "Shadow, investigate John Doe"'}`);
+    }
+
+    if (examples.length > 0) {
+      agentGuide.push(
+        '',
+        `💡 ${i.guide_examples_title || 'Quick Examples'}:`,
+        ...examples
+      );
+    }
+
+    agentGuide.push(
       '',
       '---',
       i.guide_credits

package/tools/cli/commands/uninstall.js

@@ -1,6 +1,9 @@
 /**
  * BMAD+ Uninstall Command
  * Removes BMAD+ agents, skills, and configs from the current project
+ * Internationalized — uses i18n system
+ *
+ * Author: Laurent Rochetta
  */
 
 const path = require('node:path');
@@ -8,6 +11,7 @@ const fs = require('node:fs');
 const fsExtra = require('fs-extra');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
+const { t, getLanguageOptions } = require('../i18n');
 
 module.exports = {
   command: 'uninstall',
@@ -26,45 +30,67 @@ module.exports = {
     }
 
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-    clack.log.info(`Found BMAD+ v${manifest.version} (installed ${manifest.installed})`);
+
+    // Use the language from install manifest, or ask
+    let lang = manifest.uiLanguage || 'en';
+    const i = t(lang);
+
+    clack.log.info(`BMAD+ v${manifest.version} (${i.installed_on || 'installed'} ${manifest.installed.split('T')[0]})`);
+    clack.log.info(`${i.selected_packs}: ${(manifest.packs || ['core']).join(', ')}`);
 
     const confirm = await clack.confirm({
-      message: 'Supprimer BMAD+ de ce projet ?',
+      message: i.uninstall_confirm || 'Remove BMAD+ from this project?',
     });
 
     if (!confirm || clack.isCancel(confirm)) {
-      clack.cancel('Cancelled.');
+      clack.cancel(i.cancelled);
       return;
     }
 
     const spinner = clack.spinner();
-    spinner.start('Suppression...');
+    spinner.start(i.uninstall_removing || 'Removing...');
+
+    let removed = 0;
 
     // Remove .agents/skills/ (BMAD+ agents & skills)
     const agentsDir = path.join(projectDir, '.agents');
     if (fs.existsSync(agentsDir)) {
       fsExtra.removeSync(agentsDir);
+      removed++;
     }
 
     // Remove _bmad/ config
     const bmadDir = path.join(projectDir, '_bmad');
     if (fs.existsSync(bmadDir)) {
       fsExtra.removeSync(bmadDir);
+      removed++;
+    }
+
+    // Remove _bmad-output/ (only if empty)
+    const outputDir = path.join(projectDir, '_bmad-output');
+    if (fs.existsSync(outputDir)) {
+      const contents = fs.readdirSync(outputDir, { recursive: true }).filter(f => !f.startsWith('.'));
+      if (contents.length === 0) {
+        fsExtra.removeSync(outputDir);
+        removed++;
+      } else {
+        clack.log.info(i.uninstall_output_kept || '📁 _bmad-output/ kept (contains files)');
+      }
     }
 
-    // Remove IDE configs
+    // Remove IDE configs (only BMAD+-generated ones)
     for (const configFile of ['CLAUDE.md', 'GEMINI.md', 'AGENTS.md', 'OPENCODE.md']) {
       const p = path.join(projectDir, configFile);
       if (fs.existsSync(p)) {
-        // Only remove if it's a BMAD+ generated file
         const content = fs.readFileSync(p, 'utf8');
         if (content.includes('BMAD+')) {
           fs.unlinkSync(p);
+          removed++;
         }
       }
     }
 
-    spinner.stop('✅ BMAD+ supprimé');
-    clack.outro(pc.green('Done!'));
+    spinner.stop(i.uninstall_done ? i.uninstall_done(removed) : `✅ BMAD+ removed (${removed} items)`);
+    clack.outro(pc.green(i.guide_ready ? '👋 Done!' : 'Done!'));
   },
 };