fix: handle Qdrant vector dimension mismatch when switching embedding models (#5562)

[daniel-lxs]

Description

Fixes #5562

This PR improves error handling when switching between embedding models with different vector dimensions in the Qdrant vector store. Previously, users would encounter unclear errors when the vector dimensions didn't match. Now, the system attempts to recreate the collection with the new dimensions and provides a clear, internationalized error message if the operation fails.

Changes Made

• Enhanced error handling in qdrant-client.ts to detect vector dimension mismatches during collection recreation
• Added logic to attempt deletion and recreation of the collection when dimensions change
• Implemented internationalized error messages using the key embeddings:vectorStore.vectorDimensionMismatch
• Updated error handling to preserve specific error types instead of wrapping them in generic errors
• Added comprehensive test coverage for dimension mismatch scenarios

Testing

• All existing tests pass
• Added new test cases in qdrant-client.spec.ts for:
  • Vector dimension mismatch detection
  • Collection recreation on dimension change
  • Proper error message display
• Manual testing completed:
  • Verified error handling when switching between models with different dimensions
  • Confirmed internationalized error messages display correctly

Verification of Acceptance Criteria

• Clear error message when vector dimensions don't match
• Automatic attempt to recreate collection with new dimensions
• Proper error handling if recreation fails
• All error messages are internationalized
• No breaking changes to existing functionality

Checklist

• Code follows project style guidelines
• Self-review completed
• Comments added for complex logic
• Documentation updated (error messages)
• No breaking changes
• All tests passing
• Internationalization complete for all supported languages

Files Changed

• src/services/code-index/vector-store/qdrant-client.ts - Enhanced error handling for dimension mismatches
• src/services/code-index/vector-store/__tests__/qdrant-client.spec.ts - Added comprehensive test coverage
• src/i18n/locales/*/embeddings.json - Added new error message translations for all supported languages

---

Important

Enhances error handling for Qdrant vector dimension mismatches, adds internationalized error messages, and updates tests.

• Behavior:
  • Enhanced error handling in qdrant-client.ts for vector dimension mismatches during collection recreation.
  • Attempts to delete and recreate collection if dimensions change.
  • Throws vectorDimensionMismatch error with original error as cause if recreation fails.
  • Logs errors and warnings appropriately.
• Internationalization:
  • Added vectorDimensionMismatch error message to embeddings.json in multiple locales.
• Testing:
  • Added tests in qdrant-client.spec.ts for dimension mismatch detection and error handling.
  • Tests cover scenarios where collection recreation fails due to delete or create errors.

^{This description was created by for 8903a7b. You can customize this summary. It will automatically update as commits are pushed.}

[delve-auditor]

✅ No security or compliance issues detected. Reviewed everything up to 8903a7b.

Security Overview

• 🔎 Scanned files: 20 changed file(s)

Detected Code Changes

Change Type	Relevant files
Enhancement	► embeddings.json     Add vector dimension mismatch error messages for all locales ► qdrant-client.ts     Improve error handling for vector dimension mismatches ► qdrant-client.spec.ts     Add tests for vector dimension mismatch scenarios

Reply to this PR with @delve-auditor followed by a description of what change you want and we'll auto-submit a change to this PR to implement it.