agent-recon 1.0.1

package/setup.ps1

@@ -0,0 +1,171 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Installs Agent Recon hooks into the user-global Claude Code settings
+    so that ALL Claude Code sessions on this computer are tracked, regardless of
+    which project directory they run from.
+
+.DESCRIPTION
+    1. Copies send-event.py to $HOME\.claude\hooks\
+    2. Auto-detects the Python executable (tries 'python', falls back to 'py')
+    3. Safely MERGES the 13 Agent Recon hook registrations into
+       $HOME\.claude\settings.json -- preserving any hooks you already have.
+    4. Writes the merged result back atomically.
+
+.NOTES
+    Run once from the repo root:  .\setup.ps1
+    Re-run any time to update the hook script or add missing hook entries.
+#>
+
+$ErrorActionPreference = 'Stop'
+
+# -- Paths -------------------------------------------------------------------
+$RepoRoot         = $PSScriptRoot
+$HookSrc          = Join-Path $RepoRoot '.claude\hooks\send-event.py'
+$GlobalHooksDir   = Join-Path $HOME '.claude\hooks'
+$GlobalHookScript = Join-Path $GlobalHooksDir 'send-event.py'
+$GlobalSettings   = Join-Path $HOME '.claude\settings.json'
+
+# -- Detect Python -----------------------------------------------------------
+Write-Host ''
+Write-Host '[SEARCH] Detecting Python executable...' -ForegroundColor Cyan
+$PythonExe = $null
+
+foreach ($candidate in @('python', 'py')) {
+    $found = Get-Command $candidate -ErrorAction SilentlyContinue
+    if ($found) {
+        try {
+            $ver = (& $found.Source --version 2>&1).ToString()
+            if ($ver -match 'Python 3') {
+                $PythonExe = $found.Source
+                Write-Host "  [OK] Found: $PythonExe  ($ver)" -ForegroundColor Green
+                break
+            }
+        } catch { }
+    }
+}
+
+if (-not $PythonExe) {
+    Write-Error "[FAIL] Could not find Python 3. Install Python 3 and ensure 'python' or 'py' is on your PATH."
+    exit 1
+}
+
+# -- Copy / sync hook script --------------------------------------------------
+Write-Host ''
+Write-Host '[COPY] Installing hook script...' -ForegroundColor Cyan
+if (-not (Test-Path $GlobalHooksDir)) {
+    New-Item -ItemType Directory -Path $GlobalHooksDir -Force | Out-Null
+}
+# Drift detection: only copy if the deployed script differs from the repo source
+$needsCopy = $true
+if (Test-Path $GlobalHookScript) {
+    $srcHash = (Get-FileHash $HookSrc    -Algorithm SHA256).Hash
+    $dstHash = (Get-FileHash $GlobalHookScript -Algorithm SHA256).Hash
+    if ($srcHash -eq $dstHash) {
+        $needsCopy = $false
+        Write-Host "  [OK] Hook script already up-to-date: $GlobalHookScript" -ForegroundColor Green
+    }
+}
+if ($needsCopy) {
+    Copy-Item -Path $HookSrc -Destination $GlobalHookScript -Force
+    Write-Host "  [OK] Synced to: $GlobalHookScript" -ForegroundColor Green
+}
+
+# -- Build hook command string -----------------------------------------------
+# Use full absolute paths so the hook fires from any working directory.
+$HookCommand = '"' + $PythonExe + '" "' + $GlobalHookScript + '"'
+
+# -- Load or initialise settings.json ----------------------------------------
+Write-Host ''
+Write-Host "[MERGE] Merging into: $GlobalSettings" -ForegroundColor Cyan
+
+$settings = $null
+if (Test-Path $GlobalSettings) {
+    $raw = Get-Content -Path $GlobalSettings -Raw -Encoding UTF8
+    try {
+        $settings = $raw | ConvertFrom-Json
+    } catch {
+        $backup = $GlobalSettings + '.bak_' + (Get-Date -Format 'yyyyMMdd_HHmmss')
+        Copy-Item $GlobalSettings $backup
+        Write-Host "  [WARN] Could not parse existing settings.json -- backed up to:" -ForegroundColor Yellow
+        Write-Host "         $backup" -ForegroundColor Yellow
+        $settings = $null
+    }
+}
+
+if ($null -eq $settings) {
+    $settings = New-Object PSObject
+}
+
+# Ensure top-level 'hooks' property exists
+if (-not ($settings | Get-Member -Name 'hooks' -MemberType NoteProperty -ErrorAction SilentlyContinue)) {
+    $settings | Add-Member -NotePropertyName 'hooks' -NotePropertyValue (New-Object PSObject)
+}
+
+# -- Events to register ------------------------------------------------------
+$allEvents = @(
+    'SessionStart', 'SessionEnd', 'UserPromptSubmit',
+    'SubagentStart', 'SubagentStop', 'Stop',
+    'TeammateIdle', 'TaskCompleted',
+    'PreToolUse', 'PostToolUse', 'PostToolUseFailure',
+    'Notification', 'PreCompact'
+)
+
+$added   = 0
+$skipped = 0
+
+foreach ($eventName in $allEvents) {
+    $hooksObj = $settings.hooks
+
+    $alreadyPresent = $false
+    if ($hooksObj | Get-Member -Name $eventName -MemberType NoteProperty -ErrorAction SilentlyContinue) {
+        $existing = $hooksObj.$eventName
+        foreach ($group in $existing) {
+            if ($group | Get-Member -Name 'hooks' -MemberType NoteProperty -ErrorAction SilentlyContinue) {
+                foreach ($h in $group.hooks) {
+                    if (($h | Get-Member -Name 'command' -MemberType NoteProperty -ErrorAction SilentlyContinue) -and
+                        $h.command -eq $HookCommand) {
+                        $alreadyPresent = $true
+                        break
+                    }
+                }
+            }
+            if ($alreadyPresent) { break }
+        }
+    }
+
+    if ($alreadyPresent) {
+        $skipped++
+    } else {
+        $newHook  = [PSCustomObject]@{ type = 'command'; command = $HookCommand; async = $true; timeout = 10 }
+        $newGroup = [PSCustomObject]@{ hooks = @($newHook) }
+
+        if ($hooksObj | Get-Member -Name $eventName -MemberType NoteProperty -ErrorAction SilentlyContinue) {
+            # Append to existing list
+            $hooksObj.$eventName = @($hooksObj.$eventName) + @($newGroup)
+        } else {
+            $hooksObj | Add-Member -NotePropertyName $eventName -NotePropertyValue @($newGroup)
+        }
+        $added++
+    }
+}
+
+# -- Write atomically --------------------------------------------------------
+$json = $settings | ConvertTo-Json -Depth 20
+$tmp  = $GlobalSettings + '.tmp'
+[System.IO.File]::WriteAllText($tmp, $json, [System.Text.Encoding]::UTF8)
+Move-Item -Path $tmp -Destination $GlobalSettings -Force
+
+Write-Host "  [OK] Added $added hook(s), skipped $skipped already-present." -ForegroundColor Green
+
+Write-Host ''
+Write-Host '+----------------------------------------------------------+' -ForegroundColor Cyan
+Write-Host '|  Agent Recon -- Global Hooks Installed                    |' -ForegroundColor Cyan
+Write-Host '|                                                          |' -ForegroundColor Cyan
+Write-Host '|  Every Claude Code session on this machine will now      |' -ForegroundColor Cyan
+Write-Host '|  forward events to http://localhost:3131                 |' -ForegroundColor Cyan
+Write-Host '|                                                          |' -ForegroundColor Cyan
+Write-Host '|  Start the server:  cd server ; node start.js            |' -ForegroundColor Cyan
+Write-Host '|  Open dashboard:    http://localhost:3131                |' -ForegroundColor Cyan
+Write-Host '+----------------------------------------------------------+' -ForegroundColor Cyan
+Write-Host ''

package/start-agent-recon.bat

@@ -0,0 +1,4 @@
+@echo off
+cd /d "%~dp0server"
+echo Starting Agent Recon...
+node start.js