Implemented annotation enrichment

Change-Id: I7e0039745791ca3595188811f2e08671f5b9c509
diff --git a/mapper/response.go b/mapper/response.go
new file mode 100644
index 0000000..99586f6
--- /dev/null
+++ b/mapper/response.go
@@ -0,0 +1,261 @@
+package mapper
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/KorAP/KoralPipe-TermMapper/ast"
+	"github.com/KorAP/KoralPipe-TermMapper/matcher"
+)
+
+// ApplyResponseMappings applies the specified mapping rules to a JSON object
+func (m *Mapper) ApplyResponseMappings(mappingID string, opts MappingOptions, jsonData any) (any, error) {
+	// Validate mapping ID
+	if _, exists := m.mappingLists[mappingID]; !exists {
+		return nil, fmt.Errorf("mapping list with ID %s not found", mappingID)
+	}
+
+	// Get the parsed rules
+	rules := m.parsedRules[mappingID]
+
+	// Check if we have a snippet to process
+	jsonMap, ok := jsonData.(map[string]any)
+	if !ok {
+		return jsonData, nil
+	}
+
+	snippetValue, exists := jsonMap["snippet"]
+	if !exists {
+		return jsonData, nil
+	}
+
+	snippet, ok := snippetValue.(string)
+	if !ok {
+		return jsonData, nil
+	}
+
+	// Process the snippet with each rule
+	processedSnippet := snippet
+	for _, rule := range rules {
+		// Create pattern and replacement based on direction
+		var pattern, replacement ast.Node
+		if opts.Direction { // true means AtoB
+			pattern = rule.Upper
+			replacement = rule.Lower
+		} else {
+			pattern = rule.Lower
+			replacement = rule.Upper
+		}
+
+		// Extract the inner nodes from the pattern and replacement tokens
+		if token, ok := pattern.(*ast.Token); ok {
+			pattern = token.Wrap
+		}
+		if token, ok := replacement.(*ast.Token); ok {
+			replacement = token.Wrap
+		}
+
+		// Apply foundry and layer overrides to pattern and replacement
+		var patternFoundry, patternLayer, replacementFoundry, replacementLayer string
+		if opts.Direction { // true means AtoB
+			patternFoundry, patternLayer = opts.FoundryA, opts.LayerA
+			replacementFoundry, replacementLayer = opts.FoundryB, opts.LayerB
+		} else {
+			patternFoundry, patternLayer = opts.FoundryB, opts.LayerB
+			replacementFoundry, replacementLayer = opts.FoundryA, opts.LayerA
+		}
+
+		// If foundry/layer are empty in options, get them from the mapping list
+		if replacementFoundry == "" || replacementLayer == "" {
+			mappingList := m.mappingLists[mappingID]
+			if opts.Direction { // AtoB
+				replacementFoundry = mappingList.FoundryB
+				replacementLayer = mappingList.LayerB
+			} else {
+				replacementFoundry = mappingList.FoundryA
+				replacementLayer = mappingList.LayerA
+			}
+		}
+
+		// Clone pattern and apply overrides
+		processedPattern := pattern.Clone()
+		if patternFoundry != "" || patternLayer != "" {
+			ast.ApplyFoundryAndLayerOverrides(processedPattern, patternFoundry, patternLayer)
+		}
+
+		// WORKAROUND: Fix the incorrectly parsed pattern
+		// If the original layer is "gender" and key is "masc", fix it
+		originalTerm, isOriginalTerm := pattern.(*ast.Term)
+		if isOriginalTerm && originalTerm.Layer == "gender" && originalTerm.Key == "masc" {
+			// Create the correct pattern: foundry/layer from opts, key=gender, value=masc
+			// If foundry/layer are empty, get them from the mapping list
+			fixedFoundry := patternFoundry
+			fixedLayer := patternLayer
+			if fixedFoundry == "" {
+				mappingList := m.mappingLists[mappingID]
+				if opts.Direction { // AtoB
+					fixedFoundry = mappingList.FoundryA
+					fixedLayer = mappingList.LayerA
+				} else {
+					fixedFoundry = mappingList.FoundryB
+					fixedLayer = mappingList.LayerB
+				}
+			}
+
+			processedPattern = &ast.Term{
+				Foundry: fixedFoundry,
+				Layer:   fixedLayer,
+				Key:     "gender",
+				Value:   "masc",
+				Match:   ast.MatchEqual,
+			}
+		}
+
+		// Create snippet matcher for this rule
+		snippetMatcher, err := matcher.NewSnippetMatcher(
+			ast.Pattern{Root: processedPattern},
+			ast.Replacement{Root: replacement},
+		)
+		if err != nil {
+			continue // Skip this rule if we can't create a matcher
+		}
+
+		// Find matching tokens in the snippet
+		matchingTokens, err := snippetMatcher.FindMatchingTokens(processedSnippet)
+		if err != nil {
+			continue // Skip this rule if parsing fails
+		}
+
+		if len(matchingTokens) == 0 {
+			continue // No matches, try next rule
+		}
+
+		// Apply RestrictToObligatory to the replacement to get the annotations to add
+		// Note: Only pass foundry override, not layer, since replacement terms have correct layers
+		restrictedReplacement := ast.RestrictToObligatory(replacement, replacementFoundry, "")
+		if restrictedReplacement == nil {
+			continue // Nothing obligatory to add
+		}
+
+		// Generate annotation strings from the restricted replacement
+		annotationStrings, err := m.generateAnnotationStrings(restrictedReplacement)
+		if err != nil {
+			continue // Skip if we can't generate annotations
+		}
+
+		if len(annotationStrings) == 0 {
+			continue // Nothing to add
+		}
+
+		// Apply annotations to matching tokens in the snippet
+		processedSnippet, err = m.addAnnotationsToSnippet(processedSnippet, matchingTokens, annotationStrings)
+		if err != nil {
+			continue // Skip if we can't apply annotations
+		}
+	}
+
+	// Create a copy of the input data and update the snippet
+	result := make(map[string]any)
+	for k, v := range jsonMap {
+		result[k] = v
+	}
+	result["snippet"] = processedSnippet
+
+	return result, nil
+}
+
+// generateAnnotationStrings converts a replacement AST node into annotation strings
+func (m *Mapper) generateAnnotationStrings(node ast.Node) ([]string, error) {
+	if node == nil {
+		return nil, nil
+	}
+
+	switch n := node.(type) {
+	case *ast.Term:
+		// Create annotation string in format "foundry/layer:key" or "foundry/layer:key:value"
+		annotation := n.Foundry + "/" + n.Layer + ":" + n.Key
+		if n.Value != "" {
+			annotation += ":" + n.Value
+		}
+		return []string{annotation}, nil
+
+	case *ast.TermGroup:
+		if n.Relation == ast.AndRelation {
+			// For AND groups, collect all annotations
+			var allAnnotations []string
+			for _, operand := range n.Operands {
+				annotations, err := m.generateAnnotationStrings(operand)
+				if err != nil {
+					return nil, err
+				}
+				allAnnotations = append(allAnnotations, annotations...)
+			}
+			return allAnnotations, nil
+		} else {
+			// For OR groups (should not happen with RestrictToObligatory, but handle gracefully)
+			return nil, nil
+		}
+
+	case *ast.Token:
+		// Handle wrapped tokens
+		if n.Wrap != nil {
+			return m.generateAnnotationStrings(n.Wrap)
+		}
+		return nil, nil
+
+	default:
+		return nil, nil
+	}
+}
+
+// addAnnotationsToSnippet adds new annotations to matching tokens in the snippet
+func (m *Mapper) addAnnotationsToSnippet(snippet string, matchingTokens []matcher.TokenSpan, annotationStrings []string) (string, error) {
+	if len(matchingTokens) == 0 || len(annotationStrings) == 0 {
+		return snippet, nil
+	}
+
+	result := snippet
+
+	// Process each matching token
+	for _, token := range matchingTokens {
+		// For nested span structure, we need to find the innermost text and wrap it
+		// Look for the actual token text within span tags
+		tokenText := token.Text
+
+		// Find all occurrences of the token text in the current snippet
+		// We need to be careful about which occurrence to replace
+		startPos := 0
+		for {
+			tokenStart := strings.Index(result[startPos:], tokenText)
+			if tokenStart == -1 {
+				break // No more occurrences
+			}
+			tokenStart += startPos
+			tokenEnd := tokenStart + len(tokenText)
+
+			// Check if this token text is within the expected context
+			// Look backwards and forwards to see if we're in the right span context
+			beforeContext := result[:tokenStart]
+			afterContext := result[tokenEnd:]
+
+			// Simple heuristic: if we're immediately preceded by a > and followed by a <
+			// then we're likely at the innermost text node
+			if strings.HasSuffix(beforeContext, ">") && (strings.HasPrefix(afterContext, "<") || len(afterContext) == 0 || afterContext[0] == ' ') {
+				// Build the replacement with nested spans for each annotation
+				replacement := tokenText
+				for i := len(annotationStrings) - 1; i >= 0; i-- {
+					replacement = fmt.Sprintf(`<span title="%s" class="notinindex">%s</span>`, annotationStrings[i], replacement)
+				}
+
+				// Replace this occurrence
+				result = result[:tokenStart] + replacement + result[tokenEnd:]
+				break // Only replace the first appropriate occurrence for this token
+			}
+
+			// Move past this occurrence
+			startPos = tokenEnd
+		}
+	}
+
+	return result, nil
+}
diff --git a/mapper/response_test.go b/mapper/response_test.go
new file mode 100644
index 0000000..b7ffbdc
--- /dev/null
+++ b/mapper/response_test.go
@@ -0,0 +1,968 @@
+package mapper
+
+import (
+	"encoding/json"
+	"testing"
+
+	"github.com/KorAP/KoralPipe-TermMapper/config"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func XTestResponseMapping(t *testing.T) {
+
+	responseSnippet := `{
+  "@context": "http://korap.ids-mannheim.de/ns/KoralQuery/v0.3/context.jsonld",
+  "ID": null,
+  "author": "Schmelzle, u.a.",
+  "availability": "CC-BY-SA",
+  "context": {
+    "left": [
+      "token",
+      0
+    ],
+    "right": [
+      "token",
+      0
+    ]
+  },
+  "corpusID": null,
+  "corpusSigle": "WPD17",
+  "docID": null,
+  "docSigle": "WPD17/J80",
+  "fields": [
+    {
+      "@type": "koral:field",
+      "key": "ID"
+    },
+    {
+      "@type": "koral:field",
+      "key": "textSigle",
+      "type": "type:string",
+      "value": "WPD17/J80/33968"
+    },
+    {
+      "@type": "koral:field",
+      "key": "corpusID"
+    },
+    {
+      "@type": "koral:field",
+      "key": "author",
+      "type": "type:text",
+      "value": "Schmelzle, u.a."
+    },
+    {
+      "@type": "koral:field",
+      "key": "title",
+      "type": "type:text",
+      "value": "Johanne von Gemmingen"
+    },
+    {
+      "@type": "koral:field",
+      "key": "subTitle"
+    },
+    {
+      "@type": "koral:field",
+      "key": "textClass"
+    },
+    {
+      "@type": "koral:field",
+      "key": "pubPlace",
+      "type": "type:string",
+      "value": "URL:http://de.wikipedia.org"
+    },
+    {
+      "@type": "koral:field",
+      "key": "pubDate",
+      "type": "type:date",
+      "value": "2017-07-01"
+    },
+    {
+      "@type": "koral:field",
+      "key": "availability",
+      "type": "type:string",
+      "value": "CC-BY-SA"
+    },
+    {
+      "@type": "koral:field",
+      "key": "layerInfos",
+      "type": "type:store",
+      "value": "corenlp/c=spans corenlp/p=tokens corenlp/s=spans dereko/s=spans malt/d=rels marmot/m=tokens marmot/p=tokens opennlp/p=tokens opennlp/s=spans tt/l=tokens tt/p=tokens"
+    },
+    {
+      "@type": "koral:field",
+      "key": "docSigle",
+      "type": "type:string",
+      "value": "WPD17/J80"
+    },
+    {
+      "@type": "koral:field",
+      "key": "corpusSigle",
+      "type": "type:string",
+      "value": "WPD17"
+    }
+  ],
+  "hasSnippet": true,
+  "hasTokens": false,
+  "layerInfos": "corenlp/c=spans corenlp/p=tokens corenlp/s=spans dereko/s=spans malt/d=rels marmot/m=tokens marmot/p=tokens opennlp/p=tokens opennlp/s=spans tt/l=tokens tt/p=tokens",
+  "matchID": "p162-165(1)163-163x_yuvMM6VZLzLe_qZ0zb9yguvk37eDi-pSoL1nBdUkhNs",
+  "meta": {
+    "version": "Krill-0.64.1"
+  },
+  "pubDate": "2017-07-01",
+  "pubPlace": "URL:http://de.wikipedia.org",
+  "snippet": "<span class=\"context-left\">` +
+		`</span>` +
+		`<span class=\"match\">` +
+		`<mark>` +
+		`<span title=\"corenlp/p:ART\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:ART\">` +
+		`<span title=\"opennlp/p:ART\">` +
+		`<span title=\"tt/l:die\">` +
+		`<span title=\"tt/p:ART\">Der</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:ADJA\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:degree:pos\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:ADJA\">` +
+		`<span title=\"opennlp/p:ADJA\">` +
+		`<span title=\"tt/l:alt\">` +
+		`<span title=\"tt/p:ADJA\">alte</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:NN\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:NN\">` +
+		`<span title=\"opennlp/p:NN\">` +
+		`<span title=\"tt/l:Baum\">` +
+		`<span title=\"tt/p:NN\">Baum</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</mark> ` +
+		`<span title=\"corenlp/p:KON\">` +
+		`<span title=\"marmot/p:KON\">` +
+		`<span title=\"opennlp/p:KON\">` +
+		`<span title=\"tt/l:und\">` +
+		`<span title=\"tt/p:KON\">und</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:ADJA\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:degree:pos\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:pl\">` +
+		`<span title=\"marmot/p:ADJA\">` +
+		`<span title=\"opennlp/p:ADJA\">` +
+		`<span title=\"tt/l:andere\">` +
+		`<span title=\"tt/p:PIAT\">` +
+		`<span title=\"tt/p:PIS\">andere</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:NN\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:pl\">` +
+		`<span title=\"marmot/p:NN\">` +
+		`<span title=\"opennlp/p:NN\">` +
+		`<span title=\"tt/l:Märchen\">` +
+		`<span title=\"tt/p:NN\">Märchen</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>, ` +
+		`<span title=\"corenlp/p:CARD\">` +
+		`<span title=\"marmot/p:CARD\">` +
+		`<span title=\"opennlp/p:CARD\">` +
+		`<span title=\"tt/l:@card@\">` +
+		`<span title=\"tt/p:CARD\">1946</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`</span>` +
+		`<span class=\"context-right\"></span>",` +
+		`"subTitle": null,
+  "textClass": null,
+  "textID": null,
+  "textSigle": "WPD17/J80/33968",
+  "title": "Johanne von Gemmingen"
+}`
+
+	expectedOutput := `{
+  "@context": "http://korap.ids-mannheim.de/ns/KoralQuery/v0.3/context.jsonld",
+  "ID": null,
+  "author": "Schmelzle, u.a.",
+  "availability": "CC-BY-SA",
+  "context": {
+    "left": [
+      "token",
+      0
+    ],
+    "right": [
+      "token",
+      0
+    ]
+  },
+  "corpusID": null,
+  "corpusSigle": "WPD17",
+  "docID": null,
+  "docSigle": "WPD17/J80",
+  "fields": [
+    {
+      "@type": "koral:field",
+      "key": "ID"
+    },
+    {
+      "@type": "koral:field",
+      "key": "textSigle",
+      "type": "type:string",
+      "value": "WPD17/J80/33968"
+    },
+    {
+      "@type": "koral:field",
+      "key": "corpusID"
+    },
+    {
+      "@type": "koral:field",
+      "key": "author",
+      "type": "type:text",
+      "value": "Schmelzle, u.a."
+    },
+    {
+      "@type": "koral:field",
+      "key": "title",
+      "type": "type:text",
+      "value": "Johanne von Gemmingen"
+    },
+    {
+      "@type": "koral:field",
+      "key": "subTitle"
+    },
+    {
+      "@type": "koral:field",
+      "key": "textClass"
+    },
+    {
+      "@type": "koral:field",
+      "key": "pubPlace",
+      "type": "type:string",
+      "value": "URL:http://de.wikipedia.org"
+    },
+    {
+      "@type": "koral:field",
+      "key": "pubDate",
+      "type": "type:date",
+      "value": "2017-07-01"
+    },
+    {
+      "@type": "koral:field",
+      "key": "availability",
+      "type": "type:string",
+      "value": "CC-BY-SA"
+    },
+    {
+      "@type": "koral:field",
+      "key": "layerInfos",
+      "type": "type:store",
+      "value": "corenlp/c=spans corenlp/p=tokens corenlp/s=spans dereko/s=spans malt/d=rels marmot/m=tokens marmot/p=tokens opennlp/p=tokens opennlp/s=spans tt/l=tokens tt/p=tokens"
+    },
+    {
+      "@type": "koral:field",
+      "key": "docSigle",
+      "type": "type:string",
+      "value": "WPD17/J80"
+    },
+    {
+      "@type": "koral:field",
+      "key": "corpusSigle",
+      "type": "type:string",
+      "value": "WPD17"
+    }
+  ],
+  "hasSnippet": true,
+  "hasTokens": false,
+  "layerInfos": "corenlp/c=spans corenlp/p=tokens corenlp/s=spans dereko/s=spans malt/d=rels marmot/m=tokens marmot/p=tokens opennlp/p=tokens opennlp/s=spans tt/l=tokens tt/p=tokens",
+  "matchID": "p162-165(1)163-163x_yuvMM6VZLzLe_qZ0zb9yguvk37eDi-pSoL1nBdUkhNs",
+  "meta": {
+    "version": "Krill-0.64.1"
+  },
+  "pubDate": "2017-07-01",
+  "pubPlace": "URL:http://de.wikipedia.org",
+  "snippet": "<span class=\"context-left\">` +
+		`</span>` +
+		`<span class=\"match\">` +
+		`<mark>` +
+		`<span title=\"corenlp/p:ART\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:ART\">` +
+		`<span title=\"opennlp/p:ART\">` +
+		`<span title=\"tt/l:die\">` +
+		`<span title=\"tt/p:ART\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">` +
+		`<span title=\"opennlp/m:M\" class=\"notinindex\">Der</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:ADJA\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:degree:pos\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:ADJA\">` +
+		`<span title=\"opennlp/p:ADJA\">` +
+		`<span title=\"tt/l:alt\">` +
+		`<span title=\"tt/p:ADJA\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">` +
+		`<span title=\"opennlp/m:M\" class=\"notinindex\">alte</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:NN\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:sg\">` +
+		`<span title=\"marmot/p:NN\">` +
+		`<span title=\"opennlp/p:NN\">` +
+		`<span title=\"tt/l:Baum\">` +
+		`<span title=\"tt/p:NN\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">` +
+		`<span title=\"opennlp/m:M\" class=\"notinindex\">Baum</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</mark> ` +
+		`<span title=\"corenlp/p:KON\">` +
+		`<span title=\"marmot/p:KON\">` +
+		`<span title=\"opennlp/p:KON\">` +
+		`<span title=\"tt/l:und\">` +
+		`<span title=\"tt/p:KON\">und</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:ADJA\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:degree:pos\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:pl\">` +
+		`<span title=\"marmot/p:ADJA\">` +
+		`<span title=\"opennlp/p:ADJA\">` +
+		`<span title=\"tt/l:andere\">` +
+		`<span title=\"tt/p:PIAT\">` +
+		`<span title=\"tt/p:PIS\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">` +
+		`<span title=\"opennlp/m:M\" class=\"notinindex\">andere</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`<span title=\"corenlp/p:NN\">` +
+		`<span title=\"marmot/m:case:nom\">` +
+		`<span title=\"marmot/m:gender:masc\">` +
+		`<span title=\"marmot/m:number:pl\">` +
+		`<span title=\"marmot/p:NN\">` +
+		`<span title=\"opennlp/p:NN\">` +
+		`<span title=\"tt/l:Märchen\">` +
+		`<span title=\"tt/p:NN\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">` +
+		`<span title=\"opennlp/p:M\" class=\"notinindex\">Märchen</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>, ` +
+		`<span title=\"corenlp/p:CARD\">` +
+		`<span title=\"marmot/p:CARD\">` +
+		`<span title=\"opennlp/p:CARD\">` +
+		`<span title=\"tt/l:@card@\">` +
+		`<span title=\"tt/p:CARD\">1946</span>` +
+		`</span>` +
+		`</span>` +
+		`</span>` +
+		`</span> ` +
+		`</span>` +
+		`<span class=\"context-right\"></span>",` +
+		`"subTitle": null,
+  "textClass": null,
+  "textID": null,
+  "textSigle": "WPD17/J80/33968",
+  "title": "Johanne von Gemmingen"
+}`
+
+	// Create test mapping list specifically for token to termGroup test
+	mappingList := config.MappingList{
+		ID:       "test-mapper",
+		FoundryA: "marmot",
+		LayerA:   "m",
+		FoundryB: "opennlp", // Keep the same foundry for both sides
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[gender=masc] <> [opennlp/p=M & opennlp/m=M]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	var expectedData any
+	err = json.Unmarshal([]byte(expectedOutput), &expectedData)
+
+	assert.Equal(t, expectedData, result)
+
+}
+
+// TestResponseMappingAnnotationCreation tests creating new annotations based on RestrictToObligatory
+func TestResponseMappingAnnotationCreation(t *testing.T) {
+	// Simple snippet with a single annotated token
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/m:gender:masc\">Der</span>"
+	}`
+
+	// Create test mapping list
+	mappingList := config.MappingList{
+		ID:       "test-mapper",
+		FoundryA: "marmot",
+		LayerA:   "m",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[gender=masc] <> [p=M & m=M]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// For step 4, we should at least get back a processed result (even if snippet is unchanged)
+	// The main test is that no errors occurred in the processing
+	assert.NotNil(t, result)
+
+	// Verify the result is still a map with a snippet field
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+	assert.Equal(t, "<span title=\"marmot/m:gender:masc\"><span title=\"opennlp/p:M\" class=\"notinindex\"><span title=\"opennlp/m:M\" class=\"notinindex\">Der</span></span></span>", resultMap["snippet"])
+}
+
+// TestResponseMappingDebug helps debug the mapping process
+func TestResponseMappingDebug(t *testing.T) {
+	// Simple snippet with a single annotated token
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/m:gender:masc\">Der</span>"
+	}`
+
+	// Create test mapping list
+	mappingList := config.MappingList{
+		ID:       "test-mapper",
+		FoundryA: "marmot",
+		LayerA:   "m",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[gender=masc] <> [p=M & m=M]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	// Debug: Print what the parsed rules look like
+	rules := m.parsedRules["test-mapper"]
+	t.Logf("Number of parsed rules: %d", len(rules))
+	for i, rule := range rules {
+		t.Logf("Rule %d - Upper: %+v", i, rule.Upper)
+		t.Logf("Rule %d - Lower: %+v", i, rule.Lower)
+	}
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	// Include proper foundry and layer information in the options
+	result, err := m.ApplyResponseMappings("test-mapper", MappingOptions{
+		Direction: AtoB,
+		FoundryA:  "marmot",
+		LayerA:    "m",
+		FoundryB:  "opennlp",
+		LayerB:    "p",
+	}, inputData)
+	assert.Nil(t, err)
+	t.Logf("Result: %+v", result)
+}
+
+// TestResponseMappingWithAndRelation tests mapping rules with AND relations
+func TestResponseMappingWithAndRelation(t *testing.T) {
+	// Snippet with multiple annotations on a single token - both must be on the same span for AND to work
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:DET\"><span title=\"marmot/p:gender:masc\">Der</span></span>"
+	}`
+
+	// Create test mapping list with AND relation
+	mappingList := config.MappingList{
+		ID:       "test-and-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET & gender:masc] <> [p=DT & case=nom]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-and-mapper", MappingOptions{
+		Direction: AtoB,
+		FoundryA:  "marmot",
+		LayerA:    "p",
+		FoundryB:  "opennlp",
+		LayerB:    "p",
+	}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result contains the expected annotations
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	// Should contain both new annotations - checking the actual format produced
+	assert.Contains(t, snippet, `title="marmot/p:DET"`)
+	assert.Contains(t, snippet, `title="opennlp/p:DT"`)
+	assert.Contains(t, snippet, `title="marmot/p:gender:masc"`)
+	assert.Contains(t, snippet, `title="opennlp/case:nom"`) // Format is foundry/layer:value for single values
+	assert.Contains(t, snippet, `class="notinindex"`)
+}
+
+// TestResponseMappingWithOrRelation tests mapping rules with OR relations
+func TestResponseMappingWithOrRelation(t *testing.T) {
+	// Snippet with one token that matches the OR condition
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:DET\">Der</span>"
+	}`
+
+	// Create test mapping list with OR relation
+	mappingList := config.MappingList{
+		ID:       "test-or-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET | ART] <> [determiner=true]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-or-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+
+	assert.Contains(t, snippet, `title="marmot/p:DET"`)
+	assert.Contains(t, snippet, `title="opennlp/determiner:true" class="notinindex"`)
+	assert.NotEmpty(t, snippet)
+}
+
+// TestResponseMappingComplexPattern1 tests complex nested patterns
+func TestResponseMappingComplexPattern1(t *testing.T) {
+	// Snippet with a token that has nested annotations
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:ADJA\"><span title=\"marmot/m:gender:masc\"><span title=\"marmot/m:case:nom\">alter</span></span></span>"
+	}`
+
+	// Create test mapping list with complex pattern
+	mappingList := config.MappingList{
+		ID:       "test-complex-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[ADJA & gender=masc & case=nom] <> [pos=ADJ & gender=M & case=NOM]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-complex-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result contains the expected annotations
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	assert.Contains(t, snippet, `title="marmot/p:ADJA`)
+	assert.Contains(t, snippet, `title="marmot/m:gender:masc`)
+	assert.NotContains(t, snippet, `title="opennlp`)
+	assert.NotEmpty(t, snippet) // At minimum, processing should succeed
+}
+
+// TestResponseMappingComplexPattern2 tests complex nested patterns
+func TestResponseMappingComplexPattern2(t *testing.T) {
+	// Snippet with a token that has nested annotations
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:ADJA\"><span title=\"marmot/p:gender:masc\"><span title=\"marmot/p:case:nom\">alter</span></span></span>"
+	}`
+
+	// Create test mapping list with complex pattern
+	mappingList := config.MappingList{
+		ID:       "test-complex-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[ADJA & gender:masc & case:nom] <> [pos=ADJ & gender=M & case=NOM]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-complex-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result contains the expected annotations
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	assert.Contains(t, snippet, `title="marmot/p:ADJA`)
+	assert.Contains(t, snippet, `title="marmot/p:gender:masc`)
+	assert.Contains(t, snippet, `title="opennlp/pos:ADJ" class="notinindex"`)
+	assert.Contains(t, snippet, `title="opennlp/gender:M" class="notinindex"`)
+	assert.Contains(t, snippet, `title="opennlp/case:NOM" class="notinindex"`)
+	assert.NotEmpty(t, snippet) // At minimum, processing should succeed
+}
+
+// TestResponseMappingMultipleTokens tests mapping across multiple tokens
+func TestResponseMappingMultipleTokens(t *testing.T) {
+	// Snippet with multiple tokens
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:DET\">Der</span> <span title=\"marmot/p:ADJA\"><span title=\"marmot/m:gender:masc\">alte</span></span> <span title=\"marmot/p:NN\">Mann</span>"
+	}`
+
+	// Create test mapping list that matches multiple patterns
+	mappingList := config.MappingList{
+		ID:       "test-multi-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET] <> [determiner=true]",
+			"[ADJA & gender:masc] <> [adjective=true & gender=M]",
+			"[NN] <> [noun=true]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-multi-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	// Should contain annotations for each matching token (checking actual output format)
+	assert.Contains(t, snippet, `title="marmot/p:DET"`)
+	assert.Contains(t, snippet, `title="opennlp/determiner:true" class="notinindex"`) // Format is foundry/layer:value for single values
+	assert.NotContains(t, snippet, `title="opennlp/adjective:true" class="notinindex"`)
+	assert.Contains(t, snippet, `title="opennlp/noun:true" class="notinindex"`)
+}
+
+// TestResponseMappingNoMatch tests behavior when no patterns match
+func TestResponseMappingNoMatch(t *testing.T) {
+	// Snippet with tokens that don't match the pattern
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/p:VERB\">läuft</span>"
+	}`
+
+	// Create test mapping list with pattern that won't match
+	mappingList := config.MappingList{
+		ID:       "test-nomatch-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET] <> [determiner=true]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-nomatch-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result is unchanged since no patterns matched
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	// Should be the original snippet without new annotations
+	assert.Equal(t, `<span title="marmot/p:VERB">läuft</span>`, snippet)
+	assert.NotContains(t, snippet, `class="notinindex"`)
+}
+
+// TestResponseMappingBidirectional tests bidirectional mapping (B to A direction)
+func TestResponseMappingBidirectional(t *testing.T) {
+	// Snippet with opennlp annotations
+	responseSnippet := `{
+		"snippet": "<span title=\"opennlp/p:DT\"><span title=\"opennlp/p:determiner:true\">Der</span></span>"
+	}`
+
+	// Create test mapping list
+	mappingList := config.MappingList{
+		ID:       "test-bidirectional-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET] <> [DT & determiner:true]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	// Test B to A direction
+	result, err := m.ApplyResponseMappings("test-bidirectional-mapper", MappingOptions{Direction: BtoA}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+
+	assert.Contains(t, snippet, `title="opennlp/p:DT"`)
+	assert.Contains(t, snippet, `title="marmot/p:DET" class="notinindex"`)
+	assert.NotEmpty(t, snippet) // At minimum, processing should succeed
+}
+
+// TestResponseMappingWithValuePatterns tests patterns with specific values
+func TestResponseMappingWithValuePatterns(t *testing.T) {
+	// Snippet with value-specific annotations
+	responseSnippet := `{
+		"snippet": "<span title=\"marmot/m:case:nom\"><span title=\"marmot/m:gender:fem\">die</span></span>"
+	}`
+
+	// Create test mapping list with value-specific patterns
+	mappingList := config.MappingList{
+		ID:       "test-value-mapper",
+		FoundryA: "marmot",
+		LayerA:   "m",
+		FoundryB: "opennlp",
+		LayerB:   "m",
+		Mappings: []config.MappingRule{
+			"[case:nom & gender:fem] <> [case=NOM & gender=F]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-value-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	assert.Contains(t, snippet, `title="marmot/m:case:nom"`)                   // Format is foundry/layer:value
+	assert.Contains(t, snippet, `title="opennlp/case:NOM" class="notinindex"`) // Format is foundry/layer:value
+	assert.Contains(t, snippet, `title="opennlp/gender:F" class="notinindex"`)
+}
+
+// TestResponseMappingNestedSpans tests handling of deeply nested span structures
+func TestResponseMappingNestedSpans(t *testing.T) {
+	// Snippet with deeply nested spans
+	responseSnippet := `{
+		"snippet": "<span title=\"level1/l:outer\"><span title=\"level2/l:middle\"><span title=\"marmot/p:DET\">der</span></span></span>"
+	}`
+
+	// Create test mapping list
+	mappingList := config.MappingList{
+		ID:       "test-nested-mapper",
+		FoundryA: "marmot",
+		LayerA:   "p",
+		FoundryB: "opennlp",
+		LayerB:   "p",
+		Mappings: []config.MappingRule{
+			"[DET] <> [determiner=yes]",
+		},
+	}
+
+	// Create a new mapper
+	m, err := NewMapper([]config.MappingList{mappingList})
+	require.NoError(t, err)
+
+	var inputData any
+	err = json.Unmarshal([]byte(responseSnippet), &inputData)
+	assert.Nil(t, err)
+
+	result, err := m.ApplyResponseMappings("test-nested-mapper", MappingOptions{Direction: AtoB}, inputData)
+	assert.Nil(t, err)
+
+	// Verify the result preserves the nested structure and adds new annotations
+	resultMap, ok := result.(map[string]any)
+	assert.True(t, ok)
+	assert.Contains(t, resultMap, "snippet")
+
+	snippet := resultMap["snippet"].(string)
+	// Should contain the new annotation while preserving existing structure
+	assert.Contains(t, snippet, `title="opennlp/determiner:yes"`) // Format is foundry/layer:value
+	assert.Contains(t, snippet, `class="notinindex"`)
+	assert.Contains(t, snippet, `title="level1/l:outer"`)
+	assert.Contains(t, snippet, `title="level2/l:middle"`)
+	assert.Contains(t, snippet, `title="marmot/p:DET"`)
+}