From 351ffdb3b70c97eadbba1ce9eb839496b2a1f146 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 19:32:42 +0000 Subject: [PATCH] docs: name who calls the safety GenServers, and count lib/ recursively EXPLAINME said Safety.Quarantine and Safety.RateLimiter have no caller in lib/. The application starts both, the Kin watchdog watches the limiter, and the REST and GraphQL APIs list quarantines. The gap is narrower: no scan or dispatch path calls either, and the text now says that. .claude/CLAUDE.md told agents to re-measure with `ls lib/**/*.ex`, which without globstar matches only one directory level (106 files, not the tree). It now uses find, and the count is re-measured: 172. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01CYR5bf5FBLS7cXQK72aVNM --- .claude/CLAUDE.md | 4 ++-- EXPLAINME.adoc | 10 ++++++---- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 544f9285..b2a73b7a 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -6,14 +6,14 @@ Hypatia is the neurosymbolic CI/CD intelligence layer for the hyperpolymath ecos > **Counts in this file are load-bearing — agents act on them.** They were re-measured > against the tree on 2026-08-07. If you change the shape of the system, re-measure -> (`ls lib/**/*.ex | wc -l`, `grep -c "export fn" ffi/zig/src/main.zig`, the child list in +> (`find lib -name "*.ex" | wc -l`, `grep -c "export fn" ffi/zig/src/main.zig`, the child list in > `lib/application.ex`) rather than editing a number by eye. Known-stale claims and the > full audit live in `docs/DEBT-REGISTER.adoc`. ## Architecture ``` -Hypatia # 170 Elixir source files under lib/ (recursive tree count, 2026-11-14) +Hypatia # 172 Elixir source files under lib/ (recursive tree count, 2026-11-16) ├── Elixir pipeline # core: pattern analysis, dispatch, learning ├── Merge orchestration # 12 modules — leases, ledger, ticker (largest subsystem) ├── Kin subsystem # 6 modules — contingency, arbiter, gate, watchdog diff --git a/EXPLAINME.adoc b/EXPLAINME.adoc index d7241a9f..4a8c7693 100644 --- a/EXPLAINME.adoc +++ b/EXPLAINME.adoc @@ -85,8 +85,8 @@ below 0.30) downgrades `auto_execute` to review in link:lib/fleet_dispatcher.ex[] line 267. Caveat:: -That recipe quarantine is not `Hypatia.Safety.Quarantine`, which nothing -calls (<>). The Idris2 model of the update uses natural-number +That recipe quarantine is not `Hypatia.Safety.Quarantine`, which no scan or +dispatch path calls (<>). The Idris2 model of the update uses natural-number pseudo-counts, not Elixir floats. === Machine-checked proofs @@ -249,8 +249,10 @@ for the owner, not a licence change). [CAUTION] ==== -Safety systems are built but not wired. `Safety.RateLimiter` and -`Safety.Quarantine` have no caller in `lib/`. `BatchRollback.rollback/2` is +Safety systems are built but not wired. No scan or dispatch path calls +`Safety.RateLimiter` or `Safety.Quarantine`: the application starts both, the +Kin watchdog watches the limiter, and the REST and GraphQL APIs only list +quarantines (`lib/hypatia/web/api_router.ex`, `lib/hypatia/web/graphql.ex`). `BatchRollback.rollback/2` is reached only through `Kin.Contingency.rollback_wave/2`, which nothing calls. `SelfDiagnostics.record_dispatch_failure/0` and `record_dispatch_success/0` have no callers, so its circuit breaker never opens. The moduledoc of