agileflow 2.72.0 → 2.74.0

package/src/core/agents/configuration/archival.md

@@ -36,9 +36,9 @@ ROLE: Auto-Archival Configurator
   "header": "Threshold",
   "multiSelect": false,
   "options": [
-    {"label": "7 days (Recommended)", "description": "Archive after 1 week"},
+    {"label": "30 days (Recommended)", "description": "Archive after 1 month"},
     {"label": "14 days", "description": "Archive after 2 weeks"},
-    {"label": "30 days", "description": "Archive after 1 month"}
+    {"label": "7 days", "description": "Archive after 1 week"}
   ]
 }]</parameter>
 </invoke>
@@ -71,20 +71,20 @@ Use AskUserQuestion tool to get user preference:
   "multiSelect": false,
   "options": [
     {
-      "label": "3 days",
-      "description": "Very aggressive - keeps status.json very small (best for large teams)"
+      "label": "30 days (Recommended)",
+      "description": "Monthly archival - default, keeps recent context visible"
     },
     {
-      "label": "7 days",
-      "description": "Weekly archival - recommended for fast-moving teams"
+      "label": "14 days",
+      "description": "Bi-weekly archival - good balance for fast-moving projects"
     },
     {
-      "label": "14 days",
-      "description": "Bi-weekly archival - good balance for most projects"
+      "label": "7 days",
+      "description": "Weekly archival - for large teams with many stories"
     },
     {
-      "label": "30 days",
-      "description": "Monthly archival - default, keeps recent context visible"
+      "label": "3 days",
+      "description": "Very aggressive - keeps status.json very small"
     }
   ]
 }]</parameter>

package/src/core/commands/configure.md

@@ -1,38 +1,47 @@
 ---
 description: Configure advanced AgileFlow features (git, hooks, archival, CI, status line)
-argument-hint: [--profile=full|basic|minimal|none] [--enable/--disable=features] [--migrate]
+argument-hint: [--profile=full|basic|minimal|none] [--enable/--disable=features] [--migrate] [--upgrade] [--repair] [--version] [--list-scripts]
 ---
 
 <!-- COMPACT_SUMMARY_START -->
 
 ## Compact Summary
 
-Configuration management with **profiles**, **enable/disable**, and **format migration**.
+Configuration management with **profiles**, **enable/disable**, **format migration**, and **upgrade detection**.
 
 ### Workflow (MUST FOLLOW)
 
 1. **Run detection**: `node .agileflow/scripts/agileflow-configure.js --detect`
 2. **If ⚠️ INVALID FORMAT shown**: Ask user to fix with `--migrate` BEFORE anything else
-3. **Present options**: Profiles, enable/disable, or check status
+3. **If 🔄 OUTDATED shown**: Ask user to upgrade with `--upgrade`
+4. **Present options**: Profiles, enable/disable, or check status
 
 ### Quick Commands
 
 ```bash
-node .agileflow/scripts/agileflow-configure.js --detect           # Check status
-node .agileflow/scripts/agileflow-configure.js --migrate          # Fix format issues
-node .agileflow/scripts/agileflow-configure.js --profile=full     # Enable all
-node .agileflow/scripts/agileflow-configure.js --profile=none     # Disable all
-node .agileflow/scripts/agileflow-configure.js --enable=stop      # Enable specific
-node .agileflow/scripts/agileflow-configure.js --disable=archival # Disable specific
+node .agileflow/scripts/agileflow-configure.js --detect             # Check status
+node .agileflow/scripts/agileflow-configure.js --migrate            # Fix format issues
+node .agileflow/scripts/agileflow-configure.js --upgrade            # Update outdated scripts
+node .agileflow/scripts/agileflow-configure.js --profile=full       # Enable all
+node .agileflow/scripts/agileflow-configure.js --profile=none       # Disable all
+node .agileflow/scripts/agileflow-configure.js --enable=sessionstart  # Enable specific
+node .agileflow/scripts/agileflow-configure.js --disable=archival   # Disable specific
+node .agileflow/scripts/agileflow-configure.js --list-scripts       # Show all scripts status
+node .agileflow/scripts/agileflow-configure.js --version            # Version info
+node .agileflow/scripts/agileflow-configure.js --repair             # Fix missing scripts
+node .agileflow/scripts/agileflow-configure.js --repair=statusline  # Fix specific feature
 ```
 
+**Note:** All scripts are located in `.agileflow/scripts/` - no files in project root `scripts/`.
+
 ### Features
 
-`sessionstart`, `precompact`, `stop`, `archival`, `statusline`, `autoupdate`
+`sessionstart`, `precompact`, `archival`, `statusline`, `autoupdate`
 
 ### Critical Rules
 
 - **Check for format issues FIRST** - offer to fix before other options
+- **Check for outdated scripts** - offer to upgrade if versions differ
 - **Backup created** on migrate: `.claude/settings.json.backup`
 - **Restart required** - always show red banner after changes
 
@@ -54,10 +63,9 @@ node .agileflow/scripts/agileflow-configure.js --detect
 
 **CRITICAL**: Check the output for format issues (⚠️ INVALID FORMAT).
 
-## STEP 2: If Format Issues Detected → Offer Migration FIRST
-
-If you see `⚠️ INVALID FORMAT` in the detection output, **immediately ask user about fixing**:
+## STEP 2: Handle Issues (Migration or Upgrade)
 
+### If ⚠️ INVALID FORMAT detected → Offer Migration
 ```xml
 <invoke name="AskUserQuestion">
 <parameter name="questions">[{
@@ -77,6 +85,26 @@ If user says yes:
 node .agileflow/scripts/agileflow-configure.js --migrate
 ```
 
+### If 🔄 OUTDATED detected → Offer Upgrade
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Outdated scripts detected! Your features were configured with an older AgileFlow version. Update them?",
+  "header": "Upgrade",
+  "multiSelect": false,
+  "options": [
+    {"label": "Yes, upgrade scripts (Recommended)", "description": "Re-deploy all enabled features with latest scripts."},
+    {"label": "No, keep current versions", "description": "Continue with older scripts (may miss bug fixes)."}
+  ]
+}]</parameter>
+</invoke>
+```
+
+If user says yes:
+```bash
+node .agileflow/scripts/agileflow-configure.js --upgrade
+```
+
 ## STEP 3: Configuration Options
 
 After fixing issues (or if no issues), present main options:
@@ -120,13 +148,13 @@ node .agileflow/scripts/agileflow-configure.js --profile=none
 
 ```bash
 # Enable features
-node .agileflow/scripts/agileflow-configure.js --enable=sessionstart,precompact,stop
+node .agileflow/scripts/agileflow-configure.js --enable=sessionstart,precompact
 
 # Disable features
 node .agileflow/scripts/agileflow-configure.js --disable=statusline
 
 # Both at once
-node .agileflow/scripts/agileflow-configure.js --enable=stop --disable=archival
+node .agileflow/scripts/agileflow-configure.js --enable=statusline --disable=archival
 
 # With custom archival days
 node .agileflow/scripts/agileflow-configure.js --enable=archival --archival-days=14
@@ -134,12 +162,12 @@ node .agileflow/scripts/agileflow-configure.js --enable=archival --archival-days
 
 ## Profile Details
 
-| Profile | SessionStart | PreCompact | Stop | Archival | StatusLine |
-|---------|-------------|------------|------|----------|------------|
-| `full` | ✅ | ✅ | ✅ | ✅ 7 days | ✅ |
-| `basic` | ✅ | ✅ | ❌ | ✅ 7 days | ❌ |
-| `minimal` | ✅ | ❌ | ❌ | ✅ 7 days | ❌ |
-| `none` | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Profile | SessionStart | PreCompact | Archival | StatusLine |
+|---------|-------------|------------|----------|------------|
+| `full` | ✅ | ✅ | ✅ 30 days | ✅ |
+| `basic` | ✅ | ✅ | ✅ 30 days | ❌ |
+| `minimal` | ✅ | ❌ | ✅ 30 days | ❌ |
+| `none` | ❌ | ❌ | ❌ | ❌ |
 
 ## Interactive Mode (via /configure command)
 
@@ -176,7 +204,6 @@ Based on selection, run appropriate command.
   "options": [
     {"label": "SessionStart Hook", "description": "Welcome display with project status"},
     {"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": "Auto-Update", "description": "Automatically update AgileFlow on session start"}
@@ -188,7 +215,6 @@ Based on selection, run appropriate command.
 Map selections:
 - "SessionStart Hook" → `sessionstart`
 - "PreCompact Hook" → `precompact`
-- "Stop Hook" → `stop`
 - "Archival" → `archival`
 - "Status Line" → `statusline`
 - "Auto-Update" → `autoupdate`
@@ -243,18 +269,17 @@ The script updates `docs/00-meta/agileflow-metadata.json`:
 
 ```json
 {
-  "version": "2.41.0",
-  "updated": "2025-12-22T...",
+  "version": "2.71.0",
+  "updated": "2025-12-29T...",
   "archival": {
     "enabled": true,
     "threshold_days": 7
   },
   "features": {
-    "sessionstart": {"enabled": true, "version": "2.41.0", "at": "..."},
-    "precompact": {"enabled": true, "version": "2.41.0", "at": "..."},
-    "stop": {"enabled": true, "version": "2.41.0", "at": "..."},
-    "archival": {"enabled": true, "version": "2.41.0", "at": "..."},
-    "statusline": {"enabled": true, "version": "2.41.0", "at": "..."}
+    "sessionstart": {"enabled": true, "version": "2.71.0", "at": "..."},
+    "precompact": {"enabled": true, "version": "2.71.0", "at": "..."},
+    "archival": {"enabled": true, "version": "2.71.0", "at": "..."},
+    "statusline": {"enabled": true, "version": "2.71.0", "at": "..."}
   }
 }
 ```
@@ -296,10 +321,9 @@ After configuration:
 Enabled:
   ✅ sessionstart
   ✅ precompact
-  ✅ stop
+  ✅ archival
 
 Disabled:
-  ❌ archival
   ❌ statusline
 
 ═══════════════════════════════════════════════════════
@@ -307,3 +331,102 @@ Disabled:
    Quit completely, wait 5 seconds, restart
 ═══════════════════════════════════════════════════════
 ```
+
+After upgrade:
+
+```
+🔄 Upgrading Outdated Features...
+
+Upgrading sessionstart...
+✅ Deployed agileflow-welcome.js
+✅ SessionStart hook enabled
+
+Upgrading precompact...
+✅ Deployed precompact-context.sh
+✅ PreCompact hook enabled
+
+✅ Upgraded 2 feature(s) to v2.71.0
+```
+
+## Repair & Diagnostics
+
+When scripts are accidentally deleted or corrupted, use these commands:
+
+### List Scripts Status
+
+```bash
+node .agileflow/scripts/agileflow-configure.js --list-scripts
+```
+
+Shows all scripts with their status (present/missing/modified):
+
+```
+📋 Installed Scripts
+  ✅ agileflow-welcome.js: present
+  ✅ precompact-context.sh: present
+  ❌ agileflow-statusline.sh: MISSING
+     └─ Feature: statusline
+  ⚠️  obtain-context.js: modified (local changes)
+
+Summary: 15 present, 1 modified, 1 missing
+
+💡 Run with --repair to restore missing scripts
+```
+
+### Show Version Info
+
+```bash
+node .agileflow/scripts/agileflow-configure.js --version
+```
+
+Shows installed vs latest versions:
+
+```
+📊 Version Information
+Installed:  v2.71.0
+CLI:        v2.73.0
+Latest:     v2.73.0
+
+🔄 Update available! Run: npx agileflow update
+
+Feature Versions:
+  ✅ sessionstart: v2.73.0
+  🔄 precompact: v2.68.0 → v2.73.0
+  ✅ archival: v2.73.0
+  ❌ statusline: disabled
+```
+
+### Repair Missing Scripts
+
+```bash
+# Repair all missing scripts
+node .agileflow/scripts/agileflow-configure.js --repair
+
+# Repair scripts for a specific feature only
+node .agileflow/scripts/agileflow-configure.js --repair=statusline
+```
+
+Output:
+
+```
+🔧 Repairing Scripts...
+✅ Restored agileflow-statusline.sh
+
+Repaired: 1, Errors: 0, Skipped: 18
+
+═══════════════════════════════════════════════════════
+🔴 RESTART CLAUDE CODE NOW!
+   Quit completely, wait 5 seconds, restart
+═══════════════════════════════════════════════════════
+```
+
+### When to Use Each Command
+
+| Scenario | Command |
+|----------|---------|
+| Accidentally deleted a script | `--repair` |
+| Want to see what's installed | `--list-scripts` |
+| Check if update is available | `--version` |
+| Scripts outdated (feature version differs) | `--upgrade` |
+| Settings format broken | `--migrate` |
+| Major corruption/reinstall needed | `npx agileflow update --force`

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

@@ -46,11 +46,11 @@ class Installer {
 
   /**
    * Clean up existing content directories before installing.
-   * Removes agents/, commands/, skills/, templates/ but preserves _cfg/ and config.yaml.
+   * Removes agents/, commands/, skills/, scripts/, templates/ but preserves _cfg/ and config.yaml.
    * @param {string} agileflowDir - AgileFlow installation directory
    */
   async cleanup(agileflowDir) {
-    const dirsToRemove = ['agents', 'commands', 'skills', 'templates'];
+    const dirsToRemove = ['agents', 'commands', 'skills', 'scripts', 'templates'];
 
     for (const dir of dirsToRemove) {
       const dirPath = path.join(agileflowDir, dir);
@@ -243,14 +243,6 @@ class Installer {
       await fs.ensureDir(skillsDest);
       await this.copyContent(skillsSource, skillsDest, agileflowFolder, policy);
     }
-
-    // Copy templates
-    const templatesSource = path.join(packageRoot, 'templates');
-    const templatesDest = path.join(agileflowDir, 'templates');
-    if (await fs.pathExists(templatesSource)) {
-      await fs.ensureDir(templatesDest);
-      await this.copyContent(templatesSource, templatesDest, agileflowFolder, policy);
-    }
   }
 
   /**
@@ -430,7 +422,7 @@ class Installer {
     const backupRoot = path.join(cfgDir, 'backups', timestamp);
     await fs.ensureDir(backupRoot);
 
-    const candidates = ['agents', 'commands', 'skills', 'templates', 'config.yaml'];
+    const candidates = ['agents', 'commands', 'skills', 'scripts', 'templates', 'config.yaml'];
     for (const name of candidates) {
       const srcPath = path.join(agileflowDir, name);
       if (await fs.pathExists(srcPath)) {