convoke-agents 3.0.1 → 3.0.3

package/_bmad/bme/_vortex/config.yaml

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

package/package.json

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

package/scripts/convoke-doctor.js

@@ -147,28 +147,27 @@ function checkModuleConfig(mod) {
     };
   }
 
-  if (!Array.isArray(mod.config.agents) || mod.config.agents.length === 0) {
-    return {
-      name: label,
-      passed: false,
-      error: 'config.yaml missing or empty agents section',
-      fix: `Check ${mod.configPath}`
-    };
-  }
+  const hasAgents = Array.isArray(mod.config.agents) && mod.config.agents.length > 0;
+  const hasWorkflows = Array.isArray(mod.config.workflows) && mod.config.workflows.length > 0;
 
-  if (!Array.isArray(mod.config.workflows) || mod.config.workflows.length === 0) {
+  // A module must have at least agents or workflows
+  if (!hasAgents && !hasWorkflows) {
     return {
       name: label,
       passed: false,
-      error: 'config.yaml missing or empty workflows section',
+      error: 'config.yaml missing both agents and workflows sections',
       fix: `Check ${mod.configPath}`
     };
   }
 
+  const parts = [];
+  if (hasAgents) parts.push(`${mod.config.agents.length} agents`);
+  if (hasWorkflows) parts.push(`${mod.config.workflows.length} workflows`);
+
   return {
     name: label,
     passed: true,
-    info: `${mod.config.agents.length} agents, ${mod.config.workflows.length} workflows`
+    info: parts.join(', ')
   };
 }
 

package/scripts/update/convoke-update.js

@@ -54,7 +54,7 @@ function assessUpdate(projectRoot) {
   const breakingChanges = registry.getBreakingChanges(currentVersion);
 
   if (migrations.length === 0) {
-    return { action: 'no-migrations', currentVersion, targetVersion };
+    return { action: 'refresh-only', currentVersion, targetVersion };
   }
 
   return {
@@ -144,14 +144,59 @@ async function main() {
       process.exit(1);
       break;
 
-    case 'no-migrations':
-      console.log(chalk.yellow('No migrations needed (versions compatible)'));
+    case 'refresh-only':
+    case 'upgrade':
+      break; // Continue below
+  }
+
+  // Refresh-only: no migration deltas, just update files to latest version
+  if (assessment.action === 'refresh-only') {
+    console.log(chalk.cyan('Update Plan:'));
+    console.log(`  From: ${chalk.red(assessment.currentVersion)}`);
+    console.log(`  To:   ${chalk.green(assessment.targetVersion)}`);
+    console.log('');
+    console.log(chalk.cyan('No migration deltas needed — refreshing installation files.'));
+    console.log('');
+
+    if (dryRun) {
+      console.log(chalk.yellow.bold('DRY RUN — no changes will be made'));
       console.log('');
       process.exit(0);
-      break;
+    }
 
-    case 'upgrade':
-      break; // Continue below
+    if (!yes) {
+      console.log(chalk.cyan('Your data will be backed up automatically.'));
+      console.log('');
+      const confirmed = await confirm('Proceed with update?');
+      if (!confirmed) {
+        console.log('');
+        console.log(chalk.yellow('Update cancelled.'));
+        console.log('');
+        process.exit(0);
+      }
+    }
+
+    console.log('');
+    console.log(chalk.cyan.bold('Starting update...'));
+
+    try {
+      const result = await migrationRunner.runRefreshOnly(assessment.currentVersion, { verbose });
+
+      console.log('');
+      console.log(chalk.green.bold('✓ Update completed successfully!'));
+      console.log('');
+      console.log(chalk.cyan('Changes applied:'));
+      result.changes.forEach(change => {
+        console.log(chalk.green(`  ✓ ${change}`));
+      });
+      console.log('');
+      console.log(chalk.gray(`Backup location: ${result.backupMetadata.backup_dir}`));
+      console.log('');
+    } catch (_error) {
+      process.exit(1);
+    }
+
+    process.exit(0);
   }
 
   // Show migration plan

package/scripts/update/lib/migration-runner.js

@@ -378,8 +378,108 @@ class MigrationError extends Error {
   }
 }
 
+/**
+ * Refresh-only update: no migration deltas, just backup + refresh + validate.
+ * Used when upgrading between versions that have no registered migration deltas.
+ * @param {string} fromVersion - Current installed version
+ * @param {object} options - Options { verbose }
+ * @returns {Promise<object>} Update result
+ */
+async function runRefreshOnly(fromVersion, options = {}) {
+  const { verbose = false } = options;
+  const toVersion = getPackageVersion();
+
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    throw new Error('Not in a Convoke project. Could not find _bmad/ directory.');
+  }
+
+  // 1. Acquire lock
+  await acquireMigrationLock(projectRoot);
+
+  let backupMetadata = null;
+
+  try {
+    // 2. Create backup
+    console.log(chalk.cyan('[1/3] Creating backup...'));
+    backupMetadata = await backupManager.createBackup(fromVersion, projectRoot);
+    console.log(chalk.green(`✓ Backup created: ${path.basename(backupMetadata.backup_dir)}`));
+    console.log('');
+
+    // 3. Refresh installation
+    console.log(chalk.cyan('[2/3] Refreshing installation files...'));
+    const changes = await refreshInstallation(projectRoot, { verbose });
+    console.log(chalk.green('✓ Installation refreshed'));
+    console.log('');
+
+    // 4. Validate
+    console.log(chalk.cyan('[3/3] Validating installation...'));
+    const validationResult = await validator.validateInstallation(backupMetadata, projectRoot);
+
+    validationResult.checks.forEach(check => {
+      if (check.passed) {
+        console.log(chalk.green(`  ✓ ${check.name}`));
+        if (check.info || check.warning) {
+          console.log(chalk.gray(`    ${check.info || check.warning}`));
+        }
+      } else {
+        console.log(chalk.red(`  ✗ ${check.name}`));
+        if (check.error) {
+          console.log(chalk.red(`    Error: ${check.error}`));
+        }
+      }
+    });
+    console.log('');
+
+    if (!validationResult.valid) {
+      throw new Error('Installation validation failed');
+    }
+
+    console.log(chalk.green('✓ Installation validated'));
+    console.log('');
+
+    // 5. Cleanup old backups
+    const deletedCount = await backupManager.cleanupOldBackups(5, projectRoot);
+    if (deletedCount > 0) {
+      console.log(chalk.green(`✓ Cleaned up ${deletedCount} old backup(s)`));
+    }
+
+    // Release lock
+    await releaseMigrationLock(projectRoot);
+
+    return {
+      success: true,
+      fromVersion,
+      toVersion,
+      changes,
+      backupMetadata
+    };
+
+  } catch (error) {
+    console.error('');
+    console.error(chalk.red.bold('✗ Update failed!'));
+    console.error(chalk.red(error.message));
+    console.error('');
+
+    if (backupMetadata) {
+      console.log(chalk.yellow('Restoring from backup...'));
+      try {
+        await backupManager.restoreBackup(backupMetadata, projectRoot);
+        console.log(chalk.green('✓ Installation restored from backup'));
+      } catch (restoreError) {
+        console.error(chalk.red('✗ Restore failed!'));
+        console.error(chalk.yellow(`Manual restore may be needed from: ${backupMetadata.backup_dir}`));
+      }
+    }
+
+    await releaseMigrationLock(projectRoot);
+    throw error;
+  }
+}
+
 module.exports = {
   runMigrations,
+  runRefreshOnly,
   previewMigrations,
   executeMigration,
   MigrationError

package/scripts/update/lib/refresh-installation.js

@@ -115,6 +115,13 @@ async function refreshInstallation(projectRoot, options = {}) {
 
     if (!isSameRoot) {
       await fs.copy(packageEnhance, targetEnhance, { overwrite: true });
+      // Stamp enhance config version to match package version
+      const targetEnhanceConfig = path.join(targetEnhance, 'config.yaml');
+      if (fs.existsSync(targetEnhanceConfig)) {
+        const ecContent = yaml.load(fs.readFileSync(targetEnhanceConfig, 'utf8'));
+        ecContent.version = version;
+        fs.writeFileSync(targetEnhanceConfig, yaml.dump(ecContent, { lineWidth: -1 }), 'utf8');
+      }
       changes.push('Refreshed Enhance module: _bmad/bme/_enhance/');
       if (verbose) console.log('    Refreshed Enhance module: _bmad/bme/_enhance/');
     } else {