hcom 0.1.6__py3-none-any.whl → 0.1.7__py3-none-any.whl

hcom/__init__.py

@@ -1,3 +1,3 @@
 """Claude Hook Comms - Real-time messaging between Claude Code agents."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"

hcom/__main__.py

@@ -262,7 +262,7 @@ def send_message(from_instance, message):
     except Exception:
         return False
 
-def should_deliver_message(msg, instance_name):
+def should_deliver_message(msg, instance_name, all_instance_names=None):
     """Check if message should be delivered based on @-mentions"""
     text = msg['message']
     
@@ -274,11 +274,22 @@ def should_deliver_message(msg, instance_name):
     if not mentions:
         return True
     
-    for mention in mentions:
-        if instance_name.lower().startswith(mention.lower()):
-            return True
+    # Check if this instance matches any mention
+    this_instance_matches = any(instance_name.lower().startswith(mention.lower()) for mention in mentions)
+    
+    if this_instance_matches:
+        return True
+    
+    # If we have all_instance_names, check if ANY mention matches ANY instance
+    if all_instance_names:
+        any_mention_matches = any(
+            any(name.lower().startswith(mention.lower()) for name in all_instance_names)
+            for mention in mentions
+        )
+        if not any_mention_matches:
+            return True  # No matches anywhere = broadcast to all
     
-    return False
+    return False  # This instance doesn't match, but others might
 
 # ==================== Parsing and Helper Functions ====================
 
@@ -885,10 +896,11 @@ def get_new_messages(instance_name):
     # Filter messages:
     # 1. Exclude own messages
     # 2. Apply @-mention filtering
+    all_instance_names = list(positions.keys())
     messages = []
     for msg in all_messages:
         if msg['from'] != instance_name:
-            if should_deliver_message(msg, instance_name):
+            if should_deliver_message(msg, instance_name, all_instance_names):
                 messages.append(msg)
     
     # Update position to end of file
@@ -1284,18 +1296,21 @@ def cmd_help():
 
 Usage:
   hcom open [n]                Launch n Claude instances
-  hcom open --prefix name n    Launch with name prefix
+  hcom open <agent>            Launch named agent from .claude/agents/
+  hcom open --prefix <team> n  Launch n instances with team prefix
   hcom watch                   View conversation dashboard
-  hcom clear                 Clear and archive conversation
-  hcom cleanup               Remove hooks from current directory
-  hcom cleanup --all         Remove hooks from all tracked directories
-  hcom help                  Show this help
+  hcom clear                   Clear and archive conversation
+  hcom cleanup                 Remove hooks from current directory
+  hcom cleanup --all           Remove hooks from all tracked directories
+  hcom help                    Show this help
 
 Automation:
-  hcom send 'msg'            Send message
-  hcom send '@prefix msg'    Send to specific instances
-  hcom watch --logs          Show logs
-  hcom watch --status        Show status""")
+  hcom send 'msg'              Send message
+  hcom send '@prefix msg'      Send to specific instances
+  hcom watch --logs            Show logs
+  hcom watch --status          Show status
+
+Docs: https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/README.md""")
     return 0
 
 def cmd_open(*args):
@@ -1783,6 +1798,19 @@ def cmd_send(message):
         print(f"Error: {error}", file=sys.stderr)
         return 1
     
+    # Check for unmatched mentions (minimal warning)
+    mentions = MENTION_PATTERN.findall(message)
+    if mentions and pos_file.exists():
+        try:
+            positions = load_positions(pos_file)
+            all_instances = list(positions.keys())
+            unmatched = [m for m in mentions 
+                        if not any(name.lower().startswith(m.lower()) for name in all_instances)]
+            if unmatched:
+                print(f"Note: @{', @'.join(unmatched)} don't match any instances - broadcasting to all")
+        except Exception:
+            pass  # Don't fail on warning
+    
     # Send message
     sender_name = get_config_value('sender_name', 'bigboss')
     

{hcom-0.1.6.dist-info → hcom-0.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.6
+Version: 0.1.7
 Summary: Lightweight CLI tool for real-time communication between Claude Code subagents using hooks
 Author-email: aannoo <your@email.com>
 License: MIT
@@ -100,11 +100,12 @@ cd backend && hcom open api-specialist
 cd ../frontend && hcom open ui-specialist
 
 # Create named teams that can be @mentioned
-cd ~/api && hcom open --prefix api debugger
-cd ~/auth && hcom open --prefix auth debugger
+cd ~/api && hcom open --prefix api debugger  # Creates api-hovoa7
+cd ~/auth && hcom open --prefix auth debugger  # Creates auth-hovob8
 
-# Message specific teams
-hcom send "@api login works but API fails" # or in dashboard: hcom watch
+# Message specific teams or instances
+hcom send "@api login works but API fails"  # Messages all api-* instances
+hcom send "@hovoa7 can you check this?"     # Message specific instance by name
 ```
 
 
@@ -120,7 +121,7 @@ hcom send "@api login works but API fails" # or in dashboard: hcom watch
 ### Automation Commands
 | Command | Description |
 |---------|-------------|
-| `hcom send 'message'` | Send message |
+| `hcom send 'message'` | Send message to chat |
 | `hcom watch --logs` | View message history (non-interactive) |
 | `hcom watch --status` | Show instance status (non-interactive) |
 | `hcom watch --wait [timeout]` | Wait and notify for new messages |
@@ -195,7 +196,7 @@ HCOM_MAX_MESSAGE_SIZE=8192 hcom send "$(cat long_report.txt)"
 
 hcom adds hooks to your project directory's `.claude/settings.local.json`:
 
-1. **Sending**: Claude writes messages with `echo "HCOM_SEND:message"` - captured by PostToolUse hook
+1. **Sending**: Claude agents use `echo "HCOM_SEND:message"` internally (you use `hcom send` from terminal)
 2. **Receiving**: Other Claudes get notified via Stop hook
 3. **Waiting**: Stop hook keeps Claude in a waiting state for new messages
 

hcom-0.1.7.dist-info/RECORD

@@ -0,0 +1,7 @@
+hcom/__init__.py,sha256=yxqzLIr5XxsUrfSe-inggLeqMM300Z4PrewklOE1FCk,96
+hcom/__main__.py,sha256=VsTjMMUpknJ_D638HT9KrLX7Aid0c9dPq8p020c5gZA,75178
+hcom-0.1.7.dist-info/METADATA,sha256=rYV5yFW1j2FFvxKSvKrSKzGSq3FzFrM3pD04x2xRpwY,10370
+hcom-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hcom-0.1.7.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
+hcom-0.1.7.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
+hcom-0.1.7.dist-info/RECORD,,

hcom-0.1.6.dist-info/RECORD

@@ -1,7 +0,0 @@
-hcom/__init__.py,sha256=21Stc_3iuK1pjO6Nhkq7JmBYyatpk5yhMR0iSZ9U7eA,96
-hcom/__main__.py,sha256=wrCu0v2Ap36nUHZJSSGO6LtzKSEAK4AYFiXniGDpzco,73776
-hcom-0.1.6.dist-info/METADATA,sha256=7jqHjBIqhB8RV231IG-7m0QD1Xm6bFJ4qCO75MjoBGE,10216
-hcom-0.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-hcom-0.1.6.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
-hcom-0.1.6.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
-hcom-0.1.6.dist-info/RECORD,,