plum-e2e 2.6.1 → 2.6.3

package/README.md

@@ -69,6 +69,7 @@ Full documentation is available at:
 | [Initializing the Project](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/initializing-the-project-ilfc8LUyO7) | What `plum init` generates, config files explained            |
 | [Writing Tests](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/writing-tests-XeHJQdtH49)                       | Feature files, page objects, step definitions, best practices |
 | [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                 |
 | [Integrations](https://outline.silverlunah.com/s/12bf21d1-02ba-49e9-b0df-908976407afd/doc/integrations-qfiqfmdP0j)                         | Discord & Slack webhook notifications, CI/external triggers   |
@@ -94,6 +95,7 @@ Full documentation is available at:
 | `plum run-test @tag`          | Run tests matching a tag                                           |
 | `plum run-test --parallel N`  | Run tests across N parallel workers                                |
 | `plum run-test --browser <b>` | Run in `chromium` (default) or `firefox`                           |
+| `plum run-test --help`        | Show usage for `run-test`                                          |
 | `plum create-step`            | Interactively scaffold a new step definition                       |
 | `plum manage-runners`         | Open the interactive runner management menu                        |
 

package/backend/scripts/manage-runners.mjs

@@ -88,6 +88,17 @@ async function deleteRunner(id) {
 	}
 }
 
+/**
+ * Stops/restarts a runner over the network via the primary's control routes,
+ * which hit the runner's own /api/shutdown|restart endpoints — works for any
+ * reachable runner, not just ones whose process this manager owns by PID.
+ */
+async function controlRunner(id, action) {
+	const res = await fetch(`${API_URL}/runners/${id}/${action}`, { method: 'POST' });
+	const body = await res.json().catch(() => ({}));
+	if (!res.ok || body.ok === false) throw new Error(body.error || `HTTP ${res.status}`);
+}
+
 /**
  * Resolves the display + control state for every runner: reachability (ping),
  * whether we own a live process for it, and whether we can control it at all.
@@ -156,12 +167,8 @@ function prepareNodeEnv() {
 async function runAction(r) {
 	const options = [];
 
-	if (!r.local) {
-		clack.log.info(
-			pc.dim(`"${r.name}" runs on another machine — it can be pinged but not controlled here.`)
-		);
-		options.push({ value: 'ping', label: 'Ping' });
-	} else if (r.managed) {
+	if (r.managed) {
+		// Local, and this manager owns its process — control it directly by PID.
 		options.push(
 			{ value: 'stop', label: pc.red('Stop') },
 			{ value: 'restart', label: pc.yellow('Restart') },
@@ -169,14 +176,18 @@ async function runAction(r) {
 			{ value: 'ping', label: 'Ping' }
 		);
 	} else if (r.online) {
-		clack.log.info(
-			pc.dim(
-				`"${r.name}" is up but was not started by this manager — stop it from its own terminal.`
-			)
+		// Remote, or local but started outside this manager (no PID to own) —
+		// either way the runner's own /api/shutdown|restart endpoints are
+		// reachable over the network via the primary's control routes.
+		options.push(
+			{ value: 'stop', label: pc.red('Stop') },
+			{ value: 'restart', label: pc.yellow('Restart') },
+			{ value: 'ping', label: 'Ping' }
 		);
-		options.push({ value: 'ping', label: 'Ping' });
-	} else {
+	} else if (r.local) {
 		options.push({ value: 'start', label: pc.green('Start') }, { value: 'ping', label: 'Ping' });
+	} else {
+		options.push({ value: 'ping', label: 'Ping' });
 	}
 
 	options.push(
@@ -194,15 +205,39 @@ async function runAction(r) {
 		const entry = startNode({ id: r.id, port, token: r.token });
 		clack.log.success(pc.green(`Started "${r.name}" on port ${port} (pid ${entry.pid})`));
 	} else if (action === 'stop') {
-		const ok = stopNode(r.id);
-		clack.log.success(ok ? pc.green(`Stopped "${r.name}"`) : pc.dim(`"${r.name}" was not running`));
+		if (r.managed) {
+			const ok = stopNode(r.id);
+			clack.log.success(
+				ok ? pc.green(`Stopped "${r.name}"`) : pc.dim(`"${r.name}" was not running`)
+			);
+		} else {
+			const s = clack.spinner();
+			s.start(`Stopping "${r.name}"...`);
+			try {
+				await controlRunner(r.id, 'stop');
+				s.stop(pc.green(`Stopped "${r.name}"`));
+			} catch (e) {
+				s.stop(pc.red(`Could not stop "${r.name}": ${e.message}`));
+			}
+		}
 	} else if (action === 'restart') {
-		const s = clack.spinner();
-		s.start(`Restarting "${r.name}"...`);
-		stopNode(r.id);
-		await new Promise((resolve) => setTimeout(resolve, 600));
-		const entry = startNode({ id: r.id, port, token: r.token });
-		s.stop(pc.green(`Restarted "${r.name}" (pid ${entry.pid})`));
+		if (r.managed) {
+			const s = clack.spinner();
+			s.start(`Restarting "${r.name}"...`);
+			stopNode(r.id);
+			await new Promise((resolve) => setTimeout(resolve, 600));
+			const entry = startNode({ id: r.id, port, token: r.token });
+			s.stop(pc.green(`Restarted "${r.name}" (pid ${entry.pid})`));
+		} else {
+			const s = clack.spinner();
+			s.start(`Restarting "${r.name}"...`);
+			try {
+				await controlRunner(r.id, 'restart');
+				s.stop(pc.green(`Restarted "${r.name}"`));
+			} catch (e) {
+				s.stop(pc.red(`Could not restart "${r.name}": ${e.message}`));
+			}
+		}
 	} else if (action === 'log') {
 		const entry = runnerProcess.loadRegistry()[r.id];
 		clack.note(entry?.logFile ?? '(no log file)', 'Log file');

package/bin/plum.js

@@ -1096,6 +1096,23 @@ switch (command) {
 		break;
 
 	case 'run-test': {
+		const runHelpArgs = process.argv.slice(3);
+		if (anyFlags(runHelpArgs, ['--help', '-h'])) {
+			console.log(
+				[
+					'',
+					`${pc.bold('Usage:')} plum run-test [tag] [options]`,
+					'',
+					`  ${pc.cyan('plum run-test')}                    run all tests`,
+					`  ${pc.cyan('plum run-test @tag')}               run tests matching a tag`,
+					`  ${pc.cyan('plum run-test --parallel N')}       run tests across N parallel workers`,
+					`  ${pc.cyan('plum run-test --browser firefox')}  run in a specific browser (chromium/firefox)`,
+					''
+				].join('\n')
+			);
+			break;
+		}
+
 		console.log('--------------------------------------\n');
 		console.log('🚀 Running tests locally...');
 

package/frontend/src/routes/test-repository/runs/[id]/+page.svelte

@@ -30,6 +30,7 @@
 	import { runsVersion } from '$lib/stores/runner';
 	import { auth } from '$lib/stores/auth';
 	import Button from '$lib/components/ui/Button.svelte';
+	import Modal from '$lib/components/ui/Modal.svelte';
 	import Toast from '$lib/components/ui/Toast.svelte';
 	import EmptyState from '$lib/components/ui/EmptyState.svelte';
 	import AutomatedBadge from '$lib/components/ui/AutomatedBadge.svelte';
@@ -106,6 +107,10 @@
 	let entryNote = '';
 	let expandedExecEntries = new Set();
 
+	let editRunOpen = false;
+	let editRunForm = {};
+	let editRunSaving = false;
+
 	function toggleExecSteps(entryId) {
 		if (expandedExecEntries.has(entryId)) expandedExecEntries.delete(entryId);
 		else expandedExecEntries.add(entryId);
@@ -203,6 +208,20 @@
 		run = { ...run, entries: run.entries.filter((e) => e.id !== entryId) };
 	}
 
+	async function handleUpdateRun() {
+		editRunSaving = true;
+		try {
+			const updated = await updateRun(runId, editRunForm);
+			run = { ...run, ...updated };
+			editRunOpen = false;
+			showToast('success', 'Run updated.');
+		} catch (e) {
+			showToast('error', e.message);
+		} finally {
+			editRunSaving = false;
+		}
+	}
+
 	async function handleSaveRun() {
 		saving = true;
 		try {
@@ -309,6 +328,21 @@
 
 <Toast {toast} />
 
+<Modal bind:open={editRunOpen} title="Edit Run">
+	<div class="form-fields">
+		<div class="field">
+			<label class="field-label" for="er-title">Title</label>
+			<input id="er-title" type="text" class="field-input" bind:value={editRunForm.title} />
+		</div>
+		<div class="modal-actions">
+			<Button on:click={handleUpdateRun} disabled={editRunSaving}>
+				{editRunSaving ? 'Saving…' : 'Save'}
+			</Button>
+			<Button variant="ghost" on:click={() => (editRunOpen = false)}>Cancel</Button>
+		</div>
+	</div>
+</Modal>
+
 <div class="breadcrumb">
 	<a href="/test-repository" class="bc-link">Test Repository</a>
 	<span class="bc-sep">›</span>
@@ -322,6 +356,28 @@
 		<div class="run-header-left">
 			<h1 class="run-title">{run.title}</h1>
 			<span class="run-status-badge {run.status}">{run.status}</span>
+			<button
+				class="icon-btn"
+				title="Edit run"
+				on:click={() => {
+					editRunForm = { title: run.title };
+					editRunOpen = true;
+				}}
+			>
+				<svg
+					width="14"
+					height="14"
+					viewBox="0 0 24 24"
+					fill="none"
+					stroke="currentColor"
+					stroke-width="2"
+					stroke-linecap="round"
+					stroke-linejoin="round"
+					><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7" /><path
+						d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"
+					/></svg
+				>
+			</button>
 		</div>
 		<div class="run-header-actions">
 			{#if isLocked}
@@ -1427,4 +1483,15 @@
 			display: none;
 		}
 	}
+
+	.form-fields {
+		display: flex;
+		flex-direction: column;
+		gap: 0.875rem;
+	}
+	.modal-actions {
+		display: flex;
+		gap: 0.5rem;
+		padding-top: 0.25rem;
+	}
 </style>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "plum-e2e",
-	"version": "2.6.1",
+	"version": "2.6.3",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/silverlunah/plum.git"