From a25c5ccdc9ef2f7f8ddb442a3c89870ac7b7544b Mon Sep 17 00:00:00 2001
From: Jay Kim <jay@oraclizer.io>
Date: Sun, 2 Aug 2026 18:27:35 +0900
Subject: [PATCH] Clarify bidirectional state synchronization

---
 .../assets/oraclizer-system-map-mobile.svg    | 15 ++++++++-----
 profile/assets/oraclizer-system-map.svg       | 21 ++++++++++++-------
 2 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/profile/assets/oraclizer-system-map-mobile.svg b/profile/assets/oraclizer-system-map-mobile.svg
index 44bbc66..832f3d4 100644
--- a/profile/assets/oraclizer-system-map-mobile.svg
+++ b/profile/assets/oraclizer-system-map-mobile.svg
@@ -1,6 +1,6 @@
 <svg width="720" height="1080" viewBox="0 0 720 1080" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
   <title id="title">Oraclizer system and research map for narrow screens</title>
-  <desc id="desc">A vertically arranged project map showing source systems, the OIP and OSS target architecture, regulatory semantics, and assurance work with current publication and maturity labels.</desc>
+  <desc id="desc">A vertically arranged project map showing off-chain and on-chain systems bidirectionally synchronized through the OIP and OSS target architecture, with regulatory semantics, assurance work, and current publication and maturity labels.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="720" y2="1080" gradientUnits="userSpaceOnUse">
       <stop stop-color="#07111F"/>
@@ -40,14 +40,19 @@
     <text x="406" y="210" fill="#AFC0D4" font-size="14">Token, contract, and</text>
     <text x="406" y="231" fill="#AFC0D4" font-size="14">settlement state</text>
 
-    <path d="M190 256V284H360" stroke="#5B93FF" stroke-width="2"/>
-    <path d="M530 256V284H360" stroke="#5B93FF" stroke-width="2"/>
-    <path d="M360 284V310" stroke="#5B93FF" stroke-width="2" marker-end="url(#arrow)"/>
+    <g aria-label="Bidirectional synchronization between source systems and the oracle state machine">
+      <path d="M190 256V284H280" stroke="#5B93FF" stroke-width="2"/>
+      <path d="M530 256V284H440" stroke="#5B93FF" stroke-width="2"/>
+      <rect x="280" y="268" width="160" height="32" rx="16" fill="#0B1B2E" stroke="#4D7FC7"/>
+      <path d="M298 278H322M318 274L322 278L318 282M322 290H298M302 286L298 290L302 294" stroke="#78A5FF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+      <text x="336" y="289" fill="#AFCBFF" font-size="11" font-weight="700" letter-spacing="1.2">STATE SYNC</text>
+      <path d="M360 300V310" stroke="#5B93FF" stroke-width="2"/>
+    </g>
 
     <rect x="40" y="310" width="640" height="178" rx="20" fill="#10233A" stroke="#4D7FC7" stroke-width="1.5"/>
     <text x="72" y="348" fill="#6FA0FF" font-size="13" font-weight="700" letter-spacing="1.7">TARGET ARCHITECTURE</text>
     <text x="72" y="382" fill="#FFFFFF" font-size="24" font-weight="700">ORACLE STATE MACHINE</text>
-    <text x="72" y="411" fill="#B7C9DD" font-size="15">Protocol-level coordination of state transitions</text>
+    <text x="72" y="411" fill="#B7C9DD" font-size="15">Bidirectional coordination of state transitions</text>
     <rect x="72" y="431" width="168" height="30" rx="15" fill="#193A64"/>
     <text x="156" y="451" text-anchor="middle" fill="#AFCBFF" font-size="12" font-weight="700">OIP v0.5 · PUBLISHED</text>
     <rect x="252" y="431" width="188" height="30" rx="15" fill="#2C2449"/>
diff --git a/profile/assets/oraclizer-system-map.svg b/profile/assets/oraclizer-system-map.svg
index 1ee5366..80c042e 100644
--- a/profile/assets/oraclizer-system-map.svg
+++ b/profile/assets/oraclizer-system-map.svg
@@ -1,6 +1,6 @@
 <svg width="1200" height="740" viewBox="0 0 1200 740" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
   <title id="title">Oraclizer system and research map</title>
-  <desc id="desc">A project map showing on-chain and off-chain systems connected to the OIP and OSS target architecture, supported by regulatory semantics and assurance work. Each artifact includes its current public or private status.</desc>
+  <desc id="desc">A project map showing off-chain and on-chain systems bidirectionally synchronized through the OIP and OSS target architecture, supported by regulatory semantics and assurance work. Each artifact includes its current public or private status.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="1200" y2="740" gradientUnits="userSpaceOnUse">
       <stop stop-color="#07111F"/>
@@ -16,9 +16,6 @@
     <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto" markerUnits="strokeWidth">
       <path d="M1 1L8 5L1 9" stroke="#5B93FF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
     </marker>
-    <marker id="arrowStart" markerWidth="10" markerHeight="10" refX="2" refY="5" orient="auto-start-reverse" markerUnits="strokeWidth">
-      <path d="M9 1L2 5L9 9" stroke="#5B93FF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
-    </marker>
     <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
       <feDropShadow dx="0" dy="12" stdDeviation="18" flood-color="#000814" flood-opacity="0.28"/>
     </filter>
@@ -48,14 +45,24 @@
       <text x="870" y="253" fill="#7F95AF" font-size="14">EVM networks and protocol endpoints</text>
     </g>
 
-    <path d="M358 220H426" stroke="#5B93FF" stroke-width="2" marker-start="url(#arrowStart)" marker-end="url(#arrow)"/>
-    <path d="M774 220H842" stroke="#5B93FF" stroke-width="2" marker-start="url(#arrowStart)" marker-end="url(#arrow)"/>
+    <g aria-label="Bidirectional synchronization between off-chain systems and the oracle state machine">
+      <path d="M358 220H370" stroke="#5B93FF" stroke-width="2"/>
+      <rect x="370" y="206" width="44" height="28" rx="14" fill="#0B1B2E" stroke="#4D7FC7"/>
+      <path d="M380 215H404M400 211L404 215L400 219M404 225H380M384 221L380 225L384 229" stroke="#78A5FF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+      <path d="M414 220H426" stroke="#5B93FF" stroke-width="2"/>
+    </g>
+    <g aria-label="Bidirectional synchronization between the oracle state machine and on-chain systems">
+      <path d="M774 220H786" stroke="#5B93FF" stroke-width="2"/>
+      <rect x="786" y="206" width="44" height="28" rx="14" fill="#0B1B2E" stroke="#4D7FC7"/>
+      <path d="M796 215H820M816 211L820 215L816 219M820 225H796M800 221L796 225L800 229" stroke="#78A5FF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+      <path d="M830 220H842" stroke="#5B93FF" stroke-width="2"/>
+    </g>
 
     <g filter="url(#shadow)">
       <rect x="426" y="145" width="348" height="166" rx="22" fill="#10233A" stroke="#4D7FC7" stroke-width="1.5"/>
       <text x="454" y="179" fill="#6FA0FF" font-size="13" font-weight="700" letter-spacing="1.8">TARGET ARCHITECTURE</text>
       <text x="454" y="210" fill="#FFFFFF" font-size="23" font-weight="700">ORACLE STATE MACHINE</text>
-      <text x="454" y="237" fill="#B7C9DD" font-size="15">Protocol-level coordination of state transitions</text>
+      <text x="454" y="237" fill="#B7C9DD" font-size="15">Bidirectional coordination of state transitions</text>
       <rect x="454" y="255" width="132" height="28" rx="14" fill="#193A64"/>
       <text x="520" y="274" text-anchor="middle" fill="#AFCBFF" font-size="12" font-weight="700">OIP v0.5 · PUBLISHED</text>
       <rect x="596" y="255" width="150" height="28" rx="14" fill="#2C2449"/>