convoke-agents 2.2.0 → 2.3.1

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.3.1] - 2026-03-15
+
+### Fixed
+
+- **Migration chaining bug** — `getMigrationsFor()` now walks the full migration chain instead of only matching the first hop. Users jumping multiple versions (e.g., `1.0.x` → `2.x`) previously skipped all intermediate migrations silently. The `1.5.x-to-1.6.0` config delta (Wave 3 agents) was being skipped for anyone upgrading from `1.0.x–1.4.x`.
+- **README version badge** — Updated from stale `2.0.1` to current version
+- **INSTALLATION.md** — Added missing `-p convoke-agents` to `npx` command in troubleshooting section
+- **BMAD-METHOD-COMPATIBILITY.md** — Fixed wrong package name (`convoke` → `convoke-agents`) and added missing `-p convoke-agents` to all `npx` commands
+- **Archived outdated docs** — PUBLISHING-GUIDE.md and TEST-PLAN-REAL-INSTALL.md marked as historical (contained legacy commands)
+
+### Added
+
+- **Chain traversal tests** — 10 new unit tests for migration chain resolution, parallel entry exclusion, and breaking change detection across chains
+- **Multi-version integration test** — Verifies full `1.5.2 → current` update path with all 3 deltas executing and complete migration history
+
+---
+
 ## [2.2.0] - 2026-03-14
 
 ### Changed

package/INSTALLATION.md

@@ -181,7 +181,7 @@ The installer preserves your custom settings and only adds missing entries. To f
 
 ```bash
 rm -rf _bmad/bme/_vortex/
-npx convoke-install-vortex
+npx -p convoke-agents convoke-install-vortex
 ```
 
 ### Installation succeeds but agents don't activate

package/README.md

@@ -10,7 +10,7 @@
                 Agent teams for complex systems
 ```
 
-[![Version](https://img.shields.io/badge/version-2.0.1-blue)](https://github.com/amalik/convoke-agents)
+[![Version](https://img.shields.io/badge/version-2.3.1-blue)](https://github.com/amalik/convoke-agents)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>

package/_bmad/bme/_vortex/config.yaml

@@ -33,7 +33,7 @@ workflows:
   - learning-card
   - pivot-patch-persevere
   - vortex-navigation
-version: 2.2.0
+version: 2.3.1
 user_name: '{user}'
 communication_language: en
 party_mode_enabled: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoke-agents",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Agent teams for complex systems, compatible with BMad Method",
   "main": "index.js",
   "files": [

package/scripts/update/migrations/registry.js

@@ -2,7 +2,7 @@
 
 const fs = require('fs-extra');
 const yaml = require('js-yaml');
-const { compareVersions } = require('../lib/utils');
+
 
 /**
  * Migration Registry for Convoke
@@ -73,40 +73,77 @@ const MIGRATIONS = [
 
 /**
  * Get migrations applicable for upgrading from a given version.
- * Target version is always the current package version (read at runtime).
+ * Walks the full migration chain: finds the entry-point migration matching
+ * the user's version, then follows the chain forward by parsing each
+ * migration's target version and finding the next hop.
  *
  * @param {string} fromVersion - Current installed version (e.g., "1.0.5")
- * @returns {Array} List of applicable migrations with loaded modules
+ * @returns {Array} List of applicable migrations with loaded modules, in chain order
  */
 function getMigrationsFor(fromVersion) {
   const applicable = [];
 
+  // Step 1: Find the entry-point migration matching the user's current version
+  let entryMigration = null;
   for (const migration of MIGRATIONS) {
     if (matchesVersionRange(fromVersion, migration.fromVersion)) {
-      // Lazy load the migration module
-      if (!migration.module) {
-        try {
-          migration.module = require(`./${migration.name}`);
-        } catch (error) {
-          console.error(`Failed to load migration ${migration.name}:`, error.message);
-          continue;
-        }
-      }
-
-      applicable.push(migration);
+      entryMigration = migration;
+      break;
     }
   }
 
-  // Sort by version order (oldest fromVersion first)
-  applicable.sort((a, b) => {
-    const aV = a.fromVersion.replace('.x', '.0');
-    const bV = b.fromVersion.replace('.x', '.0');
-    return compareVersions(aV, bV);
-  });
+  if (!entryMigration) return applicable;
+
+  // Load and add entry migration
+  if (!loadMigrationModule(entryMigration)) return applicable;
+  applicable.push(entryMigration);
+
+  // Step 2: Chain forward — parse target version from migration name,
+  // then find the next migration whose fromVersion matches that target
+  let targetVersion = parseTargetVersion(entryMigration.name);
+
+  while (targetVersion) {
+    const nextMigration = MIGRATIONS.find(m =>
+      matchesVersionRange(targetVersion, m.fromVersion) && !applicable.includes(m)
+    );
+
+    if (!nextMigration) break;
+    if (!loadMigrationModule(nextMigration)) break;
+
+    applicable.push(nextMigration);
+    targetVersion = parseTargetVersion(nextMigration.name);
+  }
 
   return applicable;
 }
 
+/**
+ * Parse the target version from a migration name.
+ * E.g., "1.0.x-to-1.3.0" → "1.3.0"
+ * @param {string} migrationName
+ * @returns {string|null} Target version or null if unparseable
+ */
+function parseTargetVersion(migrationName) {
+  const match = migrationName.match(/-to-(\d+\.\d+\.\d+)$/);
+  return match ? match[1] : null;
+}
+
+/**
+ * Lazy-load a migration's module file.
+ * @param {object} migration - Migration entry from MIGRATIONS array
+ * @returns {boolean} True if module loaded successfully
+ */
+function loadMigrationModule(migration) {
+  if (migration.module) return true;
+  try {
+    migration.module = require(`./${migration.name}`);
+    return true;
+  } catch (error) {
+    console.error(`Failed to load migration ${migration.name}:`, error.message);
+    return false;
+  }
+}
+
 /**
  * Check if migration has already been applied
  * @param {string} migrationName - Name of migration
@@ -190,5 +227,6 @@ module.exports = {
   hasMigrationBeenApplied,
   getBreakingChanges,
   matchesVersionRange,
+  parseTargetVersion,
   getAllMigrations
 };