agileflow 2.91.0 → 2.92.0

package/scripts/tui/blessed/data/watcher.js

@@ -4,6 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const chokidar = require('chokidar');
 
+// Import centralized path utilities
+const { getStatusPath, getBusLogPath, getSessionStatePath } = require('../../../lib/paths');
+
 /**
  * DataWatcher - watches status.json and log files for changes
  * Triggers refresh callback when data updates
@@ -15,10 +18,10 @@ class DataWatcher {
     this.watcher = null;
     this.cwd = process.cwd();
 
-    // Paths to watch
-    this.statusPath = path.join(this.cwd, 'docs/09-agents/status.json');
-    this.logPath = path.join(this.cwd, 'docs/09-agents/bus/log.jsonl');
-    this.sessionStatePath = path.join(this.cwd, '.agileflow/session-state.json');
+    // Paths to watch (using centralized path utilities)
+    this.statusPath = getStatusPath(this.cwd);
+    this.logPath = getBusLogPath(this.cwd);
+    this.sessionStatePath = getSessionStatePath(this.cwd);
   }
 
   start() {
@@ -50,8 +53,8 @@ class DataWatcher {
       usePolling: false,
       awaitWriteFinish: {
         stabilityThreshold: 100,
-        pollInterval: 50
-      }
+        pollInterval: 50,
+      },
     });
 
     this.watcher.on('change', filePath => {
@@ -85,20 +88,22 @@ class DataWatcher {
             story: s.id || s.title || 'Unknown',
             status: 'active',
             duration: this.formatDuration(s.started_at),
-            progress: s.progress || '--'
+            progress: s.progress || '--',
           }));
 
         // If no active stories, show all stories summary
         if (this.state.sessions.length === 0) {
           const ready = stories.filter(s => s.status === 'ready').length;
           const completed = stories.filter(s => s.status === 'completed').length;
-          this.state.sessions = [{
-            id: '--',
-            story: `${ready} ready, ${completed} completed`,
-            status: 'idle',
-            duration: '--',
-            progress: '--'
-          }];
+          this.state.sessions = [
+            {
+              id: '--',
+              story: `${ready} ready, ${completed} completed`,
+              status: 'idle',
+              duration: '--',
+              progress: '--',
+            },
+          ];
         }
       }
     } catch (err) {
@@ -138,7 +143,7 @@ class DataWatcher {
             action: cmd.command || cmd,
             status: 'running',
             duration: '--',
-            details: cmd.args || ''
+            details: cmd.args || '',
           }));
         }
       }

package/scripts/tui/blessed/index.js

@@ -39,7 +39,7 @@ class AgileFlowTUI {
       sessions: [],
       logs: [],
       traces: [],
-      showHelp: false
+      showHelp: false,
     };
     this.components = {};
     this.watcher = null;
@@ -90,7 +90,7 @@ class AgileFlowTUI {
     });
 
     // Tab switching with number keys
-    this.screen.key(['1', '2', '3'], (ch) => {
+    this.screen.key(['1', '2', '3'], ch => {
       if (this.components.help.isVisible()) return;
       this.switchTab(parseInt(ch) - 1);
     });

package/scripts/tui/blessed/panels/output.js

@@ -16,22 +16,22 @@ module.exports = function createOutputPanel(grid, state) {
     tags: true,
     border: {
       type: 'line',
-      fg: 'green'
+      fg: 'green',
     },
     style: {
       fg: 'white',
       bg: 'black',
-      border: { fg: 'green' }
+      border: { fg: 'green' },
     },
     scrollable: true,
     alwaysScroll: true,
     scrollbar: {
       ch: '│',
-      style: { fg: 'green' }
+      style: { fg: 'green' },
     },
     keys: true,
     vi: true,
-    mouse: true
+    mouse: true,
   });
 
   let logs = [];
@@ -75,9 +75,15 @@ module.exports = function createOutputPanel(grid, state) {
 
   return {
     element: box,
-    show() { box.show(); },
-    hide() { box.hide(); },
-    focus() { box.focus(); },
+    show() {
+      box.show();
+    },
+    hide() {
+      box.hide();
+    },
+    focus() {
+      box.focus();
+    },
     setData(data) {
       logs = data || [];
       render();
@@ -90,6 +96,6 @@ module.exports = function createOutputPanel(grid, state) {
     clear() {
       logs = [];
       render();
-    }
+    },
   };
 };

package/scripts/tui/blessed/panels/sessions.js

@@ -17,21 +17,21 @@ module.exports = function createSessionsPanel(grid, state) {
     tags: true,
     border: {
       type: 'line',
-      fg: 'cyan'
+      fg: 'cyan',
     },
     style: {
       fg: 'white',
       bg: 'black',
-      border: { fg: 'cyan' }
+      border: { fg: 'cyan' },
     },
     scrollable: true,
     alwaysScroll: true,
     scrollbar: {
       ch: '│',
-      style: { fg: 'cyan' }
+      style: { fg: 'cyan' },
     },
     keys: true,
-    vi: true
+    vi: true,
   });
 
   // Header row
@@ -41,11 +41,12 @@ module.exports = function createSessionsPanel(grid, state) {
     left: 0,
     width: '100%-2',
     height: 1,
-    content: '{bold}{cyan-fg}  ID          Story                              Status        Time{/}{/}',
+    content:
+      '{bold}{cyan-fg}  ID          Story                              Status        Time{/}{/}',
     tags: true,
     style: {
-      bg: '#222222'
-    }
+      bg: '#222222',
+    },
   });
 
   // Divider
@@ -57,8 +58,8 @@ module.exports = function createSessionsPanel(grid, state) {
     height: 1,
     content: '  ──────────  ─────────────────────────────────  ────────────  ──────',
     style: {
-      fg: 'gray'
-    }
+      fg: 'gray',
+    },
   });
 
   // Content area
@@ -70,8 +71,8 @@ module.exports = function createSessionsPanel(grid, state) {
     height: '100%-3',
     tags: true,
     style: {
-      fg: 'white'
-    }
+      fg: 'white',
+    },
   });
 
   let sessions = [];
@@ -117,9 +118,15 @@ module.exports = function createSessionsPanel(grid, state) {
 
   return {
     element: box,
-    show() { box.show(); },
-    hide() { box.hide(); },
-    focus() { box.focus(); },
+    show() {
+      box.show();
+    },
+    hide() {
+      box.hide();
+    },
+    focus() {
+      box.focus();
+    },
     setData(data) {
       sessions = data || [];
       render();
@@ -138,6 +145,6 @@ module.exports = function createSessionsPanel(grid, state) {
         selectedIndex--;
         render();
       }
-    }
+    },
   };
 };

package/scripts/tui/blessed/panels/trace.js

@@ -16,21 +16,21 @@ module.exports = function createTracePanel(grid, state) {
     tags: true,
     border: {
       type: 'line',
-      fg: 'yellow'
+      fg: 'yellow',
     },
     style: {
       fg: 'white',
       bg: 'black',
-      border: { fg: 'yellow' }
+      border: { fg: 'yellow' },
     },
     scrollable: true,
     alwaysScroll: true,
     scrollbar: {
       ch: '│',
-      style: { fg: 'yellow' }
+      style: { fg: 'yellow' },
     },
     keys: true,
-    vi: true
+    vi: true,
   });
 
   let traces = [];
@@ -76,9 +76,15 @@ module.exports = function createTracePanel(grid, state) {
 
   return {
     element: box,
-    show() { box.show(); },
-    hide() { box.hide(); },
-    focus() { box.focus(); },
+    show() {
+      box.show();
+    },
+    hide() {
+      box.hide();
+    },
+    focus() {
+      box.focus();
+    },
     setData(data) {
       traces = data || [];
       render();
@@ -86,6 +92,6 @@ module.exports = function createTracePanel(grid, state) {
     addStep(action, status = 'running', details = '') {
       traces.push({ action, status, details, duration: '--' });
       render();
-    }
+    },
   };
 };

package/scripts/tui/blessed/ui/help.js

@@ -18,7 +18,7 @@ module.exports = function createHelpOverlay(screen, state) {
     style: {
       fg: 'white',
       bg: 'black',
-      border: { fg: 'yellow' }
+      border: { fg: 'yellow' },
     },
     label: ' {yellow-fg}Help{/yellow-fg} ',
     hidden: true,
@@ -44,7 +44,7 @@ module.exports = function createHelpOverlay(screen, state) {
   {cyan-fg}q{/}         Quit TUI
   {cyan-fg}Ctrl+C{/}    Force quit
 
-{gray-fg}Press Escape or ? to close{/gray-fg}`
+{gray-fg}Press Escape or ? to close{/gray-fg}`,
   });
 
   // Close help on various keys
@@ -72,6 +72,6 @@ module.exports = function createHelpOverlay(screen, state) {
     },
     isVisible() {
       return !help.hidden;
-    }
+    },
   };
 };

package/scripts/tui/blessed/ui/screen.js

@@ -11,18 +11,18 @@ const blessed = require('blessed');
  */
 module.exports = function createScreen() {
   const screen = blessed.screen({
-    smartCSR: true,      // Key for flicker-free differential rendering
-    fullUnicode: true,   // Support Unicode characters
+    smartCSR: true, // Key for flicker-free differential rendering
+    fullUnicode: true, // Support Unicode characters
     title: 'AgileFlow TUI',
     cursor: {
       artificial: true,
       blink: true,
-      shape: 'line'
+      shape: 'line',
     },
     debug: false,
     warnings: false,
     autoPadding: true,
-    dockBorders: true
+    dockBorders: true,
   });
 
   // Enable synchronized output mode for atomic updates

package/scripts/tui/blessed/ui/statusbar.js

@@ -16,8 +16,8 @@ module.exports = function createStatusBar(screen, state) {
     tags: true,
     style: {
       fg: 'white',
-      bg: 'blue'
-    }
+      bg: 'blue',
+    },
   });
 
   // Always-visible key hints (nano-style for user-friendliness)
@@ -27,7 +27,7 @@ module.exports = function createStatusBar(screen, state) {
     '{bold}j/k{/bold}:Nav',
     '{bold}r{/bold}:Refresh',
     '{bold}?{/bold}:Help',
-    '{bold}q{/bold}:Quit'
+    '{bold}q{/bold}:Quit',
   ];
 
   const hintText = ' ' + hints.join('  ');
@@ -37,15 +37,11 @@ module.exports = function createStatusBar(screen, state) {
     element: statusBar,
     setStatus(text) {
       // Show custom status with key hints
-      const shortHints = [
-        '{bold}r{/bold}:Refresh',
-        '{bold}?{/bold}:Help',
-        '{bold}q{/bold}:Quit'
-      ];
+      const shortHints = ['{bold}r{/bold}:Refresh', '{bold}?{/bold}:Help', '{bold}q{/bold}:Quit'];
       statusBar.setContent(` ${text}  |  ${shortHints.join('  ')}`);
     },
     resetHints() {
       statusBar.setContent(hintText);
-    }
+    },
   };
 };

package/scripts/tui/blessed/ui/tabbar.js

@@ -14,8 +14,8 @@ module.exports = function createTabBar(screen, state) {
     width: '100%',
     height: 3,
     style: {
-      bg: 'black'
-    }
+      bg: 'black',
+    },
   });
 
   // Logo/title
@@ -28,8 +28,8 @@ module.exports = function createTabBar(screen, state) {
     content: '{bold}{#e8683a-fg}▄▀▄ AgileFlow{/}',
     tags: true,
     style: {
-      bg: 'black'
-    }
+      bg: 'black',
+    },
   });
 
   // Tab container
@@ -40,8 +40,8 @@ module.exports = function createTabBar(screen, state) {
     width: '100%-20',
     height: 3,
     style: {
-      bg: 'black'
-    }
+      bg: 'black',
+    },
   });
 
   // Create styled tabs
@@ -56,8 +56,8 @@ module.exports = function createTabBar(screen, state) {
       tags: true,
       style: {
         fg: 'white',
-        bg: 'black'
-      }
+        bg: 'black',
+      },
     });
     return tab;
   });
@@ -72,8 +72,8 @@ module.exports = function createTabBar(screen, state) {
     content: '{gray-fg}v2.90.7{/}',
     tags: true,
     style: {
-      bg: 'black'
-    }
+      bg: 'black',
+    },
   });
 
   return {
@@ -94,6 +94,6 @@ module.exports = function createTabBar(screen, state) {
           tab.setContent(`[${i + 1}] ${state.tabs[i]}`);
         }
       });
-    }
+    },
   };
 };

package/scripts/validators/component-validator.js

@@ -22,7 +22,7 @@ const fs = require('fs');
 const path = require('path');
 
 let input = '';
-process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('data', chunk => (input += chunk));
 process.stdin.on('end', () => {
   try {
     const context = JSON.parse(input);
@@ -62,9 +62,11 @@ function isComponentFile(filePath) {
   // Also check for .js/.ts files in component directories
   if (['.js', '.ts'].includes(ext)) {
     const normalizedPath = filePath.toLowerCase();
-    return normalizedPath.includes('/components/') ||
-           normalizedPath.includes('/pages/') ||
-           normalizedPath.includes('/views/');
+    return (
+      normalizedPath.includes('/components/') ||
+      normalizedPath.includes('/pages/') ||
+      normalizedPath.includes('/views/')
+    );
   }
 
   return componentExtensions.includes(ext);
@@ -101,7 +103,6 @@ function validateComponent(filePath) {
 
     // General accessibility checks
     issues.push(...validateAccessibility(content));
-
   } catch (e) {
     issues.push(`Read error: ${e.message}`);
   }
@@ -113,12 +114,22 @@ function validateReactComponent(content, fileName) {
   const issues = [];
 
   // Check for component export
-  if (!content.includes('export default') && !content.includes('export function') && !content.includes('export const')) {
-    issues.push('Component should have an export (export default, export function, or export const)');
+  if (
+    !content.includes('export default') &&
+    !content.includes('export function') &&
+    !content.includes('export const')
+  ) {
+    issues.push(
+      'Component should have an export (export default, export function, or export const)'
+    );
   }
 
   // Check for React import in JSX files
-  if (content.includes('React.') && !content.includes("from 'react'") && !content.includes('from "react"')) {
+  if (
+    content.includes('React.') &&
+    !content.includes("from 'react'") &&
+    !content.includes('from "react"')
+  ) {
     issues.push('Using React. prefix but React is not imported');
   }
 
@@ -132,12 +143,18 @@ function validateReactComponent(content, fileName) {
   // Check for inline styles (prefer CSS modules or styled-components)
   const inlineStyleCount = (content.match(/style=\{\{/g) || []).length;
   if (inlineStyleCount > 5) {
-    issues.push(`Too many inline styles (${inlineStyleCount}) - consider using CSS modules or styled-components`);
+    issues.push(
+      `Too many inline styles (${inlineStyleCount}) - consider using CSS modules or styled-components`
+    );
   }
 
   // Check for console.log in production code
-  if (content.includes('console.log') && !content.includes('// debug') && !content.includes('// DEBUG')) {
-    console.log('Note: console.log found - ensure it\'s removed before production');
+  if (
+    content.includes('console.log') &&
+    !content.includes('// debug') &&
+    !content.includes('// DEBUG')
+  ) {
+    console.log("Note: console.log found - ensure it's removed before production");
   }
 
   // Check for missing key prop in map
@@ -163,7 +180,11 @@ function validateVueComponent(content) {
   }
 
   // Check for scoped styles (recommended)
-  if (content.includes('<style>') && !content.includes('<style scoped') && !content.includes('scoped>')) {
+  if (
+    content.includes('<style>') &&
+    !content.includes('<style scoped') &&
+    !content.includes('scoped>')
+  ) {
     console.log('Note: Consider using scoped styles to prevent CSS leaks');
   }
 
@@ -200,11 +221,17 @@ function validateAccessibility(content) {
   // Check for click handlers on non-interactive elements
   const clickOnDiv = content.match(/onClick[^>]*>[^<]*<\/div>/gi) || [];
   if (clickOnDiv.length > 0) {
-    issues.push('onClick on <div> detected - use <button> for interactive elements (accessibility)');
+    issues.push(
+      'onClick on <div> detected - use <button> for interactive elements (accessibility)'
+    );
   }
 
   // Check for form inputs without labels
-  if (content.includes('<input') && !content.includes('<label') && !content.includes('aria-label')) {
+  if (
+    content.includes('<input') &&
+    !content.includes('<label') &&
+    !content.includes('aria-label')
+  ) {
     console.log('Note: <input> elements should have associated <label> or aria-label');
   }
 

package/scripts/validators/json-schema-validator.js

@@ -21,8 +21,16 @@
 const fs = require('fs');
 const path = require('path');
 
+// Import status constants from single source of truth
+const { VALID_STATUSES } = require('../lib/story-state-machine');
+
+// Extended statuses for backward compatibility (maps to canonical values)
+// These legacy values are accepted but should be migrated to canonical values
+const LEGACY_STATUSES = ['pending', 'done', 'in-progress', 'in-review'];
+const ALL_ACCEPTED_STATUSES = [...VALID_STATUSES, ...LEGACY_STATUSES];
+
 let input = '';
-process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('data', chunk => (input += chunk));
 process.stdin.on('end', () => {
   try {
     const context = JSON.parse(input);
@@ -85,7 +93,6 @@ function validateJson(filePath) {
     } else if (fileName === 'tsconfig.json') {
       issues.push(...validateTsConfig(data));
     }
-
   } catch (e) {
     if (e instanceof SyntaxError) {
       issues.push(`Invalid JSON syntax: ${e.message}`);
@@ -132,7 +139,7 @@ function validateStatusJson(data) {
         if (!story.title && !story.name) {
           issues.push(`Story ${story.id || index} missing 'title' or 'name' field`);
         }
-        if (story.status && !['pending', 'in_progress', 'completed', 'done', 'blocked', 'ready', 'in-progress', 'in_review', 'in-review', 'archived'].includes(story.status)) {
+        if (story.status && !ALL_ACCEPTED_STATUSES.includes(story.status)) {
           issues.push(`Story ${story.id || index} has invalid status: ${story.status}`);
         }
       });
@@ -142,7 +149,7 @@ function validateStatusJson(data) {
         if (!story.title && !story.name) {
           issues.push(`Story ${storyId} missing 'title' or 'name' field`);
         }
-        if (story.status && !['pending', 'in_progress', 'completed', 'done', 'blocked', 'ready', 'in-progress', 'in_review', 'in-review', 'archived'].includes(story.status)) {
+        if (story.status && !ALL_ACCEPTED_STATUSES.includes(story.status)) {
           issues.push(`Story ${storyId} has invalid status: ${story.status}`);
         }
       });

package/scripts/validators/markdown-validator.js

@@ -22,7 +22,7 @@ const fs = require('fs');
 const path = require('path');
 
 let input = '';
-process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('data', chunk => (input += chunk));
 process.stdin.on('end', () => {
   try {
     const context = JSON.parse(input);
@@ -108,7 +108,6 @@ function validateMarkdown(filePath) {
     } else if (filePath.includes('/10-research/')) {
       issues.push(...validateResearchNote(content));
     }
-
   } catch (e) {
     issues.push(`Read error: ${e.message}`);
   }

package/scripts/validators/migration-validator.js

@@ -19,7 +19,7 @@
  */
 
 let input = '';
-process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('data', chunk => (input += chunk));
 process.stdin.on('end', () => {
   try {
     const context = JSON.parse(input);
@@ -71,10 +71,19 @@ function validateMigration(command, result) {
 
   // Check for destructive operations without safeguards
   const destructivePatterns = [
-    { pattern: /DROP\s+TABLE/i, message: 'DROP TABLE detected - ensure backup exists and this is intentional' },
-    { pattern: /DROP\s+DATABASE/i, message: 'DROP DATABASE detected - this is extremely destructive!' },
+    {
+      pattern: /DROP\s+TABLE/i,
+      message: 'DROP TABLE detected - ensure backup exists and this is intentional',
+    },
+    {
+      pattern: /DROP\s+DATABASE/i,
+      message: 'DROP DATABASE detected - this is extremely destructive!',
+    },
     { pattern: /TRUNCATE/i, message: 'TRUNCATE detected - this removes all data permanently' },
-    { pattern: /DELETE\s+FROM.*WHERE\s*$/i, message: 'DELETE without WHERE clause detected - will delete all rows' },
+    {
+      pattern: /DELETE\s+FROM.*WHERE\s*$/i,
+      message: 'DELETE without WHERE clause detected - will delete all rows',
+    },
     { pattern: /--force|--skip-safe/i, message: 'Force flag used - bypassing safety checks' },
   ];
 
@@ -94,7 +103,10 @@ function validateMigration(command, result) {
     { pattern: /error.*migration/i, message: 'Migration error detected in output' },
     { pattern: /rollback.*failed/i, message: 'Rollback failure detected' },
     { pattern: /constraint.*violation/i, message: 'Database constraint violation' },
-    { pattern: /duplicate.*key/i, message: 'Duplicate key error - migration may have partially applied' },
+    {
+      pattern: /duplicate.*key/i,
+      message: 'Duplicate key error - migration may have partially applied',
+    },
     { pattern: /already exists/i, message: 'Object already exists - migration may need cleanup' },
   ];