Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
docs(hcc): add before/after readiness-decoupling diagram
Alfredo Lopez00da82842e1a
diff --git a/docs/architecture/pr205-before-after.png b/docs/architecture/pr205-before-after.pngnew file mode 100644index 000000000..524481e1fBinary files /dev/null and b/docs/architecture/pr205-before-after.png differdiff --git a/docs/architecture/pr205-before-after.svg b/docs/architecture/pr205-before-after.svgnew file mode 100644index 000000000..471f74cc3--- /dev/null+++ b/docs/architecture/pr205-before-after.svg@@ -0,0 +1,71 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1620 880" font-family="Helvetica, Arial, sans-serif">+<defs>+<marker id="arr_2563eb" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#2563eb"/></marker>+<marker id="arr_dc2626" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#dc2626"/></marker>+<marker id="arr_16a34a" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#16a34a"/></marker>+<marker id="arr_d97706" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#d97706"/></marker>+<marker id="arr_64748b" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#64748b"/></marker>+</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>+<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>+<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)"/>+<rect x="100.0" y="282" width="600" height="128" rx="12" fill="#fee2e2" stroke="#dc2626" stroke-width="2" opacity="1.0"/>+<text x="400" y="330.05" font-size="16" fill="#0f172a" font-weight="700" text-anchor="middle">Waits to reconcile the ENTIRE initial fleet</text>+<text x="400" y="357.35" font-size="14" fill="#475569" font-weight="400" text-anchor="middle">108 McpServers · 22 Contexts · Hosts</text>+<text x="400" y="383.94" font-size="15" fill="#dc2626" font-weight="700" text-anchor="middle">/ready = 503 for the entire wait</text>+<rect x="636" y="300" width="132" height="92" rx="12" fill="#dc2626" stroke="#dc2626" stroke-width="0" opacity="1.0"/>+<text x="702" y="336" font-size="15" fill="#ffffff" font-weight="700" text-anchor="middle">BLOCKED</text>+<text x="702" y="362" font-size="22" fill="#ffffff" font-weight="700" text-anchor="middle">~651 s</text>+<line x1="400" y1="410" x2="400" y2="467" stroke="#dc2626" stroke-width="3" marker-end="url(#arr_dc2626)"/>+<rect x="100.0" y="470" width="600" height="58" rx="12" fill="#f1f5f9" stroke="#64748b" stroke-width="2" opacity="1.0"/>+<text x="400" y="503.35" font-size="15" fill="#0f172a" font-weight="700" text-anchor="middle">/ready = 200 (only after the ENTIRE fleet converges)</text>+<line x1="400" y1="528" x2="400" y2="585" stroke="#dc2626" stroke-width="3" marker-end="url(#arr_dc2626)"/>+<rect x="100.0" y="588" width="600" height="76" rx="12" fill="#fee2e2" stroke="#dc2626" stroke-width="2" opacity="1.0"/>+<text x="400" y="621.7" font-size="17" fill="#dc2626" font-weight="700" text-anchor="middle">rollout status TIMEOUT → deploy FAILS</text>+<text x="400" y="649.0" font-size="13" fill="#475569" font-weight="400" text-anchor="middle">even though the HCC is healthy and progressing</text>+<text x="410" y="700" font-size="14" fill="#dc2626" font-weight="700" text-anchor="middle" font-style="italic">Readiness COUPLED to full fleet convergence</text>+<rect x="890.0" y="168" width="520" height="54" rx="12" fill="#dbeafe" stroke="#2563eb" stroke-width="2" opacity="1.0"/>+<text x="1150" y="199.64" font-size="16" fill="#0f172a" font-weight="700" text-anchor="middle">HCC starts — 4 watch lanes</text>+<line x1="1150" y1="222" x2="1150" y2="265" stroke="#16a34a" stroke-width="3" marker-end="url(#arr_16a34a)"/>+<rect x="890.0" y="268" width="520" height="50" rx="12" fill="#dbeafe" stroke="#2563eb" stroke-width="2" opacity="1.0"/>+<text x="1150" y="297.35" font-size="15" fill="#0f172a" font-weight="700" text-anchor="middle">BOUNDED inventory (bounded 4-LIST)</text>+<line x1="1150" y1="318" x2="1150" y2="357" stroke="#16a34a" stroke-width="3" marker-end="url(#arr_16a34a)"/>+<rect x="890.0" y="360" width="520" height="92" rx="12" fill="#fef3c7" stroke="#d97706" stroke-width="2" opacity="1.0"/>+<text x="1150" y="391.89" font-size="15" fill="#0f172a" font-weight="700" text-anchor="middle">Certifies authoritative fail-closed BARRIER</text>+<text x="1150" y="417.77" font-size="13" fill="#475569" font-weight="400" text-anchor="middle">revokes stale / unprovable NetworkPolicies</text>+<text x="1150" y="442.22999999999996" font-size="13" fill="#d97706" font-weight="700" text-anchor="middle">BEFORE declaring Ready</text>+<line x1="1150" y1="452" x2="1150" y2="493" stroke="#16a34a" stroke-width="3" marker-end="url(#arr_16a34a)"/>+<rect x="890.0" y="496" width="520" height="56" rx="12" fill="#dcfce7" stroke="#16a34a" stroke-width="2" opacity="1.0"/>+<text x="1150" y="528.9300000000001" font-size="17" fill="#16a34a" font-weight="700" text-anchor="middle">/ready = 200 (seconds)</text>+<line x1="1150" y1="552" x2="1150" y2="593" stroke="#16a34a" stroke-width="3" marker-end="url(#arr_16a34a)"/>+<rect x="890.0" y="596" width="520" height="56" rx="12" fill="#dcfce7" stroke="#16a34a" stroke-width="2" opacity="1.0"/>+<text x="1150" y="628.93" font-size="17" fill="#16a34a" font-weight="700" text-anchor="middle">rollout OK → deploy OK</text>+<path d="M 1410.0 524 H 1452 V 596" fill="none" stroke="#d97706" stroke-width="3" stroke-dasharray="7 5" marker-end="url(#arr_d97706)"/>+<rect x="1336.0" y="596" width="232" height="92" rx="12" fill="#fef3c7" stroke="#d97706" stroke-width="2" opacity="1.0"/>+<text x="1452" y="629.44" font-size="13" fill="#0f172a" font-weight="700" text-anchor="middle">ADDITIVE fleet convergence</text>+<text x="1452" y="653.19" font-size="12" fill="#475569" font-weight="400" text-anchor="middle">async, AFTER Ready</text>+<text x="1452" y="675.5200000000001" font-size="11" fill="#475569" font-weight="400" text-anchor="middle">(the rest of the policies converge)</text>+<rect x="1362.0" y="357" width="200.0" height="22" rx="7" fill="#ffffff" stroke="#2563eb" stroke-width="1.4" opacity="1.0"/>+<text x="1462" y="373" font-size="11" fill="#2563eb" font-weight="700" text-anchor="middle">isCurrent required (J3)</text>+<rect x="1382.0" y="389" width="160.0" height="22" rx="7" fill="#ffffff" stroke="#2563eb" stroke-width="1.4" opacity="1.0"/>+<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>+<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"/>+<text x="542" y="827" font-size="14" fill="#0f172a" font-weight="400" text-anchor="start">Block / failure</text>+<rect x="742" y="812" width="26" height="20" rx="5" fill="#dcfce7" stroke="#16a34a" stroke-width="2" opacity="1.0"/>+<text x="778" y="827" font-size="14" fill="#0f172a" font-weight="400" text-anchor="start">Fast Ready / OK</text>+<rect x="978" y="812" width="26" height="20" rx="5" fill="#fef3c7" stroke="#d97706" stroke-width="2" opacity="1.0"/>+<text x="1014" y="827" font-size="14" fill="#0f172a" font-weight="400" text-anchor="start">Barrier / async branch</text>+</svg>\ No newline at end of file