musubi-sdd 5.0.0 → 5.6.1

package/src/monitoring/observability.js

@@ -1,11 +1,21 @@
 /**
  * Observability Module - Logs, Metrics, and Traces
- * 
+ *
  * Provides unified observability capabilities:
  * - Structured logging
  * - Metrics collection
  * - Distributed tracing
  * - Correlation IDs
+ *
+ * Part of MUSUBI v5.0.0 - Production Readiness
+ *
+ * @module monitoring/observability
+ * @version 1.0.0
+ *
+ * @traceability
+ * - Requirement: REQ-P5-004 (Observability Integration)
+ * - Design: docs/design/tdd-musubi-v5.0.0.md#3.4
+ * - Test: tests/monitoring/observability.test.js
  */
 
 const { EventEmitter } = require('events');
@@ -19,7 +29,7 @@ const LogLevel = {
   INFO: 'info',
   WARN: 'warn',
   ERROR: 'error',
-  FATAL: 'fatal'
+  FATAL: 'fatal',
 };
 
 /**
@@ -31,7 +41,7 @@ const LOG_PRIORITY = {
   [LogLevel.INFO]: 2,
   [LogLevel.WARN]: 3,
   [LogLevel.ERROR]: 4,
-  [LogLevel.FATAL]: 5
+  [LogLevel.FATAL]: 5,
 };
 
 /**
@@ -40,7 +50,7 @@ const LOG_PRIORITY = {
 const TraceStatus = {
   OK: 'ok',
   ERROR: 'error',
-  UNSET: 'unset'
+  UNSET: 'unset',
 };
 
 /**
@@ -51,7 +61,7 @@ const SpanKind = {
   SERVER: 'server',
   CLIENT: 'client',
   PRODUCER: 'producer',
-  CONSUMER: 'consumer'
+  CONSUMER: 'consumer',
 };
 
 /**
@@ -88,7 +98,7 @@ class Logger extends EventEmitter {
       level: this.level,
       context: { ...this.context, ...context },
       outputs: this.outputs,
-      parent: this
+      parent: this,
     });
   }
 
@@ -111,7 +121,7 @@ class Logger extends EventEmitter {
       logger: this.name,
       message,
       ...this.context,
-      ...meta
+      ...meta,
     };
 
     for (const output of this.outputs) {
@@ -121,12 +131,24 @@ class Logger extends EventEmitter {
     this.emit('log', entry);
   }
 
-  trace(message, meta) { this.log(LogLevel.TRACE, message, meta); }
-  debug(message, meta) { this.log(LogLevel.DEBUG, message, meta); }
-  info(message, meta) { this.log(LogLevel.INFO, message, meta); }
-  warn(message, meta) { this.log(LogLevel.WARN, message, meta); }
-  error(message, meta) { this.log(LogLevel.ERROR, message, meta); }
-  fatal(message, meta) { this.log(LogLevel.FATAL, message, meta); }
+  trace(message, meta) {
+    this.log(LogLevel.TRACE, message, meta);
+  }
+  debug(message, meta) {
+    this.log(LogLevel.DEBUG, message, meta);
+  }
+  info(message, meta) {
+    this.log(LogLevel.INFO, message, meta);
+  }
+  warn(message, meta) {
+    this.log(LogLevel.WARN, message, meta);
+  }
+  error(message, meta) {
+    this.log(LogLevel.ERROR, message, meta);
+  }
+  fatal(message, meta) {
+    this.log(LogLevel.FATAL, message, meta);
+  }
 
   /**
    * Add an output
@@ -156,10 +178,8 @@ class ConsoleOutput {
 
   write(entry) {
     if (this.format === 'json') {
-      const output = this.pretty 
-        ? JSON.stringify(entry, null, 2)
-        : JSON.stringify(entry);
-      
+      const output = this.pretty ? JSON.stringify(entry, null, 2) : JSON.stringify(entry);
+
       if (entry.level === LogLevel.ERROR || entry.level === LogLevel.FATAL) {
         console.error(output);
       } else if (entry.level === LogLevel.WARN) {
@@ -187,7 +207,7 @@ class FileOutput {
 
   write(entry) {
     this.buffer.push(JSON.stringify(entry) + '\n');
-    
+
     if (this.buffer.length >= this.bufferSize) {
       this.flush();
     }
@@ -232,7 +252,7 @@ class MetricsCollector extends EventEmitter {
         type: 'counter',
         name: fullName,
         help,
-        values: new Map()
+        values: new Map(),
       });
     }
     return new CounterMetric(this.metrics.get(fullName), this.labels);
@@ -248,7 +268,7 @@ class MetricsCollector extends EventEmitter {
         type: 'gauge',
         name: fullName,
         help,
-        values: new Map()
+        values: new Map(),
       });
     }
     return new GaugeMetric(this.metrics.get(fullName), this.labels);
@@ -265,7 +285,7 @@ class MetricsCollector extends EventEmitter {
         name: fullName,
         help,
         buckets,
-        values: new Map()
+        values: new Map(),
       });
     }
     return new HistogramMetric(this.metrics.get(fullName), this.labels);
@@ -313,13 +333,13 @@ class MetricsCollector extends EventEmitter {
         name: metric.name,
         type: metric.type,
         help: metric.help,
-        values: []
+        values: [],
       };
 
       for (const [labelsKey, value] of metric.values) {
         metricData.values.push({
           labels: labelsKey,
-          value: metric.type === 'histogram' ? { ...value } : value
+          value: metric.type === 'histogram' ? { ...value } : value,
         });
       }
 
@@ -420,12 +440,12 @@ class HistogramMetric {
   observe(value, labels = {}) {
     const key = this._labelKey(labels);
     let data = this.metric.values.get(key);
-    
+
     if (!data) {
       data = {
         buckets: this.metric.buckets.map(() => 0),
         sum: 0,
-        count: 0
+        count: 0,
       };
       this.metric.values.set(key, data);
     }
@@ -490,7 +510,7 @@ class Span {
     this.events.push({
       name,
       timestamp: Date.now(),
-      attributes
+      attributes,
     });
     return this;
   }
@@ -526,7 +546,7 @@ class Span {
   getContext() {
     return {
       traceId: this.traceId,
-      spanId: this.spanId
+      spanId: this.spanId,
     };
   }
 
@@ -544,7 +564,7 @@ class Span {
       statusMessage: this.statusMessage,
       attributes: this.attributes,
       events: this.events,
-      links: this.links
+      links: this.links,
     };
   }
 }
@@ -573,9 +593,9 @@ class Tracer extends EventEmitter {
       attributes: {
         'service.name': this.serviceName,
         'service.version': this.version,
-        ...options.attributes
+        ...options.attributes,
       },
-      links: options.links
+      links: options.links,
     });
 
     this.spans.push(span);
@@ -590,7 +610,7 @@ class Tracer extends EventEmitter {
     return this.startSpan(name, {
       traceId: parent.traceId,
       parentSpanId: parent.spanId,
-      ...options
+      ...options,
     });
   }
 
@@ -600,11 +620,11 @@ class Tracer extends EventEmitter {
   endSpan(span) {
     span.end();
     this.emit('spanEnded', span);
-    
+
     for (const exporter of this.exporters) {
       exporter.export(span);
     }
-    
+
     return span;
   }
 
@@ -712,7 +732,7 @@ class CorrelationContext {
    */
   toHeaders() {
     const headers = {};
-    
+
     if (this.has('traceId')) {
       headers['x-trace-id'] = this.get('traceId');
     }
@@ -722,7 +742,7 @@ class CorrelationContext {
     if (this.has('correlationId')) {
       headers['x-correlation-id'] = this.get('correlationId');
     }
-    
+
     return headers;
   }
 
@@ -731,7 +751,7 @@ class CorrelationContext {
    */
   static fromHeaders(headers) {
     const ctx = new CorrelationContext();
-    
+
     if (headers['x-trace-id']) {
       ctx.set('traceId', headers['x-trace-id']);
     }
@@ -741,7 +761,7 @@ class CorrelationContext {
     if (headers['x-correlation-id']) {
       ctx.set('correlationId', headers['x-correlation-id']);
     }
-    
+
     return ctx;
   }
 }
@@ -754,22 +774,22 @@ class ObservabilityProvider extends EventEmitter {
     super();
     this.serviceName = options.serviceName || 'musubi-service';
     this.version = options.version || '1.0.0';
-    
+
     this.logger = new Logger({
       name: this.serviceName,
-      level: options.logLevel || LogLevel.INFO
+      level: options.logLevel || LogLevel.INFO,
     });
-    
+
     this.metrics = new MetricsCollector({
       name: this.serviceName,
-      prefix: options.metricsPrefix || ''
+      prefix: options.metricsPrefix || '',
     });
-    
+
     this.tracer = new Tracer({
       serviceName: this.serviceName,
-      version: this.version
+      version: this.version,
     });
-    
+
     // Standard metrics
     this._setupStandardMetrics();
   }
@@ -780,9 +800,12 @@ class ObservabilityProvider extends EventEmitter {
   _setupStandardMetrics() {
     // Request metrics
     this.requestCounter = this.metrics.counter('http_requests_total', 'Total HTTP requests');
-    this.requestDuration = this.metrics.histogram('http_request_duration_seconds', 'HTTP request duration');
+    this.requestDuration = this.metrics.histogram(
+      'http_request_duration_seconds',
+      'HTTP request duration'
+    );
     this.requestErrors = this.metrics.counter('http_request_errors_total', 'Total HTTP errors');
-    
+
     // Resource metrics
     this.activeConnections = this.metrics.gauge('active_connections', 'Active connections');
   }
@@ -813,10 +836,10 @@ class ObservabilityProvider extends EventEmitter {
    */
   trace(name, fn, options = {}) {
     const span = this.tracer.startSpan(name, options);
-    
+
     try {
       const result = fn(span);
-      
+
       if (result && typeof result.then === 'function') {
         return result
           .then(r => {
@@ -828,13 +851,13 @@ class ObservabilityProvider extends EventEmitter {
             span.setStatus(TraceStatus.ERROR, err.message);
             span.addEvent('exception', {
               'exception.type': err.name,
-              'exception.message': err.message
+              'exception.message': err.message,
             });
             this.tracer.endSpan(span);
             throw err;
           });
       }
-      
+
       span.setStatus(TraceStatus.OK);
       this.tracer.endSpan(span);
       return result;
@@ -842,7 +865,7 @@ class ObservabilityProvider extends EventEmitter {
       span.setStatus(TraceStatus.ERROR, err.message);
       span.addEvent('exception', {
         'exception.type': err.name,
-        'exception.message': err.message
+        'exception.message': err.message,
       });
       this.tracer.endSpan(span);
       throw err;
@@ -854,10 +877,10 @@ class ObservabilityProvider extends EventEmitter {
    */
   recordRequest(method, path, statusCode, duration) {
     const labels = { method, path, status_code: statusCode.toString() };
-    
+
     this.requestCounter.inc(labels);
     this.requestDuration.observe(duration / 1000, { method, path }); // Convert to seconds
-    
+
     if (statusCode >= 400) {
       this.requestErrors.inc(labels);
     }
@@ -870,10 +893,10 @@ class ObservabilityProvider extends EventEmitter {
     return {
       service: {
         name: this.serviceName,
-        version: this.version
+        version: this.version,
       },
       metrics: this.metrics.toJSON(),
-      traces: this.tracer.getAllSpans()
+      traces: this.tracer.getAllSpans(),
     };
   }
 }
@@ -921,18 +944,18 @@ module.exports = {
   MemoryExporter,
   CorrelationContext,
   ObservabilityProvider,
-  
+
   // Constants
   LogLevel,
   TraceStatus,
   SpanKind,
-  
+
   // Factories
   createLogger,
   createMetricsCollector,
   createTracer,
   createObservability,
-  
+
   // Utilities
-  generateId
+  generateId,
 };

package/src/monitoring/quality-dashboard.js

@@ -1,8 +1,16 @@
 /**
  * Quality Metrics Dashboard
  * カバレッジメトリクス、Constitutional準拠メトリクス、プロジェクトヘルス指標
- * 
+ *
+ * Part of MUSUBI v5.0.0 - Production Readiness
+ *
  * @module monitoring/quality-dashboard
+ * @version 1.0.0
+ *
+ * @traceability
+ * - Requirement: REQ-P5-001 (Quality Dashboard)
+ * - Design: docs/design/tdd-musubi-v5.0.0.md#3.1
+ * - Test: tests/monitoring/quality-dashboard.test.js
  */
 
 const EventEmitter = require('events');
@@ -16,17 +24,17 @@ const METRIC_CATEGORY = {
   QUALITY: 'quality',
   HEALTH: 'health',
   PERFORMANCE: 'performance',
-  CUSTOM: 'custom'
+  CUSTOM: 'custom',
 };
 
 /**
  * Health status levels
  */
 const HEALTH_STATUS = {
-  HEALTHY: 'healthy',        // 80-100%
-  WARNING: 'warning',        // 50-79%
-  CRITICAL: 'critical',      // 20-49%
-  FAILING: 'failing'         // <20%
+  HEALTHY: 'healthy', // 80-100%
+  WARNING: 'warning', // 50-79%
+  CRITICAL: 'critical', // 20-49%
+  FAILING: 'failing', // <20%
 };
 
 /**
@@ -41,7 +49,7 @@ const CONSTITUTIONAL_ARTICLES = {
   INCREMENTAL_ADOPTION: 'article-6',
   SEPARATION_OF_CONCERNS: 'article-7',
   FEEDBACK_LOOPS: 'article-8',
-  GOVERNANCE: 'article-9'
+  GOVERNANCE: 'article-9',
 };
 
 /**
@@ -56,17 +64,17 @@ class QualityDashboard extends EventEmitter {
    */
   constructor(options = {}) {
     super();
-    
+
     this.thresholds = {
       coverage: { healthy: 80, warning: 50, critical: 20 },
       constitutional: { healthy: 90, warning: 70, critical: 50 },
       quality: { healthy: 80, warning: 60, critical: 40 },
-      ...options.thresholds
+      ...options.thresholds,
     };
 
     this.autoCollect = options.autoCollect ?? false;
     this.collectInterval = options.collectInterval ?? 60000;
-    
+
     this.metrics = new Map();
     this.history = [];
     this.collectors = new Map();
@@ -85,25 +93,27 @@ class QualityDashboard extends EventEmitter {
    */
   initializeDefaultCollectors() {
     // Coverage metrics collector
-    this.registerCollector('coverage', async (context) => ({
+    this.registerCollector('coverage', async context => ({
       lines: context?.coverage?.lines ?? 0,
       branches: context?.coverage?.branches ?? 0,
       functions: context?.coverage?.functions ?? 0,
       statements: context?.coverage?.statements ?? 0,
-      overall: context?.coverage?.overall ?? 
-        ((context?.coverage?.lines ?? 0) + 
-         (context?.coverage?.branches ?? 0) + 
-         (context?.coverage?.functions ?? 0) + 
-         (context?.coverage?.statements ?? 0)) / 4
+      overall:
+        context?.coverage?.overall ??
+        ((context?.coverage?.lines ?? 0) +
+          (context?.coverage?.branches ?? 0) +
+          (context?.coverage?.functions ?? 0) +
+          (context?.coverage?.statements ?? 0)) /
+          4,
     }));
 
     // Constitutional compliance collector
-    this.registerCollector('constitutional', async (context) => {
+    this.registerCollector('constitutional', async context => {
       const articles = context?.constitutional ?? {};
       const scores = Object.values(CONSTITUTIONAL_ARTICLES).map(id => ({
         id,
         score: articles[id]?.score ?? 0,
-        compliant: articles[id]?.compliant ?? false
+        compliant: articles[id]?.compliant ?? false,
       }));
 
       const totalScore = scores.reduce((sum, s) => sum + s.score, 0) / scores.length;
@@ -114,25 +124,27 @@ class QualityDashboard extends EventEmitter {
         totalScore,
         compliantCount,
         totalArticles: scores.length,
-        complianceRate: (compliantCount / scores.length) * 100
+        complianceRate: (compliantCount / scores.length) * 100,
       };
     });
 
     // Quality metrics collector
-    this.registerCollector('quality', async (context) => ({
+    this.registerCollector('quality', async context => ({
       codeComplexity: context?.quality?.complexity ?? 0,
       maintainability: context?.quality?.maintainability ?? 0,
       documentation: context?.quality?.documentation ?? 0,
       testQuality: context?.quality?.testQuality ?? 0,
-      overall: context?.quality?.overall ??
+      overall:
+        context?.quality?.overall ??
         ((context?.quality?.complexity ?? 0) +
-         (context?.quality?.maintainability ?? 0) +
-         (context?.quality?.documentation ?? 0) +
-         (context?.quality?.testQuality ?? 0)) / 4
+          (context?.quality?.maintainability ?? 0) +
+          (context?.quality?.documentation ?? 0) +
+          (context?.quality?.testQuality ?? 0)) /
+          4,
     }));
 
     // Health metrics collector
-    this.registerCollector('health', async (context) => {
+    this.registerCollector('health', async _context => {
       const coverage = await this.getMetric('coverage');
       const constitutional = await this.getMetric('constitutional');
       const quality = await this.getMetric('quality');
@@ -149,7 +161,7 @@ class QualityDashboard extends EventEmitter {
         qualityScore,
         overall,
         status: this.calculateStatus(overall, 'quality'),
-        timestamp: new Date().toISOString()
+        timestamp: new Date().toISOString(),
       };
     });
   }
@@ -189,20 +201,20 @@ class QualityDashboard extends EventEmitter {
         const data = await collector(context);
         results[name] = {
           ...data,
-          collectedAt: timestamp
+          collectedAt: timestamp,
         };
         this.metrics.set(name, results[name]);
       } catch (error) {
         results[name] = {
           error: error.message,
-          collectedAt: timestamp
+          collectedAt: timestamp,
         };
       }
     }
 
     const snapshot = {
       timestamp,
-      metrics: { ...results }
+      metrics: { ...results },
     };
 
     this.history.push(snapshot);
@@ -263,20 +275,20 @@ class QualityDashboard extends EventEmitter {
       breakdown: {
         coverage: {
           score: coverage?.overall ?? 0,
-          status: this.calculateStatus(coverage?.overall ?? 0, 'coverage')
+          status: this.calculateStatus(coverage?.overall ?? 0, 'coverage'),
         },
         constitutional: {
           score: constitutional?.totalScore ?? 0,
           status: this.calculateStatus(constitutional?.totalScore ?? 0, 'constitutional'),
           compliantArticles: constitutional?.compliantCount ?? 0,
-          totalArticles: constitutional?.totalArticles ?? 9
+          totalArticles: constitutional?.totalArticles ?? 9,
         },
         quality: {
           score: quality?.overall ?? 0,
-          status: this.calculateStatus(quality?.overall ?? 0, 'quality')
-        }
+          status: this.calculateStatus(quality?.overall ?? 0, 'quality'),
+        },
       },
-      lastUpdated: health?.timestamp ?? null
+      lastUpdated: health?.timestamp ?? null,
     };
   }
 
@@ -292,7 +304,7 @@ class QualityDashboard extends EventEmitter {
       .slice(-limit)
       .map(h => ({
         timestamp: h.timestamp,
-        value: h.metrics[metricName]
+        value: h.metrics[metricName],
       }));
 
     if (data.length < 2) {
@@ -406,7 +418,7 @@ class QualityDashboard extends EventEmitter {
       [HEALTH_STATUS.HEALTHY]: '🟢',
       [HEALTH_STATUS.WARNING]: '🟡',
       [HEALTH_STATUS.CRITICAL]: '🟠',
-      [HEALTH_STATUS.FAILING]: '🔴'
+      [HEALTH_STATUS.FAILING]: '🔴',
     };
     return emojis[status] || '⚪';
   }
@@ -448,7 +460,7 @@ class QualityDashboard extends EventEmitter {
   setThresholds(category, thresholds) {
     this.thresholds[category] = {
       ...this.thresholds[category],
-      ...thresholds
+      ...thresholds,
     };
   }
 
@@ -462,7 +474,7 @@ class QualityDashboard extends EventEmitter {
       collectorsCount: this.collectors.size,
       historyCount: this.history.length,
       autoCollecting: this.intervalId !== null,
-      thresholds: { ...this.thresholds }
+      thresholds: { ...this.thresholds },
     };
   }
 }
@@ -479,5 +491,5 @@ module.exports = {
   createQualityDashboard,
   METRIC_CATEGORY,
   HEALTH_STATUS,
-  CONSTITUTIONAL_ARTICLES
+  CONSTITUTIONAL_ARTICLES,
 };