agileflow 2.82.3 → 2.82.5

package/CHANGELOG.md

@@ -0,0 +1,235 @@
+# Changelog
+
+All notable changes to AgileFlow will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [2.82.5] - 2026-01-10
+
+### Fixed
+- Fix version detection to read from config.yaml
+
+## [2.82.4] - 2026-01-10
+
+### Fixed
+- Fix whats-new command to include CHANGELOG.md in installation
+
+## [2.82.3] - 2026-01-09
+
+### Fixed
+- Copy lib directory to .agileflow for script dependencies
+
+## [2.82.2] - 2026-01-09
+
+### Fixed
+- Installer now copies lib/ directory to .agileflow/lib/ for script dependencies
+
+## [2.82.1] - 2026-01-09
+
+### Fixed
+- Fix npm package missing lib directory
+
+## [2.82.0] - 2026-01-09
+
+### Added
+- Multi-agent orchestration patterns with batch, workflow, and choose commands
+
+## [2.81.0] - 2026-01-09
+
+### Added
+- Input validation, damage control refactor, and session merge flow
+
+## [2.80.0] - 2026-01-09
+
+### Added
+- Comprehensive documentation and docs site improvements
+
+## [2.79.0] - 2026-01-09
+
+### Added
+- Damage Control protection, Visual Mode, and self-improving skills
+
+## [2.78.0] - 2026-01-08
+
+### Added
+- Enhanced compact context preservation with damage control hooks
+
+## [2.77.0] - 2026-01-01
+
+### Added
+- Vibrant 256-color palette with enhanced status line
+
+## [2.76.0] - 2026-01-01
+
+### Added
+- Ralph Loop autonomous story processing with Stop hook support
+
+## [2.75.0] - 2026-01-01
+
+### Added
+- Restructure context/research commands into subdirectories with stuck detection
+
+## [2.74.0] - 2025-12-31
+
+### Added
+- Script repair and diagnostics for /configure command
+
+## [2.73.0] - 2025-12-29
+
+### Changed
+- Consolidate scripts in .agileflow/scripts with updated hook paths
+
+## [2.72.0] - 2025-12-29
+
+### Added
+- Move scripts to .agileflow/scripts directory
+
+## [2.71.0] - 2025-12-29
+
+### Added
+- Outdated script detection with upgrade command and 30-day archival default
+
+## [2.70.0] - 2025-12-29
+
+### Fixed
+- Configure script reads version dynamically from installed package
+
+## [2.69.0] - 2025-12-29
+
+### Added
+- Fix configure script to read version dynamically instead of hardcoded
+
+## [2.68.0] - 2025-12-29
+
+### Fixed
+- Remove Stop hook, simplify docs to npx-only installation
+
+## [2.67.0] - 2025-12-29
+
+### Added
+- Simplify installation to npx-only, remove global install recommendation
+
+## [2.66.0] - 2025-12-29
+
+### Added
+- Remove unreliable Stop hook, improve global CLI messaging
+
+## [2.65.0] - 2025-12-29
+
+### Added
+- Improved outdated global CLI messaging and guidance
+
+## [2.64.0] - 2025-12-29
+
+### Changed
+- Fix version detection in welcome script for user projects
+
+## [2.63.0] - 2025-12-27
+
+### Added
+- Per-IDE options for update and uninstall commands
+
+## [2.62.0] - 2025-12-27
+
+### Added
+- Dynamic skill generation with research-driven MCP integration
+
+## [2.61.0] - 2025-12-27
+
+### Fixed
+- Fixed changelog entry formatting and version comparison links
+
+## [2.60.0] - 2025-12-27
+
+### Changed
+- Standardized changelog format with human-readable summaries
+
+## [2.59.0] - 2025-12-27
+
+### Changed
+- Automated CHANGELOG.md updates in release script
+
+## [2.58.0] - 2025-12-27
+
+### Added
+- Auto-update configuration via `/agileflow:configure --enable=autoupdate`
+
+### Fixed
+- Metadata merge for nested `updates` object in configure script
+
+## [2.57.0] - 2025-12-27
+
+### Added
+- Auto-update system with configurable check frequency
+- Update notifications in welcome message and status line
+- Changelog display after updates showing what's new
+- `/agileflow:whats-new` command for viewing full changelog
+
+## [2.56.0] - 2025-12-27
+
+### Added
+- Dynamic IDE discovery with auto-detection from handlers
+- OpenAI Codex CLI now appears in setup IDE selection
+
+### Changed
+- Replaced hardcoded IDE list with dynamic loading from IdeManager
+
+## [2.55.0] - 2025-12-26
+
+### Changed
+- Consolidated code improvements and debugging enhancements
+
+## [2.54.0] - 2025-12-26
+
+### Added
+- Test suites for generators, npm-utils, and version-checker
+
+## [2.53.0] - 2025-12-25
+
+### Added
+- Session manager for parallel session detection
+- Warning when multiple Claude sessions active
+
+## [2.52.0] - 2025-12-24
+
+### Added
+- PreCompact hook for context preservation during compacts
+
+## [2.51.0] - 2025-12-23
+
+### Added
+- OpenAI Codex CLI integration
+
+## [2.50.0] - 2025-12-22
+
+### Added
+- Windsurf and Cursor IDE support
+
+## [2.45.0] - 2025-12-20
+
+### Added
+- Auto-archival system for completed stories
+
+## [2.40.0] - 2025-12-18
+
+### Added
+- Hooks system for event-driven automation
+- Status line integration for Claude Code
+
+[Unreleased]: https://github.com/projectquestorg/AgileFlow/compare/v2.60.0...HEAD
+[2.60.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.59.0...v2.60.0
+[2.59.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.58.0...v2.59.0
+[2.58.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.57.0...v2.58.0
+[2.57.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.56.0...v2.57.0
+[2.56.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.55.0...v2.56.0
+[2.55.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.54.0...v2.55.0
+[2.54.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.53.0...v2.54.0
+[2.53.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.52.0...v2.53.0
+[2.52.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.51.0...v2.52.0
+[2.51.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.50.0...v2.51.0
+[2.50.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.45.0...v2.50.0
+[2.45.0]: https://github.com/projectquestorg/AgileFlow/compare/v2.40.0...v2.45.0
+[2.40.0]: https://github.com/projectquestorg/AgileFlow/releases/tag/v2.40.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.82.3",
+  "version": "2.82.5",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",
@@ -34,7 +34,8 @@
     "scripts/",
     "lib/",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "postinstall": "node tools/postinstall.js",

package/scripts/agileflow-welcome.js

@@ -46,29 +46,34 @@ function getProjectInfo(rootDir) {
   };
 
   // Get AgileFlow version (check multiple sources in priority order)
-  // 1. AgileFlow metadata (installed user projects)
-  // 2. packages/cli/package.json (AgileFlow dev project)
-  // 3. .agileflow/package.json (fallback)
+  // 1. .agileflow/config.yaml (installed user projects - primary source)
+  // 2. AgileFlow metadata (installed user projects - legacy)
+  // 3. packages/cli/package.json (AgileFlow dev project)
   try {
-    const metadataPath = path.join(rootDir, 'docs/00-meta/agileflow-metadata.json');
-    if (fs.existsSync(metadataPath)) {
-      const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-      info.version = metadata.version || info.version;
+    // Primary: .agileflow/config.yaml
+    const configPath = path.join(rootDir, '.agileflow', 'config.yaml');
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, 'utf8');
+      const versionMatch = content.match(/^version:\s*['"]?([0-9.]+)/m);
+      if (versionMatch) {
+        info.version = versionMatch[1];
+      }
     } else {
-      // Dev project: check packages/cli/package.json
-      const pkg = JSON.parse(
-        fs.readFileSync(path.join(rootDir, 'packages/cli/package.json'), 'utf8')
-      );
-      info.version = pkg.version || info.version;
+      // Fallback: metadata or dev project
+      const metadataPath = path.join(rootDir, 'docs/00-meta/agileflow-metadata.json');
+      if (fs.existsSync(metadataPath)) {
+        const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
+        info.version = metadata.version || info.version;
+      } else {
+        // Dev project: check packages/cli/package.json
+        const pkg = JSON.parse(
+          fs.readFileSync(path.join(rootDir, 'packages/cli/package.json'), 'utf8')
+        );
+        info.version = pkg.version || info.version;
+      }
     }
   } catch (e) {
-    // Fallback: check .agileflow/package.json
-    try {
-      const pkg = JSON.parse(
-        fs.readFileSync(path.join(rootDir, '.agileflow/package.json'), 'utf8')
-      );
-      info.version = pkg.version || info.version;
-    } catch (e2) {}
+    // Silently fail - version will remain 'unknown'
   }
 
   // Get git info

package/scripts/check-update.js

@@ -39,14 +39,18 @@ function debugLog(message, data = null) {
 
 // Get installed AgileFlow version
 function getInstalledVersion(rootDir) {
-  // First check .agileflow/package.json (installed version)
-  const agileflowPkg = path.join(rootDir, '.agileflow', 'package.json');
-  const agileflowResult = safeReadJSON(agileflowPkg);
-  if (agileflowResult.ok && agileflowResult.data?.version) {
-    return agileflowResult.data.version;
-  }
-  if (!agileflowResult.ok && agileflowResult.error) {
-    debugLog('Error reading .agileflow/package.json', agileflowResult.error);
+  // First check .agileflow/config.yaml (installed version)
+  try {
+    const configPath = path.join(rootDir, '.agileflow', 'config.yaml');
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, 'utf8');
+      const versionMatch = content.match(/^version:\s*['"]?([0-9.]+)/m);
+      if (versionMatch) {
+        return versionMatch[1];
+      }
+    }
+  } catch (err) {
+    debugLog('Error reading .agileflow/config.yaml', err.message);
   }
 
   // Fallback: check if this is the AgileFlow dev repo

package/src/core/commands/whats-new.md

@@ -50,9 +50,9 @@ Read the AgileFlow CHANGELOG.md:
 cat .agileflow/CHANGELOG.md 2>/dev/null || echo "Changelog not found"
 ```
 
-Also check the installed version:
+Also check the installed version from config.yaml:
 ```bash
-cat .agileflow/package.json 2>/dev/null | grep '"version"' || echo "Version unknown"
+cat .agileflow/config.yaml 2>/dev/null | grep 'version:' | head -1 || echo "Version unknown"
 ```
 
 **STEP 2: Parse and display**

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

@@ -153,6 +153,10 @@ class Installer {
       spinner.text = 'Installing shared libraries...';
       await this.installLib(directory, { force: effectiveForce });
 
+      // Copy CHANGELOG.md for /agileflow:whats-new command
+      spinner.text = 'Installing changelog...';
+      await this.installChangelog(agileflowDir, { force: effectiveForce });
+
       // Create config.yaml
       spinner.text = 'Creating configuration...';
       await this.createConfig(agileflowDir, userName, agileflowFolder, { force: effectiveForce });
@@ -599,6 +603,38 @@ class Installer {
     return counts;
   }
 
+  /**
+   * Copy CHANGELOG.md to .agileflow/ for /agileflow:whats-new command
+   * @param {string} agileflowDir - AgileFlow installation directory
+   * @param {Object} options - Installation options
+   * @param {boolean} options.force - Overwrite existing file
+   */
+  async installChangelog(agileflowDir, options = {}) {
+    const { force = false } = options;
+    const changelogSource = path.join(this.packageRoot, 'CHANGELOG.md');
+    const changelogDest = path.join(agileflowDir, 'CHANGELOG.md');
+
+    // Skip if source changelog doesn't exist
+    if (!(await fs.pathExists(changelogSource))) {
+      return;
+    }
+
+    const destExists = await fs.pathExists(changelogDest);
+
+    // If destination exists and not forcing, check if identical
+    if (destExists && !force) {
+      const srcContent = await fs.readFile(changelogSource, 'utf8');
+      const destContent = await fs.readFile(changelogDest, 'utf8');
+      if (srcContent === destContent) {
+        return; // Identical, skip
+      }
+      // Different content - always update changelog since it's managed by package
+    }
+
+    // Copy the changelog
+    await fs.copy(changelogSource, changelogDest);
+  }
+
   /**
    * Install all scripts from packages/cli/scripts/ to .agileflow/scripts/
    * Copies everything automatically - no manual list to maintain