Skip to content

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.md
index 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 table
diff --git a/docs/architecture/pr205-hcc-flows.png b/docs/architecture/pr205-hcc-flows.png
index 955e1fe2f..d0bbfa3d7 100644
Binary files a/docs/architecture/pr205-hcc-flows.png and b/docs/architecture/pr205-hcc-flows.png differ
diff --git a/docs/architecture/pr205-hcc-flows.svg b/docs/architecture/pr205-hcc-flows.svg
index 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 () =&gt; false</text>
<text x="230.0" y="326" text-anchor="middle" font-size="11" fill="#475569">/ready = ready &amp;&amp; providerAuthoritativeFn()</text>