merge: wave 2 executor (01-02) into main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

paperclip-reference/tests/e2e/onboarding.spec.ts

@@ -0,0 +1,142 @@
+import { test, expect } from "@playwright/test";
+
+/**
+ * E2E: Onboarding wizard flow (skip_llm mode).
+ *
+ * Walks through the 4-step OnboardingWizard:
+ *   Step 1 — Name your company
+ *   Step 2 — Create your first agent (adapter selection + config)
+ *   Step 3 — Give it something to do (task creation)
+ *   Step 4 — Ready to launch (summary + open issue)
+ *
+ * By default this runs in skip_llm mode: we do NOT assert that an LLM
+ * heartbeat fires. Set PAPERCLIP_E2E_SKIP_LLM=false to enable LLM-dependent
+ * assertions (requires a valid ANTHROPIC_API_KEY).
+ */
+
+const SKIP_LLM = process.env.PAPERCLIP_E2E_SKIP_LLM !== "false";
+
+const COMPANY_NAME = `E2E-Test-${Date.now()}`;
+const AGENT_NAME = "CEO";
+const TASK_TITLE = "E2E test task";
+
+test.describe("Onboarding wizard", () => {
+  test("completes full wizard flow", async ({ page }) => {
+    await page.goto("/");
+
+    const wizardHeading = page.locator("h3", { hasText: "Name your company" });
+    const newCompanyBtn = page.getByRole("button", { name: "New Company" });
+
+    await expect(
+      wizardHeading.or(newCompanyBtn)
+    ).toBeVisible({ timeout: 15_000 });
+
+    if (await newCompanyBtn.isVisible()) {
+      await newCompanyBtn.click();
+    }
+
+    await expect(wizardHeading).toBeVisible({ timeout: 5_000 });
+
+    const companyNameInput = page.locator('input[placeholder="Acme Corp"]');
+    await companyNameInput.fill(COMPANY_NAME);
+
+    const nextButton = page.getByRole("button", { name: "Next" });
+    await nextButton.click();
+
+    await expect(
+      page.locator("h3", { hasText: "Create your first agent" })
+    ).toBeVisible({ timeout: 10_000 });
+
+    const agentNameInput = page.locator('input[placeholder="CEO"]');
+    await expect(agentNameInput).toHaveValue(AGENT_NAME);
+
+    await expect(
+      page.locator("button", { hasText: "Claude Code" }).locator("..")
+    ).toBeVisible();
+
+    await page.getByRole("button", { name: "More Agent Adapter Types" }).click();
+    await expect(page.getByRole("button", { name: "Process" })).toHaveCount(0);
+
+    await page.getByRole("button", { name: "Next" }).click();
+
+    await expect(
+      page.locator("h3", { hasText: "Give it something to do" })
+    ).toBeVisible({ timeout: 10_000 });
+
+    const taskTitleInput = page.locator(
+      'input[placeholder="e.g. Research competitor pricing"]'
+    );
+    await taskTitleInput.clear();
+    await taskTitleInput.fill(TASK_TITLE);
+
+    await page.getByRole("button", { name: "Next" }).click();
+
+    await expect(
+      page.locator("h3", { hasText: "Ready to launch" })
+    ).toBeVisible({ timeout: 10_000 });
+
+    await expect(page.locator("text=" + COMPANY_NAME)).toBeVisible();
+    await expect(page.locator("text=" + AGENT_NAME)).toBeVisible();
+    await expect(page.locator("text=" + TASK_TITLE)).toBeVisible();
+
+    await page.getByRole("button", { name: "Create & Open Issue" }).click();
+
+    await expect(page).toHaveURL(/\/issues\//, { timeout: 10_000 });
+
+    const baseUrl = page.url().split("/").slice(0, 3).join("/");
+
+    const companiesRes = await page.request.get(`${baseUrl}/api/companies`);
+    expect(companiesRes.ok()).toBe(true);
+    const companies = await companiesRes.json();
+    const company = companies.find(
+      (c: { name: string }) => c.name === COMPANY_NAME
+    );
+    expect(company).toBeTruthy();
+
+    const agentsRes = await page.request.get(
+      `${baseUrl}/api/companies/${company.id}/agents`
+    );
+    expect(agentsRes.ok()).toBe(true);
+    const agents = await agentsRes.json();
+    const ceoAgent = agents.find(
+      (a: { name: string }) => a.name === AGENT_NAME
+    );
+    expect(ceoAgent).toBeTruthy();
+    expect(ceoAgent.role).toBe("ceo");
+    expect(ceoAgent.adapterType).not.toBe("process");
+
+    const instructionsBundleRes = await page.request.get(
+      `${baseUrl}/api/agents/${ceoAgent.id}/instructions-bundle?companyId=${company.id}`
+    );
+    expect(instructionsBundleRes.ok()).toBe(true);
+    const instructionsBundle = await instructionsBundleRes.json();
+    expect(
+      instructionsBundle.files.map((file: { path: string }) => file.path).sort()
+    ).toEqual(["AGENTS.md", "HEARTBEAT.md", "SOUL.md", "TOOLS.md"]);
+
+    const issuesRes = await page.request.get(
+      `${baseUrl}/api/companies/${company.id}/issues`
+    );
+    expect(issuesRes.ok()).toBe(true);
+    const issues = await issuesRes.json();
+    const task = issues.find(
+      (i: { title: string }) => i.title === TASK_TITLE
+    );
+    expect(task).toBeTruthy();
+    expect(task.assigneeAgentId).toBe(ceoAgent.id);
+    expect(task.description).toContain(
+      "You are the CEO. You set the direction for the company."
+    );
+    expect(task.description).not.toContain("github.com/paperclipai/companies");
+
+    if (!SKIP_LLM) {
+      await expect(async () => {
+        const res = await page.request.get(
+          `${baseUrl}/api/issues/${task.id}`
+        );
+        const issue = await res.json();
+        expect(["in_progress", "done"]).toContain(issue.status);
+      }).toPass({ timeout: 120_000, intervals: [5_000] });
+    }
+  });
+});

paperclip-reference/tests/e2e/playwright.config.ts

@@ -0,0 +1,35 @@
+import { defineConfig } from "@playwright/test";
+
+const PORT = Number(process.env.PAPERCLIP_E2E_PORT ?? 3100);
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+
+export default defineConfig({
+  testDir: ".",
+  testMatch: "**/*.spec.ts",
+  timeout: 60_000,
+  retries: 0,
+  use: {
+    baseURL: BASE_URL,
+    headless: true,
+    screenshot: "only-on-failure",
+    trace: "on-first-retry",
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: { browserName: "chromium" },
+    },
+  ],
+  // The webServer directive starts `paperclipai run` before tests.
+  // Expects `pnpm paperclipai` to be runnable from repo root.
+  webServer: {
+    command: `pnpm paperclipai run`,
+    url: `${BASE_URL}/api/health`,
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000,
+    stdout: "pipe",
+    stderr: "pipe",
+  },
+  outputDir: "./test-results",
+  reporter: [["list"], ["html", { open: "never", outputFolder: "./playwright-report" }]],
+});