musubi-sdd 6.2.2 → 6.3.0

package/src/dashboard/sprint-reporter.js

@@ -1,8 +1,8 @@
 /**
  * SprintReporter Implementation
- * 
+ *
  * Generates sprint completion reports.
- * 
+ *
  * Requirement: IMP-6.2-003-04
  * Design: Section 4.4
  */
@@ -14,12 +14,12 @@ const path = require('path');
  * Default configuration
  */
 const DEFAULT_CONFIG = {
-  storageDir: 'storage/reports'
+  storageDir: 'storage/reports',
 };
 
 /**
  * SprintReporter
- * 
+ *
  * Generates and manages sprint reports.
  */
 class SprintReporter {
@@ -46,12 +46,12 @@ class SprintReporter {
         start: sprint.startDate,
         end: sprint.endDate,
         startedAt: sprint.startedAt,
-        completedAt: sprint.completedAt
+        completedAt: sprint.completedAt,
       },
       metrics: this.calculateMetrics(sprint),
       taskSummary: this.summarizeTasks(sprint),
       velocityAnalysis: this.analyzeVelocity(sprint),
-      recommendations: this.generateRecommendations(sprint)
+      recommendations: this.generateRecommendations(sprint),
     };
 
     await this.saveReport(report);
@@ -81,18 +81,14 @@ class SprintReporter {
       totalPoints,
       completedPoints,
       remainingPoints: totalPoints - completedPoints,
-      completionRate: tasks.length > 0 
-        ? Math.round((completedTasks.length / tasks.length) * 100) 
-        : 0,
-      pointsCompletionRate: totalPoints > 0 
-        ? Math.round((completedPoints / totalPoints) * 100) 
-        : 0,
+      completionRate:
+        tasks.length > 0 ? Math.round((completedTasks.length / tasks.length) * 100) : 0,
+      pointsCompletionRate: totalPoints > 0 ? Math.round((completedPoints / totalPoints) * 100) : 0,
       plannedVelocity,
       actualVelocity,
       velocityDiff,
-      velocityAccuracy: plannedVelocity > 0 
-        ? Math.round((actualVelocity / plannedVelocity) * 100) 
-        : 0
+      velocityAccuracy:
+        plannedVelocity > 0 ? Math.round((actualVelocity / plannedVelocity) * 100) : 0,
     };
   }
 
@@ -107,34 +103,34 @@ class SprintReporter {
     const byStatus = {
       todo: tasks.filter(t => t.status === 'todo'),
       inProgress: tasks.filter(t => t.status === 'in-progress'),
-      done: tasks.filter(t => t.status === 'done')
+      done: tasks.filter(t => t.status === 'done'),
     };
 
     const byPriority = {
       critical: tasks.filter(t => t.priority === 'critical'),
       high: tasks.filter(t => t.priority === 'high'),
       medium: tasks.filter(t => t.priority === 'medium'),
-      low: tasks.filter(t => t.priority === 'low')
+      low: tasks.filter(t => t.priority === 'low'),
     };
 
     const completedByPriority = {
       critical: byPriority.critical.filter(t => t.status === 'done').length,
       high: byPriority.high.filter(t => t.status === 'done').length,
       medium: byPriority.medium.filter(t => t.status === 'done').length,
-      low: byPriority.low.filter(t => t.status === 'done').length
+      low: byPriority.low.filter(t => t.status === 'done').length,
     };
 
     return {
       byStatus: {
         todo: byStatus.todo.length,
         inProgress: byStatus.inProgress.length,
-        done: byStatus.done.length
+        done: byStatus.done.length,
       },
       byPriority: {
         critical: byPriority.critical.length,
         high: byPriority.high.length,
         medium: byPriority.medium.length,
-        low: byPriority.low.length
+        low: byPriority.low.length,
       },
       completedByPriority,
       incompleteTasks: [...byStatus.todo, ...byStatus.inProgress].map(t => ({
@@ -142,8 +138,8 @@ class SprintReporter {
         title: t.title,
         priority: t.priority,
         storyPoints: t.storyPoints,
-        status: t.status
-      }))
+        status: t.status,
+      })),
     };
   }
 
@@ -154,7 +150,7 @@ class SprintReporter {
    */
   analyzeVelocity(sprint) {
     const metrics = this.calculateMetrics(sprint);
-    
+
     let status;
     if (metrics.velocityAccuracy >= 90 && metrics.velocityAccuracy <= 110) {
       status = 'on-target';
@@ -171,7 +167,7 @@ class SprintReporter {
       actual: metrics.actualVelocity,
       difference: metrics.velocityDiff,
       accuracy: metrics.velocityAccuracy,
-      status
+      status,
     };
   }
 
@@ -190,23 +186,26 @@ class SprintReporter {
       recommendations.push({
         type: 'velocity',
         severity: 'high',
-        message: 'スプリントの実績ベロシティが計画の70%未満でした。次のスプリントでは計画ベロシティを下げることを検討してください。'
+        message:
+          'スプリントの実績ベロシティが計画の70%未満でした。次のスプリントでは計画ベロシティを下げることを検討してください。',
       });
     } else if (metrics.velocityAccuracy > 130) {
       recommendations.push({
         type: 'velocity',
         severity: 'medium',
-        message: '計画以上のベロシティを達成しました。次のスプリントでは計画ベロシティを上げることを検討してください。'
+        message:
+          '計画以上のベロシティを達成しました。次のスプリントでは計画ベロシティを上げることを検討してください。',
       });
     }
 
     // Incomplete critical tasks
-    const incompleteCritical = taskSummary.byPriority.critical - taskSummary.completedByPriority.critical;
+    const incompleteCritical =
+      taskSummary.byPriority.critical - taskSummary.completedByPriority.critical;
     if (incompleteCritical > 0) {
       recommendations.push({
         type: 'priority',
         severity: 'critical',
-        message: `${incompleteCritical}件のクリティカルタスクが未完了です。次のスプリントで優先的に対応してください。`
+        message: `${incompleteCritical}件のクリティカルタスクが未完了です。次のスプリントで優先的に対応してください。`,
       });
     }
 
@@ -215,7 +214,8 @@ class SprintReporter {
       recommendations.push({
         type: 'planning',
         severity: 'high',
-        message: 'タスク完了率が50%未満です。タスクの見積もりや優先順位付けの改善を検討してください。'
+        message:
+          'タスク完了率が50%未満です。タスクの見積もりや優先順位付けの改善を検討してください。',
       });
     }
 
@@ -224,7 +224,8 @@ class SprintReporter {
       recommendations.push({
         type: 'wip',
         severity: 'medium',
-        message: '進行中のタスクが多すぎます。WIP制限を設けてフォーカスを高めることを検討してください。'
+        message:
+          '進行中のタスクが多すぎます。WIP制限を設けてフォーカスを高めることを検討してください。',
       });
     }
 
@@ -271,7 +272,7 @@ class SprintReporter {
       'on-target': '✅',
       'over-performing': '🚀',
       'slightly-under': '⚠️',
-      'under-performing': '❌'
+      'under-performing': '❌',
     };
     lines.push(`Status: ${statusEmoji[va.status] || '❓'} **${va.status}**`);
     lines.push('');
@@ -286,10 +287,18 @@ class SprintReporter {
     lines.push('');
 
     lines.push('### By Priority');
-    lines.push(`- 🔴 Critical: ${report.taskSummary.completedByPriority.critical}/${report.taskSummary.byPriority.critical}`);
-    lines.push(`- 🟠 High: ${report.taskSummary.completedByPriority.high}/${report.taskSummary.byPriority.high}`);
-    lines.push(`- 🟡 Medium: ${report.taskSummary.completedByPriority.medium}/${report.taskSummary.byPriority.medium}`);
-    lines.push(`- 🟢 Low: ${report.taskSummary.completedByPriority.low}/${report.taskSummary.byPriority.low}`);
+    lines.push(
+      `- 🔴 Critical: ${report.taskSummary.completedByPriority.critical}/${report.taskSummary.byPriority.critical}`
+    );
+    lines.push(
+      `- 🟠 High: ${report.taskSummary.completedByPriority.high}/${report.taskSummary.byPriority.high}`
+    );
+    lines.push(
+      `- 🟡 Medium: ${report.taskSummary.completedByPriority.medium}/${report.taskSummary.byPriority.medium}`
+    );
+    lines.push(
+      `- 🟢 Low: ${report.taskSummary.completedByPriority.low}/${report.taskSummary.byPriority.low}`
+    );
     lines.push('');
 
     // Incomplete Tasks
@@ -310,7 +319,7 @@ class SprintReporter {
         critical: '🔴',
         high: '🟠',
         medium: '🟡',
-        low: '🟢'
+        low: '🟢',
       };
       for (const rec of report.recommendations) {
         lines.push(`${severityEmoji[rec.severity] || '❓'} **${rec.type}**: ${rec.message}`);
@@ -327,7 +336,7 @@ class SprintReporter {
    */
   async saveReport(report) {
     await this.ensureStorageDir();
-    
+
     const filePath = path.join(this.config.storageDir, `${report.id}.json`);
     await fs.writeFile(filePath, JSON.stringify(report, null, 2), 'utf-8');
   }

package/src/dashboard/transition-recorder.js

@@ -1,8 +1,8 @@
 /**
  * TransitionRecorder Implementation
- * 
+ *
  * Records stage transitions with timestamps and reviewers.
- * 
+ *
  * Requirement: IMP-6.2-003-02
  * Design: Section 4.2
  */
@@ -14,12 +14,12 @@ const path = require('path');
  * Default configuration
  */
 const DEFAULT_CONFIG = {
-  storageDir: 'storage/transitions'
+  storageDir: 'storage/transitions',
 };
 
 /**
  * TransitionRecorder
- * 
+ *
  * Records and manages workflow stage transitions.
  */
 class TransitionRecorder {
@@ -37,10 +37,10 @@ class TransitionRecorder {
    * @returns {Promise<Object>} Created transition record
    */
   async recordTransition(featureId, transition) {
-    const history = await this.getHistory(featureId) || {
+    const history = (await this.getHistory(featureId)) || {
       featureId,
       transitions: [],
-      createdAt: new Date().toISOString()
+      createdAt: new Date().toISOString(),
     };
 
     const record = {
@@ -52,7 +52,7 @@ class TransitionRecorder {
       reviewResult: transition.reviewResult || null,
       artifacts: transition.artifacts || [],
       notes: transition.notes || null,
-      timestamp: new Date().toISOString()
+      timestamp: new Date().toISOString(),
     };
 
     history.transitions.push(record);
@@ -70,10 +70,7 @@ class TransitionRecorder {
    */
   async getHistory(featureId) {
     try {
-      const filePath = path.join(
-        this.config.storageDir,
-        `${featureId}-transitions.json`
-      );
+      const filePath = path.join(this.config.storageDir, `${featureId}-transitions.json`);
       const content = await fs.readFile(filePath, 'utf-8');
       return JSON.parse(content);
     } catch {
@@ -146,7 +143,7 @@ class TransitionRecorder {
         successfulTransitions: 0,
         failedTransitions: 0,
         averageTime: 0,
-        stageTransitions: {}
+        stageTransitions: {},
       };
     }
 
@@ -174,7 +171,7 @@ class TransitionRecorder {
       successfulTransitions: successful,
       failedTransitions: failed,
       averageTime,
-      stageTransitions
+      stageTransitions,
     };
   }
 
@@ -185,11 +182,8 @@ class TransitionRecorder {
    */
   async saveHistory(featureId, history) {
     await this.ensureStorageDir();
-    
-    const filePath = path.join(
-      this.config.storageDir,
-      `${featureId}-transitions.json`
-    );
+
+    const filePath = path.join(this.config.storageDir, `${featureId}-transitions.json`);
 
     await fs.writeFile(filePath, JSON.stringify(history, null, 2), 'utf-8');
   }

package/src/dashboard/workflow-dashboard.js

@@ -1,8 +1,8 @@
 /**
  * WorkflowDashboard Implementation
- * 
+ *
  * Manages workflow state and progress visualization.
- * 
+ *
  * Requirement: IMP-6.2-003-01
  * Design: Section 4.1
  */
@@ -13,13 +13,7 @@ const path = require('path');
 /**
  * Valid workflow stages
  */
-const WORKFLOW_STAGES = [
-  'steering',
-  'requirements',
-  'design',
-  'implementation',
-  'validation'
-];
+const WORKFLOW_STAGES = ['steering', 'requirements', 'design', 'implementation', 'validation'];
 
 /**
  * Stage statuses
@@ -28,19 +22,19 @@ const STAGE_STATUS = {
   NOT_STARTED: 'not-started',
   IN_PROGRESS: 'in-progress',
   COMPLETED: 'completed',
-  BLOCKED: 'blocked'
+  BLOCKED: 'blocked',
 };
 
 /**
  * Default configuration
  */
 const DEFAULT_CONFIG = {
-  storageDir: 'storage/workflows'
+  storageDir: 'storage/workflows',
 };
 
 /**
  * WorkflowDashboard
- * 
+ *
  * Manages workflow state and progress for features.
  */
 class WorkflowDashboard {
@@ -60,13 +54,13 @@ class WorkflowDashboard {
    */
   async createWorkflow(featureId, options = {}) {
     const stages = {};
-    
+
     for (const stage of WORKFLOW_STAGES) {
       stages[stage] = {
         status: STAGE_STATUS.NOT_STARTED,
         startedAt: null,
         completedAt: null,
-        artifacts: []
+        artifacts: [],
       };
     }
 
@@ -83,7 +77,7 @@ class WorkflowDashboard {
       currentStage: 'steering',
       stages,
       blockers: [],
-      metadata: options.metadata || {}
+      metadata: options.metadata || {},
     };
 
     this.workflows.set(featureId, workflow);
@@ -165,7 +159,7 @@ class WorkflowDashboard {
       severity: blocker.severity || 'medium',
       createdAt: new Date().toISOString(),
       resolvedAt: null,
-      resolution: null
+      resolution: null,
     };
 
     workflow.blockers.push(blockerEntry);
@@ -203,9 +197,7 @@ class WorkflowDashboard {
     blocker.resolution = resolution;
 
     // Check if stage can be unblocked
-    const stageBlockers = workflow.blockers.filter(
-      b => b.stage === blocker.stage && !b.resolvedAt
-    );
+    const stageBlockers = workflow.blockers.filter(b => b.stage === blocker.stage && !b.resolvedAt);
 
     if (stageBlockers.length === 0 && workflow.stages[blocker.stage]) {
       workflow.stages[blocker.stage].status = STAGE_STATUS.IN_PROGRESS;
@@ -239,7 +231,7 @@ class WorkflowDashboard {
         type: 'resolve-blocker',
         priority: 'high',
         description: `${unresolvedBlockers.length}件のブロッカーを解決してください`,
-        blockers: unresolvedBlockers
+        blockers: unresolvedBlockers,
       });
     }
 
@@ -250,7 +242,7 @@ class WorkflowDashboard {
           type: 'create-artifact',
           priority: 'medium',
           description: 'プロジェクトメモリファイルを作成してください',
-          artifacts: ['structure.md', 'tech.md', 'product.md']
+          artifacts: ['structure.md', 'tech.md', 'product.md'],
         });
         break;
       case 'requirements':
@@ -258,7 +250,7 @@ class WorkflowDashboard {
           type: 'create-artifact',
           priority: 'medium',
           description: 'EARS形式の要件ドキュメントを作成してください',
-          artifacts: ['requirements.md']
+          artifacts: ['requirements.md'],
         });
         break;
       case 'design':
@@ -266,21 +258,21 @@ class WorkflowDashboard {
           type: 'create-artifact',
           priority: 'medium',
           description: 'C4設計ドキュメントとADRを作成してください',
-          artifacts: ['design.md', 'adr-*.md']
+          artifacts: ['design.md', 'adr-*.md'],
         });
         break;
       case 'implementation':
         actions.push({
           type: 'run-review',
           priority: 'medium',
-          description: 'レビューゲートを実行して実装を検証してください'
+          description: 'レビューゲートを実行して実装を検証してください',
         });
         break;
       case 'validation':
         actions.push({
           type: 'complete-validation',
           priority: 'medium',
-          description: '全てのテストが通過していることを確認してください'
+          description: '全てのテストが通過していることを確認してください',
         });
         break;
     }
@@ -336,8 +328,8 @@ class WorkflowDashboard {
       stages: Object.entries(workflow.stages).map(([name, data]) => ({
         name,
         status: data.status,
-        artifactCount: data.artifacts.length
-      }))
+        artifactCount: data.artifacts.length,
+      })),
     };
   }
 
@@ -362,11 +354,8 @@ class WorkflowDashboard {
    */
   async saveWorkflow(workflow) {
     await this.ensureStorageDir();
-    
-    const filePath = path.join(
-      this.config.storageDir,
-      `${workflow.featureId}.json`
-    );
+
+    const filePath = path.join(this.config.storageDir, `${workflow.featureId}.json`);
 
     await fs.writeFile(filePath, JSON.stringify(workflow, null, 2), 'utf-8');
     this.workflows.set(workflow.featureId, workflow);
@@ -398,7 +387,7 @@ class WorkflowDashboard {
       await this.ensureStorageDir();
       const files = await fs.readdir(this.config.storageDir);
       const workflows = [];
-      
+
       for (const file of files) {
         if (file.endsWith('.json')) {
           const featureId = file.replace('.json', '');
@@ -408,7 +397,7 @@ class WorkflowDashboard {
           }
         }
       }
-      
+
       return workflows;
     } catch {
       return [];
@@ -427,8 +416,8 @@ class WorkflowDashboard {
   }
 }
 
-module.exports = { 
-  WorkflowDashboard, 
-  WORKFLOW_STAGES, 
-  STAGE_STATUS 
+module.exports = {
+  WorkflowDashboard,
+  WORKFLOW_STAGES,
+  STAGE_STATUS,
 };