#!/bin/bash # Continuous Learning v2 - Observation Hook # # Captures tool use events for pattern analysis. # Claude Code passes hook data via stdin as JSON. # # Hook config (in ~/claude/settings.json): # # If installed as a plugin, use ${CLAUDE_PLUGIN_ROOT}: # { # "hooks": { # "PreToolUse": [{ # "matcher": "*", # "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh pre" }] # }], # "PostToolUse": [{ # "matcher": "*", # "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh post" }] # }] # } # } # # If installed manually to ~/claude/skills: # { # "hooks": { # "PreToolUse": [{ # "matcher": "*", # "hooks": [{ "type": "command", "command": "~/claude/skills/continuous-learning-v2/hooks/observe.sh pre" }] # }], # "PostToolUse": [{ # "matcher": "*", # "hooks": [{ "type": "command", "command": "~/claude/skills/continuous-learning-v2/hooks/observe.sh post" }] # }] # } # } set -e # Hook phase from CLI argument: "pre" (PreToolUse) or "post" (PostToolUse) HOOK_PHASE="${1:-post}" CONFIG_DIR="${HOME}/.claude/homunculus" OBSERVATIONS_FILE="${CONFIG_DIR}/observations.jsonl" MAX_FILE_SIZE_MB=10 # Ensure directory exists mkdir -p "$CONFIG_DIR" # Skip if disabled if [ -f "$CONFIG_DIR/disabled" ]; then exit 0 fi # Read JSON from stdin (Claude Code hook format) INPUT_JSON=$(cat) # Exit if no input if [ -z "$INPUT_JSON" ]; then exit 0 fi # Parse using python via stdin pipe (safe for all JSON payloads) # Pass HOOK_PHASE via env var since Claude Code does not include hook type in stdin JSON PARSED=$(echo "$INPUT_JSON" | HOOK_PHASE="$HOOK_PHASE" python3 -c ' import json import sys import os try: data = json.load(sys.stdin) # Determine event type from CLI argument passed via env var. # Claude Code does NOT include a "hook_type" field in the stdin JSON, # so we rely on the shell argument ("pre" or "post") instead. hook_phase = os.environ.get("HOOK_PHASE", "post") event = "tool_start" if hook_phase == "pre" else "tool_complete" # Extract fields - Claude Code hook format tool_name = data.get("tool_name", data.get("tool", "unknown")) tool_input = data.get("tool_input", data.get("input", {})) tool_output = data.get("tool_output", data.get("output", "")) session_id = data.get("session_id", "unknown") # Truncate large inputs/outputs if isinstance(tool_input, dict): tool_input_str = json.dumps(tool_input)[:5000] else: tool_input_str = str(tool_input)[:5000] if isinstance(tool_output, dict): tool_output_str = json.dumps(tool_output)[:5000] else: tool_output_str = str(tool_output)[:5000] print(json.dumps({ "parsed": True, "event": event, "tool": tool_name, "input": tool_input_str if event == "tool_start" else None, "output": tool_output_str if event == "tool_complete" else None, "session": session_id })) except Exception as e: print(json.dumps({"parsed": False, "error": str(e)})) ') # Check if parsing succeeded PARSED_OK=$(echo "$PARSED" | python3 -c "import json,sys; print(json.load(sys.stdin).get('parsed', False))") if [ "$PARSED_OK" != "True" ]; then # Fallback: log raw input for debugging timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ") export TIMESTAMP="$timestamp" echo "$INPUT_JSON" | python3 -c " import json, sys, os raw = sys.stdin.read()[:2000] print(json.dumps({'timestamp': os.environ['TIMESTAMP'], 'event': 'parse_error', 'raw': raw})) " >> "$OBSERVATIONS_FILE" exit 0 fi # Archive if file too large if [ -f "$OBSERVATIONS_FILE" ]; then file_size_mb=$(du -m "$OBSERVATIONS_FILE" 2>/dev/null | cut -f1) if [ "${file_size_mb:-0}" -ge "$MAX_FILE_SIZE_MB" ]; then archive_dir="${CONFIG_DIR}/observations.archive" mkdir -p "$archive_dir" mv "$OBSERVATIONS_FILE" "$archive_dir/observations-$(date +%Y%m%d-%H%M%S).jsonl" fi fi # Build and write observation timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ") export TIMESTAMP="$timestamp" echo "$PARSED" | python3 -c " import json, sys, os parsed = json.load(sys.stdin) observation = { 'timestamp': os.environ['TIMESTAMP'], 'event': parsed['event'], 'tool': parsed['tool'], 'session': parsed['session'] } if parsed['input'] is not None: observation['input'] = parsed['input'] if parsed['output'] is not None: observation['output'] = parsed['output'] print(json.dumps(observation)) " >> "$OBSERVATIONS_FILE" # Signal observer if running OBSERVER_PID_FILE="${CONFIG_DIR}/.observer.pid" if [ -f "$OBSERVER_PID_FILE" ]; then observer_pid=$(cat "$OBSERVER_PID_FILE") if kill -0 "$observer_pid" 2>/dev/null; then kill -USR1 "$observer_pid" 2>/dev/null || true fi fi exit 0