docs(keycloak-session-store): take the sentences out of the diagram canvases

The skill says drawings carry names and sentences go in <desc> and the paragraph beside the figure. I put sentences in node details and edge labels instead, and 27 of the 28 diagrams shipped with prose inside the canvas — "예측 다섯 개가 틀렸다", "아홉 번 조용히 실패했다", "막혀서 닿지 않는다". Only label and details render on the canvas; description does not. So every sentence moved to a noun phrase and the meaning stays in description, which was already carrying it. 막혀서 닿지 않는다 -> 차단 아홉 번 조용히 실패했다 -> 조용한 실패 9건 예측 다섯 개가 틀렸다 -> 틀린 예측 5건 로그아웃이 정리하지 않는다 -> 로그아웃 미정리 볼륨이 없으면 여기까지다 -> 볼륨 없음 Three node labels were sentences too and became names: 세션 스냅샷, 예측 선기록, 대조군 확보. What stays is what the rules protect — identifiers, commands and measured values: PRIMARY KEY (client_registration_id, principal_name), ValidationFailedException: 1 changesets check sum, nginx -t && nginx -s reload, SET LOCAL synchronous_commit TO OFF. Those are names of things, not prose about them. 294 canvas strings across 28 diagrams, none matching a sentence ending, average 11 characters. All 28 still lint clean and re-rendered. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 11:50:33 +09:00
parent 75bed382c8
commit 95c0e680b5
221 changed files with 1156 additions and 1152 deletions
@@ -17,6 +17,6 @@ JGroups 는 한 방향이 막혀도 열린 방향으로 재연결한다. 그래

 ## Relationships

- **막은 방향 → keycloak-1:** 막혀서 닿지 않는다. Evidence: L226–L232.
+- **막은 방향 → keycloak-1:** 차단. Evidence: L226–L232.
 - **keycloak-0 → 막은 방향:** JGroups 메시지. Evidence: L226–L232.
 - **keycloak-1 → 열린 반대 방향:** 반대 방향으로 재연결. Evidence: L226–L232.
@@ -14,5 +14,5 @@ n3: "열린 반대 방향" {
  shape: rectangle
 }
 n0 -> n1: "JGroups 메시지"
-n1 -> n2: "막혀서 닿지 않는다"
+n1 -> n2: "차단"
 n2 -> n3: "반대 방향으로 재연결"
@@ -7,6 +7,6 @@ digraph techviz {
  n2 [label="keycloak-1", shape=box, style="rounded,filled"];
  n3 [label="열린 반대 방향", shape=box, style="rounded,filled"];
  n0 -> n1 [label="JGroups 메시지", style=solid];
-  n1 -> n2 [label="막혀서 닿지 않는다", style=solid];
+  n1 -> n2 [label="차단", style=solid];
  n2 -> n3 [label="반대 방향으로 재연결", style=solid];
 }
@@ -14,10 +14,10 @@
        <mxCell id="n_k1" value="keycloak-1&lt;br/&gt;readiness 실패" tooltip="분단되면 스스로 로드밸런서에서 빠진다. | Evidence: L226-L236" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
          <mxGeometry x="70.0" y="394.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_rev" value="열린 반대 방향&lt;br/&gt;가르지 못한다" tooltip="비대칭 차단에서는 여기로 재연결한다. | Evidence: L226-L232" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
+        <mxCell id="n_rev" value="열린 반대 방향&lt;br/&gt;재연결 경로" tooltip="비대칭 차단에서는 여기로 재연결한다. | Evidence: L226-L232" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
          <mxGeometry x="70.0" y="561.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_f-k1" value="막혀서 닿지 않는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_fwd" target="n_k1">
+        <mxCell id="e_f-k1" value="차단" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_fwd" target="n_k1">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="169.0" y="346.0" as="offset"/>
          </mxGeometry>
@@ -94,11 +94,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "막혀서 닿지 않는다",
+      "text": "차단",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "막혀서 닿지 않는다",
+      "originalText": "차단",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -568,11 +568,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "열린 반대 방향\n가르지 못한다",
+      "text": "열린 반대 방향\n재연결 경로",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "열린 반대 방향\n가르지 못한다",
+      "originalText": "열린 반대 방향\n재연결 경로",
      "autoResize": true,
      "lineHeight": 1.25
    }
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "a5-partition-asymmetry",
  "spec_version": "1.1",
-  "spec_sha256": "26b2dc620b94c979befdef3808475899361f52b7f622fc06a78b5c6c59cd72a7",
+  "spec_sha256": "9b10dfa9cfb1f24e5b105da13bc8fde85130cc1cca2ddad54cd57c32bc2dfcf5",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -6,5 +6,5 @@ flowchart TB
    n2["keycloak-1"]
    n3["열린 반대 방향"]
    n0 -->|"JGroups 메시지"| n1
-    n1 -->|"막혀서 닿지 않는다"| n2
+    n1 -->|"차단"| n2
    n2 -->|"반대 방향으로 재연결"| n3
@@ -51,8 +51,8 @@
 </defs>
 <rect class="canvas" width="680" height="677" />
 <polyline class="edge kind-blocked style-solid emphasis-normal" points="145.0,298.0 145.0,346.0 145.0,346.0 145.0,394.0" data-evidence="226-232" />
-<rect class="edge-label-bg" x="126.5" y="332.0" width="85.0" height="22" rx="3" />
-<text class="edge-label" x="169.0" y="347.0">막혀서 닿지 않는다</text>
+<rect class="edge-label-bg" x="147.0" y="332.0" width="44.0" height="22" rx="3" />
+<text class="edge-label" x="169.0" y="347.0">차단</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="145.0,131.0 145.0,179.0 145.0,179.0 145.0,227.0" data-evidence="226-232" />
 <rect class="edge-label-bg" x="123.2" y="165.0" width="91.7" height="22" rx="3" />
 <text class="edge-label" x="169.0" y="180.0">JGroups 메시지</text>
@@ -81,6 +81,6 @@
 <rect class="node-shape kind-channel emphasis-normal role-support" data-evidence="226-232" x="70.0" y="561.0" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="145.0" y="588.0">열린 반대 방향</text>
 <line class="node-detail-divider" x1="84.0" y1="609.0" x2="206.0" y2="609.0" />
-<text class="node-detail" x="86.0" y="626.0">가르지 못한다</text>
+<text class="node-detail" x="86.0" y="626.0">재연결 경로</text>
 </g>
 </svg>