agileflow 2.57.0 → 2.58.0

package/package.json

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

package/scripts/agileflow-configure.js

@@ -23,7 +23,7 @@
  *   --detect                            Show current status
  *   --help                              Show help
  *
- * Features: sessionstart, precompact, stop, archival, statusline
+ * Features: sessionstart, precompact, stop, archival, statusline, autoupdate
  */
 
 const fs = require('fs');
@@ -42,6 +42,7 @@ const FEATURES = {
   stop: { hook: 'Stop', script: 'agileflow-stop.sh', type: 'bash' },
   archival: { script: 'archive-completed-stories.sh', requiresHook: 'sessionstart' },
   statusline: { script: 'agileflow-statusline.sh' },
+  autoupdate: { metadataOnly: true }, // Stored in metadata.updates.autoUpdate
 };
 
 // Statusline component names
@@ -559,6 +560,21 @@ echo "[$MODEL] AgileFlow"
     success('Status line enabled');
   }
 
+  // Handle autoupdate (metadata only, no hooks needed)
+  if (feature === 'autoupdate') {
+    const frequency = options.checkFrequency || 'daily';
+    updateMetadata({
+      updates: {
+        autoUpdate: true,
+        checkFrequency: frequency,
+        showChangelog: true,
+      },
+    });
+    success(`Auto-update enabled (check frequency: ${frequency})`);
+    info('AgileFlow will automatically update on session start');
+    return true; // Skip settings.json write for this feature
+  }
+
   writeJSON('.claude/settings.json', settings);
   updateMetadata({
     features: { [feature]: { enabled: true, version: VERSION, at: new Date().toISOString() } },
@@ -607,6 +623,17 @@ function disableFeature(feature) {
     success('Status line disabled');
   }
 
+  // Disable autoupdate
+  if (feature === 'autoupdate') {
+    updateMetadata({
+      updates: {
+        autoUpdate: false,
+      },
+    });
+    success('Auto-update disabled');
+    return true; // Skip settings.json write for this feature
+  }
+
   writeJSON('.claude/settings.json', settings);
   updateMetadata({
     features: { [feature]: { enabled: false, version: VERSION, at: new Date().toISOString() } },
@@ -639,6 +666,9 @@ function updateMetadata(updates) {
       meta.features[key] = { ...meta.features[key], ...value };
     });
   }
+  if (updates.updates) {
+    meta.updates = { ...meta.updates, ...updates.updates };
+  }
 
   meta.version = VERSION;
   meta.updated = new Date().toISOString();

package/src/core/commands/configure.md

@@ -28,7 +28,7 @@ node .agileflow/scripts/agileflow-configure.js --disable=archival # Disable spec
 
 ### Features
 
-`sessionstart`, `precompact`, `stop`, `archival`, `statusline`
+`sessionstart`, `precompact`, `stop`, `archival`, `statusline`, `autoupdate`
 
 ### Critical Rules
 
@@ -178,7 +178,8 @@ Based on selection, run appropriate command.
     {"label": "PreCompact Hook", "description": "Context preservation on compact"},
     {"label": "Stop Hook", "description": "Warns about uncommitted git changes"},
     {"label": "Archival", "description": "Auto-archive old completed stories"},
-    {"label": "Status Line", "description": "Custom status bar"}
+    {"label": "Status Line", "description": "Custom status bar"},
+    {"label": "Auto-Update", "description": "Automatically update AgileFlow on session start"}
   ]
 }]</parameter>
 </invoke>
@@ -190,6 +191,29 @@ Map selections:
 - "Stop Hook" → `stop`
 - "Archival" → `archival`
 - "Status Line" → `statusline`
+- "Auto-Update" → `autoupdate`
+
+## Auto-Update Configuration
+
+Enable auto-update to automatically update AgileFlow when a new version is available:
+
+```bash
+# Enable auto-update
+node .agileflow/scripts/agileflow-configure.js --enable=autoupdate
+
+# Or manually edit docs/00-meta/agileflow-metadata.json:
+```
+
+```json
+{
+  "updates": {
+    "autoUpdate": true,
+    "checkFrequency": "daily"
+  }
+}
+```
+
+**Check frequencies:** `hourly`, `daily`, `weekly`, `never`
 
 ## Format Migration Details
 

package/tools/cli/commands/setup.js

@@ -46,7 +46,8 @@ module.exports = {
         const npmLatestVersion = await getLatestVersion('agileflow');
 
         if (npmLatestVersion && semver.lt(localCliVersion, npmLatestVersion)) {
-          displayLogo();
+          // Don't show logo here - it will be shown by promptInstall() or after self-update
+          console.log(chalk.hex('#e8683a').bold('\n  AgileFlow Update Available\n'));
           info(`Newer version available: v${localCliVersion} → v${npmLatestVersion}`);
           console.log(chalk.dim('  Fetching latest version from npm...\n'));
 
@@ -69,7 +70,10 @@ module.exports = {
       // If we self-updated, show confirmation
       if (options.selfUpdated) {
         const packageJson = require(path.join(__dirname, '..', '..', '..', 'package.json'));
-        displayLogo();
+        // Only show logo here if using -y flag (since promptInstall won't be called)
+        if (options.yes) {
+          displayLogo();
+        }
         success(`Using latest CLI v${packageJson.version}`);
         console.log();
       }

package/tools/cli/commands/update.js

@@ -39,6 +39,35 @@ module.exports = {
     try {
       const directory = path.resolve(options.directory || '.');
 
+      // Get local CLI version and npm registry version early to decide on self-update
+      const packageJson = require(path.join(__dirname, '..', '..', '..', 'package.json'));
+      const localCliVersion = packageJson.version;
+      const npmLatestVersion = await getLatestVersion('agileflow');
+
+      // Self-update check: 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) {
+        // Don't show logo - the self-updated process will show it
+        console.log(chalk.hex('#e8683a').bold('\n  AgileFlow CLI Update\n'));
+        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);
+      }
+
+      // Now show the logo (either first run without update, or after self-update)
       displayLogo();
 
       // Check for existing installation
@@ -52,13 +81,6 @@ module.exports = {
 
       displaySection('Updating AgileFlow', `Current version: ${status.version}`);
 
-      // Get local CLI version and npm registry version
-      const packageJson = require(path.join(__dirname, '..', '..', '..', 'package.json'));
-      const localCliVersion = packageJson.version;
-
-      console.log(chalk.dim('Checking npm registry for latest version...'));
-      const npmLatestVersion = await getLatestVersion('agileflow');
-
       if (!npmLatestVersion) {
         warning('Could not check npm registry for latest version');
         console.log(chalk.dim('Continuing with local CLI version...\n'));
@@ -72,28 +94,6 @@ module.exports = {
         console.log(chalk.bold('Latest (npm):'), 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}`);