save progress

docs/reachability/gates.md

@@ -88,6 +88,8 @@ Detects configuration-based gates:
 
 ### DetectedGate
 
+**Note:** In **Signals API outputs**, `type` is serialized as the C# enum name (e.g., `"AuthRequired"`). In **richgraph-v1** JSON, `type` is lowerCamelCase and gate fields are snake_case (see example below).
+
 ```typescript
 interface DetectedGate {
   type: 'AuthRequired' | 'FeatureFlag' | 'AdminOnly' | 'NonDefaultConfig';
@@ -130,6 +132,25 @@ public sealed record RichGraphEdge
 }
 ```
 
+**richgraph-v1 JSON example (edge fragment):**
+
+```json
+{
+  "gate_multiplier_bps": 3000,
+  "gates": [
+    {
+      "type": "authRequired",
+      "detail": "[Authorize] attribute on controller",
+      "guard_symbol": "MyController.VulnerableAction",
+      "source_file": "src/MyController.cs",
+      "line_number": 42,
+      "detection_method": "csharp.attribute",
+      "confidence": 0.95
+    }
+  ]
+}
+```
+
 ### ReachabilityReport
 
 Gates are included in the reachability report: