feat: Associate boost factor data with a session id

[kgilpin]

This allows multiple jobs / sessions to be using the index concurrently, applying different boost factors according to their needs.

Requirements

When searching for code and files, add a session id for the boost records.

When searching, the session id is a required argument, and it is used to select only the boost
records that are relevant to the current search session.

---

/include=search/src

Plan changes only in packages/search/src

Navie Plan

Add session id to search boost records in packages/search

Problem
The search system needs to differentiate between boost records from different search sessions to ensure boost records only affect search results within their intended context. This change should be implemented within the packages/search/src directory.

Analysis
We need to modify the file index and search functionality to support session-specific boost records. This involves:

1. Adding session id to boost record storage
2. Filtering boost records by session id during search
3. Ensuring all boost operations include a session id

The core changes will be in the FileIndex class, which manages the SQLite database tables for file content and boost records.

Proposed Changes

1. packages/search/src/file-index.ts:

   • Update the file_boost table schema to include a session_id column
   • Modify the boostFile method to require a session id parameter
   • Update the search SQL query to filter boost records by session id
   • Add session id parameter to search method signature

2. packages/search/src/types.ts (new file):

   • Define interfaces for boost and search operations that include session id
   • Define types for search results and boost records

3. packages/search/src/snippet-index.ts:

   • Update the snippet boosting functionality to include session id
   • Modify snippet search to consider session-specific boost factors
   • Update the search query to filter boost records by session id

4. packages/search/src/index.ts:

   • Export the new session-aware interfaces and types
   • Update the public API to include session id in boost and search operations

This implementation focuses exclusively on the search package and maintains its core functionality while adding session-specific boost capabilities.

Review

✅ Logical Changes

The changes introduce a session ID to associate boost factors with specific search sessions, ensuring that boosts are session-specific and do not interfere with other sessions. Additionally, the database schema for boost tables is modified to include session_id as part of the primary key, and tests are updated to reflect these changes. Documentation is also added to explain the purpose of the session ID.

✅ Possible Bugs to Investigate

Notes

The initial review called out the lack of documentation for the session id feature.

[appland-release]

🎉 This PR is included in version @appland/search-v1.1.0 🎉

The release is available on:

• @appland/search-v1.1.0
• GitHub release
• @appland/search-v1.1.0

Your semantic-release bot 📦🚀

[appland-release]

🎉 This PR is included in version @appland/appmap-v3.175.0 🎉

The release is available on:

• @appland/appmap-v3.175.0
• GitHub release
• @appland/appmap-v3.175.0

Your semantic-release bot 📦🚀