Feature: Context Vector Search
  As a developer
  I want semantic context helpers validated
  So that context-aware vector search stays reliable

# TODO: Uncomment when step definitions are implemented
#   Scenario: Refresh occurs after adding context when vector search is enabled
#     Given a context service with vector search enabled
#     And I have a vector context file "vector.md" with content:
#       """
#       Vector content
#       """
#     When I add the file "vector.md" to the vector-aware context
#     Then the vector index should have refreshed 1 time
#
#   Scenario: Refresh is skipped when vector search is disabled
#     Given a context service with vector search disabled
#     And I have a vector context file "vector.md" with content:
#       """
#       Vector content
#       """
#     When I add the file "vector.md" to the vector-aware context
#     Then the vector index should have refreshed 0 times
#
#   Scenario: Removing files triggers vector index refresh
#     Given a context service with vector search enabled
#     And I have a vector context file "remove.md" with content:
#       """
#       Remove me
#       """
#     When I add the file "remove.md" to the vector-aware context
#     And I remove the file "remove.md" from the vector-aware context
#     Then the vector index should have refreshed 2 times
#
#   Scenario: Clearing context triggers vector index refresh
#     Given a context service with vector search enabled
#     And I have a vector context file "clear.md" with content:
#       """
#       Clear me
#       """
#     When I add the file "clear.md" to the vector-aware context
#     And I clear the vector-aware context
#     Then the vector index should have refreshed 2 times
#
#   Scenario: Semantic search returns stubbed results when enabled
#     Given a context service with vector search enabled
#     And the vector store stub will return "doc.md" with score 0.9
#     When I search the context for "Need insight" with limit 1
#     Then the semantic search results should include "doc.md" with score 0.9
#     And the vector store query count should be 1
#
#   Scenario: Semantic search returns empty when disabled or blank
#     Given a context service with vector search disabled
#     When I search the context for "Need nothing" with limit 1
#     Then the semantic search results should be empty
#     And the vector store query count should be 0
#     When I search the context for "   " with limit 1
#     Then the semantic search results should be empty
#     And the vector store query count should be 0
#
#   Scenario: Skip semantic search when the project lacks an identifier
#     Given a context service with vector search enabled
#     And the vector test project loses its identifier
#     When I search the context for "Untracked request" with limit 1
#     Then the semantic search results should be empty
#     And the vector store query count should be 0
#
#   Scenario: Continue after configuration error during vector refresh
#     Given a context service with vector search enabled
#     And the vector store refresh fails with configuration error
#     And I have a vector context file "refresh.md" with content:
#       """
#       Trigger refresh failure
#       """
#     When I add the file "refresh.md" to the vector-aware context
#     Then the vector index should have refreshed 1 time
#
#   Scenario: Continue after configuration error during semantic search
#     Given a context service with vector search enabled
#     And the vector store search fails with configuration error
#     When I search the context for "Diagnostic query" with limit 1
#     Then the semantic search results should be empty
#     And the vector store query count should be 1