import { randomUUID } from "node:crypto"; import { eq } from "drizzle-orm"; import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest"; import { activityLog, agents, companies, createDb, executionWorkspaces, instanceSettings, issueComments, issueInboxArchives, issues, projectWorkspaces, projects, } from "@paperclipai/db"; import { getEmbeddedPostgresTestSupport, startEmbeddedPostgresTestDatabase, } from "./helpers/embedded-postgres.js"; import { instanceSettingsService } from "../services/instance-settings.ts"; import { issueService } from "../services/issues.ts"; const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport(); const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip; if (!embeddedPostgresSupport.supported) { console.warn( `Skipping embedded Postgres issue service tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`, ); } describeEmbeddedPostgres("issueService.list participantAgentId", () => { let db!: ReturnType; let svc!: ReturnType; let tempDb: Awaited> | null = null; beforeAll(async () => { tempDb = await startEmbeddedPostgresTestDatabase("paperclip-issues-service-"); db = createDb(tempDb.connectionString); svc = issueService(db); }, 20_000); afterEach(async () => { await db.delete(issueComments); await db.delete(issueInboxArchives); await db.delete(activityLog); await db.delete(issues); await db.delete(executionWorkspaces); await db.delete(projectWorkspaces); await db.delete(projects); await db.delete(agents); await db.delete(instanceSettings); await db.delete(companies); }); afterAll(async () => { await tempDb?.cleanup(); }); it("returns issues an agent participated in across the supported signals", async () => { const companyId = randomUUID(); const agentId = randomUUID(); const otherAgentId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await db.insert(agents).values([ { id: agentId, companyId, name: "CodexCoder", role: "engineer", status: "active", adapterType: "codex_local", adapterConfig: {}, runtimeConfig: {}, permissions: {}, }, { id: otherAgentId, companyId, name: "OtherAgent", role: "engineer", status: "active", adapterType: "codex_local", adapterConfig: {}, runtimeConfig: {}, permissions: {}, }, ]); const assignedIssueId = randomUUID(); const createdIssueId = randomUUID(); const commentedIssueId = randomUUID(); const activityIssueId = randomUUID(); const excludedIssueId = randomUUID(); await db.insert(issues).values([ { id: assignedIssueId, companyId, title: "Assigned issue", status: "todo", priority: "medium", assigneeAgentId: agentId, createdByAgentId: otherAgentId, }, { id: createdIssueId, companyId, title: "Created issue", status: "todo", priority: "medium", createdByAgentId: agentId, }, { id: commentedIssueId, companyId, title: "Commented issue", status: "todo", priority: "medium", createdByAgentId: otherAgentId, }, { id: activityIssueId, companyId, title: "Activity issue", status: "todo", priority: "medium", createdByAgentId: otherAgentId, }, { id: excludedIssueId, companyId, title: "Excluded issue", status: "todo", priority: "medium", createdByAgentId: otherAgentId, assigneeAgentId: otherAgentId, }, ]); await db.insert(issueComments).values({ companyId, issueId: commentedIssueId, authorAgentId: agentId, body: "Investigating this issue.", }); await db.insert(activityLog).values({ companyId, actorType: "agent", actorId: agentId, action: "issue.updated", entityType: "issue", entityId: activityIssueId, agentId, details: { changed: true }, }); const result = await svc.list(companyId, { participantAgentId: agentId }); const resultIds = new Set(result.map((issue) => issue.id)); expect(resultIds).toEqual(new Set([ assignedIssueId, createdIssueId, commentedIssueId, activityIssueId, ])); expect(resultIds.has(excludedIssueId)).toBe(false); }); it("combines participation filtering with search", async () => { const companyId = randomUUID(); const agentId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await db.insert(agents).values({ id: agentId, companyId, name: "CodexCoder", role: "engineer", status: "active", adapterType: "codex_local", adapterConfig: {}, runtimeConfig: {}, permissions: {}, }); const matchedIssueId = randomUUID(); const otherIssueId = randomUUID(); await db.insert(issues).values([ { id: matchedIssueId, companyId, title: "Invoice reconciliation", status: "todo", priority: "medium", createdByAgentId: agentId, }, { id: otherIssueId, companyId, title: "Weekly planning", status: "todo", priority: "medium", createdByAgentId: agentId, }, ]); const result = await svc.list(companyId, { participantAgentId: agentId, q: "invoice", }); expect(result.map((issue) => issue.id)).toEqual([matchedIssueId]); }); it("accepts issue identifiers through getById", async () => { const companyId = randomUUID(); const issueId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: "PAP", requireBoardApprovalForNewAgents: false, }); await db.insert(issues).values({ id: issueId, companyId, issueNumber: 1064, identifier: "PAP-1064", title: "Feedback votes error", status: "todo", priority: "medium", createdByUserId: "user-1", }); const issue = await svc.getById("PAP-1064"); expect(issue).toEqual( expect.objectContaining({ id: issueId, identifier: "PAP-1064", }), ); }); it("returns null instead of throwing for malformed non-uuid issue refs", async () => { await expect(svc.getById("not-a-uuid")).resolves.toBeNull(); }); it("filters issues by execution workspace id", async () => { const companyId = randomUUID(); const projectId = randomUUID(); const targetWorkspaceId = randomUUID(); const otherWorkspaceId = randomUUID(); const linkedIssueId = randomUUID(); const otherLinkedIssueId = randomUUID(); const unlinkedIssueId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await db.insert(projects).values({ id: projectId, companyId, name: "Workspace project", status: "in_progress", }); await db.insert(executionWorkspaces).values([ { id: targetWorkspaceId, companyId, projectId, mode: "shared_workspace", strategyType: "project_primary", name: "Target workspace", status: "active", providerType: "local_fs", }, { id: otherWorkspaceId, companyId, projectId, mode: "shared_workspace", strategyType: "project_primary", name: "Other workspace", status: "active", providerType: "local_fs", }, ]); await db.insert(issues).values([ { id: linkedIssueId, companyId, projectId, title: "Linked issue", status: "todo", priority: "medium", executionWorkspaceId: targetWorkspaceId, }, { id: otherLinkedIssueId, companyId, projectId, title: "Other linked issue", status: "todo", priority: "medium", executionWorkspaceId: otherWorkspaceId, }, { id: unlinkedIssueId, companyId, projectId, title: "Unlinked issue", status: "todo", priority: "medium", }, ]); const result = await svc.list(companyId, { executionWorkspaceId: targetWorkspaceId }); expect(result.map((issue) => issue.id)).toEqual([linkedIssueId]); }); it("hides archived inbox issues until new external activity arrives", async () => { const companyId = randomUUID(); const userId = "user-1"; const otherUserId = "user-2"; await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); const visibleIssueId = randomUUID(); const archivedIssueId = randomUUID(); const resurfacedIssueId = randomUUID(); await db.insert(issues).values([ { id: visibleIssueId, companyId, title: "Visible issue", status: "todo", priority: "medium", createdByUserId: userId, createdAt: new Date("2026-03-26T10:00:00.000Z"), updatedAt: new Date("2026-03-26T10:00:00.000Z"), }, { id: archivedIssueId, companyId, title: "Archived issue", status: "todo", priority: "medium", createdByUserId: userId, createdAt: new Date("2026-03-26T11:00:00.000Z"), updatedAt: new Date("2026-03-26T11:00:00.000Z"), }, { id: resurfacedIssueId, companyId, title: "Resurfaced issue", status: "todo", priority: "medium", createdByUserId: userId, createdAt: new Date("2026-03-26T12:00:00.000Z"), updatedAt: new Date("2026-03-26T12:00:00.000Z"), }, ]); await svc.archiveInbox(companyId, archivedIssueId, userId, new Date("2026-03-26T12:30:00.000Z")); await svc.archiveInbox(companyId, resurfacedIssueId, userId, new Date("2026-03-26T13:00:00.000Z")); await db.insert(issueComments).values({ companyId, issueId: resurfacedIssueId, authorUserId: otherUserId, body: "This should bring the issue back into Mine.", createdAt: new Date("2026-03-26T13:30:00.000Z"), updatedAt: new Date("2026-03-26T13:30:00.000Z"), }); const archivedFiltered = await svc.list(companyId, { touchedByUserId: userId, inboxArchivedByUserId: userId, }); expect(archivedFiltered.map((issue) => issue.id)).toEqual([ resurfacedIssueId, visibleIssueId, ]); await svc.unarchiveInbox(companyId, archivedIssueId, userId); const afterUnarchive = await svc.list(companyId, { touchedByUserId: userId, inboxArchivedByUserId: userId, }); expect(new Set(afterUnarchive.map((issue) => issue.id))).toEqual(new Set([ visibleIssueId, archivedIssueId, resurfacedIssueId, ])); }); it("resurfaces archived issue when status/updatedAt changes after archiving", async () => { const companyId = randomUUID(); const userId = "user-1"; const otherUserId = "user-2"; await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); const issueId = randomUUID(); await db.insert(issues).values({ id: issueId, companyId, title: "Issue with old comment then status change", status: "todo", priority: "medium", createdByUserId: userId, createdAt: new Date("2026-03-26T10:00:00.000Z"), updatedAt: new Date("2026-03-26T10:00:00.000Z"), }); // Old external comment before archiving await db.insert(issueComments).values({ companyId, issueId, authorUserId: otherUserId, body: "Old comment before archive", createdAt: new Date("2026-03-26T11:00:00.000Z"), updatedAt: new Date("2026-03-26T11:00:00.000Z"), }); // Archive after seeing the comment await svc.archiveInbox( companyId, issueId, userId, new Date("2026-03-26T12:00:00.000Z"), ); // Verify it's archived const afterArchive = await svc.list(companyId, { touchedByUserId: userId, inboxArchivedByUserId: userId, }); expect(afterArchive.map((i) => i.id)).not.toContain(issueId); // Status/work update changes updatedAt (no new comment) await db .update(issues) .set({ status: "in_progress", updatedAt: new Date("2026-03-26T13:00:00.000Z"), }) .where(eq(issues.id, issueId)); // Should resurface because updatedAt > archivedAt const afterUpdate = await svc.list(companyId, { touchedByUserId: userId, inboxArchivedByUserId: userId, }); expect(afterUpdate.map((i) => i.id)).toContain(issueId); }); it("sorts and exposes last activity from comments and non-local issue activity logs", async () => { const companyId = randomUUID(); const olderIssueId = randomUUID(); const commentIssueId = randomUUID(); const activityIssueId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await db.insert(issues).values([ { id: olderIssueId, companyId, title: "Older issue", status: "todo", priority: "medium", updatedAt: new Date("2026-03-26T10:00:00.000Z"), }, { id: commentIssueId, companyId, title: "Comment activity issue", status: "todo", priority: "medium", updatedAt: new Date("2026-03-26T10:00:00.000Z"), }, { id: activityIssueId, companyId, title: "Logged activity issue", status: "todo", priority: "medium", updatedAt: new Date("2026-03-26T10:00:00.000Z"), }, ]); await db.insert(issueComments).values({ companyId, issueId: commentIssueId, body: "New comment without touching issue.updatedAt", createdAt: new Date("2026-03-26T11:00:00.000Z"), updatedAt: new Date("2026-03-26T11:00:00.000Z"), }); await db.insert(activityLog).values([ { companyId, actorType: "system", actorId: "system", action: "issue.document_updated", entityType: "issue", entityId: activityIssueId, createdAt: new Date("2026-03-26T12:00:00.000Z"), }, { companyId, actorType: "user", actorId: "user-1", action: "issue.read_marked", entityType: "issue", entityId: olderIssueId, createdAt: new Date("2026-03-26T13:00:00.000Z"), }, ]); const result = await svc.list(companyId, {}); expect(result.map((issue) => issue.id)).toEqual([ activityIssueId, commentIssueId, olderIssueId, ]); expect(result.find((issue) => issue.id === activityIssueId)?.lastActivityAt?.toISOString()).toBe( "2026-03-26T12:00:00.000Z", ); expect(result.find((issue) => issue.id === commentIssueId)?.lastActivityAt?.toISOString()).toBe( "2026-03-26T11:00:00.000Z", ); expect(result.find((issue) => issue.id === olderIssueId)?.lastActivityAt?.toISOString()).toBe( "2026-03-26T10:00:00.000Z", ); }); }); describeEmbeddedPostgres("issueService.create workspace inheritance", () => { let db!: ReturnType; let svc!: ReturnType; let tempDb: Awaited> | null = null; beforeAll(async () => { tempDb = await startEmbeddedPostgresTestDatabase("paperclip-issues-create-"); db = createDb(tempDb.connectionString); svc = issueService(db); }, 20_000); afterEach(async () => { await db.delete(issueComments); await db.delete(issueInboxArchives); await db.delete(activityLog); await db.delete(issues); await db.delete(executionWorkspaces); await db.delete(projectWorkspaces); await db.delete(projects); await db.delete(agents); await db.delete(instanceSettings); await db.delete(companies); }); afterAll(async () => { await tempDb?.cleanup(); }); it("inherits the parent issue workspace linkage when child workspace fields are omitted", async () => { const companyId = randomUUID(); const projectId = randomUUID(); const parentIssueId = randomUUID(); const projectWorkspaceId = randomUUID(); const executionWorkspaceId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await instanceSettingsService(db).updateExperimental({ enableIsolatedWorkspaces: true }); await db.insert(projects).values({ id: projectId, companyId, name: "Workspace project", status: "in_progress", }); await db.insert(projectWorkspaces).values({ id: projectWorkspaceId, companyId, projectId, name: "Primary workspace", isPrimary: true, sharedWorkspaceKey: "workspace-key", }); await db.insert(executionWorkspaces).values({ id: executionWorkspaceId, companyId, projectId, projectWorkspaceId, mode: "isolated_workspace", strategyType: "git_worktree", name: "Issue worktree", status: "active", providerType: "git_worktree", providerRef: `/tmp/${executionWorkspaceId}`, }); await db.insert(issues).values({ id: parentIssueId, companyId, projectId, projectWorkspaceId, title: "Parent issue", status: "in_progress", priority: "medium", executionWorkspaceId, executionWorkspacePreference: "reuse_existing", executionWorkspaceSettings: { mode: "isolated_workspace", workspaceRuntime: { profile: "agent" }, }, }); const child = await svc.create(companyId, { parentId: parentIssueId, projectId, title: "Child issue", }); expect(child.parentId).toBe(parentIssueId); expect(child.projectWorkspaceId).toBe(projectWorkspaceId); expect(child.executionWorkspaceId).toBe(executionWorkspaceId); expect(child.executionWorkspacePreference).toBe("reuse_existing"); expect(child.executionWorkspaceSettings).toEqual({ mode: "isolated_workspace", workspaceRuntime: { profile: "agent" }, }); }); it("keeps explicit workspace fields instead of inheriting the parent linkage", async () => { const companyId = randomUUID(); const projectId = randomUUID(); const parentIssueId = randomUUID(); const parentProjectWorkspaceId = randomUUID(); const parentExecutionWorkspaceId = randomUUID(); const explicitProjectWorkspaceId = randomUUID(); const explicitExecutionWorkspaceId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await instanceSettingsService(db).updateExperimental({ enableIsolatedWorkspaces: true }); await db.insert(projects).values({ id: projectId, companyId, name: "Workspace project", status: "in_progress", }); await db.insert(projectWorkspaces).values([ { id: parentProjectWorkspaceId, companyId, projectId, name: "Parent workspace", }, { id: explicitProjectWorkspaceId, companyId, projectId, name: "Explicit workspace", }, ]); await db.insert(executionWorkspaces).values([ { id: parentExecutionWorkspaceId, companyId, projectId, projectWorkspaceId: parentProjectWorkspaceId, mode: "isolated_workspace", strategyType: "git_worktree", name: "Parent worktree", status: "active", providerType: "git_worktree", }, { id: explicitExecutionWorkspaceId, companyId, projectId, projectWorkspaceId: explicitProjectWorkspaceId, mode: "shared_workspace", strategyType: "project_primary", name: "Explicit shared workspace", status: "active", providerType: "local_fs", }, ]); await db.insert(issues).values({ id: parentIssueId, companyId, projectId, projectWorkspaceId: parentProjectWorkspaceId, title: "Parent issue", status: "in_progress", priority: "medium", executionWorkspaceId: parentExecutionWorkspaceId, executionWorkspacePreference: "reuse_existing", executionWorkspaceSettings: { mode: "isolated_workspace", }, }); const child = await svc.create(companyId, { parentId: parentIssueId, projectId, title: "Child issue", projectWorkspaceId: explicitProjectWorkspaceId, executionWorkspaceId: explicitExecutionWorkspaceId, executionWorkspacePreference: "reuse_existing", executionWorkspaceSettings: { mode: "shared_workspace", }, }); expect(child.projectWorkspaceId).toBe(explicitProjectWorkspaceId); expect(child.executionWorkspaceId).toBe(explicitExecutionWorkspaceId); expect(child.executionWorkspacePreference).toBe("reuse_existing"); expect(child.executionWorkspaceSettings).toEqual({ mode: "shared_workspace", }); }); it("inherits workspace linkage from an explicit source issue without creating a parent-child relationship", async () => { const companyId = randomUUID(); const projectId = randomUUID(); const sourceIssueId = randomUUID(); const projectWorkspaceId = randomUUID(); const executionWorkspaceId = randomUUID(); await db.insert(companies).values({ id: companyId, name: "Paperclip", issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`, requireBoardApprovalForNewAgents: false, }); await instanceSettingsService(db).updateExperimental({ enableIsolatedWorkspaces: true }); await db.insert(projects).values({ id: projectId, companyId, name: "Workspace project", status: "in_progress", }); await db.insert(projectWorkspaces).values({ id: projectWorkspaceId, companyId, projectId, name: "Primary workspace", }); await db.insert(executionWorkspaces).values({ id: executionWorkspaceId, companyId, projectId, projectWorkspaceId, mode: "operator_branch", strategyType: "git_worktree", name: "Operator branch", status: "active", providerType: "git_worktree", }); await db.insert(issues).values({ id: sourceIssueId, companyId, projectId, projectWorkspaceId, title: "Source issue", status: "todo", priority: "medium", executionWorkspaceId, executionWorkspacePreference: "reuse_existing", executionWorkspaceSettings: { mode: "operator_branch", }, }); const followUp = await svc.create(companyId, { projectId, title: "Follow-up issue", inheritExecutionWorkspaceFromIssueId: sourceIssueId, }); expect(followUp.parentId).toBeNull(); expect(followUp.projectWorkspaceId).toBe(projectWorkspaceId); expect(followUp.executionWorkspaceId).toBe(executionWorkspaceId); expect(followUp.executionWorkspacePreference).toBe("reuse_existing"); expect(followUp.executionWorkspaceSettings).toEqual({ mode: "operator_branch", }); }); });