feat(viz): Add dual-score display and improve UI controls

This commit enhances the vector visualization interface with better score
transparency and improved UX:

**Dual-Score Display:**
- Store original algorithm scores before normalization (viz_routes.py:203)
- Display both raw and normalized scores: "Raw Score: 0.842 (89% relative)"
- Update plot hover text with dual scores (userinfo_routes.py:740)
- Fixes issue where all queries showed at least one 100% match regardless
  of actual relevance (normalization artifact)

**UI Improvements:**
1. Fusion Method dropdown: Changed from x-show to :disabled
   - Prevents jarring layout shift when switching algorithms
   - Dropdown stays visible but grayed out when Semantic is selected
   - Better UX with opacity: 0.5 and cursor: not-allowed

2. Score Threshold: Changed step from 0.1 to "any"
   - Allows arbitrary float precision (0.7, 0.85, 0.123)
   - Users can now fine-tune threshold values

3. Document Types: Converted multi-select to checkbox grid
   - Replaced clunky Ctrl/Cmd multi-select listbox
   - Checkbox grid with cleaner layout
   - Positioned left of Score Threshold and Result Limit inputs
   - More intuitive UX

**Technical Details:**
- Raw score ranges vary by algorithm:
  - Semantic: 0.0-1.0 (cosine similarity)
  - BM25 RRF: ~0.001-0.033 (Reciprocal Rank Fusion)
  - BM25 DBSF: Can exceed 1.0 (Distribution-Based Score Fusion)
- Normalized scores (0-1) used for visual encoding (marker size, color)
- Original scores preserved in API response via getattr fallback

Files modified:
- nextcloud_mcp_server/auth/viz_routes.py (store original_score)
- nextcloud_mcp_server/auth/templates/vector_viz.html (UI controls)
- nextcloud_mcp_server/auth/userinfo_routes.py (plot hover text)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

.gitmodules

@@ -1,6 +1,6 @@
-[submodule "oidc"]
-	path = third_party/oidc
-	url = https://github.com/cbcoutinho/oidc
 [submodule "third_party/oidc"]
 	path = third_party/oidc
 	url = https://github.com/cbcoutinho/oidc
+[submodule "third_party/notes"]
+	path = third_party/notes
+	url = https://github.com/cbcoutinho/notes

CHANGELOG.md

@@ -1,16 +1,3 @@
-## v0.41.0 (2025-11-17)
-
-### Feat
-
-- add configurable fusion algorithms for BM25 hybrid search
-- add chunk position tracking to vector indexing and search
-- add vector viz template and chunk context endpoint
-
-### Fix
-
-- prevent infinite loop in DocumentChunker with position tracking
-- Relax SearchResult validation to support DBSF fusion scores > 1.0
-
 ## v0.40.0 (2025-11-16)
 
 ### Feat

charts/nextcloud-mcp-server/Chart.yaml

@@ -2,8 +2,8 @@ apiVersion: v2
 name: nextcloud-mcp-server
 description: A Helm chart for Nextcloud MCP Server - enables AI assistants to interact with Nextcloud
 type: application
-version: 0.41.0
-appVersion: "0.41.0"
+version: 0.40.0
+appVersion: "0.40.0"
 keywords:
   - nextcloud
   - mcp

nextcloud_mcp_server/auth/templates/vector_viz.html

@@ -186,9 +186,9 @@
                         </select>
                     </div>
 
-                    <div class="viz-control-group" style="margin-bottom: 0;" x-show="algorithm === 'bm25_hybrid'">
+                    <div class="viz-control-group" style="margin-bottom: 0;">
                         <label>Fusion Method</label>
-                        <select x-model="fusion">
+                        <select x-model="fusion" :disabled="algorithm !== 'bm25_hybrid'" :style="algorithm !== 'bm25_hybrid' ? 'opacity: 0.5; cursor: not-allowed;' : ''">
                             <option value="rrf" selected>RRF (Reciprocal Rank Fusion)</option>
                             <option value="dbsf">DBSF (Distribution-Based Score Fusion)</option>
                         </select>
@@ -211,24 +211,39 @@
 
                     <div class="viz-advanced-grid">
                         <div class="viz-control-group">
-                            <label>Document Types</label>
-                            <select x-model="docTypes" multiple>
-                                <option value="">All Types (cross-app search)</option>
-                                <option value="note">Notes</option>
-                                <option value="file">Files</option>
-                                <option value="calendar">Calendar Events</option>
-                                <option value="contact">Contacts</option>
-                                <option value="deck">Deck Cards</option>
-                            </select>
-                            <small style="color: #666; display: block; margin-top: 4px;">
-                                Hold Ctrl/Cmd to select multiple
-                            </small>
+                            <label style="display: block; margin-bottom: 8px;">Document Types</label>
+                            <div style="display: grid; grid-template-columns: 1fr; gap: 6px;">
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="" style="margin-right: 8px;">
+                                    <span>All Types</span>
+                                </label>
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="note" style="margin-right: 8px;">
+                                    <span>Notes</span>
+                                </label>
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="file" style="margin-right: 8px;">
+                                    <span>Files</span>
+                                </label>
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="calendar" style="margin-right: 8px;">
+                                    <span>Calendar Events</span>
+                                </label>
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="contact" style="margin-right: 8px;">
+                                    <span>Contacts</span>
+                                </label>
+                                <label style="display: flex; align-items: center; cursor: pointer; font-weight: normal;">
+                                    <input type="checkbox" x-model="docTypes" value="deck" style="margin-right: 8px;">
+                                    <span>Deck Cards</span>
+                                </label>
+                            </div>
                         </div>
 
                         <div>
                             <div class="viz-control-group">
                                 <label>Score Threshold (Semantic/Hybrid)</label>
-                                <input type="number" x-model.number="scoreThreshold" min="0" max="1" step="0.1" />
+                                <input type="number" x-model.number="scoreThreshold" min="0" max="1" step="any" />
                             </div>
 
                             <div class="viz-control-group">
@@ -284,7 +299,8 @@
                         </a>
                         <div style="font-size: 14px; color: #666; margin-top: 4px;" x-text="result.excerpt"></div>
                         <div style="font-size: 12px; color: #999; margin-top: 4px;">
-                            Score: <span x-text="result.score.toFixed(3)"></span> |
+                            Raw Score: <span x-text="result.original_score.toFixed(3)"></span>
+                            (<span x-text="(result.score * 100).toFixed(0)"></span>% relative) |
                             Type: <span x-text="result.doc_type"></span>
                         </div>
 

nextcloud_mcp_server/auth/userinfo_routes.py

@@ -737,7 +737,7 @@ async def user_info_html(request: Request) -> HTMLResponse:
                             y: coordinates.map(c => c[1]),
                             mode: 'markers',
                             type: 'scatter',
-                            text: results.map(r => `${{r.title}}<br>Score: ${{r.score.toFixed(3)}}`),
+                            text: results.map(r => `${{r.title}}<br>Raw Score: ${{r.original_score.toFixed(3)}} (${{(r.score * 100).toFixed(0)}}% relative)`),
                             marker: {{
                                 // Multi-channel encoding: size + opacity + color for visual hierarchy
                                 // Power scaling (score^2) amplifies visual differences dramatically

nextcloud_mcp_server/auth/viz_routes.py

@@ -184,7 +184,7 @@ async def vector_visualization_search(request: Request) -> JSONResponse:
             search_results = all_results[:limit]
             search_duration = time.perf_counter() - search_start
 
-        # Normalize scores relative to this result set for better visualization
+        # Store original scores and normalize for visualization
         # (best result = 1.0, worst result = 0.0 within THIS result set)
         # This makes visual encoding meaningful regardless of RRF normalization
         if search_results:
@@ -197,8 +197,11 @@ async def vector_visualization_search(request: Request) -> JSONResponse:
                 f"→ [0.0, 1.0]"
             )
 
-            # Rescale each result's score to 0-1 within this result set
+            # Store original score and rescale to 0-1 for visualization
             for r in search_results:
+                # Store original score before normalization
+                r.original_score = r.score
+                # Rescale for visual encoding
                 r.score = (r.score - min_score) / score_range
 
         if not search_results:
@@ -317,7 +320,10 @@ async def vector_visualization_search(request: Request) -> JSONResponse:
                 "doc_type": r.doc_type,
                 "title": r.title,
                 "excerpt": r.excerpt,
-                "score": r.score,
+                "score": r.score,  # Normalized score for visual encoding (0-1)
+                "original_score": getattr(
+                    r, "original_score", r.score
+                ),  # Raw score from algorithm
                 "chunk_start_offset": r.chunk_start_offset,
                 "chunk_end_offset": r.chunk_end_offset,
             }

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nextcloud-mcp-server"
-version = "0.41.0"
+version = "0.40.0"
 description = "Model Context Protocol (MCP) server for Nextcloud integration - enables AI assistants to interact with Nextcloud data"
 authors = [
     {name = "Chris Coutinho", email = "chris@coutinho.io"}

uv.lock

@@ -1857,7 +1857,7 @@ wheels = [
 
 [[package]]
 name = "nextcloud-mcp-server"
-version = "0.41.0"
+version = "0.40.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiosqlite" },