From d15cebdc95adc6ce9ebbfe04add55618d622e059 Mon Sep 17 00:00:00 2001
From: Tobias Gesellchen <tobias@gesellix.de>
Date: Fri, 6 Mar 2026 21:57:38 +0100
Subject: [PATCH] Work around Jekyll/Liquid template engine issues

Fix for:

```
  Liquid Exception: Liquid syntax error (line 27): Tag '{% // Response: 200 OK %}' was not properly terminated with regexp: /\%\}/ in REQUEST_RECORDING_CONCEPT.md
/usr/local/bundle/gems/liquid-4.0.4/lib/liquid/block_body.rb:132:in `raise_missing_tag_terminator': Liquid syntax error (line 27): Tag '{%  (Liquid::SyntaxError)
    // Response: 200 OK
%}' was not properly terminated with regexp: /\%\}/
```
---
 docs/REQUEST_RECORDING_CONCEPT.md        | 32 +++++++++++++++---------
 docs/SCMUDC-ENRICHMENT-IMPLEMENTATION.md |  6 +++--
 2 files changed, 24 insertions(+), 14 deletions(-)

diff --git a/docs/REQUEST_RECORDING_CONCEPT.md b/docs/REQUEST_RECORDING_CONCEPT.md
index c5bfa4f..3766bd3 100644
--- a/docs/REQUEST_RECORDING_CONCEPT.md
+++ b/docs/REQUEST_RECORDING_CONCEPT.md
@@ -24,9 +24,11 @@ Authorization: Bearer jGwEmFWr...
 
 {"envelope":{"monoTime":234906,"payloadProtocolVersion":"3.1","payloadType":"scmudc","protocolVersion":"1.0","time":"2026-02-25T23:03:14.976349+00:00","uniqueId":"A81B6A536A98"},"payload":{"deviceInfo":{"boseID":"3230304","deviceID":"A81B6A536A98","deviceType":"SoundTouch 10","serialNumber":"I6332527703739342000020","softwareVersion":"27.0.6.46330.5043500 epdbuild.trunk.hepdswbld04.2022-08-04T11:20:29","systemSerialNumber":"069231P63364828AE"},"events":[{"data":{"play-state":"PAUSE_STATE"},"monoTime":234904,"time":"2026-02-25T23:03:14.973466+00:00","type":"play-state-changed"}]}}
 
-> {% 
+{% raw %}
+> {%
     // Response: 200 OK
 %}
+{% endraw %}
 ```
 
 **Mirror Recording** (missing body):
@@ -40,11 +42,13 @@ Authorization: Bearer jGwEmFWr...
 
 
 
-> {% 
+{% raw %}
+> {%
     // Response: 200 OK
     // Headers:
     // X-Proxy-Origin: upstream-mirror
 %}
+{% endraw %}
 ```
 
 ### Issue 2: Request Flow Complexity
@@ -135,7 +139,7 @@ func (s *Server) SnapshotMiddleware(next http.Handler) http.Handler {
 
         // 3. Inject pointer into context
         ctx := context.WithValue(r.Context(), SnapshotKey, snapshot)
-        
+
         // 4. Restore r.Body for downstream compatibility
         r = r.WithContext(ctx)
         r.Body = io.NopCloser(bytes.NewReader(snapshot.Body))
@@ -209,7 +213,7 @@ func (rm *RecordingManager) RecordInteraction(snapshotID string, response *Respo
         log.Printf("Request snapshot not found: %s", snapshotID)
         return
     }
-    
+
     // Record with guaranteed data integrity
     rm.recorder.RecordInteraction(request, response)
 }
@@ -217,35 +221,39 @@ func (rm *RecordingManager) RecordInteraction(snapshotID string, response *Respo
 func (r *Recorder) RecordInteraction(req *RequestSnapshot, res *ResponseSnapshot) error {
     // Generate .http file with complete data
     var buf bytes.Buffer
-    
+
     // Write request
     fmt.Fprintf(&buf, "### %s %s\n", req.Method, req.URL.String())
     fmt.Fprintf(&buf, "%s %s\n", req.Method, req.URL.String())
     fmt.Fprintf(&buf, "Host: %s\n", req.Host)
-    
+
     for k, vv := range req.Headers {
         for _, v := range vv {
             fmt.Fprintf(&buf, "%s: %s\n", k, v)
         }
     }
-    
+
     buf.WriteString("\n")
     buf.Write(req.Body)
     buf.WriteString("\n\n")
-    
+
     // Write response
+{% raw %}
     buf.WriteString("> {% \n")
+{% endraw %}
     fmt.Fprintf(&buf, "    // Response: %d %s\n", res.StatusCode, http.StatusText(res.StatusCode))
     buf.WriteString("    // Headers:\n")
-    
+
     for k, vv := range res.Headers {
         for _, v := range vv {
             fmt.Fprintf(&buf, "    // %s: %s\n", k, v)
         }
     }
-    
+
+{% raw %}
     buf.WriteString("%}\n\n")
-    
+{% endraw %}
+
     if len(res.Body) > 0 {
         buf.WriteString("/*\n")
         buf.Write(res.Body)
@@ -253,7 +261,7 @@ func (r *Recorder) RecordInteraction(req *RequestSnapshot, res *ResponseSnapshot
     } else {
         buf.WriteString("// [Binary response body: 0 bytes]\n")
     }
-    
+
     // Write to file
     return r.writeToFile(buf.Bytes(), req, res)
 }
diff --git a/docs/SCMUDC-ENRICHMENT-IMPLEMENTATION.md b/docs/SCMUDC-ENRICHMENT-IMPLEMENTATION.md
index 3f9f82b..21d7084 100644
--- a/docs/SCMUDC-ENRICHMENT-IMPLEMENTATION.md
+++ b/docs/SCMUDC-ENRICHMENT-IMPLEMENTATION.md
@@ -90,7 +90,8 @@ Host: events.api.bosecm.com
 POST /v1/scmudc/A81B6A536A98
 ...
 
-> {% 
+{% raw %}
+> {%
     // Response: 200 OK
     // SCMUDC Event Analysis:
     // - Origin: Internal System (device)
@@ -99,6 +100,7 @@ POST /v1/scmudc/A81B6A536A98
     // - Content: Billie Eilish - bad guy (instrumental version)
     // - Account: gesellix
 %}
+{% endraw %}
 ```
 
 ## Web UI Enhancement
@@ -187,4 +189,4 @@ docs/
 - **Browser Compatibility**: Emoji display across different browsers
 - **Data Validation**: Ensure enrichment doesn't introduce errors
 
-This implementation significantly improves the usability of SCMUDC telemetry data while maintaining full backward compatibility and raw data access for advanced users.
\ No newline at end of file
+This implementation significantly improves the usability of SCMUDC telemetry data while maintaining full backward compatibility and raw data access for advanced users.