Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
docs(hcc): record the required-isCurrent authority fence (J3) in the design note + diagram
Alfredo Lopez4e94174a1e3e
diff --git a/docs/architecture/hcc-readiness-flows.md b/docs/architecture/hcc-readiness-flows.mdindex 5618ab592..6a4e89ca9 100644--- a/docs/architecture/hcc-readiness-flows.md+++ b/docs/architecture/hcc-readiness-flows.md@@ -33,9 +33,12 @@ full convergence:| Readiness gate | `/ready = ready && providerAuthoritativeFn()`; constructor default `() => false`; a throwing gate → 503 | `server.ts`, `readinessGate.ts` || G1 — unconfigured authority | `currentWhenUnconfigured()` returns `false` + warns once; prod always wires the source, dev never constructs the reconciler | `reconciler.ts` || F1 — readiness-poll rebind | rebinds `isCurrent`/`server` on a superseding reconcile so the poll window does not self-destruct on a stale fence | `reconciler.ts` |+| Authority fence — `isCurrent` | **required** (not an optional/defaulted arg) on all three allow-granting reconcilers — `bindingPolicyReconciler`, `reconcileContext` (L2 context-allow), `reconcileExternalEgress` (L3 external-egress ALLOW). No `?? (() => true)` fail-open default: a caller cannot compile without supplying the fence (TS2554/TS2345) | `networkPolicyReconciler.ts`, `bindingPolicyReconciler.ts` |-The affirmative literal (`() => true`) is reachable only from the dev wiring; every-production path resolves the real authority function.+The affirmative literal (`() => true`) is reachable only from the dev/test wiring;+every production path resolves the real authority function, and — because the fence+is a **required argument** on every allow-granting reconciler rather than a defaulted+option — no production caller can silently fall back to it.## 3. DNS external-egress contract (B3) — retain / revoke decision tablediff --git a/docs/architecture/pr205-hcc-flows.png b/docs/architecture/pr205-hcc-flows.pngindex 955e1fe2f..d0bbfa3d7 100644Binary files a/docs/architecture/pr205-hcc-flows.png and b/docs/architecture/pr205-hcc-flows.png differdiff --git a/docs/architecture/pr205-hcc-flows.svg b/docs/architecture/pr205-hcc-flows.svgindex 082622f27..adb22120f 100644--- a/docs/architecture/pr205-hcc-flows.svg+++ b/docs/architecture/pr205-hcc-flows.svg@@ -49,7 +49,7 @@<line x1="993.5" y1="150.0" x2="1026.0" y2="150.0" stroke="#64748b" stroke-width="2.4" stroke-dasharray="6,4" marker-end="url(#aGray)" stroke-linecap="round"/><rect x="946.15" y="130.0" width="127.2" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/><text x="1009.75" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#475569">async · post-ready</text>-<text x="40" y="275" font-size="13" font-weight="700" fill="#b91c1c">2 · Fences fail-closed (rondas R3 / R4)</text>+<text x="40" y="275" font-size="13" font-weight="700" fill="#b91c1c">2 · Fences fail-closed (R3 · R4 · J3)</text><rect x="40.0" y="284" width="380.0" height="76" rx="11" fill="#fef2f2" stroke="#dc2626" stroke-width="1.8" filter="url(#sh)"/><text x="230.0" y="307" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Readiness gate — default () => false</text><text x="230.0" y="326" text-anchor="middle" font-size="11" fill="#475569">/ready = ready && providerAuthoritativeFn()</text>