musubi-sdd 5.1.0 → 5.6.1

package/src/gui/server.js

@@ -60,17 +60,17 @@ class GUIServer {
    */
   setupReplanningEvents() {
     // Forward replanning events to WebSocket clients
-    this.replanningService.on('state:updated', (state) => {
-      this.broadcast({ 
-        type: 'replanning:state', 
-        data: state 
+    this.replanningService.on('state:updated', state => {
+      this.broadcast({
+        type: 'replanning:state',
+        data: state,
       });
     });
 
-    this.replanningService.on('replan:recorded', (event) => {
-      this.broadcast({ 
-        type: 'replanning:event', 
-        data: event 
+    this.replanningService.on('replan:recorded', event => {
+      this.broadcast({
+        type: 'replanning:event',
+        data: event,
       });
     });
   }
@@ -286,9 +286,9 @@ class GUIServer {
       }
       try {
         const { spawn } = require('child_process');
-        const child = spawn('npx', ['musubi-requirements', 'create'], {
+        const _child = spawn('npx', ['musubi-requirements', 'create'], {
           cwd: this.projectPath,
-          shell: true
+          shell: true,
         });
         res.json({ success: true, message: 'Requirements wizard started' });
       } catch (error) {
@@ -303,20 +303,20 @@ class GUIServer {
       }
       try {
         const { id, title, type, priority, description, feature } = req.body;
-        
+
         if (!id || !title || !description || !feature) {
           return res.status(400).json({ error: 'Missing required fields' });
         }
 
         const fs = require('fs').promises;
         const specsDir = path.join(this.projectPath, 'storage', 'specs');
-        
+
         // Ensure directory exists
         await fs.mkdir(specsDir, { recursive: true });
-        
+
         const filename = `${feature}-requirements.md`;
         const filepath = path.join(specsDir, filename);
-        
+
         // Check if file exists
         let content = '';
         try {
@@ -346,9 +346,9 @@ ${description}
 
 `;
         content += reqContent;
-        
+
         await fs.writeFile(filepath, content, 'utf-8');
-        
+
         res.json({ success: true, file: filepath });
       } catch (error) {
         res.status(500).json({ error: error.message });
@@ -359,26 +359,26 @@ ${description}
       try {
         const { spawn } = require('child_process');
         const result = { stdout: '', stderr: '' };
-        
+
         const child = spawn('node', [path.join(__dirname, '../../bin/musubi-validate.js'), 'all'], {
           cwd: this.projectPath,
           shell: false,
-          env: { ...process.env, FORCE_COLOR: '0' }
+          env: { ...process.env, FORCE_COLOR: '0' },
         });
-        
-        child.stdout.on('data', (data) => result.stdout += data.toString());
-        child.stderr.on('data', (data) => result.stderr += data.toString());
-        
-        child.on('error', (error) => {
+
+        child.stdout.on('data', data => (result.stdout += data.toString()));
+        child.stderr.on('data', data => (result.stderr += data.toString()));
+
+        child.on('error', error => {
           res.status(500).json({ success: false, error: error.message });
         });
-        
-        child.on('close', (code) => {
-          res.json({ 
-            success: code === 0, 
-            output: result.stdout || 'Validation completed', 
+
+        child.on('close', code => {
+          res.json({
+            success: code === 0,
+            output: result.stdout || 'Validation completed',
             errors: result.stderr,
-            exitCode: code
+            exitCode: code,
           });
         });
       } catch (error) {
@@ -412,20 +412,20 @@ ${description}
   setupWebSocket() {
     this.wss = new WebSocketServer({ server: this.httpServer });
 
-    this.wss.on('connection', (ws) => {
+    this.wss.on('connection', ws => {
       this.clients.add(ws);
 
       ws.on('close', () => {
         this.clients.delete(ws);
       });
 
-      ws.on('error', (error) => {
+      ws.on('error', error => {
         console.error('WebSocket error:', error);
         this.clients.delete(ws);
       });
 
       // Send initial project state
-      this.projectScanner.scan().then((project) => {
+      this.projectScanner.scan().then(project => {
         ws.send(JSON.stringify({ type: 'project:init', data: project }));
       });
     });
@@ -438,7 +438,8 @@ ${description}
   broadcast(message) {
     const data = JSON.stringify(message);
     for (const client of this.clients) {
-      if (client.readyState === 1) { // WebSocket.OPEN
+      if (client.readyState === 1) {
+        // WebSocket.OPEN
         client.send(data);
       }
     }
@@ -449,10 +450,10 @@ ${description}
    */
   setupFileWatcher() {
     this.fileWatcher = new FileWatcher(this.projectPath, {
-      ignored: /(^|[\/\\])\.|node_modules/,
+      ignored: /(^|[/\\])\.|node_modules/,
     });
 
-    this.fileWatcher.on('change', async (filePath) => {
+    this.fileWatcher.on('change', async filePath => {
       try {
         const project = await this.projectScanner.scan();
         this.broadcast({ type: 'file:changed', data: { path: filePath, project } });
@@ -461,7 +462,7 @@ ${description}
       }
     });
 
-    this.fileWatcher.on('add', async (filePath) => {
+    this.fileWatcher.on('add', async filePath => {
       try {
         const project = await this.projectScanner.scan();
         this.broadcast({ type: 'file:added', data: { path: filePath, project } });
@@ -470,7 +471,7 @@ ${description}
       }
     });
 
-    this.fileWatcher.on('unlink', async (filePath) => {
+    this.fileWatcher.on('unlink', async filePath => {
       try {
         const project = await this.projectScanner.scan();
         this.broadcast({ type: 'file:removed', data: { path: filePath, project } });
@@ -487,11 +488,11 @@ ${description}
   async start() {
     return new Promise((resolve, reject) => {
       this.httpServer = http.createServer(this.app);
-      
+
       this.setupWebSocket();
       this.setupFileWatcher();
 
-      this.httpServer.listen(this.port, (err) => {
+      this.httpServer.listen(this.port, err => {
         if (err) {
           reject(err);
           return;
@@ -537,7 +538,7 @@ ${description}
     }
 
     if (this.httpServer) {
-      return new Promise((resolve) => {
+      return new Promise(resolve => {
         this.httpServer.close(resolve);
       });
     }

package/src/gui/services/file-watcher.js

@@ -6,6 +6,7 @@
 const chokidar = require('chokidar');
 const EventEmitter = require('events');
 const path = require('path');
+const fs = require('fs');
 
 /**
  * File Watcher - Watches for file changes in the project
@@ -18,10 +19,10 @@ class FileWatcher extends EventEmitter {
    */
   constructor(projectPath, options = {}) {
     super();
-    
+
     this.projectPath = projectPath;
     this.options = {
-      ignored: options.ignored || /(^|[\/\\])\.|node_modules/,
+      ignored: options.ignored || /(^|[/\\])\.|node_modules/,
       persistent: true,
       ignoreInitial: true,
       awaitWriteFinish: {
@@ -42,26 +43,40 @@ class FileWatcher extends EventEmitter {
    * Start watching
    */
   start() {
-    const watchPaths = [
+    const potentialPaths = [
       path.join(this.projectPath, 'steering'),
       path.join(this.projectPath, 'storage'),
     ];
 
+    // Only watch paths that exist to avoid ENOENT errors
+    const watchPaths = potentialPaths.filter(p => {
+      try {
+        return fs.existsSync(p);
+      } catch {
+        return false;
+      }
+    });
+
+    // If no paths exist, watch the project path itself
+    if (watchPaths.length === 0) {
+      watchPaths.push(this.projectPath);
+    }
+
     this.watcher = chokidar.watch(watchPaths, this.options);
 
-    this.watcher.on('change', (filePath) => {
+    this.watcher.on('change', filePath => {
       this.debounce('change', filePath);
     });
 
-    this.watcher.on('add', (filePath) => {
+    this.watcher.on('add', filePath => {
       this.debounce('add', filePath);
     });
 
-    this.watcher.on('unlink', (filePath) => {
+    this.watcher.on('unlink', filePath => {
       this.debounce('unlink', filePath);
     });
 
-    this.watcher.on('error', (error) => {
+    this.watcher.on('error', error => {
       this.emit('error', error);
     });
 
@@ -77,7 +92,7 @@ class FileWatcher extends EventEmitter {
    */
   debounce(event, filePath) {
     const key = `${event}:${filePath}`;
-    
+
     if (this.debounceTimers.has(key)) {
       clearTimeout(this.debounceTimers.get(key));
     }

package/src/gui/services/project-scanner.js

@@ -83,8 +83,8 @@ class ProjectScanner {
    */
   async getSteering() {
     const steeringPath = path.join(this.projectPath, 'steering');
-    
-    if (!await fs.pathExists(steeringPath)) {
+
+    if (!(await fs.pathExists(steeringPath))) {
       return null;
     }
 
@@ -104,8 +104,8 @@ class ProjectScanner {
    */
   async getConstitution() {
     const constitutionPath = path.join(this.projectPath, 'steering', 'rules', 'constitution.md');
-    
-    if (!await fs.pathExists(constitutionPath)) {
+
+    if (!(await fs.pathExists(constitutionPath))) {
       return null;
     }
 
@@ -146,8 +146,8 @@ class ProjectScanner {
    */
   async getSpecs() {
     const specsPath = path.join(this.projectPath, 'storage', 'specs');
-    
-    if (!await fs.pathExists(specsPath)) {
+
+    if (!(await fs.pathExists(specsPath))) {
       return [];
     }
 
@@ -174,6 +174,11 @@ class ProjectScanner {
    */
   async getSpec(id) {
     const specsPath = path.join(this.projectPath, 'storage', 'specs');
+
+    if (!(await fs.pathExists(specsPath))) {
+      return null;
+    }
+
     const files = await fs.readdir(specsPath);
 
     for (const file of files) {
@@ -181,7 +186,7 @@ class ProjectScanner {
 
       const filePath = path.join(specsPath, file);
       const spec = await this.parseSpec(filePath);
-      
+
       if (spec && spec.id === id) {
         return spec;
       }
@@ -232,16 +237,17 @@ class ProjectScanner {
    */
   parseRequirements(content) {
     const requirements = [];
-    const reqRegex = /#{2,3}\s+(REQ[-\w]+)[:\s]*(.+?)(?=\n#{2,3}\s+REQ|\n#{1,2}\s+[^#]|\n#{1,2}$|$)/gs;
+    const reqRegex =
+      /#{2,3}\s+(REQ[-\w]+)[:\s]*(.+?)(?=\n#{2,3}\s+REQ|\n#{1,2}\s+[^#]|\n#{1,2}$|$)/gs;
 
     let match;
     while ((match = reqRegex.exec(content)) !== null) {
       const id = match[1];
       const body = match[2].trim();
-      
+
       // Try to extract EARS pattern
       const pattern = this.detectEARSPattern(body);
-      
+
       requirements.push({
         id,
         body,
@@ -387,8 +393,8 @@ class ProjectScanner {
    */
   async getWorkflow() {
     const workflowPath = path.join(this.projectPath, 'steering', 'rules', 'workflow.md');
-    
-    if (!await fs.pathExists(workflowPath)) {
+
+    if (!(await fs.pathExists(workflowPath))) {
       // Return default workflow stages
       return {
         stages: [
@@ -427,7 +433,7 @@ class ProjectScanner {
         name: match[2].trim(),
         status,
       });
-      
+
       if (status === 'active') {
         currentStage = parseInt(match[1], 10);
       }
@@ -448,7 +454,7 @@ class ProjectScanner {
     };
 
     // Check for steering directory
-    if (!await this.hasSteering()) {
+    if (!(await this.hasSteering())) {
       results.errors.push({
         type: 'missing-steering',
         message: 'steering/ directory not found',
@@ -495,13 +501,13 @@ class ProjectScanner {
    */
   async readMarkdownFile(filePath) {
     try {
-      if (!await fs.pathExists(filePath)) {
+      if (!(await fs.pathExists(filePath))) {
         return null;
       }
-      
+
       const content = await fs.readFile(filePath, 'utf-8');
       const { data, content: body } = matter(content);
-      
+
       return {
         path: filePath,
         metadata: data,
@@ -519,13 +525,13 @@ class ProjectScanner {
    */
   async readYamlFile(filePath) {
     try {
-      if (!await fs.pathExists(filePath)) {
+      if (!(await fs.pathExists(filePath))) {
         return null;
       }
-      
+
       const yaml = require('js-yaml');
       const content = await fs.readFile(filePath, 'utf-8');
-      
+
       return {
         path: filePath,
         data: yaml.load(content),

package/src/gui/services/replanning-service.js

@@ -35,7 +35,7 @@ class ReplanningService extends EventEmitter {
     super();
     this.projectPath = projectPath;
     this.storagePath = path.join(projectPath, 'storage', 'replanning');
-    
+
     // In-memory state (will be populated from storage or engine)
     this.state = {
       status: 'idle',
@@ -49,8 +49,8 @@ class ReplanningService extends EventEmitter {
         successfulReplans: 0,
         averageConfidence: 0,
         goalCompletionRate: 0,
-        optimizationsApplied: 0
-      }
+        optimizationsApplied: 0,
+      },
     };
   }
 
@@ -106,10 +106,13 @@ class ReplanningService extends EventEmitter {
     try {
       const historyDir = path.join(this.storagePath, 'history');
       await fs.mkdir(historyDir, { recursive: true });
-      
+
       const files = await fs.readdir(historyDir);
-      const jsonFiles = files.filter(f => f.endsWith('.json')).sort().reverse();
-      
+      const jsonFiles = files
+        .filter(f => f.endsWith('.json'))
+        .sort()
+        .reverse();
+
       this.state.history = [];
       for (const file of jsonFiles.slice(0, 50)) {
         try {
@@ -148,7 +151,7 @@ class ReplanningService extends EventEmitter {
         overallProgress: 0,
         activeGoals: 0,
         completedGoals: 0,
-        milestones: []
+        milestones: [],
       };
     }
   }
@@ -168,7 +171,7 @@ class ReplanningService extends EventEmitter {
         currentPath: null,
         optimizedPath: null,
         potentialSavings: 0,
-        suggestions: []
+        suggestions: [],
       };
     }
   }
@@ -214,26 +217,26 @@ class ReplanningService extends EventEmitter {
   async recordReplan(event) {
     const historyDir = path.join(this.storagePath, 'history');
     await fs.mkdir(historyDir, { recursive: true });
-    
+
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
     const filename = `replan-${timestamp}.json`;
-    
+
     const entry = {
       id: `replan-${Date.now()}`,
       timestamp: new Date().toISOString(),
-      ...event
+      ...event,
     };
-    
+
     await fs.writeFile(path.join(historyDir, filename), JSON.stringify(entry, null, 2));
-    
+
     this.state.history.unshift(entry);
     this.state.lastReplan = entry;
     this.state.metrics.totalReplans++;
-    
+
     if (event.success) {
       this.state.metrics.successfulReplans++;
     }
-    
+
     await this.saveState();
     this.emit('replan:recorded', entry);
   }
@@ -247,7 +250,7 @@ class ReplanningService extends EventEmitter {
       this.getState(),
       this.getGoalProgress(),
       this.getPathOptimization(),
-      this.getMetrics()
+      this.getMetrics(),
     ]);
 
     return {
@@ -255,20 +258,21 @@ class ReplanningService extends EventEmitter {
       goalProgress: {
         overall: goalProgress.overallProgress || 0,
         active: goalProgress.activeGoals || 0,
-        completed: goalProgress.completedGoals || 0
+        completed: goalProgress.completedGoals || 0,
       },
       optimization: {
         status: pathOptimization.status,
-        suggestions: pathOptimization.suggestions?.length || 0
+        suggestions: pathOptimization.suggestions?.length || 0,
       },
       metrics: {
         totalReplans: metrics.totalReplans || 0,
-        successRate: metrics.totalReplans > 0 
-          ? Math.round((metrics.successfulReplans / metrics.totalReplans) * 100) 
-          : 100,
-        optimizationsApplied: metrics.optimizationsApplied || 0
+        successRate:
+          metrics.totalReplans > 0
+            ? Math.round((metrics.successfulReplans / metrics.totalReplans) * 100)
+            : 100,
+        optimizationsApplied: metrics.optimizationsApplied || 0,
       },
-      recentHistory: state.history.slice(0, 5)
+      recentHistory: state.history.slice(0, 5),
     };
   }
 }

package/src/gui/services/traceability-service.js

@@ -132,7 +132,7 @@ class TraceabilityService {
 
     try {
       const files = await fs.readdir(specsPath);
-      const reqFiles = files.filter((f) => f.endsWith('-requirements.md'));
+      const reqFiles = files.filter(f => f.endsWith('-requirements.md'));
 
       for (const file of reqFiles) {
         const filePath = path.join(specsPath, file);
@@ -156,7 +156,7 @@ class TraceabilityService {
         // Also check frontmatter for requirements list
         if (frontmatter.requirements) {
           for (const req of frontmatter.requirements) {
-            if (!requirements.find((r) => r.id === req.id)) {
+            if (!requirements.find(r => r.id === req.id)) {
               requirements.push({
                 id: req.id,
                 title: req.title || req.id,
@@ -185,7 +185,7 @@ class TraceabilityService {
 
     try {
       const files = await fs.readdir(specsPath);
-      const designFiles = files.filter((f) => f.endsWith('-design.md'));
+      const designFiles = files.filter(f => f.endsWith('-design.md'));
 
       for (const file of designFiles) {
         const filePath = path.join(specsPath, file);
@@ -216,7 +216,7 @@ class TraceabilityService {
 
     try {
       const files = await fs.readdir(specsPath);
-      const taskFiles = files.filter((f) => f.endsWith('-tasks.md'));
+      const taskFiles = files.filter(f => f.endsWith('-tasks.md'));
 
       for (const file of taskFiles) {
         const filePath = path.join(specsPath, file);
@@ -255,10 +255,10 @@ class TraceabilityService {
     const implementations = [];
 
     try {
-      await this.walkDirectory(srcPath, async (filePath) => {
+      await this.walkDirectory(srcPath, async filePath => {
         if (filePath.endsWith('.js') || filePath.endsWith('.ts')) {
           const content = await fs.readFile(filePath, 'utf-8');
-          
+
           // Look for @implements or @requirement tags
           const tagRegex = /@(?:implements|requirement)\s+(REQ-\d+[^\s]*)/g;
           let match;
@@ -292,10 +292,10 @@ class TraceabilityService {
   async walkDirectory(dir, callback) {
     try {
       const entries = await fs.readdir(dir, { withFileTypes: true });
-      
+
       for (const entry of entries) {
         const fullPath = path.join(dir, entry.name);
-        
+
         if (entry.isDirectory()) {
           if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
             await this.walkDirectory(fullPath, callback);

package/src/gui/services/workflow-service.js

@@ -46,7 +46,7 @@ class WorkflowService {
     // Check steering
     const steeringPath = path.join(this.projectPath, 'steering');
     const constitutionPath = path.join(steeringPath, 'rules', 'constitution.md');
-    
+
     try {
       await fs.access(constitutionPath);
       state.completedStages.push('steering');
@@ -61,7 +61,12 @@ class WorkflowService {
     }
 
     // Check requirements
-    const requirementsPath = path.join(this.projectPath, 'storage', 'specs', `${featureId}-requirements.md`);
+    const requirementsPath = path.join(
+      this.projectPath,
+      'storage',
+      'specs',
+      `${featureId}-requirements.md`
+    );
     if (await this.fileExists(requirementsPath)) {
       state.completedStages.push('requirements');
       state.currentStage = 'design';
@@ -100,7 +105,7 @@ class WorkflowService {
 
     try {
       const files = await fs.readdir(specsPath);
-      
+
       for (const file of files) {
         const match = file.match(/^(.+)-(requirements|design|tasks)\.md$/);
         if (match) {
@@ -133,7 +138,9 @@ class WorkflowService {
     }
 
     if (targetIndex > currentIndex + 1) {
-      throw new Error(`Cannot skip stages. Current: ${currentState.currentStage}, Target: ${targetStage}`);
+      throw new Error(
+        `Cannot skip stages. Current: ${currentState.currentStage}, Target: ${targetStage}`
+      );
     }
 
     // The actual transition is done by creating the artifact
@@ -190,7 +197,7 @@ class WorkflowService {
 
     return {
       featureId,
-      valid: issues.filter((i) => i.type === 'error').length === 0,
+      valid: issues.filter(i => i.type === 'error').length === 0,
       issues,
       state,
     };
@@ -219,11 +226,11 @@ class WorkflowService {
     try {
       const content = await fs.readFile(filePath, 'utf-8');
       const { data: frontmatter, content: body } = matter(content);
-      
+
       const sections = [];
       const sectionRegex = /^##\s+(.+)$/gm;
       let match;
-      
+
       while ((match = sectionRegex.exec(body)) !== null) {
         sections.push(match[1]);
       }