claude-comms 1.0.11 → 1.0.13

package/.claude/agents/session-review.md

@@ -6,7 +6,6 @@ color: purple
 model: opus
 ---
 
-persona
 
 You are an elite Behavioral Session Analyst specializing in multi-agent conversation dynamics and intent alignment analysis. You forensically examine the message history between users, orchestrators, and agents to understand behavioral patterns, communication breakdowns, and deviations from intended outcomes.
 
@@ -25,7 +24,7 @@ Your core competencies:
 
 You approach each session as a behavioral investigator, seeking to understand not just WHAT happened, but WHY agents behaved as they did. Your analysis reveals the human and artificial cognitive patterns that shape multi-agent collaboration outcomes.
 
-/persona
+Adhere to Response Format when you respond with with your behavioral forensics report.
 
 You must manage and maintain Todos dynamically, refine Todos after every decision, and when new information presents itself.
 Populate your initial Todos with your step by step WORKFLOW:
@@ -89,30 +88,13 @@ INGEST -> ANALYSE -> REPORT
    - Show how proper communication would have prevented deviation
    - Identify where clarifying questions should have been asked
 
-# REPORT:
-**Generate Behavioral Analysis Report** (NO files created - response only):
-   - Executive summary of deviations from user intent
-   - Specific actors and messages that caused deviations
-   - Root cause behavioral analysis for each deviation
-   - Message correction suggestions
-   - Verification of actual vs claimed changes
-
-COMPLETION GATE: Behavioral Analysis Checklist:
-□ Session ID retrieved and all pages of data fetched
-□ Every message in conversation flow analyzed chronologically
-□ Specific deviations identified with actor names and exact quotes
-□ Root cause traced for each deviation (WHY it happened)
-□ Git status and file verification performed for truth check
-□ Behavioral patterns and biases identified
-□ Message corrections suggested (what SHOULD have been said)
-□ NO documentation files created (report in response only)
-□ Gaps in understanding acknowledged with confidence levels
 
 [/WORKFLOW]
 
-# Response Format
 
-When your analysis is complete, provide a behavioral forensics report:
+
+
+# Response Format
 
 ## Executive Summary
 Brief overview of deviations from user intent, key actors involved, and critical behavioral patterns identified.
@@ -237,6 +219,7 @@ Brief overview of deviations from user intent, key actors involved, and critical
 ### Low Confidence / Speculation [<60%]
 - [Possible pattern but needs more data]
 
+
 ### Data Gaps
 - Would benefit from: [Additional information needed]
 - Could not determine: [What remains unclear]

package/.claude/hooks/comms/get_unread_messages.py

@@ -4,6 +4,9 @@ import json
 import sys
 import requests
 import argparse
+import os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
 
 def get_unread_messages(subagent_name):
     """
@@ -17,7 +20,7 @@ def get_unread_messages(subagent_name):
     """
     try:
         response = requests.post(
-            'http://localhost:4000/subagents/unread',
+            f'{get_server_url()}/subagents/unread',
             json={
                 'subagent_name': subagent_name
             },
@@ -32,7 +35,7 @@ def get_unread_messages(subagent_name):
             return []
             
     except requests.exceptions.ConnectionError:
-        print("Error: Could not connect to observability server at localhost:4000", file=sys.stderr)
+        print(f"Error: Could not connect to observability server at {get_server_url()}", file=sys.stderr)
         return []
     except requests.exceptions.Timeout:
         print("Error: Request timed out", file=sys.stderr)

package/.claude/hooks/comms/register_subagent.py

@@ -9,6 +9,9 @@
 import json
 import sys
 import requests
+import os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
 
 
 def main():
@@ -34,7 +37,7 @@ def main():
                 # Register the subagent with the server
                 try:
                     response = requests.post(
-                        'http://localhost:4000/subagents/register',
+                        f'{get_server_url()}/subagents/register',
                         json={
                             'session_id': session_id,
                             'name': nickname,
@@ -48,7 +51,7 @@ def main():
                         # Now update with initial prompt using PATCH endpoint
                         if initial_prompt:
                             prompt_response = requests.patch(
-                                f'http://localhost:4000/subagents/{session_id}/{nickname}',
+                                f'{get_server_url()}/subagents/{session_id}/{nickname}',
                                 json={'initial_prompt': initial_prompt},
                                 timeout=2
                             )

package/.claude/hooks/comms/send_message.py

@@ -4,6 +4,9 @@ import json
 import sys
 import requests
 import argparse
+import os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
 
 def send_message(sender_name, message):
     """
@@ -26,7 +29,7 @@ def send_message(sender_name, message):
                 pass
         
         response = requests.post(
-            'http://localhost:4000/subagents/message',
+            f'{get_server_url()}/subagents/message',
             json={
                 'sender': sender_name,
                 'message': message
@@ -41,7 +44,7 @@ def send_message(sender_name, message):
             return False
             
     except requests.exceptions.ConnectionError:
-        print("Error: Could not connect to observability server at localhost:4000", file=sys.stderr)
+        print(f"Error: Could not connect to observability server at {get_server_url()}", file=sys.stderr)
         return False
     except requests.exceptions.Timeout:
         print("Error: Request timed out", file=sys.stderr)

package/.claude/hooks/comms/update_subagent_completion.py

@@ -9,6 +9,9 @@
 import json
 import sys
 import requests
+import os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
 
 
 def main():
@@ -86,7 +89,7 @@ def main():
                 # Update subagent completion status
                 try:
                     response = requests.post(
-                        'http://localhost:4000/subagents/update-completion',
+                        f'{get_server_url()}/subagents/update-completion',
                         json={
                             'session_id': session_id,
                             'name': agent_name,

package/.claude/hooks/observability/send_event.py

@@ -16,8 +16,15 @@ import urllib.request
 import urllib.error
 from datetime import datetime
 
-def send_event_to_server(event_data, server_url='http://localhost:4000/events'):
+# Add parent directory to path for imports
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
+
+def send_event_to_server(event_data, server_url=None):
     """Send event data to the observability server."""
+    if server_url is None:
+        server_url = f'{get_server_url()}/events'
+    
     try:
         # Prepare the request
         req = urllib.request.Request(
@@ -49,7 +56,6 @@ def main():
     parser = argparse.ArgumentParser(description='Send Claude Code hook events to observability server')
     parser.add_argument('--source-app', required=True, help='Source application name')
     parser.add_argument('--event-type', required=True, help='Hook event type (PreToolUse, PostToolUse, etc.)')
-    parser.add_argument('--server-url', default='http://localhost:4000/events', help='Server URL')
     parser.add_argument('--add-chat', action='store_true', help='Include chat transcript if available')
     parser.add_argument('--summarize', action='store_true', help='Generate AI summary of the event')
     
@@ -94,7 +100,8 @@ def main():
     
     
     # Send to server
-    success = send_event_to_server(event_data, args.server_url)
+    server_url = f'{get_server_url()}/events'
+    success = send_event_to_server(event_data, server_url)
     
     # Always exit with 0 to not block Claude Code operations
     sys.exit(0)

package/.claude/hooks/session-data/get_session_data.py

@@ -14,6 +14,9 @@ import sys
 import argparse
 import requests
 import time
+import os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+from utils.server_config import get_server_url
 
 # Maximum tokens per page (easily configurable)
 MAX_TOKENS_PER_PAGE = 6000
@@ -170,12 +173,6 @@ def main():
         help='Return only the total number of pages instead of page data'
     )
     
-    parser.add_argument(
-        '--api-base',
-        default='http://localhost:4000',
-        help='Base API URL (default: http://localhost:4000)'
-    )
-    
     args = parser.parse_args()
     
     # Wait 100ms per page before hitting the DB (as requested)
@@ -184,7 +181,8 @@ def main():
     
     try:
         # Fetch the data from API
-        url = f"{args.api_base}/api/sessions/{args.session_id}/introspect"
+        api_base = get_server_url()
+        url = f"{api_base}/api/sessions/{args.session_id}/introspect"
         response = requests.get(url, timeout=10)
         
         if response.status_code == 200:
@@ -234,8 +232,9 @@ def main():
             sys.exit(1)
             
     except requests.exceptions.ConnectionError:
+        api_base = get_server_url()
         error_data = {
-            'error': f'Could not connect to API server at {args.api_base}',
+            'error': f'Could not connect to API server at {api_base}',
             'status_code': 0
         }
         print(json.dumps(error_data, indent=2), file=sys.stderr)

package/.claude/hooks/utils/server_config.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+"""
+Utility module to get the communication server URL from environment variable.
+Falls back to default if not set.
+"""
+
+import os
+
+def get_server_url():
+    """
+    Get the communication server URL from CLAUDE_COMMS_SERVER environment variable.
+    Falls back to http://localhost:4000 if not set.
+    
+    Returns:
+        str: The server URL
+    """
+    return os.environ.get('CLAUDE_COMMS_SERVER', 'http://localhost:4000')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-comms",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "NPX installer for Claude Code hooks and observability setup",
   "main": "src/index.js",
   "bin": {