backend/src/main/java/org/raddatz/familienarchiv/search/NlQueryParserService.java

@@ -161,6 +161,7 @@ public class NlQueryParserService {
                 ? new ArrayList<>(seen).subList(0, MAX_RESOLVED_TAGS)
                 : new ArrayList<>(seen);
 
+        // safe: entities are detached here; mutation is for DTO projection only, no dirty-check fires
         tagService.resolveEffectiveColors(capped);
 
         List<TagHint> hints = capped.stream()

frontend/src/routes/search/InterpretationChipRow.svelte.spec.ts

@@ -1,3 +1,6 @@
+// NOTE: vitest-browser fails silently when the project path contains '+' (common in git worktrees
+// named 'feat+issue-NNN-slug'). If tests fail with iframe routing errors, copy the frontend
+// directory to a path without '+' (e.g. /tmp/fe-copy) and run the suite from there.
 import { describe, expect, it, vi, afterEach } from 'vitest';
 import { cleanup, render } from 'vitest-browser-svelte';
 import { page } from 'vitest/browser';