agileflow 2.51.0 → 2.55.0

package/scripts/agileflow-welcome.js

@@ -13,7 +13,10 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { execSync, spawnSync } = require('child_process');
+
+// Session manager path (relative to script location)
+const SESSION_MANAGER_PATH = path.join(__dirname, 'session-manager.js');
 
 // ANSI color codes
 const c = {
@@ -39,9 +42,16 @@ const c = {
 
 // Box drawing characters
 const box = {
-  tl: '╭', tr: '╮', bl: '╰', br: '╯',
-  h: '─', v: '│',
-  lT: '├', rT: '┤', tT: '┬', bT: '┴',
+  tl: '╭',
+  tr: '╮',
+  bl: '╰',
+  br: '╯',
+  h: '─',
+  v: '│',
+  lT: '├',
+  rT: '┤',
+  tT: '┬',
+  bT: '┴',
   cross: '┼',
 };
 
@@ -70,7 +80,9 @@ function getProjectInfo(rootDir) {
 
   // Get package info
   try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(rootDir, 'packages/cli/package.json'), 'utf8'));
+    const pkg = JSON.parse(
+      fs.readFileSync(path.join(rootDir, 'packages/cli/package.json'), 'utf8')
+    );
     info.version = pkg.version || info.version;
   } catch (e) {
     try {
@@ -83,7 +95,10 @@ function getProjectInfo(rootDir) {
   try {
     info.branch = execSync('git branch --show-current', { cwd: rootDir, encoding: 'utf8' }).trim();
     info.commit = execSync('git rev-parse --short HEAD', { cwd: rootDir, encoding: 'utf8' }).trim();
-    info.lastCommit = execSync('git log -1 --format="%s"', { cwd: rootDir, encoding: 'utf8' }).trim();
+    info.lastCommit = execSync('git log -1 --format="%s"', {
+      cwd: rootDir,
+      encoding: 'utf8',
+    }).trim();
   } catch (e) {}
 
   // Get status info
@@ -155,7 +170,7 @@ function runArchival(rootDir) {
         execSync('bash scripts/archive-completed-stories.sh', {
           cwd: rootDir,
           encoding: 'utf8',
-          stdio: 'pipe'
+          stdio: 'pipe',
         });
         result.archived = toArchiveCount;
         result.remaining -= toArchiveCount;
@@ -201,6 +216,60 @@ function clearActiveCommands(rootDir) {
   return result;
 }
 
+function checkParallelSessions(rootDir) {
+  const result = {
+    available: false,
+    registered: false,
+    otherActive: 0,
+    currentId: null,
+    cleaned: 0,
+  };
+
+  try {
+    // Check if session manager exists
+    const managerPath = path.join(rootDir, '.agileflow', 'scripts', 'session-manager.js');
+    if (!fs.existsSync(managerPath) && !fs.existsSync(SESSION_MANAGER_PATH)) {
+      return result;
+    }
+
+    result.available = true;
+
+    // Try to register current session and get status
+    const scriptPath = fs.existsSync(managerPath) ? managerPath : SESSION_MANAGER_PATH;
+
+    // Register this session
+    try {
+      const registerOutput = execSync(`node "${scriptPath}" register`, {
+        cwd: rootDir,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      const registerData = JSON.parse(registerOutput);
+      result.registered = true;
+      result.currentId = registerData.id;
+    } catch (e) {
+      // Registration failed, continue anyway
+    }
+
+    // Get count of other active sessions
+    try {
+      const countOutput = execSync(`node "${scriptPath}" count`, {
+        cwd: rootDir,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      const countData = JSON.parse(countOutput);
+      result.otherActive = countData.count || 0;
+    } catch (e) {
+      // Count failed
+    }
+  } catch (e) {
+    // Session system not available
+  }
+
+  return result;
+}
+
 function checkPreCompact(rootDir) {
   const result = { configured: false, scriptExists: false, version: null, outdated: false };
 
@@ -258,7 +327,7 @@ function getFeatureVersions(rootDir) {
     hooks: { version: null, outdated: false },
     archival: { version: null, outdated: false },
     statusline: { version: null, outdated: false },
-    precompact: { version: null, outdated: false }
+    precompact: { version: null, outdated: false },
   };
 
   // Minimum compatible versions for each feature
@@ -266,7 +335,7 @@ function getFeatureVersions(rootDir) {
     hooks: '2.35.0',
     archival: '2.35.0',
     statusline: '2.35.0',
-    precompact: '2.40.0'  // Multi-command support
+    precompact: '2.40.0', // Multi-command support
   };
 
   try {
@@ -277,7 +346,8 @@ function getFeatureVersions(rootDir) {
       for (const feature of Object.keys(result)) {
         if (metadata.features?.[feature]?.configured_version) {
           result[feature].version = metadata.features[feature].configured_version;
-          result[feature].outdated = compareVersions(result[feature].version, minVersions[feature]) < 0;
+          result[feature].outdated =
+            compareVersions(result[feature].version, minVersions[feature]) < 0;
         }
       }
     }
@@ -291,7 +361,8 @@ function pad(str, len, align = 'left') {
   const diff = len - stripped.length;
   if (diff <= 0) return str;
   if (align === 'right') return ' '.repeat(diff) + str;
-  if (align === 'center') return ' '.repeat(Math.floor(diff/2)) + str + ' '.repeat(Math.ceil(diff/2));
+  if (align === 'center')
+    return ' '.repeat(Math.floor(diff / 2)) + str + ' '.repeat(Math.ceil(diff / 2));
   return str + ' '.repeat(diff);
 }
 
@@ -323,7 +394,7 @@ function truncate(str, maxLen, suffix = '..') {
   return str.substring(0, cutIndex) + suffix;
 }
 
-function formatTable(info, archival, session, precompact) {
+function formatTable(info, archival, session, precompact, parallelSessions) {
   const W = 58; // inner width
   const R = W - 24; // right column width (34 chars)
   const lines = [];
@@ -336,17 +407,20 @@ function formatTable(info, archival, session, precompact) {
     return `${c.dim}${box.v}${c.reset} ${pad(leftStr, 20)} ${c.dim}${box.v}${c.reset} ${pad(rightStr, R)} ${c.dim}${box.v}${c.reset}`;
   };
 
-  const divider = () => `${c.dim}${box.lT}${box.h.repeat(22)}${box.cross}${box.h.repeat(W - 22)}${box.rT}${c.reset}`;
+  const divider = () =>
+    `${c.dim}${box.lT}${box.h.repeat(22)}${box.cross}${box.h.repeat(W - 22)}${box.rT}${c.reset}`;
   const topBorder = `${c.dim}${box.tl}${box.h.repeat(22)}${box.tT}${box.h.repeat(W - 22)}${box.tr}${c.reset}`;
   const bottomBorder = `${c.dim}${box.bl}${box.h.repeat(22)}${box.bT}${box.h.repeat(W - 22)}${box.br}${c.reset}`;
 
   // Header (truncate branch name if too long)
-  const branchColor = info.branch === 'main' ? c.green : info.branch.startsWith('fix') ? c.red : c.cyan;
+  const branchColor =
+    info.branch === 'main' ? c.green : info.branch.startsWith('fix') ? c.red : c.cyan;
   // Fixed parts: "agileflow " (10) + "v" (1) + version + "  " (2) + " (" (2) + commit (7) + ")" (1) = 23 + version.length
-  const maxBranchLen = (W - 1) - 23 - info.version.length;
-  const branchDisplay = info.branch.length > maxBranchLen
-    ? info.branch.substring(0, maxBranchLen - 2) + '..'
-    : info.branch;
+  const maxBranchLen = W - 1 - 23 - info.version.length;
+  const branchDisplay =
+    info.branch.length > maxBranchLen
+      ? info.branch.substring(0, maxBranchLen - 2) + '..'
+      : info.branch;
   const header = `${c.brand}${c.bold}agileflow${c.reset} ${c.dim}v${info.version}${c.reset}  ${branchColor}${branchDisplay}${c.reset} ${c.dim}(${info.commit})${c.reset}`;
   const headerLine = `${c.dim}${box.v}${c.reset} ${pad(header, W - 1)} ${c.dim}${box.v}${c.reset}`;
 
@@ -355,10 +429,38 @@ function formatTable(info, archival, session, precompact) {
   lines.push(divider());
 
   // Stories section
-  lines.push(row('In Progress', info.wipCount > 0 ? `${info.wipCount}` : '0', c.dim, info.wipCount > 0 ? c.yellow : c.dim));
-  lines.push(row('Blocked', info.blockedCount > 0 ? `${info.blockedCount}` : '0', c.dim, info.blockedCount > 0 ? c.red : c.dim));
-  lines.push(row('Ready', info.readyCount > 0 ? `${info.readyCount}` : '0', c.dim, info.readyCount > 0 ? c.cyan : c.dim));
-  lines.push(row('Completed', info.completedCount > 0 ? `${info.completedCount}` : '0', c.dim, info.completedCount > 0 ? c.green : c.dim));
+  lines.push(
+    row(
+      'In Progress',
+      info.wipCount > 0 ? `${info.wipCount}` : '0',
+      c.dim,
+      info.wipCount > 0 ? c.yellow : c.dim
+    )
+  );
+  lines.push(
+    row(
+      'Blocked',
+      info.blockedCount > 0 ? `${info.blockedCount}` : '0',
+      c.dim,
+      info.blockedCount > 0 ? c.red : c.dim
+    )
+  );
+  lines.push(
+    row(
+      'Ready',
+      info.readyCount > 0 ? `${info.readyCount}` : '0',
+      c.dim,
+      info.readyCount > 0 ? c.cyan : c.dim
+    )
+  );
+  lines.push(
+    row(
+      'Completed',
+      info.completedCount > 0 ? `${info.completedCount}` : '0',
+      c.dim,
+      info.completedCount > 0 ? c.green : c.dim
+    )
+  );
 
   lines.push(divider());
 
@@ -366,16 +468,15 @@ function formatTable(info, archival, session, precompact) {
   if (archival.disabled) {
     lines.push(row('Auto-archival', 'disabled', c.dim, c.dim));
   } else {
-    const archivalStatus = archival.archived > 0
-      ? `archived ${archival.archived} stories`
-      : `nothing to archive`;
-    lines.push(row('Auto-archival', archivalStatus, c.dim, archival.archived > 0 ? c.green : c.dim));
+    const archivalStatus =
+      archival.archived > 0 ? `archived ${archival.archived} stories` : `nothing to archive`;
+    lines.push(
+      row('Auto-archival', archivalStatus, c.dim, archival.archived > 0 ? c.green : c.dim)
+    );
   }
 
   // Session cleanup
-  const sessionStatus = session.cleared > 0
-    ? `cleared ${session.cleared} command(s)`
-    : `clean`;
+  const sessionStatus = session.cleared > 0 ? `cleared ${session.cleared} command(s)` : `clean`;
   lines.push(row('Session state', sessionStatus, c.dim, session.cleared > 0 ? c.green : c.dim));
 
   // PreCompact status with version check
@@ -396,11 +497,31 @@ function formatTable(info, archival, session, precompact) {
     lines.push(row('Context preserve', 'not configured', c.dim, c.dim));
   }
 
+  // Parallel sessions status
+  if (parallelSessions && parallelSessions.available) {
+    if (parallelSessions.otherActive > 0) {
+      const sessionStr = `⚠️ ${parallelSessions.otherActive} other active`;
+      lines.push(row('Sessions', sessionStr, c.dim, c.yellow));
+    } else {
+      const sessionStr = parallelSessions.currentId
+        ? `✓ Session ${parallelSessions.currentId} (only)`
+        : '✓ Only session';
+      lines.push(row('Sessions', sessionStr, c.dim, c.green));
+    }
+  }
+
   lines.push(divider());
 
   // Current story (if any) - row() auto-truncates
   if (info.currentStory) {
-    lines.push(row('Current', `${c.blue}${info.currentStory.id}${c.reset}: ${info.currentStory.title}`, c.dim, ''));
+    lines.push(
+      row(
+        'Current',
+        `${c.blue}${info.currentStory.id}${c.reset}: ${info.currentStory.title}`,
+        c.dim,
+        ''
+      )
+    );
   } else {
     lines.push(row('Current', 'No active story', c.dim, c.dim));
   }
@@ -420,8 +541,17 @@ function main() {
   const archival = runArchival(rootDir);
   const session = clearActiveCommands(rootDir);
   const precompact = checkPreCompact(rootDir);
+  const parallelSessions = checkParallelSessions(rootDir);
+
+  console.log(formatTable(info, archival, session, precompact, parallelSessions));
 
-  console.log(formatTable(info, archival, session, precompact));
+  // Show warning and tip if other sessions are active
+  if (parallelSessions.otherActive > 0) {
+    console.log('');
+    console.log(`${c.yellow}⚠️  Other Claude session(s) active in this repo.${c.reset}`);
+    console.log(`${c.dim}   Run /agileflow:session:status to see all sessions.${c.reset}`);
+    console.log(`${c.dim}   Run /agileflow:session:new to create isolated workspace.${c.reset}`);
+  }
 }
 
 main();

package/scripts/generators/agent-registry.js

@@ -74,7 +74,7 @@ function categorizeAgent(name, description) {
     'Maintenance & Optimization': ['refactor', 'performance', 'monitoring'],
     'Documentation & Knowledge': ['documentation', 'readme-updater', 'research'],
     'Compliance & Governance': ['compliance', 'analytics'],
-    'Mentorship': ['mentor']
+    Mentorship: ['mentor'],
   };
 
   for (const [category, keywords] of Object.entries(categories)) {
@@ -121,7 +121,7 @@ function scanAgents(agentsDir) {
       tools,
       model: frontmatter.model || 'haiku',
       color: frontmatter.color || 'blue',
-      category: categorizeAgent(name, frontmatter.description || '')
+      category: categorizeAgent(name, frontmatter.description || ''),
     });
   }
 

package/scripts/generators/command-registry.js

@@ -47,15 +47,15 @@ function extractFrontmatter(filePath) {
 function categorizeCommand(name, description) {
   const categories = {
     'Story Management': ['story', 'epic', 'assign', 'status'],
-    'Development': ['verify', 'baseline', 'resume', 'session-init', 'babysit'],
+    Development: ['verify', 'baseline', 'resume', 'session-init', 'babysit'],
     'Quality & Testing': ['tests', 'review', 'ci'],
-    'Documentation': ['docs', 'adr', 'readme-sync'],
+    Documentation: ['docs', 'adr', 'readme-sync'],
     'Planning & Metrics': ['sprint', 'velocity', 'metrics', 'board', 'deps'],
     'Research & Strategy': ['research', 'product'],
     'Deployment & Operations': ['deploy', 'packages'],
-    'Collaboration': ['update', 'handoff', 'feedback', 'retro'],
-    'Maintenance': ['debt', 'compress', 'template'],
-    'System': ['setup', 'help', 'diagnose', 'auto', 'agent']
+    Collaboration: ['update', 'handoff', 'feedback', 'retro'],
+    Maintenance: ['debt', 'compress', 'template'],
+    System: ['setup', 'help', 'diagnose', 'auto', 'agent'],
   };
 
   for (const [category, keywords] of Object.entries(categories)) {
@@ -89,7 +89,7 @@ function scanCommands(commandsDir) {
       path: filePath,
       description: frontmatter.description || '',
       argumentHint: frontmatter['argument-hint'] || '',
-      category: categorizeCommand(name, frontmatter.description || '')
+      category: categorizeCommand(name, frontmatter.description || ''),
     });
   }
 

package/scripts/generators/index.js

@@ -25,7 +25,7 @@ function runGenerator(scriptName) {
   try {
     execSync(`node "${scriptPath}"`, {
       cwd: __dirname,
-      stdio: 'inherit'
+      stdio: 'inherit',
     });
     console.log(`✅ ${scriptName} completed successfully`);
     return true;
@@ -42,11 +42,7 @@ function main() {
   console.log('🚀 AgileFlow Content Generation System');
   console.log('Generating content from metadata...\n');
 
-  const generators = [
-    'inject-help.js',
-    'inject-babysit.js',
-    'inject-readme.js'
-  ];
+  const generators = ['inject-help.js', 'inject-babysit.js', 'inject-readme.js'];
 
   const results = [];
 

package/scripts/generators/inject-babysit.js

@@ -83,7 +83,9 @@ function injectContentByMarker(content, markerName, generated) {
   const timestamp = new Date().toISOString().split('T')[0];
   const injectedContent = `${startMarker}\n<!-- Auto-generated on ${timestamp}. Do not edit manually. -->\n\n${generated}\n${endMarker}`;
 
-  return content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length);
+  return (
+    content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length)
+  );
 }
 
 /**
@@ -159,7 +161,12 @@ function main() {
 }
 
 // Export for use in orchestrator
-module.exports = { generateAgentList, generateCommandReference, injectContentByMarker, addMarkersIfMissing };
+module.exports = {
+  generateAgentList,
+  generateCommandReference,
+  injectContentByMarker,
+  addMarkersIfMissing,
+};
 
 // Run if called directly
 if (require.main === module) {

package/scripts/generators/inject-help.js

@@ -62,7 +62,9 @@ function injectContent(content, generated) {
   const timestamp = new Date().toISOString().split('T')[0];
   const injectedContent = `${startMarker}\n<!-- Auto-generated on ${timestamp}. Do not edit manually. -->\n\n${generated}\n${endMarker}`;
 
-  return content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length);
+  return (
+    content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length)
+  );
 }
 
 /**

package/scripts/generators/inject-readme.js

@@ -91,7 +91,9 @@ function injectContentByMarker(content, markerName, generated) {
   const timestamp = new Date().toISOString().split('T')[0];
   const injectedContent = `${startMarker}\n<!-- Auto-generated on ${timestamp}. Do not edit manually. -->\n\n${generated}\n${endMarker}`;
 
-  return content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length);
+  return (
+    content.substring(0, startIdx) + injectedContent + content.substring(endIdx + endMarker.length)
+  );
 }
 
 /**
@@ -117,7 +119,9 @@ function main() {
   const agents = scanAgents(agentsDir);
   const skills = scanSkills(skillsDir);
 
-  console.log(`Found: ${commands.length} commands, ${agents.length} agents, ${skills.length} skills`);
+  console.log(
+    `Found: ${commands.length} commands, ${agents.length} agents, ${skills.length} skills`
+  );
 
   // Read README
   let readmeContent = fs.readFileSync(readmeFile, 'utf-8');
@@ -127,7 +131,7 @@ function main() {
   const stats = generateStats({
     commands: commands.length,
     agents: agents.length,
-    skills: skills.length
+    skills: skills.length,
   });
 
   console.log('Generating agent table...');

package/scripts/generators/skill-registry.js

@@ -48,10 +48,10 @@ function categorizeSkill(name, description) {
   const categories = {
     'Story & Planning': ['story', 'epic', 'sprint', 'acceptance-criteria'],
     'Code Generation': ['type-definitions', 'validation-schema', 'error-handler'],
-    'Testing': ['test-case'],
-    'Documentation': ['adr', 'api-documentation', 'changelog', 'pr-description'],
-    'Architecture': ['sql-schema', 'diagram'],
-    'Deployment': ['deployment-guide', 'migration-checklist']
+    Testing: ['test-case'],
+    Documentation: ['adr', 'api-documentation', 'changelog', 'pr-description'],
+    Architecture: ['sql-schema', 'diagram'],
+    Deployment: ['deployment-guide', 'migration-checklist'],
   };
 
   const lowerName = name.toLowerCase();
@@ -98,7 +98,7 @@ function scanSkills(skillsDir) {
       file: 'SKILL.md',
       path: skillFile,
       description,
-      category: categorizeSkill(name, description)
+      category: categorizeSkill(name, description),
     });
   }
 

package/scripts/get-env.js

@@ -35,9 +35,7 @@ function getProjectInfo() {
   }
 
   try {
-    rootPackage = JSON.parse(
-      fs.readFileSync(path.join(rootDir, 'package.json'), 'utf8')
-    );
+    rootPackage = JSON.parse(fs.readFileSync(path.join(rootDir, 'package.json'), 'utf8'));
   } catch (err) {
     // Ignore if not found
   }
@@ -50,17 +48,17 @@ function getProjectInfo() {
   try {
     gitBranch = execSync('git branch --show-current', {
       cwd: rootDir,
-      encoding: 'utf8'
+      encoding: 'utf8',
     }).trim();
     gitCommit = execSync('git rev-parse --short HEAD', {
       cwd: rootDir,
-      encoding: 'utf8'
+      encoding: 'utf8',
     }).trim();
 
     // Get recent commits (last 5)
     const commitLog = execSync('git log --oneline -5 2>/dev/null', {
       cwd: rootDir,
-      encoding: 'utf8'
+      encoding: 'utf8',
     }).trim();
     recentCommits = commitLog.split('\n').filter(Boolean);
   } catch (err) {
@@ -68,10 +66,10 @@ function getProjectInfo() {
   }
 
   // Get AgileFlow status info
-  let activeStories = [];
+  const activeStories = [];
   let wipCount = 0;
   let blockedCount = 0;
-  let activeEpics = [];
+  const activeEpics = [];
 
   try {
     const statusPath = path.join(rootDir, 'docs/09-agents/status.json');
@@ -163,13 +161,16 @@ function formatOutput(info, asJson = false, compact = false) {
 
   // Header line with project info (brand color name, dim version, colored branch)
   const branchColor = info.git.branch === 'main' ? c.green : c.cyan;
-  lines.push(`${c.brand}${c.bold}${info.project.name}${c.reset} ${c.dim}v${info.project.version}${c.reset} | ${branchColor}${info.git.branch}${c.reset} ${c.dim}(${info.git.commit})${c.reset}`);
+  lines.push(
+    `${c.brand}${c.bold}${info.project.name}${c.reset} ${c.dim}v${info.project.version}${c.reset} | ${branchColor}${info.git.branch}${c.reset} ${c.dim}(${info.git.commit})${c.reset}`
+  );
 
   // Status line (yellow WIP, red blocked)
   const wipColor = info.agileflow.wipCount > 0 ? c.yellow : c.dim;
-  let statusLine = info.agileflow.wipCount > 0
-    ? `${wipColor}WIP: ${info.agileflow.wipCount}${c.reset}`
-    : `${c.dim}No active work${c.reset}`;
+  let statusLine =
+    info.agileflow.wipCount > 0
+      ? `${wipColor}WIP: ${info.agileflow.wipCount}${c.reset}`
+      : `${c.dim}No active work${c.reset}`;
   if (info.agileflow.blockedCount > 0) {
     statusLine += ` | ${c.red}Blocked: ${info.agileflow.blockedCount}${c.reset}`;
   }