Researchclaw Cn

#!/usr/bin/env bash
# check-prereqs.sh — Check all prerequisites for AutoResearchClaw
# Returns JSON report with pass/fail for each dependency
# Exit code 0 = all pass, 1 = some failures

set -euo pipefail

PASS=0
FAIL=0
RESULTS=()

check() {
  local name="$1"
  local cmd="$2"
  local required="$3"  # "required" or "optional"

  if eval "$cmd" > /dev/null 2>&1; then
    local version
    version=$(eval "$cmd" 2>&1 | head -1 || echo "unknown")
    RESULTS+=("{\"name\":\"$name\",\"status\":\"pass\",\"version\":\"$version\",\"required\":\"$required\"}")
    PASS=$((PASS + 1))
  else
    RESULTS+=("{\"name\":\"$name\",\"status\":\"fail\",\"version\":null,\"required\":\"$required\"}")
    if [ "$required" = "required" ]; then
      FAIL=$((FAIL + 1))
    fi
  fi
}

# Core dependencies
check "python3.11+" "python3 --version 2>&1 | grep -E 'Python 3\.(1[1-9]|[2-9][0-9])'" "required"
check "pip3" "pip3 --version" "required"
check "git" "git --version" "required"

# AutoResearchClaw itself
check "researchclaw-cli" "which researchclaw" "required"
check "researchclaw-package" "python3 -c 'import researchclaw'" "required"

# Docker (required for sandbox mode, optional for simulated)
check "docker" "docker info" "optional"

# LaTeX (required for PDF output)
check "pdflatex" "pdflatex --version" "optional"

# Optional but useful
check "uv" "uv --version" "optional"

# Build JSON output
JSON="{"
JSON+="\"total_checks\":$((PASS + FAIL)),"
JSON+="\"passed\":$PASS,"
JSON+="\"failed\":$FAIL,"
JSON+="\"all_required_pass\":$([ $FAIL -eq 0 ] && echo 'true' || echo 'false'),"
JSON+="\"checks\":["
for i in "${!RESULTS[@]}"; do
  JSON+="${RESULTS[$i]}"
  if [ $i -lt $((${#RESULTS[@]} - 1)) ]; then
    JSON+=","
  fi
done
JSON+="]}"

echo "$JSON"

# Human-readable summary to stderr
echo "" >&2
echo "=== ResearchClaw Prerequisites Check ===" >&2
echo "Passed: $PASS / $((PASS + FAIL))" >&2
if [ $FAIL -gt 0 ]; then
  echo "FAILED: $FAIL required dependencies missing" >&2
  exit 1
else
  echo "All required dependencies are installed." >&2
  exit 0
fi

#!/usr/bin/env bash
# notify-completion.sh — Notification hook
# Logs pipeline completion/failure to a local log file
# Can be extended to send desktop notifications, Slack messages, etc.

set -euo pipefail

LOG_FILE="researchclaw-notifications.log"
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')

# Check for the most recent run
LATEST_RUN=$(ls -td artifacts/rc-* 2>/dev/null | head -1)

if [ -z "$LATEST_RUN" ]; then
  echo "[$TIMESTAMP] Pipeline run initiated (no artifacts yet)" >> "$LOG_FILE"
  exit 0
fi

# Check if pipeline completed
if [ -f "$LATEST_RUN/pipeline_summary.json" ]; then
  STAGES_COMPLETE=$(ls -d "$LATEST_RUN"/stage-* 2>/dev/null | wc -l)
  echo "[$TIMESTAMP] COMPLETE: Pipeline finished with $STAGES_COMPLETE stages. Output: $LATEST_RUN" >> "$LOG_FILE"

  # Desktop notification (if available)
  if command -v notify-send &> /dev/null; then
    notify-send "ResearchClaw" "Pipeline complete! $STAGES_COMPLETE stages finished. Check $LATEST_RUN"
  fi

  # macOS notification (if available)
  if command -v osascript &> /dev/null; then
    osascript -e "display notification \"Pipeline complete! $STAGES_COMPLETE stages finished.\" with title \"ResearchClaw\""
  fi
else
  STAGES_COMPLETE=$(ls -d "$LATEST_RUN"/stage-* 2>/dev/null | wc -l)
  echo "[$TIMESTAMP] IN_PROGRESS: Pipeline at stage $STAGES_COMPLETE. Output: $LATEST_RUN" >> "$LOG_FILE"
fi

#!/usr/bin/env bash
# post-run-check.sh — PostToolUse hook for researchclaw commands
# Scans tool output for common error patterns and surfaces warnings
# Input: $1 = tool output (passed by Claude Code hook system)

set -euo pipefail

OUTPUT="${1:-}"

# If no output provided, read from stdin
if [ -z "$OUTPUT" ]; then
  OUTPUT=$(cat)
fi

WARNINGS=()

# Check for common error patterns
if echo "$OUTPUT" | grep -qi "HTTP 401\|AuthenticationError\|Unauthorized"; then
  WARNINGS+=("API_AUTH_FAILURE: API key is invalid or expired. Check config.yaml llm.api_key_env.")
fi

if echo "$OUTPUT" | grep -qi "HTTP 429\|RateLimitError\|rate.limit"; then
  WARNINGS+=("RATE_LIMIT: API rate limit hit. Wait 60 seconds before resuming.")
fi

if echo "$OUTPUT" | grep -qi "MemoryError\|OOM\|Killed"; then
  WARNINGS+=("MEMORY: Out of memory. Consider using simulated mode or closing other applications.")
fi

if echo "$OUTPUT" | grep -qi "Docker\|docker.*not.*running\|Cannot connect to the Docker daemon"; then
  WARNINGS+=("DOCKER: Docker issue detected. Run 'docker info' to check Docker status.")
fi

if echo "$OUTPUT" | grep -qi "pdflatex.*not found\|LaTeX Error"; then
  WARNINGS+=("LATEX: LaTeX issue. Run '/researchclaw:setup' to check LaTeX installation.")
fi

if echo "$OUTPUT" | grep -qi "ModuleNotFoundError\|ImportError"; then
  WARNINGS+=("MISSING_MODULE: Python module missing. Run 'pip3 install researchclaw[all]'.")
fi

if echo "$OUTPUT" | grep -qi "quality_score.*below\|quality.*threshold\|gate.*rejected"; then
  WARNINGS+=("QUALITY_GATE: Quality gate rejected. Consider lowering quality.min_score in config.yaml.")
fi

if echo "$OUTPUT" | grep -qi "ConnectionError\|ConnectionRefused\|Network.*unreachable"; then
  WARNINGS+=("NETWORK: Network connectivity issue. Check internet connection and proxy settings.")
fi

# Output warnings if any
if [ ${#WARNINGS[@]} -gt 0 ]; then
  echo ""
  echo "=== ResearchClaw Auto-Diagnosis ==="
  for w in "${WARNINGS[@]}"; do
    echo "  ⚠ $w"
  done
  echo "Run '/researchclaw:diagnose' for detailed troubleshooting."
  echo "==================================="
fi

#!/usr/bin/env bash
# pre-config-write.sh — PreToolUse hook
# Backs up config.yaml before overwriting to prevent accidental data loss

set -euo pipefail

CONFIG="config.yaml"

if [ -f "$CONFIG" ]; then
  TIMESTAMP=$(date +%Y%m%d-%H%M%S)
  BACKUP="${CONFIG}.backup-${TIMESTAMP}"
  cp "$CONFIG" "$BACKUP"
  echo "Backed up existing config.yaml to $BACKUP"
fi

#!/usr/bin/env bash
# pre-delete-guard.sh — PreToolUse hook
# Prevents accidental deletion of pipeline artifacts
# Returns non-zero to block the operation

set -euo pipefail

echo "BLOCKED: Attempted to delete pipeline artifacts."
echo "Pipeline artifacts contain research results that cannot be regenerated without re-running the pipeline."
echo "If you really want to delete artifacts, do it manually outside of Claude Code."
exit 1