agileflow 2.51.0 → 2.56.0

package/tools/cli/commands/update.js

@@ -2,14 +2,24 @@
  * AgileFlow CLI - Update Command
  *
  * Updates an existing AgileFlow installation.
+ * Includes self-update capability to always use the latest CLI.
  */
 
 const chalk = require('chalk');
 const path = require('node:path');
+const { spawnSync } = require('node:child_process');
 const semver = require('semver');
 const { Installer } = require('../installers/core/installer');
 const { IdeManager } = require('../installers/ide/manager');
-const { displayLogo, displaySection, success, warning, error, info, confirm } = require('../lib/ui');
+const {
+  displayLogo,
+  displaySection,
+  success,
+  warning,
+  error,
+  info,
+  confirm,
+} = require('../lib/ui');
 const { createDocsStructure, getDocsFolderName } = require('../lib/docs-setup');
 const { getLatestVersion } = require('../lib/npm-utils');
 
@@ -22,8 +32,10 @@ module.exports = {
   options: [
     ['-d, --directory <path>', 'Project directory (default: current directory)'],
     ['--force', 'Force reinstall (skip prompts; overwrites local changes)'],
+    ['--no-self-update', 'Skip automatic CLI self-update check'],
+    ['--self-updated', 'Internal flag: indicates CLI was already self-updated'],
   ],
-  action: async (options) => {
+  action: async options => {
     try {
       const directory = path.resolve(options.directory || '.');
 
@@ -60,14 +72,44 @@ module.exports = {
         console.log(chalk.bold('Latest (npm):'), npmLatestVersion);
       }
 
-      // Check if CLI itself is outdated
-      if (npmLatestVersion && semver.lt(localCliVersion, npmLatestVersion)) {
+      // Self-update: if CLI is outdated and we haven't already self-updated, re-run with latest
+      const shouldSelfUpdate = options.selfUpdate !== false && !options.selfUpdated;
+      if (npmLatestVersion && semver.lt(localCliVersion, npmLatestVersion) && shouldSelfUpdate) {
+        console.log();
+        info(`Updating CLI from v${localCliVersion} to v${npmLatestVersion}...`);
+        console.log(chalk.dim('  Fetching latest version from npm...\n'));
+
+        // Build the command with all current options forwarded
+        const args = ['agileflow@latest', 'update', '--self-updated'];
+        if (options.directory) args.push('-d', options.directory);
+        if (options.force) args.push('--force');
+
+        const result = spawnSync('npx', args, {
+          stdio: 'inherit',
+          cwd: process.cwd(),
+          shell: process.platform === 'win32',
+        });
+
+        // Exit with the same code as the spawned process
+        process.exit(result.status ?? 0);
+      }
+
+      // If we self-updated, show confirmation
+      if (options.selfUpdated) {
+        success(`CLI updated to v${localCliVersion}`);
+        console.log();
+      }
+
+      // Check if CLI itself is still outdated (only if self-update was disabled)
+      if (npmLatestVersion && semver.lt(localCliVersion, npmLatestVersion) && !shouldSelfUpdate) {
         console.log();
         warning('Your CLI is outdated!');
         console.log(chalk.dim(`  To update your installation, run:\n`));
         console.log(chalk.cyan(`  npx agileflow@latest update\n`));
 
-        const useOutdated = options.force ? true : await confirm('Continue with outdated CLI anyway?');
+        const useOutdated = options.force
+          ? true
+          : await confirm('Continue with outdated CLI anyway?');
         if (!useOutdated) {
           console.log(chalk.dim('\nUpdate cancelled\n'));
           process.exit(0);
@@ -137,12 +179,14 @@ module.exports = {
 
       // Create/update docs structure (idempotent - only creates missing files)
       displaySection('Updating Documentation Structure', `Folder: ${config.docsFolder}/`);
-      const docsResult = await createDocsStructure(directory, config.docsFolder, { updateGitignore: false });
+      const docsResult = await createDocsStructure(directory, config.docsFolder, {
+        updateGitignore: false,
+      });
 
       if (!docsResult.success) {
         warning('Failed to update docs structure');
         if (docsResult.errors.length > 0) {
-          docsResult.errors.forEach((err) => error(`  ${err}`));
+          docsResult.errors.forEach(err => error(`  ${err}`));
         }
       }
 

package/tools/cli/installers/core/installer.js

@@ -161,7 +161,11 @@ class Installer {
 
       // Create manifest
       spinner.text = 'Creating manifest...';
-      await this.createManifest(cfgDir, { ides, userName, agileflowFolder, docsFolder }, { force: effectiveForce });
+      await this.createManifest(
+        cfgDir,
+        { ides, userName, agileflowFolder, docsFolder },
+        { force: effectiveForce }
+      );
 
       // Persist file index (used for safe future updates)
       spinner.text = 'Writing file index...';
@@ -578,21 +582,21 @@ class Installer {
     const agentsDir = path.join(agileflowDir, 'agents');
     if (await fs.pathExists(agentsDir)) {
       const files = await fs.readdir(agentsDir);
-      counts.agents = files.filter((f) => f.endsWith('.md')).length;
+      counts.agents = files.filter(f => f.endsWith('.md')).length;
     }
 
     // Count commands
     const commandsDir = path.join(agileflowDir, 'commands');
     if (await fs.pathExists(commandsDir)) {
       const files = await fs.readdir(commandsDir);
-      counts.commands = files.filter((f) => f.endsWith('.md')).length;
+      counts.commands = files.filter(f => f.endsWith('.md')).length;
     }
 
     // Count skills
     const skillsDir = path.join(agileflowDir, 'skills');
     if (await fs.pathExists(skillsDir)) {
       const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-      counts.skills = entries.filter((e) => e.isDirectory()).length;
+      counts.skills = entries.filter(e => e.isDirectory()).length;
     }
 
     return counts;

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

@@ -96,7 +96,9 @@ class BaseIdeSetup {
         const agileflowPath = path.join(projectDir, this.configDir, 'commands', folderName);
         if (await fs.pathExists(agileflowPath)) {
           await fs.remove(agileflowPath);
-          console.log(chalk.dim(`  Removed old ${folderName} configuration from ${this.displayName}`));
+          console.log(
+            chalk.dim(`  Removed old ${folderName} configuration from ${this.displayName}`)
+          );
         }
       }
     }
@@ -177,6 +179,61 @@ class BaseIdeSetup {
 
     return results;
   }
+
+  /**
+   * Recursively install markdown files from source to target directory
+   * Handles content injection and docs reference replacement.
+   * @param {string} sourceDir - Source directory path
+   * @param {string} targetDir - Target directory path
+   * @param {string} agileflowDir - AgileFlow installation directory (for dynamic content)
+   * @param {boolean} injectDynamic - Whether to inject dynamic content (only for top-level commands)
+   * @returns {Promise<{commands: number, subdirs: number}>} Count of installed items
+   */
+  async installCommandsRecursive(sourceDir, targetDir, agileflowDir, injectDynamic = false) {
+    let commandCount = 0;
+    let subdirCount = 0;
+
+    if (!(await this.exists(sourceDir))) {
+      return { commands: 0, subdirs: 0 };
+    }
+
+    await this.ensureDir(targetDir);
+
+    const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const sourcePath = path.join(sourceDir, entry.name);
+      const targetPath = path.join(targetDir, entry.name);
+
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        // Read and process .md file
+        let content = await this.readFile(sourcePath);
+
+        // Inject dynamic content if enabled (for top-level commands)
+        if (injectDynamic) {
+          content = this.injectDynamicContent(content, agileflowDir);
+        }
+
+        // Replace docs/ references with custom folder name
+        content = this.replaceDocsReferences(content);
+
+        await this.writeFile(targetPath, content);
+        commandCount++;
+      } else if (entry.isDirectory()) {
+        // Recursively process subdirectory
+        const subResult = await this.installCommandsRecursive(
+          sourcePath,
+          targetPath,
+          agileflowDir,
+          false // Don't inject dynamic content in subdirectories
+        );
+        commandCount += subResult.commands;
+        subdirCount += 1 + subResult.subdirs;
+      }
+    }
+
+    return { commands: commandCount, subdirs: subdirCount };
+  }
 }
 
 module.exports = { BaseIdeSetup };

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

@@ -19,60 +19,6 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     this.commandsDir = 'commands';
   }
 
-  /**
-   * Recursively install commands from a source directory
-   * @param {string} sourceDir - Source directory path
-   * @param {string} targetDir - Target directory path
-   * @param {string} agileflowDir - AgileFlow installation directory (for dynamic content)
-   * @param {boolean} injectDynamic - Whether to inject dynamic content (only for top-level commands)
-   * @returns {Promise<{commands: number, subdirs: number}>} Count of installed items
-   */
-  async installCommandsRecursive(sourceDir, targetDir, agileflowDir, injectDynamic = false) {
-    let commandCount = 0;
-    let subdirCount = 0;
-
-    if (!(await this.exists(sourceDir))) {
-      return { commands: 0, subdirs: 0 };
-    }
-
-    await this.ensureDir(targetDir);
-
-    const entries = await fs.readdir(sourceDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const sourcePath = path.join(sourceDir, entry.name);
-      const targetPath = path.join(targetDir, entry.name);
-
-      if (entry.isFile() && entry.name.endsWith('.md')) {
-        // Read and process .md file
-        let content = await this.readFile(sourcePath);
-
-        // Inject dynamic content if enabled (for top-level commands)
-        if (injectDynamic) {
-          content = this.injectDynamicContent(content, agileflowDir);
-        }
-
-        // Replace docs/ references with custom folder name
-        content = this.replaceDocsReferences(content);
-
-        await this.writeFile(targetPath, content);
-        commandCount++;
-      } else if (entry.isDirectory()) {
-        // Recursively process subdirectory
-        const subResult = await this.installCommandsRecursive(
-          sourcePath,
-          targetPath,
-          agileflowDir,
-          false // Don't inject dynamic content in subdirectories
-        );
-        commandCount += subResult.commands;
-        subdirCount += 1 + subResult.subdirs;
-      }
-    }
-
-    return { commands: commandCount, subdirs: subdirCount };
-  }
-
   /**
    * Setup Claude Code IDE configuration
    * @param {string} projectDir - Project directory
@@ -114,12 +60,7 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     // ALSO install agents as spawnable subagents (.claude/agents/agileflow/)
     // This allows Task tool to spawn them with subagent_type: "agileflow-ui"
     const spawnableAgentsDir = path.join(claudeDir, 'agents', 'agileflow');
-    await this.installCommandsRecursive(
-      agentsSource,
-      spawnableAgentsDir,
-      agileflowDir,
-      false
-    );
+    await this.installCommandsRecursive(agentsSource, spawnableAgentsDir, agileflowDir, false);
     console.log(chalk.dim(`    - Spawnable agents: .claude/agents/agileflow/`));
 
     // Install skills (.claude/skills/)
@@ -140,7 +81,8 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     }
 
     const totalCommands = commandResult.commands + agentResult.commands;
-    const totalSubdirs = commandResult.subdirs + (agentResult.commands > 0 ? 1 : 0) + agentResult.subdirs;
+    const totalSubdirs =
+      commandResult.subdirs + (agentResult.commands > 0 ? 1 : 0) + agentResult.subdirs;
 
     console.log(chalk.green(`  ✓ ${this.displayName} configured:`));
     console.log(chalk.dim(`    - ${totalCommands} commands installed`));