plum-e2e 2.9.13 → 2.9.17

package/CLAUDE.md

@@ -137,7 +137,7 @@ Never write comments that:
 - Describe the current task or fix ("added for the live page", "handles issue #123")
 - Are multi-line docblocks explaining parameters
 
-The GPL license header at the top of every file is a legal requirement — do not remove it.
+The MIT license header at the top of every file is a legal requirement — do not remove it. `npm run add-license` (config: `license-config.json`) applies and verifies it and runs in the pre-commit hook. Match the existing style for the file type: `/* … */` for JS/TS/CSS, `<!-- … -->` for Svelte, `# …` for shell/YAML/Dockerfiles/dotfiles, `// …` for `schema.prisma` (Prisma's formatter rewrites `/* */`, so it's kept out of `add-license` and headered by hand). JSON files carry no header.
 
 ---
 

package/README.md

@@ -79,25 +79,28 @@ Full documentation is available at:
 
 ## Command Reference
 
-| Command                       | Description                                                                                                       |
-| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `plum init`                   | Initialize a new project in the current folder                                                                    |
-| `plum server start`           | Start the full UI stack via Docker                                                                                |
-| `plum server restart`         | Rebuild Docker images and restart the server without prompts                                                      |
-| `plum server stop`            | Stop the server (data preserved)                                                                                  |
-| `plum server reconfig`        | Re-enter server settings without starting                                                                         |
-| `plum update`                 | Update Plum, then restart each registered server/node on this machine (asks before each, in an interactive shell) |
-| `plum node start`             | Set up connectivity, start a runner node, and open the runner menu                                                |
-| `plum node restart`           | Stop, refresh dependencies, and restart the runner node                                                           |
-| `plum node stop`              | Stop the runner node started from this folder                                                                     |
-| `plum node reconfig`          | Re-enter node settings and re-register                                                                            |
-| `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 `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                                                                       |
+| Command                       | Description                                                                                   |
+| ----------------------------- | --------------------------------------------------------------------------------------------- |
+| `plum init`                   | Initialize a new project in the current folder                                                |
+| `plum server start`           | Start the full UI stack via Docker                                                            |
+| `plum server restart`         | Rebuild Docker images and restart the server without prompts                                  |
+| `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 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                                                                                   |
+| `plum node delete <name>`     | Stop the node, delete its local config, and unregister it from the server                     |
+| `plum node reconfig [name]`   | Re-enter a node's settings and re-register, without starting it                               |
+| `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 `chromium` (default) or `firefox`                                                      |
+| `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                                                   |
 
 ---
 
@@ -126,7 +129,7 @@ npm run dev          # available at http://localhost:5173
 ```bash
 cd backend
 npm test                     # run all tests
-npm test -- @test-1          # run a specific scenario
+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

package/backend/_scaffold/utils/browser.ts

@@ -1,18 +1,6 @@
 /*
  * This file is part of Plum.
- *
- * Plum is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * Plum is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with Plum. If not, see https://www.gnu.org/licenses/.
+ * Licensed under the MIT License. See LICENSE file in the project root for details.
  */
 
 // Wires up Plum's session recording — removing or reordering code here can silently break report replay.

package/backend/_scaffold/utils/hooks.ts

@@ -1,18 +1,6 @@
 /*
  * This file is part of Plum.
- *
- * Plum is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * Plum is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with Plum. If not, see https://www.gnu.org/licenses/.
+ * Licensed under the MIT License. See LICENSE file in the project root for details.
  */
 
 // Wires up Plum's session recording — removing or reordering code here can silently break report replay.

package/backend/prisma/schema.prisma

@@ -1,16 +1,6 @@
-/**
- * This file is part of Plum.
- * Plum is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- * Plum is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- * You should have received a copy of the GNU General Public License
- * along with Plum. If not, see https://www.gnu.org/licenses/.
- */
+// This file is part of Plum.
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
 generator client {
   provider = "prisma-client-js"
 }

package/frontend/src/lib/components/reports/LiveReplayer.svelte

@@ -15,6 +15,7 @@
 
 	const META_EVENT_TYPE = 4;
 
+	let viewport;
 	let stage;
 	let container;
 	let player = null;
@@ -23,14 +24,18 @@
 	let nativeHeight = 0;
 	let resizeObserver;
 
-	// rrweb-player renders at the recording's native resolution — scale-and-crop
-	// it to fill the stage (object-fit: cover); letterboxing left visible bars
-	// when the aspect ratios didn't match. Re-run on every stage resize, since
-	// the panel's own layout can still shift its size after the player is built.
+	// rrweb-player renders at the recording's native resolution. Scale it to the
+	// full panel width and anchor it to the top: the browser frame is shown at
+	// true proportions (never zoomed or cropped), and any leftover space is a
+	// single region below the page — not the symmetric top+bottom letterbox
+	// bars a contain-fit leaves. Re-run on every resize.
 	function updateScale() {
-		if (!nativeWidth || !nativeHeight) return;
-		const rect = stage.getBoundingClientRect();
-		const scale = Math.max(rect.width / nativeWidth, rect.height / nativeHeight);
+		if (!nativeWidth || !nativeHeight || !viewport) return;
+		const vp = viewport.getBoundingClientRect();
+		const scale = vp.width / nativeWidth || 0;
+		stage.style.width = `${vp.width}px`;
+		stage.style.height = `${nativeHeight * scale}px`;
+		container.style.transformOrigin = 'top left';
 		container.style.transform = `scale(${scale})`;
 	}
 
@@ -38,8 +43,8 @@
 	// construction) reads events[0].timestamp unconditionally, so the initial
 	// batch must be passed in props rather than fed empty and via addEvent.
 	function buildPlayer() {
-		const rect = stage.getBoundingClientRect();
-		const meta = events[0]?.type === META_EVENT_TYPE ? events[0].data : null;
+		const rect = viewport.getBoundingClientRect();
+		const meta = events.find((e) => e?.type === META_EVENT_TYPE)?.data ?? null;
 		nativeWidth = meta?.width > 0 ? meta.width : rect.width;
 		nativeHeight = meta?.height > 0 ? meta.height : rect.height;
 
@@ -68,8 +73,9 @@
 
 	onMount(() => {
 		buildPlayer();
+		// Observe the viewport, not the stage — the stage's size is what we set.
 		resizeObserver = new ResizeObserver(updateScale);
-		resizeObserver.observe(stage);
+		resizeObserver.observe(viewport);
 	});
 	onDestroy(() => {
 		resizeObserver?.disconnect();
@@ -81,25 +87,41 @@
 	});
 </script>
 
-<div class="live-stage" bind:this={stage}>
-	<div class="live-mount" bind:this={container}></div>
+<div class="live-viewport" bind:this={viewport}>
+	<div class="live-stage" bind:this={stage}>
+		<div class="live-mount" bind:this={container}></div>
+	</div>
 </div>
 
 <style>
-	.live-stage {
-		position: relative;
+	/* Fills the panel; the stage is sized in JS to the panel width at the
+	   recording's true aspect ratio, pinned to the top. */
+	.live-viewport {
 		flex: 1;
+		width: 100%;
+		height: 100%;
 		min-width: 0;
 		min-height: 0;
 		display: flex;
-		align-items: center;
+		align-items: flex-start;
 		justify-content: center;
-		background: var(--bg-subtle);
+		overflow: hidden;
+	}
+
+	.live-stage {
+		position: relative;
 		overflow: hidden;
 	}
 
 	.live-mount {
-		display: flex;
+		position: absolute;
+		top: 0;
+		left: 0;
+	}
+
+	.live-mount :global(.rr-player) {
+		border-radius: 0 !important;
+		box-shadow: none !important;
 	}
 
 	/* Sandboxed iframe (no allow-scripts/forms/top-navigation) — safe to always

package/package.json

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