import { describe, it, expect } from 'vitest'; import * as fs from 'node:fs'; import * as path from 'node:path'; import * as os from 'node:os'; import { syncGroup, stableRepoPoolId } from '../../../src/core/group/sync.js'; import type { GroupConfig, StoredContract, RepoHandle, GroupManifestLink, } from '../../../src/core/group/types.js'; import type { RegistryEntry } from '../../../src/storage/repo-manager.js'; describe('syncGroup', () => { const makeConfig = (repos: Record): GroupConfig => ({ version: 1, name: 'test', description: '', repos, links: [], packages: {}, detect: { http: true, grpc: false, topics: false, shared_libs: false, embedding_fallback: false, }, matching: { bm25_threshold: 0.7, embedding_threshold: 0.65, max_candidates_per_step: 3 }, }); it('returns SyncResult with contracts and cross-links', async () => { const config = makeConfig({ 'app/backend': 'backend-repo', 'app/frontend': 'frontend-repo' }); const mockContracts: StoredContract[] = [ { contractId: 'http::GET::/api/users', type: 'http', role: 'provider', symbolUid: 'uid-1', symbolRef: { filePath: 'src/ctrl.ts', name: 'UserController.list' }, symbolName: 'UserController.list', confidence: 0.8, meta: { method: 'GET', path: '/api/users' }, repo: 'app/backend', }, { contractId: 'http::GET::/api/users', type: 'http', role: 'consumer', symbolUid: 'uid-2', symbolRef: { filePath: 'src/api.ts', name: 'fetchUsers' }, symbolName: 'fetchUsers', confidence: 0.7, meta: { method: 'GET', path: '/api/users' }, repo: 'app/frontend', }, ]; const result = await syncGroup(config, { extractorOverride: async () => mockContracts, skipWrite: true, }); expect(result.contracts).toHaveLength(2); expect(result.crossLinks).toHaveLength(1); expect(result.crossLinks[0].matchType).toBe('exact'); expect(result.crossLinks[0].confidence).toBe(1.0); expect(result.unmatched).toHaveLength(0); }); it('reports missing repos', async () => { const config = makeConfig({ 'app/backend': 'nonexistent-repo' }); const result = await syncGroup(config, { resolveRepoHandle: async () => null, skipWrite: true, }); expect(result.missingRepos).toContain('app/backend'); expect(result.contracts).toHaveLength(0); }); it('handles empty repos config', async () => { const config = makeConfig({}); const result = await syncGroup(config, { extractorOverride: async () => [], skipWrite: true, }); expect(result.contracts).toHaveLength(0); expect(result.crossLinks).toHaveLength(0); expect(result.missingRepos).toHaveLength(0); }); it('intra-repo matching works with service field via extractorOverride', async () => { const config = makeConfig({ 'platform/monorepo': 'monorepo' }); const mockContracts: StoredContract[] = [ { ...makeContract('http::GET::/api/users', 'provider', 'platform/monorepo'), service: 'services/auth', }, { ...makeContract('http::GET::/api/users', 'consumer', 'platform/monorepo'), service: 'services/gateway', }, ]; const result = await syncGroup(config, { extractorOverride: async () => mockContracts, skipWrite: true, }); expect(result.crossLinks).toHaveLength(1); expect(result.crossLinks[0].from.service).toBe('services/gateway'); expect(result.crossLinks[0].to.service).toBe('services/auth'); }); function makeContract(id: string, role: 'provider' | 'consumer', repo: string): StoredContract { return { contractId: id, type: 'http', role, symbolUid: `uid-${repo}-${id}`, symbolRef: { filePath: `src/${repo}.ts`, name: `fn-${id}` }, symbolName: `fn-${id}`, confidence: 0.8, meta: {}, repo, }; } it('per-repo extractorOverride receives repo handle and extracts per repo', async () => { const config = makeConfig({ 'app/backend': 'backend-repo', 'app/frontend': 'frontend-repo', }); const perRepoOverride = async (repo: RepoHandle) => { if (repo.path === 'app/backend') { return [makeContract('http::GET::/api/users', 'provider', 'app/backend')]; } return [makeContract('http::GET::/api/users', 'consumer', 'app/frontend')]; }; const result = await syncGroup(config, { extractorOverride: perRepoOverride, resolveRepoHandle: async (_name, groupPath) => ({ id: groupPath, path: groupPath, repoPath: '/tmp/' + groupPath, storagePath: '/tmp/' + groupPath + '/.gitnexus', }), skipWrite: true, }); // per-repo override goes through the initLbug path which will fail // but the extractorOverride with arity > 0 triggers the else branch // At minimum, the function should not throw expect(result).toBeDefined(); }); it('test_syncGroup_closes_only_opened_pools', async () => { const config = makeConfig({ 'app/backend': 'backend-repo', 'app/frontend': 'frontend-repo', }); const closedIds: string[] = []; const { vi } = await import('vitest'); const poolAdapter = await import('../../../src/core/lbug/pool-adapter.js'); const initSpy = vi.spyOn(poolAdapter, 'initLbug').mockResolvedValue(undefined); const closeSpy = vi.spyOn(poolAdapter, 'closeLbug').mockImplementation(async (id?: string) => { if (id) closedIds.push(id); }); try { await syncGroup(config, { resolveRepoHandle: async (_name, groupPath) => ({ id: groupPath.replace(/\//g, '-'), path: groupPath, repoPath: '/tmp/' + groupPath, storagePath: '/tmp/' + groupPath + '/.gitnexus', }), skipWrite: true, }).catch(() => {}); // closeLbug must have been called at least once with specific pool ids expect(closeSpy.mock.calls.length).toBeGreaterThan(0); expect(closedIds).toContain('app-backend'); expect(closedIds).toContain('app-frontend'); // Every call must have a truthy string id for (const id of closedIds) { expect(id).toBeTruthy(); expect(typeof id).toBe('string'); } // No blanket close (no-arg or empty-string or undefined) const blanketCalls = closeSpy.mock.calls.filter((args) => args.length === 0 || !args[0]); expect(blanketCalls).toHaveLength(0); } finally { initSpy.mockRestore(); closeSpy.mockRestore(); } }); it('manifest links in config.links produce cross-links with matchType manifest', async () => { const links: GroupManifestLink[] = [ { from: 'app/consumer', to: 'app/provider', type: 'http', contract: 'GET::/api/orders', role: 'consumer', }, ]; const config: GroupConfig = { version: 1, name: 'test', description: '', repos: { 'app/consumer': 'consumer-repo', 'app/provider': 'provider-repo' }, links, packages: {}, detect: { http: true, grpc: false, topics: false, shared_libs: false, embedding_fallback: false, }, matching: { bm25_threshold: 0.7, embedding_threshold: 0.65, max_candidates_per_step: 3 }, }; const result = await syncGroup(config, { extractorOverride: async () => [], skipWrite: true, }); // ManifestExtractor should inject 2 contracts (provider + consumer) and 1 cross-link expect(result.contracts).toHaveLength(2); const manifestLinks = result.crossLinks.filter((cl) => cl.matchType === 'manifest'); expect(manifestLinks).toHaveLength(1); expect(manifestLinks[0].contractId).toBe('http::GET::/api/orders'); expect(manifestLinks[0].from.repo).toBe('app/consumer'); expect(manifestLinks[0].to.repo).toBe('app/provider'); expect(manifestLinks[0].confidence).toBe(1.0); // With no DB executors available, UIDs fall back to the deterministic // synthetic form `manifest::::`. expect(manifestLinks[0].from.symbolUid).toBe('manifest::app/consumer::http::GET::/api/orders'); expect(manifestLinks[0].to.symbolUid).toBe('manifest::app/provider::http::GET::/api/orders'); // Manifest contracts also participate in runExactMatch; we must not emit a // duplicate matchType:'exact' cross-link for the same endpoint pair. const exactForSameContract = result.crossLinks.filter( (cl) => cl.matchType === 'exact' && cl.contractId === 'http::GET::/api/orders', ); expect(exactForSameContract).toHaveLength(0); expect(result.crossLinks).toHaveLength(1); }); it('manifest links referencing unknown repos still produce cross-links via synthetic UIDs', async () => { const links: GroupManifestLink[] = [ { from: 'app/known', to: 'app/dangling', // not present in config.repos type: 'http', contract: 'POST::/api/missing', role: 'consumer', }, ]; const config: GroupConfig = { version: 1, name: 'test', description: '', repos: { 'app/known': 'known-repo' }, links, packages: {}, detect: { http: true, grpc: false, topics: false, shared_libs: false, embedding_fallback: false, }, matching: { bm25_threshold: 0.7, embedding_threshold: 0.65, max_candidates_per_step: 3 }, }; const warnings: string[] = []; const origWarn = console.warn; console.warn = (msg: string) => warnings.push(String(msg)); try { const result = await syncGroup(config, { extractorOverride: async () => [], skipWrite: true, }); expect(result.crossLinks).toHaveLength(1); expect(result.crossLinks[0].matchType).toBe('manifest'); expect(result.crossLinks[0].to.symbolUid).toBe( 'manifest::app/dangling::http::POST::/api/missing', ); expect(warnings.some((w) => w.includes('app/dangling'))).toBe(true); } finally { console.warn = origWarn; } }); it('writes registry to groupDir when skipWrite is false', async () => { const tmpDir = path.join(os.tmpdir(), `gitnexus-sync-write-${Date.now()}`); fs.mkdirSync(tmpDir, { recursive: true }); try { const config = makeConfig({}); const result = await syncGroup(config, { extractorOverride: async () => [], groupDir: tmpDir, skipWrite: false, }); expect(result.contracts).toHaveLength(0); const registryPath = path.join(tmpDir, 'contracts.json'); expect(fs.existsSync(registryPath)).toBe(true); const registry = JSON.parse(fs.readFileSync(registryPath, 'utf-8')); expect(registry.version).toBe(1); expect(registry.contracts).toHaveLength(0); } finally { fs.rmSync(tmpDir, { recursive: true, force: true }); } }); }); describe('stableRepoPoolId', () => { it('returns lowercase name when no collision', () => { const entry: RegistryEntry = { name: 'MyRepo', path: '/a/MyRepo', storagePath: '/a/MyRepo/.gitnexus', indexedAt: '', lastCommit: '', }; const all = [entry]; expect(stableRepoPoolId(entry, all)).toBe('myrepo'); }); it('appends hash suffix on name collision with different path', () => { const entry1: RegistryEntry = { name: 'repo', path: '/a/repo', storagePath: '/a/repo/.gitnexus', indexedAt: '', lastCommit: '', }; const entry2: RegistryEntry = { name: 'repo', path: '/b/repo', storagePath: '/b/repo/.gitnexus', indexedAt: '', lastCommit: '', }; const all = [entry1, entry2]; const id1 = stableRepoPoolId(entry1, all); const id2 = stableRepoPoolId(entry2, all); expect(id1).toMatch(/^repo-/); expect(id2).toMatch(/^repo-/); expect(id1).not.toBe(id2); }); });