musubi-sdd 5.7.2 → 5.9.0

package/README.ja.md

@@ -71,6 +71,80 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
+## 📊 v5.9.0 の新機能
+
+### Phase 1-4 エンタープライズ機能 🏢
+
+大規模プロジェクトとモノレポ対応のエンタープライズ機能を大幅追加。
+
+#### ワークフロー柔軟性（Phase 1）
+
+- **3つのワークフローモード**: `small`（バグ修正）、`medium`（機能追加）、`large`（設計変更）
+- **自動検出**: フィーチャー名パターンからモード自動選択
+- **`musubi-release`**: CHANGELOG自動生成付きリリースCLI
+
+```bash
+# コミットからCHANGELOGを生成
+musubi-release
+
+# フィーチャーのモードを検出
+musubi-workflow mode --detect "feat: ユーザー認証"
+```
+
+#### モノレポ対応（Phase 2）
+
+- **パッケージレジストリ**: `steering/packages.yml` で依存関係管理
+- **依存関係グラフ**: Mermaidダイアグラム生成で可視化
+- **カバレッジ追跡**: パッケージ別テストカバレッジレポート
+
+#### 憲法レベル管理（Phase 3）
+
+- **3つの適用レベル**: `critical`（ブロック）、`advisory`（警告）、`flexible`（提案）
+- **レベル別検証**: 条項の重要度に応じた異なる適用
+- **プロジェクト別オーバーライド**: プロジェクトタイプ別カスタムレベル
+
+| レベル | 条項 | 動作 |
+|--------|------|------|
+| Critical | CONST-001, 002, 003, 005, 009 | ワークフローをブロック |
+| Advisory | CONST-004, 006, 007 | 警告のみ |
+| Flexible | CONST-008 | 提案として表示 |
+
+#### プロジェクト設定（Phase 4）
+
+- **`musubi-config`**: 設定管理用新CLI
+- **スキーマ検証**: AJVによるv2.0スキーマ検証
+- **自動マイグレーション**: v1.0設定をv2.0に自動アップグレード
+
+```bash
+musubi-config validate  # project.yml を検証
+musubi-config migrate   # v2.0 にマイグレーション
+musubi-config show      # 有効な設定を表示
+```
+
+#### オーケストレーター統合
+
+プログラムアクセス用の5つの組み込みスキル：
+
+| スキル | カテゴリ | 用途 |
+|--------|----------|------|
+| `release-manager` | release | CHANGELOG生成 |
+| `workflow-mode-manager` | workflow | モード検出・管理 |
+| `package-manager` | configuration | パッケージ・依存関係分析 |
+| `constitution-level-manager` | validation | レベル別検証 |
+| `project-config-manager` | configuration | 設定検証・マイグレーション |
+
+```javascript
+const { workflowModeSkill } = require('musubi-sdd/src/orchestration');
+
+const result = await workflowModeSkill.execute({
+  action: 'detect',
+  featureName: 'fix: 軽微なバグ'
+});
+console.log(result.detectedMode); // 'small'
+```
+
+---
+
 ## 📊 v5.6.0 の新機能
 
 ### エンタープライズスケール分析 & Rustマイグレーション支援 🏢🦀

package/README.md

@@ -71,6 +71,135 @@ musubi init --windsurf  # Windsurf IDE
 
 ---
 
+## 📊 What's New in v5.9.0
+
+### Phase 1-4 Enterprise Features 🏢
+
+Major update with enterprise-ready features for large-scale projects and monorepo support.
+
+#### Workflow Flexibility (Phase 1)
+
+- **3 Workflow Modes**: `small` (bug fixes), `medium` (features), `large` (architecture)
+- **Auto-detection**: Smart mode selection based on feature name patterns
+- **`musubi-release`**: New CLI for release automation with CHANGELOG generation
+
+```bash
+# Generate CHANGELOG from commits
+musubi-release
+
+# Show detected mode for a feature
+musubi-workflow mode --detect "feat: user authentication"
+```
+
+#### Monorepo Support (Phase 2)
+
+- **Package Registry**: `steering/packages.yml` for dependency management
+- **Dependency Graphs**: Mermaid diagram generation for visualization
+- **Coverage Tracking**: Per-package test coverage reporting
+
+#### Constitution Level Management (Phase 3)
+
+- **3 Enforcement Levels**: `critical` (blocking), `advisory` (warnings), `flexible` (suggestions)
+- **Level-aware Validation**: Different enforcement based on article importance
+- **Project Overrides**: Custom levels per project type
+
+| Level | Articles | Behavior |
+|-------|----------|----------|
+| Critical | CONST-001, 002, 003, 005, 009 | Blocks workflow |
+| Advisory | CONST-004, 006, 007 | Warnings only |
+| Flexible | CONST-008 | Suggestions |
+
+#### Project Configuration (Phase 4)
+
+- **`musubi-config`**: New CLI for configuration management
+- **Schema Validation**: v2.0 schema with AJV validation
+- **Auto-migration**: Upgrade v1.0 configs to v2.0
+
+```bash
+musubi-config validate  # Validate project.yml
+musubi-config migrate   # Migrate to v2.0
+musubi-config show      # Show effective config
+```
+
+#### Orchestrator Integration
+
+5 new built-in skills for programmatic access:
+
+| Skill | Category | Usage |
+|-------|----------|-------|
+| `release-manager` | release | CHANGELOG generation |
+| `workflow-mode-manager` | workflow | Mode detection & management |
+| `package-manager` | configuration | Package & dependency analysis |
+| `constitution-level-manager` | validation | Level-aware validation |
+| `project-config-manager` | configuration | Config validation & migration |
+
+```javascript
+const { workflowModeSkill } = require('musubi-sdd/src/orchestration');
+
+const result = await workflowModeSkill.execute({
+  action: 'detect',
+  featureName: 'fix: minor bug'
+});
+console.log(result.detectedMode); // 'small'
+```
+
+---
+
+## 📊 What's New in v5.8.0
+
+### CodeGraph MCP v0.8.0 Integration 🔗
+
+Major update to CodeGraph MCP integration with expanded language support and new features.
+
+#### 16 Language Support (NEW: Kotlin, Swift, Scala, Lua)
+
+- **Python, TypeScript, JavaScript** - Full AST analysis
+- **Rust, Go, Java, PHP, C#** - Enterprise language support
+- **C, C++, HCL (Terraform)** - System and infrastructure code
+- **Ruby** - Dynamic language support
+- **Kotlin** (NEW) - `.kt`, `.kts` files with classes, interfaces, functions
+- **Swift** (NEW) - `.swift` files with classes, structs, protocols
+- **Scala** (NEW) - `.scala`, `.sc` files with traits, objects
+- **Lua** (NEW) - `.lua` files with functions, table assignments
+
+#### File Watching & Auto Re-indexing
+
+- **`codegraph-mcp watch`** - Real-time file monitoring
+- **Debounce configuration** - Configurable delay (default: 1.0s)
+- **Community detection** - Optional `--community` flag after re-index
+
+#### Enhanced MCP Tools (14 Tools)
+
+| Category | Tools |
+|----------|-------|
+| **Graph Query** | `query_codebase`, `find_dependencies`, `find_callers`, `find_callees`, `find_implementations`, `analyze_module_structure` |
+| **Code Retrieval** | `get_code_snippet`, `read_file_content`, `get_file_structure` |
+| **GraphRAG** | `global_search`, `local_search` |
+| **Management** | `suggest_refactoring`, `reindex_repository`, `execute_shell_command` |
+
+#### Security & Performance (v0.7.3)
+
+- **Security fixes**: Path traversal and command injection protection
+- **Connection pooling**: Improved database performance
+- **Caching**: Faster repeated queries
+
+```javascript
+// Use CodeGraph MCP integration
+const { CodeGraphIntegration } = require('musubi-sdd');
+
+const cg = new CodeGraphIntegration('/path/to/repo');
+await cg.indexRepository();
+
+// File watching (v0.7.0+)
+await cg.startWatch({ debounce: 2.0, community: true });
+
+// Query codebase
+const results = await cg.queryCodebase('authentication');
+const callers = await cg.findCallers('UserService::login');
+```
+
+---
+
 ## 📊 What's New in v5.6.0
 
 ### Enterprise-Scale Analysis & Rust Migration Support 🏢🦀

package/bin/musubi-config.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+
+/**
+ * musubi-config CLI
+ *
+ * Manage project configuration (project.yml)
+ * - validate: Validate project.yml against schema
+ * - migrate: Migrate v1.0 to v2.0
+ * - show: Display effective configuration
+ */
+
+const { Command } = require('commander');
+const { ProjectValidator } = require('../src/validators/project-validator');
+const chalk = require('chalk');
+
+const program = new Command();
+
+program
+  .name('musubi-config')
+  .description('MUSUBI Project Configuration Manager')
+  .version('1.0.0');
+
+program
+  .command('validate')
+  .description('Validate project.yml against schema')
+  .option('-d, --dir <path>', 'Project directory', process.cwd())
+  .option('--strict', 'Treat warnings as errors')
+  .action(async options => {
+    try {
+      const validator = new ProjectValidator(options.dir);
+      const result = await validator.validateConfig();
+
+      console.log('\n📋 Project Configuration Validation\n');
+      console.log(`Schema Version: ${result.schemaVersion}`);
+      console.log(`Valid: ${result.valid ? chalk.green('✓ Yes') : chalk.red('✗ No')}`);
+
+      if (result.needsMigration) {
+        console.log(chalk.yellow('\n⚠️  Migration recommended: v1.0 → v2.0'));
+        console.log('   Run: musubi-config migrate');
+      }
+
+      if (result.errors.length > 0) {
+        console.log(chalk.red('\n❌ Errors:'));
+        result.errors.forEach(err => {
+          console.log(`  • ${err.path}: ${err.message}`);
+        });
+      }
+
+      if (result.warnings.length > 0) {
+        console.log(chalk.yellow('\n⚠️  Warnings:'));
+        result.warnings.forEach(warn => {
+          console.log(`  • ${warn.path}: ${warn.message}`);
+        });
+      }
+
+      if (result.valid && result.errors.length === 0) {
+        console.log(chalk.green('\n✅ Configuration is valid'));
+      }
+
+      const exitCode = result.errors.length > 0 || (options.strict && result.warnings.length > 0) ? 1 : 0;
+      process.exit(exitCode);
+    } catch (error) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('migrate')
+  .description('Migrate project.yml from v1.0 to v2.0')
+  .option('-d, --dir <path>', 'Project directory', process.cwd())
+  .option('--dry-run', 'Show changes without saving')
+  .action(async options => {
+    try {
+      const validator = new ProjectValidator(options.dir);
+      const result = await validator.migrateToV2();
+
+      console.log('\n📦 Project Configuration Migration\n');
+
+      if (!result.migrated) {
+        console.log(chalk.green(result.message));
+        return;
+      }
+
+      console.log(chalk.cyan('Migration changes:'));
+      console.log(`  • schema_version: 1.0 → 2.0`);
+      console.log(`  • package_type: ${result.config.package_type}`);
+      console.log(`  • workflow.mode: ${result.config.workflow?.mode}`);
+      console.log(`  • workflow.auto_detect_mode: ${result.config.workflow?.auto_detect_mode}`);
+      console.log(`  • constitution section added`);
+
+      if (options.dryRun) {
+        console.log(chalk.yellow('\n[Dry run] No changes saved'));
+      } else {
+        await validator.saveConfig(result.config);
+        console.log(chalk.green('\n✅ Migration complete'));
+        console.log(`   Backup saved to: steering/project.yml.backup`);
+      }
+    } catch (error) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('show')
+  .description('Display effective configuration')
+  .option('-d, --dir <path>', 'Project directory', process.cwd())
+  .option('--json', 'Output as JSON')
+  .action(async options => {
+    try {
+      const validator = new ProjectValidator(options.dir);
+      const report = await validator.generateReport();
+
+      if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+      }
+
+      console.log('\n📊 Effective Project Configuration\n');
+      console.log(`Project: ${report.projectRoot}`);
+      console.log(`Schema Version: ${report.effective.schema_version}`);
+      console.log(`Package Type: ${report.effective.package_type}`);
+      console.log(`Workflow Mode: ${report.effective.workflow_mode}`);
+      console.log(`Coverage Threshold: ${report.effective.coverage_threshold || 80}%`);
+
+      if (report.effective.constitution_overrides) {
+        console.log('\nConstitution Overrides:');
+        Object.entries(report.effective.constitution_overrides).forEach(([key, value]) => {
+          console.log(`  • ${key}: ${JSON.stringify(value)}`);
+        });
+      }
+
+      console.log('\nValidation:');
+      console.log(`  Valid: ${report.validation.valid ? 'Yes' : 'No'}`);
+      console.log(`  Errors: ${report.validation.errors.length}`);
+      console.log(`  Warnings: ${report.validation.warnings.length}`);
+    } catch (error) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('init')
+  .description('Create a new project.yml with v2.0 schema')
+  .option('-d, --dir <path>', 'Project directory', process.cwd())
+  .option('-n, --name <name>', 'Project name')
+  .option('-t, --type <type>', 'Package type', 'application')
+  .action(async options => {
+    try {
+      const fs = require('fs-extra');
+      const path = require('path');
+      const yaml = require('js-yaml');
+
+      const projectRoot = options.dir;
+      const configPath = path.join(projectRoot, 'steering/project.yml');
+
+      if (await fs.pathExists(configPath)) {
+        console.log(chalk.yellow('project.yml already exists. Use "migrate" to upgrade.'));
+        return;
+      }
+
+      await fs.ensureDir(path.join(projectRoot, 'steering'));
+
+      const projectName = options.name || path.basename(projectRoot);
+      const config = {
+        schema_version: '2.0',
+        project_name: projectName,
+        description: `${projectName} project`,
+        version: '0.1.0',
+        package_type: options.type,
+        languages: ['javascript'],
+        frameworks: [],
+        conventions: {
+          architecture_pattern: 'unknown',
+          directory_structure: {},
+        },
+        steering: {
+          auto_update: { enabled: false, frequency: 'on-demand' },
+          excluded_paths: ['node_modules/**', 'dist/**', '.git/**'],
+          memories: {
+            enabled: true,
+            path: 'steering/memories/',
+            max_file_size_kb: 500,
+            retention_days: 365,
+          },
+        },
+        agents: {
+          default_language: 'en',
+          bilingual_output: { enabled: false, languages: ['en'] },
+          output: {
+            gradual_generation: true,
+            progress_indicators: true,
+            large_file_splitting: false,
+            split_threshold_lines: 300,
+          },
+        },
+        workflow: {
+          mode: 'medium',
+          auto_detect_mode: true,
+          testing: {
+            required: true,
+            coverage_threshold: 80,
+          },
+          quality_gates: [],
+        },
+        constitution: {
+          level_config: 'steering/rules/constitution-levels.yml',
+          overrides: {},
+        },
+        custom_rules: [],
+        metadata: {
+          created_at: new Date().toISOString(),
+          musubi_version: require('../package.json').version,
+        },
+      };
+
+      await fs.writeFile(configPath, yaml.dump(config, { indent: 2 }), 'utf8');
+
+      console.log(chalk.green('\n✅ Created steering/project.yml (v2.0 schema)'));
+      console.log(`   Project: ${projectName}`);
+      console.log(`   Type: ${options.type}`);
+    } catch (error) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/bin/musubi-orchestrate.js

@@ -30,6 +30,7 @@ const {
   TriageCategory,
   TriageStrategy,
   AgentCapability,
+  getBuiltInSkills,
 } = require('../src/orchestration');
 
 const {
@@ -145,6 +146,21 @@ async function loadSkills(projectPath) {
     }
   }
 
+  // Add built-in Phase 1-4 skills
+  const builtInSkills = getBuiltInSkills();
+  for (const skill of builtInSkills) {
+    skills.set(skill.id, {
+      name: skill.name,
+      description: skill.description,
+      keywords: skill.tags || [],
+      categories: [skill.category],
+      execute: skill.execute,
+      version: skill.version,
+      inputs: skill.inputs,
+      outputs: skill.outputs,
+    });
+  }
+
   return skills;
 }