bmad-enhanced 1.3.5 → 1.3.7

package/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.3.6] - 2026-02-18
+
+### Fixed
+
+**🔍 Improved Installation Diagnostics:**
+- Added detailed debugging output to config.yaml creation in install script
+- Shows exact file path where config.yaml will be created
+- Verifies file existence immediately after write
+- Catches and displays any errors during config creation
+- Better error handling with try-catch blocks
+
+**📊 Improved Version Check Messaging:**
+- `bmad-version` now distinguishes between "fresh", "partial", and "corrupted" installations
+- "Partial installation" message when config.yaml is missing but other files exist
+- "Corrupted installation" message when required agent files are missing
+- Each scenario now provides specific next steps for resolution
+- No longer shows generic "Not installed" for all cases
+
+**What this helps with:**
+- Easier troubleshooting when installations fail
+- Clear indication of what's wrong with partial installations
+- Better guidance on how to fix installation issues
+- More detailed logs for support/debugging
+
+---
+
 ## [1.3.5] - 2026-02-18
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-enhanced",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Vortex Framework - Contextualize and Externalize streams for Lean Startup validation",
   "main": "index.js",
   "bin": {

package/scripts/install-all-agents.js

@@ -157,12 +157,14 @@ function updateConfig() {
   const configPath = path.join(process.cwd(), '_bmad', 'bme', '_vortex', 'config.yaml');
   const manifestPath = path.join(process.cwd(), '_bmad', '_config', 'agent-manifest.csv');
 
+  console.log(`${CYAN}  →${RESET} Config path: ${configPath}`);
+
   // Create config
   const configContent = `---
 submodule_name: _vortex
 description: Contextualize and Externalize streams - Strategic framing and validated learning
 module: bme
-version: 1.3.4
+version: 1.3.7
 
 # Output Configuration
 output_folder: "{project-root}/_bmad-output/vortex-artifacts"
@@ -191,9 +193,21 @@ workflows:
 party_mode_enabled: true
 core_module: bme
 `;
-  fs.mkdirSync(path.dirname(configPath), { recursive: true });
-  fs.writeFileSync(configPath, configContent);
-  console.log(`${GREEN}  ✓${RESET} Created config.yaml`);
+
+  try {
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, configContent);
+
+    // Verify file was created
+    if (fs.existsSync(configPath)) {
+      console.log(`${GREEN}  ✓${RESET} Created config.yaml`);
+    } else {
+      console.error(`${RED}  ✗${RESET} Config file not found after write!`);
+    }
+  } catch (error) {
+    console.error(`${RED}  ✗${RESET} Error creating config.yaml:`, error.message);
+    throw error;
+  }
 
   // Create manifest
   fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
@@ -288,11 +302,43 @@ function printSuccess() {
   console.log('');
 }
 
+function cleanupLegacyFiles() {
+  console.log(`${CYAN}  →${RESET} Cleaning up legacy files...`);
+
+  // Remove _designos directory (pre-Vortex structure) from all possible locations
+  const legacyPaths = [
+    path.join(process.cwd(), '_bmad', 'bme', '_designos'),
+    path.join(process.cwd(), '_bmad', '_designos'),
+  ];
+
+  for (const legacyPath of legacyPaths) {
+    if (fs.existsSync(legacyPath)) {
+      fs.removeSync(legacyPath);
+      console.log(`${GREEN}    ✓${RESET} Removed legacy directory: ${path.relative(process.cwd(), legacyPath)}`);
+    }
+  }
+
+  // Remove deprecated agent files from _vortex/agents
+  const agentsDir = path.join(process.cwd(), '_bmad', 'bme', '_vortex', 'agents');
+  const deprecatedAgents = ['empathy-mapper.md', 'wireframe-designer.md'];
+
+  for (const agent of deprecatedAgents) {
+    const agentPath = path.join(agentsDir, agent);
+    if (fs.existsSync(agentPath)) {
+      fs.removeSync(agentPath);
+      console.log(`${GREEN}    ✓${RESET} Removed deprecated agent: ${agent}`);
+    }
+  }
+
+  console.log(`${GREEN}  ✓${RESET} Legacy cleanup complete`);
+}
+
 async function main() {
   try {
     printBanner();
     checkPrerequisites();
     copyAllAgentFiles();
+    cleanupLegacyFiles();
     updateConfig();
     createOutputDirectory();
     verifyInstallation();

package/scripts/update/bmad-version.js

@@ -21,7 +21,7 @@ async function main() {
   console.log('');
 
   // Fresh install - not installed yet
-  if (scenario === 'fresh' || !currentVersion) {
+  if (scenario === 'fresh') {
     console.log(chalk.yellow('Status:           Not installed'));
     console.log(`Package version:  ${chalk.cyan(targetVersion)}`);
     console.log('');
@@ -30,6 +30,32 @@ async function main() {
     return;
   }
 
+  // Partial installation - config.yaml missing but some files exist
+  if (scenario === 'partial' || !currentVersion) {
+    console.log(chalk.red('Status:           Partial installation (config.yaml missing)'));
+    console.log(`Package version:  ${chalk.cyan(targetVersion)}`);
+    console.log('');
+    console.log(chalk.yellow('This indicates an installation error.'));
+    console.log('');
+    console.log('Try running: ' + chalk.cyan('npx bmad-install-agents'));
+    console.log('');
+    console.log('If the problem persists, check the installation logs.');
+    console.log('');
+    return;
+  }
+
+  // Corrupted installation
+  if (scenario === 'corrupted') {
+    console.log(chalk.red('Status:           Corrupted installation (missing required files)'));
+    console.log(`Package version:  ${chalk.cyan(targetVersion)}`);
+    console.log('');
+    console.log(chalk.yellow('Some required files are missing.'));
+    console.log('');
+    console.log('Run: ' + chalk.cyan('npx bmad-install-agents') + ' to reinstall');
+    console.log('');
+    return;
+  }
+
   // Installed
   console.log(`Installed version: ${chalk.cyan(currentVersion)}`);
   console.log(`Package version:   ${chalk.cyan(targetVersion)}`);

package/scripts/update/migrations/1.0.x-to-1.3.0.js

@@ -16,7 +16,7 @@ const configMerger = require('../lib/config-merger');
 module.exports = {
   name: '1.0.x-to-1.3.0',
   fromVersion: '1.0.x',
-  toVersion: '1.3.5',
+  toVersion: '1.3.7',
   breaking: true,
 
   /**
@@ -65,7 +65,7 @@ module.exports = {
     changes.push('Installed 7 new Vortex Framework workflows');
 
     // 5. Update config.yaml with new structure
-    await updateConfig(targetDir, '1.3.5');
+    await updateConfig(targetDir, '1.3.7');
     changes.push('Updated config.yaml');
 
     // 6. Update agent files
@@ -289,12 +289,21 @@ async function copyUserGuides() {
  * Remove old _designos directory (pre-Vortex structure)
  */
 async function removeOldDesignosDirectory() {
-  const designosPath = path.join(process.cwd(), '_bmad/bme/_designos');
+  const legacyPaths = [
+    path.join(process.cwd(), '_bmad/bme/_designos'),
+    path.join(process.cwd(), '_bmad/_designos'),
+  ];
 
-  if (fs.existsSync(designosPath)) {
-    await fs.remove(designosPath);
-    console.log('    Removed legacy _designos directory');
-  } else {
+  let removed = false;
+  for (const designosPath of legacyPaths) {
+    if (fs.existsSync(designosPath)) {
+      await fs.remove(designosPath);
+      console.log(`    Removed legacy directory: ${path.relative(process.cwd(), designosPath)}`);
+      removed = true;
+    }
+  }
+
+  if (!removed) {
     console.log('    No legacy _designos directory found (OK)');
   }
 }

package/scripts/update/migrations/1.1.x-to-1.3.0.js

@@ -17,7 +17,7 @@ const configMerger = require('../lib/config-merger');
 module.exports = {
   name: '1.1.x-to-1.3.0',
   fromVersion: '1.1.x',
-  toVersion: '1.3.5',
+  toVersion: '1.3.7',
   breaking: false,
 
   /**
@@ -27,7 +27,7 @@ module.exports = {
   async preview() {
     return {
       actions: [
-        'Update version: 1.1.x → 1.3.5',
+        'Update version: 1.1.x → 1.3.7',
         'Verify deprecated workflows archived',
         'Remove legacy _designos directory (pre-Vortex structure)',
         'Remove deprecated agent files (empathy-mapper.md, wireframe-designer.md)',
@@ -47,8 +47,8 @@ module.exports = {
     const targetDir = path.join(process.cwd(), '_bmad/bme/_vortex');
 
     // 1. Update version in config.yaml
-    await updateConfigVersion('1.3.5');
-    changes.push('Updated version to 1.3.5');
+    await updateConfigVersion('1.3.7');
+    changes.push('Updated version to 1.3.7');
 
     // 2. Verify deprecated structure exists
     await ensureDeprecatedStructure(targetDir);
@@ -190,12 +190,21 @@ async function copyUserGuides() {
  * Remove old _designos directory (pre-Vortex structure)
  */
 async function removeOldDesignosDirectory() {
-  const designosPath = path.join(process.cwd(), '_bmad/bme/_designos');
+  const legacyPaths = [
+    path.join(process.cwd(), '_bmad/bme/_designos'),
+    path.join(process.cwd(), '_bmad/_designos'),
+  ];
 
-  if (fs.existsSync(designosPath)) {
-    await fs.remove(designosPath);
-    console.log('    Removed legacy _designos directory');
-  } else {
+  let removed = false;
+  for (const designosPath of legacyPaths) {
+    if (fs.existsSync(designosPath)) {
+      await fs.remove(designosPath);
+      console.log(`    Removed legacy directory: ${path.relative(process.cwd(), designosPath)}`);
+      removed = true;
+    }
+  }
+
+  if (!removed) {
     console.log('    No legacy _designos directory found (OK)');
   }
 }

package/scripts/update/migrations/1.2.x-to-1.3.0.js

@@ -17,7 +17,7 @@ const configMerger = require('../lib/config-merger');
 module.exports = {
   name: '1.2.x-to-1.3.0',
   fromVersion: '1.2.x',
-  toVersion: '1.3.5',
+  toVersion: '1.3.7',
   breaking: false,
 
   /**
@@ -27,7 +27,7 @@ module.exports = {
   async preview() {
     return {
       actions: [
-        'Update version: 1.2.x → 1.3.5',
+        'Update version: 1.2.x → 1.3.7',
         'Verify deprecated workflows archived',
         'Remove legacy _designos directory (pre-Vortex structure)',
         'Remove deprecated agent files (empathy-mapper.md, wireframe-designer.md)',
@@ -47,8 +47,8 @@ module.exports = {
     const targetDir = path.join(process.cwd(), '_bmad/bme/_vortex');
 
     // 1. Update version in config.yaml
-    await updateConfigVersion('1.3.5');
-    changes.push('Updated version to 1.3.5');
+    await updateConfigVersion('1.3.7');
+    changes.push('Updated version to 1.3.7');
 
     // 2. Verify deprecated structure exists
     await ensureDeprecatedStructure(targetDir);
@@ -190,12 +190,21 @@ async function copyUserGuides() {
  * Remove old _designos directory (pre-Vortex structure)
  */
 async function removeOldDesignosDirectory() {
-  const designosPath = path.join(process.cwd(), '_bmad/bme/_designos');
+  const legacyPaths = [
+    path.join(process.cwd(), '_bmad/bme/_designos'),
+    path.join(process.cwd(), '_bmad/_designos'),
+  ];
 
-  if (fs.existsSync(designosPath)) {
-    await fs.remove(designosPath);
-    console.log('    Removed legacy _designos directory');
-  } else {
+  let removed = false;
+  for (const designosPath of legacyPaths) {
+    if (fs.existsSync(designosPath)) {
+      await fs.remove(designosPath);
+      console.log(`    Removed legacy directory: ${path.relative(process.cwd(), designosPath)}`);
+      removed = true;
+    }
+  }
+
+  if (!removed) {
     console.log('    No legacy _designos directory found (OK)');
   }
 }

package/scripts/update/migrations/registry.js

@@ -14,7 +14,7 @@ const MIGRATIONS = [
   {
     name: '1.0.x-to-1.3.0',
     fromVersion: '1.0.x',
-    toVersion: '1.3.5',
+    toVersion: '1.3.7',
     breaking: true,
     description: 'Migrate empathy-map workflow to lean-persona',
     module: null // Loaded on demand
@@ -22,7 +22,7 @@ const MIGRATIONS = [
   {
     name: '1.1.x-to-1.3.0',
     fromVersion: '1.1.x',
-    toVersion: '1.3.5',
+    toVersion: '1.3.7',
     breaking: false,
     description: 'Archive deprecated workflows, update agents',
     module: null // Loaded on demand
@@ -30,7 +30,7 @@ const MIGRATIONS = [
   {
     name: '1.2.x-to-1.3.0',
     fromVersion: '1.2.x',
-    toVersion: '1.3.5',
+    toVersion: '1.3.7',
     breaking: false,
     description: 'Update to v1.3.0 with migration system',
     module: null // Loaded on demand