Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(hcc): translate readiness diagrams to English and retarget to #382

Alfredo Lopezf4ade3b55275
diff --git a/docs/architecture/hcc-readiness-before-after.png b/docs/architecture/hcc-readiness-before-after.png
new file mode 100644
index 000000000..4db29ccfd
Binary files /dev/null and b/docs/architecture/hcc-readiness-before-after.png differ
diff --git a/docs/architecture/pr205-before-after.svg b/docs/architecture/hcc-readiness-before-after.svg
similarity index 94%
rename from docs/architecture/pr205-before-after.svg
rename to docs/architecture/hcc-readiness-before-after.svg
index 471f74cc3..b1e34db1c 100644
--- a/docs/architecture/pr205-before-after.svg
+++ b/docs/architecture/hcc-readiness-before-after.svg
@@ -8,12 +8,12 @@
</defs>
<style>text{font-family:Helvetica,Arial,sans-serif;}</style>
<rect x="0" y="0" width="1620" height="880" rx="0" fill="#ffffff" stroke="#ffffff" stroke-width="0" opacity="1.0"/>
-<text x="810.0" y="46" font-size="27" fill="#0f172a" font-weight="700" text-anchor="middle">PR #205 — Decoupling HCC readiness: before vs after</text>
-<text x="810.0" y="76" font-size="15" fill="#475569" font-weight="400" text-anchor="middle">The Host Context Controller's /ready endpoint stops waiting for full fleet convergence</text>
+<text x="810.0" y="46" font-size="27" fill="#0f172a" font-weight="700" text-anchor="middle">#382 — Decoupling HCC readiness: before vs after</text>
+<text x="810.0" y="76" font-size="15" fill="#475569" font-weight="400" text-anchor="middle">The HCC /ready stops waiting for fleet convergence — certified by CONTENT identity (desired revision), not CHANNEL identity (watch generation)</text>
<rect x="30" y="100" width="760" height="660" rx="18" fill="#fff7f6" stroke="#fecaca" stroke-width="2" opacity="1.0"/>
<rect x="830" y="100" width="760" height="660" rx="18" fill="#f5fbf7" stroke="#bbf7d0" stroke-width="2" opacity="1.0"/>
<text x="410" y="136" font-size="19" fill="#dc2626" font-weight="700" text-anchor="middle">BEFORE · origin/dev (issue #204)</text>
-<text x="1210" y="136" font-size="19" fill="#16a34a" font-weight="700" text-anchor="middle">AFTER · PR #205</text>
+<text x="1210" y="136" font-size="19" fill="#16a34a" font-weight="700" text-anchor="middle">AFTER · this PR (#382)</text>
<rect x="100.0" y="168" width="600" height="58" rx="12" fill="#dbeafe" stroke="#2563eb" stroke-width="2" opacity="1.0"/>
<text x="400" y="201.64" font-size="16" fill="#0f172a" font-weight="700" text-anchor="middle">HCC starts — 4 watch lanes</text>
<line x1="400" y1="226" x2="400" y2="279" stroke="#dc2626" stroke-width="3" marker-end="url(#arr_dc2626)"/>
@@ -59,7 +59,7 @@
<text x="1462" y="405" font-size="11" fill="#2563eb" font-weight="700" text-anchor="middle">B3 retain / revoke</text>
<rect x="1358.0" y="421" width="208.0" height="22" rx="7" fill="#ffffff" stroke="#2563eb" stroke-width="1.4" opacity="1.0"/>
<text x="1462" y="437" font-size="11" fill="#2563eb" font-weight="700" text-anchor="middle">single-writer Recreate·1</text>
-<text x="1150" y="700" font-size="14" fill="#16a34a" font-weight="700" text-anchor="middle" font-style="italic">Readiness DECOUPLED: gated on the safety barrier, not the fleet</text>
+<text x="1150" y="700" font-size="14" fill="#16a34a" font-weight="700" text-anchor="middle" font-style="italic">DECOUPLED: gated on the safety barrier · anchored to desired revision, survives GKE watch-churn</text>
<rect x="300" y="812" width="26" height="20" rx="5" fill="#dbeafe" stroke="#2563eb" stroke-width="2" opacity="1.0"/>
<text x="336" y="827" font-size="14" fill="#0f172a" font-weight="400" text-anchor="start">Startup step</text>
<rect x="506" y="812" width="26" height="20" rx="5" fill="#fee2e2" stroke="#dc2626" stroke-width="2" opacity="1.0"/>
diff --git a/docs/architecture/hcc-readiness-flows-diagram.png b/docs/architecture/hcc-readiness-flows-diagram.png
new file mode 100644
index 000000000..207ba04b0
Binary files /dev/null and b/docs/architecture/hcc-readiness-flows-diagram.png differ
diff --git a/docs/architecture/pr205-hcc-flows.svg b/docs/architecture/hcc-readiness-flows-diagram.svg
similarity index 81%
rename from docs/architecture/pr205-hcc-flows.svg
rename to docs/architecture/hcc-readiness-flows-diagram.svg
index adb22120f..db0985b89 100644
--- a/docs/architecture/pr205-hcc-flows.svg
+++ b/docs/architecture/hcc-readiness-flows-diagram.svg
@@ -9,118 +9,118 @@
<filter id="sh" x="-5%" y="-6%" width="110%" height="122%"><feDropShadow dx="0" dy="1.5" stdDeviation="1.8" flood-color="#0f172a" flood-opacity="0.16"/></filter>
</defs>
<rect width="1280" height="880" fill="#ffffff"/>
-<text x="40" y="36" font-size="20" font-weight="800" fill="#0f172a">host-context-controller — flujos que resuelve el PR #205</text>
-<text x="40" y="57" font-size="12.5" fill="#64748b">decouple readiness from initial fleet convergence · seguridad fail-closed · gobernanza single-writer de NetworkPolicy</text>
-<text x="40" y="92" font-size="13" font-weight="700" fill="#1d4ed8">1 · Lifecycle de readiness — DESACOPLADO de la convergencia de la flota</text>
+<text x="40" y="36" font-size="20" font-weight="800" fill="#0f172a">host-context-controller — flows resolved by this PR (#382)</text>
+<text x="40" y="57" font-size="12.5" fill="#64748b">decouple readiness from initial fleet convergence · fail-closed safety · single-writer NetworkPolicy governance</text>
+<text x="40" y="92" font-size="13" font-weight="700" fill="#1d4ed8">1 · Readiness lifecycle — DECOUPLED from fleet convergence</text>
<rect x="40.0" y="104" width="214" height="92" rx="11" fill="#eff6ff" stroke="#2563eb" stroke-width="1.8" filter="url(#sh)"/>
<text x="147.0" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">HCC start</text>
-<text x="147.0" y="146" text-anchor="middle" font-size="11" fill="#475569">4 watch lanes arrancan;</text>
-<text x="147.0" y="162" text-anchor="middle" font-size="11" fill="#475569">una lane que falla → recovery</text>
-<text x="147.0" y="178" text-anchor="middle" font-size="11" fill="#475569">in-process, NO mata el proceso</text>
+<text x="147.0" y="146" text-anchor="middle" font-size="11" fill="#475569">4 watch lanes start; a failing</text>
+<text x="147.0" y="162" text-anchor="middle" font-size="11" fill="#475569">lane → in-process recovery</text>
+<text x="147.0" y="178" text-anchor="middle" font-size="11" fill="#475569">— does NOT kill the process</text>
<rect x="286.5" y="104" width="214" height="92" rx="11" fill="#eff6ff" stroke="#2563eb" stroke-width="1.8" filter="url(#sh)"/>
<text x="393.5" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">4-LIST inventory</text>
<text x="393.5" y="146" text-anchor="middle" font-size="11" fill="#475569">Context ingress · mcp-host</text>
<text x="393.5" y="162" text-anchor="middle" font-size="11" fill="#475569">egress · rpc-proxy egress</text>
<text x="393.5" y="178" text-anchor="middle" font-size="11" fill="#475569">· external egress</text>
<rect x="533.0" y="104" width="214" height="92" rx="11" fill="#eff6ff" stroke="#2563eb" stroke-width="1.8" filter="url(#sh)"/>
-<text x="640.0" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Certificar safety inventory</text>
-<text x="640.0" y="146" text-anchor="middle" font-size="11" fill="#475569">revoca allows stale/</text>
-<text x="640.0" y="162" text-anchor="middle" font-size="11" fill="#475569">improbables ANTES de</text>
-<text x="640.0" y="178" text-anchor="middle" font-size="11" fill="#475569">certificar (fail-closed)</text>
+<text x="640.0" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Certify safety inventory</text>
+<text x="640.0" y="146" text-anchor="middle" font-size="11" fill="#475569">revokes stale/unprovable allows</text>
+<text x="640.0" y="162" text-anchor="middle" font-size="11" fill="#475569">BEFORE certifying (fail-closed)</text>
+<text x="640.0" y="178" text-anchor="middle" font-size="11" fill="#475569">· anchored to desired revision</text>
<rect x="779.5" y="104" width="214" height="92" rx="11" fill="#dbeafe" stroke="#1d4ed8" stroke-width="1.8" filter="url(#sh)"/>
<text x="886.5" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">/ready = 200</text>
-<text x="886.5" y="146" text-anchor="middle" font-size="11" fill="#475569">solo si el inventory está</text>
-<text x="886.5" y="162" text-anchor="middle" font-size="11" fill="#475569">certificado y ningún allow</text>
-<text x="886.5" y="178" text-anchor="middle" font-size="11" fill="#475569">stale sobrevive</text>
+<text x="886.5" y="146" text-anchor="middle" font-size="11" fill="#475569">only if inventory certified</text>
+<text x="886.5" y="162" text-anchor="middle" font-size="11" fill="#475569">and no stale allow</text>
+<text x="886.5" y="178" text-anchor="middle" font-size="11" fill="#475569">survives</text>
<rect x="1026.0" y="104" width="214" height="92" rx="11" fill="#eff6ff" stroke="#2563eb" stroke-width="1.8" filter="url(#sh)"/>
<text x="1133.0" y="127" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Additive convergence</text>
-<text x="1133.0" y="146" text-anchor="middle" font-size="11" fill="#475569">la flota converge DESPUÉS</text>
-<text x="1133.0" y="162" text-anchor="middle" font-size="11" fill="#475569">del ready — asíncrono,</text>
-<text x="1133.0" y="178" text-anchor="middle" font-size="11" fill="#475569">sin bloquearlo</text>
+<text x="1133.0" y="146" text-anchor="middle" font-size="11" fill="#475569">fleet converges AFTER</text>
+<text x="1133.0" y="162" text-anchor="middle" font-size="11" fill="#475569">ready — async,</text>
+<text x="1133.0" y="178" text-anchor="middle" font-size="11" fill="#475569">non-blocking</text>
<line x1="254.0" y1="150.0" x2="286.5" y2="150.0" stroke="#2563eb" stroke-width="2.6" marker-end="url(#aBlue)" stroke-linecap="round"/>
<rect x="229.05" y="130.0" width="82.4" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
-<text x="270.25" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#1e293b">inventariar</text>
+<text x="270.25" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#1e293b">inventory</text>
<line x1="500.5" y1="150.0" x2="533.0" y2="150.0" stroke="#2563eb" stroke-width="2.6" marker-end="url(#aBlue)" stroke-linecap="round"/>
<rect x="478.75" y="130.0" width="76.0" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
-<text x="516.75" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#1e293b">certificar</text>
+<text x="516.75" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#1e293b">certify</text>
<line x1="747.0" y1="150.0" x2="779.5" y2="150.0" stroke="#2563eb" stroke-width="2.6" marker-end="url(#aBlue)" stroke-linecap="round"/>
<rect x="738.05" y="130.0" width="50.400000000000006" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
<text x="763.25" y="142.0" text-anchor="middle" font-size="10" font-weight="700" fill="#1e293b">/ready</text>
<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 (R3 · R4 · J3)</text>
+<text x="40" y="275" font-size="13" font-weight="700" fill="#b91c1c">2 · Fail-closed fences (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>
-<text x="230.0" y="342" text-anchor="middle" font-size="11" fill="#475569">throw → 503 · nunca un 200 equivocado</text>
+<text x="230.0" y="342" text-anchor="middle" font-size="11" fill="#475569">throw → 503 · never a wrong 200</text>
<rect x="450.0" y="284" width="380.0" height="76" rx="11" fill="#fef2f2" stroke="#dc2626" stroke-width="1.8" filter="url(#sh)"/>
-<text x="640.0" y="307" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">G1 — deny sin inventory-authority</text>
+<text x="640.0" y="307" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">G1 — deny without inventory-authority</text>
<text x="640.0" y="326" text-anchor="middle" font-size="11" fill="#475569">currentWhenUnconfigured() → false + warn</text>
-<text x="640.0" y="342" text-anchor="middle" font-size="11" fill="#475569">dev nunca construye el reconciler</text>
+<text x="640.0" y="342" text-anchor="middle" font-size="11" fill="#475569">dev never builds the reconciler</text>
<rect x="860.0" y="284" width="380.0" height="76" rx="11" fill="#fef2f2" stroke="#dc2626" stroke-width="1.8" filter="url(#sh)"/>
-<text x="1050.0" y="307" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">F1 — rebind del readiness-poll</text>
-<text x="1050.0" y="326" text-anchor="middle" font-size="11" fill="#475569">re-liga isCurrent/server en reconciles</text>
-<text x="1050.0" y="342" text-anchor="middle" font-size="11" fill="#475569">superpuestos → la ventana no se autodestruye</text>
-<text x="40" y="421" font-size="13" font-weight="700" fill="#6d28d9">3 · Egress externo DNS — contrato B3 (retener/revocar) + sliding-window #299</text>
+<text x="1050.0" y="307" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">F1 — readiness-poll rebind</text>
+<text x="1050.0" y="326" text-anchor="middle" font-size="11" fill="#475569">rebinds isCurrent/server on superseding</text>
+<text x="1050.0" y="342" text-anchor="middle" font-size="11" fill="#475569">reconciles → window never self-destructs</text>
+<text x="40" y="421" font-size="13" font-weight="700" fill="#6d28d9">3 · External-egress DNS — B3 retain/revoke · #299</text>
<rect x="40" y="438" width="224" height="80" rx="11" fill="#f5f3ff" stroke="#7c3aed" stroke-width="1.8" filter="url(#sh)"/>
-<text x="152.0" y="461" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">DNS binding observado</text>
+<text x="152.0" y="461" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Observed DNS binding</text>
<text x="152.0" y="480" text-anchor="middle" font-size="11" fill="#475569">resolveExternalEgressDns</text>
-<text x="152.0" y="496" text-anchor="middle" font-size="11" fill="#475569">timeout 5s + fence isCurrent</text>
+<text x="152.0" y="496" text-anchor="middle" font-size="11" fill="#475569">5s timeout + isCurrent fence</text>
<polygon points="372,436 472,478 372,520 272,478" fill="#f5f3ff" stroke="#7c3aed" stroke-width="1.8" filter="url(#sh)"/>
-<text x="372" y="475" text-anchor="middle" font-size="12" font-weight="700" fill="#0f172a">¿identity</text>
+<text x="372" y="475" text-anchor="middle" font-size="12" font-weight="700" fill="#0f172a">identity</text>
<text x="372" y="491" text-anchor="middle" font-size="12" font-weight="700" fill="#0f172a">unchanged?</text>
<line x1="264" y1="478" x2="272" y2="478" stroke="#7c3aed" stroke-width="2.6" marker-end="url(#aViolet)" stroke-linecap="round"/>
<rect x="540" y="414" width="306" height="60" rx="11" fill="#ecfdf5" stroke="#059669" stroke-width="1.8" filter="url(#sh)"/>
-<text x="693.0" y="437" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">RETAIN — allow identity-stable</text>
-<text x="693.0" y="456" text-anchor="middle" font-size="11" fill="#475569">mismo protocolo/puerto/ownership/cidrs</text>
-<text x="693.0" y="472" text-anchor="middle" font-size="11" fill="#475569">· HCC sigue Ready (módulo cidr)</text>
+<text x="693.0" y="437" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">RETAIN — identity-stable allow</text>
+<text x="693.0" y="456" text-anchor="middle" font-size="11" fill="#475569">same protocol/port/ownership/cidrs</text>
+<text x="693.0" y="472" text-anchor="middle" font-size="11" fill="#475569">· HCC stays Ready (modulo cidr)</text>
<rect x="540" y="496" width="306" height="60" rx="11" fill="#fef2f2" stroke="#dc2626" stroke-width="1.8" filter="url(#sh)"/>
-<text x="693.0" y="519" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">REVOKE antes de readiness</text>
+<text x="693.0" y="519" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">REVOKE before readiness</text>
<text x="693.0" y="538" text-anchor="middle" font-size="11" fill="#475569">drift TCP→UDP · port · ownership · zero-cidr</text>
<text x="693.0" y="554" text-anchor="middle" font-size="11" fill="#475569">→ unprovable → cleanup fail-closed</text>
<path d="M 472,470 H 506.0 V 444 H 540" fill="none" stroke="#059669" stroke-width="2.6" marker-end="url(#aGreen)" stroke-linejoin="round"/>
<rect x="423.6" y="415" width="88.80000000000001" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
-<text x="468" y="427" text-anchor="middle" font-size="10" font-weight="700" fill="#047857">sí · retiene</text>
+<text x="468" y="427" text-anchor="middle" font-size="10" font-weight="700" fill="#047857">yes · retain</text>
<path d="M 472,486 H 506.0 V 526 H 540" fill="none" stroke="#dc2626" stroke-width="2.6" marker-end="url(#aRose)" stroke-linejoin="round"/>
<rect x="417.2" y="523" width="101.60000000000001" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
-<text x="468" y="535" text-anchor="middle" font-size="10" font-weight="700" fill="#b91c1c">drift · revoca</text>
+<text x="468" y="535" text-anchor="middle" font-size="10" font-weight="700" fill="#b91c1c">drift · revoke</text>
<rect x="892" y="430" width="348" height="88" rx="11" fill="#fffbeb" stroke="#d97706" stroke-width="1.8" filter="url(#sh)"/>
<text x="1066.0" y="453" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">ExternalEgressConvergenceCoordinator</text>
-<text x="1066.0" y="472" text-anchor="middle" font-size="11" fill="#475569">resync periódico TTL-aware (≤ TTL/2, floor)</text>
+<text x="1066.0" y="472" text-anchor="middle" font-size="11" fill="#475569">TTL-aware periodic resync (≤ TTL/2, floor)</text>
<text x="1066.0" y="488" text-anchor="middle" font-size="11" fill="#475569">sliding-window accumulate · provider CIDRs</text>
<text x="1066.0" y="504" text-anchor="middle" font-size="11" fill="#475569">fence interval ≤ overlap/2 · limiter</text>
<line x1="846" y1="444" x2="892" y2="460" stroke="#d97706" stroke-width="2.6" marker-end="url(#aAmber)" stroke-linecap="round"/>
<rect x="821.4" y="425" width="95.2" height="16" rx="4" fill="#ffffff" stroke="#e2e8f0" stroke-width="0.8"/>
-<text x="869" y="437" text-anchor="middle" font-size="10" font-weight="700" fill="#b45309">add (aditiva)</text>
-<text x="40" y="575" font-size="13" font-weight="700" fill="#047857">4 · Seam de rotación #223 (preservado) &amp; invariante de deploy single-writer</text>
+<text x="869" y="437" text-anchor="middle" font-size="10" font-weight="700" fill="#b45309">add (additive)</text>
+<text x="40" y="575" font-size="13" font-weight="700" fill="#047857">4 · Rotation seam #223 (preserved) &amp; single-writer deploy invariant</text>
<rect x="40" y="584" width="236" height="66" rx="11" fill="#ecfdf5" stroke="#059669" stroke-width="1.8" filter="url(#sh)"/>
<text x="158.0" y="607" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">validateSecret()</text>
<text x="158.0" y="626" text-anchor="middle" font-size="11" fill="#475569">sha256(canonicalJSON(secret.data))</text>
<rect x="306" y="584" width="306" height="66" rx="11" fill="#ecfdf5" stroke="#059669" stroke-width="1.8" filter="url(#sh)"/>
<text x="459.0" y="607" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">ensureDeployment(rev, isCurrent)</text>
-<text x="459.0" y="626" text-anchor="middle" font-size="11" fill="#475569">el fence de #205 se propaga aquí</text>
+<text x="459.0" y="626" text-anchor="middle" font-size="11" fill="#475569">this PR's fence propagates here</text>
<rect x="642" y="584" width="300" height="66" rx="11" fill="#ecfdf5" stroke="#059669" stroke-width="1.8" filter="url(#sh)"/>
<text x="792.0" y="607" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">pod annotation</text>
-<text x="792.0" y="626" text-anchor="middle" font-size="11" fill="#475569">clerum.io/credentials-revision → rueda 1 vez</text>
+<text x="792.0" y="626" text-anchor="middle" font-size="11" fill="#475569">clerum.io/credentials-revision → rolls once</text>
<line x1="276" y1="617" x2="306" y2="617" stroke="#059669" stroke-width="2.6" marker-end="url(#aGreen)" stroke-linecap="round"/>
<line x1="612" y1="617" x2="642" y2="617" stroke="#059669" stroke-width="2.6" marker-end="url(#aGreen)" stroke-linecap="round"/>
<rect x="972" y="584" width="268" height="66" rx="11" fill="#f8fafc" stroke="#475569" stroke-width="1.8" filter="url(#sh)"/>
<text x="1106.0" y="607" text-anchor="middle" font-size="14" font-weight="700" fill="#0f172a">Deploy single-writer</text>
<text x="1106.0" y="626" text-anchor="middle" font-size="11" fill="#475569">strategy: Recreate · replicas 1</text>
<text x="1106.0" y="642" text-anchor="middle" font-size="11" fill="#475569">· progressDeadlineSeconds 1200</text>
-<text x="40" y="700" font-size="11.5" font-weight="700" fill="#334155">Leyenda</text>
+<text x="40" y="700" font-size="11.5" font-weight="700" fill="#334155">Legend</text>
<rect x="118" y="688" width="14" height="14" rx="3" fill="#2563eb" opacity="0.9"/>
-<text x="137" y="700" font-size="11" fill="#475569">lifecycle readiness</text>
+<text x="137" y="700" font-size="11" fill="#475569">readiness lifecycle</text>
<rect x="282.6" y="688" width="14" height="14" rx="3" fill="#dc2626" opacity="0.9"/>
-<text x="301.6" y="700" font-size="11" fill="#475569">fence fail-closed / revoke</text>
+<text x="301.6" y="700" font-size="11" fill="#475569">fail-closed fence / revoke</text>
<rect x="492.0" y="688" width="14" height="14" rx="3" fill="#7c3aed" opacity="0.9"/>
<text x="511.0" y="700" font-size="11" fill="#475569">egress DNS (B3)</text>
<rect x="631.0" y="688" width="14" height="14" rx="3" fill="#d97706" opacity="0.9"/>
<text x="650.0" y="700" font-size="11" fill="#475569">coordinator #299</text>
<rect x="776.4" y="688" width="14" height="14" rx="3" fill="#059669" opacity="0.9"/>
-<text x="795.4" y="700" font-size="11" fill="#475569">retain / rotación #223</text>
+<text x="795.4" y="700" font-size="11" fill="#475569">retain / rotation #223</text>
<rect x="960.2" y="688" width="14" height="14" rx="3" fill="#475569" opacity="0.9"/>
-<text x="979.2" y="700" font-size="11" fill="#475569">invariante deploy</text>
-<text x="40" y="858" font-size="10.5" fill="#94a3b8">PR #205 · evenfire-ai/evenfire · el /ready certifica una frontera de seguridad autoritativa ANTES de que la flota converja — la convergencia restante es aditiva y asíncrona</text>
+<text x="979.2" y="700" font-size="11" fill="#475569">deploy invariant</text>
+<text x="40" y="858" font-size="10.5" fill="#94a3b8">#382 · /ready certifies an authoritative safety barrier BEFORE fleet convergence · certified by CONTENT identity (desired revision), not CHANNEL identity (watch generation) — survives GKE watch-churn / Premature-close</text>
</svg>
\ No newline at end of file
diff --git a/docs/architecture/hcc-readiness-flows.md b/docs/architecture/hcc-readiness-flows.md
index 6a4e89ca9..b20373519 100644
--- a/docs/architecture/hcc-readiness-flows.md
+++ b/docs/architecture/hcc-readiness-flows.md
@@ -1,10 +1,10 @@
-# HCC readiness & external-egress — design note (PR #205)
+# HCC readiness & external-egress — design note (#382)
> Design note for the readiness-decoupling and single-writer NetworkPolicy work in
> `host-context-controller` (HCC). Addresses the "no design/decision doc for the
> 500+-line external-egress coordinator and the certification barrier" review gap.
-![HCC flows resolved by PR #205](./pr205-hcc-flows.png)
+![HCC readiness flows resolved by #382](./hcc-readiness-flows-diagram.png)
## 1. Readiness lifecycle — decoupled from initial fleet convergence
diff --git a/docs/architecture/pr205-before-after.png b/docs/architecture/pr205-before-after.png
deleted file mode 100644
index 524481e1f..000000000
Binary files a/docs/architecture/pr205-before-after.png and /dev/null differ
diff --git a/docs/architecture/pr205-hcc-flows.png b/docs/architecture/pr205-hcc-flows.png
deleted file mode 100644
index d0bbfa3d7..000000000
Binary files a/docs/architecture/pr205-hcc-flows.png and /dev/null differ