bmad-plus 0.13.0 → 0.16.0

package/tools/build/generate.js

@@ -35,15 +35,61 @@ const MODULE_TEMPLATE_PATH = path.join(__dirname, 'module.template.yaml');
 const PACKAGE_JSON_PATH = path.join(REPO_ROOT, 'package.json');
 
 const INSTALL_LAYOUTS = ['loose', 'packaged'];
-const OWNED_COUNT_RE = /(?<![\w.-])\d+\+?[\s-]+(?:[A-Za-zÀ-ÿ-]+\s+){0,6}(?:agents?|skills?|workflows?|packs?|frameworks?|languages?|reference files)\b/gi;
-const STANDARD_PREFIX_RE = /\b(?:ISO(?:\/IEC)?|IEC|SOC|NIST(?: SP)?|PCI(?: DSS)?|WCAG|Section)\s*$/i;
+const OWNED_COUNT_RE =
+  /(?<![\w.-])\d+\+?[\s-]+(?:[A-Za-zÀ-ÿ-]+\s+){0,6}(?:agents?|skills?|workflows?|packs?|frameworks?|languages?|reference files)\b/gi;
+const STANDARD_PREFIX_RE =
+  /\b(?:ISO(?:\/IEC)?|IEC|SOC|NIST(?: SP)?|PCI(?: DSS)?|WCAG|Section)\s*$/i;
 
 function hasOwnedCount(value) {
-  return [...value.matchAll(OWNED_COUNT_RE)].some((match) =>
-    !STANDARD_PREFIX_RE.test(value.slice(0, match.index))
+  return [...value.matchAll(OWNED_COUNT_RE)].some(
+    (match) => !STANDARD_PREFIX_RE.test(value.slice(0, match.index))
   );
 }
 
+function assertResourcePath(file, where) {
+  if (
+    typeof file !== 'string' ||
+    !file ||
+    /[\\:\0]/.test(file) ||
+    file.split('/').some((part) => !part || part === '.' || part === '..')
+  ) {
+    throw new Error(`${where}: required resource must be a portable relative file path`);
+  }
+}
+
+/** Installed entry points, derived from the same layout used by pack-copy.js. */
+function buildRequiredResources(pack) {
+  const where = `registry.yaml: pack "${pack.pack_dir}"`;
+  for (const file of [
+    ...pack.agents,
+    ...(pack.skills || []),
+    ...(pack.data || []),
+    ...((pack.doctor || {}).pack_agents || []),
+    ...((pack.doctor || {}).required_resources || []),
+    ...(pack.python_entry ? [pack.python_entry] : []),
+  ]) {
+    assertResourcePath(file, where);
+  }
+  const resources = [];
+  if (pack.install_layout === 'loose') {
+    resources.push(...pack.agents.map((id) => `.agents/skills/${id}/SKILL.md`));
+  } else {
+    resources.push(
+      ...pack.doctor.pack_agents.map((file) => `.agents/skills/${pack.pack_dir}/${file}`)
+    );
+  }
+  resources.push(...(pack.skills || []).map((id) => `.agents/skills/${id}/SKILL.md`));
+  resources.push(...(pack.data || []).map((file) => `.agents/data/${file}`));
+  resources.push(
+    ...((pack.doctor || {}).required_resources || []).map(
+      (file) => `.agents/skills/${pack.pack_dir}/${file}`
+    )
+  );
+  if (pack.python_entry) resources.push(`.agents/skills/${pack.pack_dir}/${pack.python_entry}`);
+  for (const file of resources) assertResourcePath(file, where);
+  return [...new Set(resources)];
+}
+
 /**
  * Validate the minimal contract the generator relies on.
  * Throws with a precise message on the first violation.
@@ -74,11 +120,15 @@ function validateRegistry(registry) {
       throw new Error(`${where}: missing cli.desc or cli.desc_template`);
     }
     for (const [field, value] of Object.entries({
-      'cli.desc': pack.cli.desc, 'cli.desc_template': pack.cli.desc_template,
-      summary: pack.summary, summary_template: pack.summary_template,
+      'cli.desc': pack.cli.desc,
+      'cli.desc_template': pack.cli.desc_template,
+      summary: pack.summary,
+      summary_template: pack.summary_template,
     })) {
       if (value !== undefined && (typeof value !== 'string' || hasOwnedCount(value))) {
-        throw new Error(`${where}: ${field} must use derived placeholders for owned count dimensions`);
+        throw new Error(
+          `${where}: ${field} must use derived placeholders for owned count dimensions`
+        );
       }
     }
     if (!Array.isArray(pack.agents)) throw new Error(`${where}: "agents" must be a list`);
@@ -94,22 +144,82 @@ function validateRegistry(registry) {
     if (pack.install_layout === 'packaged' && !Array.isArray((pack.doctor || {}).pack_agents)) {
       throw new Error(`${where}: packaged layout requires "doctor.pack_agents" list`);
     }
+    if (
+      pack.doctor?.required_resources !== undefined &&
+      !Array.isArray(pack.doctor.required_resources)
+    ) {
+      throw new Error(`${where}: doctor.required_resources must be a list`);
+    }
+    if (
+      !Array.isArray(pack.runtime) ||
+      pack.runtime.length === 0 ||
+      pack.runtime.some((runtime) => !Object.hasOwn(registry.runtimes || {}, runtime))
+    ) {
+      throw new Error(`${where}: runtime must declare known runtimes`);
+    }
+    buildRequiredResources(pack);
     if (pack.personas !== undefined) {
       if (!Array.isArray(pack.personas)) throw new Error(`${where}: personas must be a list`);
       const roster = new Set([...pack.agents, ...(pack.sub_agents || [])]);
       const ids = new Set();
       for (const persona of pack.personas) {
-        if (!persona || ['id', 'name', 'role', 'description'].some((key) =>
-          typeof persona[key] !== 'string' || !persona[key].trim())) {
+        if (
+          !persona ||
+          ['id', 'name', 'role', 'description'].some(
+            (key) => typeof persona[key] !== 'string' || !persona[key].trim()
+          )
+        ) {
           throw new Error(`${where}: each persona needs id, name, role and description`);
         }
         if (!roster.has(persona.id) || ids.has(persona.id)) {
-          throw new Error(`${where}: persona ${persona.id} is absent from its roster or duplicated`);
+          throw new Error(
+            `${where}: persona ${persona.id} is absent from its roster or duplicated`
+          );
         }
         ids.add(persona.id);
       }
     }
   }
+  const integration = registry.targets?.integration;
+  if (
+    integration?.execution !== 'host-managed' ||
+    integration?.lifecycle_events !== 'not-integrated'
+  ) {
+    throw new Error(
+      'registry.yaml: targets.integration must declare the delivered instruction integration'
+    );
+  }
+  const processBackend = registry.targets?.optional_process_backend;
+  if (
+    processBackend &&
+    (!isDeepStrictEqual(processBackend.adapters, ['command', 'codex-exec']) ||
+      processBackend.supervisor !== 'foreground' ||
+      processBackend.launch !== 'explicit-plan' ||
+      processBackend.collect !== 'exact-attempt-receipt' ||
+      processBackend.cancellation !== 'original-owner-direct-child' ||
+      processBackend.verification !== 'independent-required' ||
+      processBackend.scheduling !== 'none')
+  ) {
+    throw new Error(
+      'registry.yaml: optional process backend differs from the delivered Nexus contract'
+    );
+  }
+  for (const [runtime, config] of Object.entries(registry.runtimes || {})) {
+    if (
+      typeof config?.min_version !== 'string' ||
+      !/^\d+\.\d+(?:\.\d+)?$/.test(config.min_version)
+    ) {
+      throw new Error(`registry.yaml: runtime "${runtime}" needs a numeric min_version`);
+    }
+  }
+  const tools = new Set();
+  for (const adapter of registry.targets.adapters || []) {
+    if (!adapter || typeof adapter.tool !== 'string' || !adapter.tool || tools.has(adapter.tool)) {
+      throw new Error('registry.yaml: adapter tool names must be nonempty and unique');
+    }
+    tools.add(adapter.tool);
+    assertResourcePath(adapter.file, `registry.yaml: adapter "${adapter.tool}"`);
+  }
   return registry;
 }
 
@@ -171,10 +281,14 @@ function renderSummary(pack, derived, field = 'summary') {
   const fallback = field === 'summary' ? pack.summary : pack.cli.desc;
   if (!template) return fallback || '';
   const values = {
-    agent_count: derived.agentCount, installer_agent_count: derived.installerAgentCount,
-    sub_agent_count: derived.subAgentCount, workflow_count: derived.workflowCount,
-    framework_count: derived.frameworkCount, category_count: derived.categoryCount,
-    skill_count: derived.skillCount, reference_file_count: derived.referenceFiles,
+    agent_count: derived.agentCount,
+    installer_agent_count: derived.installerAgentCount,
+    sub_agent_count: derived.subAgentCount,
+    workflow_count: derived.workflowCount,
+    framework_count: derived.frameworkCount,
+    category_count: derived.categoryCount,
+    skill_count: derived.skillCount,
+    reference_file_count: derived.referenceFiles,
   };
   return template.replace(/\{([a-z_]+)\}/g, (_match, key) => {
     if (!(key in values)) throw new Error(`Unknown derived summary placeholder: ${key}`);
@@ -195,18 +309,33 @@ function buildDerived(registry, { sourceRoot = path.join(REPO_ROOT, 'src', 'bmad
     const installerAgentCount = pack.agents.length;
     const subAgentCount = (pack.sub_agents || []).length;
     const facts = {
-      id, order: pack.order, name: pack.cli.name, displayName: pack.display_name || pack.cli.name,
-      required: pack.required === true, installerAgentCount, categoryAgentCount,
+      id,
+      order: pack.order,
+      name: pack.cli.name,
+      displayName: pack.display_name || pack.cli.name,
+      required: pack.required === true,
+      installerAgentCount,
+      categoryAgentCount,
       agentCount: categoryAgentCount || subAgentCount || installerAgentCount,
       subAgentCount,
-      workflowCount: (pack.workflows || []).length + categories.reduce((sum, c) => sum + (c.workflows || []).length, 0),
+      workflowCount:
+        (pack.workflows || []).length +
+        categories.reduce((sum, c) => sum + (c.workflows || []).length, 0),
       frameworkCount: (pack.compliance_tags || []).length,
       categoryCount: categories.length,
       skillCount: (pack.skills || []).length,
-      referenceFiles: countMarkdownFiles(path.join(sourceRoot, pack.pack_src_dir || 'packs', pack.pack_dir, 'references')),
+      referenceFiles: countMarkdownFiles(
+        path.join(sourceRoot, pack.pack_src_dir || 'packs', pack.pack_dir, 'references')
+      ),
       categoryAgentCounts,
+      runtimes: [...pack.runtime],
+      requiredResources: buildRequiredResources(pack),
       personas: (pack.personas || []).map(({ id, name, role, description, alias }) => ({
-        id, name, role, description, ...(alias ? { alias } : {}),
+        id,
+        name,
+        role,
+        description,
+        ...(alias ? { alias } : {}),
       })),
     };
     facts.summary = renderSummary(pack, facts);
@@ -215,10 +344,13 @@ function buildDerived(registry, { sourceRoot = path.join(REPO_ROOT, 'src', 'bmad
     packs[id] = facts;
     installerAgents += installerAgentCount;
     totalAgents += new Set([
-      ...pack.agents, ...(pack.sub_agents || []), ...categories.flatMap((c) => c.agents || []),
+      ...pack.agents,
+      ...(pack.sub_agents || []),
+      ...categories.flatMap((c) => c.agents || []),
     ]).size;
     if ((pack.runtime || []).includes('python')) {
-      const packagePath = pack.python_package || `src/bmad-plus/${pack.pack_src_dir || 'packs'}/${pack.pack_dir}`;
+      const packagePath =
+        pack.python_package || `src/bmad-plus/${pack.pack_src_dir || 'packs'}/${pack.pack_dir}`;
       pythonPacks[id] = {
         requirements: [...packagePath.split(/[\\/]/), 'requirements.txt'],
         verifyModules: [...(pack.python_verify_modules || [])],
@@ -228,12 +360,35 @@ function buildDerived(registry, { sourceRoot = path.join(REPO_ROOT, 'src', 'bmad
   const { LANGUAGES } = require('../cli/i18n');
   return {
     product: {
-      code: registry.product.code, displayName: registry.product.display_name,
-      version: registry.product.version, derivedFrom: registry.product.derived_from,
+      code: registry.product.code,
+      displayName: registry.product.display_name,
+      version: registry.product.version,
+      derivedFrom: registry.product.derived_from,
     },
     packOrder: buildPackOrder(registry),
-    packCount: Object.keys(packs).length, installerAgents, totalAgents,
-    languages: Object.keys(LANGUAGES), packs, pythonPacks,
+    packCount: Object.keys(packs).length,
+    installerAgents,
+    totalAgents,
+    languages: Object.keys(LANGUAGES),
+    packs,
+    pythonPacks,
+    diagnostics: {
+      schemaVersion: 1,
+      processExecution: registry.targets.optional_process_backend || null,
+      runtimeMinimums: Object.fromEntries(
+        Object.entries(registry.runtimes).map(([id, runtime]) => [id, runtime.min_version])
+      ),
+      integrations: Object.fromEntries(
+        registry.targets.adapters.map(({ tool, file }) => [
+          tool,
+          {
+            instructionFile: file,
+            execution: registry.targets.integration.execution,
+            lifecycleEvents: registry.targets.integration.lifecycle_events,
+          },
+        ])
+      ),
+    },
     targets: {
       spine: registry.targets.spine,
       adapters: registry.targets.adapters.map(({ tool, file }) => ({ tool, file })),
@@ -251,11 +406,24 @@ function generateModuleSource(registry, templatePath = MODULE_TEMPLATE_PATH) {
   for (const [id, pack] of sortedPackEntries(registry)) {
     const facts = derived.packs[id];
     const entry = {
-      name: facts.displayName, icon: pack.icon_emoji, description: facts.summary || facts.desc,
-      required: facts.required, agents: [...pack.agents], skills: [...(pack.skills || [])],
+      name: facts.displayName,
+      icon: pack.icon_emoji,
+      description: facts.summary || facts.desc,
+      required: facts.required,
+      agents: [...pack.agents],
+      skills: [...(pack.skills || [])],
     };
-    for (const key of ['data', 'external_package', 'orchestrator', 'categories', 'workflows',
-      'sub_agents', 'required_keys', 'optional_keys', 'cohabitation_warning']) {
+    for (const key of [
+      'data',
+      'external_package',
+      'orchestrator',
+      'categories',
+      'workflows',
+      'sub_agents',
+      'required_keys',
+      'optional_keys',
+      'cohabitation_warning',
+    ]) {
       if (key in pack) entry[key] = JSON.parse(JSON.stringify(pack[key]));
     }
     if (pack.install_layout === 'packaged') {
@@ -265,14 +433,19 @@ function generateModuleSource(registry, templatePath = MODULE_TEMPLATE_PATH) {
     moduleConfig.packs[id] = entry;
   }
   moduleConfig.install_packs['multi-select'] = [
-    ...derived.packOrder.filter((id) => !derived.packs[id].required).map((id) => ({
-      value: id, label: `${registry.packs[id].icon_emoji} ${derived.packs[id].displayName} — ${derived.packs[id].summary || derived.packs[id].desc}`,
-    })),
+    ...derived.packOrder
+      .filter((id) => !derived.packs[id].required)
+      .map((id) => ({
+        value: id,
+        label: `${registry.packs[id].icon_emoji} ${derived.packs[id].displayName} — ${derived.packs[id].summary || derived.packs[id].desc}`,
+      })),
     { value: 'all', label: 'Tout installer' },
     { value: 'none', label: 'Aucun — Core uniquement' },
   ];
-  return '# AUTO-GENERATED from registry.yaml + tools/build/module.template.yaml — DO NOT EDIT.\n' +
-    yaml.dump(moduleConfig, { lineWidth: 110, noRefs: true });
+  return (
+    '# AUTO-GENERATED from registry.yaml + tools/build/module.template.yaml — DO NOT EDIT.\n' +
+    yaml.dump(moduleConfig, { lineWidth: 110, noRefs: true })
+  );
 }
 
 /**
@@ -373,6 +546,16 @@ function check({
   const mismatches = [];
 
   const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  const { checkPythonDelivery } = require('./pack-delivery');
+  mismatches.push(...checkPythonDelivery(registry, { packageRoot: REPO_ROOT, packageJson: pkg }));
+  try {
+    require('../cli/lib/studio').validatePack(
+      path.join(REPO_ROOT, 'src/bmad-plus/packs/pack-dev-studio'),
+      registry.packs['dev-studio']
+    );
+  } catch (error) {
+    mismatches.push('Dev Studio: ' + error.message);
+  }
   if (!registry.product || registry.product.version !== pkg.version) {
     const declared = registry.product ? registry.product.version : undefined;
     mismatches.push(
@@ -385,7 +568,9 @@ function check({
       describeDiff(key, generated[key], current[key], mismatches);
     }
   }
-  if (fs.readFileSync(modulePath, 'utf8').replace(/\r\n/g, '\n') !== generateModuleSource(registry)) {
+  if (
+    fs.readFileSync(modulePath, 'utf8').replace(/\r\n/g, '\n') !== generateModuleSource(registry)
+  ) {
     mismatches.push('module.yaml: generated pack metadata differs from registry.yaml');
   }
 
@@ -427,7 +612,11 @@ function main(argv) {
     const moduleOutIdx = args.indexOf('--module-out');
     if (moduleOutIdx !== -1) {
       if (!args[moduleOutIdx + 1]) throw new Error('--module-out requires a file path');
-      fs.writeFileSync(path.resolve(args[moduleOutIdx + 1]), generateModuleSource(registry), 'utf8');
+      fs.writeFileSync(
+        path.resolve(args[moduleOutIdx + 1]),
+        generateModuleSource(registry),
+        'utf8'
+      );
     }
     console.log(`Generated ${path.resolve(outPath)} from registry.yaml`);
     return 0;
@@ -437,10 +626,6 @@ function main(argv) {
   return 0;
 }
 
-if (require.main === module) {
-  process.exitCode = main(process.argv);
-}
-
 module.exports = {
   DEFAULT_REGISTRY_PATH,
   DEFAULT_PACKS_MODULE_PATH,
@@ -459,3 +644,7 @@ module.exports = {
   check,
   main,
 };
+
+if (require.main === module) {
+  process.exitCode = main(process.argv);
+}

package/tools/build/generated-adapters/.codex/AGENTS.md

@@ -113,7 +113,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc

@@ -118,7 +118,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/.opencode/AGENTS.md

@@ -113,7 +113,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/AGENTS.md

@@ -111,7 +111,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/CLAUDE.md

@@ -114,7 +114,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/CONVENTIONS.md

@@ -113,7 +113,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/generated-adapters/GEMINI.md

@@ -118,7 +118,7 @@ After a successful update, reread the project spine and relevant installed skill
 
 ## Registry facts (computed from registry.yaml — never hand-typed)
 
-- Product: BMAD+ v0.13.0 (derived from BMAD-METHOD v6.6.0)
+- Product: BMAD+ v0.16.0 (derived from BMAD-METHOD v6.6.0)
 - Models supported: claude, gpt, gemini, local (model-agnostic by contract)
 - Packs (9): Core, OSINT, Maker, Shield, SEO, Memory, Dev Studio, Backup, Animated
 - Installer agents (14 across all packs):

package/tools/build/pack-delivery.js

@@ -0,0 +1,78 @@
+/** Build-time Python delivery checks; the npm contract repeats them on the archive. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function portable(file) {
+  return (
+    typeof file === 'string' &&
+    Boolean(file) &&
+    !/[\\:\0*?![\]{}]/.test(file) &&
+    file.split('/').every((part) => part && part !== '.' && part !== '..')
+  );
+}
+
+function checkPythonDelivery(registry, { packageRoot, packageJson }) {
+  const errors = [];
+  const roots = (packageJson.files || []).map((root) => root.replace(/\/$/, ''));
+  for (const [id, pack] of Object.entries(registry.packs)) {
+    if (!pack.runtime.includes('python')) continue;
+    if (!portable(pack.python_package)) {
+      errors.push(`${id}: python_package must name a portable package directory`);
+      continue;
+    }
+    const resources = [`${pack.python_package}/requirements.txt`];
+    if (pack.python_entry !== undefined) {
+      if (!portable(pack.python_entry)) {
+        errors.push(`${id}: python_entry must remain inside python_package`);
+        continue;
+      }
+      resources.push(`${pack.python_package}/${pack.python_entry}`);
+    }
+    for (const file of resources) {
+      if (!roots.some((root) => portable(root) && (file === root || file.startsWith(`${root}/`)))) {
+        errors.push(`${id}: ${file} is outside package.json files roots`);
+      }
+      try {
+        const target = path.join(packageRoot, file);
+        if (!fs.lstatSync(target).isFile()) throw new Error('not a regular file');
+        const relative = path.relative(fs.realpathSync(packageRoot), fs.realpathSync(target));
+        if (relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
+          throw new Error('outside package');
+      } catch {
+        errors.push(`${id}: ${file} is missing or is not a regular file inside the package`);
+      }
+    }
+  }
+  return errors;
+}
+
+function checkSeoMirror(packageRoot) {
+  const shipped = path.join(packageRoot, 'src/bmad-plus/packs/pack-seo');
+  const tested = path.join(packageRoot, 'oveanet-pack/seo-audit-360');
+  const files = (root) =>
+    fs
+      .readdirSync(path.join(root, 'scripts'))
+      .filter((file) => file.endsWith('.py'))
+      .sort();
+  const shippedFiles = files(shipped);
+  const testedFiles = files(tested);
+  const errors = [];
+  if (JSON.stringify(shippedFiles) !== JSON.stringify(testedFiles))
+    errors.push('SEO script inventory differs between shipped and tested sources');
+  for (const file of ['requirements.txt', ...shippedFiles.map((file) => `scripts/${file}`)]) {
+    try {
+      if (
+        !fs.readFileSync(path.join(shipped, file)).equals(fs.readFileSync(path.join(tested, file)))
+      ) {
+        errors.push(`SEO shipped/tested sources differ: ${file}`);
+      }
+    } catch {
+      errors.push(`SEO shipped/tested source is missing: ${file}`);
+    }
+  }
+  return errors;
+}
+
+module.exports = { checkPythonDelivery, checkSeoMirror };

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

@@ -45,9 +45,7 @@ for (const option of install.options || []) {
 installCmd.action(install.action);
 
 // Uninstall command
-const uninstallCmd = program
-  .command('uninstall')
-  .description('Remove BMAD+ from your project');
+const uninstallCmd = program.command('uninstall').description('Remove BMAD+ from your project');
 for (const option of uninstall.options || []) {
   uninstallCmd.option(...option);
 }
@@ -64,9 +62,7 @@ for (const option of update.options || []) {
 updateCmd.action(update.action);
 
 // Doctor command
-const doctorCmd = program
-  .command('doctor')
-  .description('Check BMAD+ installation integrity');
+const doctorCmd = program.command('doctor').description('Check BMAD+ installation integrity');
 
 for (const option of doctor.options || []) {
   doctorCmd.option(...option);
@@ -81,7 +77,9 @@ const scanCmd = program
 for (const option of scan.options || []) {
   scanCmd.option(...option);
 }
-scanCmd.action((scanPath, options) => scan.action({ ...options, directory: scanPath || options.directory }));
+scanCmd.action((scanPath, options) =>
+  scan.action({ ...options, directory: scanPath || options.directory })
+);
 
 // Memory command
 const memoryCmd = program
@@ -95,9 +93,7 @@ memoryCmd.action(memory.action);
 
 // Mem command (Karpathy memory loop — journal recall/write/reinforce)
 const memJournal = require('./commands/memory-journal-cmd');
-const memJournalCmd = program
-  .command(memJournal.command)
-  .description(memJournal.description);
+const memJournalCmd = program.command(memJournal.command).description(memJournal.description);
 
 for (const option of memJournal.options || []) {
   memJournalCmd.option(...option);
@@ -116,15 +112,22 @@ for (const option of autoconfig.options || []) {
 autoconfigCmd.action(autoconfig.action);
 
 // Version discovery and explicit per-project update policy.
-for (const modulePath of ['./commands/update-check', './commands/update-policy']) {
+for (const modulePath of [
+  './commands/update-check',
+  './commands/update-policy',
+  './commands/studio',
+  './commands/nexus',
+  './commands/uat',
+]) {
   const command = require(modulePath);
   const configured = program.command(command.command).description(command.description);
+  if (command.aliases) configured.aliases(command.aliases);
   for (const option of command.options || []) configured.option(...option);
   configured.action(command.action);
 }
 
 // Await asynchronous registry checks and updates before completing the CLI.
-program.parseAsync(process.argv).catch(error => {
+program.parseAsync(process.argv).catch((error) => {
   console.error(`BMAD+: ${error.message}`);
   process.exitCode = 1;
 });