musubi-sdd 6.2.1 → 6.2.2

package/bin/musubi-dashboard.js

@@ -21,7 +21,7 @@ const { DashboardCLI } = require('../src/cli/dashboard-cli');
 const args = process.argv.slice(2);
 const command = args[0];
 const subcommand = args[1];
-const feature = args[2] || args[1];
+const _feature = args[2] || args[1];
 
 // Parse options
 const options = {};

package/bin/musubi-upgrade.js

@@ -0,0 +1,395 @@
+#!/usr/bin/env node
+
+/**
+ * MUSUBI Upgrade Script
+ *
+ * Upgrades existing MUSUBI projects to newer versions:
+ * - Updates steering files
+ * - Adds new prompts/skills
+ * - Migrates configuration
+ * - Preserves user customizations
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { Command } = require('commander');
+
+const program = new Command();
+const packageJson = require('../package.json');
+
+// Version migration definitions
+const MIGRATIONS = {
+  '6.2.0': {
+    description: 'Review Gate Engine, Dashboard, Traceability',
+    changes: [
+      'Add Review Gate prompts to AGENTS.md',
+      'Create storage/reviews/, storage/dashboard/, storage/traceability/ directories',
+      'Update steering/project.yml with reviewGate settings',
+    ],
+    migrate: migrateToV620,
+  },
+  '6.2.1': {
+    description: 'Bug fixes and improvements',
+    changes: ['Minor fixes'],
+    migrate: migrateToV621,
+  },
+};
+
+// ============================================================================
+// Migration Functions
+// ============================================================================
+
+async function migrateToV620(projectDir, _options) {
+  const results = { success: [], failed: [], skipped: [] };
+
+  // 1. Create new storage directories
+  const newDirs = [
+    'storage/reviews',
+    'storage/dashboard',
+    'storage/traceability',
+    'storage/transitions',
+  ];
+
+  for (const dir of newDirs) {
+    const dirPath = path.join(projectDir, dir);
+    try {
+      if (!fs.existsSync(dirPath)) {
+        await fs.ensureDir(dirPath);
+        await fs.writeFile(path.join(dirPath, '.gitkeep'), '');
+        results.success.push(`Created ${dir}/`);
+      } else {
+        results.skipped.push(`${dir}/ already exists`);
+      }
+    } catch (err) {
+      results.failed.push(`Failed to create ${dir}/: ${err.message}`);
+    }
+  }
+
+  // 2. Update AGENTS.md with new review prompts
+  const agentsPath = path.join(projectDir, 'AGENTS.md');
+  if (fs.existsSync(agentsPath)) {
+    try {
+      let content = await fs.readFile(agentsPath, 'utf8');
+
+      const reviewPrompts = `
+### Review Gate Prompts (v6.2.0)
+
+- \`#sdd-review-requirements <feature>\` - Review requirements (EARS, stakeholders, acceptance criteria)
+- \`#sdd-review-design <feature>\` - Review design (C4, ADR, Constitutional Articles)
+- \`#sdd-review-implementation <feature>\` - Review implementation (coverage, lint, traceability)
+- \`#sdd-review-all <feature>\` - Full review cycle for all phases
+`;
+
+      if (!content.includes('#sdd-review-requirements')) {
+        // Find a good insertion point (after existing prompts section)
+        const promptsIndex = content.indexOf('### Prompts');
+        if (promptsIndex !== -1) {
+          const nextSectionIndex = content.indexOf('###', promptsIndex + 10);
+          if (nextSectionIndex !== -1) {
+            content =
+              content.slice(0, nextSectionIndex) + reviewPrompts + '\n' + content.slice(nextSectionIndex);
+          } else {
+            content += '\n' + reviewPrompts;
+          }
+        } else {
+          content += '\n' + reviewPrompts;
+        }
+
+        await fs.writeFile(agentsPath, content);
+        results.success.push('Added Review Gate prompts to AGENTS.md');
+      } else {
+        results.skipped.push('Review Gate prompts already in AGENTS.md');
+      }
+    } catch (err) {
+      results.failed.push(`Failed to update AGENTS.md: ${err.message}`);
+    }
+  } else {
+    results.skipped.push('AGENTS.md not found (not a MUSUBI project?)');
+  }
+
+  // 3. Update steering/project.yml with reviewGate settings
+  const projectYmlPath = path.join(projectDir, 'steering', 'project.yml');
+  if (fs.existsSync(projectYmlPath)) {
+    try {
+      let content = await fs.readFile(projectYmlPath, 'utf8');
+
+      const reviewGateConfig = `
+# Review Gate Settings (v6.2.0)
+reviewGate:
+  requirements:
+    earsCheck: true
+    stakeholderCoverage: true
+    acceptanceCriteriaRequired: true
+  design:
+    c4Required: ['context', 'container', 'component']
+    adrRequired: true
+    constitutionalArticles: [1, 2, 7, 8]
+  implementation:
+    minCoverage: 80
+    coverageType: 'line'
+    lintStrict: true
+
+# Traceability Settings (v6.2.0)
+traceability:
+  patterns:
+    - 'REQ-[A-Z0-9]+-\\\\d{3}'
+    - 'IMP-\\\\d+\\\\.\\\\d+-\\\\d{3}(?:-\\\\d{2})?'
+  extractFrom:
+    - 'src/**/*.{ts,js}'
+    - 'tests/**/*.test.{ts,js}'
+  outputPath: 'storage/traceability/matrix.yml'
+`;
+
+      if (!content.includes('reviewGate:')) {
+        content += '\n' + reviewGateConfig;
+        await fs.writeFile(projectYmlPath, content);
+        results.success.push('Added reviewGate settings to steering/project.yml');
+      } else {
+        results.skipped.push('reviewGate settings already in steering/project.yml');
+      }
+    } catch (err) {
+      results.failed.push(`Failed to update steering/project.yml: ${err.message}`);
+    }
+  } else {
+    results.skipped.push('steering/project.yml not found');
+  }
+
+  // 4. Create version marker
+  const versionPath = path.join(projectDir, 'steering', '.musubi-version');
+  try {
+    await fs.writeFile(versionPath, '6.2.0\n');
+    results.success.push('Created version marker');
+  } catch (err) {
+    results.failed.push(`Failed to create version marker: ${err.message}`);
+  }
+
+  return results;
+}
+
+async function migrateToV621(projectDir, _options) {
+  const results = { success: [], failed: [], skipped: [] };
+
+  // v6.2.1 is mainly bug fixes, just update version marker
+  const versionPath = path.join(projectDir, 'steering', '.musubi-version');
+  try {
+    await fs.writeFile(versionPath, '6.2.1\n');
+    results.success.push('Updated version marker to 6.2.1');
+  } catch (err) {
+    results.failed.push(`Failed to update version marker: ${err.message}`);
+  }
+
+  return results;
+}
+
+// ============================================================================
+// Utility Functions
+// ============================================================================
+
+function getCurrentVersion(projectDir) {
+  const versionPath = path.join(projectDir, 'steering', '.musubi-version');
+  if (fs.existsSync(versionPath)) {
+    return fs.readFileSync(versionPath, 'utf8').trim();
+  }
+
+  // Fallback: check if MUSUBI is initialized
+  const steeringDir = path.join(projectDir, 'steering');
+  if (fs.existsSync(steeringDir)) {
+    return '6.0.0'; // Assume pre-version-tracking
+  }
+
+  return null;
+}
+
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    if (parts1[i] > parts2[i]) return 1;
+    if (parts1[i] < parts2[i]) return -1;
+  }
+  return 0;
+}
+
+function getMigrationPath(fromVersion, toVersion) {
+  const versions = Object.keys(MIGRATIONS).sort(compareVersions);
+  const path = [];
+
+  for (const version of versions) {
+    if (compareVersions(version, fromVersion) > 0 && compareVersions(version, toVersion) <= 0) {
+      path.push(version);
+    }
+  }
+
+  return path;
+}
+
+// ============================================================================
+// CLI Commands
+// ============================================================================
+
+program
+  .name('musubi-upgrade')
+  .description('Upgrade MUSUBI project to a newer version')
+  .version(packageJson.version)
+  .option('--to <version>', 'Target version to upgrade to', 'latest')
+  .option('--dry-run', 'Preview changes without applying')
+  .option('--force', 'Force upgrade even if already at target version')
+  .action(async options => {
+    const projectDir = process.cwd();
+
+    console.log(chalk.blue.bold('\n🔄 MUSUBI Upgrade\n'));
+
+    // Check if MUSUBI is initialized
+    const currentVersion = getCurrentVersion(projectDir);
+    if (!currentVersion) {
+      console.log(chalk.red('❌ MUSUBI is not initialized in this directory.'));
+      console.log(chalk.gray('\nRun: npx musubi-sdd init\n'));
+      process.exit(1);
+    }
+
+    // Determine target version
+    let targetVersion = options.to;
+    if (targetVersion === 'latest') {
+      targetVersion = packageJson.version;
+    }
+
+    // Validate target version
+    const availableVersions = Object.keys(MIGRATIONS);
+    if (!availableVersions.includes(targetVersion) && targetVersion !== packageJson.version) {
+      console.log(chalk.red(`❌ Unknown target version: ${targetVersion}`));
+      console.log(chalk.gray(`\nAvailable versions: ${availableVersions.join(', ')}\n`));
+      process.exit(1);
+    }
+
+    console.log(chalk.white(`Current version: ${chalk.yellow(currentVersion)}`));
+    console.log(chalk.white(`Target version:  ${chalk.green(targetVersion)}`));
+
+    // Check if upgrade is needed
+    const comparison = compareVersions(currentVersion, targetVersion);
+    if (comparison >= 0 && !options.force) {
+      console.log(chalk.green('\n✅ Already at target version or newer.\n'));
+      console.log(chalk.gray('Use --force to re-run migrations.\n'));
+      process.exit(0);
+    }
+
+    // Get migration path
+    const migrationPath = getMigrationPath(currentVersion, targetVersion);
+
+    if (migrationPath.length === 0) {
+      console.log(chalk.yellow('\n⚠️  No migrations needed.\n'));
+      process.exit(0);
+    }
+
+    console.log(chalk.white(`\nMigrations to apply: ${migrationPath.join(' → ')}\n`));
+
+    // Show migration details
+    for (const version of migrationPath) {
+      const migration = MIGRATIONS[version];
+      console.log(chalk.cyan(`📦 v${version}: ${migration.description}`));
+      for (const change of migration.changes) {
+        console.log(chalk.gray(`   - ${change}`));
+      }
+    }
+
+    if (options.dryRun) {
+      console.log(chalk.yellow('\n🔍 Dry run mode - no changes applied.\n'));
+      process.exit(0);
+    }
+
+    // Confirm upgrade
+    console.log('');
+
+    // Apply migrations
+    let totalSuccess = 0;
+    let totalFailed = 0;
+    let totalSkipped = 0;
+
+    for (const version of migrationPath) {
+      console.log(chalk.blue(`\n📦 Applying migration to v${version}...\n`));
+
+      const migration = MIGRATIONS[version];
+      const results = await migration.migrate(projectDir, options);
+
+      for (const msg of results.success) {
+        console.log(chalk.green(`   ✅ ${msg}`));
+        totalSuccess++;
+      }
+      for (const msg of results.skipped) {
+        console.log(chalk.yellow(`   ⏭️  ${msg}`));
+        totalSkipped++;
+      }
+      for (const msg of results.failed) {
+        console.log(chalk.red(`   ❌ ${msg}`));
+        totalFailed++;
+      }
+    }
+
+    // Summary
+    console.log(chalk.blue.bold('\n📊 Upgrade Summary\n'));
+    console.log(chalk.green(`   ✅ Success: ${totalSuccess}`));
+    console.log(chalk.yellow(`   ⏭️  Skipped: ${totalSkipped}`));
+    console.log(chalk.red(`   ❌ Failed: ${totalFailed}`));
+
+    if (totalFailed > 0) {
+      console.log(chalk.red('\n⚠️  Some migrations failed. Please check the errors above.\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.green(`\n✅ Successfully upgraded to v${targetVersion}!\n`));
+  });
+
+// List available migrations
+program
+  .command('list')
+  .description('List available migrations')
+  .action(() => {
+    console.log(chalk.blue.bold('\n📋 Available MUSUBI Migrations\n'));
+
+    const versions = Object.keys(MIGRATIONS).sort(compareVersions);
+    for (const version of versions) {
+      const migration = MIGRATIONS[version];
+      console.log(chalk.cyan(`v${version}: ${migration.description}`));
+      for (const change of migration.changes) {
+        console.log(chalk.gray(`   - ${change}`));
+      }
+      console.log('');
+    }
+
+    console.log(chalk.white(`Current package version: ${packageJson.version}\n`));
+  });
+
+// Check current version
+program
+  .command('check')
+  .description('Check current project version')
+  .action(() => {
+    const projectDir = process.cwd();
+    const currentVersion = getCurrentVersion(projectDir);
+
+    console.log(chalk.blue.bold('\n🔍 MUSUBI Version Check\n'));
+
+    if (!currentVersion) {
+      console.log(chalk.red('❌ MUSUBI is not initialized in this directory.\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.white(`Project version: ${chalk.yellow(currentVersion)}`));
+    console.log(chalk.white(`Package version: ${chalk.green(packageJson.version)}`));
+
+    const comparison = compareVersions(currentVersion, packageJson.version);
+    if (comparison < 0) {
+      console.log(chalk.yellow(`\n⚠️  Upgrade available: ${currentVersion} → ${packageJson.version}`));
+      console.log(chalk.gray('\nRun: npx musubi-sdd upgrade\n'));
+    } else {
+      console.log(chalk.green('\n✅ Project is up to date.\n'));
+    }
+  });
+
+program.parse(process.argv);
+
+// Show help if no arguments
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/bin/musubi.js

@@ -392,6 +392,21 @@ program
     }
   });
 
+// ============================================================================
+// Command: upgrade
+// ============================================================================
+program
+  .command('upgrade')
+  .description('Upgrade MUSUBI project to a newer version')
+  .option('--to <version>', 'Target version to upgrade to', 'latest')
+  .option('--dry-run', 'Preview changes without applying')
+  .option('--force', 'Force upgrade even if already at target version')
+  .action(async _options => {
+    // Delegate to musubi-upgrade.js
+    process.argv = ['node', 'musubi-upgrade', ...process.argv.slice(3)];
+    require('./musubi-upgrade.js');
+  });
+
 // ============================================================================
 // Command: info
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubi-sdd",
-  "version": "6.2.1",
+  "version": "6.2.2",
   "description": "Ultimate Specification Driven Development Tool with 27 Agents for 7 AI Coding Platforms + MCP Integration (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Codex, Qwen Code)",
   "main": "src/index.js",
   "bin": {
@@ -26,7 +26,8 @@
     "musubi-gui": "bin/musubi-gui.js",
     "musubi-orchestrate": "bin/musubi-orchestrate.js",
     "musubi-release": "bin/musubi-release.js",
-    "musubi-config": "bin/musubi-config.js"
+    "musubi-config": "bin/musubi-config.js",
+    "musubi-upgrade": "bin/musubi-upgrade.js"
   },
   "scripts": {
     "test": "jest",

package/src/constitutional/ci-reporter.js

@@ -218,11 +218,13 @@ class CIReporter {
       }
     }
 
-    // Set output
+    // Set output using Environment Files (GITHUB_OUTPUT)
+    // Note: In GitHub Actions, these would be written to $GITHUB_OUTPUT file
+    // Format: echo "name=value" >> $GITHUB_OUTPUT
     lines.push('');
-    lines.push(`::set-output name=violations::${results.summary.totalViolations}`);
-    lines.push(`::set-output name=blocked::${blockDecision.shouldBlock}`);
-    lines.push(`::set-output name=phase_minus_one::${blockDecision.requiresPhaseMinusOne}`);
+    lines.push(`violations=${results.summary.totalViolations}`);
+    lines.push(`blocked=${blockDecision.shouldBlock}`);
+    lines.push(`phase_minus_one=${blockDecision.requiresPhaseMinusOne}`);
 
     return lines.join('\n');
   }
@@ -230,10 +232,10 @@ class CIReporter {
   /**
    * Format as JUnit XML
    * @param {Object} results - Check results
-   * @param {Object} blockDecision - Block decision
+   * @param {Object} _blockDecision - Block decision (unused, for interface compatibility)
    * @returns {string} JUnit XML
    */
-  formatJUnit(results, blockDecision) {
+  formatJUnit(results, _blockDecision) {
     const lines = [];
 
     lines.push('<?xml version="1.0" encoding="UTF-8"?>');

package/src/constitutional/phase-minus-one.js

@@ -9,7 +9,7 @@
 
 const fs = require('fs').promises;
 const path = require('path');
-const { ConstitutionalChecker, SEVERITY } = require('./checker');
+const { ConstitutionalChecker } = require('./checker');
 
 /**
  * Default configuration
@@ -51,7 +51,7 @@ class PhaseMinusOneGate {
    * @returns {Promise<Object>} Gate record
    */
   async trigger(options) {
-    const gateId = `GATE-${Date.now()}`;
+    const gateId = `GATE-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     
     const gate = {
       id: gateId,

package/src/constitutional/steering-sync.js

@@ -102,7 +102,7 @@ class SteeringSync {
     // Check for orphaned references
     if (structure) {
       // Check if directories mentioned in structure.md exist
-      const dirPattern = /`([a-z\-]+\/)`/g;
+      const dirPattern = /`([a-z-]+\/)`/g;
       let match;
       while ((match = dirPattern.exec(structure)) !== null) {
         const dirName = match[1].replace('/', '');

package/src/dashboard/sprint-reporter.js

@@ -37,7 +37,7 @@ class SprintReporter {
    */
   async generateReport(sprint) {
     const report = {
-      id: `RPT-${sprint.id}-${Date.now()}`,
+      id: `RPT-${sprint.id}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
       sprintId: sprint.id,
       sprintName: sprint.name,
       featureId: sprint.featureId,

package/src/dashboard/workflow-dashboard.js

@@ -230,7 +230,7 @@ class WorkflowDashboard {
 
     const actions = [];
     const currentStage = workflow.currentStage;
-    const stageData = workflow.stages[currentStage];
+    const _stageData = workflow.stages[currentStage];
 
     // Check for blockers
     const unresolvedBlockers = workflow.blockers.filter(b => !b.resolvedAt);

package/src/enterprise/experiment-report.js

@@ -393,7 +393,7 @@ class ExperimentReportGenerator {
    * @returns {string} HTML content
    */
   formatHTML(report) {
-    const { metadata, summary, testResults, metrics, observations, conclusions } = report;
+    const { metadata, summary, testResults, observations, conclusions } = report;
 
     return `<!DOCTYPE html>
 <html lang="en">

package/src/traceability/extractor.js

@@ -120,7 +120,7 @@ class TraceabilityExtractor {
       const lines = stdout.trim().split('\n').filter(l => l.length > 0);
 
       for (const line of lines) {
-        const [hash, message, date, author] = line.split('|');
+        const [hash, message] = line.split('|');
 
         for (const pattern of REQ_PATTERNS) {
           pattern.lastIndex = 0;