bmad-plus 0.4.1 → 0.4.3

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
  */
@@ -54,29 +54,29 @@ const PACKS = {
   seo: {
     name: 'SEO Audit 360',
     icon: '🔍',
-    description: '9-category audit for search engines + AI engines (by Oveanet)',
+    description: '3 agents (Scout, Chief, Judge) + 6-phase audit + PageSpeed loop',
     required: false,
     agents: [],
     skills: [],
-    oveanetAgent: 'seo-audit-360',
+    packDir: 'pack-seo',
   },
   backup: {
     name: 'Universal Backup',
     icon: '🗂️',
-    description: 'Timestamped ZIP backup with smart exclusions (by Oveanet)',
+    description: 'Timestamped ZIP backup with smart exclusions',
     required: false,
     agents: [],
     skills: [],
-    oveanetAgent: 'universal-backup',
+    packDir: 'pack-backup',
   },
   animated: {
     name: 'Animated Website',
     icon: '🎬',
-    description: 'Luxury scroll-driven website from video (by Oveanet)',
+    description: 'Luxury scroll-driven website from video',
     required: false,
     agents: [],
     skills: [],
-    oveanetAgent: 'animated-website',
+    packDir: 'pack-animated',
   },
 };
 
@@ -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.1 ')));
+    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) {
@@ -316,13 +318,14 @@ module.exports = {
         }
       }
 
-      // Copy Oveanet agent pack (SEO, Backup, Animated Website)
-      if (pack.oveanetAgent) {
-        const oveanetSrc = path.join(__dirname, '..', '..', '..', 'oveanet-pack', pack.oveanetAgent);
-        const oveanetDest = path.join(targetAgentsDir, pack.oveanetAgent);
-        if (fs.existsSync(oveanetSrc)) {
-          fsExtra.copySync(oveanetSrc, oveanetDest, { overwrite: true });
-          copiedSkills++;
+      // Copy pack directory (SEO, Backup, Animated Website)
+      if (pack.packDir) {
+        const packSrc = path.join(bmadSrc, 'agents', pack.packDir);
+        const packDest = path.join(targetAgentsDir, pack.packDir);
+        if (fs.existsSync(packSrc)) {
+          fsExtra.copySync(packSrc, packDest, { overwrite: true });
+          copiedAgents++;
+          copiedFiles++;
         }
       }
     }
@@ -372,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,
@@ -430,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!'));
   },
 };

package/tools/cli/commands/update.js

@@ -0,0 +1,172 @@
+/**
+ * BMAD+ Update Command
+ * Updates agents and skills while preserving user config
+ *
+ * Author: Laurent Rochetta
+ */
+
+const path = require('node:path');
+const fs = require('node:fs');
+const fsExtra = require('fs-extra');
+const clack = require('@clack/prompts');
+const pc = require('picocolors');
+const { t } = require('../i18n');
+
+// Same pack definitions as install.js — keep in sync
+const PACKS = {
+  core: {
+    agents: ['agent-strategist', 'agent-architect-dev', 'agent-quality', 'agent-orchestrator'],
+    skills: ['bmad-plus-autopilot', 'bmad-plus-parallel', 'bmad-plus-sync'],
+    data: ['role-triggers.yaml'],
+  },
+  osint: {
+    agents: ['agent-shadow'],
+    skills: [],
+    externalPackage: 'osint-agent-package',
+  },
+  maker: {
+    agents: ['agent-maker'],
+    skills: [],
+    data: [],
+  },
+  seo: { agents: [], skills: [], packDir: 'pack-seo' },
+  backup: { agents: [], skills: [], packDir: 'pack-backup' },
+  animated: { agents: [], skills: [], packDir: 'pack-animated' },
+};
+
+module.exports = {
+  command: 'update',
+  description: 'Update BMAD+ agents and skills (preserves config)',
+  options: [
+    ['-d, --directory <path>', 'Project directory (default: current directory)'],
+  ],
+  action: async (options) => {
+    const projectDir = path.resolve(options.directory || process.cwd());
+    const bmadSrc = path.join(__dirname, '..', '..', '..', 'src', 'bmad-plus');
+    const packageJson = require('../../../package.json');
+
+    clack.intro(pc.bgMagenta(pc.white(` BMAD+ Updater v${packageJson.version} `)));
+
+    // Check if installed
+    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.log.info('Run `npx bmad-plus install` first.');
+      clack.outro(pc.red('Update aborted.'));
+      return;
+    }
+
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    const lang = manifest.uiLanguage || 'en';
+    const i = t(lang);
+
+    clack.log.info(`📦 Installed: v${manifest.version} → Available: v${packageJson.version}`);
+
+    if (manifest.version === packageJson.version) {
+      clack.log.success(i.update_current || '✅ Already up to date!');
+      clack.outro(pc.green('Nothing to update.'));
+      return;
+    }
+
+    const selectedPacks = manifest.packs || ['core'];
+    clack.log.info(`${i.selected_packs}: ${selectedPacks.join(', ')}`);
+
+    const confirm = await clack.confirm({
+      message: i.update_confirm || `Update from v${manifest.version} to v${packageJson.version}?`,
+    });
+
+    if (!confirm || clack.isCancel(confirm)) {
+      clack.cancel(i.cancelled);
+      return;
+    }
+
+    const spinner = clack.spinner();
+    spinner.start(i.update_updating || 'Updating agents and skills...');
+
+    const targetAgentsDir = path.join(projectDir, '.agents', 'skills');
+    const targetDataDir = path.join(projectDir, '.agents', 'data');
+
+    fsExtra.ensureDirSync(targetAgentsDir);
+    fsExtra.ensureDirSync(targetDataDir);
+
+    let updated = 0;
+
+    for (const packId of selectedPacks) {
+      const pack = PACKS[packId];
+      if (!pack) continue;
+
+      // Update agents
+      for (const agent of (pack.agents || [])) {
+        const src = path.join(bmadSrc, 'agents', agent);
+        const dest = path.join(targetAgentsDir, agent);
+        if (fs.existsSync(src)) {
+          fsExtra.copySync(src, dest, { overwrite: true });
+          updated++;
+        }
+      }
+
+      // Update skills
+      for (const skill of (pack.skills || [])) {
+        const src = path.join(bmadSrc, 'skills', skill);
+        const dest = path.join(targetAgentsDir, skill);
+        if (fs.existsSync(src)) {
+          fsExtra.copySync(src, dest, { overwrite: true });
+          updated++;
+        }
+      }
+
+      // Update data files
+      for (const dataFile of (pack.data || [])) {
+        const src = path.join(bmadSrc, 'data', dataFile);
+        const dest = path.join(targetDataDir, dataFile);
+        if (fs.existsSync(src)) {
+          fsExtra.copySync(src, dest, { overwrite: true });
+          updated++;
+        }
+      }
+
+      // Update external package (OSINT)
+      if (pack.externalPackage) {
+        const extSrc = path.join(__dirname, '..', '..', '..', pack.externalPackage, 'skills');
+        if (fs.existsSync(extSrc)) {
+          fsExtra.copySync(extSrc, targetAgentsDir, { overwrite: true });
+          updated++;
+        }
+      }
+
+      // Update pack directory (SEO, Backup, Animated)
+      if (pack.packDir) {
+        const packSrc = path.join(bmadSrc, 'agents', pack.packDir);
+        const packDest = path.join(targetAgentsDir, pack.packDir);
+        if (fs.existsSync(packSrc)) {
+          fsExtra.copySync(packSrc, packDest, { overwrite: true });
+          updated++;
+        }
+      }
+    }
+
+    // Update module config (always)
+    const moduleYaml = path.join(bmadSrc, 'module.yaml');
+    const targetBmadDir = path.join(projectDir, '_bmad');
+    if (fs.existsSync(moduleYaml)) {
+      fsExtra.copySync(moduleYaml, path.join(targetBmadDir, 'module.yaml'));
+      updated++;
+    }
+
+    const helpCsv = path.join(bmadSrc, 'module-help.csv');
+    if (fs.existsSync(helpCsv)) {
+      fsExtra.copySync(helpCsv, path.join(targetBmadDir, 'module-help.csv'));
+      updated++;
+    }
+
+    // Update manifest version (preserve everything else)
+    manifest.version = packageJson.version;
+    manifest.lastUpdated = new Date().toISOString();
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf8');
+
+    spinner.stop(i.update_done ? i.update_done(updated) : `✅ ${updated} files updated to v${packageJson.version}`);
+
+    clack.log.info('📋 Config preserved: config.yaml, IDE configs, output directories');
+    clack.outro(pc.green(i.update_ready || `BMAD+ v${packageJson.version} is ready! 🚀`));
+  },
+};