musubi-sdd 0.8.6 → 0.8.8

package/README.ja.md

@@ -16,6 +16,7 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
 - 📝 **EARS要件ジェネレーター** - 5つのEARSパターンで明確な要件を作成（v0.8.0）
 - 🏗️ **設計ドキュメントジェネレーター** - トレーサビリティ付きC4モデルとADRを作成（v0.8.2）
 - 🔄 **変更管理システム** - ブラウンフィールドプロジェクト向け差分仕様（v0.8.6）
+- 🔍 **ギャップ検出システム** - 孤立した要件とテストされていないコードを特定（v0.8.7）
 - 🧭 **自動更新プロジェクトメモリ** - ステアリングシステムがアーキテクチャ、技術スタック、製品コンテキストを維持
 - 🚀 **自動オンボーディング** - `musubi-onboard` が既存プロジェクトを分析し、ステアリングドキュメントを生成（2-5分）
 - 🔄 **自動同期** - `musubi-sync` がコードベースの変更を検出し、ステアリングドキュメントを最新に保つ
@@ -147,6 +148,15 @@ 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  # ギャップレポートをエクスポート
 ```
 
 ### プロジェクトタイプ
@@ -198,6 +208,16 @@ musubi-change list --format json                # JSON形式でリスト
   - 成熟度が異なるマルチコンポーネントシステム
 - **有効化される機能**:
   - すべてのGreenfield + Brownfield機能
+
+## ドキュメント
+
+包括的なガイドは `docs/guides/` で利用可能です:
+
+- **[ブラウンフィールドチュートリアル](docs/guides/brownfield-tutorial.md)** - 既存プロジェクトでの変更管理ステップバイステップガイド
+- **[差分仕様ガイド](docs/guides/delta-spec-guide.md)** - 変更追跡のフォーマットリファレンス
+- **[変更管理ワークフロー](docs/guides/change-management-workflow.md)** - エンドツーエンドワークフロードキュメント
+- **[トレーサビリティマトリクスガイド](docs/guides/traceability-matrix-guide.md)** - トレーサビリティシステム使用方法
+- **[ビデオチュートリアル計画](docs/guides/video-tutorial-plan.md)** - ビデオコンテンツスクリプト
   - コンポーネントごとにワークフローを選択する柔軟性
   - 同一プロジェクト内で差分仕様とグリーンフィールド仕様を混在
 - **メリット**:

package/README.md

@@ -20,6 +20,7 @@ MUSUBI is a comprehensive SDD (Specification Driven Development) framework that
 - 📝 **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)
 - 🔄 **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
@@ -151,8 +152,27 @@ 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
 ```
 
+## Documentation
+
+Comprehensive guides are available in `docs/guides/`:
+
+- **[Brownfield Tutorial](docs/guides/brownfield-tutorial.md)** - Step-by-step guide for managing changes in existing projects
+- **[Delta Specification Guide](docs/guides/delta-spec-guide.md)** - Format reference for change tracking
+- **[Change Management Workflow](docs/guides/change-management-workflow.md)** - End-to-end workflow documentation
+- **[Traceability Matrix Guide](docs/guides/traceability-matrix-guide.md)** - Traceability system usage
+- **[Video Tutorial Plan](docs/guides/video-tutorial-plan.md)** - Video content script
+
 ### Project Types
 
 During initialization, MUSUBI asks you to select a **Project Type**. This determines the workflow and features available:

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.6",
+  "version": "0.8.8",
   "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": {
@@ -16,6 +16,7 @@
     "musubi-design": "bin/musubi-design.js",
     "musubi-tasks": "bin/musubi-tasks.js",
     "musubi-trace": "bin/musubi-trace.js",
+    "musubi-gaps": "bin/musubi-gaps.js",
     "musubi-change": "bin/musubi-change.js"
   },
   "scripts": {

package/src/analyzers/gap-detector.js

@@ -0,0 +1,508 @@
+const fs = require('fs-extra');
+const path = require('path');
+const glob = require('glob');
+const chalk = require('chalk');
+
+/**
+ * Gap Detector - Identifies orphaned requirements, untested code, and missing traceability
+ */
+class GapDetector {
+  constructor(options = {}) {
+    this.requirementsDir = options.requirementsDir || 'docs/requirements';
+    this.designDir = options.designDir || 'docs/design';
+    this.tasksDir = options.tasksDir || 'docs/tasks';
+    this.srcDir = options.srcDir || 'src';
+    this.testsDir = options.testsDir || 'tests';
+  }
+
+  /**
+   * Detect all gaps (requirements, code, tests)
+   */
+  async detectAllGaps() {
+    const orphanedRequirements = await this.detectOrphanedRequirements();
+    const unimplementedRequirements = await this.detectUnimplementedRequirements();
+    const untestedCode = await this.detectUntestedCode();
+    const missingTests = await this.detectMissingTests();
+
+    return {
+      orphanedRequirements,
+      unimplementedRequirements,
+      untestedCode,
+      missingTests,
+      summary: {
+        total: orphanedRequirements.length + unimplementedRequirements.length + 
+               untestedCode.length + missingTests.length,
+        orphanedRequirements: orphanedRequirements.length,
+        unimplementedRequirements: unimplementedRequirements.length,
+        untestedCode: untestedCode.length,
+        missingTests: missingTests.length
+      }
+    };
+  }
+
+  /**
+   * Detect orphaned requirements (no design/task references)
+   */
+  async detectOrphanedRequirements() {
+    const requirements = await this.extractRequirements();
+    const designRefs = await this.extractDesignReferences();
+    const taskRefs = await this.extractTaskReferences();
+
+    const orphaned = [];
+    for (const req of requirements) {
+      const hasDesign = designRefs.some(ref => ref === req.id);
+      const hasTask = taskRefs.some(ref => ref === req.id);
+      
+      if (!hasDesign && !hasTask) {
+        orphaned.push({
+          id: req.id,
+          title: req.title,
+          file: req.file,
+          reason: 'No design or task references found'
+        });
+      }
+    }
+
+    return orphaned;
+  }
+
+  /**
+   * Detect unimplemented requirements (no code references)
+   */
+  async detectUnimplementedRequirements() {
+    const requirements = await this.extractRequirements();
+    const codeRefs = await this.extractCodeReferences();
+
+    const unimplemented = [];
+    for (const req of requirements) {
+      const hasCode = codeRefs.some(ref => ref === req.id);
+      
+      if (!hasCode) {
+        unimplemented.push({
+          id: req.id,
+          title: req.title,
+          file: req.file,
+          reason: 'No code implementation found'
+        });
+      }
+    }
+
+    return unimplemented;
+  }
+
+  /**
+   * Detect untested code (no test files)
+   */
+  async detectUntestedCode() {
+    const srcFiles = await this.getSourceFiles();
+    const testFiles = await this.getTestFiles();
+
+    const untested = [];
+    for (const srcFile of srcFiles) {
+      const baseName = path.basename(srcFile, path.extname(srcFile));
+      const hasTest = testFiles.some(testFile => {
+        const testBaseName = path.basename(testFile, path.extname(testFile));
+        return testBaseName.includes(baseName) || testBaseName.replace('.test', '') === baseName;
+      });
+
+      if (!hasTest) {
+        untested.push({
+          file: srcFile,
+          reason: 'No corresponding test file found'
+        });
+      }
+    }
+
+    return untested;
+  }
+
+  /**
+   * Detect missing tests (requirements without test coverage)
+   */
+  async detectMissingTests() {
+    const requirements = await this.extractRequirements();
+    const testRefs = await this.extractTestReferences();
+
+    const missing = [];
+    for (const req of requirements) {
+      const hasTest = testRefs.some(ref => ref === req.id);
+      
+      if (!hasTest) {
+        missing.push({
+          id: req.id,
+          title: req.title,
+          file: req.file,
+          reason: 'No test coverage found'
+        });
+      }
+    }
+
+    return missing;
+  }
+
+  /**
+   * Calculate coverage statistics
+   */
+  async calculateCoverage() {
+    const requirements = await this.extractRequirements();
+    const designRefs = await this.extractDesignReferences();
+    const taskRefs = await this.extractTaskReferences();
+    const codeRefs = await this.extractCodeReferences();
+    const testRefs = await this.extractTestReferences();
+    const srcFiles = await this.getSourceFiles();
+    const testFiles = await this.getTestFiles();
+
+    const totalReqs = requirements.length;
+    const withDesign = requirements.filter(req => 
+      designRefs.some(ref => ref === req.id)
+    ).length;
+    const withTasks = requirements.filter(req => 
+      taskRefs.some(ref => ref === req.id)
+    ).length;
+    const withCode = requirements.filter(req => 
+      codeRefs.some(ref => ref === req.id)
+    ).length;
+    const withTests = requirements.filter(req => 
+      testRefs.some(ref => ref === req.id)
+    ).length;
+
+    const totalSrc = srcFiles.length;
+    const testedSrc = srcFiles.filter(srcFile => {
+      const baseName = path.basename(srcFile, path.extname(srcFile));
+      return testFiles.some(testFile => {
+        const testBaseName = path.basename(testFile, path.extname(testFile));
+        return testBaseName.includes(baseName) || testBaseName.replace('.test', '') === baseName;
+      });
+    }).length;
+
+    return {
+      requirements: {
+        total: totalReqs,
+        withDesign,
+        withTasks,
+        withCode,
+        withTests,
+        designCoverage: totalReqs > 0 ? (withDesign / totalReqs) * 100 : 100,
+        taskCoverage: totalReqs > 0 ? (withTasks / totalReqs) * 100 : 100,
+        implementationCoverage: totalReqs > 0 ? (withCode / totalReqs) * 100 : 100,
+        testCoverage: totalReqs > 0 ? (withTests / totalReqs) * 100 : 100
+      },
+      code: {
+        total: totalSrc,
+        tested: testedSrc,
+        untested: totalSrc - testedSrc,
+        testCoverage: totalSrc > 0 ? (testedSrc / totalSrc) * 100 : 100
+      }
+    };
+  }
+
+  /**
+   * Extract requirements from requirements directory
+   */
+  async extractRequirements() {
+    if (!await fs.pathExists(this.requirementsDir)) {
+      return [];
+    }
+
+    const files = glob.sync(`${this.requirementsDir}/**/*.md`);
+    const requirements = [];
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const matches = content.matchAll(/^##\s+(REQ-[A-Z]+-\d+):\s+(.+)$/gm);
+      
+      for (const match of matches) {
+        requirements.push({
+          id: match[1],
+          title: match[2],
+          file: path.relative(process.cwd(), file)
+        });
+      }
+    }
+
+    return requirements;
+  }
+
+  /**
+   * Extract design references from design directory
+   */
+  async extractDesignReferences() {
+    if (!await fs.pathExists(this.designDir)) {
+      return [];
+    }
+
+    const files = glob.sync(`${this.designDir}/**/*.md`);
+    const references = new Set();
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const matches = content.matchAll(/REQ-[A-Z]+-\d+/g);
+      
+      for (const match of matches) {
+        references.add(match[0]);
+      }
+    }
+
+    return Array.from(references);
+  }
+
+  /**
+   * Extract task references from tasks directory
+   */
+  async extractTaskReferences() {
+    if (!await fs.pathExists(this.tasksDir)) {
+      return [];
+    }
+
+    const files = glob.sync(`${this.tasksDir}/**/*.md`);
+    const references = new Set();
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const matches = content.matchAll(/REQ-[A-Z]+-\d+/g);
+      
+      for (const match of matches) {
+        references.add(match[0]);
+      }
+    }
+
+    return Array.from(references);
+  }
+
+  /**
+   * Extract code references from source directory
+   */
+  async extractCodeReferences() {
+    if (!await fs.pathExists(this.srcDir)) {
+      return [];
+    }
+
+    const files = glob.sync(`${this.srcDir}/**/*.{js,ts,jsx,tsx,py,java,go,rb}`);
+    const references = new Set();
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const matches = content.matchAll(/REQ-[A-Z]+-\d+/g);
+      
+      for (const match of matches) {
+        references.add(match[0]);
+      }
+    }
+
+    return Array.from(references);
+  }
+
+  /**
+   * Extract test references from tests directory
+   */
+  async extractTestReferences() {
+    if (!await fs.pathExists(this.testsDir)) {
+      return [];
+    }
+
+    const files = glob.sync(`${this.testsDir}/**/*.{test,spec}.{js,ts,jsx,tsx,py,java,go,rb}`);
+    const references = new Set();
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const matches = content.matchAll(/REQ-[A-Z]+-\d+/g);
+      
+      for (const match of matches) {
+        references.add(match[0]);
+      }
+    }
+
+    return Array.from(references);
+  }
+
+  /**
+   * Get source files
+   */
+  async getSourceFiles() {
+    if (!await fs.pathExists(this.srcDir)) {
+      return [];
+    }
+
+    return glob.sync(`${this.srcDir}/**/*.{js,ts,jsx,tsx}`, {
+      ignore: ['**/*.test.*', '**/*.spec.*', '**/node_modules/**']
+    });
+  }
+
+  /**
+   * Get test files
+   */
+  async getTestFiles() {
+    if (!await fs.pathExists(this.testsDir)) {
+      return [];
+    }
+
+    return glob.sync(`${this.testsDir}/**/*.{test,spec}.{js,ts,jsx,tsx}`);
+  }
+
+  /**
+   * Display gaps in table format
+   */
+  displayTable(gaps, verbose = false) {
+    console.log(chalk.bold('\n📊 Gap Detection Summary\n'));
+    console.log(`Total Gaps: ${chalk.yellow(gaps.summary.total)}`);
+    console.log(`  Orphaned Requirements: ${chalk.yellow(gaps.summary.orphanedRequirements)}`);
+    console.log(`  Unimplemented Requirements: ${chalk.yellow(gaps.summary.unimplementedRequirements)}`);
+    console.log(`  Untested Code: ${chalk.yellow(gaps.summary.untestedCode)}`);
+    console.log(`  Missing Tests: ${chalk.yellow(gaps.summary.missingTests)}`);
+
+    if (verbose && gaps.orphanedRequirements.length > 0) {
+      console.log(chalk.bold('\n🔴 Orphaned Requirements:\n'));
+      gaps.orphanedRequirements.forEach(req => {
+        console.log(`  ${chalk.red(req.id)}: ${req.title}`);
+        console.log(`    File: ${req.file}`);
+        console.log(`    Reason: ${req.reason}\n`);
+      });
+    }
+
+    if (verbose && gaps.untestedCode.length > 0) {
+      console.log(chalk.bold('\n🔴 Untested Code:\n'));
+      gaps.untestedCode.forEach(item => {
+        console.log(`  ${chalk.red(item.file)}`);
+        console.log(`    Reason: ${item.reason}\n`);
+      });
+    }
+  }
+
+  /**
+   * Display requirements table
+   */
+  displayRequirementsTable(orphaned) {
+    if (orphaned.length === 0) {
+      console.log(chalk.green('No orphaned requirements found.'));
+      return;
+    }
+
+    console.log(chalk.bold('\n🔴 Orphaned Requirements:\n'));
+    orphaned.forEach(req => {
+      console.log(`  ${chalk.red(req.id)}: ${req.title}`);
+      console.log(`    File: ${req.file}`);
+      console.log(`    Reason: ${req.reason}\n`);
+    });
+  }
+
+  /**
+   * Display code table
+   */
+  displayCodeTable(untested) {
+    if (untested.length === 0) {
+      console.log(chalk.green('All code is tested.'));
+      return;
+    }
+
+    console.log(chalk.bold('\n🔴 Untested Code:\n'));
+    untested.forEach(item => {
+      console.log(`  ${chalk.red(item.file)}`);
+      console.log(`    Reason: ${item.reason}\n`);
+    });
+  }
+
+  /**
+   * Display coverage table
+   */
+  displayCoverageTable(coverage) {
+    console.log(chalk.bold('\n📊 Coverage Statistics\n'));
+    
+    console.log(chalk.bold('Requirements Coverage:'));
+    console.log(`  Total Requirements: ${coverage.requirements.total}`);
+    console.log(`  With Design: ${coverage.requirements.withDesign} (${coverage.requirements.designCoverage.toFixed(1)}%)`);
+    console.log(`  With Tasks: ${coverage.requirements.withTasks} (${coverage.requirements.taskCoverage.toFixed(1)}%)`);
+    console.log(`  With Code: ${coverage.requirements.withCode} (${coverage.requirements.implementationCoverage.toFixed(1)}%)`);
+    console.log(`  With Tests: ${coverage.requirements.withTests} (${coverage.requirements.testCoverage.toFixed(1)}%)`);
+    
+    console.log(chalk.bold('\nCode Coverage:'));
+    console.log(`  Total Source Files: ${coverage.code.total}`);
+    console.log(`  Tested: ${coverage.code.tested} (${coverage.code.testCoverage.toFixed(1)}%)`);
+    console.log(`  Untested: ${coverage.code.untested}`);
+  }
+
+  /**
+   * Format gaps as markdown
+   */
+  formatMarkdown(gaps) {
+    let md = '# Gap Detection Report\n\n';
+    md += '## Summary\n\n';
+    md += `- **Total Gaps**: ${gaps.summary.total}\n`;
+    md += `- **Orphaned Requirements**: ${gaps.summary.orphanedRequirements}\n`;
+    md += `- **Unimplemented Requirements**: ${gaps.summary.unimplementedRequirements}\n`;
+    md += `- **Untested Code**: ${gaps.summary.untestedCode}\n`;
+    md += `- **Missing Tests**: ${gaps.summary.missingTests}\n\n`;
+
+    if (gaps.orphanedRequirements.length > 0) {
+      md += '## Orphaned Requirements\n\n';
+      gaps.orphanedRequirements.forEach(req => {
+        md += `### ${req.id}: ${req.title}\n\n`;
+        md += `- **File**: ${req.file}\n`;
+        md += `- **Reason**: ${req.reason}\n\n`;
+      });
+    }
+
+    if (gaps.untestedCode.length > 0) {
+      md += '## Untested Code\n\n';
+      gaps.untestedCode.forEach(item => {
+        md += `### ${item.file}\n\n`;
+        md += `- **Reason**: ${item.reason}\n\n`;
+      });
+    }
+
+    return md;
+  }
+
+  /**
+   * Format requirements as markdown
+   */
+  formatRequirementsMarkdown(orphaned) {
+    let md = '# Orphaned Requirements Report\n\n';
+    md += `**Total**: ${orphaned.length}\n\n`;
+
+    orphaned.forEach(req => {
+      md += `## ${req.id}: ${req.title}\n\n`;
+      md += `- **File**: ${req.file}\n`;
+      md += `- **Reason**: ${req.reason}\n\n`;
+    });
+
+    return md;
+  }
+
+  /**
+   * Format code as markdown
+   */
+  formatCodeMarkdown(untested) {
+    let md = '# Untested Code Report\n\n';
+    md += `**Total**: ${untested.length}\n\n`;
+
+    untested.forEach(item => {
+      md += `## ${item.file}\n\n`;
+      md += `- **Reason**: ${item.reason}\n\n`;
+    });
+
+    return md;
+  }
+
+  /**
+   * Format coverage as markdown
+   */
+  formatCoverageMarkdown(coverage) {
+    let md = '# Coverage Report\n\n';
+    
+    md += '## Requirements Coverage\n\n';
+    md += `- **Total Requirements**: ${coverage.requirements.total}\n`;
+    md += `- **With Design**: ${coverage.requirements.withDesign} (${coverage.requirements.designCoverage.toFixed(1)}%)\n`;
+    md += `- **With Tasks**: ${coverage.requirements.withTasks} (${coverage.requirements.taskCoverage.toFixed(1)}%)\n`;
+    md += `- **With Code**: ${coverage.requirements.withCode} (${coverage.requirements.implementationCoverage.toFixed(1)}%)\n`;
+    md += `- **With Tests**: ${coverage.requirements.withTests} (${coverage.requirements.testCoverage.toFixed(1)}%)\n\n`;
+    
+    md += '## Code Coverage\n\n';
+    md += `- **Total Source Files**: ${coverage.code.total}\n`;
+    md += `- **Tested**: ${coverage.code.tested} (${coverage.code.testCoverage.toFixed(1)}%)\n`;
+    md += `- **Untested**: ${coverage.code.untested}\n`;
+    
+    return md;
+  }
+}
+
+module.exports = GapDetector;