agileflow 2.37.0 → 2.37.1

package/package.json

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

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

@@ -33,6 +33,59 @@ Set up the hooks system that enables event-driven automation in Claude Code. Hoo
 
 ## Configuration Steps
 
+### Step 0: Check and Migrate Old Format
+
+**IMPORTANT**: Before configuring, check if `.claude/settings.json` exists with old format and migrate it.
+
+The NEW hooks format uses `matcher` and `hooks` array:
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'Hello'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+The OLD format (pre-2024) used `enabled`, `command`, `description` directly - THIS IS INVALID NOW:
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "enabled": true,
+        "command": "echo 'Hello'",
+        "description": "..."
+      }
+    ]
+  }
+}
+```
+
+**Migration check**:
+```bash
+if [ -f .claude/settings.json ]; then
+  # Check for old format (has "enabled" but no "hooks" array inside)
+  if jq -e '.hooks.SessionStart[0].enabled' .claude/settings.json >/dev/null 2>&1; then
+    echo "⚠️  Old hooks format detected - migration needed"
+    # Backup
+    cp .claude/settings.json .claude/settings.json.backup
+    echo "Backed up to .claude/settings.json.backup"
+  fi
+fi
+```
+
+If old format detected, the agent should rebuild the hooks configuration from scratch using the new format.
+
 ### Step 1: Create Directories
 
 ```bash

package/src/core/agents/configuration/status-line.md

@@ -223,15 +223,45 @@ else
 fi
 ```
 
+**Check for old statusLine format** (string instead of object):
+
+The NEW format uses an object:
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bash scripts/agileflow-statusline.sh",
+    "padding": 0
+  }
+}
+```
+
+The OLD format (invalid) was just a string:
+```json
+{
+  "statusLine": "bash scripts/agileflow-statusline.sh"
+}
+```
+
+```bash
+# Check for old string format
+if [ -f .claude/settings.json ]; then
+  OLD_FORMAT=$(jq -r 'if .statusLine | type == "string" then "yes" else "no" end' .claude/settings.json 2>/dev/null)
+  if [ "$OLD_FORMAT" = "yes" ]; then
+    echo "⚠️  Old statusLine format detected (string) - will be replaced with object format"
+  fi
+fi
+```
+
 Add or update the statusLine configuration:
 
-Use `jq` to add/update the statusLine field:
+Use `jq` to add/update the statusLine field (this will replace old string format):
 
 ```bash
 # Backup existing settings
 cp .claude/settings.json .claude/settings.json.backup 2>/dev/null
 
-# Add statusLine configuration
+# Add statusLine configuration (replaces any old format)
 jq '. + {"statusLine": {"type": "command", "command": "bash scripts/agileflow-statusline.sh", "padding": 0}}' .claude/settings.json > .claude/settings.json.tmp && mv .claude/settings.json.tmp .claude/settings.json
 ```