axel-setup 0.2.0

package/templates/settings.json

@@ -0,0 +1,255 @@
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "CLAUDE_AUTO_BACKGROUND_TASKS": "1",
+    "CLAUDE_CODE_IDLE_THRESHOLD_MINUTES": "30",
+    "CLAUDE_CODE_IDLE_TOKEN_THRESHOLD": "50000"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(*)",
+      "Read(*)",
+      "Edit(*)",
+      "Write(*)",
+      "Glob(*)",
+      "Grep(*)",
+      "Agent(*)",
+      "mcp__*"
+    ],
+    "deny": [
+      "Bash(rm -rf *)",
+      "Bash(dd *)"
+    ],
+    "defaultMode": "bypassPermissions"
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"$TOOL_INPUT\" | grep -qE '\\-\\-no-verify' && echo 'BLOCKED: --no-verify is prohibited' >&2 && exit 2 || exit 0"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/validate-commit-format.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"$TOOL_INPUT\" | grep -qE 'RAILS_ENV=staging' && echo 'WARNING: staging = PRODUCTION. Confirm with the user.' >&2 && exit 1 || exit 0"
+          }
+        ]
+      },
+      {
+        "matcher": "Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jq -c -f $HOME/.claude/hooks/enforce-agent-model.jq",
+            "timeout": 5,
+            "statusMessage": "Checking Agent model routing..."
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/proactive-resolver.sh",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/post-edit-lint.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/post-edit-lint.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|Edit|Write|MultiEdit|Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$HOME/.claude/hooks/gsd-context-monitor.js\"",
+            "timeout": 3
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|Edit|Write|Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-log-action.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|Edit|Write|Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-checkpoint.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/post-commit-verify.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/post-commit-memory-trigger.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/linear-lifecycle-sync.sh",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-auto-title.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-cost-log.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-summarize.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/memory-extractor.sh",
+            "async": true
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/desktop-notify.sh",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/precompact-save-context.sh"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/hooks/session-restore.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "bash $HOME/.claude/statusline-command.sh"
+  },
+  "enabledPlugins": {
+    "frontend-design@claude-plugins-official": true,
+    "context7@claude-plugins-official": true,
+    "ruby-lsp@claude-plugins-official": true,
+    "typescript-lsp@claude-plugins-official": true,
+    "pyright-lsp@claude-plugins-official": true,
+    "code-simplifier@claude-plugins-official": true,
+    "hookify@claude-plugins-official": true,
+    "claude-md-management@claude-plugins-official": true,
+    "commit-commands@claude-plugins-official": true,
+    "pr-review-toolkit@claude-plugins-official": true
+  },
+  "language": "spanish",
+  "alwaysThinkingEnabled": true,
+  "effortLevel": "high",
+  "autoCompactWindow": 500000,
+  "promptSuggestionEnabled": true,
+  "voiceEnabled": true,
+  "channelsEnabled": true,
+  "autoMemoryEnabled": true,
+  "autoMemoryDirectory": "~/.claude/memory",
+  "autoDreamEnabled": true,
+  "showThinkingSummaries": true,
+  "skipDangerousModePermissionPrompt": true
+}

package/templates/statusline-command.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# Claude Code status line script
+# Reads JSON from stdin and prints a compact status line
+# Also persists last-known stats for session cost logging
+
+input=$(cat)
+
+# --- Session ID (for per-session stat files) ---
+session_id=$(echo "$input" | jq -r '.session_id // empty')
+
+# --- Directory ---
+cwd=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // empty')
+if [ -n "$cwd" ]; then
+  dir=$(basename "$cwd")
+else
+  dir=$(basename "$(pwd)")
+fi
+
+# --- Git branch (skip optional locks) ---
+branch=$(GIT_OPTIONAL_LOCKS=0 git -C "$cwd" symbolic-ref --short HEAD 2>/dev/null \
+         || GIT_OPTIONAL_LOCKS=0 git -C "$cwd" rev-parse --short HEAD 2>/dev/null)
+
+# --- Detect project type from cwd ---
+node_ver=""
+ruby_ver=""
+
+# Node version — try .nvmrc in the cwd, then `node` on PATH
+if [ -f "$cwd/.nvmrc" ]; then
+  node_ver="node:$(cat "$cwd/.nvmrc" | tr -d '[:space:]')"
+elif command -v node &>/dev/null; then
+  node_ver="node:$(node --version 2>/dev/null | sed 's/v//')"
+fi
+
+# Ruby version — prefer .ruby-version in the cwd, then `ruby` on PATH
+if [ -f "$cwd/.ruby-version" ]; then
+  ruby_ver="ruby:$(cat "$cwd/.ruby-version" | tr -d '[:space:]')"
+elif command -v ruby &>/dev/null; then
+  ruby_ver="ruby:$(ruby --version 2>/dev/null | awk '{print $2}')"
+fi
+
+# --- Context window ---
+remaining=$(echo "$input" | jq -r '.context_window.remaining_percentage // empty')
+ctx_used=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
+total_input=$(echo "$input" | jq -r '.context_window.total_input_tokens // empty')
+total_output=$(echo "$input" | jq -r '.context_window.total_output_tokens // empty')
+
+# --- Cost ---
+cost_usd=$(echo "$input" | jq -r '.cost.total_cost_usd // empty')
+
+# --- Rate limits ---
+five_h_pct=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
+five_h_resets=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
+
+# --- Model short name ---
+model=$(echo "$input" | jq -r '.model.display_name // empty' | sed 's/Claude //' | sed 's/ (.*)//')
+
+# --- Persist last-known stats for Stop hook ---
+if [ -n "$session_id" ]; then
+  stats_file="$HOME/.claude/session-stats-${session_id}.json"
+  echo "$input" | jq -c '{
+    session_id: .session_id,
+    cwd: (.workspace.current_dir // .cwd),
+    cost_usd: (.cost.total_cost_usd // 0),
+    total_input_tokens: (.context_window.total_input_tokens // 0),
+    total_output_tokens: (.context_window.total_output_tokens // 0),
+    ctx_used_pct: (.context_window.used_percentage // 0),
+    five_h_pct: (.rate_limits.five_hour.used_percentage // 0),
+    five_h_resets: (.rate_limits.five_hour.resets_at // 0),
+    model: (.model.display_name // ""),
+    timestamp: now | todate
+  }' > "$stats_file" 2>/dev/null
+
+  # Save starting 5h% once (first non-zero value = baseline before this session)
+  start_file="$HOME/.claude/session-stats-${session_id}-start.json"
+  if [ ! -f "$start_file" ] && [ -n "$five_h_pct" ] && [ "$five_h_pct" != "0" ]; then
+    echo "{\"five_h_pct_start\": $five_h_pct}" > "$start_file"
+  fi
+fi
+
+# --- Colors (ANSI) ---
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+MAGENTA='\033[0;35m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+parts=()
+
+# Directory
+parts+=("$(printf "${CYAN}%s${RESET}" "$dir")")
+
+# Git branch
+if [ -n "$branch" ]; then
+  parts+=("$(printf "${GREEN}(%s)${RESET}" "$branch")")
+fi
+
+# Project runtime versions (only show what's relevant to the project)
+is_node=false
+is_ruby=false
+[ -f "$cwd/package.json" ] || [ -f "$cwd/pnpm-lock.yaml" ] || [ -f "$cwd/.nvmrc" ] && is_node=true
+[ -f "$cwd/Gemfile" ] || [ -f "$cwd/.ruby-version" ] && is_ruby=true
+
+if $is_node && [ -n "$node_ver" ]; then
+  parts+=("$(printf "${YELLOW}%s${RESET}" "$node_ver")")
+fi
+if $is_ruby && [ -n "$ruby_ver" ]; then
+  parts+=("$(printf "${MAGENTA}%s${RESET}" "$ruby_ver")")
+fi
+
+# Model
+if [ -n "$model" ]; then
+  parts+=("$(printf "${BLUE}%s${RESET}" "$model")")
+fi
+
+# Context remaining
+if [ -n "$remaining" ]; then
+  ctx_int=$(printf "%.0f" "$remaining")
+  if [ "$ctx_int" -le 20 ]; then
+    ctx_color="$RED"
+  else
+    ctx_color="$GREEN"
+  fi
+  parts+=("$(printf "${ctx_color}ctx:%s%%${RESET}" "$ctx_int")")
+fi
+
+# Cost — format: $1.26 (2 decimals if >= $0.10, 3 if smaller)
+if [ -n "$cost_usd" ] && [ "$cost_usd" != "0" ]; then
+  cost_big=$(awk "BEGIN {exit !($cost_usd >= 0.10)}" 2>/dev/null && echo 1 || echo 0)
+  if [ "$cost_big" = "1" ]; then
+    cost_fmt=$(printf "%.2f" "$cost_usd" 2>/dev/null)
+  else
+    cost_fmt=$(printf "%.3f" "$cost_usd" 2>/dev/null)
+  fi
+  parts+=("$(printf "${YELLOW}\$%s${RESET}" "$cost_fmt")")
+fi
+
+# Rate limit 5h — shows acum% and +delta% for this session
+if [ -n "$five_h_pct" ] && [ "$five_h_pct" != "0" ]; then
+  five_int=$(printf "%.0f" "$five_h_pct" 2>/dev/null)
+  if [ "$five_int" -ge 80 ]; then
+    rl_color="$RED"
+  elif [ "$five_int" -ge 50 ]; then
+    rl_color="$YELLOW"
+  else
+    rl_color="$DIM"
+  fi
+
+  # Per-session delta
+  delta_str=""
+  if [ -n "$session_id" ]; then
+    start_file_check="$HOME/.claude/session-stats-${session_id}-start.json"
+    if [ -f "$start_file_check" ]; then
+      five_h_start_val=$(jq -r '.five_h_pct_start // 0' "$start_file_check" 2>/dev/null)
+      five_h_delta_val=$(awk "BEGIN {d=$five_h_pct-$five_h_start_val; printf \"%.1f\", (d<0?0:d)}")
+      delta_str=" (+${five_h_delta_val}%)"
+    fi
+  fi
+
+  # Show reset time if close to limit
+  reset_str=""
+  if [ "$five_int" -ge 70 ] && [ -n "$five_h_resets" ] && [ "$five_h_resets" != "0" ]; then
+    reset_time=$(date -r "$five_h_resets" '+%H:%M' 2>/dev/null || date -d "@$five_h_resets" '+%H:%M' 2>/dev/null)
+    [ -n "$reset_time" ] && reset_str=" reset@${reset_time}"
+  fi
+  parts+=("$(printf "${rl_color}5h:%s%%%s%s${RESET}" "$five_int" "$delta_str" "$reset_str")")
+fi
+
+# Join with separator
+sep=" | "
+result=""
+for part in "${parts[@]}"; do
+  if [ -z "$result" ]; then
+    result="$part"
+  else
+    result="$result$sep$part"
+  fi
+done
+
+printf "%b\n" "$result"

package/tests/fixtures/hooks/events.json

@@ -0,0 +1,32 @@
+{
+  "preToolUseAgentMissingModel": {
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Agent",
+    "tool_input": {
+      "description": "Audit installer behavior",
+      "prompt": "Review bootstrap profile side effects."
+    }
+  },
+  "preToolUseAgentWithModel": {
+    "hook_event_name": "PreToolUse",
+    "tool_name": "Agent",
+    "tool_input": {
+      "description": "Audit installer behavior",
+      "prompt": "Review bootstrap profile side effects.",
+      "model": "sonnet"
+    }
+  },
+  "postToolUseEdit": {
+    "hook_event_name": "PostToolUse",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "src/example.js",
+      "old_string": "const enabled = false;",
+      "new_string": "const enabled = true;"
+    }
+  },
+  "sessionStop": {
+    "hook_event_name": "Stop",
+    "session_id": "fixture-session"
+  }
+}

package/tools/session-costs-view.sh

@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+# session-costs-view.sh
+# Pretty-print the session costs log
+# Usage:
+#   ~/.claude/tools/session-costs-view.sh           → all sessions (last 30)
+#   ~/.claude/tools/session-costs-view.sh today     → today only
+#   ~/.claude/tools/session-costs-view.sh week      → last 7 days
+#   ~/.claude/tools/session-costs-view.sh summary   → totals by day
+
+LOG_FILE="$HOME/.claude/session-costs.log"
+MODE="${1:-all}"
+TODAY=$(date +%Y-%m-%d)
+WEEK_AGO=$(date -v-7d +%Y-%m-%d 2>/dev/null || date -d "7 days ago" +%Y-%m-%d 2>/dev/null)
+
+if [ ! -f "$LOG_FILE" ]; then
+  echo "No hay datos todavía. El log se crea al cerrar la primera sesión con actividad."
+  exit 0
+fi
+
+# ANSI colors
+BOLD='\033[1m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+RED='\033[0;31m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+# Filter rows based on mode (skip header)
+case "$MODE" in
+  today)
+    DATA=$(tail -n +2 "$LOG_FILE" | grep "^${TODAY}")
+    TITLE="Sesiones de hoy (${TODAY})"
+    ;;
+  week)
+    DATA=$(tail -n +2 "$LOG_FILE" | awk -F',' -v cutoff="$WEEK_AGO" '$1 >= cutoff')
+    TITLE="Últimos 7 días"
+    ;;
+  summary)
+    echo -e "${BOLD}=== Resumen por día ===${RESET}"
+    echo ""
+    tail -n +2 "$LOG_FILE" | awk -F',' '
+    {
+      day[$1] += $5
+      sessions[$1]++
+      tokens[$1] += ($6 + $7)
+      five_h_delta[$1] += $10
+    }
+    END {
+      for (d in day) {
+        printf "%s  sesiones: %2d  costo: $%.2f  tokens: %5dk  limite-5h usado: %.1f%%\n",
+          d, sessions[d], day[d], tokens[d]/1000, five_h_delta[d]
+      }
+    }' | sort -r
+    echo ""
+    TOTAL=$(tail -n +2 "$LOG_FILE" | awk -F',' '{sum+=$5} END {printf "%.2f", sum}')
+    SESSIONS=$(tail -n +2 "$LOG_FILE" | wc -l | tr -d ' ')
+    TOTAL_5H=$(tail -n +2 "$LOG_FILE" | awk -F',' '{sum+=$10} END {printf "%.1f", sum}')
+    echo -e "${BOLD}Total acumulado: \$${TOTAL} en ${SESSIONS} sesión(es) — ${TOTAL_5H}% del límite de 5h consumido en total${RESET}"
+    exit 0
+    ;;
+  *)
+    DATA=$(tail -n +2 "$LOG_FILE" | tail -30)
+    TITLE="Últimas 30 sesiones"
+    ;;
+esac
+
+if [ -z "$DATA" ]; then
+  echo "Sin datos para el período seleccionado."
+  exit 0
+fi
+
+echo -e "${BOLD}=== ${TITLE} ===${RESET}"
+echo ""
+# Header: date time session project cost in out ctx% 5h-acum% 5h-sesion%
+printf "${BOLD}%-12s %-6s %-10s %-18s %7s %7s %7s %6s %8s %9s${RESET}\n" \
+  "Fecha" "Hora" "Session" "Proyecto" "Costo" "In-tok" "Out-tok" "Ctx%" "5h-acum" "5h-sesion"
+echo "────────────────────────────────────────────────────────────────────────────────────────────"
+
+TOTAL_COST=0
+TOTAL_5H_DELTA=0
+while IFS=',' read -r date time sess proj cost in_tok out_tok ctx_pct five_h_end five_h_delta model; do
+  # Color cost
+  cost_cents=$(awk "BEGIN {printf \"%.0f\", ${cost:-0} * 100}" 2>/dev/null)
+  if [ "${cost_cents:-0}" -gt 100 ]; then
+    cost_color="$RED"
+  elif [ "${cost_cents:-0}" -gt 30 ]; then
+    cost_color="$YELLOW"
+  else
+    cost_color="$GREEN"
+  fi
+
+  # Color 5h acumulado
+  five_end_int=$(printf "%.0f" "${five_h_end:-0}" 2>/dev/null)
+  if [ "${five_end_int:-0}" -ge 80 ]; then
+    five_end_color="$RED"
+  elif [ "${five_end_int:-0}" -ge 50 ]; then
+    five_end_color="$YELLOW"
+  else
+    five_end_color="$DIM"
+  fi
+
+  # Color 5h delta de esta sesión
+  five_delta_int=$(printf "%.0f" "${five_h_delta:-0}" 2>/dev/null)
+  if [ "${five_delta_int:-0}" -ge 20 ]; then
+    five_delta_color="$RED"
+  elif [ "${five_delta_int:-0}" -ge 10 ]; then
+    five_delta_color="$YELLOW"
+  else
+    five_delta_color="$CYAN"
+  fi
+
+  in_k=$(awk "BEGIN {printf \"%.0f\", ${in_tok:-0}/1000}" 2>/dev/null)k
+  out_k=$(awk "BEGIN {printf \"%.0f\", ${out_tok:-0}/1000}" 2>/dev/null)k
+
+  printf "${DIM}%-12s %-6s${RESET} ${CYAN}%-10s${RESET} %-18s ${cost_color}%7s${RESET} %7s %7s %5s%% ${five_end_color}%7s%%${RESET} ${five_delta_color}%8s%%${RESET}\n" \
+    "$date" "$time" "$sess" "${proj:0:18}" "\$$cost" "$in_k" "$out_k" "$ctx_pct" "$five_h_end" "$five_h_delta"
+
+  TOTAL_COST=$(awk "BEGIN {printf \"%.2f\", $TOTAL_COST + ${cost:-0}}" 2>/dev/null)
+  TOTAL_5H_DELTA=$(awk "BEGIN {printf \"%.1f\", $TOTAL_5H_DELTA + ${five_h_delta:-0}}" 2>/dev/null)
+done <<< "$DATA"
+
+echo "────────────────────────────────────────────────────────────────────────────────────────────"
+COUNT=$(echo "$DATA" | wc -l | tr -d ' ')
+echo -e "${BOLD}Total: \$${TOTAL_COST} en ${COUNT} sesión(es) — ${TOTAL_5H_DELTA}% del límite de 5h consumido${RESET}"
+echo ""
+echo -e "${DIM}Columna '5h-sesion' = cuánto del límite de 5h consumió esta sesión específica${RESET}"
+echo -e "${DIM}Modos: $(basename "$0") [today|week|summary|all]${RESET}"