From abcc6da9a09f85527211749909ce52dce56528f7 Mon Sep 17 00:00:00 2001
From: "Evgeny @ SimpleX Chat"
 <259188159+evgeny-simplex@users.noreply.github.com>
Date: Sat, 14 Mar 2026 10:35:36 +0000
Subject: [PATCH] fixes

---
 spec/diagrams/ntf-router.svg  | 21 +++++++++++++--------
 spec/diagrams/smp-router.svg  |  5 +++++
 spec/diagrams/xftp-router.svg |  4 ++--
 spec/routers.md               |  3 ++-
 4 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/spec/diagrams/ntf-router.svg b/spec/diagrams/ntf-router.svg
index fb35fe804..b42429459 100644
--- a/spec/diagrams/ntf-router.svg
+++ b/spec/diagrams/ntf-router.svg
@@ -52,14 +52,19 @@
   <text x="326" y="88" font-size="9" fill="#999">net</text>
 
   <!-- commands label -->
-  <text x="52" y="120" font-size="10" fill="#666">TNEW, TVFY, TRPL, TDEL</text>
-  <text x="52" y="134" font-size="10" fill="#666">SNEW, SCHK, SDEL</text>
+  <text x="52" y="120" font-size="10" fill="#666">TNEW, TVFY, TCHK, TRPL, TDEL, TCRN</text>
+  <text x="52" y="134" font-size="10" fill="#666">SNEW, SCHK, SDEL, PING</text>
 
   <!-- client -> store (down) -->
-  <line x1="199" y1="100" x2="199" y2="280"
-        stroke="#333" marker-end="url(#arr)" />
+  <line x1="199" y1="100" x2="199" y2="278"
+        stroke="#555" stroke-dasharray="3,2" marker-end="url(#arr)" />
   <text x="211" y="230" font-size="10" fill="#555">store</text>
 
+  <!-- client -> pushQ (PNVerification on TNEW/TRPL) -->
+  <line x1="160" y1="100" x2="50" y2="388"
+        stroke="#333" marker-end="url(#arr)" />
+  <text x="62" y="260" font-size="9" fill="#555">pushQ</text>
+
   <!-- ===== SMP CLIENT AGENT GROUP (right) ===== -->
   <rect x="370" y="40" width="435" height="220" rx="6"
         fill="none" stroke="#888" stroke-dasharray="6,3" />
@@ -104,9 +109,9 @@
   <text x="500" y="183" font-size="10" fill="#555">pushQ</text>
 
   <!-- receiveAgent -> store (down) -->
-  <line x1="697" y1="164" x2="697" y2="195"
+  <line x1="697" y1="164" x2="697" y2="278"
         stroke="#555" stroke-dasharray="3,2" marker-end="url(#arr)" />
-  <text x="709" y="183" font-size="10" fill="#555">store</text>
+  <text x="709" y="230" font-size="10" fill="#555">store</text>
 
   <!-- per-SMP-server subscriber -->
   <rect x="390" y="200" width="200" height="44" rx="4"
@@ -118,10 +123,10 @@
   <text x="408" y="196" font-size="9" fill="#555">subscriberSubQ</text>
 
   <!-- ===== CENTRAL STORE ===== -->
-  <rect x="100" y="280" width="600" height="50" rx="4"
+  <rect x="100" y="280" width="620" height="50" rx="4"
         fill="#fef7e0" stroke="#f9ab00" />
   <text x="400" y="301" text-anchor="middle" font-weight="bold">tokens / subscriptions / tokenLastNtfs</text>
-  <text x="400" y="319" text-anchor="middle" font-size="10">(in-memory TMap + PostgreSQL)</text>
+  <text x="400" y="319" text-anchor="middle" font-size="10">(PostgreSQL)</text>
 
   <!-- ===== PUSH DELIVERY ===== -->
   <rect x="25" y="355" width="780" height="90" rx="6"
diff --git a/spec/diagrams/smp-router.svg b/spec/diagrams/smp-router.svg
index 796bbf80f..09a198bc9 100644
--- a/spec/diagrams/smp-router.svg
+++ b/spec/diagrams/smp-router.svg
@@ -90,6 +90,11 @@
         fill="#f5f5f5" stroke="#ccc" />
   <text x="122" y="221" text-anchor="middle" font-size="9" fill="#888">StoreLog (optional)</text>
 
+  <!-- NtfStore under MsgStore (in-memory notification queue, read by deliverNtfs/expireNtfs) -->
+  <rect x="320" y="208" width="155" height="18" rx="3"
+        fill="#fef7e0" stroke="#f9ab00" />
+  <text x="397" y="221" text-anchor="middle" font-size="9" fill="#888">NtfStore (STM TMap)</text>
+
   <!-- subQ arrow: from client bottom-center, through gap between stores, to serverThread -->
   <!-- Gap between stores: x=200..320 -->
   <line x1="250" y1="102" x2="250" y2="296"
diff --git a/spec/diagrams/xftp-router.svg b/spec/diagrams/xftp-router.svg
index bf60f000d..6f13221f9 100644
--- a/spec/diagrams/xftp-router.svg
+++ b/spec/diagrams/xftp-router.svg
@@ -46,7 +46,7 @@
   <!-- Command Processing -->
   <rect x="45" y="120" width="475" height="36" rx="4"
         fill="#e8f0fe" stroke="#4285f4" />
-  <text x="282" y="143" text-anchor="middle">Command Processing (FNEW, FADD, FPUT, FGET, FACK, FDEL)</text>
+  <text x="282" y="143" text-anchor="middle">Command Processing (FNEW, FADD, FPUT, FGET, FACK, FDEL, PING)</text>
 
   <!-- Command Processing -> FileStore -->
   <line x1="160" y1="156" x2="130" y2="180"
@@ -66,7 +66,7 @@
   <rect x="300" y="182" width="220" height="48" rx="4"
         fill="#fef7e0" stroke="#f9ab00" />
   <text x="410" y="203" text-anchor="middle" font-weight="bold">Disk Storage</text>
-  <text x="410" y="221" text-anchor="middle" font-size="10">filesPath / senderId / data</text>
+  <text x="410" y="221" text-anchor="middle" font-size="10">filesPath / base64(senderId)</text>
 
   <!-- Quota note -->
   <text x="410" y="246" text-anchor="middle" font-size="9" fill="#888">quota-managed via usedStorage TVar</text>
diff --git a/spec/routers.md b/spec/routers.md
index f146ca8af..b66c52ce4 100644
--- a/spec/routers.md
+++ b/spec/routers.md
@@ -95,10 +95,11 @@ sequenceDiagram
     HS->>S: server DH key + version
 
     S->>CP: FNEW (create data packet)
-    CP->>FS: create FileRec, reserve quota
+    CP->>FS: create FileRec
     CP->>S: sender ID + recipient IDs
 
     S->>CP: FPUT (send encrypted data)
+    CP->>FS: reserve quota
     CP->>D: write to disk
     CP->>FS: commit filePath
     CP->>S: OK