agileflow 2.31.0 → 2.32.1

package/src/core/commands/help.md

@@ -19,72 +19,6 @@ Print a concise, one-screen overview:
 - WIP limit: max 2 stories/agent
 - List ALL available commands with one-line examples
 
-<!-- AUTOGEN:COMMAND_LIST:START -->
-<!-- Auto-generated on 2025-12-12. Do not edit manually. -->
-
-**Collaboration:**
-- `/AgileFlow:feedback` - Collect and process agent feedback
-- `/AgileFlow:handoff` - Document work handoff between agents
-- `/AgileFlow:retro` - Generate retrospective with Start/Stop/Continue format
-- `/AgileFlow:update` - Generate stakeholder progress report
-
-**Deployment & Operations:**
-- `/AgileFlow:deploy` - Set up automated deployment pipeline
-- `/AgileFlow:packages` - Manage dependencies with updates and security audits
-
-**Development:**
-- `/AgileFlow:babysit` - Interactive mentor for end-to-end feature implementation
-- `/AgileFlow:baseline` - Mark current state as verified baseline
-- `/AgileFlow:resume` - Resume work with verification and context loading
-- `/AgileFlow:session-init` - Initialize session harness with test verification
-- `/AgileFlow:verify` - Run project tests and update story test status
-
-**Documentation:**
-- `/AgileFlow:adr` - Create an Architecture Decision Record
-- `/AgileFlow:docs` - Synchronize documentation with code changes
-- `/AgileFlow:readme-sync` - Synchronize a folder's README.md with its current contents
-
-**Maintenance:**
-- `/AgileFlow:compress` - Compress status.json by removing verbose fields and keeping only tracking metadata
-- `/AgileFlow:debt` - Track and prioritize technical debt items
-- `/AgileFlow:template` - Create and manage custom document templates
-
-**Other:**
-- `/AgileFlow:blockers` - Track and resolve blockers with actionable suggestions
-- `/AgileFlow:changelog` - Auto-generate changelog from commit history
-- `/AgileFlow:context` - Generate context export for web AI tools
-- `/AgileFlow:impact` - Analyze change impact across codebase
-- `/AgileFlow:pr` - Generate pull request description from story
-
-**Planning & Metrics:**
-- `/AgileFlow:board` - Display visual kanban board with WIP limits
-- `/AgileFlow:deps` - Visualize dependency graph with critical path detection
-- `/AgileFlow:metrics` - Analytics dashboard with cycle time and throughput
-- `/AgileFlow:sprint` - Data-driven sprint planning with velocity forecasting
-
-**Quality & Testing:**
-- `/AgileFlow:ci` - Bootstrap CI/CD workflow with testing and quality checks
-- `/AgileFlow:review` - AI-powered code review with quality suggestions
-- `/AgileFlow:tests` - Set up automated testing infrastructure
-- `/AgileFlow:velocity` - Track velocity and forecast sprint capacity
-
-**Research & Strategy:**
-- `/AgileFlow:research` - Initialize research note with structured template
-
-**Story Management:**
-- `/AgileFlow:assign` - Assign or reassign a story to an owner
-- `/AgileFlow:epic` - Create a new epic with stories
-- `/AgileFlow:status` - Update story status and progress
-- `/AgileFlow:story` - Create a user story with acceptance criteria
-- `/AgileFlow:story-validate` - Validate story completeness before development
-
-**System:**
-- `/AgileFlow:agent` - Onboard a new agent with profile and contract
-- `/AgileFlow:auto` - Auto-generate stories from PRDs, mockups, or specs
-- `/AgileFlow:diagnose` - System health diagnostics
-- `/AgileFlow:help` - Display AgileFlow system overview and commands
-- `/AgileFlow:setup` - Bootstrap entire AgileFlow system in current project
-
-<!-- AUTOGEN:COMMAND_LIST:END -->
+<!-- {{COMMAND_LIST}} -->
 
 OUTPUT: plain markdown only (no file writes)

package/tools/cli/installers/ide/_base-ide.js

@@ -59,6 +59,20 @@ class BaseIdeSetup {
       .replace(/\bdocs\b(?!\.)/g, this.docsFolder); // Replace standalone "docs" word
   }
 
+  /**
+   * Inject dynamic content into template (agent lists, command lists)
+   * @param {string} content - Template file content
+   * @param {string} agileflowDir - AgileFlow installation directory
+   * @returns {string} Content with placeholders replaced
+   */
+  injectDynamicContent(content, agileflowDir) {
+    const { injectContent } = require('../lib/content-injector');
+    const agentsDir = path.join(agileflowDir, 'src', 'core', 'agents');
+    const commandsDir = path.join(agileflowDir, 'src', 'core', 'commands');
+
+    return injectContent(content, agentsDir, commandsDir);
+  }
+
   /**
    * Main setup method - must be implemented by subclasses
    * @param {string} projectDir - Project directory

package/tools/cli/installers/ide/claude-code.js

@@ -26,7 +26,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
    * @param {Object} options - Setup options
    */
   async setup(projectDir, agileflowDir, options = {}) {
-    console.log(chalk.cyan(`  Setting up ${this.displayName}...`));
+    console.log(chalk.hex('#C15F3C')(`  Setting up ${this.displayName}...`));
 
     // Clean up old installation first
     await this.cleanup(projectDir);
@@ -49,6 +49,9 @@ class ClaudeCodeSetup extends BaseIdeSetup {
         // Read the original command content
         let content = await this.readFile(command.path);
 
+        // Inject dynamic content (agent lists, command lists)
+        content = this.injectDynamicContent(content, agileflowDir);
+
         // Replace docs/ references with custom folder name
         content = this.replaceDocsReferences(content);
 

package/tools/cli/installers/ide/cursor.js

@@ -27,7 +27,7 @@ class CursorSetup extends BaseIdeSetup {
    * @param {Object} options - Setup options
    */
   async setup(projectDir, agileflowDir, options = {}) {
-    console.log(chalk.cyan(`  Setting up ${this.displayName}...`));
+    console.log(chalk.hex('#C15F3C')(`  Setting up ${this.displayName}...`));
 
     // Clean up old installation first
     await this.cleanup(projectDir);
@@ -50,6 +50,9 @@ class CursorSetup extends BaseIdeSetup {
         // Read the original command content
         let content = await this.readFile(command.path);
 
+        // Inject dynamic content (agent lists, command lists)
+        content = this.injectDynamicContent(content, agileflowDir);
+
         // Replace docs/ references with custom folder name
         content = this.replaceDocsReferences(content);
 

package/tools/cli/installers/ide/windsurf.js

@@ -27,7 +27,7 @@ class WindsurfSetup extends BaseIdeSetup {
    * @param {Object} options - Setup options
    */
   async setup(projectDir, agileflowDir, options = {}) {
-    console.log(chalk.cyan(`  Setting up ${this.displayName}...`));
+    console.log(chalk.hex('#C15F3C')(`  Setting up ${this.displayName}...`));
 
     // Clean up old installation first
     await this.cleanup(projectDir);
@@ -50,6 +50,9 @@ class WindsurfSetup extends BaseIdeSetup {
         // Read the original command content
         let content = await this.readFile(command.path);
 
+        // Inject dynamic content (agent lists, command lists)
+        content = this.injectDynamicContent(content, agileflowDir);
+
         // Replace docs/ references with custom folder name
         content = this.replaceDocsReferences(content);
 

package/tools/cli/lib/content-injector.js

@@ -0,0 +1,139 @@
+/**
+ * Content Injector - Dynamic content injection for command files
+ *
+ * Generates agent lists and command lists from source directories
+ * and injects them into command files during installation.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+/**
+ * Scan agents directory and generate formatted agent list
+ * @param {string} agentsDir - Path to agents directory
+ * @returns {string} Formatted agent list
+ */
+function generateAgentList(agentsDir) {
+  const files = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+  const agents = [];
+
+  for (const file of files) {
+    const filePath = path.join(agentsDir, file);
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    // Extract YAML frontmatter
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) continue;
+
+    try {
+      const frontmatter = yaml.load(match[1]);
+
+      // Handle tools field - can be array or string
+      let tools = frontmatter.tools || [];
+      if (typeof tools === 'string') {
+        tools = tools.split(',').map(t => t.trim());
+      }
+
+      agents.push({
+        name: frontmatter.name || path.basename(file, '.md'),
+        description: frontmatter.description || '',
+        tools: tools,
+        model: frontmatter.model || 'haiku'
+      });
+    } catch (err) {
+      console.warn(`Warning: Could not parse frontmatter in ${file}`);
+    }
+  }
+
+  // Sort alphabetically by name
+  agents.sort((a, b) => a.name.localeCompare(b.name));
+
+  // Generate formatted output
+  let output = `**AVAILABLE AGENTS (${agents.length} total)**:\n\n`;
+
+  agents.forEach((agent, index) => {
+    output += `${index + 1}. **${agent.name}** (model: ${agent.model})\n`;
+    output += `   - **Purpose**: ${agent.description}\n`;
+    output += `   - **Tools**: ${agent.tools.join(', ')}\n`;
+    output += `   - **Usage**: \`subagent_type: "AgileFlow:${agent.name}"\`\n`;
+    output += `\n`;
+  });
+
+  return output;
+}
+
+/**
+ * Scan commands directory and generate formatted command list
+ * @param {string} commandsDir - Path to commands directory
+ * @returns {string} Formatted command list
+ */
+function generateCommandList(commandsDir) {
+  const files = fs.readdirSync(commandsDir).filter(f => f.endsWith('.md'));
+  const commands = [];
+
+  for (const file of files) {
+    const filePath = path.join(commandsDir, file);
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    // Extract YAML frontmatter
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) continue;
+
+    try {
+      const frontmatter = yaml.load(match[1]);
+      const cmdName = path.basename(file, '.md');
+      commands.push({
+        name: cmdName,
+        description: frontmatter.description || '',
+        argumentHint: frontmatter['argument-hint'] || ''
+      });
+    } catch (err) {
+      console.warn(`Warning: Could not parse frontmatter in ${file}`);
+    }
+  }
+
+  // Sort alphabetically by name
+  commands.sort((a, b) => a.name.localeCompare(b.name));
+
+  // Generate formatted output
+  let output = `Available commands (${commands.length} total):\n`;
+
+  commands.forEach(cmd => {
+    const argHint = cmd.argumentHint ? ` ${cmd.argumentHint}` : '';
+    output += `- \`/AgileFlow:${cmd.name}${argHint}\` - ${cmd.description}\n`;
+  });
+
+  return output;
+}
+
+/**
+ * Inject dynamic content into a template file
+ * @param {string} templateContent - Template file content with placeholders
+ * @param {string} agentsDir - Path to agents directory
+ * @param {string} commandsDir - Path to commands directory
+ * @returns {string} Content with placeholders replaced
+ */
+function injectContent(templateContent, agentsDir, commandsDir) {
+  let result = templateContent;
+
+  // Replace {{AGENT_LIST}} placeholder
+  if (result.includes('{{AGENT_LIST}}')) {
+    const agentList = generateAgentList(agentsDir);
+    result = result.replace(/<!-- {{AGENT_LIST}} -->/g, agentList);
+  }
+
+  // Replace {{COMMAND_LIST}} placeholder
+  if (result.includes('{{COMMAND_LIST}}')) {
+    const commandList = generateCommandList(commandsDir);
+    result = result.replace(/<!-- {{COMMAND_LIST}} -->/g, commandList);
+  }
+
+  return result;
+}
+
+module.exports = {
+  generateAgentList,
+  generateCommandList,
+  injectContent
+};

package/tools/cli/lib/docs-setup.js

@@ -240,7 +240,7 @@ async function createDocsStructure(targetDir, docsFolder = 'docs') {
   };
 
   try {
-    console.log(chalk.cyan(`\nCreating ${docsFolder}/ structure...`));
+    console.log(chalk.hex('#C15F3C')(`\nCreating ${docsFolder}/ structure...`));
 
     // Create directories
     const directories = getDirectoryStructure(docsFolder);

package/tools/cli/lib/ui.js

@@ -18,13 +18,13 @@ const packageJson = require(packageJsonPath);
  */
 function displayLogo() {
   const logo = `
-     _         _ _      _____ _
-    / \\   __ _(_) | ___|  ___| | _____      __
-   / _ \\ / _\` | | |/ _ \\ |_  | |/ _ \\ \\ /\\ / /
-  / ___ \\ (_| | | |  __/  _| | | (_) \\ V  V /
- /_/   \\_\\__, |_|_|\\___|_|   |_|\\___/ \\_/\\_/
-         |___/                                `;
-  console.log(chalk.cyan(logo));
+ █████╗  ██████╗ ██╗██╗     ███████╗███████╗██╗      ██████╗ ██╗    ██╗
+██╔══██╗██╔════╝ ██║██║     ██╔════╝██╔════╝██║     ██╔═══██╗██║    ██║
+███████║██║  ███╗██║██║     █████╗  █████╗  ██║     ██║   ██║██║ █╗ ██║
+██╔══██║██║   ██║██║██║     ██╔══╝  ██╔══╝  ██║     ██║   ██║██║███╗██║
+██║  ██║╚██████╔╝██║███████╗███████╗██║     ███████╗╚██████╔╝╚███╔███╔╝
+╚═╝  ╚═╝ ╚═════╝ ╚═╝╚══════╝╚══════╝╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝ `;
+  console.log(chalk.hex('#C15F3C')(logo));
   console.log(chalk.dim(`  AgileFlow v${packageJson.version} - AI-Driven Agile Development\n`));
 }
 
@@ -34,7 +34,7 @@ function displayLogo() {
  * @param {string} subtitle - Optional subtitle
  */
 function displaySection(title, subtitle = null) {
-  console.log(chalk.bold.cyan(`\n${title}`));
+  console.log(chalk.bold.hex('#C15F3C')(`\n${title}`));
   if (subtitle) {
     console.log(chalk.dim(subtitle));
   }