agileflow 3.4.3 → 4.0.0-alpha.2

package/scripts/generators/agent-registry.js

@@ -1,183 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Agent Registry Scanner
- *
- * Scans agents/ directory and extracts metadata from frontmatter.
- * Returns structured agent registry for use in generators.
- *
- * Set DEBUG_REGISTRY=1 for verbose logging of skipped files.
- */
-
-const fs = require('fs');
-const fsp = require('fs').promises;
-const path = require('path');
-const { extractFrontmatter, normalizeTools } = require('../lib/frontmatter-parser');
-const { getCached, setCached } = require('../../lib/registry-cache');
-
-// Lazy-load model-profiles to avoid circular deps and missing-module crashes
-let _resolveModel;
-function getResolveModel() {
-  if (_resolveModel === undefined) {
-    try {
-      _resolveModel = require('../lib/model-profiles').resolveModel;
-    } catch (_) {
-      _resolveModel = null;
-    }
-  }
-  return _resolveModel;
-}
-
-// Debug mode: set DEBUG_REGISTRY=1 to see why files are skipped
-const DEBUG = process.env.DEBUG_REGISTRY === '1';
-
-/**
- * Log debug messages when DEBUG_REGISTRY=1
- * @param {string} message - Message to log
- */
-function debugLog(message) {
-  if (DEBUG) {
-    console.error(`[agent-registry] ${message}`);
-  }
-}
-
-/**
- * Categorize agent based on its role
- * @param {string} name - Agent name
- * @param {string} description - Agent description
- * @returns {string} Category name
- */
-function categorizeAgent(name, description) {
-  const categories = {
-    'Core Development': ['ui', 'api', 'database', 'devops', 'ci'],
-    'Specialized Development': ['mobile', 'integrations', 'datamigration'],
-    'Quality & Testing': ['qa', 'testing', 'security', 'accessibility'],
-    'Architecture & Design': ['design', 'adr-writer', 'epic-planner', 'product'],
-    'Maintenance & Optimization': ['refactor', 'performance', 'monitoring'],
-    'Documentation & Knowledge': ['documentation', 'readme-updater', 'research'],
-    'Compliance & Governance': ['compliance', 'analytics'],
-    Mentorship: ['mentor'],
-  };
-
-  for (const [category, keywords] of Object.entries(categories)) {
-    if (keywords.some(kw => name.includes(kw))) {
-      return category;
-    }
-  }
-
-  return 'Other';
-}
-
-/**
- * Scan agents directory and build registry
- * @param {string} agentsDir - Path to agents directory
- * @returns {Promise<Array>} Array of agent metadata objects
- */
-async function scanAgents(agentsDir) {
-  // Check cache first
-  const cached = getCached(agentsDir);
-  if (cached) {
-    debugLog(`Using cached agents for ${agentsDir}`);
-    return cached;
-  }
-
-  const agents = [];
-  const skipped = [];
-
-  let files;
-  try {
-    files = await fsp.readdir(agentsDir);
-  } catch (err) {
-    debugLog(`Failed to read directory: ${err.message}`);
-    return agents;
-  }
-
-  debugLog(`Scanning ${files.length} files in ${agentsDir}`);
-
-  for (const file of files) {
-    if (!file.endsWith('.md')) {
-      debugLog(`Skipping non-md file: ${file}`);
-      continue;
-    }
-
-    const filePath = path.join(agentsDir, file);
-    const frontmatter = extractFrontmatter(filePath);
-    const name = file.replace('.md', '');
-
-    // Check if frontmatter was extracted successfully
-    if (Object.keys(frontmatter).length === 0) {
-      skipped.push({ file, reason: 'no frontmatter or parse error' });
-      debugLog(`Skipping ${file}: no frontmatter found`);
-      continue;
-    }
-
-    // Normalize tools field (handles array or comma-separated string)
-    const tools = normalizeTools(frontmatter.tools);
-
-    debugLog(`Loaded ${file}: name="${frontmatter.name || name}", tools=${tools.length}`);
-
-    agents.push({
-      name,
-      file,
-      path: filePath,
-      displayName: frontmatter.name || name,
-      description: frontmatter.description || '',
-      tools,
-      model: (getResolveModel() || ((_, fm) => fm || 'haiku'))(null, frontmatter.model),
-      color: frontmatter.color || 'blue',
-      category: categorizeAgent(name, frontmatter.description || ''),
-    });
-  }
-
-  // Sort by category, then by name
-  agents.sort((a, b) => {
-    if (a.category !== b.category) {
-      return a.category.localeCompare(b.category);
-    }
-    return a.name.localeCompare(b.name);
-  });
-
-  if (skipped.length > 0) {
-    debugLog(`Skipped ${skipped.length} files: ${skipped.map(s => s.file).join(', ')}`);
-  }
-
-  debugLog(`Found ${agents.length} agents`);
-
-  // Cache the result
-  setCached(agentsDir, agents);
-
-  return agents;
-}
-
-/**
- * Main function
- */
-async function main() {
-  const rootDir = path.resolve(__dirname, '../..');
-  const agentsDir = path.join(rootDir, 'src/core/agents');
-
-  if (!fs.existsSync(agentsDir)) {
-    console.error(`Agents directory not found: ${agentsDir}`);
-    process.exit(1);
-  }
-
-  const agents = await scanAgents(agentsDir);
-
-  // If called directly, output JSON
-  if (require.main === module) {
-    console.log(JSON.stringify(agents, null, 2));
-  }
-
-  return agents;
-}
-
-// Export for use in other scripts
-module.exports = { scanAgents, categorizeAgent };
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(err => {
-    console.error('Error:', err.message);
-    process.exit(1);
-  });
-}

package/scripts/generators/command-registry.js

@@ -1,166 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Command Registry Scanner
- *
- * Scans commands/ directory and extracts metadata from frontmatter.
- * Returns structured command registry for use in generators.
- *
- * Set DEBUG_REGISTRY=1 for verbose logging of skipped files.
- */
-
-const fs = require('fs');
-const fsp = require('fs').promises;
-const path = require('path');
-const { extractFrontmatter } = require('../lib/frontmatter-parser');
-const { getCached, setCached } = require('../../lib/registry-cache');
-
-// Debug mode: set DEBUG_REGISTRY=1 to see why files are skipped
-const DEBUG = process.env.DEBUG_REGISTRY === '1';
-
-/**
- * Log debug messages when DEBUG_REGISTRY=1
- * @param {string} message - Message to log
- */
-function debugLog(message) {
-  if (DEBUG) {
-    console.error(`[command-registry] ${message}`);
-  }
-}
-
-/**
- * Categorize command based on its name/description
- * @param {string} name - Command name
- * @param {string} description - Command description
- * @returns {string} Category name
- */
-function categorizeCommand(name, description) {
-  const categories = {
-    'Story Management': ['story', 'epic', 'assign', 'status'],
-    Development: ['verify', 'baseline', 'resume', 'session-init', 'babysit'],
-    'Quality & Testing': ['tests', 'review', 'ci'],
-    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'],
-  };
-
-  for (const [category, keywords] of Object.entries(categories)) {
-    if (keywords.some(kw => name.includes(kw))) {
-      return category;
-    }
-  }
-
-  return 'Other';
-}
-
-/**
- * Scan commands directory and build registry
- * @param {string} commandsDir - Path to commands directory
- * @returns {Promise<Array>} Array of command metadata objects
- */
-async function scanCommands(commandsDir) {
-  // Check cache first
-  const cached = getCached(commandsDir);
-  if (cached) {
-    debugLog(`Using cached commands for ${commandsDir}`);
-    return cached;
-  }
-
-  const commands = [];
-  const skipped = [];
-
-  let files;
-  try {
-    files = await fsp.readdir(commandsDir);
-  } catch (err) {
-    debugLog(`Failed to read directory: ${err.message}`);
-    return commands;
-  }
-
-  debugLog(`Scanning ${files.length} files in ${commandsDir}`);
-
-  for (const file of files) {
-    if (!file.endsWith('.md')) {
-      debugLog(`Skipping non-md file: ${file}`);
-      continue;
-    }
-
-    const filePath = path.join(commandsDir, file);
-    const frontmatter = extractFrontmatter(filePath);
-    const name = file.replace('.md', '');
-
-    // Check if frontmatter was extracted successfully
-    if (Object.keys(frontmatter).length === 0) {
-      skipped.push({ file, reason: 'no frontmatter or parse error' });
-      debugLog(`Skipping ${file}: no frontmatter found`);
-      continue;
-    }
-
-    debugLog(`Loaded ${file}: description="${frontmatter.description || '(none)'}"`);
-
-    commands.push({
-      name,
-      file,
-      path: filePath,
-      description: frontmatter.description || '',
-      argumentHint: frontmatter['argument-hint'] || '',
-      category: categorizeCommand(name, frontmatter.description || ''),
-    });
-  }
-
-  // Sort by category, then by name
-  commands.sort((a, b) => {
-    if (a.category !== b.category) {
-      return a.category.localeCompare(b.category);
-    }
-    return a.name.localeCompare(b.name);
-  });
-
-  if (skipped.length > 0) {
-    debugLog(`Skipped ${skipped.length} files: ${skipped.map(s => s.file).join(', ')}`);
-  }
-
-  debugLog(`Found ${commands.length} commands`);
-
-  // Cache the result
-  setCached(commandsDir, commands);
-
-  return commands;
-}
-
-/**
- * Main function
- */
-async function main() {
-  const rootDir = path.resolve(__dirname, '../..');
-  const commandsDir = path.join(rootDir, 'src/core/commands');
-
-  if (!fs.existsSync(commandsDir)) {
-    console.error(`Commands directory not found: ${commandsDir}`);
-    process.exit(1);
-  }
-
-  const commands = await scanCommands(commandsDir);
-
-  // If called directly, output JSON
-  if (require.main === module) {
-    console.log(JSON.stringify(commands, null, 2));
-  }
-
-  return commands;
-}
-
-// Export for use in other scripts
-module.exports = { scanCommands, categorizeCommand };
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(err => {
-    console.error('Error:', err.message);
-    process.exit(1);
-  });
-}

package/scripts/generators/index.js

@@ -1,85 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Content Generation Orchestrator
- *
- * Runs all content generators to update AgileFlow plugin files.
- * Single source of truth: frontmatter and directory structure.
- */
-
-const path = require('path');
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-
-const execFileAsync = promisify(execFile);
-
-/**
- * Run a generator script asynchronously
- * @param {string} scriptName - Name of the generator script
- * @returns {Promise<{generator: string, success: boolean}>} Result with status
- */
-async function runGenerator(scriptName) {
-  const scriptPath = path.join(__dirname, scriptName);
-
-  console.log(`\n${'='.repeat(60)}`);
-  console.log(`Running: ${scriptName}`);
-  console.log('='.repeat(60));
-
-  try {
-    await execFileAsync('node', [scriptPath], {
-      cwd: __dirname,
-      stdio: 'inherit',
-    });
-    console.log(`✅ ${scriptName} completed successfully`);
-    return { generator: scriptName, success: true };
-  } catch (error) {
-    console.error(`❌ ${scriptName} failed:`, error.message);
-    return { generator: scriptName, success: false };
-  }
-}
-
-/**
- * Main orchestrator
- */
-async 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'];
-
-  // Run all generators in parallel
-  const results = await Promise.all(generators.map(g => runGenerator(g)));
-
-  // Summary
-  console.log(`\n${'='.repeat(60)}`);
-  console.log('GENERATION SUMMARY');
-  console.log('='.repeat(60));
-
-  let allSuccess = true;
-  for (const { generator, success } of results) {
-    const status = success ? '✅' : '❌';
-    console.log(`${status} ${generator}`);
-    if (!success) allSuccess = false;
-  }
-
-  console.log('');
-
-  if (allSuccess) {
-    console.log('🎉 All generators completed successfully!');
-    console.log('📝 Generated content is ready for commit.');
-    process.exit(0);
-  } else {
-    console.log('⚠️  Some generators failed. Please check errors above.');
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(err => {
-    console.error(err);
-    process.exit(1);
-  });
-}
-
-module.exports = { runGenerator };

package/scripts/generators/inject-babysit.js

@@ -1,191 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Babysit Command Content Injector
- *
- * Injects agent list and command references into /agileflow:babysit command file.
- * Handles multiple AUTOGEN sections.
- */
-
-const fs = require('fs');
-const fsp = require('fs').promises;
-const path = require('path');
-const { scanAgents } = require('./agent-registry');
-const { scanCommands } = require('./command-registry');
-
-/**
- * Generate agent list content as category summary with counts.
- * Uses compact format with discovery pointer instead of listing every agent name.
- * Research (arXiv:2602.11988): Full lists increase context cost without improving performance.
- * @param {Array} agents - Array of agent metadata
- * @returns {string} Formatted agent category summary
- */
-function generateAgentList(agents) {
-  const lines = [];
-
-  lines.push(`**AVAILABLE AGENTS** (${agents.length} total):`);
-  lines.push('');
-
-  // Group agents by category for compact output (counts only, not full names)
-  const categories = {};
-  for (const agent of agents) {
-    const cat = agent.category || 'Other';
-    if (!categories[cat]) categories[cat] = { count: 0, examples: [] };
-    categories[cat].count++;
-    // Keep first 3 names as examples
-    if (categories[cat].examples.length < 3) {
-      categories[cat].examples.push(agent.name);
-    }
-  }
-
-  for (const [category, data] of Object.entries(categories)) {
-    const examples = data.examples.join(', ');
-    const more = data.count > 3 ? `, +${data.count - 3} more` : '';
-    lines.push(`**${category}** (${data.count}): ${examples}${more}`);
-  }
-
-  lines.push('');
-  lines.push('Browse all: `ls .agileflow/agents/` or run `/agileflow:help agents`');
-
-  return lines.join('\n');
-}
-
-/**
- * Generate command reference list (compact format for babysit)
- * @param {Array} commands - Array of command metadata
- * @returns {string} Formatted command list
- */
-function generateCommandReference(commands) {
-  const lines = [];
-
-  // Group by category
-  const categories = {};
-  for (const cmd of commands) {
-    if (!categories[cmd.category]) {
-      categories[cmd.category] = [];
-    }
-    categories[cmd.category].push(cmd);
-  }
-
-  for (const [category, cmds] of Object.entries(categories)) {
-    const cmdNames = cmds.map(c => c.name).join(', ');
-    lines.push(`- **${category}**: ${cmdNames}`);
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * Inject content between specified AUTOGEN markers
- * @param {string} content - Original file content
- * @param {string} markerName - Name of the marker (e.g., AGENT_LIST, COMMAND_REF)
- * @param {string} generated - Generated content to inject
- * @returns {string} Updated file content
- */
-function injectContentByMarker(content, markerName, generated) {
-  const startMarker = `<!-- AUTOGEN:${markerName}:START -->`;
-  const endMarker = `<!-- AUTOGEN:${markerName}:END -->`;
-
-  const startIdx = content.indexOf(startMarker);
-  const endIdx = content.indexOf(endMarker);
-
-  if (startIdx === -1 || endIdx === -1) {
-    console.warn(`AUTOGEN:${markerName} markers not found - skipping`);
-    return content;
-  }
-
-  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)
-  );
-}
-
-/**
- * Add AUTOGEN markers to babysit file if they don't exist
- * @param {string} content - Original file content
- * @returns {string} Updated content with markers
- */
-function addMarkersIfMissing(content) {
-  let updated = content;
-
-  // Add AGENT_LIST markers around the agent list section
-  if (!content.includes('<!-- AUTOGEN:AGENT_LIST:START -->')) {
-    // Find "**AVAILABLE AGENTS**" and wrap it
-    const agentSectionStart = content.indexOf('**AVAILABLE AGENTS**');
-    if (agentSectionStart !== -1) {
-      // Find the end of the agent list (before "**WHEN TO SPAWN AGENTS**")
-      const agentSectionEnd = content.indexOf('**WHEN TO SPAWN AGENTS**', agentSectionStart);
-      if (agentSectionEnd !== -1) {
-        const before = content.substring(0, agentSectionStart);
-        const agentSection = content.substring(agentSectionStart, agentSectionEnd);
-        const after = content.substring(agentSectionEnd);
-
-        updated = `${before}<!-- AUTOGEN:AGENT_LIST:START -->\n${agentSection}<!-- AUTOGEN:AGENT_LIST:END -->\n\n${after}`;
-        console.log('✅ Added AGENT_LIST markers to babysit.md');
-      }
-    }
-  }
-
-  return updated;
-}
-
-/**
- * Main function
- */
-async function main() {
-  const rootDir = path.resolve(__dirname, '../..');
-  const babysitFile = path.join(rootDir, 'src/core/commands/babysit.md');
-  const agentsDir = path.join(rootDir, 'src/core/agents');
-  const commandsDir = path.join(rootDir, 'src/core/commands');
-
-  // Check if babysit file exists
-  if (!fs.existsSync(babysitFile)) {
-    console.error(`Babysit file not found: ${babysitFile}`);
-    process.exit(1);
-  }
-
-  // Scan agents and commands
-  console.log('Scanning agents...');
-  const agents = scanAgents(agentsDir);
-  console.log(`Found ${agents.length} agents`);
-
-  console.log('Scanning commands...');
-  const commands = scanCommands(commandsDir);
-  console.log(`Found ${commands.length} commands`);
-
-  // Read babysit file
-  let babysitContent = await fsp.readFile(babysitFile, 'utf-8');
-
-  // Add markers if missing
-  babysitContent = addMarkersIfMissing(babysitContent);
-
-  // Generate content
-  console.log('Generating agent list...');
-  const agentList = generateAgentList(agents);
-
-  // Inject content
-  console.log('Injecting content into babysit.md...');
-  babysitContent = injectContentByMarker(babysitContent, 'AGENT_LIST', agentList);
-
-  // Write back
-  await fsp.writeFile(babysitFile, babysitContent, 'utf-8');
-  console.log('✅ Successfully updated babysit.md');
-}
-
-// Export for use in orchestrator
-module.exports = {
-  generateAgentList,
-  generateCommandReference,
-  injectContentByMarker,
-  addMarkersIfMissing,
-};
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(err => {
-    console.error(err);
-    process.exit(1);
-  });
-}