bmad-plus 0.8.0 → 0.9.1

package/tools/cli/commands/install.js

@@ -8,123 +8,17 @@
 
 const path = require('node:path');
 const fs = require('node:fs');
-const os = require('node:os');
 const fsExtra = require('fs-extra');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
 const { t, getLanguageOptions, getCommLanguageOptions } = require('../i18n');
+const { PACKS } = require('../lib/packs');
+const { copyPackFiles } = require('../lib/pack-copy');
+const { initMemory } = require('../lib/memory-init');
+const { generateIDEConfig, IDE_CONFIGS } = require('../lib/ide-config');
+const { validateUserName } = require('../lib/validate');
 
-// Pack definitions
-const PACKS = {
-  core: {
-    name: 'Core Development',
-    icon: '⚙️',
-    description: '4 multi-role agents (Atlas, Forge, Sentinel, Nexus)',
-    required: true,
-    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: {
-    name: 'OSINT Intelligence',
-    icon: '🔍',
-    description: 'Agent Shadow — investigation, scraping, psychoprofil',
-    required: false,
-    agents: ['agent-shadow'],
-    skills: [],
-    externalPackage: 'osint-agent-package',
-  },
-  maker: {
-    name: 'Agent Creator',
-    icon: '🧬',
-    description: 'Maker — design, build, and package new BMAD+ agents',
-    required: false,
-    agents: ['agent-maker'],
-    skills: [],
-    data: [],
-  },
-  shield: {
-    name: 'Pack Shield (GRC)',
-    icon: '🛡️',
-    description: '38 compliance agents — GDPR, ISO 27001, SOC 2, PCI DSS, EU AI Act...',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-shield',
-    packSrcDir: 'packs',
-  },
-  'dev-studio': {
-    name: 'Dev Studio — Full SDLC',
-    icon: '🏗️',
-    description: 'Full SDLC pipeline: brainstorm → PRD → architecture → TDD → code review → deploy',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-dev-studio',
-    packSrcDir: 'packs',
-  },
-  seo: {
-    name: 'SEO Audit 360',
-    icon: '🔍',
-    description: '3 agents (Scout, Chief, Judge) + 6-phase audit + PageSpeed loop',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-seo',
-  },
-  backup: {
-    name: 'Universal Backup',
-    icon: '🗂️',
-    description: 'Timestamped ZIP backup with smart exclusions',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-backup',
-  },
-  animated: {
-    name: 'Animated Website',
-    icon: '🎬',
-    description: 'Luxury scroll-driven website from video',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-animated',
-  },
-  memory: {
-    name: 'Memory — Persistent Brain',
-    icon: '🧠',
-    description: 'Cross-session memory + project scanner + Karpathy guardrails. Agents learn.',
-    required: false,
-    agents: [],
-    skills: [],
-    packDir: 'pack-memory',
-    packSrcDir: 'packs',
-  },
-};
-
-// IDE configurations
-const IDE_CONFIGS = {
-  'claude-code': {
-    name: 'Claude Code',
-    detect: ['.claude'],
-    configFile: 'CLAUDE.md',
-  },
-  'gemini-cli': {
-    name: 'Gemini CLI',
-    detect: ['.gemini'],
-    configFile: 'GEMINI.md',
-  },
-  'codex-cli': {
-    name: 'Codex CLI / OpenCode',
-    detect: ['.codex', '.opencode'],
-    configFile: 'AGENTS.md',
-  },
-  'antigravity': {
-    name: 'Antigravity',
-    detect: ['.gemini/antigravity'],
-    configFile: 'GEMINI.md',
-  },
-};
+// Pack definitions are imported from the shared module: require('../lib/packs').PACKS
 
 module.exports = {
   command: 'install',
@@ -133,6 +27,7 @@ module.exports = {
     ['-d, --directory <path>', 'Installation directory (default: current directory)'],
     ['-p, --packs <packs>', 'Comma-separated pack IDs: core,osint,all (default: interactive)'],
     ['-y, --yes', 'Accept all defaults, skip prompts'],
+    ['-l, --lang <code>', 'Language code: en, fr, es, de, pt-br, ru, zh, he, ja, it (overrides auto-detection)'],
     ['--tools <tools>', 'Comma-separated IDE IDs (default: auto-detect)'],
   ],
   action: async (options) => {
@@ -144,8 +39,8 @@ module.exports = {
     clack.intro(pc.bgCyan(pc.black(` BMAD+ Installer v${pkgJson.version} `)));
     clack.log.info(pc.dim('✨ Created by Laurent Rochetta — github.com/lrochetta/BMAD-PLUS'));
 
-    let lang = 'en';
-    if (!options.yes) {
+    let lang = options.lang || 'en';
+    if (!options.yes && !options.lang) {
       const langChoice = await clack.select({
         message: '🌐 Select your language / Choisissez votre langue / 选择语言',
         options: getLanguageOptions(),
@@ -153,7 +48,7 @@ module.exports = {
 
       if (clack.isCancel(langChoice)) {
         clack.cancel('Installation cancelled.');
-        process.exit(0);
+        throw new Error('Installation cancelled.');
       }
       lang = langChoice;
     }
@@ -164,7 +59,7 @@ module.exports = {
     if (!fs.existsSync(bmadSrc)) {
       clack.log.error(`${i.source_not_found}: ${bmadSrc}`);
       clack.outro(pc.red(i.failed));
-      process.exit(1);
+      throw new Error(`Source not found: ${bmadSrc}`);
     }
 
     clack.log.info(`${i.installing_to}: ${pc.cyan(projectDir)}`);
@@ -187,7 +82,7 @@ module.exports = {
           .map(([key, pack]) => ({
             value: key,
             label: `${pack.icon} ${pack.name}`,
-            hint: pack.disabled ? i.soon : pack.description,
+            hint: pack.disabled ? i.soon : (pack.desc || pack.description || ''),
             disabled: pack.disabled,
           })),
         required: false,
@@ -195,7 +90,7 @@ module.exports = {
 
       if (clack.isCancel(packChoice)) {
         clack.cancel(i.cancelled);
-        process.exit(0);
+        throw new Error(i.cancelled);
       }
 
       selectedPacks = [...new Set(['core', ...packChoice])];
@@ -278,10 +173,15 @@ module.exports = {
 
       if (clack.isCancel(userConfig)) {
         clack.cancel(i.cancelled);
-        process.exit(0);
+        throw new Error(i.cancelled);
       }
 
-      userName = userConfig.userName;
+      // Validate user-provided name
+      const rawName = userConfig.userName;
+      const fb = process.env.USER || process.env.USERNAME || 'Developer';
+      const { name: validatedName, warnings } = validateUserName(rawName, fb);
+      for (const w of warnings) clack.log.warn(w);
+      userName = validatedName;
       commLang = userConfig.commLang;
     }
 
@@ -302,148 +202,26 @@ module.exports = {
     let copiedSkills = 0;
     let copiedFiles = 0;
 
+    const projectRoot = path.join(bmadSrc, '..', '..');
+
     for (const packId of selectedPacks) {
       const pack = PACKS[packId];
       if (!pack || pack.disabled) continue;
 
-      // Copy 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 });
-          copiedAgents++;
-        }
-      }
-
-      // Copy 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 });
-          copiedSkills++;
-        }
-      }
-
-      // Copy 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 });
-          copiedFiles++;
-        }
-      }
-
-      // Copy external package (OSINT)
-      if (pack.externalPackage) {
-        const extSrc = path.join(__dirname, '..', '..', '..', pack.externalPackage, 'skills');
-        const extDest = path.join(targetAgentsDir);
-        if (fs.existsSync(extSrc)) {
-          fsExtra.copySync(extSrc, extDest, { overwrite: true });
-          copiedSkills++;
-        }
-      }
-
-      // Copy pack directory (SEO, Backup, Animated Website, Shield)
-      if (pack.packDir) {
-        const srcParent = pack.packSrcDir || 'agents';
-        const packSrc = path.join(bmadSrc, srcParent, pack.packDir);
-        const packDest = path.join(targetAgentsDir, pack.packDir);
-        if (fs.existsSync(packSrc)) {
-          fsExtra.copySync(packSrc, packDest, { overwrite: true });
-          copiedAgents++;
-          copiedFiles++;
-        }
-      }
+      const result = copyPackFiles({
+        bmadSrc,
+        targetAgentsDir,
+        targetDataDir,
+        projectRoot,
+        pack,
+      });
+      copiedAgents += result.copiedAgents;
+      copiedSkills += result.copiedSkills;
+      copiedFiles += result.copiedFiles;
 
       // Memory pack: initialize brain with existing brain detection
       if (packId === 'memory' && pack.packDir) {
-        const memoryDir = path.join(projectDir, '.agents', 'memory');
-        const sessionsDir = path.join(memoryDir, 'sessions');
-        const globalBrainDir = path.join(os.homedir(), '.bmad-plus', 'brain', 'projects');
-        const templateDir = path.join(bmadSrc, 'packs', 'pack-memory', 'templates');
-
-        // Create project memory (never overwrite existing)
-        fsExtra.ensureDirSync(sessionsDir);
-        const memoryFiles = ['decisions.md', 'lessons.md', 'patterns.md', 'context.md'];
-        for (const mf of memoryFiles) {
-          const dest = path.join(memoryDir, mf);
-          if (!fs.existsSync(dest)) {
-            const src = path.join(templateDir, mf);
-            if (fs.existsSync(src)) {
-              let content = fs.readFileSync(src, 'utf8');
-              content = content.replace(/\{\{date\}\}/g, new Date().toISOString().slice(0, 10));
-              content = content.replace(/\{\{project_name\}\}/g, path.basename(projectDir));
-              content = content.replace(/\{\{project_path\}\}/g, projectDir);
-              fs.writeFileSync(dest, content, 'utf8');
-            }
-          }
-        }
-
-        // Detect existing brain directories
-        const brainCandidates = [
-          path.join(os.homedir(), '.bmad-plus', 'brain'),
-          path.join(projectDir, '_brain'),
-          path.join(os.homedir(), '.claude', 'memory'),
-        ];
-        const existingBrain = brainCandidates.find(p => fs.existsSync(p));
-
-        if (existingBrain) {
-          clack.log.info(`🧠 ${i.brain_detected || 'Existing brain detected'}: ${existingBrain}`);
-          // Write brain link pointer
-          fs.writeFileSync(
-            path.join(memoryDir, '.brain-link'),
-            JSON.stringify({ linked_brain: existingBrain, linked_at: new Date().toISOString() }, null, 2),
-            'utf8'
-          );
-        } else {
-          // Create fresh global brain
-          fsExtra.ensureDirSync(globalBrainDir);
-          const identitySrc = path.join(templateDir, 'identity.yaml');
-          const identityDest = path.join(os.homedir(), '.bmad-plus', 'brain', 'identity.yaml');
-          if (fs.existsSync(identitySrc) && !fs.existsSync(identityDest)) {
-            let content = fs.readFileSync(identitySrc, 'utf8');
-            content = content.replace(/\{\{user_name\}\}/g, userName);
-            content = content.replace(/\{\{language\}\}/g, commLang);
-            content = content.replace(/\{\{date\}\}/g, new Date().toISOString().slice(0, 10));
-            fs.writeFileSync(identityDest, content, 'utf8');
-          }
-          // Copy global memory templates
-          for (const gf of ['decisions.md', 'lessons.md', 'patterns.md']) {
-            const dest = path.join(os.homedir(), '.bmad-plus', 'brain', gf);
-            if (!fs.existsSync(dest)) {
-              const src = path.join(templateDir, gf);
-              if (fs.existsSync(src)) {
-                let content = fs.readFileSync(src, 'utf8');
-                content = content.replace(/\{\{date\}\}/g, new Date().toISOString().slice(0, 10));
-                content = content.replace(/\{\{project_name\}\}/g, 'Global Brain');
-                fs.writeFileSync(dest, content, 'utf8');
-              }
-            }
-          }
-          clack.log.info(`🧠 ${i.brain_created || 'Global brain created'}: ${path.join(os.homedir(), '.bmad-plus', 'brain')}`);
-        }
-
-        // Index this project in global brain
-        const crypto = require('node:crypto');
-        const projHash = crypto.createHash('sha256').update(projectDir).digest('hex').slice(0, 8);
-        const projMeta = {
-          path: projectDir,
-          name: path.basename(projectDir),
-          hash: projHash,
-          status: 'active',
-          bmad_installed: true,
-          packs_installed: selectedPacks,
-          last_scanned: new Date().toISOString().slice(0, 10),
-        };
-        fsExtra.ensureDirSync(globalBrainDir);
-        fs.writeFileSync(
-          path.join(globalBrainDir, `${projHash}.yaml`),
-          Object.entries(projMeta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
-          'utf8'
-        );
+        initMemory({ projectDir, bmadSrc, userName, commLang, selectedPacks });
       }
     }
 
@@ -632,94 +410,6 @@ module.exports = {
 
 // ── Helpers ──
 
-function generateIDEConfig(userName, language, packs) {
-  const agents = [
-    '- **Atlas** (Strategist) — Business analysis + Product management',
-    '- **Forge** (Architect-Dev) — Architecture + Development + Documentation',
-    '- **Sentinel** (Quality) — QA + UX review',
-    '- **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution',
-  ];
-
-  if (packs.includes('osint')) {
-    agents.push('- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling');
-  }
-
-  if (packs.includes('shield')) {
-    agents.push('- **Shield** (GRC) — 38 compliance agents (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)');
-  }
-
-  if (packs.includes('dev-studio')) {
-    agents.push('- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs');
-    agents.push('- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review');
-    agents.push('- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization');
-    agents.push('- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping');
-    agents.push('- **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories');
-    agents.push('- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation');
-  }
-
-  if (packs.includes('memory')) {
-    agents.push('- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall');
-  }
-
-  // Build memory section if memory pack is installed
-  let memorySection = '';
-  if (packs.includes('memory')) {
-    memorySection = [
-      '',
-      '## Memory Protocol (Karpathy Guardrails)',
-      '',
-      'Agents MUST follow these behavioral principles:',
-      '',
-      '### G1 — Think Before Coding',
-      '- State assumptions explicitly. If uncertain, ask.',
-      '- Check `.agents/memory/decisions.md` for prior decisions before re-deciding.',
-      '',
-      '### G2 — Simplicity First',
-      '- Minimum code that solves the problem. Nothing speculative.',
-      '- Check `.agents/memory/patterns.md` for existing solutions.',
-      '',
-      '### G3 — Surgical Changes',
-      '- Touch only what you must. Match existing style.',
-      '- Log surprises in `.agents/memory/lessons.md`.',
-      '',
-      '### G4 — Goal-Driven Execution',
-      '- Define success criteria before implementing.',
-      '- Log non-obvious decisions in `.agents/memory/decisions.md`.',
-      '',
-      '### Memory Files',
-      '- `.agents/memory/decisions.md` — Read at session start, write when making decisions',
-      '- `.agents/memory/lessons.md` — Write when something unexpected happens',
-      '- `.agents/memory/patterns.md` — Write when a reusable pattern is validated',
-      '- `.agents/memory/context.md` — Update at session end with project state',
-    ].join('\n');
-  }
-
-  return `# BMAD+ — AI Agent Configuration
-
-## Project Context
-This project uses BMAD+, an augmented AI-driven development framework.
-Based on BMAD-METHOD v6.6.0 with multi-role agents, autopilot mode, and parallel execution.
-
-## Agents
-To activate an agent, say its name or persona:
-${agents.join('\n')}
-
-## Skills
-- Load skills from \`.agents/skills/\`
-- Each agent has a SKILL.md with capabilities, activation protocol, and role-switching rules
-- Auto-activation triggers: \`.agents/data/role-triggers.yaml\`
-
-## Key Commands
-- \`bmad-help\` — Show all available agents and skills
-- \`autopilot\` — Launch Nexus in full pipeline mode
-- \`parallel\` — Enable parallel multi-agent execution
-
-## Communication
-- User name: ${userName}
-- Default language: ${language} for user-facing content, English for code and technical docs.
-${memorySection}`;
-}
-
 function generateConfigYaml(userName, language, projectDir) {
   const projectName = path.basename(projectDir);
   return `# BMAD+ Project Configuration

package/tools/cli/commands/memory.js

@@ -40,6 +40,7 @@ module.exports = {
   description: 'Manage BMAD+ persistent brain (status, export)',
   options: [
     ['-d, --directory <path>', 'Project directory (default: current directory)'],
+    ['-l, --lang <code>', 'Language code: en, fr, es, de, pt-br, ru, zh, he, ja, it'],
   ],
   subcommands: {
     status: 'Show memory health report',

package/tools/cli/commands/scan.js

@@ -12,34 +12,7 @@ const os = require('node:os');
 const crypto = require('node:crypto');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
-
-// Project detection markers (priority order)
-const PROJECT_MARKERS = [
-  { file: 'package.json', stack: 'Node.js', detect: (dir) => {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
-      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-      if (deps['next']) return 'Next.js';
-      if (deps['nuxt']) return 'Nuxt';
-      if (deps['react']) return 'React';
-      if (deps['vue']) return 'Vue.js';
-      if (deps['svelte']) return 'Svelte';
-      if (deps['express']) return 'Express';
-      if (deps['fastify']) return 'Fastify';
-      if (deps['electron']) return 'Electron';
-      if (deps['tauri']) return 'Tauri';
-      return 'Node.js';
-    } catch { return 'Node.js'; }
-  }},
-  { file: 'Cargo.toml', stack: 'Rust' },
-  { file: 'pyproject.toml', stack: 'Python' },
-  { file: 'requirements.txt', stack: 'Python' },
-  { file: 'go.mod', stack: 'Go' },
-  { file: 'composer.json', stack: 'PHP' },
-  { file: 'Gemfile', stack: 'Ruby' },
-  { file: 'pom.xml', stack: 'Java' },
-  { file: 'build.gradle', stack: 'Java/Kotlin' },
-];
+const { PROJECT_MARKERS } = require('../lib/stack-detect');
 
 // Directories to skip during scanning
 const SKIP_DIRS = new Set([
@@ -77,7 +50,9 @@ function getProjectName(dir) {
       const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
       if (pkg.name) return pkg.name;
     }
-  } catch {}
+  } catch {
+    // Malformed/unreadable package.json; fall back to directory name.
+  }
   return path.basename(dir);
 }
 
@@ -143,6 +118,46 @@ function scanDirectory(rootDir, maxDepth = 4, currentDepth = 0, activeDays = 30,
   return projects;
 }
 
+/**
+ * Index a single project in the global brain by writing its metadata YAML file.
+ * @param {object} project - Project metadata object
+ * @param {string} globalBrainDir - Path to the brain projects directory
+ * @returns {void}
+ */
+function indexProject(project, globalBrainDir) {
+  const hash = crypto.createHash('sha256').update(project.path).digest('hex').slice(0, 8);
+  const meta = {
+    path: project.path,
+    name: project.name,
+    hash,
+    stack: project.stack,
+    status: project.status,
+    bmad_installed: project.bmad,
+    has_git: project.hasGit,
+    last_scanned: new Date().toISOString().slice(0, 10),
+  };
+  fs.writeFileSync(
+    path.join(globalBrainDir, `${hash}.yaml`),
+    Object.entries(meta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
+    'utf8'
+  );
+}
+
+/**
+ * Index multiple projects in the global brain.
+ * @param {object[]} projectList - Array of project metadata objects
+ * @param {string} brainDir - Path to the brain projects directory
+ * @returns {number} Number of projects indexed
+ */
+function indexProjects(projectList, brainDir) {
+  let count = 0;
+  for (const proj of projectList) {
+    indexProject(proj, brainDir);
+    count++;
+  }
+  return count;
+}
+
 module.exports = {
   command: 'scan',
   description: 'Scan directories to discover and index projects in the global brain',
@@ -152,12 +167,19 @@ module.exports = {
     ['--active-days <n>', 'Days since last modified to consider a project "active" (default: 30)', '30'],
     ['--paused-days <n>', 'Days since last modified to consider a project "paused" (default: 180)', '180'],
     ['-y, --yes', 'Index all projects without prompting'],
+    ['-l, --lang <code>', 'Language code: en, fr, es, de, pt-br, ru, zh, he, ja, it'],
   ],
   action: async (options) => {
     const scanDir = path.resolve(options.directory || process.cwd());
-    const maxDepth = parseInt(options.depth) || 4;
-    const activeDays = parseInt(options.activeDays) || 30;
-    const pausedDays = parseInt(options.pausedDays) || 180;
+
+    const rawDepth = parseInt(options.depth, 10);
+    const maxDepth = (!isNaN(rawDepth) && rawDepth > 0) ? rawDepth : (() => { clack.log.warn(`Invalid --depth "${options.depth}", defaulting to 4`); return 4; })();
+
+    const rawActive = parseInt(options.activeDays, 10);
+    const activeDays = (!isNaN(rawActive) && rawActive > 0) ? rawActive : (() => { clack.log.warn(`Invalid --active-days "${options.activeDays}", defaulting to 30`); return 30; })();
+
+    const rawPaused = parseInt(options.pausedDays, 10);
+    const pausedDays = (!isNaN(rawPaused) && rawPaused > 0) ? rawPaused : (() => { clack.log.warn(`Invalid --paused-days "${options.pausedDays}", defaulting to 180`); return 180; })();
 
     clack.intro(pc.bgMagenta(pc.white(' 🧠 BMAD+ Project Scanner ')));
 
@@ -218,26 +240,7 @@ module.exports = {
       const fsExtra = require('fs-extra');
       fsExtra.ensureDirSync(globalBrainDir);
 
-      let indexed = 0;
-      for (const proj of projects) {
-        const hash = crypto.createHash('sha256').update(proj.path).digest('hex').slice(0, 8);
-        const meta = {
-          path: proj.path,
-          name: proj.name,
-          hash,
-          stack: proj.stack,
-          status: proj.status,
-          bmad_installed: proj.bmad,
-          has_git: proj.hasGit,
-          last_scanned: new Date().toISOString().slice(0, 10),
-        };
-        fs.writeFileSync(
-          path.join(globalBrainDir, `${hash}.yaml`),
-          Object.entries(meta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
-          'utf8'
-        );
-        indexed++;
-      }
+      const indexed = indexProjects(projects, globalBrainDir);
       clack.log.success(`✅ ${indexed} project(s) indexed in ${globalBrainDir}`);
     } else {
       // Interactive mode
@@ -279,27 +282,7 @@ module.exports = {
         toIndex = selected.map(i => projects[i]);
       }
 
-      let indexed = 0;
-      for (const proj of toIndex) {
-        const hash = crypto.createHash('sha256').update(proj.path).digest('hex').slice(0, 8);
-        const meta = {
-          path: proj.path,
-          name: proj.name,
-          hash,
-          stack: proj.stack,
-          status: proj.status,
-          bmad_installed: proj.bmad,
-          has_git: proj.hasGit,
-          last_scanned: new Date().toISOString().slice(0, 10),
-        };
-        fs.writeFileSync(
-          path.join(globalBrainDir, `${hash}.yaml`),
-          Object.entries(meta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
-          'utf8'
-        );
-        indexed++;
-      }
-
+      const indexed = indexProjects(toIndex, globalBrainDir);
       clack.log.success(`✅ ${indexed} project(s) indexed in global brain`);
     }
 
@@ -319,7 +302,9 @@ module.exports = {
             }
           }
           existingProjects.push(meta);
-        } catch {}
+        } catch {
+          // Skip a project entry whose index file is unreadable/corrupt.
+        }
       }
     }
 
@@ -356,5 +341,7 @@ module.exports = {
     getProjectName,
     hasBmadInstalled,
     scanDirectory,
+    indexProject,
+    indexProjects,
   },
 };

package/tools/cli/commands/uninstall.js

@@ -11,12 +11,15 @@ const fs = require('node:fs');
 const fsExtra = require('fs-extra');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
-const { t, getLanguageOptions } = require('../i18n');
+const { t } = require('../i18n');
 
 module.exports = {
   command: 'uninstall',
   description: 'Remove BMAD+ from your project',
-  action: async () => {
+  options: [
+    ['-l, --lang <code>', 'Language code: en, fr, es, de, pt-br, ru, zh, he, ja, it'],
+  ],
+  action: async (options) => {
     const projectDir = process.cwd();
 
     clack.intro(pc.bgRed(pc.white(' BMAD+ Uninstaller ')));
@@ -31,8 +34,8 @@ module.exports = {
 
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
 
-    // Use the language from install manifest, or ask
-    let lang = manifest.uiLanguage || 'en';
+    // Use --lang flag, or fall back to manifest language
+    let lang = options.lang || manifest.uiLanguage || 'en';
     const i = t(lang);
 
     clack.log.info(`BMAD+ v${manifest.version} (${i.installed_on || 'installed'} ${manifest.installed.split('T')[0]})`);