@clfhhc/bmad-methods-skills 0.0.2 → 0.0.5

package/README.md

@@ -1,5 +1,8 @@
 # BMAD-Methods-Skills
 
+[![Release](https://github.com/clfhhc/BMAD-Methods-Skills/actions/workflows/release.yml/badge.svg)](https://github.com/clfhhc/BMAD-Methods-Skills/actions/workflows/release.yml)
+[![npm](https://img.shields.io/npm/v/@clfhhc/bmad-methods-skills.svg)](https://www.npmjs.com/package/@clfhhc/bmad-methods-skills)
+
 Automatically convert BMAD-METHOD agents and workflows to Claude Skills format.
 
 ## Distribution (New Projects)
@@ -7,13 +10,14 @@ Automatically convert BMAD-METHOD agents and workflows to Claude Skills format.
 To install the BMAD bootstrap skill into a new project, you can use `npx`:
 
 ```bash
-npx @clfhhc/bmad-methods-skills init
+npx @clfhhc/bmad-methods-skills init --bootstrap
 ```
 
 This will:
 1. Detect your AI tool (.agent, .cursor, or .claude)
-2. Install the `bootstrap-bmad-skills` and `enhance-bmad-skills` into your project
-3. Enable the `BS` command to fetch and install all other BMAD skills via `npx`
+2. Automatically fetch, convert, and install the complete BMAD method suite
+3. Install `bootstrap-bmad-skills` and `enhance-bmad-skills` for future maintenance
+4. Enable the `BS` command as a manual backup workflow
 
 ## Documentation
 

package/bin/bmad-skills.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 
-import fs from 'fs-extra';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import readline from 'node:readline';
+import fs from 'fs-extra';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -17,7 +16,12 @@ async function run() {
     await init(args);
   } else if (command === 'install') {
     await install(args);
-  } else if (command === '--help' || command === '-h' || args.includes('--help') || args.includes('-h')) {
+  } else if (
+    command === '--help' ||
+    command === '-h' ||
+    args.includes('--help') ||
+    args.includes('-h')
+  ) {
     printHelp();
   } else {
     // Proxy to convert.js logic
@@ -25,13 +29,11 @@ async function run() {
   }
 }
 
-
-
 /**
  * Install specific skills from a source directory to the project's skill directory
  */
 async function install(args) {
-  const sourceArg = args.find(a => a.startsWith('--from='))?.split('=')[1];
+  const sourceArg = args.find((a) => a.startsWith('--from='))?.split('=')[1];
   const force = args.includes('--force');
 
   if (!sourceArg) {
@@ -55,7 +57,7 @@ async function install(args) {
   // Get skills from source
   const skills = await fs.readdir(sourcePath);
   const validSkills = [];
-  
+
   for (const skill of skills) {
     if ((await fs.stat(path.join(sourcePath, skill))).isDirectory()) {
       validSkills.push(skill);
@@ -68,18 +70,18 @@ async function install(args) {
   }
 
   console.log(`\nFound ${validSkills.length} skills to install.`);
-  
+
   // Install
   for (const skillName of validSkills) {
     await installSkill(
-      skillName, 
-      path.join(sourcePath, skillName), 
+      skillName,
+      path.join(sourcePath, skillName),
       path.join(process.cwd(), toolInfo.path, skillName),
       force
     );
   }
 
-  console.log(`\n✅ Installation complete.`);
+  console.log('\n✅ Installation complete.');
 }
 
 async function init(args) {
@@ -88,44 +90,140 @@ async function init(args) {
   const toolInfo = await detectTool(args);
   if (!toolInfo) return;
 
+  // Check for bootstrap flag
+  const isBootstrap = args.includes('--bootstrap');
+
+  if (isBootstrap) {
+    console.log('🔄 Bootstrapping full BMAD suite...');
+
+    // 1. Run conversion
+    const tempDir = '.temp/converted-skills-bootstrap';
+    console.log(`\n--- Step 1: Fetching & Converting (${tempDir}) ---`);
+    process.env.BMAD_OUTPUT_DIR = tempDir; // Pass specific output dir to convert.js
+
+    // Create synthetic args for convert.js
+    // We filter out init-specific args to avoid confusion, but keep repo/branch overrides
+    const convertArgs = args.filter(
+      (a) =>
+        !['init', '--bootstrap', '--force', '--tool'].some((x) => a.includes(x))
+    );
+
+    // Temporarily override argv for the imported module
+    const originalArgv = process.argv;
+    process.argv = [
+      process.argv[0],
+      process.argv[1],
+      ...convertArgs,
+      '--output-dir',
+      tempDir,
+    ];
+
+    try {
+      const { spawn } = await import('node:child_process');
+      const binPath = fileURLToPath(import.meta.url); // this file
+
+      await new Promise((resolve, reject) => {
+        // Run self without command -> trigger convert logic
+        const child = spawn(
+          process.execPath,
+          [binPath, ...convertArgs, '--output-dir', tempDir],
+          {
+            stdio: 'inherit',
+          }
+        );
+        child.on('close', (code) => {
+          if (code === 0) resolve();
+          else reject(new Error(`Conversion failed with code ${code}`));
+        });
+      });
+    } catch (error) {
+      console.error(`❌ Bootstrap conversion failed: ${error.message}`);
+      process.argv = originalArgv; // Restore
+      return;
+    }
+    process.argv = originalArgv; // Restore
+
+    // 2. Install
+    console.log(`\n--- Step 2: Installing to ${toolInfo.name} ---`);
+    await install([
+      'install',
+      `--from=${tempDir}`,
+      `--tool=${toolInfo.name.toLowerCase()}`, // Ensure generic name match
+      '--force', // Always force in bootstrap mode? Or respect args? Let's use force for bootstrap convenience
+    ]);
+
+    // 3. Install bundled skills (bootstrap-bmad-skills, enhance-bmad-skills)
+    // We reuse the logic from the standard init, but silence it slightly or just run it
+    const skillsDir = path.join(pkgRoot, 'skills');
+    if (await fs.pathExists(skillsDir)) {
+      const skills = await fs.readdir(skillsDir);
+      for (const skill of skills) {
+        if ((await fs.stat(path.join(skillsDir, skill))).isDirectory()) {
+          await installSkill(
+            skill,
+            path.join(skillsDir, skill),
+            path.join(process.cwd(), toolInfo.path, skill),
+            true
+          );
+        }
+      }
+    }
+
+    // Cleanup
+    try {
+      await fs.remove('.temp'); // Remove generic temp if used
+      // Note: we used specific temp dir, removing that
+      if (tempDir.startsWith('.temp')) await fs.remove('.temp');
+    } catch (_e) {
+      /* ignore */
+    }
+
+    console.log('\n✨ Bootstrap functionality complete!');
+    return;
+  }
+
+  // STANDARD INIT (Bootstrap skills only)
   console.log(`📦 Installing Bootstrap Skills for ${toolInfo.name}...`);
 
   // Dynamically find skills in package
   const skillsDir = path.join(pkgRoot, 'skills');
   if (!(await fs.pathExists(skillsDir))) {
-     console.error('❌ Critical Error: Package skills directory not found.');
-     return;
+    console.error('❌ Critical Error: Package skills directory not found.');
+    return;
   }
 
   const skills = await fs.readdir(skillsDir);
   const skillsToInstall = [];
-  
+
   for (const skill of skills) {
     // Only install directories as skills
     if ((await fs.stat(path.join(skillsDir, skill))).isDirectory()) {
-        skillsToInstall.push(skill);
+      skillsToInstall.push(skill);
     }
   }
 
   if (skillsToInstall.length === 0) {
-      console.warn('⚠️  No skills found in package to install.');
-      return;
+    console.warn('⚠️  No skills found in package to install.');
+    return;
   }
-  
+
   const force = args.includes('--force');
 
   try {
     for (const skillName of skillsToInstall) {
       const sourceDir = path.join(skillsDir, skillName);
       const targetDir = path.resolve(process.cwd(), toolInfo.path, skillName);
-      
+
       await installSkill(skillName, sourceDir, targetDir, force);
     }
-    
+
     console.log(`\n✅ Successfully initialized in: ${toolInfo.path}/`);
     console.log('\nNext steps:');
     console.log(`1. Open your AI chat (${toolInfo.name}).`);
-    console.log('2. Type "BS" or "bootstrap-skills" to fetch and install the full BMAD method suite.');
+    console.log(
+      '2. Run "npx @clfhhc/bmad-methods-skills init --bootstrap" to auto-install everything.'
+    );
+    console.log('   OR Type "BS" in chat for the guided workflow.');
   } catch (error) {
     console.error(`\n❌ Installation failed: ${error.message}`);
   }
@@ -138,14 +236,14 @@ async function installSkill(name, source, target, force) {
   if (await fs.pathExists(target)) {
     if (!force) {
       console.warn(`  ⚠ Skill '${name}' already exists. Skipping.`);
-    console.warn('    (Use --force to overwrite)');
+      console.warn('    (Use --force to overwrite)');
       return;
     }
     console.log(`  ↻ Updating ${name}...`);
   } else {
     console.log(`  + Installing ${name}...`);
   }
-  
+
   await fs.ensureDir(path.dirname(target));
   await fs.copy(source, target, { overwrite: true });
 }
@@ -154,29 +252,45 @@ async function installSkill(name, source, target, force) {
  * Helper to detect AI tool
  */
 async function detectTool(args) {
-  const toolArg = args.find(a => a.startsWith('--tool='))?.split('=')[1];
+  const toolArg = args.find((a) => a.startsWith('--tool='))?.split('=')[1];
   const force = args.includes('--force');
 
   const tools = [
-    { name: 'Antigravity', path: '.agent/skills', active: await fs.pathExists('.agent') },
-    { name: 'Cursor', path: '.cursor/skills', active: await fs.pathExists('.cursor') },
-    { name: 'Claude Code (Local)', path: '.claude/skills', active: await fs.pathExists('.claude') },
+    {
+      name: 'Antigravity',
+      path: '.agent/skills',
+      active: await fs.pathExists('.agent'),
+    },
+    {
+      name: 'Cursor',
+      path: '.cursor/skills',
+      active: await fs.pathExists('.cursor'),
+    },
+    {
+      name: 'Claude Code (Local)',
+      path: '.claude/skills',
+      active: await fs.pathExists('.claude'),
+    },
   ];
 
-  let selectedTool = tools.find(t => t.active);
-  
+  let selectedTool = tools.find((t) => t.active);
+
   if (toolArg) {
-    selectedTool = tools.find(t => t.name.toLowerCase().includes(toolArg.toLowerCase()));
+    selectedTool = tools.find((t) =>
+      t.name.toLowerCase().includes(toolArg.toLowerCase())
+    );
   }
 
   if (!selectedTool) {
     if (force) {
-       // Default to antigravity if forced and not found
-       return tools[0];
+      // Default to antigravity if forced and not found
+      return tools[0];
     }
-    
+
     console.log('❌ No AI tool directory detected (.agent, .cursor, .claude).');
-    console.log('   Use --tool=<name> to force installation or ensure you are in the project root.');
+    console.log(
+      '   Use --tool=<name> to force installation or ensure you are in the project root.'
+    );
     console.log('   Available tools: antigravity, cursor, claude');
     return null;
   }
@@ -196,6 +310,7 @@ Commands:
 Options (for init/install):
   --tool=<name>    Specify tool (antigravity, cursor, claude)
   --force          Overwrite existing skills / Force installation
+  --bootstrap      Automatically fetch, convert, and install full suite
   --from=<path>    (install only) Source directory containing skills
 
 Options (for conversion):
@@ -211,7 +326,7 @@ Options (for conversion):
   `);
 }
 
-run().catch(err => {
+run().catch((err) => {
   console.error(err);
   process.exit(1);
 });

package/config.json

@@ -4,14 +4,8 @@
   "outputDir": "./skills",
   "tempDir": "./.temp/bmad-method",
   "modules": ["bmm", "bmb", "cis", "core"],
-  "agentPaths": [
-    "src/core/agents",
-    "src/modules/*/agents"
-  ],
-  "workflowPaths": [
-    "src/core/workflows",
-    "src/modules/*/workflows"
-  ],
+  "agentPaths": ["src/core/agents", "src/modules/*/agents"],
+  "workflowPaths": ["src/core/workflows", "src/modules/*/workflows"],
   "enhancements": {
     "optional": {
       "addExamples": true,

package/convert.js

@@ -1,10 +1,11 @@
-import fs from 'fs-extra';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { fetchBmadRepo } from './src/utils/bmad-fetcher.js';
-import { findAgentsAndWorkflows } from './src/utils/file-finder.js';
+import fs from 'fs-extra';
 import { convertAgentToSkill } from './src/converters/agent-converter.js';
 import { convertWorkflowToSkill } from './src/converters/workflow-converter.js';
+import { fetchBmadRepo } from './src/utils/bmad-fetcher.js';
+import { findAgentsAndWorkflows } from './src/utils/file-finder.js';
+import { migrateResources } from './src/utils/resource-migrator.js';
 import { writeSkill } from './src/utils/skill-writer.js';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -29,7 +30,7 @@ function parseArgs() {
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
-    
+
     if (arg === '--output-dir' && i + 1 < args.length) {
       options.outputDir = args[++i];
     } else if (arg === '--repo' && i + 1 < args.length) {
@@ -167,7 +168,8 @@ try {
     config.enhancements.optional.addBestPractices = cliOptions.addBestPractices;
   }
   if (cliOptions.addTroubleshooting !== null) {
-    config.enhancements.optional.addTroubleshooting = cliOptions.addTroubleshooting;
+    config.enhancements.optional.addTroubleshooting =
+      cliOptions.addTroubleshooting;
   }
   if (cliOptions.addRelatedSkills !== null) {
     config.enhancements.optional.addRelatedSkills = cliOptions.addRelatedSkills;
@@ -199,7 +201,7 @@ async function main() {
     const bmadRoot = await fetchBmadRepo(
       config.bmadRepo,
       config.bmadBranch,
-      path.resolve(process.cwd(), config.tempDir),
+      path.resolve(process.cwd(), config.tempDir)
     );
     console.log(`✓ Repository ready at: ${bmadRoot}\n`);
 
@@ -208,14 +210,14 @@ async function main() {
     const { agents, workflows } = await findAgentsAndWorkflows(
       bmadRoot,
       config.agentPaths,
-      config.workflowPaths,
+      config.workflowPaths
     );
 
     stats.agents.total = agents.length;
     stats.workflows.total = workflows.length;
 
     console.log(
-      `✓ Found ${agents.length} agents and ${workflows.length} workflows\n`,
+      `✓ Found ${agents.length} agents and ${workflows.length} workflows\n`
     );
 
     // Step 3: Prepare output directory
@@ -237,12 +239,7 @@ async function main() {
             ...agentOptions,
             currentModule: agent.module,
           });
-          await writeSkill(
-            outputDir,
-            agent.module,
-            agent.name,
-            skillContent,
-          );
+          await writeSkill(outputDir, agent.module, agent.name, skillContent);
           stats.agents.converted++;
           console.log(`  ✓ ${agent.module}/${agent.name}`);
         } catch (error) {
@@ -252,9 +249,7 @@ async function main() {
             path: agent.path,
             error: error.message,
           });
-          console.error(
-            `  ✗ ${agent.module}/${agent.name}: ${error.message}`,
-          );
+          console.error(`  ✗ ${agent.module}/${agent.name}: ${error.message}`);
         }
       }
       console.log();
@@ -274,14 +269,14 @@ async function main() {
             {
               ...workflowOptions,
               isMarkdown: workflow.isMarkdown || false,
-            },
+            }
           );
           await writeSkill(
             outputDir,
             workflow.module,
             workflow.name,
             skillContent,
-            { workflowDir: workflow.workflowDir },
+            { workflowDir: workflow.workflowDir }
           );
           stats.workflows.converted++;
           console.log(`  ✓ ${workflow.module}/${workflow.name}`);
@@ -293,14 +288,17 @@ async function main() {
             error: error.message,
           });
           console.error(
-            `  ✗ ${workflow.module}/${workflow.name}: ${error.message}`,
+            `  ✗ ${workflow.module}/${workflow.name}: ${error.message}`
           );
         }
       }
       console.log();
     }
 
-    // Step 6: Generate summary
+    // Step 6: Migrate auxiliary resources
+    await migrateResources(bmadRoot, outputDir);
+
+    // Step 7: Generate summary
     await printSummary();
   } catch (error) {
     console.error(`\n❌ Fatal error: ${error.message}`);
@@ -325,8 +323,7 @@ async function printSummary() {
   console.log(`  Errors: ${stats.workflows.errors}`);
   console.log();
 
-  const totalConverted =
-    stats.agents.converted + stats.workflows.converted;
+  const totalConverted = stats.agents.converted + stats.workflows.converted;
   const totalErrors = stats.agents.errors + stats.workflows.errors;
 
   if (totalErrors > 0) {
@@ -340,19 +337,23 @@ async function printSummary() {
 
   console.log(`✅ Successfully converted ${totalConverted} skills`);
   console.log(
-    `📁 Output directory: ${path.resolve(process.cwd(), config.outputDir)}`,
+    `📁 Output directory: ${path.resolve(process.cwd(), config.outputDir)}`
   );
-  
+
   // Show configuration info
   if (config.outputDir !== './skills') {
     console.log('\n💡 Note: Output directory is not the default (./skills)');
     console.log('   This directory is not version controlled.');
     console.log('   To use default settings, run without --output-dir flag.');
   }
-  
+
   if (config.enhancements.identityCharLimit !== null) {
-    console.log(`\n💡 Note: Identity character limit is set to ${config.enhancements.identityCharLimit}`);
-    console.log('   Default behavior (no limit) is recommended for better content.');
+    console.log(
+      `\n💡 Note: Identity character limit is set to ${config.enhancements.identityCharLimit}`
+    );
+    console.log(
+      '   Default behavior (no limit) is recommended for better content.'
+    );
   }
 
   // Print per-module breakdown