GitNexus/gitnexus/test/integration/search-core.test.ts

/**
 * P0 Integration Tests: BM25/FTS Search against real LadybugDB
 *
 * Tests: searchFTSFromLbug via core adapter (no repoId) path against
 * indexed test data. Verifies ranked result ordering, score merging,
 * and empty-match behavior.
 *
 * Uses withTestLbugDB wrapper for full lifecycle management.
 */
import { describe, it, expect } from 'vitest';
import { withTestLbugDB } from '../helpers/test-indexed-db.js';
import { searchFTSFromLbug } from '../../src/core/search/bm25-index.js';
import { SEARCH_SEED_DATA, SEARCH_FTS_INDEXES } from '../fixtures/search-seed.js';

// ─── Core adapter path (no repoId) ──────────────────────────────────

withTestLbugDB(
  'search-core',
  (_handle) => {
    describe('searchFTSFromLbug — core adapter (no repoId)', () => {
      it('returns ranked results for a matching query', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 10);

        expect(results.length).toBeGreaterThan(0);

        for (const r of results) {
          expect(r).toHaveProperty('filePath');
          expect(r).toHaveProperty('score');
          expect(r).toHaveProperty('rank');
          expect(typeof r.filePath).toBe('string');
          expect(typeof r.score).toBe('number');
          expect(typeof r.rank).toBe('number');
          expect(r.score).toBeGreaterThan(0);
        }

        // Ranks should be sequential starting from 1
        results.forEach((r, i) => {
          expect(r.rank).toBe(i + 1);
        });
      });

      it('results are ordered by descending score', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 10);

        for (let i = 1; i < results.length; i++) {
          expect(results[i - 1].score).toBeGreaterThanOrEqual(results[i].score);
        }
      });

      it('auth-related files rank higher than unrelated files', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 10);
        const filePaths = results.map((r) => r.filePath);

        expect(filePaths).toContain('src/auth.ts');

        const authIdx = filePaths.indexOf('src/auth.ts');
        const utilsIdx = filePaths.indexOf('src/utils.ts');
        if (utilsIdx !== -1) {
          expect(authIdx).toBeLessThan(utilsIdx);
        }
      });

      it('merges scores from multiple node types for the same filePath', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 20);

        const authResult = results.find((r) => r.filePath === 'src/auth.ts');
        expect(authResult).toBeDefined();

        const routerResult = results.find((r) => r.filePath === 'src/router.ts');
        if (routerResult) {
          expect(authResult!.score).toBeGreaterThan(routerResult.score);
        }
      });

      it('respects limit parameter', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 2);
        expect(results.length).toBeLessThanOrEqual(2);
      });

      it('returns empty array for a non-matching query', async () => {
        const { results } = await searchFTSFromLbug('xyzzyplughtwisty', 10);
        expect(results).toEqual([]);
      });
    });

    // ─── Unhappy paths ──────────────────────────────────────────────────

    describe('unhappy paths', () => {
      it('returns empty array for empty query string', async () => {
        const { results } = await searchFTSFromLbug('', 10);
        expect(results).toEqual([]);
      });

      it('returns empty array for whitespace-only query', async () => {
        const { results } = await searchFTSFromLbug('   ', 10);
        expect(results).toEqual([]);
      });

      it('handles special characters in query gracefully', async () => {
        const { results } = await searchFTSFromLbug('user* OR auth+', 10);
        expect(Array.isArray(results)).toBe(true);
      });

      it('does not treat write-like words inside search text as write operations (#1608)', async () => {
        const { results, ftsAvailable } = await searchFTSFromLbug(
          'create user authentication delete',
          10,
        );
        expect(ftsAvailable).toBe(true);
        expect(results.length).toBeGreaterThan(0);
      });

      it('handles limit of 0', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 0);
        expect(results).toEqual([]);
      });

      it('handles negative limit gracefully', async () => {
        const { results } = await searchFTSFromLbug('user authentication', -1);
        expect(Array.isArray(results)).toBe(true);
      });

      it('handles very large limit', async () => {
        const { results } = await searchFTSFromLbug('user authentication', 100000);
        expect(results.length).toBeLessThanOrEqual(100000);
        expect(results.length).toBeGreaterThan(0);
      });
    });
  },
  {
    seed: SEARCH_SEED_DATA,
    ftsIndexes: SEARCH_FTS_INDEXES,
  },
);