From bf027f10b94b9a51c093386176885e6259e8392d Mon Sep 17 00:00:00 2001 From: Dai Ha Date: Thu, 10 Sep 2026 18:13:50 +0700 Subject: [PATCH] #455: document herdr test socket exception --- CLAUDE.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3cbdf43..4b95e43 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -223,6 +223,19 @@ must obey belongs in the charter, not here. - **This repo is the bridge.** The daemon is `fleetd`, its MCP mount is `http://127.0.0.1:8765/mcp`, and the code behind the rules above is `mcp/FleetMcp` (tools), `auth/Authz` (the role table), `mcp/ConnectionIdentity` (connection→role), and `worker/*Launcher` (`REPLY_CHARTER`). +- **Herdr socket tests (measured 2026-09-10).** In this repo, herdr is a subject under test. A + worker assigned to herdr code, and the lead, may let a test open the herdr socket directly in a + throwaway workspace that the test tears down. This only covers + `fleetd/src/test/java/dev/ltms/fleet/herdr/AgentControlContractTest.java`, + `fleetd/src/test/java/dev/ltms/fleet/herdr/HerdrContractTest.java`, + `fleetd/src/test/java/dev/ltms/fleet/herdr/PaneLocatorContractTest.java`, and + `fleetd/src/test/java/dev/ltms/fleet/herdr/WorkspacePlacementContractTest.java`. It is not a + general licence. Using the herdr CLI or socket to move a real fleet session, pane, or peer stays + banned. That is the control plane that invariant 5 protects. Re-measure with + `grep -rl 'UnixSocketHerdrClient.connect()' fleetd/src/test/java --include='*.java'`. A non-empty + result means tests still open the socket and this note still applies. An empty result means nobody + does this any more; delete this section. Canonical invariant 5 restatement is tracked in #458 and + is not part of this change. - **`fleet_profiles`/`fleet_list` report two separate outage states, and they are not the same thing.** *Quarantined* (CB-578) means the backend told us it is out of capacity — a long, 1800s-default cooldown. *Cooling off* (fleetd #201/#227) means a profile's credential threw two -- 2.52.0