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
@@ -16,5 +16,5 @@

 ## Relationships

- **주입 명령 → 대상 상태 확인:** 걸렸는가를 먼저 본다. Evidence: L128–L133.
- **대상 상태 확인 → 결과 관측:** 걸린 뒤에만 결과를 읽는다. Evidence: L128–L133.
+- **주입 명령 → 대상 상태 확인:** 상태 확인. Evidence: L128–L133.
+- **대상 상태 확인 → 결과 관측:** 결과 판독. Evidence: L128–L133.
@@ -10,5 +10,5 @@ n1: "대상 상태 확인" {
 n2: "결과 관측" {
  shape: rectangle
 }
-n0 -> n1: "걸렸는가를 먼저 본다"
-n1 -> n2: "걸린 뒤에만 결과를 읽는다"
+n0 -> n1: "상태 확인"
+n1 -> n2: "결과 판독"
@@ -5,6 +5,6 @@ digraph techviz {
  n0 [label="주입 명령", shape=box, style="rounded,filled"];
  n1 [label="대상 상태 확인", shape=box, style="rounded,filled"];
  n2 [label="결과 관측", shape=box, style="rounded,filled"];
-  n0 -> n1 [label="걸렸는가를 먼저 본다", style=solid];
-  n1 -> n2 [label="걸린 뒤에만 결과를 읽는다", style=solid];
+  n0 -> n1 [label="상태 확인", style=solid];
+  n1 -> n2 [label="결과 판독", style=solid];
 }
@@ -1,25 +1,25 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
  <diagram id="injection-verification" name="주입이 걸렸는지 따로 확인한다">
-    <mxGraphModel dx="1059" dy="300" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1059" pageHeight="1169" math="0" shadow="0">
+    <mxGraphModel dx="1035" dy="300" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1035" pageHeight="1169" math="0" shadow="0">
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_inject" value="주입 명령&lt;br/&gt;아홉 번 조용히 실패했다" tooltip="NetworkPolicy · tc · kill · iptables. | Evidence: L109-L112" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
+        <mxCell id="n_inject" value="주입 명령&lt;br/&gt;조용한 실패 9건" tooltip="NetworkPolicy · tc · kill · iptables. | Evidence: L109-L112" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
          <mxGeometry x="70.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_verify" value="대상 상태 확인&lt;br/&gt;cluster_size · 워커 PID · conntrack · 패킷 카운터" tooltip="결과가 아니라 대상이 그 상태인지를 본다. | Evidence: L128-L133" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
          <mxGeometry x="380.0" y="60.0" width="300.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_observe" value="결과 관측&lt;br/&gt;주입 실패 = 영향 없음 으로 읽힌다" tooltip="여기만 보면 두 상황이 같아 보인다. | Evidence: L128-L131" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
-          <mxGeometry x="840.0" y="60.0" width="174.0" height="71.0" as="geometry"/>
+        <mxCell id="n_observe" value="결과 관측&lt;br/&gt;실패 · 무영향 구별 불가" tooltip="여기만 보면 두 상황이 같아 보인다. | Evidence: L128-L131" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
+          <mxGeometry x="840.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_i-v" value="걸렸는가를 먼저 본다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_inject" target="n_verify">
+        <mxCell id="e_i-v" value="상태 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_inject" target="n_verify">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="300.0" y="67.5" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_v-o" value="걸린 뒤에만 결과를 읽는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_verify" target="n_observe">
+        <mxCell id="e_v-o" value="결과 판독" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_verify" target="n_observe">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="760.0" y="67.5" 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
    },
@@ -165,9 +165,9 @@
    {
      "id": "edge-label-v-o",
      "type": "text",
-      "x": 704.0,
+      "x": 715.0,
      "y": 55.5,
-      "width": 112,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -193,11 +193,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "걸린 뒤에만 결과를 읽는다",
+      "text": "결과 판독",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "걸린 뒤에만 결과를 읽는다",
+      "originalText": "결과 판독",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -262,11 +262,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "주입 명령\n아홉 번 조용히 실패했다",
+      "text": "주입 명령\n조용한 실패 9건",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "주입 명령\n아홉 번 조용히 실패했다",
+      "originalText": "주입 명령\n조용한 실패 9건",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -344,7 +344,7 @@
      "type": "rectangle",
      "x": 840.0,
      "y": 60.0,
-      "width": 174.0,
+      "width": 150.0,
      "height": 71.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -374,7 +374,7 @@
      "type": "text",
      "x": 850.0,
      "y": 70.0,
-      "width": 154.0,
+      "width": 130.0,
      "height": 51.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -400,11 +400,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": "injection-verification",
  "spec_version": "1.1",
-  "spec_sha256": "611f473e287966f16e1be6d7cd47ea750e670f3c89e904fa7ec945363433293e",
+  "spec_sha256": "0826a08af0195d042f44cb3a9193ff9d9fe84316a739000e989b23b320a9363b",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -4,5 +4,5 @@ flowchart LR
    n0["주입 명령"]
    n1["대상 상태 확인"]
    n2["결과 관측"]
-    n0 -->|"걸렸는가를 먼저 본다"| n1
-    n1 -->|"걸린 뒤에만 결과를 읽는다"| n2
+    n0 -->|"상태 확인"| n1
+    n1 -->|"결과 판독"| n2
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" width="1059" height="300" viewBox="0 0 1059 300" role="img" aria-labelledby="diagram-title diagram-description">
+<svg xmlns="http://www.w3.org/2000/svg" width="1035" height="300" viewBox="0 0 1035 300" role="img" aria-labelledby="diagram-title diagram-description">
 <title id="diagram-title">주입이 걸렸는지 따로 확인한다</title>
 <desc id="diagram-description">이 실험대에서 아홉 번의 주입이 조용히 실패했다. conntrack 이 ESTABLISHED 연결을 통과시키고, kubectl delete --force 가 크래시가 아니며, PID 1 이 SIGKILL 을 무시하고, kube-router 가 iptables 체인을 다시 끼워 넣는다. 모두 아무 일도 없었다로 보였다. 그래서 주입 뒤에는 결과를 보기 전에 대상이 실제로 그 상태인지를 cluster_size, 워커 PID, conntrack 표, 패킷 카운터로 확인한다.</desc>
 <metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;injection-verification&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;주입이 먹지 않는다 — 아홉 번, 전부 조용히&quot;,&quot;line&quot;:113}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
@@ -49,18 +49,18 @@
    .timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
  </style>
 </defs>
-<rect class="canvas" width="1059" height="300" />
+<rect class="canvas" width="1035" height="300" />
 <polyline class="edge kind-request style-solid emphasis-normal" points="220.0,95.5 300.0,95.5 300.0,95.5 380.0,95.5" data-evidence="128-133" />
-<rect class="edge-label-bg" x="254.2" y="53.5" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="300.0" y="68.5">걸렸는가를 먼저 본다</text>
+<rect class="edge-label-bg" x="274.2" y="53.5" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="300.0" y="68.5">상태 확인</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="680.0,95.5 760.0,95.5 760.0,95.5 840.0,95.5" data-evidence="128-133" />
-<rect class="edge-label-bg" x="704.1" y="53.5" width="111.8" height="22" rx="3" />
-<text class="edge-label" x="760.0" y="68.5">걸린 뒤에만 결과를 읽는다</text>
+<rect class="edge-label-bg" x="734.2" y="53.5" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="760.0" y="68.5">결과 판독</text>
 <g id="node-inject">
 <rect class="node-shape kind-process emphasis-primary role-source" data-evidence="109-112" x="70.0" y="60.0" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="145.0" y="87.0">주입 명령</text>
 <line class="node-detail-divider" x1="84.0" y1="108.0" x2="206.0" y2="108.0" />
-<text class="node-detail" x="86.0" y="125.0">아홉 번 조용히 실패했다</text>
+<text class="node-detail" x="86.0" y="125.0">조용한 실패 9건</text>
 </g>
 <g id="node-verify">
 <rect class="node-shape kind-process emphasis-warning role-control" data-evidence="128-133" x="380.0" y="60.0" width="300.0" height="71.0" rx="7" />
@@ -69,9 +69,9 @@
 <text class="node-detail" x="396.0" y="125.0">cluster_size · 워커 PID · conntrack · 패킷 카운터</text>
 </g>
 <g id="node-observe">
-<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="128-131" x="840.0" y="60.0" width="174.0" height="71.0" rx="7" />
-<text class="node-label" x="927.0" y="87.0">결과 관측</text>
-<line class="node-detail-divider" x1="854.0" y1="108.0" x2="1000.0" y2="108.0" />
-<text class="node-detail" x="856.0" y="125.0">주입 실패 = 영향 없음 으로 읽힌다</text>
+<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="128-131" x="840.0" y="60.0" width="150.0" height="71.0" rx="7" />
+<text class="node-label" x="915.0" y="87.0">결과 관측</text>
+<line class="node-detail-divider" x1="854.0" y1="108.0" x2="976.0" y2="108.0" />
+<text class="node-detail" x="856.0" y="125.0">실패 · 무영향 구별 불가</text>
 </g>
 </svg>