plum-e2e 2.10.0 → 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/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

@@ -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
@@ -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/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/scripts/{manage-runners.mjs → manage-nodes.mjs}

@@ -4,13 +4,13 @@
  */
 
 /**
- * Interactive manager for local node runners.
+ * Interactive manager for Plum nodes.
  *
- * Registers new runners with the Plum primary and starts / stops / restarts the
- * node processes that back local runners, all from one menu.
+ * Registers new nodes with the Plum primary and starts / stops / restarts the
+ * node processes, all from one menu.
  *
- * Usage:  node scripts/manage-runners.mjs
- *    or:  npm run manage-runners     (from the backend directory)
+ * Usage:  node scripts/manage-nodes.mjs
+ *    or:  npm run manage-nodes     (from the backend directory)
  *
  * Env:    PLUM_API_URL   primary server API base (default http://localhost:3001)
  */
@@ -24,7 +24,7 @@ import runnerProcess from '../lib/runnerProcess.js';
 import nodeRegister from '../lib/nodeRegister.js';
 
 const { isLocalUrl, parsePort, pruneDead, statusOf, findPidOnPort } = runnerProcess;
-const { generateToken, detectLanIp, loadNodeByName } = nodeRegister;
+const { generateToken, loadNodeByName } = nodeRegister;
 
 const API_URL = process.env.PLUM_API_URL || 'http://localhost:3001';
 
@@ -55,21 +55,6 @@ function authHeaders() {
 	return RUNNER_TOKEN ? { Authorization: `Bearer ${RUNNER_TOKEN}` } : {};
 }
 
-/**
- * When the primary runs in Docker it cannot reach `localhost` on the host —
- * only substitute when the user explicitly enters localhost/127.0.0.1.
- */
-function resolveNodeUrl(url) {
-	try {
-		const u = new URL(url);
-		if (u.hostname === 'localhost' || u.hostname === '127.0.0.1') {
-			u.hostname = 'host.docker.internal';
-		}
-		return u.toString().replace(/\/+$/, '');
-	} catch {}
-	return url.replace(/\/+$/, '');
-}
-
 async function fetchRunners() {
 	const res = await fetch(`${API_URL}/runners`, { headers: authHeaders() });
 	if (!res.ok) throw new Error(`HTTP ${res.status}`);
@@ -250,29 +235,53 @@ async function runAction(r) {
 	}
 }
 
-async function addRunner() {
+async function addNode() {
 	const suggested = `node-${generateToken().slice(0, 6)}`;
 
+	const mode = await clack.select({
+		message: 'Is this node for a production / network setup, or this local machine?',
+		options: [
+			{ value: 'production', label: 'Production / Network' },
+			{ value: 'local', label: 'Local machine' }
+		],
+		initialValue: 'local'
+	});
+	if (cancelled(mode)) return;
+
 	const name = await clack.text({
-		message: 'Runner name',
+		message: 'Node name or alias — call it whatever you like',
 		placeholder: suggested,
 		defaultValue: suggested
 	});
 	if (cancelled(name)) return;
 
-	let port;
-	for (;;) {
-		port = await clack.text({
-			message: 'Local port this node listens on',
-			placeholder: '3002',
-			defaultValue: '3002'
+	let primary;
+	if (mode === 'production') {
+		primary = await clack.text({
+			message:
+				'Plum server backend URL or IP address, including the port (with http:// or https://)',
+			placeholder: 'https://plum.example.com'
 		});
-		if (cancelled(port)) return;
-		const pid = findPidOnPort(Number(port));
-		if (!pid) break;
-		clack.log.warn(pc.yellow(`Port ${port} is already in use (pid ${pid}) — choose another.`));
+		if (cancelled(primary)) return;
+		primary = String(primary).trim();
+	} else {
+		const bp = await clack.text({
+			message: 'Port your Plum backend runs on (default 3001 — run `docker compose ps` if unsure)',
+			placeholder: '3001',
+			defaultValue: '3001'
+		});
+		if (cancelled(bp)) return;
+		primary = `http://localhost:${(bp || '3001').trim()}`;
 	}
 
+	const port = await clack.text({
+		message:
+			'Port this node will listen on — any process already using it will be stopped on start',
+		placeholder: '3002',
+		defaultValue: '3002'
+	});
+	if (cancelled(port)) return;
+
 	const defToken = process.env.NODE_TOKEN || generateToken();
 	const token = await clack.text({
 		message: 'Auth token',
@@ -281,15 +290,19 @@ async function addRunner() {
 	});
 	if (cancelled(token)) return;
 
-	const defaultUrl = `http://${detectLanIp()}:${port}`;
-	const urlInput = await clack.text({
-		message: 'URL the Plum server uses to reach this node',
-		placeholder: defaultUrl,
-		defaultValue: defaultUrl
-	});
-	if (cancelled(urlInput)) return;
-
-	const url = resolveNodeUrl(urlInput || defaultUrl);
+	let url;
+	if (mode === 'production') {
+		url = await clack.text({
+			message: 'URL your Plum server uses to reach this node (e.g. https://node-1.example.com)',
+			placeholder: `https://${name}.example.com`
+		});
+		if (cancelled(url)) return;
+		url = String(url).trim().replace(/\/+$/, '');
+	} else {
+		// Local primary runs in Docker — it reaches a host node via
+		// host.docker.internal, not localhost.
+		url = `http://host.docker.internal:${port}`;
+	}
 
 	// Exactly `plum node start` — register, start on this machine, verify,
 	// persist. One code path for both entry points.
@@ -297,8 +310,10 @@ async function addRunner() {
 		plumNode(
 			'start',
 			name,
+			'--mode',
+			mode,
 			'--primary',
-			API_URL,
+			primary,
 			'--url',
 			url,
 			'--port',
@@ -314,22 +329,22 @@ async function addRunner() {
 }
 
 async function main() {
-	clack.intro(pc.bgMagenta(pc.white('  🟣 Plum — Manage Runners  ')));
+	clack.intro(pc.bgMagenta(pc.white('  🟣 Plum — Manage Nodes  ')));
 
 	if (!RUNNER_TOKEN) {
 		clack.log.warn(
-			'No runner token available — stop / restart / delete will be rejected.\n' +
-				'Run `plum manage-runners` on the primary host, or from a folder where you started a node.'
+			'No node token available — stop / restart / delete will be rejected.\n' +
+				'Run `plum manage-nodes` on the primary host, or from a folder where you started a node.'
 		);
 	}
 
 	for (;;) {
 		const s = clack.spinner();
-		s.start(`Loading runners from ${API_URL}...`);
+		s.start(`Loading nodes from ${API_URL}...`);
 		let runners;
 		try {
 			runners = await describeRunners();
-			s.stop(`Runners at ${API_URL}`);
+			s.stop(`Nodes at ${API_URL}`);
 		} catch (e) {
 			s.stop(pc.red(`Could not reach Plum server at ${API_URL}`));
 			clack.log.error(e.message);
@@ -337,17 +352,17 @@ async function main() {
 			process.exit(1);
 		}
 
-		if (runners.length === 0) clack.log.info(pc.dim('No runners registered yet.'));
+		if (runners.length === 0) clack.log.info(pc.dim('No nodes registered yet.'));
 
 		const choice = await clack.select({
-			message: runners.length ? 'Select a runner' : 'No runners yet',
+			message: runners.length ? 'Select a node' : 'No nodes yet',
 			options: [
 				...runners.map((r) => ({
 					value: r.id,
 					label: r.name,
 					hint: statusBadge(r)
 				})),
-				{ value: '__add__', label: pc.green('+ Add new runner') },
+				{ value: '__add__', label: pc.green('+ Add new node') },
 				{ value: '__refresh__', label: pc.cyan('↻ Refresh') },
 				{ value: '__quit__', label: pc.dim('Quit') }
 			]
@@ -356,7 +371,7 @@ async function main() {
 		if (cancelled(choice) || choice === '__quit__') break;
 		if (choice === '__refresh__') continue;
 		if (choice === '__add__') {
-			await addRunner();
+			await addNode();
 			continue;
 		}