mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-27 11:20:42 +01:00
DottaandPaperclip
aeea5f9195
## Thinking Path > - Paperclip is the open source control plane people use to manage AI agents for work. > - This change touches the board UI surfaces for issue run timelines and routine schedule editing. > - Operators need cancelled runs to distinguish ordinary cancellation from human interruption, otherwise the run history reads as more severe than it is. > - Routine schedule editing also needs to preserve user-entered cron values while rendering common schedules in a stable, understandable editor. > - This pull request keeps the editor state tied to explicit schedule values, adds coverage for routine editable sections, and makes interrupted run copy more precise. > - The benefit is less surprising routine editing and clearer issue run history for operators. ## Linked Issues or Issue Description No public GitHub issue is filed for this exact branch. Related public PRs: - Refs #3581, which addresses a narrower schedule reset case. - Refs #1803, which is another open schedule editor UI improvement. Problem description: Routine trigger schedules can be edited through the board UI, but the previous schedule editor path could normalize or reset cron state in ways that made unsaved edits fragile. Issue run history also labeled operator-interrupted cancelled runs like ordinary cancellations. Reviewers should treat this PR as a combined UI stabilization pass for those two visible operator workflows. ## What Changed - Added a more stable routine schedule editor flow that preserves explicit cron values and handles custom/common schedule transitions. - Wired routine editable-section state so schedule drafts do not get overwritten by unrelated section refreshes. - Added tests for schedule editor behavior, routine editable sections, and routine service schedule preservation. - Updated issue run timeline copy so operator-interrupted cancelled runs display as interrupted, while ordinary cancelled runs remain cancelled. - Kept the classic issue thread run label behavior aligned with the current issue thread surface. ## Verification - `NODE_ENV=development pnpm run preflight:workspace-links && NODE_ENV=development pnpm exec vitest run server/src/__tests__/routines-service.test.ts ui/src/components/IssueChatThread.test.tsx ui/src/components/ScheduleEditor.test.tsx ui/src/components/routine-sections/editable-sections.test.tsx` — 103 tests passed. Note: direct `pnpm exec vitest ...` without `NODE_ENV=development` loaded a React build where `React.act` is undefined in this workspace. The same targeted tests pass under the development React build. ## Risks Low to medium risk. The changes are UI-focused but touch routine schedule editing, which is a high-frequency operator workflow. The main risk is that an uncommon cron expression could render as custom when a user expected a preset; the added tests cover preservation and explicit custom handling. > For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and discuss it in `#dev` before opening the PR. Feature PRs that overlap with planned core work may need to be redirected — check the roadmap first. See `CONTRIBUTING.md`. ## Model Used OpenAI Codex, GPT-5-class coding agent. Exact hosted runtime model ID and context window were not exposed in this session. Tool use and local command execution were used for inspection, verification, GitHub PR creation, and Paperclip issue updates. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [ ] If this change affects the UI, I have included before/after screenshots - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
1695 lines
55 KiB
TypeScript
1695 lines
55 KiB
TypeScript
import { createHmac, randomUUID } from "node:crypto";
|
|
import { eq } from "drizzle-orm";
|
|
import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";
|
|
import {
|
|
activityLog,
|
|
agents,
|
|
companies,
|
|
companySecretBindings,
|
|
companySecrets,
|
|
companySecretVersions,
|
|
createDb,
|
|
executionWorkspaces,
|
|
heartbeatRuns,
|
|
instanceSettings,
|
|
issueInboxArchives,
|
|
issueReadStates,
|
|
issues,
|
|
projectWorkspaces,
|
|
projects,
|
|
routineRuns,
|
|
routines,
|
|
routineTriggers,
|
|
secretAccessEvents,
|
|
} from "@paperclipai/db";
|
|
import {
|
|
getEmbeddedPostgresTestSupport,
|
|
startEmbeddedPostgresTestDatabase,
|
|
} from "./helpers/embedded-postgres.js";
|
|
import { issueService } from "../services/issues.ts";
|
|
import { instanceSettingsService } from "../services/instance-settings.ts";
|
|
import * as providerRegistry from "../secrets/provider-registry.ts";
|
|
import { routineService } from "../services/routines.ts";
|
|
import { secretService } from "../services/secrets.ts";
|
|
|
|
const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
|
|
const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
|
|
const originalSecretsProviderEnv = process.env.PAPERCLIP_SECRETS_PROVIDER;
|
|
|
|
if (!embeddedPostgresSupport.supported) {
|
|
console.warn(
|
|
`Skipping embedded Postgres routines service tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`,
|
|
);
|
|
}
|
|
|
|
describeEmbeddedPostgres("routine service live-execution coalescing", () => {
|
|
let db!: ReturnType<typeof createDb>;
|
|
let tempDb: Awaited<ReturnType<typeof startEmbeddedPostgresTestDatabase>> | null = null;
|
|
|
|
beforeAll(async () => {
|
|
tempDb = await startEmbeddedPostgresTestDatabase("paperclip-routines-service-");
|
|
db = createDb(tempDb.connectionString);
|
|
}, 20_000);
|
|
|
|
afterEach(async () => {
|
|
if (originalSecretsProviderEnv === undefined) {
|
|
delete process.env.PAPERCLIP_SECRETS_PROVIDER;
|
|
} else {
|
|
process.env.PAPERCLIP_SECRETS_PROVIDER = originalSecretsProviderEnv;
|
|
}
|
|
await db.delete(activityLog);
|
|
await db.delete(issueInboxArchives);
|
|
await db.delete(issueReadStates);
|
|
await db.delete(secretAccessEvents);
|
|
await db.delete(companySecretBindings);
|
|
await db.delete(routineRuns);
|
|
await db.delete(routineTriggers);
|
|
await db.delete(routines);
|
|
await db.delete(companySecretVersions);
|
|
await db.delete(companySecrets);
|
|
await db.delete(heartbeatRuns);
|
|
await db.delete(issues);
|
|
await db.delete(executionWorkspaces);
|
|
await db.delete(projectWorkspaces);
|
|
await db.delete(projects);
|
|
await db.delete(agents);
|
|
await db.delete(companies);
|
|
await db.delete(instanceSettings);
|
|
});
|
|
|
|
afterAll(async () => {
|
|
await tempDb?.cleanup();
|
|
});
|
|
|
|
async function seedFixture(opts?: {
|
|
wakeup?: (
|
|
agentId: string,
|
|
wakeupOpts: {
|
|
source?: string;
|
|
triggerDetail?: string;
|
|
reason?: string | null;
|
|
payload?: Record<string, unknown> | null;
|
|
requestedByActorType?: "user" | "agent" | "system";
|
|
requestedByActorId?: string | null;
|
|
contextSnapshot?: Record<string, unknown>;
|
|
},
|
|
) => Promise<unknown>;
|
|
}) {
|
|
const companyId = randomUUID();
|
|
const agentId = randomUUID();
|
|
const projectId = randomUUID();
|
|
const issuePrefix = `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`;
|
|
const wakeups: Array<{
|
|
agentId: string;
|
|
opts: {
|
|
source?: string;
|
|
triggerDetail?: string;
|
|
reason?: string | null;
|
|
payload?: Record<string, unknown> | null;
|
|
requestedByActorType?: "user" | "agent" | "system";
|
|
requestedByActorId?: string | null;
|
|
contextSnapshot?: Record<string, unknown>;
|
|
};
|
|
}> = [];
|
|
|
|
await db.insert(companies).values({
|
|
id: companyId,
|
|
name: "Paperclip",
|
|
issuePrefix,
|
|
requireBoardApprovalForNewAgents: false,
|
|
});
|
|
|
|
await db.insert(agents).values({
|
|
id: agentId,
|
|
companyId,
|
|
name: "CodexCoder",
|
|
role: "engineer",
|
|
status: "active",
|
|
adapterType: "codex_local",
|
|
adapterConfig: {},
|
|
runtimeConfig: {},
|
|
permissions: {},
|
|
});
|
|
|
|
await db.insert(projects).values({
|
|
id: projectId,
|
|
companyId,
|
|
name: "Routines",
|
|
status: "in_progress",
|
|
});
|
|
|
|
const svc = routineService(db, {
|
|
heartbeat: {
|
|
wakeup: async (wakeupAgentId, wakeupOpts) => {
|
|
wakeups.push({ agentId: wakeupAgentId, opts: wakeupOpts });
|
|
if (opts?.wakeup) return opts.wakeup(wakeupAgentId, wakeupOpts);
|
|
const issueId =
|
|
(typeof wakeupOpts.payload?.issueId === "string" && wakeupOpts.payload.issueId) ||
|
|
(typeof wakeupOpts.contextSnapshot?.issueId === "string" && wakeupOpts.contextSnapshot.issueId) ||
|
|
null;
|
|
if (!issueId) return null;
|
|
const queuedRunId = randomUUID();
|
|
await db.insert(heartbeatRuns).values({
|
|
id: queuedRunId,
|
|
companyId,
|
|
agentId: wakeupAgentId,
|
|
invocationSource: wakeupOpts.source ?? "assignment",
|
|
triggerDetail: wakeupOpts.triggerDetail ?? null,
|
|
status: "queued",
|
|
contextSnapshot: { ...(wakeupOpts.contextSnapshot ?? {}), issueId },
|
|
});
|
|
await db
|
|
.update(issues)
|
|
.set({
|
|
executionRunId: queuedRunId,
|
|
executionLockedAt: new Date(),
|
|
})
|
|
.where(eq(issues.id, issueId));
|
|
return { id: queuedRunId };
|
|
},
|
|
},
|
|
});
|
|
const issueSvc = issueService(db);
|
|
const routine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "ascii frog",
|
|
description: "Run the frog routine",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
},
|
|
{},
|
|
);
|
|
|
|
return { companyId, agentId, issueSvc, projectId, routine, svc, wakeups };
|
|
}
|
|
|
|
it("filters listed routines by project", async () => {
|
|
const { companyId, agentId, projectId, routine, svc } = await seedFixture();
|
|
const otherProjectId = randomUUID();
|
|
await db.insert(projects).values({
|
|
id: otherProjectId,
|
|
companyId,
|
|
name: "Other routines",
|
|
status: "in_progress",
|
|
});
|
|
const otherRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId: otherProjectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "other project routine",
|
|
description: null,
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const projectRoutines = await svc.list(companyId, { projectId });
|
|
const allRoutines = await svc.list(companyId);
|
|
|
|
expect(projectRoutines.map((entry) => entry.id)).toEqual([routine.id]);
|
|
expect(allRoutines.map((entry) => entry.id)).toEqual(expect.arrayContaining([routine.id, otherRoutine.id]));
|
|
});
|
|
|
|
it("creates a fresh execution issue when the previous routine issue is open but idle", async () => {
|
|
const { companyId, issueSvc, routine, svc } = await seedFixture();
|
|
const previousRunId = randomUUID();
|
|
const previousIssue = await issueSvc.create(companyId, {
|
|
projectId: routine.projectId,
|
|
title: routine.title,
|
|
description: routine.description,
|
|
status: "todo",
|
|
priority: routine.priority,
|
|
assigneeAgentId: routine.assigneeAgentId,
|
|
originKind: "routine_execution",
|
|
originId: routine.id,
|
|
originRunId: previousRunId,
|
|
});
|
|
|
|
await db.insert(routineRuns).values({
|
|
id: previousRunId,
|
|
companyId,
|
|
routineId: routine.id,
|
|
triggerId: null,
|
|
source: "manual",
|
|
status: "issue_created",
|
|
triggeredAt: new Date("2026-03-20T12:00:00.000Z"),
|
|
linkedIssueId: previousIssue.id,
|
|
completedAt: new Date("2026-03-20T12:00:00.000Z"),
|
|
});
|
|
|
|
const detailBefore = await svc.getDetail(routine.id);
|
|
expect(detailBefore?.activeIssue).toBeNull();
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
expect(run.status).toBe("issue_created");
|
|
expect(run.linkedIssueId).not.toBe(previousIssue.id);
|
|
|
|
const routineIssues = await db
|
|
.select({
|
|
id: issues.id,
|
|
originRunId: issues.originRunId,
|
|
})
|
|
.from(issues)
|
|
.where(eq(issues.originId, routine.id));
|
|
|
|
expect(routineIssues).toHaveLength(2);
|
|
expect(routineIssues.map((issue) => issue.id)).toContain(previousIssue.id);
|
|
expect(routineIssues.map((issue) => issue.id)).toContain(run.linkedIssueId);
|
|
});
|
|
|
|
it("creates draft routines without a project or default assignee", async () => {
|
|
const { companyId, svc } = await seedFixture();
|
|
|
|
const routine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId: null,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "draft routine",
|
|
description: "No defaults yet",
|
|
assigneeAgentId: null,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
},
|
|
{},
|
|
);
|
|
|
|
expect(routine.projectId).toBeNull();
|
|
expect(routine.assigneeAgentId).toBeNull();
|
|
expect(routine.status).toBe("paused");
|
|
});
|
|
|
|
it("creates revision 1 on routine create and appends revisions for real updates only", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
|
|
const initialRevisions = await svc.listRevisions(routine.id);
|
|
expect(initialRevisions).toHaveLength(1);
|
|
expect(initialRevisions[0]).toMatchObject({
|
|
id: routine.latestRevisionId,
|
|
revisionNumber: 1,
|
|
title: "ascii frog",
|
|
changeSummary: "Created routine",
|
|
});
|
|
expect(initialRevisions[0]?.snapshot.routine.description).toBe("Run the frog routine");
|
|
|
|
const updated = await svc.update(
|
|
routine.id,
|
|
{
|
|
description: "Run the frog routine with logs",
|
|
baseRevisionId: routine.latestRevisionId,
|
|
},
|
|
{},
|
|
);
|
|
expect(updated?.latestRevisionNumber).toBe(2);
|
|
expect(updated?.latestRevisionId).not.toBe(routine.latestRevisionId);
|
|
|
|
const noOp = await svc.update(
|
|
routine.id,
|
|
{
|
|
description: "Run the frog routine with logs",
|
|
baseRevisionId: updated?.latestRevisionId,
|
|
},
|
|
{},
|
|
);
|
|
expect(noOp?.latestRevisionId).toBe(updated?.latestRevisionId);
|
|
expect(noOp?.latestRevisionNumber).toBe(2);
|
|
|
|
const revisions = await svc.listRevisions(routine.id);
|
|
expect(revisions.map((revision) => revision.revisionNumber)).toEqual([2, 1]);
|
|
expect(revisions[0]?.snapshot.routine.description).toBe("Run the frog routine with logs");
|
|
expect(revisions[1]?.snapshot.routine.description).toBe("Run the frog routine");
|
|
});
|
|
|
|
it("stores routine env in revisions, syncs routine secret bindings, and stamps runs with the dispatch revision", async () => {
|
|
const { agentId, companyId, projectId, svc } = await seedFixture();
|
|
const secrets = secretService(db);
|
|
const secret = await secrets.create(companyId, {
|
|
name: `routine-api-${randomUUID()}`,
|
|
provider: "local_encrypted",
|
|
value: "secret-value",
|
|
});
|
|
|
|
const routine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "secret routine",
|
|
description: null,
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "always_enqueue",
|
|
catchUpPolicy: "skip_missed",
|
|
env: {
|
|
ROUTINE_API_KEY: { type: "secret_ref", secretId: secret.id, version: "latest" },
|
|
ROUTINE_PLAIN: { type: "plain", value: "plain-value" },
|
|
},
|
|
},
|
|
{},
|
|
);
|
|
|
|
const bindings = await db
|
|
.select()
|
|
.from(companySecretBindings)
|
|
.where(eq(companySecretBindings.targetId, routine.id));
|
|
expect(bindings).toMatchObject([
|
|
{
|
|
companyId,
|
|
secretId: secret.id,
|
|
targetType: "routine",
|
|
configPath: "env.ROUTINE_API_KEY",
|
|
},
|
|
]);
|
|
|
|
const [initialRevision] = await svc.listRevisions(routine.id);
|
|
expect(initialRevision?.snapshot.routine.env).toEqual(routine.env);
|
|
|
|
await db.delete(companySecretBindings).where(eq(companySecretBindings.targetId, routine.id));
|
|
const repaired = await svc.update(routine.id, { env: routine.env }, {});
|
|
expect(repaired).not.toBeNull();
|
|
const repairedBindings = await db
|
|
.select()
|
|
.from(companySecretBindings)
|
|
.where(eq(companySecretBindings.targetId, routine.id));
|
|
expect(repairedBindings).toMatchObject([
|
|
{
|
|
companyId,
|
|
secretId: secret.id,
|
|
targetType: "routine",
|
|
configPath: "env.ROUTINE_API_KEY",
|
|
},
|
|
]);
|
|
|
|
const currentRoutine = repaired ?? routine;
|
|
const runBefore = await svc.runRoutine(routine.id, { source: "manual" });
|
|
expect(runBefore.routineRevisionId).toBe(currentRoutine.latestRevisionId);
|
|
|
|
const updated = await svc.update(
|
|
routine.id,
|
|
{
|
|
env: {
|
|
ROUTINE_API_KEY: { type: "secret_ref", secretId: secret.id, version: "latest" },
|
|
ROUTINE_PLAIN: { type: "plain", value: "changed" },
|
|
},
|
|
},
|
|
{},
|
|
);
|
|
expect(updated?.latestRevisionNumber).toBe(currentRoutine.latestRevisionNumber + 1);
|
|
|
|
const runAfter = await svc.runRoutine(routine.id, { source: "manual" });
|
|
expect(runAfter.routineRevisionId).toBe(updated?.latestRevisionId);
|
|
expect(runAfter.dispatchFingerprint).not.toBe(runBefore.dispatchFingerprint);
|
|
});
|
|
|
|
it("rejects stale routine baseRevisionId updates", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const updated = await svc.update(routine.id, { description: "new description" }, {});
|
|
await expect(
|
|
svc.update(routine.id, {
|
|
title: "stale update",
|
|
baseRevisionId: routine.latestRevisionId,
|
|
}, {}),
|
|
).rejects.toMatchObject({
|
|
status: 409,
|
|
details: {
|
|
currentRevisionId: updated?.latestRevisionId,
|
|
},
|
|
});
|
|
});
|
|
|
|
it("restores an older routine revision append-only and preserves run history", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const revision1Id = routine.latestRevisionId!;
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
const revision2Routine = await svc.update(routine.id, { description: "revision 2" }, {});
|
|
|
|
const restored = await svc.restoreRevision(routine.id, revision1Id, {});
|
|
|
|
expect(restored.restoredFromRevisionId).toBe(revision1Id);
|
|
expect(restored.restoredFromRevisionNumber).toBe(1);
|
|
expect(restored.routine.latestRevisionNumber).toBe(3);
|
|
expect(restored.routine.latestRevisionId).not.toBe(revision2Routine?.latestRevisionId);
|
|
expect(restored.routine.description).toBe("Run the frog routine");
|
|
expect(restored.revision.restoredFromRevisionId).toBe(revision1Id);
|
|
expect(restored.revision.snapshot.routine.description).toBe("Run the frog routine");
|
|
|
|
const revisions = await svc.listRevisions(routine.id);
|
|
expect(revisions.map((revision) => revision.revisionNumber)).toEqual([3, 2, 1]);
|
|
await expect(db.select().from(routineRuns).where(eq(routineRuns.id, run.id))).resolves.toHaveLength(1);
|
|
});
|
|
|
|
it("rejects restoring the current latest routine revision", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
|
|
await expect(
|
|
svc.restoreRevision(routine.id, routine.latestRevisionId!, {}),
|
|
).rejects.toMatchObject({
|
|
status: 409,
|
|
details: {
|
|
currentRevisionId: routine.latestRevisionId,
|
|
},
|
|
});
|
|
});
|
|
|
|
it("recreates deleted webhook trigger secrets when restoring a historical revision", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const created = await svc.createTrigger(routine.id, {
|
|
kind: "webhook",
|
|
signingMode: "bearer",
|
|
replayWindowSec: 300,
|
|
}, {});
|
|
await svc.deleteTrigger(created.trigger.id, {});
|
|
await expect(db.select().from(companySecrets).where(eq(companySecrets.id, created.trigger.secretId!))).resolves.toHaveLength(0);
|
|
await expect(db.select().from(companySecretBindings).where(eq(companySecretBindings.secretId, created.trigger.secretId!))).resolves.toHaveLength(0);
|
|
|
|
const restored = await svc.restoreRevision(routine.id, created.revision.id, {});
|
|
|
|
expect(restored.secretMaterials).toHaveLength(1);
|
|
expect(restored.secretMaterials[0]).toMatchObject({
|
|
triggerId: created.trigger.id,
|
|
});
|
|
expect(restored.secretMaterials[0]?.webhookSecret).toBeTruthy();
|
|
expect(restored.secretMaterials[0]?.webhookUrl).toContain("/api/routine-triggers/public/");
|
|
|
|
const restoredTrigger = await svc.getTrigger(created.trigger.id);
|
|
expect(restoredTrigger?.secretId).toBeTruthy();
|
|
expect(restoredTrigger?.publicId).toBeTruthy();
|
|
expect(restoredTrigger?.publicId).not.toBe(created.trigger.publicId);
|
|
});
|
|
|
|
it("persists custom schedule cron expressions exactly", async () => {
|
|
const { companyId, routine, svc } = await seedFixture();
|
|
const cronExpression = "0 8-18/2 * * 1-5";
|
|
|
|
const created = await svc.createTrigger(routine.id, {
|
|
kind: "schedule",
|
|
label: "Business hours",
|
|
cronExpression,
|
|
timezone: "UTC",
|
|
}, {});
|
|
|
|
expect(created.trigger.cronExpression).toBe(cronExpression);
|
|
|
|
const storedTrigger = await svc.getTrigger(created.trigger.id);
|
|
expect(storedTrigger?.cronExpression).toBe(cronExpression);
|
|
|
|
const [listed] = await svc.list(companyId);
|
|
expect(listed?.triggers[0]?.cronExpression).toBe(cronExpression);
|
|
});
|
|
|
|
it("blocks agents from restoring routine revisions assigned to another agent", async () => {
|
|
const { companyId, routine, svc } = await seedFixture();
|
|
const otherAgentId = randomUUID();
|
|
await db.insert(agents).values({
|
|
id: otherAgentId,
|
|
companyId,
|
|
name: "OtherCoder",
|
|
role: "engineer",
|
|
status: "active",
|
|
adapterType: "codex_local",
|
|
adapterConfig: {},
|
|
runtimeConfig: {},
|
|
permissions: {},
|
|
});
|
|
const revision1Id = routine.latestRevisionId!;
|
|
|
|
await svc.update(routine.id, { assigneeAgentId: otherAgentId }, {});
|
|
|
|
await expect(
|
|
svc.restoreRevision(routine.id, revision1Id, { agentId: otherAgentId }),
|
|
).rejects.toMatchObject({
|
|
status: 403,
|
|
message: "Agents can only restore routine revisions assigned to themselves",
|
|
});
|
|
await expect(svc.get(routine.id)).resolves.toMatchObject({
|
|
assigneeAgentId: otherAgentId,
|
|
latestRevisionNumber: 2,
|
|
});
|
|
});
|
|
|
|
it("blocks restoring routine revisions assigned to agents that are no longer assignable", async () => {
|
|
const { agentId, routine, svc } = await seedFixture();
|
|
const revision1Id = routine.latestRevisionId!;
|
|
await svc.update(routine.id, { description: "revision 2" }, {});
|
|
await db
|
|
.update(agents)
|
|
.set({ status: "terminated" })
|
|
.where(eq(agents.id, agentId));
|
|
|
|
await expect(
|
|
svc.restoreRevision(routine.id, revision1Id, { userId: "board-user" }),
|
|
).rejects.toMatchObject({
|
|
status: 409,
|
|
message: "Cannot assign routines to terminated agents",
|
|
details: {
|
|
code: "agent_not_assignable",
|
|
reason: "assignee_terminated",
|
|
assigneeAgentId: agentId,
|
|
},
|
|
});
|
|
await expect(svc.get(routine.id)).resolves.toMatchObject({
|
|
description: "revision 2",
|
|
latestRevisionNumber: 2,
|
|
});
|
|
});
|
|
|
|
it("blocks routine reassignment to agents under terminated managers", async () => {
|
|
const { agentId, companyId, routine, svc } = await seedFixture();
|
|
const terminatedManagerId = randomUUID();
|
|
const blockedAgentId = randomUUID();
|
|
await db.insert(agents).values([
|
|
{
|
|
id: terminatedManagerId,
|
|
companyId,
|
|
name: "TerminatedManager",
|
|
role: "manager",
|
|
status: "terminated",
|
|
adapterType: "codex_local",
|
|
adapterConfig: {},
|
|
runtimeConfig: {},
|
|
permissions: {},
|
|
},
|
|
{
|
|
id: blockedAgentId,
|
|
companyId,
|
|
name: "BlockedRoutineCoder",
|
|
role: "engineer",
|
|
status: "active",
|
|
reportsTo: terminatedManagerId,
|
|
adapterType: "codex_local",
|
|
adapterConfig: {},
|
|
runtimeConfig: {},
|
|
permissions: {},
|
|
},
|
|
]);
|
|
|
|
await expect(svc.update(routine.id, {
|
|
assigneeAgentId: blockedAgentId,
|
|
}, { userId: "board-user" })).rejects.toMatchObject({
|
|
status: 409,
|
|
details: {
|
|
code: "agent_not_assignable",
|
|
reason: "ancestor_terminated",
|
|
assigneeAgentId: blockedAgentId,
|
|
invalidAncestorAgentId: terminatedManagerId,
|
|
},
|
|
});
|
|
|
|
await expect(svc.get(routine.id)).resolves.toMatchObject({
|
|
assigneeAgentId: agentId,
|
|
});
|
|
});
|
|
|
|
it("blocks manual routine runs when the persisted assignee is no longer assignable", async () => {
|
|
const { agentId, routine, svc } = await seedFixture();
|
|
await db
|
|
.update(agents)
|
|
.set({ status: "terminated" })
|
|
.where(eq(agents.id, agentId));
|
|
|
|
await expect(svc.runRoutine(routine.id, {
|
|
source: "manual",
|
|
payload: null,
|
|
variables: null,
|
|
}, { userId: "board-user" })).rejects.toMatchObject({
|
|
status: 409,
|
|
details: {
|
|
code: "agent_not_assignable",
|
|
reason: "assignee_terminated",
|
|
assigneeAgentId: agentId,
|
|
},
|
|
});
|
|
});
|
|
|
|
it("appends safe trigger metadata revisions without leaking webhook secrets", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const created = await svc.createTrigger(routine.id, {
|
|
kind: "webhook",
|
|
signingMode: "bearer",
|
|
replayWindowSec: 300,
|
|
}, {});
|
|
expect(created.revision.revisionNumber).toBe(2);
|
|
expect(created.secretMaterial?.webhookSecret).toBeTruthy();
|
|
|
|
const updated = await svc.updateTrigger(created.trigger.id, { label: "deploy hook" }, {});
|
|
expect(updated?.revision.revisionNumber).toBe(3);
|
|
|
|
const rotated = await svc.rotateTriggerSecret(created.trigger.id, {});
|
|
expect(rotated.revision.revisionNumber).toBe(4);
|
|
expect(rotated.secretMaterial.webhookSecret).toBeTruthy();
|
|
|
|
const deleted = await svc.deleteTrigger(created.trigger.id, {});
|
|
expect(deleted.revision?.revisionNumber).toBe(5);
|
|
await expect(db.select().from(companySecrets).where(eq(companySecrets.id, created.trigger.secretId!))).resolves.toHaveLength(0);
|
|
await expect(db.select().from(companySecretBindings).where(eq(companySecretBindings.secretId, created.trigger.secretId!))).resolves.toHaveLength(0);
|
|
|
|
const revisions = await svc.listRevisions(routine.id);
|
|
const serialized = JSON.stringify(revisions.map((revision) => revision.snapshot));
|
|
expect(serialized).toContain(created.trigger.publicId!);
|
|
expect(serialized).not.toContain(created.secretMaterial!.webhookSecret);
|
|
expect(serialized).not.toContain(rotated.secretMaterial.webhookSecret);
|
|
expect(serialized).not.toContain(created.trigger.secretId!);
|
|
expect(revisions[0]?.snapshot.triggers).toHaveLength(0);
|
|
});
|
|
|
|
it("wakes the assignee when a routine creates a fresh execution issue", async () => {
|
|
const { agentId, routine, svc, wakeups } = await seedFixture();
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
|
|
expect(run.status).toBe("issue_created");
|
|
expect(run.linkedIssueId).toBeTruthy();
|
|
expect(wakeups).toEqual([
|
|
{
|
|
agentId,
|
|
opts: {
|
|
source: "assignment",
|
|
triggerDetail: "system",
|
|
reason: "issue_assigned",
|
|
payload: { issueId: run.linkedIssueId, mutation: "create" },
|
|
requestedByActorType: undefined,
|
|
requestedByActorId: null,
|
|
contextSnapshot: { issueId: run.linkedIssueId, source: "routine.dispatch" },
|
|
},
|
|
},
|
|
]);
|
|
});
|
|
|
|
it("records the manual board runner on fresh routine issues so they appear in that user's inbox", async () => {
|
|
const { companyId, agentId, issueSvc, routine, svc } = await seedFixture();
|
|
const userId = randomUUID();
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" }, { userId });
|
|
|
|
expect(run.status).toBe("issue_created");
|
|
expect(run.linkedIssueId).toBeTruthy();
|
|
const [createdIssue] = await db
|
|
.select({
|
|
id: issues.id,
|
|
assigneeAgentId: issues.assigneeAgentId,
|
|
createdByUserId: issues.createdByUserId,
|
|
})
|
|
.from(issues)
|
|
.where(eq(issues.id, run.linkedIssueId!));
|
|
expect(createdIssue).toMatchObject({
|
|
id: run.linkedIssueId,
|
|
assigneeAgentId: agentId,
|
|
createdByUserId: userId,
|
|
});
|
|
|
|
const inboxIssues = await issueSvc.list(companyId, {
|
|
touchedByUserId: userId,
|
|
inboxArchivedByUserId: userId,
|
|
includeRoutineExecutions: true,
|
|
});
|
|
expect(inboxIssues.map((issue) => issue.id)).toContain(run.linkedIssueId);
|
|
});
|
|
|
|
it("waits for the assignee wakeup to be queued before returning the routine run", async () => {
|
|
let wakeupResolved = false;
|
|
const { routine, svc } = await seedFixture({
|
|
wakeup: async () => {
|
|
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
wakeupResolved = true;
|
|
return null;
|
|
},
|
|
});
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
|
|
expect(run.status).toBe("issue_created");
|
|
expect(wakeupResolved).toBe(true);
|
|
});
|
|
|
|
it("coalesces only when the existing routine issue has a live execution run", async () => {
|
|
const { agentId, companyId, issueSvc, routine, svc } = await seedFixture();
|
|
const previousRunId = randomUUID();
|
|
const liveHeartbeatRunId = randomUUID();
|
|
const previousIssue = await issueSvc.create(companyId, {
|
|
projectId: routine.projectId,
|
|
title: routine.title,
|
|
description: routine.description,
|
|
status: "in_progress",
|
|
priority: routine.priority,
|
|
assigneeAgentId: routine.assigneeAgentId,
|
|
originKind: "routine_execution",
|
|
originId: routine.id,
|
|
originRunId: previousRunId,
|
|
});
|
|
|
|
await db.insert(routineRuns).values({
|
|
id: previousRunId,
|
|
companyId,
|
|
routineId: routine.id,
|
|
triggerId: null,
|
|
source: "manual",
|
|
status: "issue_created",
|
|
triggeredAt: new Date("2026-03-20T12:00:00.000Z"),
|
|
linkedIssueId: previousIssue.id,
|
|
});
|
|
|
|
await db.insert(heartbeatRuns).values({
|
|
id: liveHeartbeatRunId,
|
|
companyId,
|
|
agentId,
|
|
invocationSource: "assignment",
|
|
triggerDetail: "system",
|
|
status: "running",
|
|
contextSnapshot: { issueId: previousIssue.id },
|
|
startedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
});
|
|
|
|
await db
|
|
.update(issues)
|
|
.set({
|
|
checkoutRunId: liveHeartbeatRunId,
|
|
executionRunId: liveHeartbeatRunId,
|
|
executionLockedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
})
|
|
.where(eq(issues.id, previousIssue.id));
|
|
|
|
const detailBefore = await svc.getDetail(routine.id);
|
|
expect(detailBefore?.activeIssue?.id).toBe(previousIssue.id);
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
expect(run.status).toBe("coalesced");
|
|
expect(run.linkedIssueId).toBe(previousIssue.id);
|
|
expect(run.coalescedIntoRunId).toBe(previousRunId);
|
|
|
|
const routineIssues = await db
|
|
.select({ id: issues.id })
|
|
.from(issues)
|
|
.where(eq(issues.originId, routine.id));
|
|
|
|
expect(routineIssues).toHaveLength(1);
|
|
expect(routineIssues[0]?.id).toBe(previousIssue.id);
|
|
});
|
|
|
|
it("touches a coalesced routine issue for the manual runner's inbox", async () => {
|
|
const { agentId, companyId, issueSvc, routine, svc } = await seedFixture();
|
|
const userId = randomUUID();
|
|
const previousRunId = randomUUID();
|
|
const liveHeartbeatRunId = randomUUID();
|
|
const previousIssue = await issueSvc.create(companyId, {
|
|
projectId: routine.projectId,
|
|
title: routine.title,
|
|
description: routine.description,
|
|
status: "in_progress",
|
|
priority: routine.priority,
|
|
assigneeAgentId: routine.assigneeAgentId,
|
|
originKind: "routine_execution",
|
|
originId: routine.id,
|
|
originRunId: previousRunId,
|
|
});
|
|
|
|
await db.insert(routineRuns).values({
|
|
id: previousRunId,
|
|
companyId,
|
|
routineId: routine.id,
|
|
triggerId: null,
|
|
source: "manual",
|
|
status: "issue_created",
|
|
triggeredAt: new Date("2026-03-20T12:00:00.000Z"),
|
|
linkedIssueId: previousIssue.id,
|
|
});
|
|
await db.insert(heartbeatRuns).values({
|
|
id: liveHeartbeatRunId,
|
|
companyId,
|
|
agentId,
|
|
invocationSource: "assignment",
|
|
triggerDetail: "system",
|
|
status: "running",
|
|
contextSnapshot: { issueId: previousIssue.id },
|
|
startedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
});
|
|
await db
|
|
.update(issues)
|
|
.set({
|
|
checkoutRunId: liveHeartbeatRunId,
|
|
executionRunId: liveHeartbeatRunId,
|
|
executionLockedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
})
|
|
.where(eq(issues.id, previousIssue.id));
|
|
await db.insert(issueInboxArchives).values({
|
|
companyId,
|
|
issueId: previousIssue.id,
|
|
userId,
|
|
archivedAt: new Date("2026-03-20T12:02:00.000Z"),
|
|
});
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" }, { userId });
|
|
|
|
expect(run.status).toBe("coalesced");
|
|
expect(run.linkedIssueId).toBe(previousIssue.id);
|
|
await expect(
|
|
db.select().from(issueInboxArchives).where(eq(issueInboxArchives.issueId, previousIssue.id)),
|
|
).resolves.toHaveLength(0);
|
|
await expect(
|
|
db.select().from(issueReadStates).where(eq(issueReadStates.issueId, previousIssue.id)),
|
|
).resolves.toEqual([
|
|
expect.objectContaining({
|
|
companyId,
|
|
issueId: previousIssue.id,
|
|
userId,
|
|
}),
|
|
]);
|
|
|
|
const inboxIssues = await issueSvc.list(companyId, {
|
|
touchedByUserId: userId,
|
|
inboxArchivedByUserId: userId,
|
|
includeRoutineExecutions: true,
|
|
});
|
|
expect(inboxIssues.map((issue) => issue.id)).toContain(previousIssue.id);
|
|
});
|
|
|
|
it("touches a skipped active routine issue for the manual runner's inbox", async () => {
|
|
const { agentId, companyId, issueSvc, routine, svc } = await seedFixture();
|
|
const userId = randomUUID();
|
|
const previousRunId = randomUUID();
|
|
const liveHeartbeatRunId = randomUUID();
|
|
|
|
await db
|
|
.update(routines)
|
|
.set({ concurrencyPolicy: "skip_if_active" })
|
|
.where(eq(routines.id, routine.id));
|
|
|
|
const previousIssue = await issueSvc.create(companyId, {
|
|
projectId: routine.projectId,
|
|
title: routine.title,
|
|
description: routine.description,
|
|
status: "in_progress",
|
|
priority: routine.priority,
|
|
assigneeAgentId: routine.assigneeAgentId,
|
|
originKind: "routine_execution",
|
|
originId: routine.id,
|
|
originRunId: previousRunId,
|
|
});
|
|
|
|
await db.insert(routineRuns).values({
|
|
id: previousRunId,
|
|
companyId,
|
|
routineId: routine.id,
|
|
triggerId: null,
|
|
source: "manual",
|
|
status: "issue_created",
|
|
triggeredAt: new Date("2026-03-20T12:00:00.000Z"),
|
|
linkedIssueId: previousIssue.id,
|
|
});
|
|
await db.insert(heartbeatRuns).values({
|
|
id: liveHeartbeatRunId,
|
|
companyId,
|
|
agentId,
|
|
invocationSource: "assignment",
|
|
triggerDetail: "system",
|
|
status: "running",
|
|
contextSnapshot: { issueId: previousIssue.id },
|
|
startedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
});
|
|
await db
|
|
.update(issues)
|
|
.set({
|
|
checkoutRunId: liveHeartbeatRunId,
|
|
executionRunId: liveHeartbeatRunId,
|
|
executionLockedAt: new Date("2026-03-20T12:01:00.000Z"),
|
|
})
|
|
.where(eq(issues.id, previousIssue.id));
|
|
await db.insert(issueInboxArchives).values({
|
|
companyId,
|
|
issueId: previousIssue.id,
|
|
userId,
|
|
archivedAt: new Date("2026-03-20T12:02:00.000Z"),
|
|
});
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" }, { userId });
|
|
|
|
expect(run.status).toBe("skipped");
|
|
expect(run.linkedIssueId).toBe(previousIssue.id);
|
|
await expect(
|
|
db.select().from(issueInboxArchives).where(eq(issueInboxArchives.issueId, previousIssue.id)),
|
|
).resolves.toHaveLength(0);
|
|
await expect(
|
|
db.select().from(issueReadStates).where(eq(issueReadStates.issueId, previousIssue.id)),
|
|
).resolves.toEqual([
|
|
expect.objectContaining({
|
|
companyId,
|
|
issueId: previousIssue.id,
|
|
userId,
|
|
}),
|
|
]);
|
|
|
|
const inboxIssues = await issueSvc.list(companyId, {
|
|
touchedByUserId: userId,
|
|
inboxArchivedByUserId: userId,
|
|
includeRoutineExecutions: true,
|
|
});
|
|
expect(inboxIssues.map((issue) => issue.id)).toContain(previousIssue.id);
|
|
});
|
|
|
|
it("does not coalesce live routine runs with different resolved variables", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const variableRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "pre-pr for {{branch}}",
|
|
description: "Create a pre-PR from {{branch}}",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
variables: [
|
|
{ name: "branch", label: null, type: "text", defaultValue: null, required: true, options: [] },
|
|
],
|
|
},
|
|
{},
|
|
);
|
|
|
|
const first = await svc.runRoutine(variableRoutine.id, {
|
|
source: "manual",
|
|
variables: { branch: "feature/a" },
|
|
});
|
|
const second = await svc.runRoutine(variableRoutine.id, {
|
|
source: "manual",
|
|
variables: { branch: "feature/b" },
|
|
});
|
|
|
|
expect(first.status).toBe("issue_created");
|
|
expect(second.status).toBe("issue_created");
|
|
expect(first.linkedIssueId).toBeTruthy();
|
|
expect(second.linkedIssueId).toBeTruthy();
|
|
expect(first.linkedIssueId).not.toBe(second.linkedIssueId);
|
|
|
|
const routineIssues = await db
|
|
.select({
|
|
id: issues.id,
|
|
title: issues.title,
|
|
originFingerprint: issues.originFingerprint,
|
|
})
|
|
.from(issues)
|
|
.where(eq(issues.originId, variableRoutine.id));
|
|
|
|
expect(routineIssues).toHaveLength(2);
|
|
expect(routineIssues.map((issue) => issue.title).sort()).toEqual([
|
|
"pre-pr for feature/a",
|
|
"pre-pr for feature/b",
|
|
]);
|
|
expect(new Set(routineIssues.map((issue) => issue.originFingerprint)).size).toBe(2);
|
|
});
|
|
|
|
it("interpolates routine variables into the execution issue and stores resolved values", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const variableRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "repo triage for {{repo}}",
|
|
description: "Review {{repo}} for {{priority}} bugs",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
variables: [
|
|
{ name: "repo", label: null, type: "text", defaultValue: null, required: true, options: [] },
|
|
{ name: "priority", label: null, type: "select", defaultValue: "high", required: true, options: ["high", "low"] },
|
|
],
|
|
},
|
|
{},
|
|
);
|
|
expect(variableRoutine.variables.map((variable) => variable.name)).toEqual(["repo", "priority"]);
|
|
|
|
const run = await svc.runRoutine(variableRoutine.id, {
|
|
source: "manual",
|
|
variables: { repo: "paperclip" },
|
|
});
|
|
|
|
const storedIssue = await db
|
|
.select({ title: issues.title, description: issues.description })
|
|
.from(issues)
|
|
.where(eq(issues.id, run.linkedIssueId!))
|
|
.then((rows) => rows[0] ?? null);
|
|
const storedRun = await db
|
|
.select({ triggerPayload: routineRuns.triggerPayload })
|
|
.from(routineRuns)
|
|
.where(eq(routineRuns.id, run.id))
|
|
.then((rows) => rows[0] ?? null);
|
|
|
|
expect(storedIssue?.title).toBe("repo triage for paperclip");
|
|
expect(storedIssue?.description).toBe("Review paperclip for high bugs");
|
|
expect(storedRun?.triggerPayload).toEqual({
|
|
variables: {
|
|
repo: "paperclip",
|
|
priority: "high",
|
|
},
|
|
});
|
|
});
|
|
|
|
it("attaches the selected execution workspace to manually triggered routine issues", async () => {
|
|
const { companyId, projectId, routine, svc } = await seedFixture();
|
|
const projectWorkspaceId = randomUUID();
|
|
const executionWorkspaceId = randomUUID();
|
|
|
|
await instanceSettingsService(db).updateExperimental({ enableIsolatedWorkspaces: true });
|
|
await db
|
|
.update(projects)
|
|
.set({
|
|
executionWorkspacePolicy: {
|
|
enabled: true,
|
|
defaultMode: "shared_workspace",
|
|
defaultProjectWorkspaceId: projectWorkspaceId,
|
|
},
|
|
})
|
|
.where(eq(projects.id, projectId));
|
|
await db.insert(projectWorkspaces).values({
|
|
id: projectWorkspaceId,
|
|
companyId,
|
|
projectId,
|
|
name: "Primary workspace",
|
|
isPrimary: true,
|
|
sharedWorkspaceKey: "routine-primary",
|
|
});
|
|
await db.insert(executionWorkspaces).values({
|
|
id: executionWorkspaceId,
|
|
companyId,
|
|
projectId,
|
|
projectWorkspaceId,
|
|
mode: "isolated_workspace",
|
|
strategyType: "git_worktree",
|
|
name: "Routine worktree",
|
|
status: "active",
|
|
providerType: "git_worktree",
|
|
});
|
|
|
|
const run = await svc.runRoutine(routine.id, {
|
|
source: "manual",
|
|
executionWorkspaceId,
|
|
executionWorkspacePreference: "reuse_existing",
|
|
executionWorkspaceSettings: { mode: "isolated_workspace" },
|
|
});
|
|
|
|
const storedIssue = await db
|
|
.select({
|
|
projectWorkspaceId: issues.projectWorkspaceId,
|
|
executionWorkspaceId: issues.executionWorkspaceId,
|
|
executionWorkspacePreference: issues.executionWorkspacePreference,
|
|
executionWorkspaceSettings: issues.executionWorkspaceSettings,
|
|
})
|
|
.from(issues)
|
|
.where(eq(issues.id, run.linkedIssueId!))
|
|
.then((rows) => rows[0] ?? null);
|
|
|
|
expect(storedIssue).toEqual({
|
|
projectWorkspaceId,
|
|
executionWorkspaceId,
|
|
executionWorkspacePreference: "reuse_existing",
|
|
executionWorkspaceSettings: { mode: "isolated_workspace" },
|
|
});
|
|
});
|
|
|
|
it("auto-populates workspaceBranch from a reused isolated workspace", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const projectWorkspaceId = randomUUID();
|
|
const executionWorkspaceId = randomUUID();
|
|
|
|
await instanceSettingsService(db).updateExperimental({ enableIsolatedWorkspaces: true });
|
|
await db
|
|
.update(projects)
|
|
.set({
|
|
executionWorkspacePolicy: {
|
|
enabled: true,
|
|
defaultMode: "shared_workspace",
|
|
defaultProjectWorkspaceId: projectWorkspaceId,
|
|
},
|
|
})
|
|
.where(eq(projects.id, projectId));
|
|
await db.insert(projectWorkspaces).values({
|
|
id: projectWorkspaceId,
|
|
companyId,
|
|
projectId,
|
|
name: "Primary workspace",
|
|
isPrimary: true,
|
|
sharedWorkspaceKey: "routine-primary",
|
|
});
|
|
await db.insert(executionWorkspaces).values({
|
|
id: executionWorkspaceId,
|
|
companyId,
|
|
projectId,
|
|
projectWorkspaceId,
|
|
mode: "isolated_workspace",
|
|
strategyType: "git_worktree",
|
|
name: "Routine worktree",
|
|
status: "active",
|
|
providerType: "git_worktree",
|
|
branchName: "pap-1634-routine-branch",
|
|
});
|
|
|
|
const branchRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "Review {{workspaceBranch}}",
|
|
description: "Use branch {{workspaceBranch}}",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
variables: [
|
|
{ name: "workspaceBranch", label: null, type: "text", defaultValue: null, required: true, options: [] },
|
|
],
|
|
},
|
|
{},
|
|
);
|
|
|
|
const run = await svc.runRoutine(branchRoutine.id, {
|
|
source: "manual",
|
|
executionWorkspaceId,
|
|
executionWorkspacePreference: "reuse_existing",
|
|
executionWorkspaceSettings: { mode: "isolated_workspace" },
|
|
});
|
|
|
|
const storedIssue = await db
|
|
.select({ title: issues.title, description: issues.description })
|
|
.from(issues)
|
|
.where(eq(issues.id, run.linkedIssueId!))
|
|
.then((rows) => rows[0] ?? null);
|
|
const storedRun = await db
|
|
.select({ triggerPayload: routineRuns.triggerPayload })
|
|
.from(routineRuns)
|
|
.where(eq(routineRuns.id, run.id))
|
|
.then((rows) => rows[0] ?? null);
|
|
|
|
expect(storedIssue?.title).toBe("Review pap-1634-routine-branch");
|
|
expect(storedIssue?.description).toBe("Use branch pap-1634-routine-branch");
|
|
expect(storedRun?.triggerPayload).toEqual({
|
|
variables: {
|
|
workspaceBranch: "pap-1634-routine-branch",
|
|
},
|
|
});
|
|
});
|
|
|
|
it("runs draft routines with one-off agent and project overrides", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const draftRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId: null,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "draft dispatch",
|
|
description: "Pick defaults at run time",
|
|
assigneeAgentId: null,
|
|
priority: "medium",
|
|
status: "paused",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const run = await svc.runRoutine(draftRoutine.id, {
|
|
source: "manual",
|
|
projectId,
|
|
assigneeAgentId: agentId,
|
|
});
|
|
|
|
expect(run.status).toBe("issue_created");
|
|
expect(run.linkedIssueId).toBeTruthy();
|
|
|
|
const storedIssue = await db
|
|
.select({
|
|
projectId: issues.projectId,
|
|
assigneeAgentId: issues.assigneeAgentId,
|
|
})
|
|
.from(issues)
|
|
.where(eq(issues.id, run.linkedIssueId!))
|
|
.then((rows) => rows[0] ?? null);
|
|
|
|
expect(storedIssue).toEqual({
|
|
projectId,
|
|
assigneeAgentId: agentId,
|
|
});
|
|
});
|
|
|
|
it("rejects enabling automation for routines without a default agent", async () => {
|
|
const { companyId, svc } = await seedFixture();
|
|
const draftRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId: null,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "draft routine",
|
|
description: null,
|
|
assigneeAgentId: null,
|
|
priority: "medium",
|
|
status: "paused",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
},
|
|
{},
|
|
);
|
|
|
|
await expect(
|
|
svc.update(draftRoutine.id, { status: "active" }, {}),
|
|
).rejects.toThrow(/default agent required/i);
|
|
});
|
|
|
|
it("blocks schedule triggers when required variables do not have defaults", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const variableRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "repo triage",
|
|
description: "Review {{repo}}",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
variables: [
|
|
{ name: "repo", label: null, type: "text", defaultValue: null, required: true, options: [] },
|
|
],
|
|
},
|
|
{},
|
|
);
|
|
|
|
await expect(
|
|
svc.createTrigger(variableRoutine.id, {
|
|
kind: "schedule",
|
|
label: "daily",
|
|
cronExpression: "0 10 * * *",
|
|
timezone: "UTC",
|
|
}, {}),
|
|
).rejects.toThrow(/require defaults for required variables/i);
|
|
});
|
|
|
|
it("treats malformed stored defaults as missing when validating schedule triggers", async () => {
|
|
const { companyId, agentId, projectId, svc } = await seedFixture();
|
|
const variableRoutine = await svc.create(
|
|
companyId,
|
|
{
|
|
projectId,
|
|
goalId: null,
|
|
parentIssueId: null,
|
|
title: "ship check",
|
|
description: "Review {{approved}}",
|
|
assigneeAgentId: agentId,
|
|
priority: "medium",
|
|
status: "active",
|
|
concurrencyPolicy: "coalesce_if_active",
|
|
catchUpPolicy: "skip_missed",
|
|
variables: [
|
|
{ name: "approved", label: null, type: "boolean", defaultValue: true, required: true, options: [] },
|
|
],
|
|
},
|
|
{},
|
|
);
|
|
|
|
await db
|
|
.update(routines)
|
|
.set({
|
|
variables: [
|
|
{
|
|
name: "approved",
|
|
label: null,
|
|
type: "boolean",
|
|
defaultValue: "definitely",
|
|
required: true,
|
|
options: [],
|
|
},
|
|
],
|
|
})
|
|
.where(eq(routines.id, variableRoutine.id));
|
|
|
|
await expect(
|
|
svc.createTrigger(variableRoutine.id, {
|
|
kind: "schedule",
|
|
label: "daily",
|
|
cronExpression: "0 10 * * *",
|
|
timezone: "UTC",
|
|
}, {}),
|
|
).rejects.toThrow(/require defaults for required variables/i);
|
|
});
|
|
|
|
it("serializes concurrent dispatches until the first execution issue is linked to a queued run", async () => {
|
|
const { routine, svc } = await seedFixture({
|
|
wakeup: async (wakeupAgentId, wakeupOpts) => {
|
|
const issueId =
|
|
(typeof wakeupOpts.payload?.issueId === "string" && wakeupOpts.payload.issueId) ||
|
|
(typeof wakeupOpts.contextSnapshot?.issueId === "string" && wakeupOpts.contextSnapshot.issueId) ||
|
|
null;
|
|
await new Promise((resolve) => setTimeout(resolve, 25));
|
|
if (!issueId) return null;
|
|
const queuedRunId = randomUUID();
|
|
await db.insert(heartbeatRuns).values({
|
|
id: queuedRunId,
|
|
companyId: routine.companyId,
|
|
agentId: wakeupAgentId,
|
|
invocationSource: wakeupOpts.source ?? "assignment",
|
|
triggerDetail: wakeupOpts.triggerDetail ?? null,
|
|
status: "queued",
|
|
contextSnapshot: { ...(wakeupOpts.contextSnapshot ?? {}), issueId },
|
|
});
|
|
await db
|
|
.update(issues)
|
|
.set({
|
|
executionRunId: queuedRunId,
|
|
executionLockedAt: new Date(),
|
|
})
|
|
.where(eq(issues.id, issueId));
|
|
return { id: queuedRunId };
|
|
},
|
|
});
|
|
|
|
const [first, second] = await Promise.all([
|
|
svc.runRoutine(routine.id, { source: "manual" }),
|
|
svc.runRoutine(routine.id, { source: "manual" }),
|
|
]);
|
|
|
|
expect([first.status, second.status].sort()).toEqual(["coalesced", "issue_created"]);
|
|
expect(first.linkedIssueId).toBeTruthy();
|
|
expect(second.linkedIssueId).toBeTruthy();
|
|
expect(first.linkedIssueId).toBe(second.linkedIssueId);
|
|
|
|
const routineIssues = await db
|
|
.select({ id: issues.id })
|
|
.from(issues)
|
|
.where(eq(issues.originId, routine.id));
|
|
|
|
expect(routineIssues).toHaveLength(1);
|
|
});
|
|
|
|
it("fails the run and cleans up the execution issue when wakeup queueing fails", async () => {
|
|
const { routine, svc } = await seedFixture({
|
|
wakeup: async () => {
|
|
throw new Error("queue unavailable");
|
|
},
|
|
});
|
|
|
|
const run = await svc.runRoutine(routine.id, { source: "manual" });
|
|
|
|
expect(run.status).toBe("failed");
|
|
expect(run.failureReason).toContain("queue unavailable");
|
|
expect(run.linkedIssueId).toBeNull();
|
|
|
|
const routineIssues = await db
|
|
.select({ id: issues.id })
|
|
.from(issues)
|
|
.where(eq(issues.originId, routine.id));
|
|
|
|
expect(routineIssues).toHaveLength(0);
|
|
});
|
|
|
|
it("accepts standard second-precision webhook timestamps for HMAC triggers", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const { trigger, secretMaterial } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "webhook",
|
|
signingMode: "hmac_sha256",
|
|
replayWindowSec: 300,
|
|
},
|
|
{},
|
|
);
|
|
|
|
expect(trigger.publicId).toBeTruthy();
|
|
expect(secretMaterial?.webhookSecret).toBeTruthy();
|
|
|
|
const payload = { ok: true };
|
|
const rawBody = Buffer.from(JSON.stringify(payload));
|
|
const timestampSeconds = String(Math.floor(Date.now() / 1000));
|
|
const signature = `sha256=${createHmac("sha256", secretMaterial!.webhookSecret)
|
|
.update(`${timestampSeconds}.`)
|
|
.update(rawBody)
|
|
.digest("hex")}`;
|
|
|
|
const run = await svc.firePublicTrigger(trigger.publicId!, {
|
|
signatureHeader: signature,
|
|
timestampHeader: timestampSeconds,
|
|
rawBody,
|
|
payload,
|
|
});
|
|
|
|
expect(run.source).toBe("webhook");
|
|
expect(run.status).toBe("issue_created");
|
|
expect(run.linkedIssueId).toBeTruthy();
|
|
});
|
|
|
|
it("uses the configured provider for generated webhook trigger secrets", async () => {
|
|
process.env.PAPERCLIP_SECRETS_PROVIDER = "aws_secrets_manager";
|
|
const originalGetSecretProvider = providerRegistry.getSecretProvider;
|
|
const getSecretProviderSpy = vi.spyOn(providerRegistry, "getSecretProvider").mockImplementation((provider) => {
|
|
if (provider !== "aws_secrets_manager") {
|
|
return originalGetSecretProvider(provider);
|
|
}
|
|
return {
|
|
id: "aws_secrets_manager",
|
|
descriptor: () => ({
|
|
id: "aws_secrets_manager",
|
|
label: "AWS Secrets Manager",
|
|
supportsManaged: true,
|
|
supportsExternalReference: true,
|
|
}),
|
|
validateConfig: async () => ({ ok: true, warnings: [] }),
|
|
createSecret: async ({ value }) => ({
|
|
material: { source: "managed", secretId: "arn:aws:secretsmanager:stub", versionId: "v1" },
|
|
valueSha256: `sha:${value}`,
|
|
fingerprintSha256: `sha:${value}`,
|
|
externalRef: "arn:aws:secretsmanager:stub",
|
|
providerVersionRef: "v1",
|
|
}),
|
|
createVersion: async ({ value }) => ({
|
|
material: { source: "managed", secretId: "arn:aws:secretsmanager:stub", versionId: "v2" },
|
|
valueSha256: `sha:${value}`,
|
|
fingerprintSha256: `sha:${value}`,
|
|
externalRef: "arn:aws:secretsmanager:stub",
|
|
providerVersionRef: "v2",
|
|
}),
|
|
linkExternalSecret: async ({ externalRef, providerVersionRef }) => ({
|
|
material: { source: "external", secretId: externalRef, versionId: providerVersionRef ?? null },
|
|
valueSha256: "external",
|
|
fingerprintSha256: "external",
|
|
externalRef,
|
|
providerVersionRef: providerVersionRef ?? null,
|
|
}),
|
|
resolveVersion: async () => "resolved-secret",
|
|
deleteOrArchive: async () => undefined,
|
|
healthCheck: async () => ({
|
|
provider: "aws_secrets_manager",
|
|
status: "ok",
|
|
message: "stubbed",
|
|
}),
|
|
};
|
|
});
|
|
|
|
try {
|
|
const { routine, svc } = await seedFixture();
|
|
const { trigger } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "webhook",
|
|
signingMode: "hmac_sha256",
|
|
replayWindowSec: 300,
|
|
},
|
|
{},
|
|
);
|
|
|
|
const [secret] = await db
|
|
.select({
|
|
id: companySecrets.id,
|
|
provider: companySecrets.provider,
|
|
})
|
|
.from(companySecrets)
|
|
.where(eq(companySecrets.id, trigger.secretId!));
|
|
|
|
expect(secret).toMatchObject({
|
|
id: trigger.secretId,
|
|
provider: "aws_secrets_manager",
|
|
});
|
|
} finally {
|
|
getSecretProviderSpy.mockRestore();
|
|
}
|
|
});
|
|
|
|
it("accepts GitHub-style X-Hub-Signature-256 with github_hmac signing mode", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const { trigger, secretMaterial } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "webhook",
|
|
signingMode: "github_hmac",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const payload = { action: "opened", pull_request: { number: 1 } };
|
|
const rawBody = Buffer.from(JSON.stringify(payload));
|
|
const signature = `sha256=${createHmac("sha256", secretMaterial!.webhookSecret)
|
|
.update(rawBody)
|
|
.digest("hex")}`;
|
|
|
|
const run = await svc.firePublicTrigger(trigger.publicId!, {
|
|
hubSignatureHeader: signature,
|
|
rawBody,
|
|
payload,
|
|
});
|
|
|
|
expect(run.source).toBe("webhook");
|
|
expect(run.status).toBe("issue_created");
|
|
});
|
|
|
|
it("rejects invalid signature for github_hmac signing mode", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const { trigger } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "webhook",
|
|
signingMode: "github_hmac",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const rawBody = Buffer.from(JSON.stringify({ ok: true }));
|
|
|
|
await expect(
|
|
svc.firePublicTrigger(trigger.publicId!, {
|
|
hubSignatureHeader: "sha256=0000000000000000000000000000000000000000000000000000000000000000",
|
|
rawBody,
|
|
payload: { ok: true },
|
|
}),
|
|
).rejects.toThrow();
|
|
});
|
|
|
|
it("accepts any request with none signing mode", async () => {
|
|
const { routine, svc } = await seedFixture();
|
|
const { trigger } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "webhook",
|
|
signingMode: "none",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const run = await svc.firePublicTrigger(trigger.publicId!, {
|
|
payload: { event: "error.created" },
|
|
});
|
|
|
|
expect(run.source).toBe("webhook");
|
|
expect(run.status).toBe("issue_created");
|
|
});
|
|
|
|
it("suppresses scheduled ticks while the routine project is paused, then resumes when unpaused", async () => {
|
|
const { companyId, projectId, routine, svc } = await seedFixture();
|
|
const { trigger } = await svc.createTrigger(
|
|
routine.id,
|
|
{
|
|
kind: "schedule",
|
|
label: "daily",
|
|
cronExpression: "0 0 * * *",
|
|
timezone: "UTC",
|
|
},
|
|
{},
|
|
);
|
|
|
|
const pastDue = new Date("2020-01-01T00:00:00.000Z");
|
|
|
|
// Pause the project and make the schedule trigger due.
|
|
await db
|
|
.update(projects)
|
|
.set({ pausedAt: new Date(), pauseReason: "manual pause" })
|
|
.where(eq(projects.id, projectId));
|
|
await db
|
|
.update(routineTriggers)
|
|
.set({ nextRunAt: pastDue })
|
|
.where(eq(routineTriggers.id, trigger.id));
|
|
|
|
const pausedResult = await svc.tickScheduledTriggers(new Date());
|
|
expect(pausedResult.triggered).toBe(0);
|
|
|
|
// No execution issue should be created while paused.
|
|
const issuesWhilePaused = await db
|
|
.select()
|
|
.from(issues)
|
|
.where(eq(issues.companyId, companyId));
|
|
expect(issuesWhilePaused).toHaveLength(0);
|
|
|
|
// One skipped routine run with pause-specific reason and no linked issue.
|
|
const skippedRuns = await db
|
|
.select()
|
|
.from(routineRuns)
|
|
.where(eq(routineRuns.routineId, routine.id));
|
|
expect(skippedRuns).toHaveLength(1);
|
|
expect(skippedRuns[0]?.status).toBe("skipped");
|
|
expect(skippedRuns[0]?.source).toBe("schedule");
|
|
expect(skippedRuns[0]?.failureReason).toBe("paused");
|
|
expect(skippedRuns[0]?.linkedIssueId).toBeNull();
|
|
expect(skippedRuns[0]?.completedAt).not.toBeNull();
|
|
|
|
// Trigger advanced past the paused firing and audit reflects the pause skip.
|
|
const pausedTrigger = await db
|
|
.select()
|
|
.from(routineTriggers)
|
|
.where(eq(routineTriggers.id, trigger.id))
|
|
.then((rows) => rows[0]);
|
|
expect(pausedTrigger?.nextRunAt).not.toBeNull();
|
|
expect(pausedTrigger!.nextRunAt!.getTime()).toBeGreaterThan(pastDue.getTime());
|
|
expect(pausedTrigger?.lastResult).toMatch(/paused/i);
|
|
|
|
// Unpause and make the trigger due again; a normal tick now creates an issue.
|
|
await db
|
|
.update(projects)
|
|
.set({ pausedAt: null, pauseReason: null })
|
|
.where(eq(projects.id, projectId));
|
|
await db
|
|
.update(routineTriggers)
|
|
.set({ nextRunAt: pastDue })
|
|
.where(eq(routineTriggers.id, trigger.id));
|
|
|
|
const resumedResult = await svc.tickScheduledTriggers(new Date());
|
|
expect(resumedResult.triggered).toBe(1);
|
|
|
|
const issuesAfterResume = await db
|
|
.select()
|
|
.from(issues)
|
|
.where(eq(issues.companyId, companyId));
|
|
expect(issuesAfterResume).toHaveLength(1);
|
|
|
|
const runsAfterResume = await db
|
|
.select()
|
|
.from(routineRuns)
|
|
.where(eq(routineRuns.routineId, routine.id));
|
|
expect(runsAfterResume).toHaveLength(2);
|
|
expect(runsAfterResume.some((run) => run.status === "issue_created")).toBe(true);
|
|
});
|
|
});
|