musubi-sdd 6.2.0 → 6.2.1

package/README.ja.md

@@ -17,7 +17,7 @@
 
 ---
 
-> 🤖 **7つのAIエージェント** × 📋 **27の専門スキル** × ⚖️ **憲法ガバナンス**
+> 🤖 **7つのAIエージェント** × 📋 **31の専門スキル** × ⚖️ **憲法ガバナンス**
 
 MUSUBI（結び）は、6つの主要フレームワークのベスト機能を統合した包括的な**仕様駆動開発（SDD）**フレームワークです。複数のAIコーディングエージェントに対応した本番環境対応ツールです。
 
@@ -71,6 +71,65 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
+## 📊 v6.2.0 の新機能
+
+### Review Gate Engine 🛡️
+
+各開発ステージでの体系的なレビューのための新しい品質ゲート。
+
+#### レビューゲート
+
+| ゲート | 説明 | プロンプト |
+|------|------|------------|
+| **Requirements Gate** | EARS形式、優先度、受入基準の検証 | `#sdd-review-requirements` |
+| **Design Gate** | C4モデル、ADR、コンポーネント設計の検証 | `#sdd-review-design` |
+| **Implementation Gate** | コード品質、テストカバレッジ、命名規則 | `#sdd-review-implementation` |
+| **Full Review** | 全ゲートを順番に実行 | `#sdd-review-all` |
+
+```bash
+# AIエージェントでレビュープロンプトを使用
+#sdd-review-requirements user-auth
+#sdd-review-design user-auth
+#sdd-review-implementation user-auth
+```
+
+#### ワークフローダッシュボード
+
+- **進捗可視化**: 5ステージのリアルタイム進捗表示
+- **ブロッカー管理**: ブロッカーの追加・解決・追跡
+- **遷移記録**: ステージ間遷移の記録と分析
+- **スプリント計画**: ベロシティ追跡付きタスク優先度付け
+
+```bash
+musubi dashboard show <feature>     # ワークフロー状態表示
+musubi dashboard start <feature>    # 新規ワークフロー開始
+musubi dashboard blocker <feature>  # ブロッカー管理
+```
+
+#### トレーサビリティシステム
+
+- **自動抽出**: コード・テスト・コミットからID自動抽出
+- **ギャップ検出**: 設計・実装・テストの欠落検出
+- **マトリックスストレージ**: 履歴付きYAMLベース追跡マトリックス
+
+```bash
+musubi-trace extract <dir>   # トレーサビリティID抽出
+musubi-trace gaps <feature>  # ギャップ検出
+musubi-trace matrix          # マトリックスレポート生成
+```
+
+#### エンタープライズ機能
+
+| 機能 | 説明 |
+|------|------|
+| **エラーリカバリー** | 修復手順付き自動エラー分析 |
+| **ロールバックマネージャー** | ファイル/コミット/ステージ/スプリント単位のロールバック |
+| **CIレポーター** | GitHub Actions統合 |
+| **Phase -1 ゲート** | 全ステージ前の憲法準拠チェック |
+| **Steering同期** | バージョン変更時のステアリングファイル自動更新 |
+
+---
+
 ## 📊 v5.9.0 の新機能
 
 ### Phase 1-4 エンタープライズ機能 🏢

package/README.md

@@ -17,7 +17,7 @@
 
 ---
 
-> 🤖 **7 AI Coding Agents** × 📋 **27 Specialized Skills** × ⚖️ **Constitutional Governance**
+> 🤖 **7 AI Coding Agents** × 📋 **31 Specialized Skills** × ⚖️ **Constitutional Governance**
 
 MUSUBI (結び - "connection/binding") is a comprehensive **Specification Driven Development (SDD)** framework that synthesizes the best features from 6 leading frameworks into a production-ready tool for multiple AI coding agents.
 
@@ -71,6 +71,65 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
+## 📊 What's New in v6.2.0
+
+### Review Gate Engine 🛡️
+
+New quality gates for systematic review at each development stage.
+
+#### Review Gates
+
+| Gate | Description | Prompt |
+|------|-------------|--------|
+| **Requirements Gate** | EARS format, priority, acceptance criteria validation | `#sdd-review-requirements` |
+| **Design Gate** | C4 model, ADR, component design validation | `#sdd-review-design` |
+| **Implementation Gate** | Code quality, test coverage, naming conventions | `#sdd-review-implementation` |
+| **Full Review** | All gates in sequence | `#sdd-review-all` |
+
+```bash
+# Use review prompts in your AI agent
+#sdd-review-requirements user-auth
+#sdd-review-design user-auth
+#sdd-review-implementation user-auth
+```
+
+#### Workflow Dashboard
+
+- **Progress Visualization**: Real-time progress across 5 stages
+- **Blocker Management**: Add, resolve, and track blockers
+- **Transition Recording**: Record and analyze stage transitions
+- **Sprint Planning**: Task prioritization with velocity tracking
+
+```bash
+musubi dashboard show <feature>     # Show workflow status
+musubi dashboard start <feature>    # Start new workflow
+musubi dashboard blocker <feature>  # Manage blockers
+```
+
+#### Traceability System
+
+- **Auto-Extraction**: Automatic ID extraction from code, tests, commits
+- **Gap Detection**: Detect missing design, implementation, or tests
+- **Matrix Storage**: YAML-based traceability matrix with history
+
+```bash
+musubi-trace extract <dir>   # Extract traceability IDs
+musubi-trace gaps <feature>  # Detect gaps
+musubi-trace matrix          # Generate matrix report
+```
+
+#### Enterprise Features
+
+| Feature | Description |
+|---------|-------------|
+| **Error Recovery** | Auto error analysis with remediation steps |
+| **Rollback Manager** | File/commit/stage/sprint level rollback |
+| **CI Reporter** | GitHub Actions integration |
+| **Phase -1 Gate** | Constitutional compliance before all stages |
+| **Steering Sync** | Auto-update steering files on version change |
+
+---
+
 ## 📊 What's New in v5.9.0
 
 ### Phase 1-4 Enterprise Features 🏢

package/bin/musubi-dashboard.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+
+/**
+ * MUSUBI Dashboard CLI
+ * 
+ * Workflow dashboard for progress visualization and management.
+ * 
+ * Usage:
+ *   musubi-dashboard show <feature>      Show workflow status
+ *   musubi-dashboard create <feature>    Create new workflow
+ *   musubi-dashboard advance <feature>   Advance to next stage
+ *   musubi-dashboard blocker <feature>   Manage blockers
+ *   musubi-dashboard sprint <action>     Sprint management
+ *   musubi-dashboard trace <action>      Traceability management
+ * 
+ * Requirement: IMP-6.2-003-05
+ */
+
+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];
+
+// Parse options
+const options = {};
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('--')) {
+    const key = args[i].slice(2);
+    const value = args[i + 1] && !args[i + 1].startsWith('--') ? args[i + 1] : true;
+    options[key] = value;
+    if (value !== true) i++;
+  }
+}
+
+async function main() {
+  const cli = new DashboardCLI();
+
+  if (!command || command === '--help' || command === '-h') {
+    showHelp();
+    process.exit(0);
+  }
+
+  try {
+    let result;
+
+    switch (command) {
+      case 'show':
+      case 'status':
+        result = await cli.execute('workflow:status', [subcommand]);
+        formatWorkflowStatus(result);
+        break;
+
+      case 'create':
+      case 'start':
+        result = await cli.execute('workflow:create', [subcommand], options);
+        console.log(`\n✅ Workflow created for: ${subcommand}`);
+        formatWorkflowStatus(result);
+        break;
+
+      case 'advance':
+        result = await cli.execute('workflow:advance', [subcommand], options);
+        console.log(`\n✅ Workflow advanced`);
+        formatWorkflowStatus(result);
+        break;
+
+      case 'blocker':
+        if (options.add) {
+          result = await cli.execute('blocker:add', [subcommand], {
+            stage: options.stage || 'current',
+            description: options.add,
+            severity: options.severity || 'medium'
+          });
+          console.log(`\n✅ Blocker added: ${options.add}`);
+        } else if (options.resolve) {
+          result = await cli.execute('blocker:resolve', [subcommand], {
+            blockerId: options.resolve,
+            resolution: options.resolution || 'Resolved'
+          });
+          console.log(`\n✅ Blocker resolved`);
+        } else {
+          result = await cli.execute('blocker:list', [subcommand]);
+          formatBlockers(result);
+        }
+        break;
+
+      case 'sprint':
+        await handleSprintCommand(cli, subcommand, args.slice(2), options);
+        break;
+
+      case 'trace':
+        await handleTraceCommand(cli, subcommand, args.slice(2), options);
+        break;
+
+      case 'report':
+        result = await cli.execute('report:generate', [subcommand], options);
+        console.log(result.report);
+        break;
+
+      default:
+        console.error(`Unknown command: ${command}`);
+        showHelp();
+        process.exit(1);
+    }
+  } catch (error) {
+    console.error(`\n❌ Error: ${error.message}`);
+    if (options.verbose) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+async function handleSprintCommand(cli, action, args, options) {
+  let result;
+
+  switch (action) {
+    case 'create':
+      result = await cli.execute('sprint:create', args, options);
+      console.log(`\n✅ Sprint created: ${result.id}`);
+      break;
+
+    case 'start':
+      result = await cli.execute('sprint:start', args);
+      console.log(`\n✅ Sprint started: ${args[0]}`);
+      break;
+
+    case 'complete':
+      result = await cli.execute('sprint:complete', args);
+      console.log(`\n✅ Sprint completed: ${args[0]}`);
+      break;
+
+    case 'status':
+      result = await cli.execute('sprint:status', args);
+      formatSprintStatus(result);
+      break;
+
+    case 'report':
+      result = await cli.execute('sprint:report', args, options);
+      console.log(result.markdown || result.report);
+      break;
+
+    default:
+      console.error(`Unknown sprint action: ${action}`);
+      process.exit(1);
+  }
+}
+
+async function handleTraceCommand(cli, action, args, options) {
+  let result;
+
+  switch (action) {
+    case 'extract':
+      result = await cli.execute('trace:extract', args, options);
+      console.log(`\n✅ Extracted ${result.references?.length || 0} traceability references`);
+      break;
+
+    case 'gaps':
+      result = await cli.execute('trace:gaps', args);
+      formatGaps(result);
+      break;
+
+    case 'matrix':
+      result = await cli.execute('trace:matrix', args, options);
+      console.log(result.markdown || JSON.stringify(result, null, 2));
+      break;
+
+    case 'report':
+      result = await cli.execute('trace:report', args, options);
+      console.log(result.report);
+      break;
+
+    default:
+      console.error(`Unknown trace action: ${action}`);
+      process.exit(1);
+  }
+}
+
+function formatWorkflowStatus(workflow) {
+  if (!workflow) {
+    console.log('\n⚠️  No workflow found for this feature');
+    return;
+  }
+
+  console.log(`\n📊 Workflow Dashboard: ${workflow.featureId || 'Unknown'}`);
+  console.log('═'.repeat(50));
+
+  if (workflow.title) {
+    console.log(`📝 Title: ${workflow.title}`);
+  }
+
+  console.log(`📍 Current Stage: ${workflow.currentStage || 'N/A'}`);
+  console.log(`📈 Completion: ${workflow.completion || 0}%`);
+  console.log('');
+
+  // Stage visualization
+  const stages = ['steering', 'requirements', 'design', 'implementation', 'validation'];
+  const stageStatus = workflow.stages || {};
+
+  console.log('Stages:');
+  stages.forEach((stage, index) => {
+    const status = stageStatus[stage]?.status || 'pending';
+    const icon = getStatusIcon(status);
+    const current = stage === workflow.currentStage ? '◀' : '';
+    console.log(`  ${index + 1}. ${icon} ${stage.padEnd(15)} ${current}`);
+  });
+
+  if (workflow.blockers && workflow.blockers.length > 0) {
+    console.log(`\n⚠️  Blockers: ${workflow.blockers.filter(b => !b.resolvedAt).length} active`);
+  }
+}
+
+function formatBlockers(result) {
+  const blockers = result.blockers || [];
+  
+  if (blockers.length === 0) {
+    console.log('\n✅ No blockers');
+    return;
+  }
+
+  console.log(`\n⚠️  Blockers (${blockers.length}):`);
+  console.log('─'.repeat(40));
+
+  blockers.forEach((blocker, i) => {
+    const status = blocker.resolvedAt ? '✅' : '🚫';
+    console.log(`${i + 1}. ${status} [${blocker.severity || 'medium'}] ${blocker.description}`);
+    if (blocker.stage) {
+      console.log(`   Stage: ${blocker.stage}`);
+    }
+  });
+}
+
+function formatSprintStatus(sprint) {
+  if (!sprint) {
+    console.log('\n⚠️  Sprint not found');
+    return;
+  }
+
+  console.log(`\n🏃 Sprint: ${sprint.name || sprint.id}`);
+  console.log('═'.repeat(50));
+  console.log(`Status: ${sprint.status || 'unknown'}`);
+  console.log(`Tasks: ${sprint.tasks?.length || 0}`);
+  
+  if (sprint.metrics) {
+    console.log(`Completion: ${sprint.metrics.completionPercentage || 0}%`);
+    console.log(`Points: ${sprint.metrics.completedPoints || 0}/${sprint.metrics.totalPoints || 0}`);
+  }
+}
+
+function formatGaps(result) {
+  const gaps = result.gaps || [];
+
+  if (gaps.length === 0) {
+    console.log('\n✅ No traceability gaps detected');
+    return;
+  }
+
+  console.log(`\n⚠️  Traceability Gaps (${gaps.length}):`);
+  console.log('─'.repeat(50));
+
+  // Group by severity
+  const bySeverity = { critical: [], high: [], medium: [], low: [] };
+  gaps.forEach(gap => {
+    const sev = gap.severity || 'medium';
+    if (bySeverity[sev]) bySeverity[sev].push(gap);
+  });
+
+  Object.entries(bySeverity).forEach(([severity, items]) => {
+    if (items.length > 0) {
+      const icon = severity === 'critical' ? '🔴' : severity === 'high' ? '🟠' : severity === 'medium' ? '🟡' : '🟢';
+      console.log(`\n${icon} ${severity.toUpperCase()} (${items.length}):`);
+      items.forEach(gap => {
+        console.log(`  - ${gap.requirementId}: ${gap.gapType}`);
+        if (gap.suggestion) {
+          console.log(`    💡 ${gap.suggestion}`);
+        }
+      });
+    }
+  });
+}
+
+function getStatusIcon(status) {
+  const icons = {
+    'completed': '✅',
+    'in-progress': '🔄',
+    'blocked': '🚫',
+    'pending': '⬜',
+    'not-started': '⬜'
+  };
+  return icons[status] || '⬜';
+}
+
+function showHelp() {
+  console.log(`
+MUSUBI Dashboard CLI v6.2.0
+
+Usage: musubi-dashboard <command> [options]
+
+Workflow Commands:
+  show <feature>         Show workflow status
+  create <feature>       Create new workflow
+  start <feature>        Alias for create
+  advance <feature>      Advance to next stage
+  blocker <feature>      Manage blockers
+    --add <description>  Add a blocker
+    --resolve <id>       Resolve a blocker
+    --stage <stage>      Specify stage
+    --severity <level>   Set severity (low/medium/high/critical)
+
+Sprint Commands:
+  sprint create <name>   Create a new sprint
+    --feature <id>       Associated feature
+    --velocity <points>  Sprint velocity
+  sprint start <id>      Start a sprint
+  sprint complete <id>   Complete a sprint
+  sprint status <id>     Show sprint status
+  sprint report <id>     Generate sprint report
+
+Traceability Commands:
+  trace extract <dir>    Extract traceability IDs
+  trace gaps <feature>   Detect traceability gaps
+  trace matrix           Generate traceability matrix
+  trace report           Generate full report
+
+General Options:
+  --verbose              Show detailed output
+  --format <type>        Output format (text/json/markdown)
+  --help, -h             Show this help
+
+Examples:
+  musubi-dashboard show user-auth
+  musubi-dashboard create FEAT-001 --title "User Authentication"
+  musubi-dashboard blocker FEAT-001 --add "Waiting for API spec"
+  musubi-dashboard sprint create "Sprint 1" --feature FEAT-001
+  musubi-dashboard trace gaps FEAT-001
+`);
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubi-sdd",
-  "version": "6.2.0",
+  "version": "6.2.1",
   "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": {
@@ -73,7 +73,8 @@
     "js-yaml": "^4.1.0",
     "open": "^10.1.0",
     "playwright": "^1.40.0",
-    "ws": "^8.14.2"
+    "ws": "^8.14.2",
+    "yaml": "^2.8.2"
   },
   "devDependencies": {
     "eslint": "^8.50.0",