plum-e2e 2.9.17 → 2.12.0

package/.env

@@ -21,4 +21,4 @@
 #
 
 
-IS_HEADLESS=true
+IS_HEADLESS=false

package/CLAUDE.md

@@ -5,7 +5,7 @@
 - **Frontend**: SvelteKit 5, port 5173. ESM, no TypeScript.
 - **Backend**: Express + Socket.io, port 3001. CommonJS (`require`/`module.exports`).
 - **Database**: PostgreSQL via Prisma ORM (`backend/services/prisma.js`).
-- **Infrastructure**: Docker Compose (`docker-compose.yml`) for the server stack. Runner nodes run as a bare `PLUM_MODE=node` Node process (started by `plum node start` / the dev `manage-runners` script), not via Docker.
+- **Infrastructure**: Docker Compose (`docker-compose.yml`) for the server stack. Nodes run as a bare `PLUM_MODE=node` Node process (started by `plum node start` / the dev `manage-nodes` script), not via Docker.
 
 ---
 

package/README.md

@@ -16,7 +16,7 @@
 ## Requirements
 
 - [Node.js](https://nodejs.org) v18 or higher
-- [Docker](https://www.docker.com) — required for `plum server start` (the web UI stack). Runner nodes (`plum node start`) run as a plain Node process and **do not need Docker**.
+- [Docker](https://www.docker.com) — required for `plum server start` (the web UI stack). Nodes (`plum node start`) run as a plain Node process and **do not need Docker**.
 
 ---
 
@@ -42,7 +42,7 @@ plum run-test
 plum server start
 ```
 
-Open **http://localhost:5173** and sign in with the account you create on first start.
+On first start, Plum asks whether you're setting up on a **local machine** or a **production / network server**, and whether to use the default ports (backend `3001`, frontend `3002`). Then open **http://localhost:3002** and sign in with the account you create.
 
 ### For contributors
 
@@ -53,7 +53,7 @@ npm run init        # installs all monorepo dependencies
 npm run docker:up   # builds and starts the full stack
 ```
 
-The UI is available at **http://localhost:5173**. The frontend dev server runs outside Docker for fast HMR — see the **Development** section below.
+The UI is available at **http://localhost:3002**. For fast HMR while developing the frontend, run the Vite dev server outside Docker (`http://localhost:5173`) — see the **Development** section below.
 
 ---
 
@@ -71,7 +71,7 @@ Full documentation is available at:
 | [Running Tests Locally](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/running-tests-locally-GGhFcqaAQ8)       | `plum run-test` flags, parallel runs, debugging tips          |
 | [Retrying Flaky Tests](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/retrying-flaky-tests-NXwRF5SXru)         | Auto-retry failed scenarios, global setting, report badges    |
 | [Setting Up the Server](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/setting-up-the-server-vj0Ab1kJVs)       | Production server setup, reverse proxy (Nginx/Caddy), Docker  |
-| [Setting Up Nodes](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/setting-up-nodes-dtmekJGJia)                 | Runner nodes, systemd service, managing nodes                 |
+| [Setting Up Nodes](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/setting-up-nodes-dtmekJGJia)                 | Nodes, systemd service, managing nodes                        |
 | [Integrations](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/integrations-qfiqfmdP0j)                         | Discord & Slack webhook notifications, CI/external triggers   |
 | [Backup](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/backup-RNNObJfct9)                                     | Backup strategy                                               |
 
@@ -87,7 +87,7 @@ Full documentation is available at:
 | `plum server stop`            | Stop the server (data preserved)                                                              |
 | `plum server reconfig`        | Re-enter server settings without starting                                                     |
 | `plum update`                 | Update Plum, then restart every registered server and node on this machine (asks before each) |
-| `plum node start [name]`      | Register a runner node with the server and start it on this machine                           |
+| `plum node start [name]`      | Register a node with the server and start it on this machine                                  |
 | `plum node list`              | List this machine's nodes and their status                                                    |
 | `plum node restart [name]`    | Stop, refresh dependencies, and restart a node                                                |
 | `plum node stop [name]`       | Stop a node                                                                                   |
@@ -100,7 +100,7 @@ Full documentation is available at:
 | `plum run-test --help`        | Show usage for `run-test`                                                                     |
 | `plum create-step`            | Interactively scaffold a new step definition                                                  |
 | `plum create-test`            | Interactively scaffold a full feature (`.feature` + Page + Steps)                             |
-| `plum manage-runners`         | Open the interactive runner management menu                                                   |
+| `plum manage-nodes`           | Open the interactive node management menu                                                     |
 
 ---
 
@@ -133,7 +133,7 @@ npm test -- @TC-001          # run a specific scenario
 npm test -- --parallel 4     # run in parallel
 npm run create-step          # scaffold a step definition
 npm run create-test          # scaffold a full test from template
-npm run manage-runners       # open the runner management menu
+npm run manage-nodes         # open the node management menu
 ```
 
 ### Test file locations

package/backend/app.js

@@ -8,7 +8,7 @@ const cors = require('cors');
 const { isNodeMode } = require('./constants/env');
 const app = express();
 
-app.use(cors({ origin: '*' }));
+app.use(cors({ origin: '*', exposedHeaders: ['Content-Disposition'] }));
 // Dispatching a run to a node ships the whole tests/ tree (base64-encoded,
 // fixtures included) as one JSON body — Express's 100kb default 413s well
 // before a real test suite does.

package/backend/constants/socketEvents.js

@@ -10,18 +10,14 @@
  * in sync when adding or renaming an event.
  */
 const SOCKET_EVENTS = Object.freeze({
-	// Interactive single-run (built-in runner, one browser tab watching)
+	// Client → server: request a run / cancel a run by id
 	RUN_TEST: 'run-test',
 	CANCEL_TEST: 'cancel-test',
-	LOG: 'log',
-	DONE: 'done',
 
-	// Multi-lane distributed run (single interactive run, several runners)
-	RUNNER_LANES_INIT: 'runner-lanes-init',
-	RUNNER_LANE_LOG: 'runner-lane-log',
-	RUNNER_LANE_STATUS: 'runner-lane-status',
-
-	// Background runs (cron / REST / MCP triggered, no single owning socket)
+	// Server → every client: one run's lifecycle, keyed by runId. Every run
+	// (manual, cron, REST, MCP) flows through the queue and streams over these —
+	// there is no separate "interactive" socket path.
+	BG_RUN_QUEUED: 'bg-run-queued',
 	BG_RUN_START: 'bg-run-start',
 	BG_RUN_LOG: 'bg-run-log',
 	BG_RUN_DONE: 'bg-run-done',
@@ -29,11 +25,9 @@ const SOCKET_EVENTS = Object.freeze({
 	BG_RUN_LANE_LOG: 'bg-run-lane-log',
 	BG_RUN_LANE_STATUS: 'bg-run-lane-status',
 
-	// Live rrweb streaming — one shape for every run type, always
-	// carrying a lane id (BUILT_IN_RUNNER_ID for the plain single-run case) and
-	// a workerId, so a single built-in run with --parallel workers is finally
-	// attributable per worker instead of one flat interleaved stream.
-	RUNNER_LANE_RRWEB_BATCH: 'runner-lane-rrweb-batch',
+	// Live rrweb streaming — always carries a lane id (BUILT_IN_RUNNER_ID for the
+	// plain single-runner case) and a workerId, so a run with --parallel workers
+	// is attributable per worker instead of one flat interleaved stream.
 	BG_RUN_LANE_RRWEB_BATCH: 'bg-run-lane-rrweb-batch',
 
 	// Global notifications (any client, not tied to a specific run)

package/backend/lib/csv.js

@@ -0,0 +1,21 @@
+/*
+ * This file is part of Plum.
+ * Licensed under the MIT License. See LICENSE file in the project root for details.
+ */
+
+// A leading =, +, or - makes a spreadsheet treat the cell as a formula. (@ is
+// left alone — every Cucumber tag starts with one.)
+const FORMULA_LEADS = /^[=+-]/;
+
+function cell(value) {
+	let s = value === null || value === undefined ? '' : String(value);
+	if (FORMULA_LEADS.test(s)) s = `'${s}`;
+	return /[",\r\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+
+// BOM-prefixed so Excel detects UTF-8. `rows[0]` is the header.
+function toCsv(rows) {
+	return '' + rows.map((r) => r.map(cell).join(',')).join('\r\n') + '\r\n';
+}
+
+module.exports = { toCsv, cell };

package/backend/lib/exportResponse.js

@@ -0,0 +1,37 @@
+/*
+ * This file is part of Plum.
+ * Licensed under the MIT License. See LICENSE file in the project root for details.
+ */
+
+const slug = (s) =>
+	String(s)
+		.replace(/[^a-z0-9]+/gi, '-')
+		.replace(/^-+|-+$/g, '')
+		.toLowerCase() || 'export';
+
+const CONTENT_TYPE = {
+	json: 'application/json; charset=utf-8',
+	csv: 'text/csv; charset=utf-8'
+};
+
+const exportFormat = (req) => (String(req.query.format).toLowerCase() === 'csv' ? 'csv' : 'json');
+
+/**
+ * Renders and sends one of `renderers` (keyed by format) as a downloadable
+ * file. Each renderer is a function returning the body (or a promise of it);
+ * only the requested format's renderer runs.
+ */
+async function sendExport(res, { format, filenameBase, ...renderers }) {
+	if (typeof renderers[format] !== 'function') {
+		return res.status(400).json({ error: `Unsupported export format: ${format}` });
+	}
+	const name = `${slug(filenameBase)}-${new Date().toISOString().slice(0, 10)}.${format}`;
+	res.setHeader('Content-Disposition', `attachment; filename="${name}"`);
+	res.setHeader('Content-Type', CONTENT_TYPE[format]);
+
+	const body = await renderers[format]();
+	if (format === 'json') return res.send(JSON.stringify(body, null, 2));
+	res.send(body);
+}
+
+module.exports = { sendExport, exportFormat };

package/backend/lib/serverBootstrap.js

@@ -40,17 +40,17 @@ function attachListenRetry(server, port) {
 }
 
 function wireRealtimeServices(io, isNodeMode) {
-	if (isNodeMode) return { cronService: null, backupCronService: null };
+	if (isNodeMode) return { cronService: null, backupCronService: null, runQueueService: null };
 
 	const socketHandler = require('../websockets/socketHandler.js');
 	const cronService = require('../services/cronService');
 	const backupCronService = require('../services/backupCronService');
+	const runQueueService = require('../services/runQueueService');
 
 	socketHandler(io);
-	cronService.setSocketIO(io);
-	require('../routes/trigger.routes').setSocketIO(io);
+	runQueueService.setSocketIO(io);
 
-	return { cronService, backupCronService };
+	return { cronService, backupCronService, runQueueService };
 }
 
 async function initCronServices(cronService, backupCronService) {
@@ -68,7 +68,7 @@ async function bootstrapMcpKey(isNodeMode) {
 }
 
 function logServerReady(port, isNodeMode) {
-	console.log(`Backend running on port ${port}${isNodeMode ? ' (node/runner mode)' : ''}`);
+	console.log(`Backend running on port ${port}${isNodeMode ? ' (node mode)' : ''}`);
 }
 
 // Dispatches to the node-runner startup path or the full-server startup path
@@ -83,7 +83,7 @@ async function onServerListening({ port, io, testsDir, isNodeMode }) {
 }
 
 function handleNodeModeStartup(port) {
-	// Self-register PID so manage-runners can track and stop this process.
+	// Self-register PID so manage-nodes can track and stop this process.
 	const runnerId = process.env.RUNNER_ID;
 	if (!runnerId) return;
 

package/backend/lib/serverConfig.js

@@ -19,8 +19,10 @@ const CONFIG_FILENAME = '.plum-server.json';
 function defaults() {
 	return {
 		headless: false,
+		// 'local' derives localhost URLs; 'production' takes operator-supplied ones.
+		mode: 'local',
 		backendPort: '3001',
-		frontendPort: '5173',
+		frontendPort: '3002',
 		// Public URLs the browser actually uses. Left blank until the user sets
 		// them (e.g. behind a reverse proxy) — resolved to a localhost default
 		// at the call site otherwise.
@@ -56,10 +58,10 @@ function loadServerConfig(dir) {
 }
 
 function saveServerConfig(dir, cfg) {
-	const { headless, backendPort, frontendPort, apiUrl, uiUrl } = cfg;
+	const { headless, mode, backendPort, frontendPort, apiUrl, uiUrl } = cfg;
 	fs.writeFileSync(
 		configPath(dir),
-		JSON.stringify({ headless, backendPort, frontendPort, apiUrl, uiUrl }, null, 2) + '\n',
+		JSON.stringify({ headless, mode, backendPort, frontendPort, apiUrl, uiUrl }, null, 2) + '\n',
 		'utf8'
 	);
 }

package/backend/mcp/server.js

@@ -32,6 +32,7 @@ const testSuiteService = require('../services/testSuiteService');
 const testCaseService = require('../services/testCaseService');
 const triggerService = require('../services/triggerService');
 const reportService = require('../services/reportService');
+const exportService = require('../services/exportService');
 
 // ---------------------------------------------------------------------------
 // Polling helper for test runs
@@ -41,8 +42,8 @@ async function pollJob(jobId, { maxMs = 600_000, intervalMs = 5_000 } = {}) {
 	const deadline = Date.now() + maxMs;
 	while (Date.now() < deadline) {
 		await new Promise((r) => setTimeout(r, intervalMs));
-		const job = triggerService.getJob(jobId);
-		if (job.status !== JOB_STATUS.RUNNING) return job;
+		const job = await triggerService.getJob(jobId);
+		if (job && job.status !== JOB_STATUS.RUNNING) return job;
 	}
 	return { status: 'timeout', jobId };
 }
@@ -379,7 +380,7 @@ function createMcpServer({ userId }) {
 			jobId: z.string().uuid().describe('Job ID returned by run_tests')
 		},
 		async ({ jobId }) => {
-			const job = triggerService.getJob(jobId);
+			const job = await triggerService.getJob(jobId);
 			if (!job) throw new Error('Job not found');
 			return { content: [{ type: 'text', text: JSON.stringify(job, null, 2) }] };
 		}
@@ -506,6 +507,49 @@ function createMcpServer({ userId }) {
 		}
 	);
 
+	// -- Exports --------------------------------------------------------------
+
+	server.tool(
+		'export_test_cases',
+		'Export test cases as CSV (one row per step) or JSON. Scope: the whole repository, one suite, or one test run (a run also carries each case’s recorded result). The JSON form can be re-imported.',
+		{
+			format: z.enum(['csv', 'json']).describe('csv or json'),
+			scope: z.enum(['all', 'suite', 'run']).optional().describe('Default: all'),
+			id: z
+				.string()
+				.optional()
+				.describe('Suite or run id — required when scope is "suite" or "run"')
+		},
+		async ({ format, scope = 'all', id }) => {
+			if ((scope === 'suite' || scope === 'run') && !id) {
+				throw new Error(`scope "${scope}" needs an id`);
+			}
+			const data = await exportService.buildTestCaseExport(scope, {
+				suiteId: id,
+				runId: id
+			});
+			if (!data) throw new Error('Nothing found for that scope/id');
+			const text =
+				format === 'csv' ? exportService.testCaseCsv(data) : JSON.stringify(data, null, 2);
+			return { content: [{ type: 'text', text }] };
+		}
+	);
+
+	server.tool(
+		'export_report',
+		'Export a Plum test report as CSV (one row per step) or a minimal JSON summary suitable for sharing.',
+		{
+			reportId: z.number().int().describe('Numeric report ID'),
+			format: z.enum(['csv', 'json']).describe('csv or json')
+		},
+		async ({ reportId, format }) => {
+			const data = await exportService.buildReportExport(reportId);
+			if (!data) throw new Error('Report not found');
+			const text = format === 'csv' ? exportService.reportCsv(data) : JSON.stringify(data, null, 2);
+			return { content: [{ type: 'text', text }] };
+		}
+	);
+
 	return server;
 }
 

package/backend/middleware/runnerOrAdmin.js

@@ -10,7 +10,7 @@ const { AUTH_SCHEME } = require('../lib/authHeader');
 
 /**
  * Accepts either a logged-in admin (web Settings UI) or any currently-registered
- * runner's own token (manage-runners.mjs and node self-registration have no
+ * runner's own token (manage-nodes.mjs and node self-registration have no
  * browser session/JWT to present, but every runner already has a token
  * generated at registration — reuse it instead of a second credential).
  */

package/backend/package.json

@@ -7,7 +7,7 @@
 		"create-step": "node config/scripts/create-step.mjs",
 		"create-env": "node services/envService.js",
 		"test": "node config/scripts/run-tests.js",
-		"manage-runners": "node scripts/manage-runners.mjs",
+		"manage-nodes": "node scripts/manage-nodes.mjs",
 		"create-test": "node config/scripts/create-test.mjs"
 	},
 	"keywords": [],

package/backend/prisma/migrations/20260829000000_add_run_queue/migration.sql

@@ -0,0 +1,29 @@
+-- CreateTable
+CREATE TABLE "RunQueue" (
+    "id" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "triggerType" TEXT NOT NULL DEFAULT 'manual-trigger',
+    "label" TEXT NOT NULL DEFAULT '',
+    "status" TEXT NOT NULL DEFAULT 'queued',
+    "tag" TEXT NOT NULL DEFAULT '',
+    "workers" INTEGER NOT NULL DEFAULT 1,
+    "browser" TEXT NOT NULL DEFAULT 'chromium',
+    "runnerIds" TEXT NOT NULL DEFAULT 'built-in',
+    "testRunId" TEXT,
+    "baseUrl" TEXT,
+    "runTitle" TEXT,
+    "startedBy" TEXT,
+    "notifyDiscord" BOOLEAN NOT NULL DEFAULT false,
+    "notifySlack" BOOLEAN NOT NULL DEFAULT false,
+    "reportId" INTEGER,
+    "exitCode" INTEGER,
+    "note" TEXT,
+    "queuedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "startedAt" TIMESTAMP(3),
+    "finishedAt" TIMESTAMP(3),
+
+    CONSTRAINT "RunQueue_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "RunQueue_status_queuedAt_idx" ON "RunQueue"("status", "queuedAt");

package/backend/prisma/schema.prisma

@@ -219,6 +219,36 @@ model TestRunEntry {
   @@index([caseId])
 }
 
+// One row per run request (manual, cron, external, mcp). A run stays `queued`
+// until every runner it targets is free, then flips to `running`, then `done`.
+// DB-backed so the queue survives a restart — stale `running` rows are
+// reconciled to `done` on boot and queued rows resume.
+model RunQueue {
+  id            String    @id
+  kind          String
+  triggerType   String    @default("manual-trigger")
+  label         String    @default("")
+  status        String    @default("queued")
+  tag           String    @default("")
+  workers       Int       @default(1)
+  browser       String    @default("chromium")
+  runnerIds     String    @default("built-in")
+  testRunId     String?
+  baseUrl       String?
+  runTitle      String?
+  startedBy     String?
+  notifyDiscord Boolean   @default(false)
+  notifySlack   Boolean   @default(false)
+  reportId      Int?
+  exitCode      Int?
+  note          String?
+  queuedAt      DateTime  @default(now())
+  startedAt     DateTime?
+  finishedAt    DateTime?
+
+  @@index([status, queuedAt])
+}
+
 model TestCaseHistory {
   id           String   @id @default(cuid())
   caseId       String

package/backend/routes/active-runs.routes.js

@@ -5,14 +5,18 @@
 
 const express = require('express');
 const router = express.Router();
-const activeRunsService = require('../services/activeRunsService');
+const runQueueService = require('../services/runQueueService');
 const { jwtAuth } = require('../middleware/jwtAuth');
 
-// Runs carry a real user's display name (`startedBy`) — gate this the same way as
-// other identity-bearing routes (test-suites, test-runs, users), not left open like
-// the purely operational GET routes (reports, tests) that never touch user identity.
-router.get('/', jwtAuth, (req, res) => {
-	res.json({ runs: activeRunsService.listActiveRuns() });
+// Queued + running rows carry a real user's display name (`startedBy`) — gate
+// this the same way as other identity-bearing routes, not left open like the
+// purely operational GET routes.
+router.get('/', jwtAuth, async (req, res, next) => {
+	try {
+		res.json({ runs: await runQueueService.listActive() });
+	} catch (e) {
+		next(e);
+	}
 });
 
 module.exports = router;

package/backend/routes/node.routes.js

@@ -49,6 +49,13 @@ router.post('/execute', authGuard, (req, res) => {
 	res.json({ jobId, status: 'started' });
 });
 
+// Stop a running job (primary server relays a user's cancel)
+router.post('/cancel/:jobId', authGuard, (req, res) => {
+	const ok = nodeExecutionService.cancelJob(req.params.jobId);
+	if (!ok) return res.status(404).json({ error: 'Job not found' });
+	res.json({ ok: true });
+});
+
 // Fetch the final report content after a job completes
 router.get('/report/:jobId', authGuard, (req, res) => {
 	const job = nodeExecutionService.getJob(req.params.jobId);

package/backend/routes/reports.routes.js

@@ -6,6 +6,25 @@
 const express = require('express');
 const router = express.Router();
 const reportService = require('../services/reportService');
+const exportService = require('../services/exportService');
+const { sendExport, exportFormat } = require('../lib/exportResponse');
+
+router.get('/:id/export', async (req, res, next) => {
+	const id = parseInt(req.params.id, 10);
+	if (isNaN(id)) return res.status(400).json({ error: 'Invalid report id' });
+	try {
+		const data = await exportService.buildReportExport(id);
+		if (!data) return res.status(404).json({ error: 'Report not found' });
+		await sendExport(res, {
+			format: exportFormat(req),
+			filenameBase: `report-${id}`,
+			json: () => data,
+			csv: () => exportService.reportCsv(data)
+		});
+	} catch (e) {
+		next(e);
+	}
+});
 
 router.get('/', async (req, res) => {
 	try {

package/backend/routes/runners.routes.js

@@ -10,7 +10,7 @@ const { jwtAuth } = require('../middleware/jwtAuth');
 const { requireAdmin } = require('../middleware/requireAdmin');
 const { runnerOrAdmin } = require('../middleware/runnerOrAdmin');
 
-// List/create are hit by headless CLI tools (manage-runners.mjs, node
+// List/create are hit by headless CLI tools (manage-nodes.mjs, node
 // self-registration) with no session to present — same as before the
 // runner-management routes were locked down. The response never includes
 // runner tokens (toPublicRunner strips them), so listing isn't a secret leak.

package/backend/routes/test-cases.routes.js

@@ -6,7 +6,19 @@
 const express = require('express');
 const router = express.Router();
 const { jwtAuth } = require('../middleware/jwtAuth');
+const { requireAdmin } = require('../middleware/requireAdmin');
 const testCaseService = require('../services/testCaseService');
+const testImportService = require('../services/testImportService');
+
+router.post('/import', jwtAuth, requireAdmin, async (req, res, next) => {
+	try {
+		const result = await testImportService.importTestCases(req.body, req.user.userId);
+		res.json(result);
+	} catch (e) {
+		if (e.status === 400) return res.status(400).json({ error: e.message });
+		next(e);
+	}
+});
 
 router.get('/:id', jwtAuth, async (req, res, next) => {
 	try {

package/backend/routes/test-runs.routes.js

@@ -7,6 +7,23 @@ const express = require('express');
 const router = express.Router();
 const { jwtAuth } = require('../middleware/jwtAuth');
 const testRunService = require('../services/testRunService');
+const exportService = require('../services/exportService');
+const { sendExport, exportFormat } = require('../lib/exportResponse');
+
+router.get('/:id/export', jwtAuth, async (req, res, next) => {
+	try {
+		const data = await exportService.buildTestCaseExport('run', { runId: req.params.id });
+		if (!data) return res.status(404).json({ error: 'Test run not found' });
+		await sendExport(res, {
+			format: exportFormat(req),
+			filenameBase: `run-${data.run?.title ?? req.params.id}`,
+			json: () => data,
+			csv: () => exportService.testCaseCsv(data)
+		});
+	} catch (e) {
+		next(e);
+	}
+});
 
 router.get('/', jwtAuth, async (req, res, next) => {
 	try {

package/backend/routes/test-suites.routes.js

@@ -7,6 +7,40 @@ const express = require('express');
 const router = express.Router();
 const { jwtAuth } = require('../middleware/jwtAuth');
 const testSuiteService = require('../services/testSuiteService');
+const exportService = require('../services/exportService');
+const { sendExport, exportFormat } = require('../lib/exportResponse');
+
+const testCaseRenderers = (data) => ({
+	json: () => data,
+	csv: () => exportService.testCaseCsv(data)
+});
+
+router.get('/export', jwtAuth, async (req, res, next) => {
+	try {
+		const data = await exportService.buildTestCaseExport('all');
+		await sendExport(res, {
+			format: exportFormat(req),
+			filenameBase: 'test-cases',
+			...testCaseRenderers(data)
+		});
+	} catch (e) {
+		next(e);
+	}
+});
+
+router.get('/:id/export', jwtAuth, async (req, res, next) => {
+	try {
+		const data = await exportService.buildTestCaseExport('suite', { suiteId: req.params.id });
+		if (!data) return res.status(404).json({ error: 'Suite not found' });
+		await sendExport(res, {
+			format: exportFormat(req),
+			filenameBase: `suite-${data.suites[0]?.displayId ?? req.params.id}`,
+			...testCaseRenderers(data)
+		});
+	} catch (e) {
+		next(e);
+	}
+});
 
 router.get('/', jwtAuth, async (req, res, next) => {
 	try {

package/backend/routes/trigger.routes.js

@@ -37,11 +37,14 @@ router.post('/', jwtAuth, async (req, res, next) => {
 	}
 });
 
-router.get('/:jobId', jwtAuth, (req, res) => {
-	const job = triggerService.getJob(req.params.jobId);
-	if (!job) return res.status(404).json({ error: 'Job not found' });
-	res.json(job);
+router.get('/:jobId', jwtAuth, async (req, res, next) => {
+	try {
+		const job = await triggerService.getJob(req.params.jobId);
+		if (!job) return res.status(404).json({ error: 'Job not found' });
+		res.json(job);
+	} catch (e) {
+		next(e);
+	}
 });
 
 module.exports = router;
-router.setSocketIO = triggerService.setSocketIO;