musubi-sdd 5.1.0 → 5.6.1

package/src/phase5-integration.js

@@ -1,18 +1,54 @@
 /**
  * Phase 5 Integration Module
  * Advanced Features統合エンジン
- * 
+ *
  * @module phase5-integration
  */
 
 const EventEmitter = require('events');
 
 // Phase 5 modules
-const { SteeringAutoUpdate, createSteeringAutoUpdate, TRIGGER, STEERING_TYPE } = require('./steering/steering-auto-update');
-const { SteeringValidator, createSteeringValidator, SEVERITY, RULE_TYPE } = require('./steering/steering-validator');
-const { TemplateConstraints, ThinkingChecklist, createTemplateConstraints, createThinkingChecklist, CONSTRAINT_TYPE, UNCERTAINTY, MARKER_TYPE } = require('./templates/template-constraints');
-const { QualityDashboard, createQualityDashboard, METRIC_CATEGORY, HEALTH_STATUS, CONSTITUTIONAL_ARTICLES } = require('./monitoring/quality-dashboard');
-const { AdvancedValidation, createAdvancedValidation, VALIDATION_TYPE, ARTIFACT_TYPE, GAP_SEVERITY } = require('./validators/advanced-validation');
+const {
+  SteeringAutoUpdate,
+  createSteeringAutoUpdate,
+  TRIGGER,
+  STEERING_TYPE,
+} = require('./steering/steering-auto-update');
+const {
+  SteeringValidator,
+  createSteeringValidator,
+  SEVERITY,
+  RULE_TYPE,
+} = require('./steering/steering-validator');
+const {
+  TemplateConstraints,
+  ThinkingChecklist,
+  createTemplateConstraints,
+  createThinkingChecklist,
+  CONSTRAINT_TYPE,
+  UNCERTAINTY,
+  MARKER_TYPE,
+} = require('./templates/template-constraints');
+const {
+  QualityDashboard,
+  createQualityDashboard,
+  METRIC_CATEGORY,
+  HEALTH_STATUS,
+  CONSTITUTIONAL_ARTICLES,
+} = require('./monitoring/quality-dashboard');
+const {
+  AdvancedValidation,
+  createAdvancedValidation,
+  VALIDATION_TYPE,
+  ARTIFACT_TYPE,
+  GAP_SEVERITY,
+} = require('./validators/advanced-validation');
+const {
+  CodeGraphAutoUpdate,
+  createCodeGraphAutoUpdate,
+  TRIGGER: CODEGRAPH_TRIGGER,
+  TARGET: CODEGRAPH_TARGET,
+} = require('./analyzers/codegraph-auto-update');
 
 /**
  * Phase 5 integration status
@@ -22,7 +58,7 @@ const INTEGRATION_STATUS = {
   READY: 'ready',
   RUNNING: 'running',
   STOPPED: 'stopped',
-  ERROR: 'error'
+  ERROR: 'error',
 };
 
 /**
@@ -37,6 +73,7 @@ class Phase5Integration extends EventEmitter {
    * @param {Object} options.templates - Template constraints options
    * @param {Object} options.dashboard - Quality dashboard options
    * @param {Object} options.validation - Advanced validation options
+   * @param {Object} options.codegraph - CodeGraph auto-update options
    */
   constructor(options = {}) {
     super();
@@ -50,6 +87,7 @@ class Phase5Integration extends EventEmitter {
     this.templateConstraints = createTemplateConstraints(options.templates || {});
     this.qualityDashboard = createQualityDashboard(options.dashboard || {});
     this.advancedValidation = createAdvancedValidation(options.validation || {});
+    this.codeGraphAutoUpdate = createCodeGraphAutoUpdate(options.codegraph || {});
 
     // Thinking checklist
     this.thinkingChecklist = createThinkingChecklist();
@@ -66,12 +104,12 @@ class Phase5Integration extends EventEmitter {
    */
   setupEventHandlers() {
     // When steering is updated, validate it
-    this.steeringAutoUpdate.on('update-applied', (update) => {
+    this.steeringAutoUpdate.on('update-applied', update => {
       this.emit('steering-updated', update);
     });
 
     // When quality is collected, check thresholds
-    this.qualityDashboard.on('collected', (snapshot) => {
+    this.qualityDashboard.on('collected', snapshot => {
       const health = this.qualityDashboard.getHealthSummary();
       if (health.status === HEALTH_STATUS.CRITICAL || health.status === HEALTH_STATUS.FAILING) {
         this.emit('health-alert', { status: health.status, snapshot });
@@ -79,18 +117,28 @@ class Phase5Integration extends EventEmitter {
     });
 
     // When validation finds issues, emit alerts
-    this.advancedValidation.on('validated', (result) => {
+    this.advancedValidation.on('validated', result => {
       if (!result.valid) {
         this.emit('validation-alert', result);
       }
     });
 
     // When gaps are detected, emit alerts
-    this.advancedValidation.on('gaps-detected', (result) => {
+    this.advancedValidation.on('gaps-detected', result => {
       if (result.criticalGaps > 0) {
         this.emit('gap-alert', result);
       }
     });
+
+    // When codegraph is updated, emit events
+    this.codeGraphAutoUpdate.on('update-complete', result => {
+      this.emit('codegraph-updated', result);
+    });
+
+    // When codegraph has errors, emit alerts
+    this.codeGraphAutoUpdate.on('update-error', error => {
+      this.emit('codegraph-error', error);
+    });
   }
 
   /**
@@ -105,7 +153,8 @@ class Phase5Integration extends EventEmitter {
       templateConstraints: this.templateConstraints,
       qualityDashboard: this.qualityDashboard,
       advancedValidation: this.advancedValidation,
-      thinkingChecklist: this.thinkingChecklist
+      thinkingChecklist: this.thinkingChecklist,
+      codeGraphAutoUpdate: this.codeGraphAutoUpdate,
     };
     return components[name] || null;
   }
@@ -139,7 +188,7 @@ class Phase5Integration extends EventEmitter {
         metrics,
         validation,
         overallScore,
-        recommendations: this.generateRecommendations(health, validation)
+        recommendations: this.generateRecommendations(health, validation),
       };
 
       this.status = INTEGRATION_STATUS.READY;
@@ -158,8 +207,9 @@ class Phase5Integration extends EventEmitter {
    */
   calculateOverallScore(metrics, validation) {
     const healthScore = metrics.health?.overall ?? 0;
-    const validationScore = validation.valid ? 100 : 
-      Math.max(0, 100 - (validation.criticalIssues * 20) - (validation.totalIssues * 5));
+    const validationScore = validation.valid
+      ? 100
+      : Math.max(0, 100 - validation.criticalIssues * 20 - validation.totalIssues * 5);
 
     return Math.round((healthScore + validationScore) / 2);
   }
@@ -176,7 +226,7 @@ class Phase5Integration extends EventEmitter {
         type: 'coverage',
         priority: 'high',
         message: 'Increase test coverage to improve project health',
-        currentScore: health.breakdown.coverage.score
+        currentScore: health.breakdown.coverage.score,
       });
     }
 
@@ -185,7 +235,7 @@ class Phase5Integration extends EventEmitter {
         type: 'constitutional',
         priority: 'high',
         message: 'Review constitutional compliance for all articles',
-        currentScore: health.breakdown.constitutional.score
+        currentScore: health.breakdown.constitutional.score,
       });
     }
 
@@ -195,7 +245,7 @@ class Phase5Integration extends EventEmitter {
         type: 'gaps',
         priority: validation.gaps.criticalGaps > 0 ? 'critical' : 'medium',
         message: `Address ${validation.gaps.gapCount} specification gaps`,
-        details: validation.gaps.gaps.slice(0, 5)
+        details: validation.gaps.gaps.slice(0, 5),
       });
     }
 
@@ -204,7 +254,7 @@ class Phase5Integration extends EventEmitter {
         type: 'traceability',
         priority: 'medium',
         message: 'Improve traceability coverage between artifacts',
-        currentCoverage: validation.traceability.coverage
+        currentCoverage: validation.traceability.coverage,
       });
     }
 
@@ -224,13 +274,14 @@ class Phase5Integration extends EventEmitter {
     }
 
     const overallValid = Object.values(results).every(r => r.valid);
-    const avgScore = Object.values(results).reduce((sum, r) => sum + r.score, 0) / Object.keys(results).length;
+    const avgScore =
+      Object.values(results).reduce((sum, r) => sum + r.score, 0) / Object.keys(results).length;
 
     return {
       valid: overallValid,
       files: results,
       avgScore: Math.round(avgScore),
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
   }
 
@@ -254,26 +305,26 @@ class Phase5Integration extends EventEmitter {
       components: {
         steeringAutoUpdate: {
           rules: this.steeringAutoUpdate.rules?.length ?? 0,
-          history: this.steeringAutoUpdate.updateHistory?.length ?? 0
+          history: this.steeringAutoUpdate.updateHistory?.length ?? 0,
         },
         steeringValidator: {
           rules: this.steeringValidator.rules?.size ?? 0,
-          history: this.steeringValidator.history?.length ?? 0
+          history: this.steeringValidator.history?.length ?? 0,
         },
         templateConstraints: {
           templates: Object.keys(this.templateConstraints.templates).length,
-          history: this.templateConstraints.validationHistory?.length ?? 0
+          history: this.templateConstraints.validationHistory?.length ?? 0,
         },
         qualityDashboard: {
           metrics: this.qualityDashboard.metrics?.size ?? 0,
-          history: this.qualityDashboard.history?.length ?? 0
+          history: this.qualityDashboard.history?.length ?? 0,
         },
         advancedValidation: {
           artifacts: this.advancedValidation.artifacts?.size ?? 0,
-          links: this.advancedValidation.countLinks?.() ?? 0
-        }
+          links: this.advancedValidation.countLinks?.() ?? 0,
+        },
       },
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
   }
 
@@ -328,7 +379,7 @@ class Phase5Integration extends EventEmitter {
     this.qualityDashboard.clear();
     this.advancedValidation.clear();
     this.thinkingChecklist.reset();
-    
+
     this.status = INTEGRATION_STATUS.READY;
     this.emit('reset');
   }
@@ -338,6 +389,7 @@ class Phase5Integration extends EventEmitter {
    */
   start() {
     this.qualityDashboard.startAutoCollection();
+    this.codeGraphAutoUpdate.start();
     this.status = INTEGRATION_STATUS.RUNNING;
     this.emit('started');
   }
@@ -347,6 +399,7 @@ class Phase5Integration extends EventEmitter {
    */
   stop() {
     this.qualityDashboard.stopAutoCollection();
+    this.codeGraphAutoUpdate.stop();
     this.status = INTEGRATION_STATUS.STOPPED;
     this.emit('stopped');
   }
@@ -398,5 +451,11 @@ module.exports = {
   createAdvancedValidation,
   VALIDATION_TYPE,
   ARTIFACT_TYPE,
-  GAP_SEVERITY
+  GAP_SEVERITY,
+
+  // Re-export Sprint 5.5: CodeGraph Auto-Update
+  CodeGraphAutoUpdate,
+  createCodeGraphAutoUpdate,
+  CODEGRAPH_TRIGGER,
+  CODEGRAPH_TARGET,
 };

package/src/reporters/coverage-report.js

@@ -90,10 +90,18 @@ class CoverageReporter {
     lines.push('-'.repeat(30));
     lines.push(`Total Requirements: ${coverage.totalRequirements}`);
     lines.push('');
-    lines.push(`Design Coverage:  ${this.formatBar(coverage.designCoverage)}  ${coverage.designCoverage}%`);
-    lines.push(`Tasks Coverage:   ${this.formatBar(coverage.tasksCoverage)}  ${coverage.tasksCoverage}%`);
-    lines.push(`Code Coverage:    ${this.formatBar(coverage.codeCoverage)}  ${coverage.codeCoverage}%`);
-    lines.push(`Test Coverage:    ${this.formatBar(coverage.testsCoverage)}  ${coverage.testsCoverage}%`);
+    lines.push(
+      `Design Coverage:  ${this.formatBar(coverage.designCoverage)}  ${coverage.designCoverage}%`
+    );
+    lines.push(
+      `Tasks Coverage:   ${this.formatBar(coverage.tasksCoverage)}  ${coverage.tasksCoverage}%`
+    );
+    lines.push(
+      `Code Coverage:    ${this.formatBar(coverage.codeCoverage)}  ${coverage.codeCoverage}%`
+    );
+    lines.push(
+      `Test Coverage:    ${this.formatBar(coverage.testsCoverage)}  ${coverage.testsCoverage}%`
+    );
     lines.push('-'.repeat(30));
     lines.push(`OVERALL:          ${this.formatBar(coverage.overall)}  ${coverage.overall}%`);
     lines.push('');
@@ -129,7 +137,7 @@ class CoverageReporter {
    */
   formatMarkdown(data) {
     const lines = [];
-    const { coverage, gaps, matrix } = data;
+    const { coverage, gaps, matrix: _matrix } = data;
 
     lines.push('# Traceability Coverage Report');
     lines.push('');
@@ -137,7 +145,12 @@ class CoverageReporter {
     lines.push('');
 
     // Overall status
-    const status = coverage.overall >= 80 ? '✅ Good' : coverage.overall >= 60 ? '⚠️ Needs Improvement' : '❌ Critical';
+    const status =
+      coverage.overall >= 80
+        ? '✅ Good'
+        : coverage.overall >= 60
+          ? '⚠️ Needs Improvement'
+          : '❌ Critical';
     lines.push(`## Overall Status: ${status}`);
     lines.push('');
 
@@ -146,32 +159,55 @@ class CoverageReporter {
     lines.push('');
     lines.push('| Category | Covered | Total | Coverage |');
     lines.push('|----------|---------|-------|----------|');
-    lines.push(`| Design | ${coverage.withDesign} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.designCoverage)} ${coverage.designCoverage}% |`);
-    lines.push(`| Tasks | ${coverage.withTasks} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.tasksCoverage)} ${coverage.tasksCoverage}% |`);
-    lines.push(`| Code | ${coverage.withCode} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.codeCoverage)} ${coverage.codeCoverage}% |`);
-    lines.push(`| Tests | ${coverage.withTests} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.testsCoverage)} ${coverage.testsCoverage}% |`);
-    lines.push(`| **Overall** | - | - | ${this.formatProgressBar(coverage.overall)} **${coverage.overall}%** |`);
+    lines.push(
+      `| Design | ${coverage.withDesign} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.designCoverage)} ${coverage.designCoverage}% |`
+    );
+    lines.push(
+      `| Tasks | ${coverage.withTasks} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.tasksCoverage)} ${coverage.tasksCoverage}% |`
+    );
+    lines.push(
+      `| Code | ${coverage.withCode} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.codeCoverage)} ${coverage.codeCoverage}% |`
+    );
+    lines.push(
+      `| Tests | ${coverage.withTests} | ${coverage.totalRequirements} | ${this.formatProgressBar(coverage.testsCoverage)} ${coverage.testsCoverage}% |`
+    );
+    lines.push(
+      `| **Overall** | - | - | ${this.formatProgressBar(coverage.overall)} **${coverage.overall}%** |`
+    );
     lines.push('');
 
     // Gaps
     if (gaps) {
       lines.push('## Gaps Analysis');
       lines.push('');
-      
-      const totalGaps = gaps.orphanedRequirements.length + gaps.orphanedDesign.length + 
-                        gaps.orphanedTasks.length + gaps.untestedCode.length + 
-                        gaps.missingTests.length;
-      
+
+      const totalGaps =
+        gaps.orphanedRequirements.length +
+        gaps.orphanedDesign.length +
+        gaps.orphanedTasks.length +
+        gaps.untestedCode.length +
+        gaps.missingTests.length;
+
       lines.push(`**Total Gaps Found**: ${totalGaps}`);
       lines.push('');
 
       lines.push('| Gap Type | Count | Status |');
       lines.push('|----------|-------|--------|');
-      lines.push(`| Orphaned Requirements | ${gaps.orphanedRequirements.length} | ${gaps.orphanedRequirements.length === 0 ? '✅' : '⚠️'} |`);
-      lines.push(`| Orphaned Design | ${gaps.orphanedDesign.length} | ${gaps.orphanedDesign.length === 0 ? '✅' : '⚠️'} |`);
-      lines.push(`| Orphaned Tasks | ${gaps.orphanedTasks.length} | ${gaps.orphanedTasks.length === 0 ? '✅' : '⚠️'} |`);
-      lines.push(`| Untested Code | ${gaps.untestedCode.length} | ${gaps.untestedCode.length === 0 ? '✅' : '⚠️'} |`);
-      lines.push(`| Missing Tests | ${gaps.missingTests.length} | ${gaps.missingTests.length === 0 ? '✅' : '❌'} |`);
+      lines.push(
+        `| Orphaned Requirements | ${gaps.orphanedRequirements.length} | ${gaps.orphanedRequirements.length === 0 ? '✅' : '⚠️'} |`
+      );
+      lines.push(
+        `| Orphaned Design | ${gaps.orphanedDesign.length} | ${gaps.orphanedDesign.length === 0 ? '✅' : '⚠️'} |`
+      );
+      lines.push(
+        `| Orphaned Tasks | ${gaps.orphanedTasks.length} | ${gaps.orphanedTasks.length === 0 ? '✅' : '⚠️'} |`
+      );
+      lines.push(
+        `| Untested Code | ${gaps.untestedCode.length} | ${gaps.untestedCode.length === 0 ? '✅' : '⚠️'} |`
+      );
+      lines.push(
+        `| Missing Tests | ${gaps.missingTests.length} | ${gaps.missingTests.length === 0 ? '✅' : '❌'} |`
+      );
       lines.push('');
 
       // Show details for each gap type
@@ -217,19 +253,27 @@ class CoverageReporter {
     // Recommendations
     lines.push('## Recommendations');
     lines.push('');
-    
+
     if (coverage.overall < 100) {
       if (coverage.testsCoverage < 80) {
-        lines.push('1. 🧪 **Increase test coverage**: Add tests for requirements that are missing test links');
+        lines.push(
+          '1. 🧪 **Increase test coverage**: Add tests for requirements that are missing test links'
+        );
       }
       if (coverage.designCoverage < 80) {
-        lines.push('2. 📐 **Complete design documentation**: Link requirements to design documents');
+        lines.push(
+          '2. 📐 **Complete design documentation**: Link requirements to design documents'
+        );
       }
       if (coverage.codeCoverage < 80) {
-        lines.push('3. 💻 **Link code to requirements**: Add requirement references in code comments');
+        lines.push(
+          '3. 💻 **Link code to requirements**: Add requirement references in code comments'
+        );
       }
       if (gaps && gaps.orphanedRequirements.length > 0) {
-        lines.push('4. 🔗 **Address orphaned requirements**: Link them to design, tasks, or remove if obsolete');
+        lines.push(
+          '4. 🔗 **Address orphaned requirements**: Link them to design, tasks, or remove if obsolete'
+        );
       }
     } else {
       lines.push('✅ Excellent! Full traceability coverage achieved.');
@@ -360,7 +404,9 @@ class CoverageReporter {
     </table>
   </div>
 
-  ${gaps ? `
+  ${
+    gaps
+      ? `
   <div class="card">
     <h2>Gaps Analysis</h2>
     <table>
@@ -396,17 +442,23 @@ class CoverageReporter {
       </tr>
     </table>
   </div>
-  ` : ''}
+  `
+      : ''
+  }
 
   <div class="card">
     <h2>Recommendations</h2>
     <ul>
-      ${coverage.overall < 100 ? `
+      ${
+        coverage.overall < 100
+          ? `
         ${coverage.testsCoverage < 80 ? '<li>🧪 <strong>Increase test coverage</strong>: Add tests for requirements that are missing test links</li>' : ''}
         ${coverage.designCoverage < 80 ? '<li>📐 <strong>Complete design documentation</strong>: Link requirements to design documents</li>' : ''}
         ${coverage.codeCoverage < 80 ? '<li>💻 <strong>Link code to requirements</strong>: Add requirement references in code comments</li>' : ''}
         ${gaps && gaps.orphanedRequirements.length > 0 ? '<li>🔗 <strong>Address orphaned requirements</strong>: Link them to design, tasks, or remove if obsolete</li>' : ''}
-      ` : '<li>✅ Excellent! Full traceability coverage achieved.</li>'}
+      `
+          : '<li>✅ Excellent! Full traceability coverage achieved.</li>'
+      }
     </ul>
   </div>