agileflow 2.96.3 → 2.96.4

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.96.4] - 2026-02-06
+
+### Added
+- Command deduplication to fix duplicate slash commands in autocomplete
+
 ## [2.96.3] - 2026-02-06
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.96.3",
+  "version": "2.96.4",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

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

@@ -208,6 +208,69 @@ class BaseIdeSetup {
           }
         }
       }
+
+      // Remove duplicate command files that exist outside the agileflow/ subfolder
+      // These cause "command 2" entries in Claude Code's autocomplete
+      await this.removeDuplicateCommands(projectDir);
+    }
+  }
+
+  /**
+   * Remove duplicate AgileFlow command files from the parent commands directory.
+   * When commands exist both in .claude/commands/agileflow/foo.md AND .claude/commands/foo.md,
+   * Claude Code shows them as "foo" and "foo 2" in autocomplete. This removes the loose copies.
+   * @param {string} projectDir - Project directory
+   */
+  async removeDuplicateCommands(projectDir) {
+    const commandsDir = path.join(projectDir, this.configDir, 'commands');
+    const agileflowDir = path.join(commandsDir, 'agileflow');
+
+    if (!(await fs.pathExists(commandsDir))) return;
+
+    // Get list of AgileFlow command names (files and directories)
+    const agileflowNames = new Set();
+    if (await fs.pathExists(agileflowDir)) {
+      const entries = await fs.readdir(agileflowDir, { withFileTypes: true });
+      for (const entry of entries) {
+        agileflowNames.add(entry.name);
+      }
+    }
+
+    // Also collect names from the source commands to catch pre-existing stale copies
+    const coreCommandsDir = path.join(projectDir, this.agileflowFolder, 'commands');
+    if (await fs.pathExists(coreCommandsDir)) {
+      const entries = await fs.readdir(coreCommandsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        agileflowNames.add(entry.name);
+      }
+    }
+
+    if (agileflowNames.size === 0) return;
+
+    // Scan the parent commands directory for loose duplicates
+    let removedCount = 0;
+    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      // Skip the agileflow subfolder itself and non-agileflow items
+      if (entry.name === 'agileflow' || entry.name === 'AgileFlow') continue;
+
+      // Check if this file/directory matches an AgileFlow command name
+      if (agileflowNames.has(entry.name)) {
+        const duplicatePath = path.join(commandsDir, entry.name);
+        try {
+          await fs.remove(duplicatePath);
+          removedCount++;
+        } catch {
+          // Best effort - don't fail setup over cleanup
+        }
+      }
+    }
+
+    if (removedCount > 0) {
+      console.log(
+        chalk.dim(`  Removed ${removedCount} duplicate command(s) from ${this.displayName}`)
+      );
     }
   }
 

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

@@ -35,6 +35,11 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     const { ideDir, agileflowTargetDir } = result;
     const agentsSource = path.join(agileflowDir, 'agents');
 
+    // Claude Code specific: Check for duplicates in user-level ~/.claude/commands/
+    // Commands in both ~/.claude/commands/ and .claude/commands/agileflow/ cause
+    // "command 2" entries in autocomplete
+    await this.removeUserLevelDuplicates(agileflowDir);
+
     // Claude Code specific: Install agents as spawnable subagents (.claude/agents/agileflow/)
     // This allows Task tool to spawn them with subagent_type: "agileflow-ui"
     const spawnableAgentsDir = path.join(ideDir, 'agents', 'agileflow');
@@ -282,6 +287,71 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
     console.log(chalk.dim(`    - SessionStart hooks: welcome, archive, context-loader`));
   }
+
+  /**
+   * Remove AgileFlow command duplicates from user-level ~/.claude/commands/
+   * When the same command exists in both ~/.claude/commands/ and
+   * <project>/.claude/commands/agileflow/, Claude Code shows duplicates.
+   * @param {string} agileflowDir - AgileFlow installation directory (to get command names)
+   */
+  async removeUserLevelDuplicates(agileflowDir) {
+    const os = require('os');
+    const userCommandsDir = path.join(os.homedir(), '.claude', 'commands');
+
+    if (!(await fs.pathExists(userCommandsDir))) return;
+
+    // Collect AgileFlow command names from source
+    const agileflowNames = new Set();
+    const commandsSource = path.join(agileflowDir, 'commands');
+    const agentsSource = path.join(agileflowDir, 'agents');
+
+    for (const sourceDir of [commandsSource, agentsSource]) {
+      if (await fs.pathExists(sourceDir)) {
+        const entries = await fs.readdir(sourceDir, { withFileTypes: true });
+        for (const entry of entries) {
+          agileflowNames.add(entry.name);
+        }
+      }
+    }
+
+    if (agileflowNames.size === 0) return;
+
+    // Check for agileflow-related items in user-level commands
+    let removedCount = 0;
+    const entries = await fs.readdir(userCommandsDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      // Only remove items that match AgileFlow command names
+      if (agileflowNames.has(entry.name)) {
+        const duplicatePath = path.join(userCommandsDir, entry.name);
+        try {
+          await fs.remove(duplicatePath);
+          removedCount++;
+        } catch {
+          // Best effort - don't fail setup over cleanup
+        }
+      }
+    }
+
+    // Also remove any agileflow/ subfolder from user-level commands
+    for (const folderName of ['agileflow', 'AgileFlow']) {
+      const userAgileflowDir = path.join(userCommandsDir, folderName);
+      if (await fs.pathExists(userAgileflowDir)) {
+        try {
+          await fs.remove(userAgileflowDir);
+          removedCount++;
+        } catch {
+          // Best effort
+        }
+      }
+    }
+
+    if (removedCount > 0) {
+      console.log(
+        chalk.dim(`    - Removed ${removedCount} duplicate(s) from ~/.claude/commands/`)
+      );
+    }
+  }
 }
 
 module.exports = { ClaudeCodeSetup };