musubi-sdd 0.8.5 → 0.8.6

package/README.ja.md

@@ -15,7 +15,7 @@ MUSUBIは、6つの主要フレームワークのベスト機能を統合した
 - 📋 **憲法ガバナンス** - 9つの不変条項 + フェーズ-1ゲートによる品質保証
 - 📝 **EARS要件ジェネレーター** - 5つのEARSパターンで明確な要件を作成（v0.8.0）
 - 🏗️ **設計ドキュメントジェネレーター** - トレーサビリティ付きC4モデルとADRを作成（v0.8.2）
-- 🔄 **差分仕様** - ブラウンフィールドおよびグリーンフィールドプロジェクト対応
+- 🔄 **変更管理システム** - ブラウンフィールドプロジェクト向け差分仕様（v0.8.6）
 - 🧭 **自動更新プロジェクトメモリ** - ステアリングシステムがアーキテクチャ、技術スタック、製品コンテキストを維持
 - 🚀 **自動オンボーディング** - `musubi-onboard` が既存プロジェクトを分析し、ステアリングドキュメントを生成（2-5分）
 - 🔄 **自動同期** - `musubi-sync` がコードベースの変更を検出し、ステアリングドキュメントを最新に保つ
@@ -138,6 +138,15 @@ 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形式でリスト
 ```
 
 ### プロジェクトタイプ

package/README.md

@@ -19,7 +19,7 @@ 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)
 - 🧭 **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 +142,15 @@ 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
 ```
 
 ### 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubi-sdd",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "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,8 @@
     "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-change": "bin/musubi-change.js"
   },
   "scripts": {
     "test": "jest",

package/src/managers/change.js

@@ -0,0 +1,476 @@
+/**
+ * MUSUBI Change Manager
+ * 
+ * Manages delta specifications for brownfield projects
+ * Implements ADDED/MODIFIED/REMOVED/RENAMED change tracking
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const glob = require('glob');
+
+class ChangeManager {
+  constructor(workspaceRoot) {
+    this.workspaceRoot = workspaceRoot;
+  }
+
+  /**
+   * Initialize new change proposal
+   */
+  async initChange(changeId, options = {}) {
+    const changesDir = path.join(this.workspaceRoot, options.changesDir || 'storage/changes');
+    const changeFile = path.join(changesDir, `${changeId}.md`);
+
+    // Check if change already exists
+    if (await fs.pathExists(changeFile)) {
+      throw new Error(`Change ${changeId} already exists`);
+    }
+
+    // Create changes directory if it doesn't exist
+    await fs.mkdirp(changesDir);
+
+    // Load template
+    const template = await this.loadTemplate(options.template);
+
+    // Create change document
+    const content = this.renderTemplate(template, {
+      changeId,
+      title: options.title || 'New Change',
+      description: options.description || 'Description of the change',
+      date: new Date().toISOString().split('T')[0]
+    });
+
+    await fs.writeFile(changeFile, content, 'utf-8');
+
+    return {
+      file: changeFile,
+      changeId
+    };
+  }
+
+  /**
+   * Apply change to codebase
+   */
+  async applyChange(changeId, options = {}) {
+    const changesDir = path.join(this.workspaceRoot, options.changesDir || 'storage/changes');
+    const changeFile = path.join(changesDir, `${changeId}.md`);
+
+    // Check if change exists
+    if (!await fs.pathExists(changeFile)) {
+      throw new Error(`Change ${changeId} not found`);
+    }
+
+    // Parse delta specification
+    const delta = await this.parseDelta(changeFile);
+
+    // Validate if not force
+    if (!options.force) {
+      const validation = await this.validateDelta(delta);
+      if (!validation.valid) {
+        throw new Error(`Validation failed: ${validation.errors.map(e => e.message).join(', ')}`);
+      }
+    }
+
+    const stats = {
+      added: 0,
+      modified: 0,
+      removed: 0,
+      renamed: 0
+    };
+
+    if (!options.dryRun) {
+      // Apply ADDED items
+      for (const item of delta.added) {
+        await this.applyAdded(item);
+        stats.added++;
+      }
+
+      // Apply MODIFIED items
+      for (const item of delta.modified) {
+        await this.applyModified(item);
+        stats.modified++;
+      }
+
+      // Apply REMOVED items
+      for (const item of delta.removed) {
+        await this.applyRemoved(item);
+        stats.removed++;
+      }
+
+      // Apply RENAMED items
+      for (const item of delta.renamed) {
+        await this.applyRenamed(item);
+        stats.renamed++;
+      }
+    } else {
+      // Dry run - just count
+      stats.added = delta.added.length;
+      stats.modified = delta.modified.length;
+      stats.removed = delta.removed.length;
+      stats.renamed = delta.renamed.length;
+    }
+
+    return { stats };
+  }
+
+  /**
+   * Archive completed change
+   */
+  async archiveChange(changeId, options = {}) {
+    const changesDir = path.join(this.workspaceRoot, options.changesDir || 'storage/changes');
+    const specsDir = path.join(this.workspaceRoot, options.specsDir || 'specs');
+    const sourceFile = path.join(changesDir, `${changeId}.md`);
+    const archiveFile = path.join(specsDir, 'changes', `${changeId}.md`);
+
+    // Check if change exists
+    if (!await fs.pathExists(sourceFile)) {
+      throw new Error(`Change ${changeId} not found`);
+    }
+
+    // Create specs/changes directory
+    await fs.mkdirp(path.dirname(archiveFile));
+
+    // Parse delta and merge to canonical specs
+    const delta = await this.parseDelta(sourceFile);
+    await this.mergeDeltaToSpecs(delta, specsDir);
+
+    // Move change file to archive
+    await fs.move(sourceFile, archiveFile, { overwrite: true });
+
+    return {
+      source: sourceFile,
+      archive: archiveFile
+    };
+  }
+
+  /**
+   * List all changes
+   */
+  async listChanges(options = {}) {
+    const changesDir = path.join(this.workspaceRoot, options.changesDir || 'storage/changes');
+    
+    if (!await fs.pathExists(changesDir)) {
+      return [];
+    }
+
+    const files = glob.sync('*.md', { cwd: changesDir, absolute: true });
+    const changes = [];
+
+    for (const file of files) {
+      const content = await fs.readFile(file, 'utf-8');
+      const changeId = path.basename(file, '.md');
+      
+      // Extract title and date
+      const titleMatch = content.match(/# (.+)/);
+      const dateMatch = content.match(/\*\*Date\*\*: (.+)/);
+      
+      // Determine status (simplified - could be more sophisticated)
+      const status = 'pending'; // In real implementation, track applied/archived status
+
+      changes.push({
+        id: changeId,
+        title: titleMatch ? titleMatch[1] : changeId,
+        date: dateMatch ? dateMatch[1] : 'Unknown',
+        status,
+        file: path.relative(this.workspaceRoot, file)
+      });
+    }
+
+    // Filter by status if specified
+    if (options.status) {
+      return changes.filter(c => c.status === options.status);
+    }
+
+    // Sort by ID for consistent ordering
+    return changes.sort((a, b) => a.id.localeCompare(b.id));
+  }
+
+  /**
+   * Validate delta specification
+   */
+  async validateChange(changeId, options = {}) {
+    const changesDir = path.join(this.workspaceRoot, options.changesDir || 'storage/changes');
+    const changeFile = path.join(changesDir, `${changeId}.md`);
+
+    // Check if change exists
+    if (!await fs.pathExists(changeFile)) {
+      throw new Error(`Change ${changeId} not found`);
+    }
+
+    // Parse delta
+    const delta = await this.parseDelta(changeFile);
+
+    // Validate
+    const validation = await this.validateDelta(delta);
+
+    return {
+      valid: validation.valid,
+      errors: validation.errors,
+      stats: {
+        added: delta.added.length,
+        modified: delta.modified.length,
+        removed: delta.removed.length,
+        renamed: delta.renamed.length
+      }
+    };
+  }
+
+  /**
+   * Load template
+   */
+  async loadTemplate(customTemplate) {
+    if (customTemplate && await fs.pathExists(customTemplate)) {
+      return fs.readFile(customTemplate, 'utf-8');
+    }
+
+    // Default template
+    return `# {{title}}
+
+**Change ID**: {{changeId}}  
+**Date**: {{date}}  
+**Status**: Pending
+
+## Description
+
+{{description}}
+
+## Requirements Changes
+
+### ADDED
+
+<!-- List new requirements here -->
+
+### MODIFIED
+
+<!-- List modified requirements here -->
+
+### REMOVED
+
+<!-- List removed requirements here -->
+
+### RENAMED
+
+<!-- List renamed requirements here -->
+
+## Design Changes
+
+### ADDED
+
+<!-- List new design elements -->
+
+### MODIFIED
+
+<!-- List modified design elements -->
+
+### REMOVED
+
+<!-- List removed design elements -->
+
+## Code Changes
+
+### ADDED
+
+<!-- List new files/modules -->
+
+### MODIFIED
+
+<!-- List modified files/modules -->
+
+### REMOVED
+
+<!-- List removed files/modules -->
+
+### RENAMED
+
+<!-- List renamed files/modules -->
+
+## Impact Analysis
+
+### Affected Components
+
+- [Component 1]
+- [Component 2]
+
+### Breaking Changes
+
+- [ ] No breaking changes
+- [ ] Breaking changes (list below)
+
+### Migration Steps
+
+1. [Migration step 1]
+2. [Migration step 2]
+
+## Testing
+
+### Test Changes
+
+- [ ] Unit tests updated
+- [ ] Integration tests updated
+- [ ] E2E tests updated
+
+### Test Coverage
+
+- Current coverage: XX%
+- Target coverage: XX%
+
+## Traceability
+
+### Requirements → Design → Code → Tests
+
+- REQ-XXX-001 → Design-A → Module-B → Test-C
+
+## Approval
+
+- [ ] Technical review complete
+- [ ] Product review complete
+- [ ] Security review complete (if needed)
+- [ ] Ready to apply
+`;
+  }
+
+  /**
+   * Render template with data
+   */
+  renderTemplate(template, data) {
+    let result = template;
+    for (const [key, value] of Object.entries(data)) {
+      result = result.replace(new RegExp(`{{${key}}}`, 'g'), value);
+    }
+    return result;
+  }
+
+  /**
+   * Parse delta specification
+   */
+  async parseDelta(deltaFile) {
+    const content = await fs.readFile(deltaFile, 'utf-8');
+
+    const delta = {
+      added: [],
+      modified: [],
+      removed: [],
+      renamed: []
+    };
+
+    // Simple parser - extract items under each section
+    const sections = ['ADDED', 'MODIFIED', 'REMOVED', 'RENAMED'];
+    
+    for (const section of sections) {
+      const sectionRegex = new RegExp(`### ${section}\\s+([\\s\\S]*?)(?=###|$)`, 'g');
+      const matches = content.matchAll(sectionRegex);
+
+      for (const match of matches) {
+        const sectionContent = match[1];
+        const items = this.parseItems(sectionContent);
+        delta[section.toLowerCase()].push(...items);
+      }
+    }
+
+    return delta;
+  }
+
+  /**
+   * Parse items from section content
+   */
+  parseItems(content) {
+    const items = [];
+    const lines = content.split('\n');
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      // Skip empty lines and HTML comments
+      if (!trimmed || trimmed.startsWith('<!--') || trimmed.startsWith('##')) {
+        continue;
+      }
+      
+      if (trimmed.startsWith('- REQ-')) {
+        // Extract requirement ID and title
+        const match = trimmed.match(/- (REQ-[A-Z0-9]+-\d{3}):?\s*(.+)?/);
+        if (match) {
+          items.push({
+            id: match[1],
+            title: match[2] || '',
+            line: trimmed
+          });
+        }
+      }
+    }
+
+    return items;
+  }
+
+  /**
+   * Validate delta specification
+   */
+  async validateDelta(delta) {
+    const errors = [];
+
+    // Check for valid REQ IDs
+    const allItems = [
+      ...delta.added,
+      ...delta.modified,
+      ...delta.removed,
+      ...delta.renamed
+    ];
+
+    for (const item of allItems) {
+      if (!item.id || !item.id.match(/^REQ-[A-Z0-9]+-\d{3}$/)) {
+        errors.push({
+          message: `Invalid requirement ID: ${item.id}`,
+          line: item.line
+        });
+      }
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+
+  /**
+   * Apply ADDED item
+   */
+  async applyAdded(item) {
+    // In real implementation, this would create new requirement/design/code
+    // For now, just a placeholder
+    return item;
+  }
+
+  /**
+   * Apply MODIFIED item
+   */
+  async applyModified(item) {
+    // In real implementation, this would update existing requirement/design/code
+    return item;
+  }
+
+  /**
+   * Apply REMOVED item
+   */
+  async applyRemoved(item) {
+    // In real implementation, this would remove requirement/design/code
+    return item;
+  }
+
+  /**
+   * Apply RENAMED item
+   */
+  async applyRenamed(item) {
+    // In real implementation, this would rename requirement/design/code
+    return item;
+  }
+
+  /**
+   * Merge delta to canonical specs
+   */
+  async mergeDeltaToSpecs(delta, specsDir) {
+    // In real implementation, this would merge changes to canonical specs
+    // For now, just ensure specs directory exists
+    await fs.mkdirp(specsDir);
+    return delta;
+  }
+}
+
+module.exports = ChangeManager;