bmad-enhanced 1.1.3 → 1.3.0

package/README.md

@@ -4,10 +4,11 @@
 
 > Strategic framing and validated learning through Emma and Wade
 
-[![Status](https://img.shields.io/badge/status-v1.1.0--repositioned-green)]()
-[![Version](https://img.shields.io/badge/version-1.1.0-blue)]()
-[![Emma](https://img.shields.io/badge/emma-contextualization_expert-brightgreen)]()
-[![Wade](https://img.shields.io/badge/wade-lean_experiments_specialist-brightgreen)]()
+[![Status](https://img.shields.io/badge/status-v1.3.0--complete-success)]()
+[![Version](https://img.shields.io/badge/version-1.3.0-blue)]()
+[![Workflows](https://img.shields.io/badge/workflows-7_implemented-success)]()
+[![Emma](https://img.shields.io/badge/emma-3_workflows-brightgreen)]()
+[![Wade](https://img.shields.io/badge/wade-4_workflows-brightgreen)]()
 [![License](https://img.shields.io/badge/license-MIT-blue)]()
 
 ---
@@ -62,10 +63,10 @@ npx bmad-method@alpha install
 Once BMAD Method is installed:
 
 ```bash
-npm install bmad-enhanced@1.1.0 && npx bmad-install-agents
+npm install bmad-enhanced@1.3.0 && npx bmad-install-agents
 ```
 
-That's it! Emma and Wade (Vortex framework) are now added to your BMAD installation.
+That's it! Emma and Wade (Vortex framework) with all 7 workflows are now added to your BMAD installation.
 
 ### Installation
 
@@ -73,14 +74,14 @@ That's it! Emma and Wade (Vortex framework) are now added to your BMAD installat
 
 ```bash
 # Install into your project
-npm install bmad-enhanced@1.1.0
+npm install bmad-enhanced@1.3.0
 
-# Install all agents (Emma + Wade)
+# Install all agents (Emma + Wade) with all 7 workflows
 npx bmad-install-agents
 
 # Or install individually
-npx bmad-install-emma    # Install Emma (Contextualization Expert)
-npx bmad-install-wade    # Install Wade (Lean Experiments Specialist)
+npx bmad-install-emma    # Install Emma (3 Contextualize workflows)
+npx bmad-install-wade    # Install Wade (4 Externalize workflows)
 ```
 
 **Option 2: Clone from source**
@@ -99,10 +100,12 @@ cat _bmad/bme/_vortex/agents/contextualization-expert.md
 
 **What gets installed:**
 - Agent definition files (`_bmad/bme/_vortex/agents/`)
-- Workflow files (7 workflows: lean-persona, product-vision, contextualize-scope, mvp, lean-experiment, proof-of-concept, proof-of-value)
+- **7 complete workflows** (56 files):
+  - Emma: lean-persona, product-vision, contextualize-scope
+  - Wade: mvp, lean-experiment, proof-of-concept, proof-of-value
 - Configuration file (`_bmad/bme/_vortex/config.yaml`)
 - Output directory (`_bmad-output/vortex-artifacts/`)
-- User guides (coming in v1.2.0)
+- User guides (Emma & Wade v1.2.0)
 
 ### Your First Lean Persona with Emma
 
@@ -111,12 +114,22 @@ cat _bmad/bme/_vortex/agents/contextualization-expert.md
 cat _bmad/bme/_vortex/agents/contextualization-expert.md
 ```
 
-Emma will guide you through strategic contextualization:
-- **Lean Persona:** Jobs-to-be-done focused user personas (coming in v1.2.0)
-- **Product Vision:** Align team around the "why" before the "what" (coming in v1.2.0)
-- **Contextualize Scope:** Decide which problem space to investigate (coming in v1.2.0)
+Emma will guide you through strategic contextualization with 3 workflows:
 
-**Current Status:** Workflows coming in v1.2.0. Use Emma's chat mode for strategic framing guidance.
+- **[LP] Lean Persona** - Create jobs-to-be-done focused user personas
+  - 6-step guided workflow
+  - Hypothesis-driven with validation planning
+  - Output: Lean persona document with riskiest assumptions identified
+
+- **[PV] Product Vision** - Define strategic product vision
+  - Vision statement, future state (3-5 years), guiding principles
+  - Strategic assumptions and validation plan
+  - Output: Complete product vision document
+
+- **[CS] Contextualize Scope** - Decide which problem space to investigate
+  - Systematic opportunity evaluation with scoring matrix
+  - Clear scope boundaries (what's in, what's out)
+  - Output: Scope decision document with rationale
 
 ### Your First Lean Experiment with Wade
 
@@ -125,13 +138,106 @@ Emma will guide you through strategic contextualization:
 cat _bmad/bme/_vortex/agents/lean-experiments-specialist.md
 ```
 
-Wade will guide you through validated learning:
-- **MVP:** Design Minimum Viable Product to test riskiest assumptions (coming in v1.2.0)
-- **Lean Experiment:** Run Build-Measure-Learn cycles (coming in v1.2.0)
-- **Proof-of-Concept:** Validate technical feasibility (coming in v1.2.0)
-- **Proof-of-Value:** Validate business value (coming in v1.2.0)
+Wade will guide you through validated learning with 4 workflows:
+
+- **[MVP] Minimum Viable Product** - Design MVPs to test riskiest assumptions
+  - Not feature-light products - smallest thing to test assumptions
+  - Build-Measure-Learn cycle planning
+  - Output: MVP specification document
+
+- **[LE] Lean Experiment** - Execute Build-Measure-Learn cycles
+  - Hypothesis-driven experimentation framework
+  - Metrics definition and pivot-or-persevere decisions
+  - Output: Experiment results and learning documentation
+
+- **[POC] Proof-of-Concept** - Validate technical feasibility
+  - Test "Can we build it?" before "Should we build it?"
+  - Technical risk assessment and PoC scoping
+  - Output: Feasibility evaluation document
 
-**Current Status:** Workflows coming in v1.2.0. Use Wade's chat mode for experiment design guidance.
+- **[POV] Proof-of-Value** - Validate business value
+  - Test "Should we build it?" (business case)
+  - Willingness to pay and market demand experiments
+  - Output: Business case and build/pivot/kill decision
+
+---
+
+## 🔄 Updating BMAD-Enhanced
+
+### Check Version
+
+```bash
+npx bmad-version
+```
+
+**Output shows:**
+- Current installed version
+- Latest package version
+- Update availability status
+- Migration history
+
+### Update to Latest Version
+
+```bash
+# Update the package
+npm install bmad-enhanced@latest
+
+# Preview changes (dry run)
+npx bmad-update --dry-run
+
+# Apply the update
+npx bmad-update
+```
+
+**Your data is automatically backed up before any changes.**
+
+### Update Commands
+
+- `npx bmad-update` - Apply updates and migrations
+- `npx bmad-update --dry-run` - Preview changes without applying
+- `npx bmad-update --yes` - Skip confirmation prompt
+- `npx bmad-version` - Show current version and status
+
+### Data Safety
+
+**Automatic backups before every update:**
+- Location: `_bmad-output/.backups/backup-{version}-{timestamp}/`
+- Automatic rollback if migration fails
+- Keeps last 5 backups
+
+**Never touched:**
+- All user data in `_bmad-output/`
+- User preferences (name, language)
+- Custom configurations
+
+### Migration Paths
+
+**From v1.1.x to v1.3.0:**
+- No breaking changes
+- Agent files refreshed (bug fixes)
+- User guides updated
+
+**From v1.0.x to v1.3.0:**
+- ⚠️ Breaking: empathy-map → lean-persona
+- Old workflows preserved in `_deprecated/`
+- 7 new workflows installed
+
+### Troubleshooting
+
+If update fails:
+
+```bash
+# Check migration logs
+ls _bmad-output/.logs/
+
+# Restore from backup
+cp -r _bmad-output/.backups/backup-{version}-{timestamp}/* _bmad/bme/_vortex/
+
+# Reinstall (preserves user data)
+npx bmad-install-agents
+```
+
+**📖 See [UPDATE-GUIDE.md](UPDATE-GUIDE.md) for comprehensive update documentation**
 
 ---
 
@@ -155,82 +261,85 @@ All agents built using a standard pattern:
 
 ## 🚀 Agents
 
-### Emma (contextualization-expert) - ✅ REPOSITIONED
+### Emma (contextualization-expert) - ✅ COMPLETE
 
-**Status:** Repositioned in v1.1.0 - Workflows coming in v1.2.0
+**Status:** v1.2.0 - All 3 workflows implemented and ready to use
 **Title:** Contextualization Expert 🎯
 **Stream:** Contextualize
 **Domain:** Strategic framing, problem-product space navigation
 
-**New Workflows (v1.2.0):**
-- **Lean Persona:** Create jobs-to-be-done focused personas
-- **Product Vision:** Define clear product vision and strategic direction
-- **Contextualize Scope:** Decide which problem space to investigate
+**Workflows Available Now:**
+- **lean-persona** - Create jobs-to-be-done focused personas (6 steps)
+- **product-vision** - Define clear product vision and strategic direction (6 steps)
+- **contextualize-scope** - Decide which problem space to investigate (6 steps)
 
 **Key Positioning:**
 - Helps teams frame the right problem before building solutions
 - Focus on Lean Startup methodologies and validated assumptions
 - Guides teams through strategic clarity before tactical execution
+- Hypothesis-driven with built-in validation planning
 
 **Differentiation:**
 - **Emma vs Maya:** Emma contextualizes (problem space), Maya creates (solution space)
 - Emma answers "What should we solve?" before Maya answers "How should we solve it?"
 
-**Current Status:** Chat mode available for strategic guidance. Workflows coming March 2026.
+**Output:** Lean personas, product visions, and scope decisions in `_bmad-output/vortex-artifacts/`
 
 ---
 
-### Wade (lean-experiments-specialist) - ✅ REPOSITIONED
+### Wade (lean-experiments-specialist) - ✅ COMPLETE
 
-**Status:** Repositioned in v1.1.0 - Workflows coming in v1.2.0
+**Status:** v1.2.0 - All 4 workflows implemented and ready to use
 **Title:** Lean Experiments Specialist 🧪
 **Stream:** Externalize
 **Domain:** Lean Startup experimentation, validated learning
 
-**New Workflows (v1.2.0):**
-- **MVP:** Design Minimum Viable Product to test riskiest assumptions
-- **Lean Experiment:** Run Build-Measure-Learn cycles
-- **Proof-of-Concept:** Validate technical feasibility
-- **Proof-of-Value:** Validate business value
+**Workflows Available Now:**
+- **mvp** - Design Minimum Viable Product to test riskiest assumptions (6 steps)
+- **lean-experiment** - Run Build-Measure-Learn cycles (6 steps)
+- **proof-of-concept** - Validate technical feasibility (6 steps)
+- **proof-of-value** - Validate business value (6 steps)
 
 **Key Positioning:**
 - Helps teams test assumptions with real users through rapid experiments
 - Focus on validated learning over perfection
 - Guides teams from hypotheses to evidence
+- Build-Measure-Learn cycles with pivot-or-persevere decisions
 
 **Differentiation:**
 - **Wade vs Sally:** Wade externalizes (test with users), Sally internalizes (test with code)
 - Wade answers "Should we build this?" before Sally answers "How do we build this well?"
 
-**Current Status:** Chat mode available for experiment design. Workflows coming March 2026.
+**Output:** MVP specs, experiment results, PoC/PoV evaluations in `_bmad-output/vortex-artifacts/`
 
 ---
 
 ## 📊 Project Status
 
-**Current Version:** v1.1.0 - Vortex Framework Repositioning
+**Current Version:** v1.2.0 - Complete Vortex Framework Implementation ✅
 
 **Progress:**
-- ✅ Emma - REPOSITIONED to Contextualization Expert (v1.1.0)
-- ✅ Wade - REPOSITIONED to Lean Experiments Specialist (v1.1.0)
-- 📋 New workflows - Coming in v1.2.0 (March 2026)
+- ✅ Emma - 3 Contextualize workflows IMPLEMENTED (v1.2.0)
+- ✅ Wade - 4 Externalize workflows IMPLEMENTED (v1.2.0)
+- ✅ 56 workflow files created (7 workflows × 8 files each)
+- ✅ User guides updated to v1.2.0
 
-**What Changed in v1.1.0:**
-- Module renamed: `_designos` → `_vortex`
-- Emma: Empathy Mapping → Strategic Framing & Contextualization
-- Wade: Wireframe Design → Lean Experiments & Validated Learning
-- 7 new workflows defined (implementation in v1.2.0)
+**What's New in v1.2.0:**
+- **7 complete workflows** - lean-persona, product-vision, contextualize-scope (Emma) + mvp, lean-experiment, proof-of-concept, proof-of-value (Wade)
+- **Lean Startup methodology** - Hypothesis-driven, Build-Measure-Learn cycles
+- **Updated documentation** - Emma & Wade user guides v1.2.0
+- **Deprecated workflows archived** - empathy-map and wireframe moved to `_deprecated/` (still functional)
 
 **Roadmap:**
 ```
-v1.1.0               v1.2.0              v2.0.0
-├─────────────────┬──────────────────┬──────────────────┤
-│ Repositioning ✅ │  Workflows 📋    │  Advanced 📋     │
-│ • New identity  │  • 7 workflows   │  • Multi-agent   │
-│ • Framework     │  • Templates     │  • Integration   │
-│ • Structure     │  • User guides   │  • Analytics     │
-└─────────────────┴──────────────────┴──────────────────┘
-   Feb 2026           Mar 2026           Q2 2026
+v1.1.0               v1.2.0                  v1.3.0              v2.0.0
+├─────────────────┬────────────────────────┬──────────────────┬──────────────────┤
+│ Repositioning ✅ │  Workflows ✅          │  Tooling 📋      │  Advanced 📋     │
+│ • New identity  │  • 7 workflows         │  • Update tools  │  • Multi-agent   │
+│ • Framework     │  • Templates           │  • Migration     │  • Integration   │
+│ • Structure     │  • User guides         │  • Automation    │  • Analytics     │
+└─────────────────┴────────────────────────┴──────────────────┴──────────────────┘
+   Feb 2026            Feb 2026                Q2 2026             Q3 2026
 ```
 
 **See:** [CHANGELOG.md](CHANGELOG.md) for complete version history
@@ -721,11 +830,22 @@ Built on:
 - Use Wade alone for experiment design and validation
 - Use both together for complete Contextualize → Externalize flow
 
-### When will the new workflows be ready?
+### Are the new workflows ready?
+
+**Yes! v1.2.0 released February 2026.** All 7 workflows are fully implemented and ready to use:
+
+**Emma (Contextualize):**
+- lean-persona (6-step workflow)
+- product-vision (6-step workflow)
+- contextualize-scope (6-step workflow)
 
-**v1.2.0 in March 2026.** The 7 workflows (lean-persona, product-vision, contextualize-scope, mvp, lean-experiment, proof-of-concept, proof-of-value) are currently in development.
+**Wade (Externalize):**
+- mvp (6-step workflow)
+- lean-experiment (6-step workflow)
+- proof-of-concept (6-step workflow)
+- proof-of-value (6-step workflow)
 
-**Current state:** Emma and Wade's chat modes are available for guidance while workflows are being built.
+Each workflow includes templates, step files, and comprehensive guidance.
 
 ### How is this different from BMAD core agents?
 

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "bmad-enhanced",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "Vortex Framework - Contextualize and Externalize streams for Lean Startup validation",
   "main": "index.js",
   "bin": {
     "bmad-install-agents": "scripts/install-all-agents.js",
     "bmad-install-emma": "scripts/install-emma.js",
-    "bmad-install-wade": "scripts/install-wade.js"
+    "bmad-install-wade": "scripts/install-wade.js",
+    "bmad-update": "scripts/update/bmad-update.js",
+    "bmad-version": "scripts/update/bmad-version.js",
+    "bmad-migrate": "scripts/update/bmad-migrate.js"
   },
   "scripts": {
     "install:emma": "node scripts/install-emma.js",
@@ -37,6 +40,7 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
-    "fs-extra": "^11.3.3"
+    "fs-extra": "^11.3.3",
+    "js-yaml": "^4.1.0"
   }
 }

package/scripts/install-all-agents.js

@@ -65,8 +65,8 @@ function copyAllAgentFiles() {
 
   // Create target directory structure
   fs.mkdirSync(path.join(targetDir, 'agents'), { recursive: true });
-  fs.mkdirSync(path.join(targetDir, 'workflows', 'empathy-map', 'steps'), { recursive: true });
-  fs.mkdirSync(path.join(targetDir, 'workflows', 'wireframe', 'steps'), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, 'workflows', '_deprecated', 'empathy-map', 'steps'), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, 'workflows', '_deprecated', 'wireframe', 'steps'), { recursive: true });
 
   // Copy Emma agent file
   console.log(`${CYAN}  →${RESET} Installing Emma (contextualization-expert)...`);
@@ -89,8 +89,8 @@ function copyAllAgentFiles() {
 
   emmaWorkflowFiles.forEach(file => {
     fs.copyFileSync(
-      path.join(sourceDir, 'workflows', 'empathy-map', file),
-      path.join(targetDir, 'workflows', 'empathy-map', file)
+      path.join(sourceDir, 'workflows', '_deprecated', 'empathy-map', file),
+      path.join(targetDir, 'workflows', '_deprecated', 'empathy-map', file)
     );
   });
 
@@ -117,8 +117,8 @@ function copyAllAgentFiles() {
 
   wadeWorkflowFiles.forEach(file => {
     fs.copyFileSync(
-      path.join(sourceDir, 'workflows', 'wireframe', file),
-      path.join(targetDir, 'workflows', 'wireframe', file)
+      path.join(sourceDir, 'workflows', '_deprecated', 'wireframe', file),
+      path.join(targetDir, 'workflows', '_deprecated', 'wireframe', file)
     );
   });
 
@@ -136,7 +136,7 @@ function updateConfig() {
 submodule_name: _vortex
 description: Contextualize and Externalize streams - Strategic framing and validated learning
 module: bme
-version: 1.1.0
+version: 1.2.0
 
 # Output Configuration
 output_folder: "{project-root}/_bmad-output/vortex-artifacts"
@@ -194,8 +194,8 @@ function verifyInstallation() {
   const checks = [
     { path: '_bmad/bme/_vortex/agents/contextualization-expert.md', name: 'Emma agent file' },
     { path: '_bmad/bme/_vortex/agents/lean-experiments-specialist.md', name: 'Wade agent file' },
-    { path: '_bmad/bme/_vortex/workflows/empathy-map/workflow.md', name: 'Emma workflow' },
-    { path: '_bmad/bme/_vortex/workflows/wireframe/workflow.md', name: 'Wade workflow' },
+    { path: '_bmad/bme/_vortex/workflows/_deprecated/empathy-map/workflow.md', name: 'Emma workflow (legacy)' },
+    { path: '_bmad/bme/_vortex/workflows/_deprecated/wireframe/workflow.md', name: 'Wade workflow (legacy)' },
     { path: '_bmad/bme/_vortex/config.yaml', name: 'Configuration file' },
   ];
 

package/scripts/install-emma.js

@@ -53,7 +53,7 @@ function copyAgentFiles() {
 
   // Create target directory structure
   fs.mkdirSync(path.join(targetDir, 'agents'), { recursive: true });
-  fs.mkdirSync(path.join(targetDir, 'workflows', 'empathy-map', 'steps'), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, 'workflows', '_deprecated', 'empathy-map', 'steps'), { recursive: true });
 
   // Copy Emma agent file
   fs.copyFileSync(
@@ -75,8 +75,8 @@ function copyAgentFiles() {
 
   workflowFiles.forEach(file => {
     fs.copyFileSync(
-      path.join(sourceDir, 'workflows', 'empathy-map', file),
-      path.join(targetDir, 'workflows', 'empathy-map', file)
+      path.join(sourceDir, 'workflows', '_deprecated', 'empathy-map', file),
+      path.join(targetDir, 'workflows', '_deprecated', 'empathy-map', file)
     );
   });
 
@@ -95,7 +95,7 @@ function updateConfig() {
 submodule_name: _vortex
 description: Contextualize and Externalize streams - Strategic framing and validated learning
 module: bme
-version: 1.1.0
+version: 1.2.0
 
 # Output Configuration
 output_folder: "{project-root}/_bmad-output/vortex-artifacts"

package/scripts/install-wade.js

@@ -53,7 +53,7 @@ function copyAgentFiles() {
 
   // Create target directory structure
   fs.mkdirSync(path.join(targetDir, 'agents'), { recursive: true });
-  fs.mkdirSync(path.join(targetDir, 'workflows', 'wireframe', 'steps'), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, 'workflows', '_deprecated', 'wireframe', 'steps'), { recursive: true });
 
   // Copy Wade agent file
   fs.copyFileSync(
@@ -75,8 +75,8 @@ function copyAgentFiles() {
 
   workflowFiles.forEach(file => {
     fs.copyFileSync(
-      path.join(sourceDir, 'workflows', 'wireframe', file),
-      path.join(targetDir, 'workflows', 'wireframe', file)
+      path.join(sourceDir, 'workflows', '_deprecated', 'wireframe', file),
+      path.join(targetDir, 'workflows', '_deprecated', 'wireframe', file)
     );
   });
 
@@ -95,7 +95,7 @@ function updateConfig() {
 submodule_name: _vortex
 description: Contextualize and Externalize streams - Strategic framing and validated learning
 module: bme
-version: 1.1.0
+version: 1.2.0
 
 # Output Configuration
 output_folder: "{project-root}/_bmad-output/vortex-artifacts"

package/scripts/postinstall.js

@@ -1,17 +1,106 @@
 #!/usr/bin/env node
 
+const path = require('path');
+const fs = require('fs');
+
+// Check if update system is available
+const versionDetectorPath = path.join(__dirname, 'update/lib/version-detector.js');
+const registryPath = path.join(__dirname, 'update/migrations/registry.js');
+
+const hasUpdateSystem = fs.existsSync(versionDetectorPath) && fs.existsSync(registryPath);
+
+// ANSI color codes
 const BOLD = '\x1b[1m';
 const RESET = '\x1b[0m';
 const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+
+async function main() {
+  console.log('');
+  console.log(`${BOLD}BMAD-Enhanced installed!${RESET}`);
+  console.log('');
+
+  // If update system available, check for upgrades
+  if (hasUpdateSystem) {
+    const versionDetector = require('./update/lib/version-detector');
+    const registry = require('./update/migrations/registry');
+
+    const currentVersion = versionDetector.getCurrentVersion();
+    const targetVersion = versionDetector.getTargetVersion();
+    const scenario = versionDetector.detectInstallationScenario();
+
+    // Fresh install
+    if (scenario === 'fresh' || !currentVersion) {
+      console.log('To install agents into your project, run:');
+      console.log('');
+      console.log(`  ${CYAN}npx bmad-install-agents${RESET}  - Install all agents (Emma + Wade)`);
+      console.log('');
+      console.log('Or install individually:');
+      console.log(`  ${CYAN}npx bmad-install-emma${RESET}    - Install Emma (contextualization-expert)`);
+      console.log(`  ${CYAN}npx bmad-install-wade${RESET}    - Install Wade (lean-experiments-specialist)`);
+      console.log('');
+      return;
+    }
+
+    // Already up to date
+    if (currentVersion === targetVersion) {
+      console.log(`${GREEN}✓ BMAD-Enhanced is up to date! (v${currentVersion})${RESET}`);
+      console.log('');
+      return;
+    }
+
+    // Upgrade detected
+    if (versionDetector.compareVersions(currentVersion, targetVersion) < 0) {
+      console.log(`${YELLOW}${BOLD}⚠ UPGRADE DETECTED${RESET}`);
+      console.log('');
+      console.log(`  Current version: ${RED}${currentVersion}${RESET}`);
+      console.log(`  New version:     ${GREEN}${targetVersion}${RESET}`);
+      console.log('');
+
+      // Check for breaking changes
+      const breakingChanges = registry.getBreakingChanges(currentVersion, targetVersion);
+      if (breakingChanges.length > 0) {
+        console.log(`${RED}${BOLD}  ⚠ Breaking changes detected!${RESET}`);
+        console.log('');
+        console.log('  Breaking changes:');
+        breakingChanges.forEach(change => {
+          console.log(`${YELLOW}    - ${change}${RESET}`);
+        });
+        console.log('');
+      }
+
+      console.log('To preview changes without applying:');
+      console.log(`  ${CYAN}npx bmad-update --dry-run${RESET}`);
+      console.log('');
+      console.log('To apply the update:');
+      console.log(`  ${CYAN}npx bmad-update${RESET}`);
+      console.log('');
+      console.log(`${BOLD}Your data will be backed up automatically before any changes.${RESET}`);
+      console.log('');
+      return;
+    }
+
+    // Downgrade (shouldn't happen normally)
+    if (versionDetector.compareVersions(currentVersion, targetVersion) > 0) {
+      console.log(`${YELLOW}Note: Package version (${targetVersion}) is older than installed version (${currentVersion})${RESET}`);
+      console.log('');
+      return;
+    }
+  } else {
+    // Fallback to original message if update system not available
+    console.log('To install agents into your project, run:');
+    console.log('');
+    console.log(`  ${CYAN}npx bmad-install-agents${RESET}  - Install all agents (Emma + Wade)`);
+    console.log('');
+    console.log('Or install individually:');
+    console.log(`  ${CYAN}npx bmad-install-emma${RESET}    - Install Emma (empathy-mapper)`);
+    console.log(`  ${CYAN}npx bmad-install-wade${RESET}    - Install Wade (wireframe-designer)`);
+    console.log('');
+  }
+}
 
-console.log('');
-console.log(`${BOLD}BMAD-Enhanced installed!${RESET}`);
-console.log('');
-console.log('To install agents into your project, run:');
-console.log('');
-console.log(`  ${CYAN}npx bmad-install-agents${RESET}  - Install all agents (Emma + Wade)`);
-console.log('');
-console.log('Or install individually:');
-console.log(`  ${CYAN}npx bmad-install-emma${RESET}    - Install Emma (empathy-mapper)`);
-console.log(`  ${CYAN}npx bmad-install-wade${RESET}    - Install Wade (wireframe-designer)`);
-console.log('');
+main().catch(error => {
+  console.error('Error in postinstall:', error.message);
+});