create-merlin-brain 3.2.0 → 3.3.0

package/files/merlin/agents-sync.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# Merlin CLI: agents-sync.sh — sync, list, info for Merlin agents
+# Usage: merlin agents [sync|list|info <name>]
+set -euo pipefail
+
+AGENTS_DIR="${HOME}/.claude/agents"
+MERLIN_DIR="${HOME}/.claude/merlin"
+LAST_SYNC="${MERLIN_DIR}/.last-agent-sync"
+API_URL="${MERLIN_API_URL:-https://api.merlin.build}"
+
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+CYAN='\033[0;36m'; MAGENTA='\033[0;35m'; BOLD='\033[1m'
+DIM='\033[2m'; RESET='\033[0m'
+
+die() { echo -e "${RED}Error: $*${RESET}" >&2; exit 1; }
+
+file_hash() {
+  md5sum "${1}" 2>/dev/null | cut -c1-8 || md5 -q "${1}" 2>/dev/null | cut -c1-8 || echo "unknown"
+}
+
+json_field() {
+  echo "${1}" | python3 -c "import sys,json;print(json.load(sys.stdin).get('${2}',''))" 2>/dev/null || echo ""
+}
+
+json_agent_entry() {
+  echo "${1}" | python3 -c "
+import sys,json
+data=json.load(sys.stdin)
+for a in data.get('agents',[]):
+    if a['name']=='${2}': print(json.dumps(a)); break
+" 2>/dev/null || echo ""
+}
+
+cmd_sync() {
+  echo -e "\n${MAGENTA}${BOLD}  🔮 Merlin Agent Sync${RESET}\n"
+  echo -e "${DIM}  Checking ${API_URL} for updates...${RESET}\n"
+  [ -d "${AGENTS_DIR}" ] || mkdir -p "${AGENTS_DIR}"
+
+  local installed="" count=0
+  for f in "${AGENTS_DIR}"/*.md; do
+    [ -f "${f}" ] || continue
+    local name hash
+    name=$(basename "${f}" .md); hash=$(file_hash "${f}")
+    installed="${installed}${name}:${hash},"; count=$((count + 1))
+  done
+  echo -e "  ${DIM}Installed: ${count} agents${RESET}"
+
+  local response
+  response=$(curl -s --max-time 10 "${API_URL}/api/agents-sync/check?installed=${installed}" 2>/dev/null) || die "Cannot reach ${API_URL}"
+  local stale_count
+  stale_count=$(json_field "${response}" "count")
+
+  if [ "${stale_count:-0}" = "0" ]; then
+    echo -e "\n  ${GREEN}✓ All agents are up to date!${RESET}\n"
+    date +%s > "${LAST_SYNC}"; return 0
+  fi
+
+  echo -e "  ${YELLOW}${stale_count} agent(s) need updating${RESET}\n"
+  local stale_names
+  stale_names=$(echo "${response}" | python3 -c "
+import sys,json
+for a in json.load(sys.stdin).get('stale',[]): print(a['name'])
+" 2>/dev/null) || die "Failed to parse response"
+
+  local updated=0 failed=0
+  for agent_name in ${stale_names}; do
+    printf "  Syncing %-35s " "${agent_name}..."
+    local content md_content
+    content=$(curl -s --max-time 10 "${API_URL}/api/agents-sync/${agent_name}" 2>/dev/null) || { echo -e "${RED}FAIL${RESET}"; failed=$((failed+1)); continue; }
+    md_content=$(json_field "${content}" "content")
+    if [ -n "${md_content}" ]; then
+      echo "${md_content}" > "${AGENTS_DIR}/${agent_name}.md"
+      echo -e "${GREEN}✓${RESET}"; updated=$((updated+1))
+    else
+      echo -e "${RED}EMPTY${RESET}"; failed=$((failed+1))
+    fi
+  done
+
+  echo -e "\n  ${GREEN}Updated: ${updated}${RESET}"
+  [ "${failed}" -gt 0 ] && echo -e "  ${RED}Failed: ${failed}${RESET}"
+  echo ""; date +%s > "${LAST_SYNC}"
+}
+
+cmd_list() {
+  echo -e "\n${MAGENTA}${BOLD}  🔮 Merlin Agents${RESET}\n"
+  [ -d "${AGENTS_DIR}" ] || die "No agents directory at ${AGENTS_DIR}"
+
+  local manifest=""
+  manifest=$(curl -s --max-time 5 "${API_URL}/api/agents-sync" 2>/dev/null) || manifest=""
+
+  local count=0
+  for f in "${AGENTS_DIR}"/*.md; do
+    [ -f "${f}" ] || continue
+    local name hash
+    name=$(basename "${f}" .md); hash=$(file_hash "${f}"); count=$((count+1))
+
+    local icon="${GREEN}●${RESET}"
+    if [ -n "${manifest}" ]; then
+      local entry cloud_hash
+      entry=$(json_agent_entry "${manifest}" "${name}")
+      if [ -n "${entry}" ]; then
+        cloud_hash=$(json_field "${entry}" "hash")
+        [ "${cloud_hash}" != "${hash}" ] && icon="${YELLOW}●${RESET}"
+      fi
+    fi
+
+    local desc
+    desc=$(grep -m1 '^[^#<-]' "${f}" 2>/dev/null | head -c 60 || echo "")
+    printf "  ${icon} ${BOLD}%-35s${RESET} ${DIM}%s${RESET}\n" "${name}" "${desc}"
+  done
+
+  echo -e "\n  ${DIM}Total: ${count} agents${RESET}"
+  echo -e "  ${GREEN}●${RESET} up to date  ${YELLOW}●${RESET} update available\n"
+}
+
+cmd_info() {
+  local name="${1:-}"
+  [ -n "${name}" ] || die "Usage: merlin agents info <name>"
+  local agent_file="${AGENTS_DIR}/${name}.md"
+  [ -f "${agent_file}" ] || die "Agent '${name}' not found"
+
+  echo -e "\n${MAGENTA}${BOLD}  🔮 Agent: ${name}${RESET}\n"
+
+  local hash lines size
+  hash=$(file_hash "${agent_file}")
+  lines=$(wc -l < "${agent_file}" | tr -d ' ')
+  size=$(wc -c < "${agent_file}" | tr -d ' ')
+
+  echo -e "  ${CYAN}Hash:${RESET}  ${hash}"
+  echo -e "  ${CYAN}Lines:${RESET} ${lines}"
+  echo -e "  ${CYAN}Size:${RESET}  ${size} bytes"
+  echo -e "  ${CYAN}Path:${RESET}  ${agent_file}"
+
+  local cloud_info cloud_hash
+  cloud_info=$(curl -s --max-time 5 "${API_URL}/api/agents-sync/${name}" 2>/dev/null) || cloud_info=""
+  if [ -n "${cloud_info}" ]; then
+    cloud_hash=$(json_field "${cloud_info}" "hash")
+    if [ -n "${cloud_hash}" ]; then
+      [ "${cloud_hash}" = "${hash}" ] && echo -e "  ${CYAN}Cloud:${RESET} ${GREEN}up to date${RESET}" || echo -e "  ${CYAN}Cloud:${RESET} ${YELLOW}update available${RESET}"
+    fi
+  else
+    echo -e "  ${CYAN}Cloud:${RESET} ${DIM}unavailable${RESET}"
+  fi
+
+  echo -e "\n  ${BOLD}Preview:${RESET}"
+  head -5 "${agent_file}" | sed 's/^/    /'
+  echo -e "    ${DIM}...${RESET}\n"
+}
+
+subcmd="${1:-help}"
+shift 2>/dev/null || true
+
+case "${subcmd}" in
+  sync) cmd_sync ;;
+  list) cmd_list ;;
+  info) cmd_info "${1:-}" ;;
+  help|--help|-h)
+    echo -e "\n${BOLD}Usage:${RESET} merlin agents <command>\n"
+    echo -e "  ${CYAN}sync${RESET}   Sync agents from merlin.build cloud"
+    echo -e "  ${CYAN}list${RESET}   Show installed agents with update status"
+    echo -e "  ${CYAN}info${RESET}   <name>  Show details for one agent\n" ;;
+  *) die "Unknown: ${subcmd}. Use: sync, list, info" ;;
+esac

package/files/merlin/analytics.sh

@@ -0,0 +1,159 @@
+#!/usr/bin/env bash
+#
+# Merlin Analytics CLI Viewer
+# View, compare, upload, and clean session analytics data.
+# Requires jq for JSON processing.
+#
+set -euo pipefail
+
+ANALYTICS_DIR="${HOME}/.claude/merlin/analytics"
+API_URL="${MERLIN_API_URL:-https://auth.merlin.build}"
+API_KEY="${MERLIN_API_KEY:-}"
+
+# Colors
+R='\033[0m' G='\033[32m' B='\033[34m' Y='\033[33m' DIM='\033[2m' BOLD='\033[1m'
+GRN() { printf "${G}%s${R}" "$1"; }
+BLU() { printf "${B}%s${R}" "$1"; }
+GRY() { printf "${DIM}%s${R}" "$1"; }
+
+check_jq() {
+  if ! command -v jq >/dev/null 2>&1; then
+    echo "Error: jq is required. Install: brew install jq (macOS) or apt install jq (Linux)"
+    exit 1
+  fi
+}
+
+fmt_duration() {
+  local s="${1:-0}"
+  if [ "$s" -ge 3600 ]; then printf "%dh %dm" $((s/3600)) $(((s%3600)/60))
+  elif [ "$s" -ge 60 ]; then printf "%dm %ds" $((s/60)) $((s%60))
+  else printf "%ds" "$s"; fi
+}
+
+type_color() {
+  case "${1:-raw}" in
+    loop) GRN "$1" ;; hooks) BLU "$1" ;; *) GRY "$1" ;;
+  esac
+}
+
+# ─── Summary: Show last N sessions ──────────────────────────────────────────
+cmd_summary() {
+  check_jq
+  local limit="${1:-10}"
+  local files
+  files=$(find "${ANALYTICS_DIR}" -name 'session-*.json' -not -name '*.uploaded.json' 2>/dev/null | sort -r | head -n "$limit")
+
+  if [ -z "$files" ]; then
+    echo "No analytics sessions found in ${ANALYTICS_DIR}"
+    return
+  fi
+
+  printf "${BOLD}%-20s %-6s %8s %6s %5s %5s${R}\n" "DATE" "TYPE" "DURATION" "SIGHT" "FILES" "TASKS"
+  printf "%-20s %-6s %8s %6s %5s %5s\n" "────────────────────" "──────" "────────" "──────" "─────" "─────"
+
+  echo "$files" | while IFS= read -r f; do
+    [ -f "$f" ] || continue
+    local row
+    row=$(jq -r '[
+      .startTime // "unknown",
+      .sessionType // "raw",
+      (.durationSeconds // 0 | tostring),
+      (.summary.sightsCallCount // (.events | map(select(.type=="sights_call")) | length) // 0 | tostring),
+      (.summary.filesChanged // (.events | map(select(.type=="file_edit")) | length) // 0 | tostring),
+      (.summary.tasksCompleted // (.events | map(select(.type=="task_complete")) | length) // 0 | tostring)
+    ] | @tsv' "$f" 2>/dev/null) || continue
+    local dt stype dur sight fchg tasks
+    IFS=$'\t' read -r dt stype dur sight fchg tasks <<< "$row"
+    local date_str="${dt:0:16}"
+    local dur_fmt; dur_fmt=$(fmt_duration "$dur")
+    printf "%-20s " "$date_str"
+    type_color "$stype"
+    printf "%*s %8s %6s %5s %5s\n" "$((6-${#stype}))" "" "$dur_fmt" "$sight" "$fchg" "$tasks"
+  done
+}
+
+# ─── Compare: Average metrics by session type ───────────────────────────────
+cmd_compare() {
+  check_jq
+  local files
+  files=$(find "${ANALYTICS_DIR}" -name 'session-*.json' 2>/dev/null)
+  [ -z "$files" ] && { echo "No sessions found."; return; }
+
+  printf "\n${BOLD}Session Type Comparison${R}\n"
+  printf "%-8s %6s %8s %6s %5s %5s\n" "TYPE" "COUNT" "AVG DUR" "SIGHTS" "FILES" "TASKS"
+  printf "%-8s %6s %8s %6s %5s %5s\n" "────────" "──────" "────────" "──────" "─────" "─────"
+
+  for stype in loop hooks raw; do
+    local stats
+    stats=$(echo "$files" | xargs -I{} jq -r "select(.sessionType == \"$stype\") |
+      [(.durationSeconds // 0), (.summary.sightsCallCount // 0), (.summary.filesChanged // 0), (.summary.tasksCompleted // 0)]
+      | @tsv" {} 2>/dev/null | awk -F'\t' '
+      { n++; d+=$1; s+=$2; f+=$3; t+=$4 }
+      END { if(n>0) printf "%d\t%d\t%d\t%d\t%d", n, d/n, s/n, f/n, t/n; else printf "0\t0\t0\t0\t0" }
+    ')
+    local cnt avg_d avg_s avg_f avg_t
+    IFS=$'\t' read -r cnt avg_d avg_s avg_f avg_t <<< "$stats"
+    [ "$cnt" -eq 0 ] && continue
+    local dur_fmt; dur_fmt=$(fmt_duration "$avg_d")
+    type_color "$stype"
+    printf "%*s %6s %8s %6s %5s %5s\n" "$((8-${#stype}))" "" "$cnt" "$dur_fmt" "$avg_s" "$avg_f" "$avg_t"
+  done
+  echo ""
+}
+
+# ─── Upload: Send sessions to Merlin API ────────────────────────────────────
+cmd_upload() {
+  check_jq
+  [ -z "${API_KEY}" ] && { echo "Error: MERLIN_API_KEY not set. Get your key at merlin.build/settings"; exit 1; }
+
+  local files
+  files=$(find "${ANALYTICS_DIR}" -name 'session-*.json' -not -name '*.uploaded.json' 2>/dev/null)
+  [ -z "$files" ] && { echo "No new sessions to upload."; return; }
+
+  local count; count=$(echo "$files" | wc -l | tr -d ' ')
+  echo "Uploading ${count} session(s)..."
+
+  local sessions="[]"
+  while IFS= read -r f; do
+    [ -f "$f" ] || continue
+    sessions=$(jq --slurpfile s "$f" '. + $s' <<< "$sessions" 2>/dev/null) || continue
+  done <<< "$files"
+
+  local resp
+  resp=$(curl -sS -X POST "${API_URL}/api/analytics/upload" \
+    -H "Authorization: Bearer ${API_KEY}" \
+    -H "Content-Type: application/json" \
+    -d "{\"sessions\": ${sessions}}" 2>&1) || { echo "Upload failed: $resp"; return 1; }
+
+  # Mark uploaded
+  echo "$files" | while IFS= read -r f; do
+    mv "$f" "${f%.json}.uploaded.json" 2>/dev/null || true
+  done
+  echo "Uploaded ${count} session(s) successfully."
+}
+
+# ─── Clean: Remove old sessions ─────────────────────────────────────────────
+cmd_clean() {
+  local days="${1:-30}"
+  local count=0
+  find "${ANALYTICS_DIR}" -name 'session-*.json' -mtime +"$days" 2>/dev/null | while IFS= read -r f; do
+    rm -f "$f" && count=$((count + 1))
+  done
+  find "${ANALYTICS_DIR}" -name '*.uploaded.json' -mtime +"$days" 2>/dev/null -delete
+  echo "Cleaned sessions older than ${days} days."
+}
+
+# ─── Main ────────────────────────────────────────────────────────────────────
+case "${1:-summary}" in
+  summary)  cmd_summary "${2:-10}" ;;
+  compare)  cmd_compare ;;
+  upload)   cmd_upload ;;
+  clean)    cmd_clean "${2:-30}" ;;
+  *)
+    echo "Usage: merlin analytics [summary|compare|upload|clean]"
+    echo "  summary [N]   Show last N sessions (default 10)"
+    echo "  compare       Compare metrics by session type"
+    echo "  upload        Upload sessions to merlin.build"
+    echo "  clean [days]  Remove sessions older than N days (default 30)"
+    ;;
+esac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-merlin-brain",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Merlin - The Ultimate AI Brain for Claude Code. One install: workflows, agents, loop, and Sights MCP server.",
   "type": "module",
   "main": "./dist/server/index.js",