agileflow 3.4.0 → 3.4.2

package/tools/cli/commands/setup.js

@@ -89,7 +89,14 @@ module.exports = {
         config = await promptInstall();
       }
 
-      displaySection('Setting Up AgileFlow', `Target: ${config.directory}`);
+      const totalSteps = 5;
+      let currentStep = 0;
+      const step = label => {
+        currentStep++;
+        return `[${currentStep}/${totalSteps}] ${label}`;
+      };
+
+      displaySection(step('Installing Core Content'), `Target: ${config.directory}`);
 
       // Run core installation
       const coreResult = await installer.install(config);
@@ -104,17 +111,81 @@ module.exports = {
       success(`Installed ${coreResult.counts.skills} skills`);
 
       // Setup IDE configurations
-      displaySection('Configuring IDEs');
+      displaySection(step('Configuring IDEs'));
 
       ideManager.setAgileflowFolder(config.agileflowFolder);
       ideManager.setDocsFolder(config.docsFolder);
 
+      // Check for existing IDE configs before overwriting
+      if (!options.yes) {
+        const existingConfigs = [];
+        const ideConfigDirs = {
+          'claude-code': '.claude',
+          cursor: '.cursor',
+          windsurf: '.windsurf',
+        };
+
+        for (const ide of config.ides) {
+          const configDir = ideConfigDirs[ide];
+          if (configDir) {
+            const fullPath = path.join(config.directory, configDir);
+            if (fs.existsSync(fullPath)) {
+              existingConfigs.push({ ide, dir: configDir });
+            }
+          }
+        }
+
+        if (existingConfigs.length > 0) {
+          const { confirmOverwrite } = require('inquirer');
+          const configList = existingConfigs.map(c => `  ${c.dir}/`).join('\n');
+          console.log(chalk.yellow(`\n  Existing IDE configs detected:\n${configList}\n`));
+          console.log(
+            chalk.dim(
+              '  AgileFlow will add commands and hooks to these directories.\n' +
+                '  Existing settings will be merged (not replaced).\n'
+            )
+          );
+
+          let proceed = true;
+          try {
+            const inquirer = require('inquirer');
+            const answer = await inquirer.prompt([
+              {
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Continue with IDE configuration?',
+                default: true,
+              },
+            ]);
+            proceed = answer.proceed;
+          } catch {
+            // If inquirer not available or stdin not interactive, proceed
+            proceed = true;
+          }
+
+          if (!proceed) {
+            info('Skipping IDE configuration. Core installation is complete.');
+            console.log(chalk.dim('  Run setup again to configure IDEs later.\n'));
+            // Skip to docs structure
+            displaySection('Creating Documentation Structure', `Folder: ${config.docsFolder}/`);
+            const docsResult = await createDocsStructure(config.directory, config.docsFolder, {
+              updateGitignore: config.updateGitignore,
+            });
+            if (!docsResult.success) {
+              error('Failed to create docs structure');
+            }
+            console.log(chalk.green('\n✨ Setup complete (without IDE configs)!\n'));
+            return;
+          }
+        }
+      }
+
       for (const ide of config.ides) {
         await ideManager.setup(ide, config.directory, coreResult.path);
       }
 
       // Create docs structure
-      displaySection('Creating Documentation Structure', `Folder: ${config.docsFolder}/`);
+      displaySection(step('Creating Documentation Structure'), `Folder: ${config.docsFolder}/`);
       const docsResult = await createDocsStructure(config.directory, config.docsFolder, {
         updateGitignore: config.updateGitignore,
       });
@@ -127,6 +198,7 @@ module.exports = {
       }
 
       // Update metadata with config tracking
+      displaySection(step('Updating Configuration'));
       try {
         const metadataPath = path.join(
           config.directory,
@@ -149,6 +221,16 @@ module.exports = {
       }
 
       // Final summary
+      displaySection(step('Verifying Installation'));
+      const { counts } = coreResult;
+      const totalItems = (counts.commands || 0) + (counts.agents || 0) + (counts.skills || 0);
+      console.log(
+        chalk.green(
+          `  Setup complete: ${counts.commands} commands, ${counts.agents} agents, ${counts.skills} skills installed`
+        )
+      );
+      console.log(chalk.dim(`  IDEs configured: ${config.ides.join(', ')}`));
+
       console.log(chalk.green('\n✨ Setup complete!\n'));
 
       console.log(chalk.bold('Get started:'));

package/tools/cli/commands/update.js

@@ -230,6 +230,48 @@ module.exports = {
 
       console.log(chalk.green(`\n✨ Update complete! (${status.version} → ${latestVersion})\n`));
 
+      // Show changelog diff between old and new version
+      try {
+        const fs = require('node:fs');
+        const changelogPath = path.join(status.path, 'CHANGELOG.md');
+        if (fs.existsSync(changelogPath)) {
+          const changelog = fs.readFileSync(changelogPath, 'utf8');
+          const oldVer = status.version.replace(/^v/, '');
+          const newVer = latestVersion.replace(/^v/, '');
+
+          // Extract sections between old and new version headers
+          const versionPattern = /^##\s+\[?\d+\.\d+\.\d+\]?/m;
+          const lines = changelog.split('\n');
+          const relevantLines = [];
+          let capturing = false;
+
+          for (const line of lines) {
+            if (versionPattern.test(line)) {
+              if (line.includes(oldVer)) {
+                break; // Stop at old version
+              }
+              capturing = true;
+            }
+            if (capturing) {
+              relevantLines.push(line);
+            }
+          }
+
+          if (relevantLines.length > 0) {
+            const maxLines = 20;
+            const display = relevantLines.slice(0, maxLines);
+            console.log(chalk.hex('#e8683a').bold(`  What's New in v${newVer}:\n`));
+            display.forEach(l => console.log(chalk.dim(`  ${l}`)));
+            if (relevantLines.length > maxLines) {
+              console.log(chalk.dim(`  ... and ${relevantLines.length - maxLines} more lines`));
+            }
+            console.log(chalk.dim(`\n  Run /agileflow:whats-new for full changelog\n`));
+          }
+        }
+      } catch {
+        // Changelog display is non-critical
+      }
+
       // If running from outdated global installation, remind user to update it
       if (
         npmLatestVersion &&

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

@@ -64,6 +64,9 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     // Claude Code specific: Setup SessionStart hooks (welcome, archive, context-loader)
     await this.setupSessionStartHooks(projectDir, agileflowDir, ideDir, options);
 
+    // Claude Code specific: Setup PostToolUse hooks (native team observer)
+    await this.setupPostToolUseHooks(projectDir, agileflowDir, ideDir, options);
+
     return result;
   }
 
@@ -297,6 +300,71 @@ class ClaudeCodeSetup extends BaseIdeSetup {
     );
   }
 
+  /**
+   * Setup PostToolUse hooks for native Agent Teams observability.
+   * Registers native-team-observer.js for TeamCreate, SendMessage, ListTeams.
+   * @param {string} projectDir - Project directory
+   * @param {string} agileflowDir - AgileFlow installation directory
+   * @param {string} claudeDir - .claude directory path
+   * @param {Object} options - Setup options
+   */
+  async setupPostToolUseHooks(projectDir, agileflowDir, claudeDir, options = {}) {
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+
+    if (fs.existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      } catch (e) {
+        settings = {};
+      }
+    }
+
+    if (!settings.hooks) settings.hooks = {};
+    if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = [];
+
+    const observerCommand = 'node $CLAUDE_PROJECT_DIR/.agileflow/scripts/native-team-observer.js';
+
+    const postToolUseHooks = [
+      {
+        matcher: 'TeamCreate',
+        hooks: [{ type: 'command', command: observerCommand, timeout: 5000 }],
+      },
+      {
+        matcher: 'SendMessage',
+        hooks: [{ type: 'command', command: observerCommand, timeout: 5000 }],
+      },
+      {
+        matcher: 'ListTeams',
+        hooks: [{ type: 'command', command: observerCommand, timeout: 5000 }],
+      },
+    ];
+
+    // Merge with existing hooks (don't duplicate)
+    for (const newHook of postToolUseHooks) {
+      const existingIdx = settings.hooks.PostToolUse.findIndex(h => h.matcher === newHook.matcher);
+      if (existingIdx === -1) {
+        settings.hooks.PostToolUse.push(newHook);
+      } else {
+        const existing = settings.hooks.PostToolUse[existingIdx];
+        if (!existing.hooks) existing.hooks = [];
+        const hasObserver = existing.hooks.some(
+          h => h.type === 'command' && h.command && h.command.includes('native-team-observer')
+        );
+        if (!hasObserver) {
+          existing.hooks.push(newHook.hooks[0]);
+        }
+      }
+    }
+
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+    console.log(
+      chalk.dim(
+        `    - PostToolUse hooks: native team observer (TeamCreate, SendMessage, ListTeams)`
+      )
+    );
+  }
+
   /**
    * Remove AgileFlow command duplicates from user-level ~/.claude/commands/
    * When the same command exists in both ~/.claude/commands/ and