musubi-sdd 0.8.5 → 0.8.7

package/README.ja.md

@@ -15,7 +15,8 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
 - 📋 **憲法ガバナンス** - 9つの不変条項 + フェーズ-1ゲートによる品質保証
 - 📝 **EARS要件ジェネレーター** - 5つのEARSパターンで明確な要件を作成（v0.8.0）
 - 🏗️ **設計ドキュメントジェネレーター** - トレーサビリティ付きC4モデルとADRを作成（v0.8.2）
-- 🔄 **差分仕様** - ブラウンフィールドおよびグリーンフィールドプロジェクト対応
+- 🔄 **変更管理システム** - ブラウンフィールドプロジェクト向け差分仕様（v0.8.6）
+- 🔍 **ギャップ検出システム** - 孤立した要件とテストされていないコードを特定（v0.8.7）
 - 🧭 **自動更新プロジェクトメモリ** - ステアリングシステムがアーキテクチャ、技術スタック、製品コンテキストを維持
 - 🚀 **自動オンボーディング** - `musubi-onboard` が既存プロジェクトを分析し、ステアリングドキュメントを生成（2-5分）
 - 🔄 **自動同期** - `musubi-sync` がコードベースの変更を検出し、ステアリングドキュメントを最新に保つ
@@ -138,6 +139,24 @@ musubi-trace coverage --min-coverage 100        # 100%カバレッジ要求
 musubi-trace gaps                               # 孤立した要件/コード検出
 musubi-trace requirement REQ-AUTH-001           # 特定要件をトレース
 musubi-trace validate                           # 100%トレーサビリティ検証（第5条）
+
+# ブラウンフィールドプロジェクト向け変更管理（v0.8.6）
+musubi-change init CHANGE-001 --title "認証機能追加"  # 変更提案を作成
+musubi-change validate CHANGE-001 --verbose     # 差分仕様を検証
+musubi-change apply CHANGE-001 --dry-run        # 変更をプレビュー
+musubi-change apply CHANGE-001                  # コードベースに変更を適用
+musubi-change archive CHANGE-001                # specs/にアーカイブ
+musubi-change list --status pending             # 保留中の変更をリスト
+musubi-change list --format json                # JSON形式でリスト
+
+# ギャップ検出とカバレッジ検証（v0.8.7）
+musubi-gaps detect                              # 全ギャップを検出
+musubi-gaps detect --verbose                    # 詳細なギャップ情報を表示
+musubi-gaps requirements                        # 孤立した要件を検出
+musubi-gaps code                                # テストされていないコードを検出
+musubi-gaps coverage                            # カバレッジ統計を計算
+musubi-gaps coverage --min-coverage 100         # 100%カバレッジを要求
+musubi-gaps detect --format markdown > gaps.md  # ギャップレポートをエクスポート
 ```
 
 ### プロジェクトタイプ

package/README.md

@@ -19,7 +19,8 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
 - 📋 **Constitutional Governance** - 9 immutable articles + Phase -1 Gates for quality enforcement
 - 📝 **EARS Requirements Generator** - Create unambiguous requirements with 5 EARS patterns (v0.8.0)
 - 🏗️ **Design Document Generator** - Create C4 models and ADRs with traceability (v0.8.2)
-- 🔄 **Delta Specifications** - Brownfield and greenfield project support
+- 🔄 **Change Management System** - Delta specifications for brownfield projects (v0.8.6)
+- 🔍 **Gap Detection System** - Identify orphaned requirements and untested code (v0.8.7)
 - 🧭 **Auto-Updating Project Memory** - Steering system maintains architecture, tech stack, and product context
 - 🚀 **Automatic Onboarding** - `musubi-onboard` analyzes existing projects and generates steering docs (2-5 minutes)
 - 🔄 **Auto-Sync** - `musubi-sync` detects codebase changes and keeps steering docs current
@@ -142,6 +143,24 @@ musubi-trace coverage --min-coverage 100        # Require 100% coverage
 musubi-trace gaps                               # Detect orphaned requirements/code
 musubi-trace requirement REQ-AUTH-001           # Trace specific requirement
 musubi-trace validate                           # Validate 100% traceability (Article V)
+
+# Change management for brownfield projects (v0.8.6)
+musubi-change init CHANGE-001 --title "Add authentication"  # Create change proposal
+musubi-change validate CHANGE-001 --verbose     # Validate delta specification
+musubi-change apply CHANGE-001 --dry-run        # Preview changes
+musubi-change apply CHANGE-001                  # Apply changes to codebase
+musubi-change archive CHANGE-001                # Archive to specs/
+musubi-change list --status pending             # List pending changes
+musubi-change list --format json                # List in JSON format
+
+# Gap detection and coverage validation (v0.8.7)
+musubi-gaps detect                              # Detect all gaps
+musubi-gaps detect --verbose                    # Show detailed gap information
+musubi-gaps requirements                        # Detect orphaned requirements
+musubi-gaps code                                # Detect untested code
+musubi-gaps coverage                            # Calculate coverage statistics
+musubi-gaps coverage --min-coverage 100         # Require 100% coverage
+musubi-gaps detect --format markdown > gaps.md  # Export gap report
 ```
 
 ### Project Types

package/bin/musubi-change.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+
+/**
+ * MUSUBI Change Management CLI
+ * 
+ * Manages delta specifications for brownfield projects
+ * Implements ADDED/MODIFIED/REMOVED/RENAMED change tracking
+ * 
+ * Usage:
+ *   musubi-change init <change-id>       # Create change proposal
+ *   musubi-change apply <change-id>      # Apply change to codebase
+ *   musubi-change archive <change-id>    # Archive completed change
+ *   musubi-change list                   # List all changes
+ *   musubi-change validate <change-id>   # Validate delta format
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const ChangeManager = require('../src/managers/change.js');
+
+const program = new Command();
+
+program
+  .name('musubi-change')
+  .description('MUSUBI Change Management - Delta specifications for brownfield projects')
+  .version('0.8.6');
+
+// Initialize change proposal
+program
+  .command('init <change-id>')
+  .description('Create new change proposal with delta specification')
+  .option('-t, --title <title>', 'Change title')
+  .option('-d, --description <description>', 'Change description')
+  .option('--changes <dir>', 'Changes directory', 'storage/changes')
+  .option('--template <path>', 'Custom delta template')
+  .action(async (changeId, options) => {
+    try {
+      const workspaceRoot = process.cwd();
+      const manager = new ChangeManager(workspaceRoot);
+
+      console.log(chalk.blue('📝 Creating change proposal...'));
+      console.log(chalk.dim(`Change ID: ${changeId}`));
+
+      const result = await manager.initChange(changeId, {
+        title: options.title,
+        description: options.description,
+        changesDir: options.changes,
+        template: options.template
+      });
+
+      console.log(chalk.green('✓ Change proposal created successfully'));
+      console.log(chalk.dim(`Location: ${result.file}`));
+      console.log();
+      console.log(chalk.yellow('Next steps:'));
+      console.log(chalk.dim('1. Edit the delta specification'));
+      console.log(chalk.dim(`2. Run: musubi-change validate ${changeId}`));
+      console.log(chalk.dim(`3. Run: musubi-change apply ${changeId}`));
+    } catch (error) {
+      console.error(chalk.red('✗ Failed to create change proposal'));
+      console.error(chalk.dim(error.message));
+      process.exit(1);
+    }
+  });
+
+// Apply change to codebase
+program
+  .command('apply <change-id>')
+  .description('Apply change proposal to codebase')
+  .option('--changes <dir>', 'Changes directory', 'storage/changes')
+  .option('--dry-run', 'Preview changes without applying')
+  .option('--force', 'Force apply even with validation errors')
+  .action(async (changeId, options) => {
+    try {
+      const workspaceRoot = process.cwd();
+      const manager = new ChangeManager(workspaceRoot);
+
+      if (options.dryRun) {
+        console.log(chalk.blue('🔍 Previewing changes (dry run)...'));
+      } else {
+        console.log(chalk.blue('⚙️  Applying changes...'));
+      }
+
+      const result = await manager.applyChange(changeId, {
+        changesDir: options.changes,
+        dryRun: options.dryRun,
+        force: options.force
+      });
+
+      if (options.dryRun) {
+        console.log(chalk.yellow('\nPreview (no changes applied):'));
+        console.log(chalk.green(`  ${result.stats.added} files to be added`));
+        console.log(chalk.blue(`  ${result.stats.modified} files to be modified`));
+        console.log(chalk.red(`  ${result.stats.removed} files to be removed`));
+        console.log(chalk.yellow(`  ${result.stats.renamed} files to be renamed`));
+      } else {
+        console.log(chalk.green('\n✓ Changes applied successfully'));
+        console.log(chalk.green(`  ${result.stats.added} files added`));
+        console.log(chalk.blue(`  ${result.stats.modified} files modified`));
+        console.log(chalk.red(`  ${result.stats.removed} files removed`));
+        console.log(chalk.yellow(`  ${result.stats.renamed} files renamed`));
+        
+        console.log();
+        console.log(chalk.yellow('Next steps:'));
+        console.log(chalk.dim('1. Test the changes'));
+        console.log(chalk.dim(`2. Run: musubi-change archive ${changeId}`));
+      }
+    } catch (error) {
+      console.error(chalk.red('✗ Failed to apply changes'));
+      console.error(chalk.dim(error.message));
+      process.exit(1);
+    }
+  });
+
+// Archive completed change
+program
+  .command('archive <change-id>')
+  .description('Archive completed change to specs/')
+  .option('--changes <dir>', 'Changes directory', 'storage/changes')
+  .option('--specs <dir>', 'Specs archive directory', 'specs')
+  .action(async (changeId, options) => {
+    try {
+      const workspaceRoot = process.cwd();
+      const manager = new ChangeManager(workspaceRoot);
+
+      console.log(chalk.blue('📦 Archiving change...'));
+
+      const result = await manager.archiveChange(changeId, {
+        changesDir: options.changes,
+        specsDir: options.specs
+      });
+
+      console.log(chalk.green('✓ Change archived successfully'));
+      console.log(chalk.dim(`Source: ${result.source}`));
+      console.log(chalk.dim(`Archive: ${result.archive}`));
+      console.log();
+      console.log(chalk.yellow('Delta merged to canonical specification'));
+    } catch (error) {
+      console.error(chalk.red('✗ Failed to archive change'));
+      console.error(chalk.dim(error.message));
+      process.exit(1);
+    }
+  });
+
+// List all changes
+program
+  .command('list')
+  .description('List all change proposals')
+  .option('--changes <dir>', 'Changes directory', 'storage/changes')
+  .option('--status <status>', 'Filter by status (pending|applied|archived)')
+  .option('--format <format>', 'Output format (table|json)', 'table')
+  .action(async (options) => {
+    try {
+      const workspaceRoot = process.cwd();
+      const manager = new ChangeManager(workspaceRoot);
+
+      const changes = await manager.listChanges({
+        changesDir: options.changes,
+        status: options.status
+      });
+
+      if (options.format === 'json') {
+        console.log(JSON.stringify(changes, null, 2));
+        return;
+      }
+
+      // Table format
+      console.log(chalk.bold('\nChange Proposals:\n'));
+      
+      if (changes.length === 0) {
+        console.log(chalk.dim('No changes found'));
+        return;
+      }
+
+      console.log(chalk.dim('ID'.padEnd(20) + 'Title'.padEnd(40) + 'Status'.padEnd(15) + 'Date'));
+      console.log(chalk.dim('-'.repeat(90)));
+
+      changes.forEach(change => {
+        const statusColor = {
+          pending: chalk.yellow,
+          applied: chalk.blue,
+          archived: chalk.green
+        }[change.status] || chalk.white;
+
+        console.log(
+          change.id.padEnd(20) +
+          change.title.padEnd(40) +
+          statusColor(change.status.padEnd(15)) +
+          change.date
+        );
+      });
+
+      console.log();
+      console.log(chalk.dim(`Total: ${changes.length} change(s)`));
+    } catch (error) {
+      console.error(chalk.red('✗ Failed to list changes'));
+      console.error(chalk.dim(error.message));
+      process.exit(1);
+    }
+  });
+
+// Validate delta format
+program
+  .command('validate <change-id>')
+  .description('Validate delta specification format')
+  .option('--changes <dir>', 'Changes directory', 'storage/changes')
+  .option('-v, --verbose', 'Show detailed validation results')
+  .action(async (changeId, options) => {
+    try {
+      const workspaceRoot = process.cwd();
+      const manager = new ChangeManager(workspaceRoot);
+
+      console.log(chalk.blue('🔍 Validating delta specification...'));
+
+      const result = await manager.validateChange(changeId, {
+        changesDir: options.changes,
+        verbose: options.verbose
+      });
+
+      if (result.valid) {
+        console.log(chalk.green('✓ Delta specification is valid'));
+        
+        if (options.verbose) {
+          console.log();
+          console.log(chalk.bold('Summary:'));
+          console.log(chalk.green(`  ${result.stats.added} ADDED items`));
+          console.log(chalk.blue(`  ${result.stats.modified} MODIFIED items`));
+          console.log(chalk.red(`  ${result.stats.removed} REMOVED items`));
+          console.log(chalk.yellow(`  ${result.stats.renamed} RENAMED items`));
+        }
+      } else {
+        console.log(chalk.red('✗ Validation failed'));
+        console.log();
+        
+        result.errors.forEach(error => {
+          console.log(chalk.red(`  • ${error.message}`));
+          if (error.line) {
+            console.log(chalk.dim(`    Line ${error.line}`));
+          }
+        });
+        
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red('✗ Failed to validate change'));
+      console.error(chalk.dim(error.message));
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/bin/musubi-gaps.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+
+/**
+ * MUSUBI Gap Detection CLI
+ * Identifies orphaned requirements, untested code, and missing traceability
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const GapDetector = require('../src/analyzers/gap-detector');
+
+const program = new Command();
+
+program
+  .name('musubi-gaps')
+  .description('Detect gaps in requirements, code, and test coverage')
+  .version('0.8.7');
+
+program
+  .command('detect')
+  .description('Detect all gaps (requirements, code, tests)')
+  .option('--requirements <dir>', 'Requirements directory', 'docs/requirements')
+  .option('--design <dir>', 'Design directory', 'docs/design')
+  .option('--tasks <dir>', 'Tasks directory', 'docs/tasks')
+  .option('--src <dir>', 'Source code directory', 'src')
+  .option('--tests <dir>', 'Test directory', 'tests')
+  .option('--format <format>', 'Output format (table|json|markdown)', 'table')
+  .option('--verbose', 'Show detailed gap information')
+  .action(async (options) => {
+    try {
+      console.log(chalk.blue('\n🔍 Detecting gaps in traceability...\n'));
+      
+      const detector = new GapDetector({
+        requirementsDir: options.requirements,
+        designDir: options.design,
+        tasksDir: options.tasks,
+        srcDir: options.src,
+        testsDir: options.tests
+      });
+
+      const gaps = await detector.detectAllGaps();
+      
+      if (options.format === 'json') {
+        console.log(JSON.stringify(gaps, null, 2));
+      } else if (options.format === 'markdown') {
+        console.log(detector.formatMarkdown(gaps));
+      } else {
+        detector.displayTable(gaps, options.verbose);
+      }
+
+      const totalGaps = gaps.orphanedRequirements.length +
+                        gaps.unimplementedRequirements.length +
+                        gaps.untestedCode.length +
+                        gaps.missingTests.length;
+
+      if (totalGaps === 0) {
+        console.log(chalk.green('\n✓ No gaps detected! 100% traceability achieved.\n'));
+        process.exit(0);
+      } else {
+        console.log(chalk.yellow(`\n⚠ Found ${totalGaps} gap(s). See details above.\n`));
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('requirements')
+  .description('Detect orphaned requirements (no design/code)')
+  .option('--requirements <dir>', 'Requirements directory', 'docs/requirements')
+  .option('--design <dir>', 'Design directory', 'docs/design')
+  .option('--tasks <dir>', 'Tasks directory', 'docs/tasks')
+  .option('--format <format>', 'Output format (table|json|markdown)', 'table')
+  .action(async (options) => {
+    try {
+      console.log(chalk.blue('\n🔍 Detecting orphaned requirements...\n'));
+      
+      const detector = new GapDetector({
+        requirementsDir: options.requirements,
+        designDir: options.design,
+        tasksDir: options.tasks
+      });
+
+      const orphaned = await detector.detectOrphanedRequirements();
+      
+      if (options.format === 'json') {
+        console.log(JSON.stringify(orphaned, null, 2));
+      } else if (options.format === 'markdown') {
+        console.log(detector.formatRequirementsMarkdown(orphaned));
+      } else {
+        detector.displayRequirementsTable(orphaned);
+      }
+
+      if (orphaned.length === 0) {
+        console.log(chalk.green('\n✓ No orphaned requirements detected.\n'));
+        process.exit(0);
+      } else {
+        console.log(chalk.yellow(`\n⚠ Found ${orphaned.length} orphaned requirement(s).\n`));
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('code')
+  .description('Detect untested code')
+  .option('--src <dir>', 'Source code directory', 'src')
+  .option('--tests <dir>', 'Test directory', 'tests')
+  .option('--format <format>', 'Output format (table|json|markdown)', 'table')
+  .action(async (options) => {
+    try {
+      console.log(chalk.blue('\n🔍 Detecting untested code...\n'));
+      
+      const detector = new GapDetector({
+        srcDir: options.src,
+        testsDir: options.tests
+      });
+
+      const untested = await detector.detectUntestedCode();
+      
+      if (options.format === 'json') {
+        console.log(JSON.stringify(untested, null, 2));
+      } else if (options.format === 'markdown') {
+        console.log(detector.formatCodeMarkdown(untested));
+      } else {
+        detector.displayCodeTable(untested);
+      }
+
+      if (untested.length === 0) {
+        console.log(chalk.green('\n✓ All code is tested.\n'));
+        process.exit(0);
+      } else {
+        console.log(chalk.yellow(`\n⚠ Found ${untested.length} untested file(s).\n`));
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('coverage')
+  .description('Calculate coverage statistics')
+  .option('--requirements <dir>', 'Requirements directory', 'docs/requirements')
+  .option('--design <dir>', 'Design directory', 'docs/design')
+  .option('--tasks <dir>', 'Tasks directory', 'docs/tasks')
+  .option('--src <dir>', 'Source code directory', 'src')
+  .option('--tests <dir>', 'Test directory', 'tests')
+  .option('--min-coverage <percent>', 'Minimum required coverage', '100')
+  .option('--format <format>', 'Output format (table|json|markdown)', 'table')
+  .action(async (options) => {
+    try {
+      console.log(chalk.blue('\n📊 Calculating coverage statistics...\n'));
+      
+      const detector = new GapDetector({
+        requirementsDir: options.requirements,
+        designDir: options.design,
+        tasksDir: options.tasks,
+        srcDir: options.src,
+        testsDir: options.tests
+      });
+
+      const coverage = await detector.calculateCoverage();
+      const minCoverage = parseFloat(options.minCoverage);
+      
+      if (options.format === 'json') {
+        console.log(JSON.stringify(coverage, null, 2));
+      } else if (options.format === 'markdown') {
+        console.log(detector.formatCoverageMarkdown(coverage));
+      } else {
+        detector.displayCoverageTable(coverage);
+      }
+
+      const avgCoverage = (
+        coverage.requirements.implementationCoverage +
+        coverage.requirements.testCoverage +
+        coverage.code.testCoverage
+      ) / 3;
+
+      if (avgCoverage >= minCoverage) {
+        console.log(chalk.green(`\n✓ Coverage ${avgCoverage.toFixed(1)}% meets minimum ${minCoverage}%\n`));
+        process.exit(0);
+      } else {
+        console.log(chalk.red(`\n✗ Coverage ${avgCoverage.toFixed(1)}% below minimum ${minCoverage}%\n`));
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red(`\n✗ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubi-sdd",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Ultimate Specification Driven Development Tool with 25 Agents for 7 AI Coding Platforms (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Codex, Qwen Code)",
   "main": "src/index.js",
   "bin": {
@@ -15,7 +15,9 @@
     "musubi-requirements": "bin/musubi-requirements.js",
     "musubi-design": "bin/musubi-design.js",
     "musubi-tasks": "bin/musubi-tasks.js",
-    "musubi-trace": "bin/musubi-trace.js"
+    "musubi-trace": "bin/musubi-trace.js",
+    "musubi-gaps": "bin/musubi-gaps.js",
+    "musubi-change": "bin/musubi-change.js"
   },
   "scripts": {
     "test": "jest",