bmad-stella 1.0.0

package/tools/lib/dependency-resolver.js

@@ -0,0 +1,175 @@
+const fs = require('node:fs').promises;
+const path = require('node:path');
+const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('./yaml-utils');
+
+class DependencyResolver {
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+    this.bmadCore = path.join(rootDir, 'bmad-core');
+    this.common = path.join(rootDir, 'common');
+    this.cache = new Map();
+  }
+
+  async resolveAgentDependencies(agentId) {
+    const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
+    const agentContent = await fs.readFile(agentPath, 'utf8');
+
+    // Extract YAML from markdown content with command cleaning
+    const yamlContent = extractYamlFromAgent(agentContent, true);
+    if (!yamlContent) {
+      throw new Error(`No YAML configuration found in agent ${agentId}`);
+    }
+
+    const agentConfig = yaml.load(yamlContent);
+
+    const dependencies = {
+      agent: {
+        id: agentId,
+        path: agentPath,
+        content: agentContent,
+        config: agentConfig,
+      },
+      resources: [],
+    };
+
+    // Personas are now embedded in agent configs, no need to resolve separately
+
+    // Resolve other dependencies
+    const depTypes = ['tasks', 'templates', 'checklists', 'data', 'utils'];
+    for (const depType of depTypes) {
+      const deps = agentConfig.dependencies?.[depType] || [];
+      for (const depId of deps) {
+        const resource = await this.loadResource(depType, depId);
+        if (resource) dependencies.resources.push(resource);
+      }
+    }
+
+    return dependencies;
+  }
+
+  async resolveTeamDependencies(teamId) {
+    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yaml`);
+    const teamContent = await fs.readFile(teamPath, 'utf8');
+    const teamConfig = yaml.load(teamContent);
+
+    const dependencies = {
+      team: {
+        id: teamId,
+        path: teamPath,
+        content: teamContent,
+        config: teamConfig,
+      },
+      agents: [],
+      resources: new Map(), // Use Map to deduplicate resources
+    };
+
+    // Always add bmad-orchestrator agent first if it's a team
+    const bmadAgent = await this.resolveAgentDependencies('bmad-orchestrator');
+    dependencies.agents.push(bmadAgent.agent);
+    for (const res of bmadAgent.resources) {
+      dependencies.resources.set(res.path, res);
+    }
+
+    // Resolve all agents in the team
+    let agentsToResolve = teamConfig.agents || [];
+
+    // Handle wildcard "*" - include all agents except bmad-master
+    if (agentsToResolve.includes('*')) {
+      const allAgents = await this.listAgents();
+      // Remove wildcard and add all agents except those already in the list and bmad-master
+      agentsToResolve = agentsToResolve.filter((a) => a !== '*');
+      for (const agent of allAgents) {
+        if (!agentsToResolve.includes(agent) && agent !== 'bmad-master') {
+          agentsToResolve.push(agent);
+        }
+      }
+    }
+
+    for (const agentId of agentsToResolve) {
+      if (agentId === 'bmad-orchestrator' || agentId === 'bmad-master') continue; // Already added or excluded
+      const agentDeps = await this.resolveAgentDependencies(agentId);
+      dependencies.agents.push(agentDeps.agent);
+
+      // Add resources with deduplication
+      for (const res of agentDeps.resources) {
+        dependencies.resources.set(res.path, res);
+      }
+    }
+
+    // Resolve workflows
+    for (const workflowId of teamConfig.workflows || []) {
+      const resource = await this.loadResource('workflows', workflowId);
+      if (resource) dependencies.resources.set(resource.path, resource);
+    }
+
+    // Convert Map back to array
+    dependencies.resources = [...dependencies.resources.values()];
+
+    return dependencies;
+  }
+
+  async loadResource(type, id) {
+    const cacheKey = `${type}#${id}`;
+    if (this.cache.has(cacheKey)) {
+      return this.cache.get(cacheKey);
+    }
+
+    try {
+      let content = null;
+      let filePath = null;
+
+      // First try bmad-core
+      try {
+        filePath = path.join(this.bmadCore, type, id);
+        content = await fs.readFile(filePath, 'utf8');
+      } catch {
+        // If not found in bmad-core, try common folder
+        try {
+          filePath = path.join(this.common, type, id);
+          content = await fs.readFile(filePath, 'utf8');
+        } catch {
+          // File not found in either location
+        }
+      }
+
+      if (!content) {
+        console.warn(`Resource not found: ${type}/${id}`);
+        return null;
+      }
+
+      const resource = {
+        type,
+        id,
+        path: filePath,
+        content,
+      };
+
+      this.cache.set(cacheKey, resource);
+      return resource;
+    } catch (error) {
+      console.error(`Error loading resource ${type}/${id}:`, error.message);
+      return null;
+    }
+  }
+
+  async listAgents() {
+    try {
+      const files = await fs.readdir(path.join(this.bmadCore, 'agents'));
+      return files.filter((f) => f.endsWith('.md')).map((f) => f.replace('.md', ''));
+    } catch {
+      return [];
+    }
+  }
+
+  async listTeams() {
+    try {
+      const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
+      return files.filter((f) => f.endsWith('.yaml')).map((f) => f.replace('.yaml', ''));
+    } catch {
+      return [];
+    }
+  }
+}
+
+module.exports = DependencyResolver;

package/tools/lib/yaml-utils.js

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for YAML extraction from agent files
+ */
+
+/**
+ * Extract YAML content from agent markdown files
+ * @param {string} agentContent - The full content of the agent file
+ * @param {boolean} cleanCommands - Whether to clean command descriptions (default: false)
+ * @returns {string|null} - The extracted YAML content or null if not found
+ */
+function extractYamlFromAgent(agentContent, cleanCommands = false) {
+  // Remove carriage returns and match YAML block
+  const yamlMatch = agentContent.replaceAll('\r', '').match(/```ya?ml\n([\s\S]*?)\n```/);
+  if (!yamlMatch) return null;
+
+  let yamlContent = yamlMatch[1].trim();
+
+  // Clean up command descriptions if requested
+  // Converts "- command - description" to just "- command"
+  if (cleanCommands) {
+    yamlContent = yamlContent.replaceAll(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+  }
+
+  return yamlContent;
+}
+
+module.exports = {
+  extractYamlFromAgent,
+};

package/tools/md-assets/web-agent-startup-instructions.md

@@ -0,0 +1,39 @@
+# Web Agent Bundle Instructions
+
+You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
+
+## Important Instructions
+
+### **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
+
+### **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
+
+- `==================== START: .bmad-core/folder/filename.md ====================`
+- `==================== END: .bmad-core/folder/filename.md ====================`
+
+When you need to reference a resource mentioned in your instructions:
+
+- Look for the corresponding START/END tags
+- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
+- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
+
+**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
+
+```yaml
+dependencies:
+  utils:
+    - template-format
+  tasks:
+    - create-story
+```
+
+These references map directly to bundle sections:
+
+- `dependencies.utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
+- `dependencies.utils: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
+
+### **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance. You have no file system to write to, so you will maintain document history being drafted in your memory unless a canvas feature is available and the user confirms its usage.
+
+## **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role explicitly as defined.
+
+---

package/tools/preview-release-notes.js

@@ -0,0 +1,66 @@
+const { execSync } = require('node:child_process');
+const fs = require('node:fs');
+
+// Get the latest stable tag (exclude beta tags)
+const allTags = execSync('git tag -l | sort -V', { encoding: 'utf8' }).split('\n').filter(Boolean);
+const stableTags = allTags.filter((tag) => !tag.includes('beta'));
+const latestTag = stableTags.at(-1) || 'v5.0.0';
+
+// Get commits since last tag
+const commits = execSync(`git log ${latestTag}..HEAD --pretty=format:"- %s" --reverse`, {
+  encoding: 'utf8',
+})
+  .split('\n')
+  .filter(Boolean);
+
+// Categorize commits
+const features = commits.filter((commit) => /^- (feat|Feature)/.test(commit));
+const fixes = commits.filter((commit) => /^- (fix|Fix)/.test(commit));
+const chores = commits.filter((commit) => /^- (chore|Chore)/.test(commit));
+const others = commits.filter(
+  (commit) => !/^- (feat|Feature|fix|Fix|chore|Chore|release:|Release:)/.test(commit),
+);
+
+// Get next version (you can modify this logic)
+const currentVersion = require('../package.json').version;
+const versionParts = currentVersion.split('.').map(Number);
+const nextVersion = `${versionParts[0]}.${versionParts[1] + 1}.0`; // Default to minor bump
+
+console.log(`## 🚀 What's New in v${nextVersion}\n`);
+
+if (features.length > 0) {
+  console.log('### ✨ New Features');
+  for (const feature of features) console.log(feature);
+  console.log('');
+}
+
+if (fixes.length > 0) {
+  console.log('### 🐛 Bug Fixes');
+  for (const fix of fixes) console.log(fix);
+  console.log('');
+}
+
+if (others.length > 0) {
+  console.log('### 📦 Other Changes');
+  for (const other of others) console.log(other);
+  console.log('');
+}
+
+if (chores.length > 0) {
+  console.log('### 🔧 Maintenance');
+  for (const chore of chores) console.log(chore);
+  console.log('');
+}
+
+console.log('\n## 📦 Installation\n');
+console.log('```bash');
+console.log('npx bmad-method install');
+console.log('```');
+
+console.log(
+  `\n**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/${latestTag}...v${nextVersion}`,
+);
+
+console.log(`\n---\n📊 **Summary**: ${commits.length} commits since ${latestTag}`);
+console.log(`🏷️ **Previous tag**: ${latestTag}`);
+console.log(`🚀 **Next version**: v${nextVersion} (estimated)`);

package/tools/setup-hooks.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+# Setup script for git hooks
+echo "Setting up git hooks..."
+
+# Install husky
+npm install --save-dev husky
+
+# Initialize husky
+npx husky init
+
+# Create pre-commit hook
+cat > .husky/pre-commit << 'EOF'
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# Run validation checks before commit
+echo "Running pre-commit checks..."
+
+npm run validate
+npm run format:check
+npm run lint
+
+if [ $? -ne 0 ]; then
+  echo "❌ Pre-commit checks failed. Please fix the issues before committing."
+  echo "   Run 'npm run format' to fix formatting issues"
+  echo "   Run 'npm run lint:fix' to fix some lint issues"
+  exit 1
+fi
+
+echo "✅ Pre-commit checks passed!"
+EOF
+
+chmod +x .husky/pre-commit
+
+echo "✅ Git hooks setup complete!"
+echo "Now commits will be validated before they're created."

package/tools/shared/bannerArt.js

@@ -0,0 +1,105 @@
+// ASCII banner art definitions extracted from banners.js to separate art from logic
+
+const BMAD_TITLE = 'BMAD-METHOD™';
+const FLATTENER_TITLE = 'FLATTENER';
+const INSTALLER_TITLE = 'INSTALLER';
+
+// Large ASCII blocks (block-style fonts)
+const BMAD_LARGE = `
+██████╗ ███╗   ███╗ █████╗ ██████╗       ███╗   ███╗███████╗████████╗██╗  ██╗ ██████╗ ██████╗ 
+██╔══██╗████╗ ████║██╔══██╗██╔══██╗      ████╗ ████║██╔════╝╚══██╔══╝██║  ██║██╔═══██╗██╔══██╗
+██████╔╝██╔████╔██║███████║██║  ██║█████╗██╔████╔██║█████╗     ██║   ███████║██║   ██║██║  ██║
+██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║╚════╝██║╚██╔╝██║██╔══╝     ██║   ██╔══██║██║   ██║██║  ██║
+██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝      ██║ ╚═╝ ██║███████╗   ██║   ██║  ██║╚██████╔╝██████╔╝
+╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝       ╚═╝     ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+`;
+
+const FLATTENER_LARGE = `
+███████╗██╗      █████╗ ████████╗████████╗███████╗███╗   ██╗███████╗██████╗ 
+██╔════╝██║     ██╔══██╗╚══██╔══╝╚══██╔══╝██╔════╝████╗  ██║██╔════╝██╔══██╗
+█████╗  ██║     ███████║   ██║      ██║   █████╗  ██╔██╗ ██║█████╗  ██████╔╝
+██╔══╝  ██║     ██╔══██║   ██║      ██║   ██╔══╝  ██║╚██╗██║██╔══╝  ██╔══██╗
+██║     ███████║██║  ██║   ██║      ██║   ███████╗██║ ╚████║███████╗██║  ██║
+╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝
+ `;
+
+const INSTALLER_LARGE = `
+██╗███╗   ██╗███████╗████████╗ █████╗ ██╗     ██╗     ███████╗██████╗ 
+██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗██║     ██║     ██╔════╝██╔══██╗
+██║██╔██╗ ██║███████╗   ██║   ███████║██║     ██║     █████╗  ██████╔╝
+██║██║╚██╗██║╚════██║   ██║   ██╔══██║██║     ██║     ██╔══╝  ██╔══██╗
+██║██║ ╚████║███████║   ██║   ██║  ██║███████╗███████╗███████╗██║  ██║
+╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝
+`;
+
+// Curated medium/small/tiny variants (fixed art, no runtime scaling)
+// Medium: bold framed title with heavy fill (high contrast, compact)
+const BMAD_MEDIUM = `
+███╗ █╗    █╗ ██╗ ███╗    █╗    █╗███╗█████╗█╗ █╗ ██╗ ███╗ 
+█╔═█╗██╗  ██║█╔═█╗█╔═█╗   ██╗  ██║█╔═╝╚═█╔═╝█║ █║█╔═█╗█╔═█╗
+███╔╝█╔███╔█║████║█║ █║██╗█╔███╔█║██╗   █║  ████║█║ █║█║ █║
+█╔═█╗█║ █╔╝█║█╔═█║█║ █║╚═╝█║ █╔╝█║█╔╝   █║  █╔═█║█║ █║█║ █║
+███╔╝█║ ╚╝ █║█║ █║███╔╝   █║ ╚╝ █║███╗  █║  █║ █║╚██╔╝███╔╝
+╚══╝ ╚╝    ╚╝╚╝ ╚╝╚══╝    ╚╝    ╚╝╚══╝  ╚╝  ╚╝ ╚╝ ╚═╝ ╚══╝ 
+`;
+
+const FLATTENER_MEDIUM = `
+███╗█╗   ██╗ █████╗█████╗███╗█╗  █╗███╗███╗ 
+█╔═╝█║  █╔═█╗╚═█╔═╝╚═█╔═╝█╔═╝██╗ █║█╔═╝█╔═█╗
+██╗ █║  ████║  █║    █║  ██╗ █╔█╗█║██╗ ███╔╝
+█╔╝ █║  █╔═█║  █║    █║  █╔╝ █║ ██║█╔╝ █╔═█╗
+█║  ███║█║ █║  █║    █║  ███╗█║  █║███╗█║ █║
+╚╝  ╚══╝╚╝ ╚╝  ╚╝    ╚╝  ╚══╝╚╝  ╚╝╚══╝╚╝ ╚╝
+ `;
+
+const INSTALLER_MEDIUM = `
+█╗█╗  █╗████╗█████╗ ██╗ █╗  █╗  ███╗███╗ 
+█║██╗ █║█╔══╝╚═█╔═╝█╔═█╗█║  █║  █╔═╝█╔═█╗
+█║█╔█╗█║████╗  █║  ████║█║  █║  ██╗ ███╔╝
+█║█║ ██║╚══█║  █║  █╔═█║█║  █║  █╔╝ █╔═█╗
+█║█║  █║████║  █║  █║ █║███╗███╗███╗█║ █║
+╚╝╚╝  ╚╝╚═══╝  ╚╝  ╚╝ ╚╝╚══╝╚══╝╚══╝╚╝ ╚╝
+`;
+
+// Small: rounded box with bold rule
+// Width: 30 columns total (28 inner)
+const BMAD_SMALL = `
+╭──────────────────────────╮
+│       BMAD-METHOD™       │
+╰──────────────────────────╯
+`;
+
+const FLATTENER_SMALL = `
+╭──────────────────────────╮
+│         FLATTENER        │
+╰──────────────────────────╯
+`;
+
+const INSTALLER_SMALL = `
+ ╭──────────────────────────╮
+ │         INSTALLER        │
+ ╰──────────────────────────╯
+ `;
+
+// Tiny (compact brackets)
+const BMAD_TINY = `[ BMAD-METHOD™ ]`;
+const FLATTENER_TINY = `[ FLATTENER ]`;
+const INSTALLER_TINY = `[ INSTALLER ]`;
+
+module.exports = {
+  BMAD_TITLE,
+  FLATTENER_TITLE,
+  INSTALLER_TITLE,
+  BMAD_LARGE,
+  FLATTENER_LARGE,
+  INSTALLER_LARGE,
+  BMAD_MEDIUM,
+  FLATTENER_MEDIUM,
+  INSTALLER_MEDIUM,
+  BMAD_SMALL,
+  FLATTENER_SMALL,
+  INSTALLER_SMALL,
+  BMAD_TINY,
+  FLATTENER_TINY,
+  INSTALLER_TINY,
+};

package/tools/sync-installer-version.js

@@ -0,0 +1,32 @@
+/**
+ * Sync installer package.json version with main package.json
+ * Used by semantic-release to keep versions in sync
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function syncInstallerVersion() {
+  // Read main package.json
+  const mainPackagePath = path.join(__dirname, '..', 'package.json');
+  const mainPackage = JSON.parse(fs.readFileSync(mainPackagePath, 'utf8'));
+
+  // Read installer package.json
+  const installerPackagePath = path.join(__dirname, 'installer', 'package.json');
+  const installerPackage = JSON.parse(fs.readFileSync(installerPackagePath, 'utf8'));
+
+  // Update installer version to match main version
+  installerPackage.version = mainPackage.version;
+
+  // Write back installer package.json
+  fs.writeFileSync(installerPackagePath, JSON.stringify(installerPackage, null, 2) + '\n');
+
+  console.log(`Synced installer version to ${mainPackage.version}`);
+}
+
+// Run if called directly
+if (require.main === module) {
+  syncInstallerVersion();
+}
+
+module.exports = { syncInstallerVersion };

package/tools/sync-version.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+# Sync local version with published npm version
+# Run this after a release if the version bump commit didn't sync automatically
+
+echo "🔄 Syncing local version with npm..."
+
+# Get the latest published version
+VERSION=$(npm view bmad-method@latest version)
+echo "📦 Latest published version: $VERSION"
+
+# Update package.json
+npm version $VERSION --no-git-tag-version
+
+# Update installer package.json
+sed -i '' 's/"version": ".*"/"version": "'$VERSION'"/' tools/installer/package.json
+
+# Commit and push
+git add package.json tools/installer/package.json
+git commit -m "sync: update to published version $VERSION"
+git push
+
+echo "✅ Synced to version $VERSION"

package/tools/update-expansion-version.js

@@ -0,0 +1,53 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const yaml = require('js-yaml');
+
+const arguments_ = process.argv.slice(2);
+
+if (arguments_.length < 2) {
+  console.log('Usage: node update-expansion-version.js <expansion-pack-id> <new-version>');
+  console.log('Example: node update-expansion-version.js bmad-creator-tools 1.1.0');
+  process.exit(1);
+}
+
+const [packId, newVersion] = arguments_;
+
+// Validate version format
+if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
+  console.error('Error: Version must be in format X.Y.Z (e.g., 1.2.3)');
+  process.exit(1);
+}
+
+async function updateVersion() {
+  try {
+    // Update in config.yaml
+    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
+
+    if (!fs.existsSync(configPath)) {
+      console.error(`Error: Expansion pack '${packId}' not found`);
+      process.exit(1);
+    }
+
+    const configContent = fs.readFileSync(configPath, 'utf8');
+    const config = yaml.load(configContent);
+    const oldVersion = config.version || 'unknown';
+
+    config.version = newVersion;
+
+    const updatedYaml = yaml.dump(config, { indent: 2 });
+    fs.writeFileSync(configPath, updatedYaml);
+
+    console.log(`✓ Updated ${packId}/config.yaml: ${oldVersion} → ${newVersion}`);
+    console.log(`\n✓ Successfully updated ${packId} to version ${newVersion}`);
+    console.log('\nNext steps:');
+    console.log('1. Test the changes');
+    console.log(
+      '2. Commit: git add -A && git commit -m "chore: bump ' + packId + ' to v' + newVersion + '"',
+    );
+  } catch (error) {
+    console.error('Error updating version:', error.message);
+    process.exit(1);
+  }
+}
+
+updateVersion();