musubi-sdd 5.0.0 → 5.6.1

package/src/analyzers/stuck-detector.js

@@ -1,8 +1,8 @@
 /**
  * MUSUBI Stuck Detector
- * 
+ *
  * AIエージェントのスタック状態（無限ループ、繰り返しエラー）を検出
- * 
+ *
  * @module src/analyzers/stuck-detector
  * @see REQ-P0-B001
  * @inspired-by OpenHands openhands/controller/stuck.py
@@ -52,7 +52,7 @@ const Severity = {
 
 /**
  * イベントのハッシュを生成
- * @param {Object} event 
+ * @param {Object} event
  * @returns {string}
  */
 function hashEvent(event) {
@@ -131,7 +131,7 @@ class StuckDetector {
     this.maxMonologueSteps = options.maxMonologueSteps || 10;
     this.maxContextErrors = options.maxContextErrors || 3;
     this.maxStageOscillations = options.maxStageOscillations || 3;
-    
+
     this.history = [];
     this.stuckAnalysis = null;
   }
@@ -252,11 +252,11 @@ class StuckDetector {
 
     const lastN = this.history.slice(-this.maxRepeatErrors);
     const allErrors = lastN.every(e => e.type === EventType.ERROR);
-    
+
     if (allErrors) {
       const firstHash = lastN[0].hash;
       const sameError = lastN.every(e => e.hash === firstHash);
-      
+
       if (sameError) {
         return new StuckAnalysis({
           loopType: LoopType.ERROR_LOOP,
@@ -282,10 +282,11 @@ class StuckDetector {
     }
 
     const lastN = this.history.slice(-this.maxMonologueSteps);
-    const allMessages = lastN.every(e => 
-      e.type === EventType.MESSAGE && 
-      !e.content.includes('```') &&  // コードブロックなし
-      e.content.length < 500  // 短いメッセージ
+    const allMessages = lastN.every(
+      e =>
+        e.type === EventType.MESSAGE &&
+        !e.content.includes('```') && // コードブロックなし
+        e.content.length < 500 // 短いメッセージ
     );
 
     if (allMessages) {
@@ -320,11 +321,12 @@ class StuckDetector {
     ];
 
     const lastN = this.history.slice(-this.maxContextErrors);
-    const allContextErrors = lastN.every(e => 
-      e.type === EventType.ERROR &&
-      contextErrorPatterns.some(pattern => 
-        e.content.toLowerCase().includes(pattern.toLowerCase())
-      )
+    const allContextErrors = lastN.every(
+      e =>
+        e.type === EventType.ERROR &&
+        contextErrorPatterns.some(pattern =>
+          e.content.toLowerCase().includes(pattern.toLowerCase())
+        )
     );
 
     if (allContextErrors) {
@@ -353,7 +355,7 @@ class StuckDetector {
 
     const lastN = this.history.slice(-minEvents);
     const stages = lastN.map(e => e.stage);
-    
+
     // 2つのステージ間を往復しているかチェック
     const uniqueStages = [...new Set(stages)];
     if (uniqueStages.length !== 2) {
@@ -383,7 +385,7 @@ class StuckDetector {
 
   /**
    * 代替アプローチを提案
-   * @param {string} loopType 
+   * @param {string} loopType
    * @returns {string[]}
    */
   _suggestAlternatives(loopType) {

package/src/converters/index.js

@@ -1,6 +1,6 @@
 /**
  * Converters Module
- * 
+ *
  * Cross-format conversion between MUSUBI and Spec Kit
  */
 
@@ -20,21 +20,27 @@ const irTypes = require('./ir/types');
  * @returns {Promise<{filesConverted: number, warnings: string[], outputPath: string}>}
  */
 async function convertFromSpeckit(sourcePath, options = {}) {
-  const { output = '.', dryRun = false, force = false, verbose = false, preserveRaw = false } = options;
-  
+  const {
+    output = '.',
+    dryRun = false,
+    force = false,
+    verbose = false,
+    preserveRaw = false,
+  } = options;
+
   if (verbose) console.log(`Converting Spec Kit project from: ${sourcePath}`);
-  
+
   // Parse Spec Kit project to IR
   const ir = await parseSpeckitProject(sourcePath);
-  
+
   if (verbose) {
     console.log(`  Found ${ir.features.length} features`);
     console.log(`  Found ${ir.constitution.articles.length} constitution articles`);
   }
-  
+
   // Write to MUSUBI format
   const result = await writeMusubiProject(ir, output, { dryRun, force, preserveRaw, verbose });
-  
+
   return {
     filesConverted: result.filesWritten,
     warnings: result.warnings,
@@ -48,28 +54,33 @@ async function convertFromSpeckit(sourcePath, options = {}) {
  * @returns {Promise<{filesConverted: number, warnings: string[], outputPath: string}>}
  */
 async function convertToSpeckit(options = {}) {
-  const { 
-    source = '.', 
-    output = './.specify', 
-    dryRun = false, 
-    force = false, 
-    verbose = false, 
-    preserveRaw = false 
+  const {
+    source = '.',
+    output = './.specify',
+    dryRun = false,
+    force = false,
+    verbose = false,
+    preserveRaw = false,
   } = options;
-  
+
   if (verbose) console.log(`Converting MUSUBI project to Spec Kit format`);
-  
+
   // Parse MUSUBI project to IR
   const ir = await parseMusubiProject(source);
-  
+
   if (verbose) {
     console.log(`  Found ${ir.features.length} features`);
     console.log(`  Found ${ir.constitution.articles.length} constitution articles`);
   }
-  
+
   // Write to Spec Kit format
-  const result = await writeSpeckitProject(ir, output.replace('/.specify', ''), { dryRun, force, preserveRaw, verbose });
-  
+  const result = await writeSpeckitProject(ir, output.replace('/.specify', ''), {
+    dryRun,
+    force,
+    preserveRaw,
+    verbose,
+  });
+
   return {
     filesConverted: result.filesWritten,
     warnings: result.warnings,
@@ -86,7 +97,7 @@ async function convertToSpeckit(options = {}) {
 async function validateFormat(format, projectPath) {
   const errors = [];
   const warnings = [];
-  
+
   try {
     if (format === 'speckit') {
       await parseSpeckitProject(projectPath);
@@ -98,7 +109,7 @@ async function validateFormat(format, projectPath) {
   } catch (error) {
     errors.push(error.message);
   }
-  
+
   return {
     valid: errors.length === 0,
     errors,
@@ -115,36 +126,38 @@ async function validateFormat(format, projectPath) {
 async function testRoundtrip(projectPath, options = {}) {
   const { verbose = false } = options;
   const differences = [];
-  
+
   try {
     // Detect format
     const fs = require('fs-extra');
     const path = require('path');
-    
+
     const isSpeckit = await fs.pathExists(path.join(projectPath, '.specify'));
     const isMusubi = await fs.pathExists(path.join(projectPath, 'steering'));
-    
+
     if (!isSpeckit && !isMusubi) {
       return {
         passed: false,
         similarity: 0,
-        differences: ['Could not detect project format (neither .specify nor steering directory found)'],
+        differences: [
+          'Could not detect project format (neither .specify nor steering directory found)',
+        ],
       };
     }
-    
+
     if (verbose) {
       console.log(`Detected format: ${isSpeckit ? 'Spec Kit' : 'MUSUBI'}`);
     }
-    
+
     // Parse original
-    const originalIR = isSpeckit 
+    const originalIR = isSpeckit
       ? await parseSpeckitProject(projectPath)
       : await parseMusubiProject(projectPath);
-    
+
     // Convert to other format (in memory)
     const tempDir = path.join(projectPath, '.roundtrip-temp');
     await fs.ensureDir(tempDir);
-    
+
     try {
       // Write to other format
       if (isSpeckit) {
@@ -152,34 +165,34 @@ async function testRoundtrip(projectPath, options = {}) {
       } else {
         await writeSpeckitProject(originalIR, tempDir, { force: true });
       }
-      
+
       // Parse converted
       const convertedIR = isSpeckit
         ? await parseMusubiProject(tempDir)
         : await parseSpeckitProject(tempDir);
-      
+
       // Write back to original format
       const tempDir2 = path.join(projectPath, '.roundtrip-temp2');
       await fs.ensureDir(tempDir2);
-      
+
       if (isSpeckit) {
         await writeSpeckitProject(convertedIR, tempDir2, { force: true });
       } else {
         await writeMusubiProject(convertedIR, tempDir2, { force: true });
       }
-      
+
       // Parse roundtrip result
       const roundtripIR = isSpeckit
         ? await parseSpeckitProject(tempDir2)
         : await parseMusubiProject(tempDir2);
-      
+
       // Compare
       const similarity = compareIR(originalIR, roundtripIR, differences);
-      
+
       // Cleanup
       await fs.remove(tempDir);
       await fs.remove(tempDir2);
-      
+
       return {
         passed: similarity >= 90,
         similarity,
@@ -206,27 +219,33 @@ async function testRoundtrip(projectPath, options = {}) {
  * @returns {Promise<{featuresCreated: number, requirementsCreated: number, warnings: string[], outputPath: string}>}
  */
 async function convertFromOpenAPI(specPath, options = {}) {
-  const { output = '.', dryRun = false, force = false, verbose = false, featureName } = options;
-  
+  const {
+    output = '.',
+    dryRun = false,
+    force = false,
+    verbose = false,
+    featureName: _featureName,
+  } = options;
+
   if (verbose) console.log(`Converting OpenAPI spec from: ${specPath}`);
-  
+
   // Parse OpenAPI spec to IR
   const ir = await parseOpenAPISpec(specPath);
-  
+
   // Count requirements
   let requirementsCreated = 0;
   for (const feature of ir.features) {
     requirementsCreated += feature.requirements?.length || 0;
   }
-  
+
   if (verbose) {
     console.log(`  Found ${ir.features.length} features`);
     console.log(`  Found ${requirementsCreated} requirements`);
   }
-  
+
   // Write to MUSUBI format
   const result = await writeMusubiProject(ir, output, { dryRun, force, verbose });
-  
+
   return {
     featuresCreated: ir.features.length,
     requirementsCreated,
@@ -237,15 +256,15 @@ async function convertFromOpenAPI(specPath, options = {}) {
 
 /**
  * Compare two IR structures and return similarity percentage
- * @param {import('./ir/types').ProjectIR} original 
- * @param {import('./ir/types').ProjectIR} roundtrip 
- * @param {string[]} differences 
+ * @param {import('./ir/types').ProjectIR} original
+ * @param {import('./ir/types').ProjectIR} roundtrip
+ * @param {string[]} differences
  * @returns {number} Similarity percentage (0-100)
  */
 function compareIR(original, roundtrip, differences) {
   let matches = 0;
   let total = 0;
-  
+
   // Compare metadata
   total++;
   if (original.metadata.name === roundtrip.metadata.name) {
@@ -253,20 +272,22 @@ function compareIR(original, roundtrip, differences) {
   } else {
     differences.push(`Name mismatch: "${original.metadata.name}" vs "${roundtrip.metadata.name}"`);
   }
-  
+
   // Compare features count
   total++;
   if (original.features.length === roundtrip.features.length) {
     matches++;
   } else {
-    differences.push(`Feature count mismatch: ${original.features.length} vs ${roundtrip.features.length}`);
+    differences.push(
+      `Feature count mismatch: ${original.features.length} vs ${roundtrip.features.length}`
+    );
   }
-  
+
   // Compare each feature
   for (let i = 0; i < Math.min(original.features.length, roundtrip.features.length); i++) {
     const origFeature = original.features[i];
     const rtFeature = roundtrip.features[i];
-    
+
     // Compare feature name
     total++;
     if (origFeature.name === rtFeature.name) {
@@ -274,7 +295,7 @@ function compareIR(original, roundtrip, differences) {
     } else {
       differences.push(`Feature ${i} name mismatch: "${origFeature.name}" vs "${rtFeature.name}"`);
     }
-    
+
     // Compare requirements count
     total++;
     const origReqs = origFeature.specification?.requirements?.length || 0;
@@ -284,7 +305,7 @@ function compareIR(original, roundtrip, differences) {
     } else {
       differences.push(`Feature ${i} requirements count mismatch: ${origReqs} vs ${rtReqs}`);
     }
-    
+
     // Compare tasks count
     total++;
     const origTasks = origFeature.tasks?.length || 0;
@@ -295,7 +316,7 @@ function compareIR(original, roundtrip, differences) {
       differences.push(`Feature ${i} tasks count mismatch: ${origTasks} vs ${rtTasks}`);
     }
   }
-  
+
   // Compare constitution articles
   total++;
   const origArticles = original.constitution?.articles?.length || 0;
@@ -305,7 +326,7 @@ function compareIR(original, roundtrip, differences) {
   } else {
     differences.push(`Constitution articles count mismatch: ${origArticles} vs ${rtArticles}`);
   }
-  
+
   return Math.round((matches / total) * 100);
 }
 

package/src/converters/ir/types.js

@@ -1,6 +1,6 @@
 /**
  * Intermediate Representation (IR) Types for Cross-Format Conversion
- * 
+ *
  * Enables bidirectional conversion between MUSUBI and Spec Kit formats
  * with minimal information loss.
  */
@@ -369,7 +369,7 @@ function createEmptyFeatureIR(id, name) {
 function createRequirementFromEARS(id, statement) {
   const pattern = detectEARSPattern(statement);
   const parsed = parseEARSStatement(statement, pattern);
-  
+
   return {
     id,
     title: '',
@@ -390,7 +390,7 @@ function createRequirementFromEARS(id, statement) {
  */
 function detectEARSPattern(statement) {
   const upper = statement.toUpperCase();
-  
+
   if (upper.includes('WHILE') && upper.includes('WHEN')) {
     return 'complex';
   }
@@ -412,33 +412,33 @@ function detectEARSPattern(statement) {
  * @param {EARSPattern} pattern - EARS pattern
  * @returns {{trigger?: string, condition?: string, action: string}}
  */
-function parseEARSStatement(statement, pattern) {
+function parseEARSStatement(statement, _pattern) {
   const result = { action: '' };
-  
+
   // Extract SHALL clause
   const shallMatch = statement.match(/SHALL\s+(.+?)(?:\.|$)/i);
   if (shallMatch) {
     result.action = shallMatch[1].trim();
   }
-  
+
   // Extract WHEN clause
   const whenMatch = statement.match(/WHEN\s+(.+?),/i);
   if (whenMatch) {
     result.trigger = whenMatch[1].trim();
   }
-  
+
   // Extract WHILE clause
   const whileMatch = statement.match(/WHILE\s+(.+?),/i);
   if (whileMatch) {
     result.condition = whileMatch[1].trim();
   }
-  
+
   // Extract WHERE clause
   const whereMatch = statement.match(/WHERE\s+(.+?),/i);
   if (whereMatch) {
     result.condition = whereMatch[1].trim();
   }
-  
+
   return result;
 }
 
@@ -452,7 +452,7 @@ function userScenarioToRequirement(userScenario, reqId) {
   // Convert "As a [actor], I want [action] so that [benefit]"
   // to "WHEN the [actor] [action], the system SHALL [provide benefit]"
   const statement = `WHEN the ${userScenario.actor} ${userScenario.action}, the system SHALL ${userScenario.benefit}.`;
-  
+
   return {
     id: reqId,
     title: userScenario.title,
@@ -477,7 +477,7 @@ function requirementToUserScenario(requirement, storyId) {
   let actor = 'user';
   let action = requirement.trigger || 'performs an action';
   let benefit = requirement.action;
-  
+
   // Try to extract actor from trigger
   if (requirement.trigger) {
     const actorMatch = requirement.trigger.match(/the\s+(\w+)/i);
@@ -485,7 +485,7 @@ function requirementToUserScenario(requirement, storyId) {
       actor = actorMatch[1];
     }
   }
-  
+
   return {
     id: storyId,
     title: requirement.title || `Story for ${requirement.id}`,