plum-e2e 1.3.0 → 1.3.1

package/README.md

@@ -50,7 +50,7 @@ my-tests/
 │   ├── pages/             — Page Object Models
 │   └── utils/             — Browser setup, hooks, shared helpers
 ├── .env                   — Base URL and browser settings
-├── .gitignore             — Pre-configured to exclude reports/
+├── .gitignore             — Pre-configured to exclude .env and reports/
 ├── plum.plugins.json      — Add extra npm packages for your tests
 └── tsconfig.json          — IDE type resolution (no local install needed)
 ```
@@ -247,17 +247,24 @@ Follow the prompts — Plum writes the boilerplate, you fill in the implementati
 
 ### Run Tests Locally
 
-Use `plum dev` to run tests directly on your machine without Docker:
+Use `plum run-test` to run tests directly on your machine without Docker:
 
 ```bash
-plum dev                         # run all tests
-plum dev @test-login-1           # run a single scenario
-plum dev @suite-login            # run an entire suite
-plum dev --parallel 4            # run all tests across 4 workers
-plum dev --parallel 4 @suite-login  # run a suite in parallel
+plum run-test                            # run all tests
+plum run-test @test-login-1              # run a single scenario
+plum run-test @suite-login               # run an entire suite
+plum run-test --parallel 4               # run all tests across 4 workers
+plum run-test --parallel 4 @suite-login  # run a suite in parallel
+plum run-test --browser firefox          # run in a specific browser
 ```
 
-> `plum dev` syncs your tests, installs dependencies, and runs Cucumber. No Docker needed.
+| Flag               | Description                                  |
+| ------------------ | -------------------------------------------- |
+| `@tag`             | Run only tests matching the tag              |
+| `--parallel <n>`   | Run across `n` parallel workers              |
+| `--browser <name>` | `chromium` (default), `firefox`, or `webkit` |
+
+> `plum run-test` syncs your tests, installs dependencies, and runs Cucumber. No Docker needed.
 
 ---
 
@@ -304,9 +311,10 @@ plum node stop
 | `plum init`                   | Initialize a new project in the current folder           |
 | `plum server start`           | Start the full UI stack via Docker (alias: `plum start`) |
 | `plum server stop`            | Stop the server and preserve data (alias: `plum stop`)   |
-| `plum dev`                    | Run all tests locally without Docker                     |
-| `plum dev @tag`               | Run tests matching a tag                                 |
-| `plum dev --parallel N`       | Run tests across N parallel workers                      |
+| `plum run-test`               | Run all tests locally without Docker                     |
+| `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 a specific browser (chromium/firefox/webkit)      |
 | `plum create-step`            | Interactively scaffold a new step definition             |
 | `plum node start --token <t>` | Start a runner node on this machine                      |
 | `plum node stop`              | Stop the runner node                                     |

package/backend/config/scripts/run-tests.js

@@ -25,6 +25,8 @@ const runners = parallel || process.env.REPORT_RUNNERS || '1';
 const tag = process.env.TAG || process.argv.slice(2).find((a) => a.startsWith('@'));
 const browser = process.env.BROWSER || 'chromium';
 
+let testExitCode = 0;
+
 try {
 	const testsRoot = (process.env.TESTS_ROOT || 'tests').replace(/\\/g, '/');
 
@@ -56,6 +58,8 @@ try {
 	const cucumberCommand = baseCommand.join(' ');
 	execSync(cucumberCommand, { stdio: 'inherit' });
 } catch (error) {
+	// Cucumber exits non-zero when scenarios fail — preserve it so callers see the real result.
+	testExitCode = error.status ?? 1;
 	console.error(pc.red('✗') + ' Tests failed: ' + error.message);
 } finally {
 	try {
@@ -67,3 +71,5 @@ try {
 		console.error(pc.red('✗') + ' Report generation failed: ' + error.message);
 	}
 }
+
+process.exit(testExitCode);

package/backend/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "plum-backend",
-	"version": "1.3.0",
+	"version": "1.3.1",
 	"main": "index.js",
 	"scripts": {
 		"init": "node services/envService.js",

package/bin/plum.js

@@ -100,7 +100,7 @@ function installPlugins() {
 // Ensure user's .gitignore contains Plum-generated entries
 function ensureGitignore() {
 	const gitignorePath = path.join(process.cwd(), '.gitignore');
-	const plumEntries = ['reports/'];
+	const plumEntries = ['.env', 'reports/'];
 	const plumBlock = `\n# Plum (auto-generated)\n${plumEntries.join('\n')}\n`;
 
 	if (!fs.existsSync(gitignorePath)) {
@@ -251,7 +251,7 @@ switch (command) {
 					"1. **Open `.env`** and set `BASE_URL` to your application's URL.",
 					'2. **Run the example tests** to confirm everything works:',
 					'   ```bash',
-					'   plum dev',
+					'   plum run-test',
 					'   ```',
 					'3. **Write your first test** — edit a file in `tests/features/` or generate a step:',
 					'   ```bash',
@@ -269,9 +269,10 @@ switch (command) {
 					'',
 					'| Command | Description |',
 					'| --- | --- |',
-					'| `plum dev` | Run all tests locally |',
-					'| `plum dev @tag` | Run tests matching a tag |',
-					'| `plum dev --parallel N` | Run tests across N parallel workers |',
+					'| `plum run-test` | Run all tests locally |',
+					'| `plum run-test @tag` | Run tests matching a tag |',
+					'| `plum run-test --parallel N` | Run tests across N parallel workers |',
+					'| `plum run-test --browser firefox` | Run in a specific browser (chromium/firefox/webkit) |',
 					'| `plum start` | Start the full UI via Docker |',
 					'| `plum stop` | Stop the server |',
 					'| `plum create-step` | Interactively generate a new step definition |',
@@ -311,8 +312,8 @@ switch (command) {
 					'```',
 					'',
 					'```bash',
-					'plum dev @test-login-1   # run a single scenario',
-					'plum dev @suite-login    # run the whole suite',
+					'plum run-test @test-login-1   # run a single scenario',
+					'plum run-test @suite-login    # run the whole suite',
 					'```',
 					'',
 					'---',
@@ -342,7 +343,7 @@ switch (command) {
 		});
 
 		console.log(
-			'🟣  Plum is now ready!\n\n Scaffold test cases are in `tests/`.\n Add extra npm packages to `plum.plugins.json`.\n\n - Run tests locally:\n   `plum dev` or `plum dev @tag`\n\n - Start the full UI (requires Docker):\n   `plum start`\n\n - Generate a step:\n   `plum create-step`'
+			'🟣  Plum is now ready!\n\n Scaffold test cases are in `tests/`.\n Add extra npm packages to `plum.plugins.json`.\n\n - Run tests locally:\n   `plum run-test` or `plum run-test @tag`\n\n - Start the full UI (requires Docker):\n   `plum start`\n\n - Generate a step:\n   `plum create-step`'
 		);
 		console.log('--------------------------------------\n');
 		break;
@@ -412,20 +413,30 @@ switch (command) {
 		console.log('--------------------------------------\n');
 		break;
 
-	case 'dev': {
+	case 'run-test': {
 		console.log('--------------------------------------\n');
-		console.log('🚀 Running Plum in Development Mode...');
+		console.log('🚀 Running tests locally...');
 
 		// Copy .env file from root to backend
 		copyEnvFile();
 
-		const devArgs = process.argv.slice(3);
-		const parallelIdx = devArgs.indexOf('--parallel');
-		const parallelArg = parallelIdx !== -1 ? devArgs[parallelIdx + 1] : null;
-		const tagArg = devArgs.find((a) => a.startsWith('@')) ?? null;
+		const runArgs = process.argv.slice(3);
+		const parallelIdx = runArgs.indexOf('--parallel');
+		const parallelArg = parallelIdx !== -1 ? runArgs[parallelIdx + 1] : null;
+		const browserIdx = runArgs.indexOf('--browser');
+		const browserArg = browserIdx !== -1 ? runArgs[browserIdx + 1] : null;
+		const tagArg = runArgs.find((a) => a.startsWith('@')) ?? null;
 		const userTestsPath = path.resolve(process.cwd(), 'tests');
 		const backendTestsPath = path.join(plumRoot, 'backend', 'tests');
 
+		const validBrowsers = ['chromium', 'firefox', 'webkit'];
+		if (browserArg && !validBrowsers.includes(browserArg)) {
+			console.error(
+				`✗ Invalid browser "${browserArg}". Choose one of: ${validBrowsers.join(', ')}`
+			);
+			process.exit(1);
+		}
+
 		// Copy user tests into backend
 		if (fs.existsSync(userTestsPath)) {
 			console.log('📦 Syncing your tests...\n');
@@ -458,6 +469,7 @@ switch (command) {
 		console.log('Running `npm run test` with:');
 		console.log('TAG =', tagArg ?? '');
 		console.log('PARALLEL =', parallelArg ?? 'off');
+		console.log('BROWSER =', browserArg ?? 'chromium');
 		console.log('TRIGGER =', 'command-line-trigger');
 
 		execSync('npm run test', {
@@ -467,7 +479,8 @@ switch (command) {
 				...process.env,
 				TAG: tagArg ?? '',
 				TRIGGER: 'command-line-trigger',
-				...(parallelArg ? { PARALLEL: parallelArg } : {})
+				...(parallelArg ? { PARALLEL: parallelArg } : {}),
+				...(browserArg ? { BROWSER: browserArg } : {})
 			}
 		});
 		console.log('--------------------------------------\n');
@@ -566,7 +579,10 @@ switch (command) {
 		console.log('    --token <secret>   Auth token the primary must send');
 		console.log('    --primary <url>    URL of the primary Plum server');
 		console.log('  node stop            Stop the runner node');
-		console.log('  dev                  Run tests locally without Docker');
+		console.log('  run-test             Run tests locally without Docker');
+		console.log('    @tag               Run only tests matching a tag');
+		console.log('    --parallel <n>     Run across n parallel workers');
+		console.log('    --browser <name>   chromium | firefox | webkit (default: chromium)');
 		console.log('  create-step          Interactively scaffold a new step definition');
 		console.log('\n--------------------------------------\n');
 }

package/frontend/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "plum-frontend",
 	"private": true,
-	"version": "1.3.0",
+	"version": "1.3.1",
 	"type": "module",
 	"scripts": {
 		"dev": "vite dev",

package/frontend/src/routes/reports/[id]/+page.svelte

@@ -56,6 +56,14 @@
 		return scenario.tags.find((tag) => /^@test[\w-]*/i.test(tag));
 	}
 
+	function featureSuiteTag(feature) {
+		for (const scenario of feature.scenarios) {
+			const suiteTag = scenario.tags.find((tag) => /suite/i.test(tag));
+			if (suiteTag) return suiteTag;
+		}
+		return null;
+	}
+
 	function visibleTags(scenario) {
 		const testTag = scenarioTestTag(scenario);
 		if (testTag) return [testTag];
@@ -349,6 +357,9 @@
 						<polyline points="14 2 14 8 20 8" />
 					</svg>
 					{feature.name}
+					{#if featureSuiteTag(feature)}
+						<span class="suite-tag">{featureSuiteTag(feature)}</span>
+					{/if}
 				</h2>
 				<div class="feature-right">
 					<span class="feature-file">{feature.uri}</span>
@@ -687,6 +698,16 @@
 		color: var(--text-muted);
 	}
 
+	.suite-tag {
+		font-size: 0.65rem;
+		font-family: 'JetBrains Mono', monospace;
+		background: var(--accent-soft);
+		color: var(--accent);
+		padding: 0.1rem 0.4rem;
+		border-radius: 100px;
+		font-weight: 500;
+	}
+
 	.scenarios {
 		display: flex;
 		flex-direction: column;

package/package.json

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