musubi-sdd 5.1.0 → 5.6.1

package/src/steering/auto-updater.js

@@ -1,6 +1,6 @@
 /**
  * Steering Auto-Update Module
- * 
+ *
  * Automatically updates steering files based on agent work:
  * - Detects project changes
  * - Updates structure.md, tech.md, product.md
@@ -8,7 +8,7 @@
  * - Supports domain-specific custom rules
  */
 
-const fs = require('fs');
+const _fs = require('fs');
 const path = require('path');
 const { EventEmitter } = require('events');
 
@@ -21,7 +21,7 @@ const SteeringFileType = {
   PRODUCT: 'product',
   PROJECT: 'project',
   RULES: 'rules',
-  CUSTOM: 'custom'
+  CUSTOM: 'custom',
 };
 
 /**
@@ -34,7 +34,7 @@ const UpdateTrigger = {
   DEPENDENCY_ADDED: 'dependency-added',
   DEPENDENCY_REMOVED: 'dependency-removed',
   CONFIG_CHANGED: 'config-changed',
-  MANUAL: 'manual'
+  MANUAL: 'manual',
 };
 
 /**
@@ -43,25 +43,16 @@ const UpdateTrigger = {
 class ChangeDetector {
   constructor(options = {}) {
     this.patterns = options.patterns || {
-      structure: [
-        /^src\//,
-        /^lib\//,
-        /^packages\//,
-        /^components\//
-      ],
+      structure: [/^src\//, /^lib\//, /^packages\//, /^components\//],
       tech: [
         /package\.json$/,
         /requirements\.txt$/,
         /Gemfile$/,
         /go\.mod$/,
         /Cargo\.toml$/,
-        /\.config\.(js|ts|json)$/
+        /\.config\.(js|ts|json)$/,
       ],
-      product: [
-        /README\.md$/,
-        /docs\//,
-        /\.env\.example$/
-      ]
+      product: [/README\.md$/, /docs\//, /\.env\.example$/],
     };
   }
 
@@ -95,7 +86,7 @@ class ChangeDetector {
       deletedFiles: [],
       addedDependencies: [],
       removedDependencies: [],
-      affectedSteering: []
+      affectedSteering: [],
     };
 
     for (const change of changes) {
@@ -108,11 +99,7 @@ class ChangeDetector {
       }
     }
 
-    const allFiles = [
-      ...analysis.addedFiles,
-      ...analysis.modifiedFiles,
-      ...analysis.deletedFiles
-    ];
+    const allFiles = [...analysis.addedFiles, ...analysis.modifiedFiles, ...analysis.deletedFiles];
 
     analysis.affectedSteering = this.detectAffectedSteering(allFiles);
 
@@ -149,7 +136,7 @@ class SteeringUpdater {
       updates.push({
         section: 'directories',
         action: 'add',
-        content: [...newDirs].map(d => `- \`${d}/\` - [TODO: Add description]`)
+        content: [...newDirs].map(d => `- \`${d}/\` - [TODO: Add description]`),
       });
     }
 
@@ -166,7 +153,7 @@ class SteeringUpdater {
       updates.push({
         section: 'directories',
         action: 'review',
-        content: [...removedDirs].map(d => `- \`${d}/\` may need removal or update`)
+        content: [...removedDirs].map(d => `- \`${d}/\` may need removal or update`),
       });
     }
 
@@ -188,8 +175,8 @@ class SteeringUpdater {
         action: 'sync',
         content: {
           runtime: Object.keys(deps),
-          development: Object.keys(devDeps)
-        }
+          development: Object.keys(devDeps),
+        },
       });
 
       // Detect framework
@@ -206,7 +193,7 @@ class SteeringUpdater {
         updates.push({
           section: 'frameworks',
           action: 'update',
-          content: frameworks
+          content: frameworks,
         });
       }
     }
@@ -227,7 +214,7 @@ class SteeringUpdater {
         updates.push({
           section: 'name',
           action: 'sync',
-          content: titleMatch[1]
+          content: titleMatch[1],
         });
       }
 
@@ -237,7 +224,7 @@ class SteeringUpdater {
         updates.push({
           section: 'description',
           action: 'sync',
-          content: descMatch[1].trim()
+          content: descMatch[1].trim(),
         });
       }
     }
@@ -257,7 +244,7 @@ class SteeringUpdater {
         section: update.section,
         action: update.action,
         applied: !this.dryRun,
-        content: update.content
+        content: update.content,
       });
     }
 
@@ -283,29 +270,29 @@ class ProjectYmlSync {
       description: '',
       tech_stack: [],
       features: [],
-      agents: []
+      agents: [],
     };
 
     // Simple YAML-like parsing
     const lines = content.split('\n');
     let currentKey = null;
-    let inList = false;
+    let _inList = false;
 
     for (const line of lines) {
       const trimmed = line.trim();
-      
+
       if (trimmed.startsWith('#') || trimmed === '') continue;
 
       const keyMatch = line.match(/^(\w+):\s*(.*)$/);
       if (keyMatch) {
         currentKey = keyMatch[1];
         const value = keyMatch[2].trim();
-        
+
         if (value && !value.startsWith('-')) {
           data[currentKey] = value;
-          inList = false;
+          _inList = false;
         } else {
-          inList = true;
+          _inList = true;
           if (!Array.isArray(data[currentKey])) {
             data[currentKey] = [];
           }
@@ -374,20 +361,20 @@ class ProjectYmlSync {
     const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
 
     const techMapping = {
-      'react': 'React',
-      'vue': 'Vue.js',
-      'angular': 'Angular',
-      'next': 'Next.js',
-      'express': 'Express',
-      'fastify': 'Fastify',
-      'typescript': 'TypeScript',
-      'jest': 'Jest',
-      'mocha': 'Mocha',
-      'webpack': 'Webpack',
-      'vite': 'Vite',
-      'tailwindcss': 'Tailwind CSS',
-      'prisma': 'Prisma',
-      'mongoose': 'Mongoose'
+      react: 'React',
+      vue: 'Vue.js',
+      angular: 'Angular',
+      next: 'Next.js',
+      express: 'Express',
+      fastify: 'Fastify',
+      typescript: 'TypeScript',
+      jest: 'Jest',
+      mocha: 'Mocha',
+      webpack: 'Webpack',
+      vite: 'Vite',
+      tailwindcss: 'Tailwind CSS',
+      prisma: 'Prisma',
+      mongoose: 'Mongoose',
     };
 
     for (const [dep, tech] of Object.entries(techMapping)) {
@@ -418,17 +405,17 @@ class CustomSteeringRules {
     // Parse custom rules from markdown format
     const rules = [];
     const rulePattern = /## Rule: (.+)\n([\s\S]*?)(?=## Rule:|$)/g;
-    
+
     let match;
     while ((match = rulePattern.exec(content)) !== null) {
       const name = match[1].trim();
       const body = match[2].trim();
-      
+
       const rule = {
         name,
         pattern: null,
         action: 'warn',
-        message: ''
+        message: '',
       };
 
       // Parse pattern
@@ -476,7 +463,7 @@ class CustomSteeringRules {
             rule: name,
             file: change.path,
             action: rule.action,
-            message: rule.message
+            message: rule.message,
           });
         }
       }
@@ -495,18 +482,18 @@ class SteeringAutoUpdater extends EventEmitter {
     this.projectRoot = options.projectRoot || process.cwd();
     this.steeringDir = options.steeringDir || 'steering';
     this.dryRun = options.dryRun || false;
-    
+
     this.detector = new ChangeDetector(options.detectorOptions);
     this.updater = new SteeringUpdater({
       steeringDir: this.steeringDir,
       dryRun: this.dryRun,
-      backup: options.backup
+      backup: options.backup,
     });
     this.projectSync = new ProjectYmlSync({
-      path: path.join(this.steeringDir, 'project.yml')
+      path: path.join(this.steeringDir, 'project.yml'),
     });
     this.customRules = new CustomSteeringRules({
-      rulesDir: path.join(this.steeringDir, 'custom')
+      rulesDir: path.join(this.steeringDir, 'custom'),
     });
 
     this.updateHistory = [];
@@ -517,13 +504,13 @@ class SteeringAutoUpdater extends EventEmitter {
    */
   analyze(changes, context = {}) {
     const analysis = this.detector.analyzeChanges(changes);
-    
+
     const suggestions = {
       structure: [],
       tech: [],
       product: [],
       project: [],
-      custom: []
+      custom: [],
     };
 
     // Generate structure updates
@@ -547,9 +534,9 @@ class SteeringAutoUpdater extends EventEmitter {
     return {
       analysis,
       suggestions,
-      affectedFiles: analysis.affectedSteering.map(type => 
+      affectedFiles: analysis.affectedSteering.map(type =>
         path.join(this.steeringDir, `${type}.md`)
-      )
+      ),
     };
   }
 
@@ -560,7 +547,7 @@ class SteeringAutoUpdater extends EventEmitter {
     const results = {
       applied: [],
       skipped: [],
-      errors: []
+      errors: [],
     };
 
     for (const [type, updates] of Object.entries(suggestions)) {
@@ -575,7 +562,7 @@ class SteeringAutoUpdater extends EventEmitter {
       } catch (error) {
         results.errors.push({
           type,
-          error: error.message
+          error: error.message,
         });
       }
     }
@@ -583,7 +570,7 @@ class SteeringAutoUpdater extends EventEmitter {
     // Record in history
     this.updateHistory.push({
       timestamp: new Date(),
-      results
+      results,
     });
 
     return results;
@@ -594,10 +581,10 @@ class SteeringAutoUpdater extends EventEmitter {
    */
   syncProjectYml(projectData, packageJson) {
     const updated = this.projectSync.syncWithPackageJson(projectData, packageJson);
-    
+
     this.emit('projectSynced', {
       before: projectData,
-      after: updated
+      after: updated,
     });
 
     return updated;
@@ -632,16 +619,16 @@ class SteeringAutoUpdater extends EventEmitter {
           type: 'missing',
           file,
           severity: 'error',
-          message: `Required steering file ${file} is missing`
+          message: `Required steering file ${file} is missing`,
         });
       }
     }
 
     // Check for empty sections (would require file content)
-    
+
     return {
       valid: issues.filter(i => i.severity === 'error').length === 0,
-      issues
+      issues,
     };
   }
 }
@@ -660,11 +647,11 @@ module.exports = {
   ProjectYmlSync,
   CustomSteeringRules,
   SteeringAutoUpdater,
-  
+
   // Constants
   SteeringFileType,
   UpdateTrigger,
-  
+
   // Factory
-  createSteeringAutoUpdater
+  createSteeringAutoUpdater,
 };

package/src/steering/index.js

@@ -1,6 +1,6 @@
 /**
  * Steering Module - Main Entry Point
- * 
+ *
  * Provides comprehensive steering file management:
  * - Auto-Update: Automatic steering file updates
  * - Template Constraints: LLM-constraining syntax
@@ -17,7 +17,7 @@ const {
   SteeringAutoUpdater,
   SteeringFileType,
   UpdateTrigger,
-  createSteeringAutoUpdater
+  createSteeringAutoUpdater,
 } = require('./auto-updater');
 
 // Template Constraints Module
@@ -32,7 +32,7 @@ const {
   ConstraintType,
   UncertaintyMarker,
   Severity: ConstraintSeverity,
-  createTemplateConstraintEngine
+  createTemplateConstraintEngine,
 } = require('./template-constraints');
 
 // Quality Metrics Module
@@ -47,7 +47,7 @@ const {
   MetricCategory,
   HealthStatus,
   TrendDirection,
-  createQualityDashboard
+  createQualityDashboard,
 } = require('./quality-metrics');
 
 // Advanced Validation Module
@@ -63,7 +63,7 @@ const {
   ValidationType,
   Severity: ValidationSeverity,
   ArtifactType,
-  createAdvancedValidator
+  createAdvancedValidator,
 } = require('./advanced-validation');
 
 module.exports = {
@@ -115,5 +115,5 @@ module.exports = {
   ValidationType,
   ValidationSeverity,
   ArtifactType,
-  createAdvancedValidator
+  createAdvancedValidator,
 };

package/src/steering/quality-metrics.js

@@ -1,6 +1,6 @@
 /**
  * Quality Metrics Dashboard Module
- * 
+ *
  * Provides:
  * - Coverage metrics (code, test, documentation)
  * - Compliance scoring (steering, constitutional)
@@ -9,7 +9,7 @@
  */
 
 const EventEmitter = require('events');
-const path = require('path');
+const _path = require('path');
 
 // Metric Categories
 const MetricCategory = {
@@ -17,7 +17,7 @@ const MetricCategory = {
   COMPLIANCE: 'compliance',
   QUALITY: 'quality',
   HEALTH: 'health',
-  TREND: 'trend'
+  TREND: 'trend',
 };
 
 // Health Status
@@ -25,7 +25,7 @@ const HealthStatus = {
   HEALTHY: 'healthy',
   WARNING: 'warning',
   CRITICAL: 'critical',
-  UNKNOWN: 'unknown'
+  UNKNOWN: 'unknown',
 };
 
 // Trend Direction
@@ -33,7 +33,7 @@ const TrendDirection = {
   UP: 'up',
   DOWN: 'down',
   STABLE: 'stable',
-  UNKNOWN: 'unknown'
+  UNKNOWN: 'unknown',
 };
 
 /**
@@ -77,7 +77,7 @@ class Metric {
       target: this.target,
       progress: this.getProgress(),
       onTarget: this.isOnTarget(),
-      timestamp: this.timestamp.toISOString()
+      timestamp: this.timestamp.toISOString(),
     };
   }
 }
@@ -104,7 +104,7 @@ class CoverageMetric extends Metric {
     return {
       ...super.toJSON(),
       covered: this.coveredItems,
-      total: this.totalItems
+      total: this.totalItems,
     };
   }
 }
@@ -127,7 +127,7 @@ class ComplianceMetric extends Metric {
   addViolation(violation) {
     this.violations.push({
       ...violation,
-      timestamp: new Date()
+      timestamp: new Date(),
     });
     this.recalculate();
     return this;
@@ -144,7 +144,7 @@ class ComplianceMetric extends Metric {
       this.value = 100;
       return;
     }
-    
+
     const violatedRules = new Set(this.violations.map(v => v.rule));
     const compliantCount = this.rules.length - violatedRules.size;
     this.value = (compliantCount / this.rules.length) * 100;
@@ -156,7 +156,7 @@ class ComplianceMetric extends Metric {
       ...super.toJSON(),
       rules: this.rules.length,
       violations: this.violations.length,
-      violatedRules: [...new Set(this.violations.map(v => v.rule))]
+      violatedRules: [...new Set(this.violations.map(v => v.rule))],
     };
   }
 }
@@ -204,7 +204,7 @@ class HealthIndicator {
       status: this.status,
       message: this.message,
       lastCheck: this.lastCheck?.toISOString(),
-      healthy: this.isHealthy()
+      healthy: this.isHealthy(),
     };
   }
 }
@@ -221,7 +221,7 @@ class TrendAnalyzer {
 
   addDataPoint(value, timestamp = new Date()) {
     this.dataPoints.push({ value, timestamp });
-    
+
     // Keep only maxPoints
     if (this.dataPoints.length > this.maxPoints) {
       this.dataPoints = this.dataPoints.slice(-this.maxPoints);
@@ -256,7 +256,7 @@ class TrendAnalyzer {
       percentChange,
       first,
       last,
-      dataPoints: recent.length
+      dataPoints: recent.length,
     };
   }
 
@@ -282,7 +282,7 @@ class TrendAnalyzer {
       average: this.getAverage(),
       min: this.getMin(),
       max: this.getMax(),
-      dataPoints: this.dataPoints.length
+      dataPoints: this.dataPoints.length,
     };
   }
 }
@@ -296,7 +296,7 @@ class QualityScoreCalculator {
       coverage: 0.3,
       compliance: 0.3,
       health: 0.2,
-      trends: 0.2
+      trends: 0.2,
     };
   }
 
@@ -305,18 +305,18 @@ class QualityScoreCalculator {
       coverage: this.calculateCoverageScore(metrics.coverage || []),
       compliance: this.calculateComplianceScore(metrics.compliance || []),
       health: this.calculateHealthScore(metrics.health || []),
-      trends: this.calculateTrendScore(metrics.trends || [])
+      trends: this.calculateTrendScore(metrics.trends || []),
     };
 
     const overall = Object.entries(this.weights).reduce((acc, [key, weight]) => {
-      return acc + (scores[key] * weight);
+      return acc + scores[key] * weight;
     }, 0);
 
     return {
       overall: Math.round(overall * 100) / 100,
       breakdown: scores,
       grade: this.getGrade(overall),
-      weights: this.weights
+      weights: this.weights,
     };
   }
 
@@ -334,15 +334,17 @@ class QualityScoreCalculator {
 
   calculateHealthScore(healthIndicators) {
     if (healthIndicators.length === 0) return 100;
-    
+
     const statusScores = {
       [HealthStatus.HEALTHY]: 100,
       [HealthStatus.WARNING]: 60,
       [HealthStatus.CRITICAL]: 0,
-      [HealthStatus.UNKNOWN]: 50
+      [HealthStatus.UNKNOWN]: 50,
     };
 
-    const avg = healthIndicators.reduce((acc, h) => acc + statusScores[h.status], 0) / healthIndicators.length;
+    const avg =
+      healthIndicators.reduce((acc, h) => acc + statusScores[h.status], 0) /
+      healthIndicators.length;
     return avg;
   }
 
@@ -353,7 +355,7 @@ class QualityScoreCalculator {
       [TrendDirection.UP]: 100,
       [TrendDirection.STABLE]: 70,
       [TrendDirection.DOWN]: 30,
-      [TrendDirection.UNKNOWN]: 50
+      [TrendDirection.UNKNOWN]: 50,
     };
 
     const avg = trends.reduce((acc, t) => acc + directionScores[t.direction], 0) / trends.length;
@@ -469,7 +471,7 @@ class QualityMetricsDashboard extends EventEmitter {
       coverage: this.getMetricsByCategory(MetricCategory.COVERAGE),
       compliance: this.getMetricsByCategory(MetricCategory.COMPLIANCE),
       health: [...this.healthIndicators.values()],
-      trends: Object.values(this.getTrends())
+      trends: Object.values(this.getTrends()),
     };
 
     const score = this.scoreCalculator.calculate(data);
@@ -483,7 +485,7 @@ class QualityMetricsDashboard extends EventEmitter {
       type,
       name,
       value,
-      timestamp: new Date()
+      timestamp: new Date(),
     });
 
     if (this.history.length > this.maxHistory) {
@@ -532,8 +534,8 @@ class QualityMetricsDashboard extends EventEmitter {
         totalMetrics: metrics.length,
         healthyIndicators: health.filter(h => h.healthy).length,
         totalIndicators: health.length,
-        metricsOnTarget: metrics.filter(m => m.onTarget).length
-      }
+        metricsOnTarget: metrics.filter(m => m.onTarget).length,
+      },
     };
   }
 
@@ -558,12 +560,14 @@ class QualityMetricsDashboard extends EventEmitter {
       `| Trends | ${summary.score.breakdown.trends.toFixed(1)}% |`,
       '',
       '## Metrics',
-      ''
+      '',
     ];
 
     for (const metric of summary.metrics) {
-      const status = metric.onTarget ? '✅' : (metric.onTarget === false ? '⚠️' : '➖');
-      lines.push(`- ${status} **${metric.name}**: ${metric.value.toFixed(1)}${metric.unit === 'percent' ? '%' : ` ${metric.unit}`}`);
+      const status = metric.onTarget ? '✅' : metric.onTarget === false ? '⚠️' : '➖';
+      lines.push(
+        `- ${status} **${metric.name}**: ${metric.value.toFixed(1)}${metric.unit === 'percent' ? '%' : ` ${metric.unit}`}`
+      );
       if (metric.target) {
         lines.push(`  - Target: ${metric.target}%`);
       }
@@ -572,7 +576,7 @@ class QualityMetricsDashboard extends EventEmitter {
     lines.push('', '## Health Indicators', '');
 
     for (const indicator of summary.health) {
-      const icon = indicator.healthy ? '🟢' : (indicator.status === 'warning' ? '🟡' : '🔴');
+      const icon = indicator.healthy ? '🟢' : indicator.status === 'warning' ? '🟡' : '🔴';
       lines.push(`- ${icon} **${indicator.name}**: ${indicator.status}`);
       if (indicator.message) {
         lines.push(`  - ${indicator.message}`);
@@ -582,8 +586,10 @@ class QualityMetricsDashboard extends EventEmitter {
     lines.push('', '## Trends', '');
 
     for (const [name, trend] of Object.entries(summary.trends)) {
-      const icon = trend.direction === 'up' ? '📈' : (trend.direction === 'down' ? '📉' : '➡️');
-      lines.push(`- ${icon} **${name}**: ${trend.direction} (${trend.percentChange?.toFixed(1) || 0}%)`);
+      const icon = trend.direction === 'up' ? '📈' : trend.direction === 'down' ? '📉' : '➡️';
+      lines.push(
+        `- ${icon} **${name}**: ${trend.direction} (${trend.percentChange?.toFixed(1) || 0}%)`
+      );
     }
 
     return lines.join('\n');
@@ -635,7 +641,7 @@ module.exports = {
   MetricCategory,
   HealthStatus,
   TrendDirection,
-  
+
   // Classes
   Metric,
   CoverageMetric,
@@ -644,7 +650,7 @@ module.exports = {
   TrendAnalyzer,
   QualityScoreCalculator,
   QualityMetricsDashboard,
-  
+
   // Factory
-  createQualityDashboard
+  createQualityDashboard,
 };