bmad-plus 0.12.0 → 0.12.2

package/tools/cli/lib/ide-config.js

@@ -1,259 +1,267 @@
-/**
- * BMAD+ IDE Configuration Generator
- * Extracted from install.js for modularity.
- * Generates CLAUDE.md, GEMINI.md, AGENTS.md content with pack-aware agent filtering.
- *
- * Author: Laurent Rochetta
- */
-
-// ── 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',
-  },
-};
-
-// All 14 BMAD+ agents — always included in templates
-const AGENT_LIST = [
-  '- **Atlas** (Strategist) — Business analysis + Product management',
-  '- **Forge** (Architect-Dev) — Architecture + Development + Documentation',
-  '- **Sentinel** (Quality) — QA + UX review',
-  '- **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution',
-  '- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling',
-  '- **Shield** (GRC) — 38 compliance agents (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)',
-  '- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs',
-  '- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review',
-  '- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization',
-  '- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping',
-  '- **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories',
-  '- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation',
-  '- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall',
-  '- **Maker** (Creator) — Custom agent builder — Create new agents from description',
-];
-
-/**
- * Filter agents based on installed packs.
- * Core agents are always included; others depend on pack selection.
- *
- * @param {string[]} packs - List of installed pack IDs
- * @returns {string[]} Agent description lines
- */
-function getAgentsByPacks(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('maker')) {
-    agents.push('- **Maker** (Creator) — Custom agent builder — Create new agents from description');
-  }
-
-  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 Architecture — 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');
-  }
-
-  return agents;
-}
-
-/**
- * Build the Memory Protocol section if the memory pack is installed.
- *
- * @param {string[]} packs - List of installed pack IDs
- * @returns {string} Memory section markdown (empty string if no memory pack)
- */
-function getMemorySection(packs) {
-  if (!packs.includes('memory')) return '';
-  return [
-    '',
-    '## 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');
-}
-
-/**
- * Generate IDE config content with pack-aware agent filtering.
- *
- * @param {string} userName - The user's display name
- * @param {string} language - User-facing communication language
- * @param {string[]} packs - List of installed pack IDs
- * @returns {string} Complete Markdown template
- */
-function generateIDEConfig(userName, language, packs) {
-  const agents = getAgentsByPacks(packs);
-  const memorySection = getMemorySection(packs);
-
-  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}`;
-}
-
-/**
- * Generate a complete CLAUDE.md / GEMINI.md / AGENTS.md config file
- * (all agents, no filtering — backward compatible)
- *
- * @param {string} userName - The user's display name
- * @param {string} language - User-facing communication language
- * @returns {string} Complete Markdown template
- */
-function generateBaseConfig(userName, language) {
-  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:
-${AGENT_LIST.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.
-
-## 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`;
-}
-
-module.exports = {
-  IDE_CONFIGS,
-  generateIDEConfig,
-  getAgentsByPacks,
-
-  /**
-   * Generate CLAUDE.md config for Claude Code
-   * @param {string} userName
-   * @param {string} language
-   * @returns {string}
-   */
-  generateClaudeMD: generateBaseConfig,
-
-  /**
-   * Generate GEMINI.md config for Gemini CLI / Antigravity
-   * @param {string} userName
-   * @param {string} language
-   * @returns {string}
-   */
-  generateGeminiMD: generateBaseConfig,
-
-  /**
-   * Generate AGENTS.md config for Codex CLI / OpenCode
-   * @param {string} userName
-   * @param {string} language
-   * @returns {string}
-   */
-  generateAgentsMD: generateBaseConfig,
-};
+/**
+ * BMAD+ IDE Configuration Generator
+ * Extracted from install.js for modularity.
+ * Generates CLAUDE.md, GEMINI.md, AGENTS.md content with pack-aware agent filtering.
+ *
+ * Author: Laurent Rochetta
+ */
+
+// ── 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',
+  },
+};
+
+// Shield ships 27 compliance agents (registry.yaml `shield.categories`) AND 11
+// workflows (`shield.workflows`) — two separate dimensions that must never be
+// summed into a single "agents" figure. Summing them is what produced the retired
+// "38" over-count that shipped into every generated user config. Declared once so
+// the two call sites below cannot drift apart; gated by tools/build/check-counts.js.
+const SHIELD_AGENT_LINE =
+  '- **Shield** (GRC) — 27 compliance agents + 11 workflows (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)';
+
+// All 14 BMAD+ agents — always included in templates
+const AGENT_LIST = [
+  '- **Atlas** (Strategist) — Business analysis + Product management',
+  '- **Forge** (Architect-Dev) — Architecture + Development + Documentation',
+  '- **Sentinel** (Quality) — QA + UX review',
+  '- **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution',
+  '- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling',
+  SHIELD_AGENT_LINE,
+  '- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs',
+  '- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review',
+  '- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization',
+  '- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping',
+  '- **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories',
+  '- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation',
+  '- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall',
+  '- **Maker** (Creator) — Custom agent builder — Create new agents from description',
+];
+
+/**
+ * Filter agents based on installed packs.
+ * Core agents are always included; others depend on pack selection.
+ *
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string[]} Agent description lines
+ */
+function getAgentsByPacks(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_AGENT_LINE);
+  }
+
+  if (packs.includes('maker')) {
+    agents.push('- **Maker** (Creator) — Custom agent builder — Create new agents from description');
+  }
+
+  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 Architecture — 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');
+  }
+
+  return agents;
+}
+
+/**
+ * Build the Memory Protocol section if the memory pack is installed.
+ *
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string} Memory section markdown (empty string if no memory pack)
+ */
+function getMemorySection(packs) {
+  if (!packs.includes('memory')) return '';
+  return [
+    '',
+    '## 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');
+}
+
+/**
+ * Generate IDE config content with pack-aware agent filtering.
+ *
+ * @param {string} userName - The user's display name
+ * @param {string} language - User-facing communication language
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string} Complete Markdown template
+ */
+function generateIDEConfig(userName, language, packs) {
+  const agents = getAgentsByPacks(packs);
+  const memorySection = getMemorySection(packs);
+
+  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}`;
+}
+
+/**
+ * Generate a complete CLAUDE.md / GEMINI.md / AGENTS.md config file
+ * (all agents, no filtering — backward compatible)
+ *
+ * @param {string} userName - The user's display name
+ * @param {string} language - User-facing communication language
+ * @returns {string} Complete Markdown template
+ */
+function generateBaseConfig(userName, language) {
+  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:
+${AGENT_LIST.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.
+
+## 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`;
+}
+
+module.exports = {
+  IDE_CONFIGS,
+  generateIDEConfig,
+  getAgentsByPacks,
+
+  /**
+   * Generate CLAUDE.md config for Claude Code
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateClaudeMD: generateBaseConfig,
+
+  /**
+   * Generate GEMINI.md config for Gemini CLI / Antigravity
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateGeminiMD: generateBaseConfig,
+
+  /**
+   * Generate AGENTS.md config for Codex CLI / OpenCode
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateAgentsMD: generateBaseConfig,
+};