bmad-plus 0.12.2 → 0.13.0

package/tools/cli/lib/pack-copy.js

@@ -1,84 +1,80 @@
 /**
- * BMAD+ Shared Pack-Copy Module
- * Extracted duplicate file-copy loops from install.js and update.js.
- *
+ * Shared deterministic pack enumeration and conservative installation copying.
  * Author: Laurent Rochetta
  */
-
 const path = require('node:path');
 const fs = require('node:fs');
-const fsExtra = require('fs-extra');
-
-/**
- * Copy files for a single pack definition into the target directories.
- *
- * @param {object} opts
- * @param {string} opts.bmadSrc      - Path to src/bmad-plus/
- * @param {string} opts.targetAgentsDir - Destination for agents / skills
- * @param {string} opts.targetDataDir   - Destination for data files
- * @param {string} opts.projectRoot    - Project root (for external package resolution)
- * @param {object} opts.pack           - Pack definition from PACKS
- * @returns {{ copiedAgents: number, copiedSkills: number, copiedFiles: number }}
- */
-function copyPackFiles({ bmadSrc, targetAgentsDir, targetDataDir, projectRoot, pack }) {
-  let copiedAgents = 0;
-  let copiedSkills = 0;
-  let copiedFiles = 0;
+const crypto = require('node:crypto');
+const { safeTarget } = require('../../build/generate-adapters');
 
-  if (!pack) return { copiedAgents, copiedSkills, copiedFiles };
+const fileHash = content => crypto.createHash('sha256').update(content).digest('hex');
 
-  // 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++;
+function listPackFiles({ bmadSrc, targetAgentsDir, targetDataDir, projectRoot, pack }) {
+  const result = { copiedAgents: 0, copiedSkills: 0, copiedFiles: 0, files: [] };
+  if (!pack) return result;
+  function walk(source, target) {
+    let stat;
+    try { stat = fs.lstatSync(source); } catch (error) {
+      if (error.code === 'ENOENT') return false;
+      throw error;
     }
+    if (stat.isSymbolicLink()) throw new Error('Pack source is a symbolic link: ' + source);
+    if (stat.isDirectory()) {
+      for (const name of fs.readdirSync(source).sort()) walk(path.join(source, name), path.join(target, name));
+    } else if (stat.isFile()) {
+      result.files.push({ source, target });
+    } else throw new Error('Pack source is not a regular file: ' + source);
+    return true;
   }
-
-  // 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++;
-    }
+  for (const name of pack.agents || []) {
+    if (walk(path.join(bmadSrc, 'agents', name), path.join(targetAgentsDir, name))) result.copiedAgents++;
   }
-
-  // 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++;
-    }
+  for (const name of pack.skills || []) {
+    if (walk(path.join(bmadSrc, 'skills', name), path.join(targetAgentsDir, name))) result.copiedSkills++;
   }
-
-  // Copy external package (e.g. OSINT)
-  if (pack.externalPackage) {
-    const extSrc = path.join(projectRoot, pack.externalPackage, 'skills');
-    if (fs.existsSync(extSrc)) {
-      fsExtra.copySync(extSrc, targetAgentsDir, { overwrite: true });
-      copiedSkills++;
-    }
+  for (const name of pack.data || []) {
+    if (walk(path.join(bmadSrc, 'data', name), path.join(targetDataDir, name))) result.copiedFiles++;
+  }
+  if (pack.externalPackage && walk(path.join(projectRoot, pack.externalPackage, 'skills'), targetAgentsDir)) result.copiedSkills++;
+  if (pack.packDir && walk(path.join(bmadSrc, pack.packSrcDir || 'agents', pack.packDir), path.join(targetAgentsDir, pack.packDir))) {
+    result.copiedAgents++;
+    result.copiedFiles++;
   }
+  return result;
+}
 
-  // Copy pack directory (SEO, Backup, Animated, Shield, etc.)
-  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++;
+function copyManagedFile({ source, target, projectDir, inventory, previousInventory = {}, onConflict = () => {} }) {
+  const file = path.relative(projectDir, target).split(path.sep).join('/');
+  safeTarget(projectDir, file);
+  const sourceStat = fs.lstatSync(source);
+  if (!sourceStat.isFile() || sourceStat.isSymbolicLink()) throw new Error('Pack source is not a regular file: ' + source);
+  const content = fs.readFileSync(source);
+  const hash = fileHash(content);
+  if (fs.existsSync(target)) {
+    const existingHash = fileHash(fs.readFileSync(target));
+    if (existingHash === hash) {
+      if (inventory) inventory[file] = hash;
+      return false;
+    }
+    if (previousInventory[file] !== existingHash) {
+      if (inventory && previousInventory[file]) inventory[file] = previousInventory[file];
+      onConflict(file);
+      return false;
     }
   }
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  safeTarget(projectDir, file);
+  fs.writeFileSync(target, content, { mode: sourceStat.mode });
+  if (inventory) inventory[file] = hash;
+  return true;
+}
 
-  return { copiedAgents, copiedSkills, copiedFiles };
+function copyPackFiles(options) {
+  const { files, ...counts } = listPackFiles(options);
+  const projectDir = options.projectDir || path.dirname(options.targetAgentsDir);
+  for (const { target } of files) safeTarget(projectDir, path.relative(projectDir, target).split(path.sep).join('/'));
+  for (const entry of files) copyManagedFile({ ...options, ...entry, projectDir });
+  return counts;
 }
 
-module.exports = { copyPackFiles };
+module.exports = { copyPackFiles, listPackFiles, copyManagedFile, fileHash };

package/tools/cli/lib/packs.js

@@ -62,7 +62,7 @@ const PACKS = {
     "skills": [],
     "packDir": "pack-shield",
     "packSrcDir": "packs",
-    "desc": "GRC compliance (25+ frameworks)"
+    "desc": "GRC compliance (26 frameworks)"
   },
   "seo": {
     "name": "SEO",
@@ -99,7 +99,7 @@ const PACKS = {
     ],
     "packDir": "pack-dev-studio",
     "packSrcDir": "packs",
-    "desc": "SDLC automation (6 agents, 56+ skills)"
+    "desc": "SDLC automation (6 agents, specialized workflows)"
   },
   "backup": {
     "name": "Backup",
@@ -206,4 +206,438 @@ const EXPECTED_AGENTS = {
   }
 };
 
-module.exports = { PACKS, PACK_ORDER, EXPECTED_AGENTS };
+const DERIVED = {
+  "product": {
+    "code": "bmad-plus",
+    "displayName": "BMAD+",
+    "version": "0.13.0",
+    "derivedFrom": "BMAD-METHOD v6.6.0"
+  },
+  "packOrder": [
+    "core",
+    "osint",
+    "maker",
+    "shield",
+    "seo",
+    "memory",
+    "dev-studio",
+    "backup",
+    "animated"
+  ],
+  "packCount": 9,
+  "installerAgents": 14,
+  "totalAgents": 47,
+  "languages": [
+    "en",
+    "fr",
+    "es",
+    "de",
+    "pt-br",
+    "ru",
+    "zh",
+    "he",
+    "ja",
+    "it"
+  ],
+  "packs": {
+    "core": {
+      "id": "core",
+      "order": 0,
+      "name": "Core",
+      "displayName": "Core Development",
+      "required": true,
+      "installerAgentCount": 4,
+      "categoryAgentCount": 0,
+      "agentCount": 4,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 0,
+      "categoryCount": 0,
+      "skillCount": 3,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "agent-strategist",
+          "name": "Atlas",
+          "role": "Strategist",
+          "description": "Business analysis + Product management"
+        },
+        {
+          "id": "agent-architect-dev",
+          "name": "Forge",
+          "role": "Architect-Dev",
+          "description": "Architecture + Development + Documentation"
+        },
+        {
+          "id": "agent-quality",
+          "name": "Sentinel",
+          "role": "Quality",
+          "description": "QA + UX review"
+        },
+        {
+          "id": "agent-orchestrator",
+          "name": "Nexus",
+          "role": "Orchestrator",
+          "description": "Sprint management + Autopilot + Parallel execution"
+        }
+      ],
+      "summary": "Multi-role agents for the full development lifecycle.",
+      "desc": "Core agents & skills",
+      "description": "Core agents & skills"
+    },
+    "osint": {
+      "id": "osint",
+      "order": 1,
+      "name": "OSINT",
+      "displayName": "OSINT Intelligence",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 1,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 2,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "agent-shadow",
+          "name": "Shadow",
+          "role": "OSINT",
+          "description": "Investigation + Scraping + Psychoprofiling"
+        }
+      ],
+      "summary": "Investigation & scraping (55+ Apify actors, 7 APIs).",
+      "desc": "OSINT & investigation",
+      "description": "OSINT & investigation"
+    },
+    "maker": {
+      "id": "maker",
+      "order": 2,
+      "name": "Maker",
+      "displayName": "Agent Creator",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 1,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 0,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "agent-maker",
+          "name": "Maker",
+          "role": "Agent Creator",
+          "description": "Design, build, validate, and package new BMAD+ agents"
+        }
+      ],
+      "summary": "Design, build, validate, and package new BMAD+-compatible agents.",
+      "desc": "Agent creation toolkit",
+      "description": "Agent creation toolkit"
+    },
+    "shield": {
+      "id": "shield",
+      "order": 3,
+      "name": "Shield",
+      "displayName": "Shield — GRC Compliance",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 27,
+      "agentCount": 27,
+      "subAgentCount": 0,
+      "workflowCount": 11,
+      "frameworkCount": 26,
+      "categoryCount": 6,
+      "skillCount": 0,
+      "referenceFiles": 79,
+      "categoryAgentCounts": [
+        5,
+        6,
+        6,
+        4,
+        3,
+        3
+      ],
+      "personas": [
+        {
+          "id": "shield-orchestrator",
+          "name": "Shield",
+          "role": "GRC",
+          "description": "Compliance agents for GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2 and more"
+        }
+      ],
+      "summary": "27 compliance agents + 11 workflows across 26+ frameworks.",
+      "desc": "GRC compliance (26 frameworks)",
+      "description": "GRC compliance (26 frameworks)"
+    },
+    "seo": {
+      "id": "seo",
+      "order": 4,
+      "name": "SEO",
+      "displayName": "SEO Audit 360",
+      "required": false,
+      "installerAgentCount": 3,
+      "categoryAgentCount": 0,
+      "agentCount": 3,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 1,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "seo-scout",
+          "name": "SEO Scout",
+          "role": "Technical Scanner",
+          "description": "Crawling + technical inspection + performance"
+        },
+        {
+          "id": "seo-chief",
+          "name": "SEO Chief",
+          "role": "Strategist & Reporter",
+          "description": "Scoring + strategy + reporting"
+        },
+        {
+          "id": "seo-judge",
+          "name": "SEO Judge",
+          "role": "Content & AI Analyst",
+          "description": "Content quality + structured data + GEO analysis"
+        }
+      ],
+      "summary": "3 agents (Scout, Chief, Judge) + 6-phase audit + PageSpeed loop.",
+      "desc": "SEO audit & optimization",
+      "description": "SEO audit & optimization"
+    },
+    "memory": {
+      "id": "memory",
+      "order": 5,
+      "name": "Memory",
+      "displayName": "Memory — Persistent Brain",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 1,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 0,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "zecher",
+          "name": "Zecher",
+          "role": "Memory Archivist",
+          "description": "Persistent cross-session memory, consolidation, project scanning, context recall, session handoffs",
+          "alias": "זכר, Memory Guardian"
+        }
+      ],
+      "summary": "Cross-session memory + project scanner + Karpathy guardrails.",
+      "desc": "Persistent cross-session memory",
+      "description": "Persistent cross-session memory"
+    },
+    "dev-studio": {
+      "id": "dev-studio",
+      "order": 6,
+      "name": "Dev Studio",
+      "displayName": "Dev Studio — Full SDLC",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 6,
+      "subAgentCount": 6,
+      "workflowCount": 38,
+      "frameworkCount": 0,
+      "categoryCount": 5,
+      "skillCount": 1,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [
+        0,
+        0,
+        0,
+        0,
+        0
+      ],
+      "personas": [
+        {
+          "id": "analyst-agent",
+          "name": "Miriam",
+          "role": "Business Analyst",
+          "description": "Strategic analysis, research, product briefs",
+          "alias": "מרים"
+        },
+        {
+          "id": "tech-writer-agent",
+          "name": "Huldah",
+          "role": "Technical Writer",
+          "description": "Documentation, diagrams, editorial review",
+          "alias": "חולדה"
+        },
+        {
+          "id": "pm-agent",
+          "name": "Yosef",
+          "role": "Product Manager",
+          "description": "PRD, requirements, feature prioritization",
+          "alias": "יוסף"
+        },
+        {
+          "id": "ux-designer-agent",
+          "name": "Rachel",
+          "role": "UX Designer",
+          "description": "User experience, wireframes, empathy mapping",
+          "alias": "רחל"
+        },
+        {
+          "id": "architect-agent",
+          "name": "Bezalel",
+          "role": "System Architect",
+          "description": "Architecture, ADRs, epics & stories",
+          "alias": "בצלאל"
+        },
+        {
+          "id": "dev-agent",
+          "name": "Oholiab",
+          "role": "Senior Engineer",
+          "description": "TDD, sprint, code review, implementation",
+          "alias": "אהליאב"
+        }
+      ],
+      "summary": "6 specialized agents + 38 workflows: Analysis → Planning → Architecture → Implementation → Review.",
+      "desc": "SDLC automation (6 agents, specialized workflows)",
+      "description": "SDLC automation (6 agents, specialized workflows)"
+    },
+    "backup": {
+      "id": "backup",
+      "order": 7,
+      "name": "Backup",
+      "displayName": "Universal Backup",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 1,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 0,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "backup-agent",
+          "name": "Backup Manager",
+          "role": "Backup & Restore",
+          "description": "Timestamped backups, restoration, and rotation"
+        }
+      ],
+      "summary": "Timestamped ZIP backup with smart exclusions.",
+      "desc": "Backup & restore",
+      "description": "Backup & restore"
+    },
+    "animated": {
+      "id": "animated",
+      "order": 8,
+      "name": "Animated",
+      "displayName": "Animated Website",
+      "required": false,
+      "installerAgentCount": 1,
+      "categoryAgentCount": 0,
+      "agentCount": 1,
+      "subAgentCount": 0,
+      "workflowCount": 0,
+      "frameworkCount": 0,
+      "categoryCount": 0,
+      "skillCount": 0,
+      "referenceFiles": 0,
+      "categoryAgentCounts": [],
+      "personas": [
+        {
+          "id": "animated-website-agent",
+          "name": "Animated Website Creator",
+          "role": "Website Builder",
+          "description": "Video-driven scrolling websites"
+        }
+      ],
+      "summary": "Luxury scroll-driven website from video.",
+      "desc": "Animated website agents",
+      "description": "Animated website agents"
+    }
+  },
+  "pythonPacks": {
+    "seo": {
+      "requirements": [
+        "src",
+        "bmad-plus",
+        "packs",
+        "pack-seo",
+        "requirements.txt"
+      ],
+      "verifyModules": [
+        "requests",
+        "bs4",
+        "defusedxml",
+        "lxml"
+      ]
+    },
+    "memory": {
+      "requirements": [
+        "mcp-server",
+        "requirements.txt"
+      ],
+      "verifyModules": [
+        "chromadb"
+      ]
+    }
+  },
+  "targets": {
+    "spine": "AGENTS.md",
+    "adapters": [
+      {
+        "tool": "claude-code",
+        "file": "CLAUDE.md"
+      },
+      {
+        "tool": "gemini-cli",
+        "file": "GEMINI.md"
+      },
+      {
+        "tool": "antigravity",
+        "file": "GEMINI.md"
+      },
+      {
+        "tool": "cursor",
+        "file": ".cursor/rules/bmad-plus.mdc"
+      },
+      {
+        "tool": "codex-cli",
+        "file": ".codex/AGENTS.md"
+      },
+      {
+        "tool": "opencode",
+        "file": ".opencode/AGENTS.md"
+      },
+      {
+        "tool": "aider",
+        "file": "CONVENTIONS.md"
+      }
+    ],
+    "models_supported": [
+      "claude",
+      "gpt",
+      "gemini",
+      "local"
+    ]
+  }
+};
+
+module.exports = { PACKS, PACK_ORDER, EXPECTED_AGENTS, DERIVED };