agent-ecosystem/test/main/services/team/TeamTranscriptSourceLocator.test.ts

281 lines
10 KiB
TypeScript

import * as os from 'os';
import * as path from 'path';
import { afterEach, describe, expect, it, vi } from 'vitest';
import * as fs from 'fs/promises';
import { TeamTranscriptSourceLocator } from '../../../../src/main/services/team/taskLogs/discovery/TeamTranscriptSourceLocator';
import { setClaudeBasePathOverride } from '../../../../src/main/utils/pathDecoder';
describe('TeamTranscriptSourceLocator', () => {
let tmpDir: string | null = null;
afterEach(async () => {
setClaudeBasePathOverride(null);
if (tmpDir) {
await fs.rm(tmpDir, { recursive: true, force: true });
tmpDir = null;
}
});
async function writeSessionFixture(projectRoot: string, sessionId: string): Promise<string[]> {
const rootTranscript = path.join(projectRoot, `${sessionId}.jsonl`);
const subagentsDir = path.join(projectRoot, sessionId, 'subagents');
const subagentTranscript = path.join(subagentsDir, 'agent-worker.jsonl');
await fs.mkdir(subagentsDir, { recursive: true });
await fs.writeFile(rootTranscript, '{}\n', 'utf8');
await fs.writeFile(subagentTranscript, '{}\n', 'utf8');
return [rootTranscript, subagentTranscript];
}
function makeResolverContext(projectRoot: string, teamName: string, sessionIds: string[]) {
return {
projectDir: projectRoot,
projectId: '-Users-test-cache',
config: {
name: teamName,
projectPath: '/Users/test/cache',
members: [],
},
sessionIds,
};
}
it('recovers projectPath from member cwd and includes only team-related root sessions', async () => {
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-transcripts-'));
setClaudeBasePathOverride(tmpDir);
const teamName = 'signal-ops-test';
const projectPath = '/Users/test/signal-ops';
const projectId = '-Users-test-signal-ops';
const leadSessionId = 'lead-session';
const memberSessionId = 'member-bob';
await fs.mkdir(path.join(tmpDir, 'teams', teamName), { recursive: true });
await fs.writeFile(
path.join(tmpDir, 'teams', teamName, 'config.json'),
JSON.stringify(
{
name: teamName,
leadSessionId,
members: [
{ name: 'team-lead', agentType: 'team-lead', cwd: projectPath },
{ name: 'bob', agentType: 'general-purpose', cwd: projectPath },
],
},
null,
2
),
'utf8'
);
const projectRoot = path.join(tmpDir, 'projects', projectId);
await fs.mkdir(path.join(projectRoot, leadSessionId, 'subagents'), { recursive: true });
await fs.writeFile(
path.join(projectRoot, `${leadSessionId}.jsonl`),
JSON.stringify({
timestamp: '2026-04-15T14:02:00.000Z',
type: 'user',
teamName,
agentName: 'team-lead',
message: { role: 'user', content: `Lead for team "${teamName}" (${teamName})` },
}) + '\n',
'utf8'
);
await fs.writeFile(
path.join(projectRoot, `${memberSessionId}.jsonl`),
JSON.stringify({
timestamp: '2026-04-15T14:02:01.000Z',
type: 'user',
teamName,
agentName: 'bob',
message: {
role: 'user',
content: `You are bootstrapping into team "${teamName}" as member "bob".`,
},
}) + '\n',
'utf8'
);
await fs.writeFile(
path.join(projectRoot, 'unrelated-session.jsonl'),
JSON.stringify({
timestamp: '2026-04-15T14:02:02.000Z',
type: 'user',
message: { role: 'user', content: 'Unrelated solo session' },
}) + '\n',
'utf8'
);
await fs.writeFile(
path.join(projectRoot, leadSessionId, 'subagents', 'agent-worker.jsonl'),
JSON.stringify({
timestamp: '2026-04-15T14:02:03.000Z',
type: 'user',
message: { role: 'user', content: `You are bob, a developer on team "${teamName}".` },
}) + '\n',
'utf8'
);
const locator = new TeamTranscriptSourceLocator();
const context = await locator.getContext(teamName);
const transcriptFiles = await locator.listTranscriptFiles(teamName);
expect(context).not.toBeNull();
expect(context?.projectId).toBe(projectId);
expect(context?.config.projectPath).toBe(projectPath);
expect(context?.sessionIds).toEqual(expect.arrayContaining([leadSessionId, memberSessionId]));
expect(context?.sessionIds).not.toContain('unrelated-session');
expect(transcriptFiles).toEqual(
expect.arrayContaining([
path.join(projectRoot, `${leadSessionId}.jsonl`),
path.join(projectRoot, `${memberSessionId}.jsonl`),
path.join(projectRoot, leadSessionId, 'subagents', 'agent-worker.jsonl'),
])
);
expect(transcriptFiles).not.toContain(path.join(projectRoot, 'unrelated-session.jsonl'));
});
it('returns the same sorted transcript set across multiple session directories', async () => {
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-transcripts-'));
setClaudeBasePathOverride(tmpDir);
const teamName = 'bounded-discovery-test';
const projectPath = '/Users/test/bounded-discovery';
const projectId = '-Users-test-bounded-discovery';
const sessionIds = Array.from({ length: 12 }, (_, index) => `member-${index + 1}`);
await fs.mkdir(path.join(tmpDir, 'teams', teamName), { recursive: true });
await fs.writeFile(
path.join(tmpDir, 'teams', teamName, 'config.json'),
JSON.stringify(
{
name: teamName,
projectPath,
members: sessionIds.map((sessionId, index) => ({
name: `member-${index + 1}`,
agentType: 'general-purpose',
sessionId,
cwd: projectPath,
})),
},
null,
2
),
'utf8'
);
const projectRoot = path.join(tmpDir, 'projects', projectId);
const expectedFiles: string[] = [];
for (const sessionId of sessionIds) {
const rootTranscript = path.join(projectRoot, `${sessionId}.jsonl`);
const subagentsDir = path.join(projectRoot, sessionId, 'subagents');
const subagentTranscript = path.join(subagentsDir, 'agent-worker.jsonl');
await fs.mkdir(subagentsDir, { recursive: true });
await fs.writeFile(
rootTranscript,
JSON.stringify({
timestamp: '2026-04-15T14:02:00.000Z',
type: 'user',
teamName,
message: { role: 'user', content: `Bootstrap ${sessionId} for ${teamName}` },
}) + '\n',
'utf8'
);
await fs.writeFile(
subagentTranscript,
JSON.stringify({
timestamp: '2026-04-15T14:02:01.000Z',
type: 'user',
message: { role: 'user', content: `Subagent for ${sessionId}` },
}) + '\n',
'utf8'
);
await fs.writeFile(
path.join(subagentsDir, 'agent-acompact-ignore.jsonl'),
'{}\n',
'utf8'
);
expectedFiles.push(rootTranscript, subagentTranscript);
}
const transcriptFiles = await new TeamTranscriptSourceLocator().listTranscriptFiles(teamName);
expect(transcriptFiles).toEqual([...expectedFiles].sort((a, b) => a.localeCompare(b)));
});
it('shares in-flight context discovery across parallel context and file-list reads', async () => {
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-transcripts-'));
const teamName = 'inflight-discovery-test';
const projectRoot = path.join(tmpDir, 'projects', '-Users-test-cache');
const expectedFiles = await writeSessionFixture(projectRoot, 'session-a');
const resolver = {
getContext: vi.fn(async () => {
await Promise.resolve();
return makeResolverContext(projectRoot, teamName, ['session-a']);
}),
};
const locator = new TeamTranscriptSourceLocator(resolver as never);
const [context, transcriptFiles] = await Promise.all([
locator.getContext(teamName),
locator.listTranscriptFiles(teamName),
]);
expect(context?.sessionIds).toEqual(['session-a']);
expect(transcriptFiles).toEqual(expectedFiles.sort((a, b) => a.localeCompare(b)));
expect(resolver.getContext).toHaveBeenCalledTimes(1);
});
it('reuses cached context inside the TTL and rebuilds after team invalidation', async () => {
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-transcripts-'));
const teamName = 'cached-discovery-test';
const projectRoot = path.join(tmpDir, 'projects', '-Users-test-cache');
await writeSessionFixture(projectRoot, 'session-a');
const sessionBFiles = await writeSessionFixture(projectRoot, 'session-b');
let sessionIds = ['session-a'];
const resolver = {
getContext: vi.fn(async () => makeResolverContext(projectRoot, teamName, [...sessionIds])),
};
const locator = new TeamTranscriptSourceLocator(resolver as never);
await locator.listTranscriptFiles(teamName);
await locator.listTranscriptFiles(teamName);
expect(resolver.getContext).toHaveBeenCalledTimes(1);
sessionIds = ['session-a', 'session-b'];
locator.invalidateTeam(teamName);
const transcriptFiles = await locator.listTranscriptFiles(teamName);
expect(resolver.getContext).toHaveBeenCalledTimes(2);
expect(transcriptFiles).toEqual(expect.arrayContaining(sessionBFiles));
});
it('bypasses cached context when forceRefresh is requested', async () => {
tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'claude-team-transcripts-'));
const teamName = 'force-refresh-discovery-test';
const projectRoot = path.join(tmpDir, 'projects', '-Users-test-cache');
await writeSessionFixture(projectRoot, 'session-a');
let sessionIds = ['session-a'];
const resolver = {
getContext: vi.fn(async () => makeResolverContext(projectRoot, teamName, [...sessionIds])),
};
const locator = new TeamTranscriptSourceLocator(resolver as never);
await locator.getContext(teamName);
sessionIds = ['session-a', 'session-b'];
await locator.getContext(teamName);
expect(resolver.getContext).toHaveBeenCalledTimes(1);
const refreshed = await locator.getContext(teamName, { forceRefresh: true });
expect(refreshed?.sessionIds).toEqual(['session-a', 'session-b']);
expect(resolver.getContext).toHaveBeenCalledTimes(2);
});
});