musubi-sdd 5.1.0 → 5.6.1

package/src/steering/steering-auto-update.js

@@ -2,7 +2,7 @@
  * @file steering-auto-update.js
  * @description Automatic steering file update engine
  * @version 1.0.0
- * 
+ *
  * Part of MUSUBI v5.0.0 - Phase 5 Advanced Features
  */
 
@@ -22,7 +22,7 @@ const TRIGGER = {
   DEPENDENCY_UPDATE: 'dependency-update',
   CONFIG_CHANGE: 'config-change',
   MANUAL: 'manual',
-  SCHEDULED: 'scheduled'
+  SCHEDULED: 'scheduled',
 };
 
 /**
@@ -34,7 +34,7 @@ const STEERING_TYPE = {
   TECH: 'tech',
   PRODUCT: 'product',
   RULES: 'rules',
-  CUSTOM: 'custom'
+  CUSTOM: 'custom',
 };
 
 /**
@@ -76,10 +76,10 @@ const DEFAULT_RULES = [
     trigger: TRIGGER.DEPENDENCY_UPDATE,
     target: STEERING_TYPE.TECH,
     priority: 10,
-    condition: (context) => context.packageJsonChanged,
+    condition: context => context.packageJsonChanged,
     update: async (steering, context) => {
       const changes = [];
-      
+
       if (context.newDependencies?.length > 0) {
         changes.push(`Added dependencies: ${context.newDependencies.join(', ')}`);
       }
@@ -89,9 +89,9 @@ const DEFAULT_RULES = [
       if (context.updatedDependencies?.length > 0) {
         changes.push(`Updated dependencies: ${context.updatedDependencies.join(', ')}`);
       }
-      
+
       return { section: 'dependencies', changes };
-    }
+    },
   },
   {
     id: 'structure-dirs-update',
@@ -99,11 +99,11 @@ const DEFAULT_RULES = [
     trigger: TRIGGER.CODE_CHANGE,
     target: STEERING_TYPE.STRUCTURE,
     priority: 5,
-    condition: (context) => context.newDirectories?.length > 0,
+    condition: context => context.newDirectories?.length > 0,
     update: async (steering, context) => {
       const changes = context.newDirectories.map(dir => `Added directory: ${dir}`);
       return { section: 'directories', changes };
-    }
+    },
   },
   {
     id: 'structure-files-update',
@@ -111,7 +111,7 @@ const DEFAULT_RULES = [
     trigger: TRIGGER.CODE_CHANGE,
     target: STEERING_TYPE.STRUCTURE,
     priority: 4,
-    condition: (context) => context.significantFileChanges,
+    condition: context => context.significantFileChanges,
     update: async (steering, context) => {
       const changes = [];
       if (context.newEntryPoints?.length > 0) {
@@ -121,7 +121,7 @@ const DEFAULT_RULES = [
         changes.push(`New modules: ${context.newModules.join(', ')}`);
       }
       return { section: 'files', changes };
-    }
+    },
   },
   {
     id: 'product-features-update',
@@ -129,14 +129,14 @@ const DEFAULT_RULES = [
     trigger: TRIGGER.AGENT_WORK,
     target: STEERING_TYPE.PRODUCT,
     priority: 8,
-    condition: (context) => context.featureCompleted,
+    condition: context => context.featureCompleted,
     update: async (steering, context) => {
       const changes = [`Completed feature: ${context.featureName}`];
       if (context.featureDescription) {
         changes.push(`Description: ${context.featureDescription}`);
       }
       return { section: 'features', changes };
-    }
+    },
   },
   {
     id: 'rules-patterns-update',
@@ -144,12 +144,12 @@ const DEFAULT_RULES = [
     trigger: TRIGGER.AGENT_WORK,
     target: STEERING_TYPE.RULES,
     priority: 3,
-    condition: (context) => context.newPatterns?.length > 0,
+    condition: context => context.newPatterns?.length > 0,
     update: async (steering, context) => {
       const changes = context.newPatterns.map(p => `New pattern: ${p}`);
       return { section: 'patterns', changes };
-    }
-  }
+    },
+  },
 ];
 
 /**
@@ -163,22 +163,22 @@ class SteeringAutoUpdate extends EventEmitter {
    */
   constructor(options = {}) {
     super();
-    
+
     this.steeringPath = options.steeringPath || 'steering';
     this.autoSave = options.autoSave !== false;
     this.backup = options.backup !== false;
     this.rules = [...DEFAULT_RULES, ...(options.rules || [])];
-    
+
     // Sort rules by priority
     this.rules.sort((a, b) => (b.priority || 0) - (a.priority || 0));
-    
+
     // State
     this.updates = new Map();
     this.updateCounter = 0;
     this.steering = new Map();
     this.pendingChanges = new Map();
   }
-  
+
   /**
    * Load steering files
    * @param {string} [basePath='.'] - Base path
@@ -186,14 +186,14 @@ class SteeringAutoUpdate extends EventEmitter {
    */
   async loadSteering(basePath = '.') {
     const steeringDir = path.join(basePath, this.steeringPath);
-    
+
     const files = {
       [STEERING_TYPE.STRUCTURE]: 'structure.md',
       [STEERING_TYPE.TECH]: 'tech.md',
       [STEERING_TYPE.PRODUCT]: 'product.md',
-      [STEERING_TYPE.RULES]: 'rules/constitution.md'
+      [STEERING_TYPE.RULES]: 'rules/constitution.md',
     };
-    
+
     for (const [type, file] of Object.entries(files)) {
       const filePath = path.join(steeringDir, file);
       try {
@@ -203,14 +203,14 @@ class SteeringAutoUpdate extends EventEmitter {
             path: filePath,
             content,
             parsed: this.parseMarkdown(content),
-            lastModified: fs.statSync(filePath).mtime
+            lastModified: fs.statSync(filePath).mtime,
           });
         }
       } catch (error) {
         this.emit('error', { type, file, error });
       }
     }
-    
+
     // Load custom steering files
     const customDir = path.join(steeringDir, 'custom');
     if (fs.existsSync(customDir)) {
@@ -222,15 +222,15 @@ class SteeringAutoUpdate extends EventEmitter {
           path: filePath,
           content,
           parsed: this.parseMarkdown(content),
-          lastModified: fs.statSync(filePath).mtime
+          lastModified: fs.statSync(filePath).mtime,
         });
       }
     }
-    
+
     this.emit('steering:loaded', { count: this.steering.size });
     return this.steering;
   }
-  
+
   /**
    * Parse markdown into sections
    * @private
@@ -240,7 +240,7 @@ class SteeringAutoUpdate extends EventEmitter {
     const lines = content.split('\n');
     let currentSection = 'header';
     let currentContent = [];
-    
+
     for (const line of lines) {
       const headerMatch = line.match(/^(#{1,6})\s+(.+)$/);
       if (headerMatch) {
@@ -254,15 +254,15 @@ class SteeringAutoUpdate extends EventEmitter {
         currentContent.push(line);
       }
     }
-    
+
     // Save last section
     if (currentContent.length > 0) {
       sections.set(currentSection, currentContent.join('\n'));
     }
-    
+
     return sections;
   }
-  
+
   /**
    * Process an update trigger
    * @param {string} trigger - Trigger type
@@ -272,9 +272,9 @@ class SteeringAutoUpdate extends EventEmitter {
   async processTrigger(trigger, context = {}) {
     const id = this.generateId();
     this.emit('trigger:received', { id, trigger, context });
-    
+
     const results = [];
-    
+
     // Find applicable rules
     const applicableRules = this.rules.filter(rule => {
       if (rule.trigger !== trigger) return false;
@@ -285,20 +285,20 @@ class SteeringAutoUpdate extends EventEmitter {
         return false;
       }
     });
-    
+
     // Apply each rule
     for (const rule of applicableRules) {
       try {
         this.emit('rule:applying', { rule: rule.id, target: rule.target });
-        
+
         const steering = this.steering.get(rule.target);
         if (!steering) {
           this.emit('rule:skipped', { rule: rule.id, reason: 'target not found' });
           continue;
         }
-        
+
         const updateResult = await rule.update(steering, context);
-        
+
         if (updateResult && updateResult.changes?.length > 0) {
           // Queue changes
           if (!this.pendingChanges.has(rule.target)) {
@@ -308,9 +308,9 @@ class SteeringAutoUpdate extends EventEmitter {
             rule: rule.id,
             section: updateResult.section,
             changes: updateResult.changes,
-            timestamp: Date.now()
+            timestamp: Date.now(),
           });
-          
+
           const result = {
             id: `update-${++this.updateCounter}`,
             success: true,
@@ -318,12 +318,12 @@ class SteeringAutoUpdate extends EventEmitter {
             trigger,
             rule: rule.id,
             changes: updateResult.changes,
-            timestamp: Date.now()
+            timestamp: Date.now(),
           };
-          
+
           results.push(result);
           this.updates.set(result.id, result);
-          
+
           this.emit('rule:applied', { rule: rule.id, changes: updateResult.changes });
         }
       } catch (error) {
@@ -334,77 +334,74 @@ class SteeringAutoUpdate extends EventEmitter {
           trigger,
           rule: rule.id,
           error: error.message,
-          timestamp: Date.now()
+          timestamp: Date.now(),
         };
-        
+
         results.push(result);
         this.emit('rule:failed', { rule: rule.id, error });
       }
     }
-    
+
     // Auto-save if enabled
     if (this.autoSave && results.some(r => r.success)) {
       await this.applyPendingChanges();
     }
-    
+
     this.emit('trigger:processed', { id, results });
     return results;
   }
-  
+
   /**
    * Apply pending changes to files
    * @returns {Promise<Object>} Apply result
    */
   async applyPendingChanges() {
     const applied = [];
-    
+
     for (const [target, changes] of this.pendingChanges.entries()) {
       const steering = this.steering.get(target);
       if (!steering) continue;
-      
+
       try {
         // Create backup
         if (this.backup) {
           const backupPath = `${steering.path}.backup`;
           fs.writeFileSync(backupPath, steering.content);
         }
-        
+
         // Generate changelog section
         const changelog = this.generateChangelog(changes);
-        
+
         // Update content
         let newContent = steering.content;
-        
+
         // Add or update changelog section
         if (newContent.includes('## Changelog')) {
-          newContent = newContent.replace(
-            /## Changelog\n/,
-            `## Changelog\n\n${changelog}\n`
-          );
+          newContent = newContent.replace(/## Changelog\n/, `## Changelog\n\n${changelog}\n`);
         } else {
           newContent += `\n\n## Changelog\n\n${changelog}`;
         }
-        
+
         // Write file
         fs.writeFileSync(steering.path, newContent);
-        
+
         // Update in-memory state
         steering.content = newContent;
         steering.parsed = this.parseMarkdown(newContent);
         steering.lastModified = new Date();
-        
+
         applied.push({ target, changesCount: changes.length });
-        
+
         this.emit('changes:applied', { target, changes });
       } catch (error) {
         this.emit('changes:failed', { target, error });
       }
     }
-    
+
     this.pendingChanges.clear();
     return { applied };
   }
-  
+
   /**
    * Generate changelog entry
    * @private
@@ -412,16 +409,16 @@ class SteeringAutoUpdate extends EventEmitter {
   generateChangelog(changes) {
     const date = new Date().toISOString().split('T')[0];
     const entries = [];
-    
+
     for (const change of changes) {
       for (const item of change.changes) {
         entries.push(`- ${item}`);
       }
     }
-    
+
     return `### ${date}\n${entries.join('\n')}`;
   }
-  
+
   /**
    * Add custom rule
    * @param {UpdateRule} rule - Rule to add
@@ -430,13 +427,13 @@ class SteeringAutoUpdate extends EventEmitter {
     if (!rule.id || !rule.trigger || !rule.target) {
       throw new Error('Rule must have id, trigger, and target');
     }
-    
+
     this.rules.push(rule);
     this.rules.sort((a, b) => (b.priority || 0) - (a.priority || 0));
-    
+
     this.emit('rule:added', { ruleId: rule.id });
   }
-  
+
   /**
    * Remove rule
    * @param {string} ruleId - Rule ID to remove
@@ -448,7 +445,7 @@ class SteeringAutoUpdate extends EventEmitter {
       this.emit('rule:removed', { ruleId });
     }
   }
-  
+
   /**
    * Get update history
    * @param {Object} [filter={}] - Filter options
@@ -456,7 +453,7 @@ class SteeringAutoUpdate extends EventEmitter {
    */
   getHistory(filter = {}) {
     let results = Array.from(this.updates.values());
-    
+
     if (filter.trigger) {
       results = results.filter(r => r.trigger === filter.trigger);
     }
@@ -466,17 +463,17 @@ class SteeringAutoUpdate extends EventEmitter {
     if (filter.success !== undefined) {
       results = results.filter(r => r.success === filter.success);
     }
-    
+
     return results.sort((a, b) => b.timestamp - a.timestamp);
   }
-  
+
   /**
    * Get statistics
    * @returns {Object}
    */
   getStats() {
     const updates = Array.from(this.updates.values());
-    
+
     return {
       totalUpdates: updates.length,
       successful: updates.filter(u => u.success).length,
@@ -487,10 +484,10 @@ class SteeringAutoUpdate extends EventEmitter {
       }, {}),
       rulesCount: this.rules.length,
       steeringFilesLoaded: this.steering.size,
-      pendingChanges: this.pendingChanges.size
+      pendingChanges: this.pendingChanges.size,
     };
   }
-  
+
   /**
    * Generate unique ID
    * @private
@@ -498,47 +495,47 @@ class SteeringAutoUpdate extends EventEmitter {
   generateId() {
     return `trigger-${Date.now().toString(36)}-${Math.random().toString(36).substr(2, 6)}`;
   }
-  
+
   /**
    * Clear history
    */
   clearHistory() {
     this.updates.clear();
   }
-  
+
   /**
    * Validate steering consistency
    * @returns {Object} Validation result
    */
   validateConsistency() {
     const issues = [];
-    
+
     // Check cross-file references
     const structure = this.steering.get(STEERING_TYPE.STRUCTURE);
     const tech = this.steering.get(STEERING_TYPE.TECH);
-    
+
     if (structure && tech) {
       // Check if tech references match structure
       const structureDirs = this.extractDirectories(structure.content);
       const techDirs = this.extractDirectories(tech.content);
-      
+
       for (const dir of techDirs) {
         if (!structureDirs.includes(dir)) {
           issues.push({
             type: 'mismatch',
             file: STEERING_TYPE.TECH,
-            message: `Directory "${dir}" referenced in tech.md but not in structure.md`
+            message: `Directory "${dir}" referenced in tech.md but not in structure.md`,
           });
         }
       }
     }
-    
+
     return {
       valid: issues.length === 0,
-      issues
+      issues,
     };
   }
-  
+
   /**
    * Extract directories from content
    * @private
@@ -568,5 +565,5 @@ module.exports = {
   createSteeringAutoUpdate,
   TRIGGER,
   STEERING_TYPE,
-  DEFAULT_RULES
+  DEFAULT_RULES,
 };