musubi-sdd 6.2.1 → 6.3.0

package/src/traceability/gap-detector.js

@@ -1,8 +1,8 @@
 /**
  * GapDetector Implementation
- * 
+ *
  * Detects requirements without implementation or tests.
- * 
+ *
  * Requirement: IMP-6.2-004-02
  * Design: Section 5.2
  */
@@ -14,32 +14,35 @@ const SEVERITY_MAP = {
   'no-test': 'critical',
   'no-code': 'high',
   'no-design': 'medium',
-  'no-commit': 'low'
+  'no-commit': 'low',
 };
 
 /**
  * Severity ordering for sorting
  */
 const SEVERITY_ORDER = {
-  'critical': 0,
-  'high': 1,
-  'medium': 2,
-  'low': 3
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3,
 };
 
 /**
  * Suggestions for each gap type
  */
 const SUGGESTIONS = {
-  'no-test': 'この要件に対するテストを作成してください。Article III (Test-First) に従い、実装前にテストを書くことを推奨します。',
+  'no-test':
+    'この要件に対するテストを作成してください。Article III (Test-First) に従い、実装前にテストを書くことを推奨します。',
   'no-code': '要件の実装が必要です。設計ドキュメントを参照して実装を開始してください。',
-  'no-design': '設計ドキュメントを作成してください。C4モデルに従い、コンポーネント図とADRを追加することを推奨します。',
-  'no-commit': 'この要件に関連するコミットがありません。コミットメッセージに要件IDを含めてください。'
+  'no-design':
+    '設計ドキュメントを作成してください。C4モデルに従い、コンポーネント図とADRを追加することを推奨します。',
+  'no-commit':
+    'この要件に関連するコミットがありません。コミットメッセージに要件IDを含めてください。',
 };
 
 /**
  * GapDetector
- * 
+ *
  * Detects gaps in traceability between requirements and artifacts.
  */
 class GapDetector {
@@ -82,7 +85,7 @@ class GapDetector {
       requirementId,
       gapType,
       severity: SEVERITY_MAP[gapType],
-      suggestion: SUGGESTIONS[gapType]
+      suggestion: SUGGESTIONS[gapType],
     };
   }
 
@@ -117,8 +120,7 @@ class GapDetector {
       gapsByType[gap.gapType] = (gapsByType[gap.gapType] || 0) + 1;
 
       // Count by requirement
-      gapsByRequirement[gap.requirementId] = 
-        (gapsByRequirement[gap.requirementId] || 0) + 1;
+      gapsByRequirement[gap.requirementId] = (gapsByRequirement[gap.requirementId] || 0) + 1;
 
       // Count by severity
       switch (gap.severity) {
@@ -144,7 +146,7 @@ class GapDetector {
       mediumGaps,
       lowGaps,
       gapsByType,
-      gapsByRequirement
+      gapsByRequirement,
     };
   }
 
@@ -161,7 +163,7 @@ class GapDetector {
     return {
       generatedAt: new Date().toISOString(),
       gaps: sortedGaps,
-      summary
+      summary,
     };
   }
 
@@ -222,7 +224,7 @@ class GapDetector {
 
     const reqsWithGaps = this.getRequirementsWithGaps(links);
     const covered = links.length - reqsWithGaps.length;
-    
+
     return Math.round((covered / links.length) * 100);
   }
 }

package/src/traceability/index.js

@@ -1,6 +1,6 @@
 /**
  * Traceability Module
- * 
+ *
  * Requirement: IMP-6.2-004
  */
 
@@ -11,5 +11,5 @@ const { MatrixStorage } = require('./matrix-storage');
 module.exports = {
   TraceabilityExtractor,
   GapDetector,
-  MatrixStorage
+  MatrixStorage,
 };

package/src/traceability/matrix-storage.js

@@ -1,8 +1,8 @@
 /**
  * MatrixStorage Implementation
- * 
+ *
  * YAML-based persistence for traceability matrices.
- * 
+ *
  * Requirement: IMP-6.2-004-03
  * Design: ADR-6.2-002
  */
@@ -15,12 +15,12 @@ const yaml = require('yaml');
  * Default configuration
  */
 const DEFAULT_CONFIG = {
-  storageDir: 'storage/traceability'
+  storageDir: 'storage/traceability',
 };
 
 /**
  * MatrixStorage
- * 
+ *
  * Persists traceability matrices as YAML files.
  */
 class MatrixStorage {
@@ -46,11 +46,11 @@ class MatrixStorage {
 
     const yamlContent = yaml.stringify(matrix, {
       indent: 2,
-      lineWidth: 0
+      lineWidth: 0,
     });
 
     await fs.writeFile(filePath, yamlContent, 'utf-8');
-    
+
     return filePath;
   }
 
@@ -62,7 +62,7 @@ class MatrixStorage {
   async load(filename) {
     try {
       let filePath;
-      
+
       if (filename.endsWith('.yaml') || filename.endsWith('.yml')) {
         filePath = path.join(this.config.storageDir, filename);
       } else {
@@ -74,7 +74,7 @@ class MatrixStorage {
 
       await fs.access(filePath);
       const content = await fs.readFile(filePath, 'utf-8');
-      
+
       return yaml.parse(content);
     } catch {
       return null;
@@ -88,15 +88,15 @@ class MatrixStorage {
    */
   async loadLatest(featureId) {
     const files = await this.list(featureId);
-    
+
     if (files.length === 0) return null;
 
     // Sort by date (newest first)
     files.sort().reverse();
-    
+
     const latestFile = files[0];
     const filePath = path.join(this.config.storageDir, latestFile);
-    
+
     const content = await fs.readFile(filePath, 'utf-8');
     return yaml.parse(content);
   }
@@ -109,9 +109,7 @@ class MatrixStorage {
   async list(prefix) {
     try {
       const files = await fs.readdir(this.config.storageDir);
-      const yamlFiles = files.filter(f => 
-        f.endsWith('.yaml') || f.endsWith('.yml')
-      );
+      const yamlFiles = files.filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
 
       if (prefix) {
         return yamlFiles.filter(f => f.startsWith(prefix));
@@ -145,7 +143,7 @@ class MatrixStorage {
     // Get all requirement IDs
     const allReqIds = new Set([
       ...Object.keys(matrix1.requirements),
-      ...Object.keys(matrix2.requirements)
+      ...Object.keys(matrix2.requirements),
     ]);
 
     for (const reqId of allReqIds) {
@@ -159,7 +157,7 @@ class MatrixStorage {
           design: this.mergeLinks(link1.design, link2.design),
           code: this.mergeLinks(link1.code, link2.code),
           tests: this.mergeLinks(link1.tests, link2.tests),
-          commits: this.mergeLinks(link1.commits, link2.commits)
+          commits: this.mergeLinks(link1.commits, link2.commits),
         };
       } else {
         requirements[reqId] = link1 || link2;
@@ -170,7 +168,7 @@ class MatrixStorage {
       version: matrix2.version,
       generatedAt: new Date().toISOString(),
       requirements,
-      summary: this.calculateSummary(requirements)
+      summary: this.calculateSummary(requirements),
     };
   }
 
@@ -182,7 +180,7 @@ class MatrixStorage {
    */
   mergeLinks(links1, links2) {
     const merged = [...links1];
-    
+
     for (const link of links2) {
       const exists = merged.some(l => {
         if (l.path && link.path) {
@@ -219,7 +217,7 @@ class MatrixStorage {
         withCode: 0,
         withTests: 0,
         gaps: 0,
-        coveragePercentage: 0
+        coveragePercentage: 0,
       };
     }
 
@@ -249,8 +247,8 @@ class MatrixStorage {
     }
 
     // Calculate coverage as percentage of requirements with full coverage
-    const fullyLinked = links.filter(l => 
-      l.design.length > 0 && l.code.length > 0 && l.tests.length > 0
+    const fullyLinked = links.filter(
+      l => l.design.length > 0 && l.code.length > 0 && l.tests.length > 0
     ).length;
 
     return {
@@ -260,7 +258,7 @@ class MatrixStorage {
       withCode,
       withTests,
       gaps: gapCount,
-      coveragePercentage: Math.round((fullyLinked / total) * 100)
+      coveragePercentage: Math.round((fullyLinked / total) * 100),
     };
   }
 

package/src/validators/constitution.js

@@ -567,12 +567,15 @@ class ConstitutionValidator {
       files: [],
     };
 
-    // Find all source files
+    // Find all source files (excluding node_modules)
     const sourcePatterns = ['src/**/*.js', 'lib/**/*.js', 'bin/**/*.js'];
 
     const files = [];
     for (const pattern of sourcePatterns) {
-      const matches = await glob(pattern, { cwd: this.projectRoot });
+      const matches = await glob(pattern, {
+        cwd: this.projectRoot,
+        ignore: ['**/node_modules/**'],
+      });
       files.push(...matches.map(f => path.join(this.projectRoot, f)));
     }
 

package/src/validators/critic-system.js

@@ -211,7 +211,7 @@ class RequirementsCritic extends BaseCritic {
    */
   checkEarsFormat(context) {
     const content =
-      context.content || this.readFile('docs/requirements/srs/srs-musubi-v3.0.0.ja.md') || '';
+      context.content || this.readFile('storage/specs/srs/srs-musubi-v3.0.0.ja.md') || '';
 
     // EARS キーワードパターン
     const earsPatterns = [
@@ -241,7 +241,7 @@ class RequirementsCritic extends BaseCritic {
    */
   checkCompleteness(context) {
     const content =
-      context.content || this.readFile('docs/requirements/srs/srs-musubi-v3.0.0.ja.md') || '';
+      context.content || this.readFile('storage/specs/srs/srs-musubi-v3.0.0.ja.md') || '';
 
     const requiredSections = [
       /## 機能要件|## Functional Requirements/i,
@@ -258,7 +258,7 @@ class RequirementsCritic extends BaseCritic {
    */
   checkTestability(context) {
     const content =
-      context.content || this.readFile('docs/requirements/srs/srs-musubi-v3.0.0.ja.md') || '';
+      context.content || this.readFile('storage/specs/srs/srs-musubi-v3.0.0.ja.md') || '';
 
     // 数値目標や測定可能な基準があるかチェック
     const measurablePatterns = [
@@ -340,7 +340,7 @@ class DesignCritic extends BaseCritic {
    * C4モデル準拠チェック
    */
   checkC4Format(_context) {
-    const designDir = path.join(this.projectRoot, 'docs/design');
+    const designDir = path.join(this.projectRoot, 'storage/design');
     if (!fs.existsSync(designDir)) return 0;
 
     // C4レベルのキーワードをチェック
@@ -362,7 +362,7 @@ class DesignCritic extends BaseCritic {
    * ADR存在チェック
    */
   checkAdrPresence(_context) {
-    const adrDir = path.join(this.projectRoot, 'docs/design/adr');
+    const adrDir = path.join(this.projectRoot, 'storage/design/adr');
     if (!fs.existsSync(adrDir)) return 0;
 
     const adrFiles = fs.readdirSync(adrDir).filter(f => f.startsWith('ADR-') && f.endsWith('.md'));
@@ -375,7 +375,7 @@ class DesignCritic extends BaseCritic {
    * 要件カバレッジチェック
    */
   checkRequirementCoverage(_context) {
-    const designDir = path.join(this.projectRoot, 'docs/design');
+    const designDir = path.join(this.projectRoot, 'storage/design');
     if (!fs.existsSync(designDir)) return 0;
 
     const files = fs.readdirSync(designDir).filter(f => f.endsWith('.md'));

package/src/validators/traceability-validator.js

@@ -67,9 +67,9 @@ const defaultConfig = {
 
   // Paths configuration
   paths: {
-    requirements: 'docs/requirements',
-    design: 'docs/design',
-    tasks: 'docs/tasks',
+    requirements: 'storage/specs',
+    design: 'storage/design',
+    tasks: 'storage/tasks',
     code: 'src',
     tests: 'tests',
   },