agileflow 2.43.0 → 2.45.0

package/scripts/agileflow-statusline.sh

@@ -0,0 +1,355 @@
+#!/bin/bash
+# AgileFlow Status Line for Claude Code
+# Displays contextual information from status.json and session data
+#
+# This script is called by Claude Code and receives JSON via stdin.
+# Customize this script to change what's displayed in your status line.
+#
+# Available data from stdin JSON:
+#   .model.display_name          - Model name (Opus, Sonnet, etc.)
+#   .cost.total_cost_usd         - Session cost in USD
+#   .context_window.context_window_size - Total context window size
+#   .context_window.current_usage.input_tokens - Current input tokens
+#   .workspace.current_dir       - Current working directory
+
+# ============================================================================
+# ANSI Color Codes
+# ============================================================================
+RESET="\033[0m"
+BOLD="\033[1m"
+DIM="\033[2m"
+
+# Foreground colors
+BLACK="\033[30m"
+RED="\033[31m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+BLUE="\033[34m"
+MAGENTA="\033[35m"
+CYAN="\033[36m"
+WHITE="\033[37m"
+
+# Bright foreground colors
+BRIGHT_RED="\033[91m"
+BRIGHT_GREEN="\033[92m"
+BRIGHT_YELLOW="\033[93m"
+BRIGHT_BLUE="\033[94m"
+BRIGHT_MAGENTA="\033[95m"
+BRIGHT_CYAN="\033[96m"
+
+# Brand color (burnt orange #e8683a = RGB 232,104,58)
+BRAND="\033[38;2;232;104;58m"
+
+# ============================================================================
+# Read Component Configuration
+# ============================================================================
+# Default: all components enabled
+SHOW_AGILEFLOW=true
+SHOW_MODEL=true
+SHOW_STORY=true
+SHOW_EPIC=true
+SHOW_WIP=true
+SHOW_CONTEXT=true
+SHOW_COST=true
+SHOW_GIT=true
+
+# Check agileflow-metadata.json for component settings
+if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
+  COMPONENTS=$(jq '.features.statusline.components // null' docs/00-meta/agileflow-metadata.json 2>/dev/null)
+  if [ "$COMPONENTS" != "null" ] && [ -n "$COMPONENTS" ]; then
+    # Use 'if . == null then true else . end' to properly handle false values
+    # (jq's // operator treats false as falsy and applies the fallback)
+    SHOW_AGILEFLOW=$(echo "$COMPONENTS" | jq -r '.agileflow | if . == null then true else . end')
+    SHOW_MODEL=$(echo "$COMPONENTS" | jq -r '.model | if . == null then true else . end')
+    SHOW_STORY=$(echo "$COMPONENTS" | jq -r '.story | if . == null then true else . end')
+    SHOW_EPIC=$(echo "$COMPONENTS" | jq -r '.epic | if . == null then true else . end')
+    SHOW_WIP=$(echo "$COMPONENTS" | jq -r '.wip | if . == null then true else . end')
+    SHOW_CONTEXT=$(echo "$COMPONENTS" | jq -r '.context | if . == null then true else . end')
+    SHOW_COST=$(echo "$COMPONENTS" | jq -r '.cost | if . == null then true else . end')
+    SHOW_GIT=$(echo "$COMPONENTS" | jq -r '.git | if . == null then true else . end')
+  fi
+fi
+
+# ============================================================================
+# AgileFlow Version & Update Check
+# ============================================================================
+AGILEFLOW_DISPLAY=""
+if [ "$SHOW_AGILEFLOW" = "true" ]; then
+  # Get local version from package.json or metadata
+  LOCAL_VERSION=""
+  if [ -f ".agileflow/package.json" ]; then
+    LOCAL_VERSION=$(jq -r '.version // ""' .agileflow/package.json 2>/dev/null)
+  elif [ -f "docs/00-meta/agileflow-metadata.json" ]; then
+    LOCAL_VERSION=$(jq -r '.version // ""' docs/00-meta/agileflow-metadata.json 2>/dev/null)
+  fi
+
+  if [ -n "$LOCAL_VERSION" ] && [ "$LOCAL_VERSION" != "null" ]; then
+    # Check for updates (cached for 1 hour to avoid rate limiting)
+    UPDATE_CACHE="/tmp/agileflow-update-check"
+    UPDATE_AVAILABLE=""
+    LATEST_VERSION=""
+
+    # Only check npm if cache is stale (older than 1 hour)
+    if [ ! -f "$UPDATE_CACHE" ] || [ "$(find "$UPDATE_CACHE" -mmin +60 2>/dev/null)" ]; then
+      # Quick npm check (timeout after 2 seconds)
+      LATEST_VERSION=$(timeout 2 npm view agileflow version 2>/dev/null || echo "")
+      if [ -n "$LATEST_VERSION" ]; then
+        echo "$LATEST_VERSION" > "$UPDATE_CACHE"
+      fi
+    else
+      LATEST_VERSION=$(cat "$UPDATE_CACHE" 2>/dev/null)
+    fi
+
+    # Compare versions
+    if [ -n "$LATEST_VERSION" ] && [ "$LATEST_VERSION" != "$LOCAL_VERSION" ]; then
+      # Simple version comparison (works for semver)
+      if [ "$(printf '%s\n' "$LOCAL_VERSION" "$LATEST_VERSION" | sort -V | tail -n1)" = "$LATEST_VERSION" ] && [ "$LOCAL_VERSION" != "$LATEST_VERSION" ]; then
+        UPDATE_AVAILABLE="$LATEST_VERSION"
+      fi
+    fi
+
+    # Build display
+    if [ -n "$UPDATE_AVAILABLE" ]; then
+      AGILEFLOW_DISPLAY="${BRAND}agileflow${RESET} ${DIM}v${LOCAL_VERSION}${RESET} ${YELLOW}↑${UPDATE_AVAILABLE}${RESET}"
+    else
+      AGILEFLOW_DISPLAY="${BRAND}agileflow${RESET} ${DIM}v${LOCAL_VERSION}${RESET}"
+    fi
+  else
+    AGILEFLOW_DISPLAY="${BRAND}agileflow${RESET}"
+  fi
+fi
+
+# ============================================================================
+# Parse Input JSON
+# ============================================================================
+input=$(cat)
+
+# Parse model info
+MODEL_DISPLAY=$(echo "$input" | jq -r '.model.display_name // "Claude"')
+
+# Parse context usage
+CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size // 200000')
+USAGE=$(echo "$input" | jq '.context_window.current_usage // null')
+
+CTX_DISPLAY=""
+CTX_COLOR="$GREEN"
+if [ "$USAGE" != "null" ]; then
+  CURRENT_TOKENS=$(echo "$USAGE" | jq '.input_tokens + (.cache_creation_input_tokens // 0) + (.cache_read_input_tokens // 0)')
+  if [ "$CURRENT_TOKENS" != "null" ] && [ "$CURRENT_TOKENS" -gt 0 ] 2>/dev/null; then
+    PERCENT_USED=$((CURRENT_TOKENS * 100 / CONTEXT_SIZE))
+
+    # Color based on usage level
+    if [ "$PERCENT_USED" -ge 80 ]; then
+      CTX_COLOR="$BRIGHT_RED"
+    elif [ "$PERCENT_USED" -ge 60 ]; then
+      CTX_COLOR="$YELLOW"
+    elif [ "$PERCENT_USED" -ge 40 ]; then
+      CTX_COLOR="$BRIGHT_YELLOW"
+    else
+      CTX_COLOR="$GREEN"
+    fi
+
+    CTX_DISPLAY="${CTX_COLOR}${PERCENT_USED}%${RESET}"
+  fi
+fi
+
+# Parse cost
+TOTAL_COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
+COST_DISPLAY=""
+if [ "$TOTAL_COST" != "0" ] && [ "$TOTAL_COST" != "null" ]; then
+  COST_CENTS=$(echo "$TOTAL_COST * 100" | bc 2>/dev/null | cut -d. -f1)
+  if [ -n "$COST_CENTS" ] && [ "$COST_CENTS" -gt 100 ]; then
+    # Over $1 - show in yellow
+    COST_DISPLAY="${YELLOW}$(printf '$%.2f' "$TOTAL_COST")${RESET}"
+  else
+    COST_DISPLAY="${DIM}$(printf '$%.2f' "$TOTAL_COST")${RESET}"
+  fi
+fi
+
+# ============================================================================
+# AgileFlow Status - Read from status.json
+# ============================================================================
+STORY_DISPLAY=""
+EPIC_DISPLAY=""
+NEXT_STORY=""
+WIP_DISPLAY=""
+
+if [ -f "docs/09-agents/status.json" ]; then
+  STATUS_JSON=$(cat docs/09-agents/status.json 2>/dev/null)
+
+  # Find first in-progress story and its epic
+  STORY_ID=$(echo "$STATUS_JSON" | jq -r '.stories | to_entries | map(select(.value.status == "in-progress")) | .[0].key // empty')
+
+  if [ -n "$STORY_ID" ] && [ "$STORY_ID" != "null" ]; then
+    STORY_TITLE=$(echo "$STATUS_JSON" | jq -r ".stories[\"$STORY_ID\"].title // \"\"")
+    EPIC_ID=$(echo "$STATUS_JSON" | jq -r ".stories[\"$STORY_ID\"].epic // \"\"")
+
+    if [ -n "$STORY_TITLE" ] && [ "$STORY_TITLE" != "null" ]; then
+      # Truncate title if too long (max 25 chars)
+      if [ ${#STORY_TITLE} -gt 25 ]; then
+        STORY_TITLE="${STORY_TITLE:0:22}..."
+      fi
+      STORY_DISPLAY="${CYAN}${STORY_ID}${RESET}${DIM}:${RESET} ${STORY_TITLE}"
+    fi
+
+    # Get epic progress if we have an epic
+    if [ -n "$EPIC_ID" ] && [ "$EPIC_ID" != "null" ]; then
+      # Count total stories in this epic
+      TOTAL_IN_EPIC=$(echo "$STATUS_JSON" | jq "[.stories | to_entries[] | select(.value.epic == \"$EPIC_ID\")] | length")
+      # Count done stories in this epic
+      DONE_IN_EPIC=$(echo "$STATUS_JSON" | jq "[.stories | to_entries[] | select(.value.epic == \"$EPIC_ID\" and .value.status == \"done\")] | length")
+
+      if [ "$TOTAL_IN_EPIC" -gt 0 ] 2>/dev/null; then
+        EPIC_PCT=$((DONE_IN_EPIC * 100 / TOTAL_IN_EPIC))
+
+        # Color epic progress based on completion
+        if [ "$EPIC_PCT" -ge 80 ]; then
+          EPIC_COLOR="$GREEN"
+        elif [ "$EPIC_PCT" -ge 50 ]; then
+          EPIC_COLOR="$YELLOW"
+        else
+          EPIC_COLOR="$DIM"
+        fi
+        EPIC_DISPLAY="${MAGENTA}${EPIC_ID}${RESET} ${EPIC_COLOR}${DONE_IN_EPIC}/${TOTAL_IN_EPIC}${RESET}"
+      fi
+    fi
+  else
+    # No story in-progress - find next READY story (priority: high > medium > low)
+    NEXT_ID=$(echo "$STATUS_JSON" | jq -r '
+      .stories | to_entries
+      | map(select(.value.status == "ready" or .value.status == "backlog" or .value.status == "draft"))
+      | sort_by(
+          if .value.priority == "high" then 0
+          elif .value.priority == "medium" then 1
+          else 2
+          end
+        )
+      | .[0].key // empty
+    ')
+
+    if [ -n "$NEXT_ID" ] && [ "$NEXT_ID" != "null" ]; then
+      NEXT_PRIORITY=$(echo "$STATUS_JSON" | jq -r ".stories[\"$NEXT_ID\"].priority // \"\"")
+      # Color based on priority
+      case "$NEXT_PRIORITY" in
+        high) PRIORITY_COLOR="$RED" ;;
+        medium) PRIORITY_COLOR="$YELLOW" ;;
+        *) PRIORITY_COLOR="$GREEN" ;;
+      esac
+      NEXT_STORY="${DIM}Next:${RESET} ${PRIORITY_COLOR}${NEXT_ID}${RESET}"
+    fi
+  fi
+
+  # Calculate WIP count
+  WIP_COUNT=$(echo "$STATUS_JSON" | jq '[.stories | to_entries[] | select(.value.status == "in-progress" or .value.status == "in-review")] | length')
+  WIP_LIMIT=3  # Default WIP limit
+  if [ -n "$WIP_COUNT" ] && [ "$WIP_COUNT" != "null" ] && [ "$WIP_COUNT" -gt 0 ] 2>/dev/null; then
+    # Color WIP based on limit
+    if [ "$WIP_COUNT" -gt "$WIP_LIMIT" ]; then
+      WIP_COLOR="$RED"
+    elif [ "$WIP_COUNT" -eq "$WIP_LIMIT" ]; then
+      WIP_COLOR="$YELLOW"
+    else
+      WIP_COLOR="$GREEN"
+    fi
+    WIP_DISPLAY="${DIM}WIP${RESET} ${WIP_COLOR}${WIP_COUNT}${RESET}"
+  fi
+fi
+
+# ============================================================================
+# Git Branch with Colors
+# ============================================================================
+GIT_DISPLAY=""
+if git rev-parse --git-dir > /dev/null 2>&1; then
+  BRANCH=$(git branch --show-current 2>/dev/null)
+  if [ -n "$BRANCH" ]; then
+    # Color based on branch type
+    case "$BRANCH" in
+      main|master)
+        GIT_COLOR="$GREEN"
+        ;;
+      develop|dev)
+        GIT_COLOR="$BLUE"
+        ;;
+      feature/*|feat/*)
+        GIT_COLOR="$CYAN"
+        ;;
+      fix/*|bugfix/*|hotfix/*)
+        GIT_COLOR="$RED"
+        ;;
+      release/*)
+        GIT_COLOR="$MAGENTA"
+        ;;
+      *)
+        GIT_COLOR="$DIM"
+        ;;
+    esac
+
+    # Truncate long branch names
+    if [ ${#BRANCH} -gt 20 ]; then
+      BRANCH="${BRANCH:0:17}..."
+    fi
+    GIT_DISPLAY="${GIT_COLOR}${BRANCH}${RESET}"
+  fi
+fi
+
+# ============================================================================
+# Build Status Line
+# ============================================================================
+OUTPUT=""
+
+# Separator
+SEP=" ${DIM}│${RESET} "
+
+# AgileFlow branding (if enabled)
+if [ "$SHOW_AGILEFLOW" = "true" ] && [ -n "$AGILEFLOW_DISPLAY" ]; then
+  OUTPUT="${AGILEFLOW_DISPLAY}"
+fi
+
+# Model with subtle styling (if enabled)
+if [ "$SHOW_MODEL" = "true" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${DIM}[${RESET}${BOLD}${MODEL_DISPLAY}${RESET}${DIM}]${RESET}"
+fi
+
+# Add current story OR next story suggestion (if enabled)
+if [ "$SHOW_STORY" = "true" ]; then
+  if [ -n "$STORY_DISPLAY" ]; then
+    [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+    OUTPUT="${OUTPUT}${STORY_DISPLAY}"
+  elif [ -n "$NEXT_STORY" ]; then
+    [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+    OUTPUT="${OUTPUT}${NEXT_STORY}"
+  fi
+fi
+
+# Add epic progress (if enabled and working on a story in an epic)
+if [ "$SHOW_EPIC" = "true" ] && [ -n "$EPIC_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${EPIC_DISPLAY}"
+fi
+
+# Add WIP count (if enabled)
+if [ "$SHOW_WIP" = "true" ] && [ -n "$WIP_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${WIP_DISPLAY}"
+fi
+
+# Add context usage (if enabled)
+if [ "$SHOW_CONTEXT" = "true" ] && [ -n "$CTX_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${CTX_DISPLAY}"
+fi
+
+# Add cost (if enabled)
+if [ "$SHOW_COST" = "true" ] && [ -n "$COST_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${COST_DISPLAY}"
+fi
+
+# Add git branch (if enabled)
+if [ "$SHOW_GIT" = "true" ] && [ -n "$GIT_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${GIT_DISPLAY}"
+fi
+
+echo -e "$OUTPUT"

package/scripts/agileflow-stop.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# agileflow-stop.sh - Session wrap-up hook
+
+# Only run if we're in a git repo
+git rev-parse --git-dir > /dev/null 2>&1 || exit 0
+
+# Check for uncommitted changes
+CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+
+if [ "$CHANGES" -gt 0 ]; then
+  echo ""
+  echo -e "\033[0;33m$CHANGES uncommitted change(s)\033[0m"
+fi