From 73e55dc44aa580e03efeac4aa5c5d11c48454b3f Mon Sep 17 00:00:00 2001
From: damocles <damocles@hyperhive>
Date: Sun, 31 May 2026 16:31:46 +0200
Subject: [PATCH] docs(CLAUDE.md): note .bound marker filter on agent_sockets
 (follow-up to #832)

---
 CLAUDE.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 4f4028bd..eb4ff1ba 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -43,6 +43,14 @@ hive-c0re/         host daemon + sibling operator CLI (lib + 2 bins)
   src/agent_sockets.rs  writes `/var/lib/hyperhive/agent-sockets.json` on
                          meta sync; gateway reads name→socket-path
                          map for unix-domain per-agent UI binding (#784).
+                         Entries are filtered by a `.bound` marker file
+                         the harness drops next to its socket after a
+                         successful `bind()` (#832) — pre-bind agents
+                         stay out of the map so the gateway never races
+                         a missing-socket upstream. A 10s poll loop
+                         (`spawn_poll`) re-fires the writer so the map
+                         reconverges if a marker appears between
+                         meta-sync ticks.
   src/agent_server.rs   per-sub-agent socket listener (long-poll Recv)
   src/broker.rs         sqlite Message store + intra-process broadcast
                          channel (`MessageEvent`) for `recv_blocking_batch` +