@muggleai/works 4.8.0 → 4.8.2

package/README.md

@@ -55,7 +55,9 @@ This installs:
 npm install -g @muggleai/works
 ```
 
-Then configure your MCP client:
+For Cursor, that's it — the install automatically configures `~/.cursor/mcp.json` and syncs `muggle-*` skills to `~/.cursor/skills/`. Just restart Cursor.
+
+For other MCP clients, add this to your client's config:
 
 ```json
 {
@@ -71,7 +73,7 @@ Then configure your MCP client:
 }
 ```
 
-`npm install` also syncs `muggle-*` skills to `~/.cursor/skills/` for Cursor discovery. Claude slash commands are plugin-managed, so update those with `/plugin update muggleai@muggle-works`.
+Claude slash commands are plugin-managed, so update those with `/plugin update muggleai@muggle-works`.
 
 ### 2. Verify
 
@@ -519,7 +521,7 @@ muggle-ai-works/
 │   ├── verify-plugin-marketplace.mjs  # Validates plugin/marketplace consistency
 │   ├── verify-compatibility-contracts.mjs # Validates long-term surface contracts
 │   ├── verify-upgrade-experience.mjs  # Validates in-place upgrade behavior
-│   └── postinstall.mjs      #   npm postinstall (Electron app download)
+│   └── postinstall.mjs      #   npm postinstall (Electron app download, Cursor MCP config, skills sync)
 │
 ├── config/compatibility/     # Contract baselines (CLI/MCP/plugin/skills)
 ├── bin/                     # CLI entrypoint (muggle.js → dist/cli.js)

package/dist/{chunk-OUI734ME.js → chunk-44I5ROCB.js}

@@ -2211,6 +2211,9 @@ async function executeElectronAppAsync(params) {
   if (params.showUi) {
     spawnArgs.push("--show-ui");
   }
+  if (params.freshSession) {
+    spawnArgs.push("--fresh-session");
+  }
   logger4.info("Spawning electron-app for local execution", {
     runId: params.runId,
     mode,
@@ -2359,7 +2362,8 @@ async function executeTestGeneration(params) {
         scriptFilePath: inputFilePath,
         authFilePath,
         timeoutMs,
-        showUi: params.showUi
+        showUi: params.showUi,
+        freshSession: params.freshSession
       });
       const completedAt = Date.now();
       const executionTimeMs = completedAt - startedAt;
@@ -2505,7 +2509,8 @@ async function executeReplay(params) {
         scriptFilePath: inputFilePath,
         authFilePath,
         timeoutMs,
-        showUi: params.showUi
+        showUi: params.showUi,
+        freshSession: params.freshSession
       });
       const completedAt = Date.now();
       const executionTimeMs = completedAt - startedAt;
@@ -3239,6 +3244,12 @@ var WorkflowStartTestScriptGenerationInputSchema = z.object({
   expectedResult: z.string().min(1).describe("Expected result"),
   workflowParams: WorkflowParamsSchema
 });
+var WorkflowStartTestScriptGenerationBulkInputSchema = z.object({
+  projectId: IdSchema.describe("Project ID (UUID)"),
+  name: z.string().min(1).describe("Workflow name"),
+  testCaseIds: z.array(IdSchema).optional().describe("Optional: targeted test case UUIDs to generate scripts for; when absent generates for all eligible test cases in the project"),
+  workflowParams: WorkflowParamsSchema
+});
 var WorkflowGetLatestScriptGenByTestCaseInputSchema = z.object({
   testCaseId: IdSchema.describe("Test case ID (UUID)")
 });
@@ -4208,6 +4219,25 @@ var workflowTools = [
       };
     }
   },
+  {
+    name: "muggle-remote-workflow-start-test-script-generation-bulk",
+    description: "Start a bulk test script generation workflow to generate scripts for multiple test cases in a single request.",
+    inputSchema: WorkflowStartTestScriptGenerationBulkInputSchema,
+    mapToUpstream: (input) => {
+      const data = input;
+      return {
+        method: "POST",
+        path: `${MUGGLE_TEST_PREFIX}/workflow/test-script/test-script-generation/bulk`,
+        body: {
+          projectId: data.projectId,
+          name: data.name,
+          ...data.testCaseIds && { testCaseIds: data.testCaseIds },
+          ...data.workflowParams && { workflowParams: data.workflowParams }
+        },
+        timeoutMs: getWorkflowTimeoutMs()
+      };
+    }
+  },
   {
     name: "muggle-remote-wf-get-ts-gen-latest-run",
     description: "Get the latest run status for a test script generation workflow runtime.",
@@ -5146,14 +5176,6 @@ __export(local_exports, {
   executeTool: () => executeTool,
   getTool: () => getTool
 });
-var AuthLoginInputSchema2 = z.object({
-  waitForCompletion: z.boolean().optional().describe("Whether to wait for browser login completion before returning. Default: true"),
-  timeoutMs: z.number().int().positive().min(1e3).max(9e5).optional().describe("Maximum time to wait for login completion in milliseconds. Default: 120000")
-});
-var AuthPollInputSchema2 = z.object({
-  deviceCode: z.string().optional().describe("Device code from the login response. Optional if a login was recently started.")
-});
-var EmptyInputSchema2 = z.object({});
 var TestCaseDetailsSchema = z.object({
   /** Cloud test case ID. */
   id: MuggleEntityIdSchema.describe("Cloud test case ID (UUID)"),
@@ -5200,7 +5222,9 @@ var ExecuteTestGenerationInputSchema = z.object({
   /** Optional timeout. */
   timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds (default: 300000 = 5 min)"),
   /** Show the electron-app UI during execution. Default: visible window. Pass false to run headless. */
-  showUi: z.boolean().optional().describe("Show the electron-app UI during generation. Defaults to visible; pass false to run headless.")
+  showUi: z.boolean().optional().describe("Show the electron-app UI during generation. Defaults to visible; pass false to run headless."),
+  /** Clear all session storage (cookies, localStorage, etc.) before execution. Use for test cases that require a clean browser state, such as registration, login, or cookie consent flows. */
+  freshSession: z.boolean().optional().describe("Clear all session storage (cookies, localStorage, etc.) before execution. Use for test cases that require a clean browser state \u2014 e.g. registration, login, or cookie consent flows. Default: false.")
 });
 var ExecuteReplayInputSchema = z.object({
   /** Test script metadata from muggle-remote-test-script-get. */
@@ -5212,7 +5236,9 @@ var ExecuteReplayInputSchema = z.object({
   /** Optional timeout. */
   timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds (default: 180000 = 3 min)"),
   /** Show the electron-app UI during execution. Default: visible window. Pass false to run headless. */
-  showUi: z.boolean().optional().describe("Show the electron-app UI during replay. Defaults to visible; pass false to run headless.")
+  showUi: z.boolean().optional().describe("Show the electron-app UI during replay. Defaults to visible; pass false to run headless."),
+  /** Clear all session storage (cookies, localStorage, etc.) before execution. Use for test cases that require a clean browser state, such as registration, login, or cookie consent flows. */
+  freshSession: z.boolean().optional().describe("Clear all session storage (cookies, localStorage, etc.) before execution. Use for test cases that require a clean browser state \u2014 e.g. registration, login, or cookie consent flows. Default: false.")
 });
 var CancelExecutionInputSchema = z.object({
   runId: MuggleEntityIdSchema.describe("Run ID (UUID) to cancel")
@@ -5240,6 +5266,7 @@ var ListSessionsInputSchema = z.object({
 var CleanupSessionsInputSchema = z.object({
   max_age_days: z.number().int().min(0).optional().describe("Maximum age of sessions to keep (in days). Sessions older than this will be deleted. Defaults to 30.")
 });
+var EmptyInputSchema2 = z.object({});
 
 // packages/mcps/src/mcp/tools/local/tool-registry.ts
 function createChildLogger2(correlationId) {
@@ -5464,7 +5491,8 @@ var executeTestGenerationTool = {
         testCase: input.testCase,
         localUrl: input.localUrl,
         timeoutMs: input.timeoutMs,
-        showUi
+        showUi,
+        freshSession: input.freshSession
       });
       const content = [
         "## Test Generation " + (result.status === "passed" ? "Successful" : "Failed"),
@@ -5503,7 +5531,8 @@ var executeReplayTool = {
         actionScript: input.actionScript,
         localUrl: input.localUrl,
         timeoutMs: input.timeoutMs,
-        showUi
+        showUi,
+        freshSession: input.freshSession
       });
       const content = [
         "## Test Replay " + (result.status === "passed" ? "Successful" : "Failed"),
@@ -5799,6 +5828,7 @@ __export(e2e_exports2, {
   WorkflowMemoryParamsSchema: () => WorkflowMemoryParamsSchema,
   WorkflowParamsSchema: () => WorkflowParamsSchema,
   WorkflowStartTestCaseDetectionInputSchema: () => WorkflowStartTestCaseDetectionInputSchema,
+  WorkflowStartTestScriptGenerationBulkInputSchema: () => WorkflowStartTestScriptGenerationBulkInputSchema,
   WorkflowStartTestScriptGenerationInputSchema: () => WorkflowStartTestScriptGenerationInputSchema,
   WorkflowStartTestScriptReplayBulkInputSchema: () => WorkflowStartTestScriptReplayBulkInputSchema,
   WorkflowStartTestScriptReplayInputSchema: () => WorkflowStartTestScriptReplayInputSchema,
@@ -5824,8 +5854,6 @@ function getQaTools() {
 // packages/mcps/src/mcp/local/index.ts
 var local_exports2 = {};
 __export(local_exports2, {
-  AuthLoginInputSchema: () => AuthLoginInputSchema2,
-  AuthPollInputSchema: () => AuthPollInputSchema2,
   AuthService: () => AuthService,
   CancelExecutionInputSchema: () => CancelExecutionInputSchema,
   CleanupSessionsInputSchema: () => CleanupSessionsInputSchema,

package/dist/{chunk-2ZDLQAO4.js → chunk-OMLNCNSZ.js}

@@ -1,4 +1,4 @@
-import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, verifyFileChecksum, calculateFileChecksum, getQaTools, getLocalQaTools, performLogout, performLogin, toolRequiresAuth, getCallerCredentials, getDataDir, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require } from './chunk-OUI734ME.js';
+import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, verifyFileChecksum, calculateFileChecksum, getQaTools, getLocalQaTools, performLogout, performLogin, toolRequiresAuth, getCallerCredentials, getDataDir, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require } from './chunk-44I5ROCB.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -6,12 +6,12 @@ import { z, ZodError } from 'zod';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import * as fs from 'fs';
 import { readFileSync, existsSync, rmSync, mkdirSync, readdirSync, createWriteStream, writeFileSync, statSync } from 'fs';
-import * as path from 'path';
+import * as path4 from 'path';
 import { dirname, resolve, join } from 'path';
 import { fileURLToPath } from 'url';
 import { Command } from 'commander';
 import axios from 'axios';
-import { platform, arch, homedir } from 'os';
+import { platform, homedir, arch } from 'os';
 import { execFile } from 'child_process';
 import { pipeline } from 'stream/promises';
 
@@ -486,7 +486,7 @@ function renderResultSummary(test, projectId) {
     lines.push(`**Error:** \`${safeInlineCode(test.error)}\``);
   }
   lines.push(`**Steps:** ${test.steps.length}`);
-  lines.push(`[View on Muggle AI dashboard \u2192](${dashboardUrl})`);
+  lines.push(`[View steps on Muggle AI \u2192](${dashboardUrl})`);
   return lines;
 }
 function renderBody(report, opts) {
@@ -686,7 +686,7 @@ async function resolveGsScreenshotUrls(report, opts) {
     if (gsUrls.length === 0) {
       return report;
     }
-    const mcps = await import('./src-2IDMKEJ5.js');
+    const mcps = await import('./src-ZRUONWKV.js');
     const credentials = await mcps.getCallerCredentialsAsync();
     if (!credentials.bearerToken && !credentials.apiKey) {
       stderrWrite(
@@ -807,13 +807,13 @@ var CURSOR_SKILLS_SUBDIR = "skills";
 var MUGGLE_SKILL_PREFIX = "muggle";
 var INSTALL_MANIFEST_FILE = "install-manifest.json";
 function getElectronAppBaseDir() {
-  return path.join(getDataDir(), ELECTRON_APP_DIR);
+  return path4.join(getDataDir(), ELECTRON_APP_DIR);
 }
 function getCursorSkillsDir() {
-  return path.join(homedir(), CURSOR_SKILLS_DIR, CURSOR_SKILLS_SUBDIR);
+  return path4.join(homedir(), CURSOR_SKILLS_DIR, CURSOR_SKILLS_SUBDIR);
 }
 function getInstallManifestPath() {
-  return path.join(getDataDir(), INSTALL_MANIFEST_FILE);
+  return path4.join(getDataDir(), INSTALL_MANIFEST_FILE);
 }
 function readInstallManifest() {
   const manifestPath = getInstallManifestPath();
@@ -851,7 +851,7 @@ function listObsoleteSkills() {
       if (manifestSkills.has(entry.name)) {
         continue;
       }
-      const skillPath = path.join(skillsDir, entry.name);
+      const skillPath = path4.join(skillsDir, entry.name);
       const sizeBytes = getDirectorySize(skillPath);
       obsoleteSkills.push({
         name: entry.name,
@@ -897,7 +897,7 @@ function getDirectorySize(dirPath) {
   try {
     const entries = readdirSync(dirPath, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path.join(dirPath, entry.name);
+      const fullPath = path4.join(dirPath, entry.name);
       if (entry.isDirectory()) {
         totalSize += getDirectorySize(fullPath);
       } else if (entry.isFile()) {
@@ -950,7 +950,7 @@ function listInstalledVersions() {
       if (!/^\d+\.\d+\.\d+$/.test(entry.name)) {
         continue;
       }
-      const versionPath = path.join(baseDir, entry.name);
+      const versionPath = path4.join(baseDir, entry.name);
       const sizeBytes = getDirectorySize(versionPath);
       versions.push({
         version: entry.name,
@@ -1106,11 +1106,11 @@ function getExpectedExecutablePath(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path.join(versionDir, "MuggleAI.exe");
+      return path4.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path.join(versionDir, "MuggleAI");
+      return path4.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -1119,7 +1119,7 @@ function verifyElectronAppInstallation() {
   const version = getElectronAppVersion();
   const versionDir = getElectronAppDir(version);
   const executablePath = getExpectedExecutablePath(versionDir);
-  const metadataPath = path.join(versionDir, ".install-metadata.json");
+  const metadataPath = path4.join(versionDir, ".install-metadata.json");
   const result = {
     valid: false,
     versionDir,
@@ -1326,7 +1326,7 @@ function runDiagnostics() {
     name: "Cursor MCP Config",
     passed: cursorMcpConfigValidationResult.passed,
     description: cursorMcpConfigValidationResult.description,
-    suggestion: "Re-run npm install -g @muggleai/works to refresh ~/.cursor/mcp.json"
+    suggestion: "Run 'muggle setup' to configure ~/.cursor/mcp.json"
   });
   return results;
 }
@@ -1640,11 +1640,11 @@ function getExpectedExecutablePath2(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path.join(versionDir, "MuggleAI.exe");
+      return path4.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path.join(versionDir, "MuggleAI");
+      return path4.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -1740,10 +1740,43 @@ function cleanupFailedInstall(versionDir) {
     }
   }
 }
+function upsertCursorMcpConfig() {
+  const cursorMcpConfigPath = path4.join(homedir(), ".cursor", "mcp.json");
+  const cursorDir = path4.join(homedir(), ".cursor");
+  let config = {};
+  if (existsSync(cursorMcpConfigPath)) {
+    try {
+      const raw = readFileSync(cursorMcpConfigPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        console.log("Warning: ~/.cursor/mcp.json has unexpected shape, skipping MCP config upsert.");
+        return;
+      }
+      config = parsed;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.log("Warning: ~/.cursor/mcp.json is invalid JSON, skipping MCP config upsert.");
+      console.log(`  Parse error: ${message}`);
+      return;
+    }
+  }
+  if (!config.mcpServers || typeof config.mcpServers !== "object") {
+    config.mcpServers = {};
+  }
+  config.mcpServers.muggle = {
+    command: "muggle",
+    args: ["serve"]
+  };
+  mkdirSync(cursorDir, { recursive: true });
+  writeFileSync(cursorMcpConfigPath, `${JSON.stringify(config, null, 2)}
+`, "utf-8");
+  console.log(`Cursor MCP config updated at ${cursorMcpConfigPath}`);
+}
 async function setupCommand(options) {
   const version = getElectronAppVersion();
   const versionDir = getElectronAppDir(version);
   const platformKey = getPlatformKey();
+  upsertCursorMcpConfig();
   if (!options.force && isElectronAppInstalled()) {
     console.log(`Electron app v${version} is already installed at ${versionDir}`);
     console.log("Use --force to re-download.");
@@ -1761,7 +1794,7 @@ async function setupCommand(options) {
       rmSync(versionDir, { recursive: true, force: true });
     }
     mkdirSync(versionDir, { recursive: true });
-    const tempFile = path.join(versionDir, binaryName);
+    const tempFile = path4.join(versionDir, binaryName);
     await downloadWithRetry(downloadUrl, tempFile);
     console.log("Download complete, verifying checksum...");
     const checksums = getElectronAppChecksums();
@@ -1797,7 +1830,7 @@ The archive may be corrupted or in an unexpected format.`
       );
     }
     const executableChecksum = await calculateFileChecksum(executablePath);
-    const metadataPath = path.join(versionDir, INSTALL_METADATA_FILE_NAME);
+    const metadataPath = path4.join(versionDir, INSTALL_METADATA_FILE_NAME);
     writeInstallMetadata({
       metadataPath,
       version,
@@ -1839,7 +1872,7 @@ function extractVersionFromTag(tag) {
   return match ? match[1] : null;
 }
 function getVersionOverridePath() {
-  return path.join(getDataDir(), VERSION_OVERRIDE_FILE);
+  return path4.join(getDataDir(), VERSION_OVERRIDE_FILE);
 }
 function getEffectiveElectronAppVersion() {
   const overridePath = getVersionOverridePath();
@@ -1927,11 +1960,11 @@ function getExpectedExecutablePath3(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path.join(versionDir, "MuggleAI.exe");
+      return path4.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path.join(versionDir, "MuggleAI");
+      return path4.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -2043,7 +2076,7 @@ async function downloadAndInstall(version, downloadUrl, checksum) {
   if (!response.ok) {
     throw new Error(`Download failed: ${response.status} ${response.statusText}`);
   }
-  const tempFile = path.join(versionDir, binaryName);
+  const tempFile = path4.join(versionDir, binaryName);
   const fileStream = createWriteStream(tempFile);
   if (!response.body) {
     throw new Error("No response body");
@@ -2085,7 +2118,7 @@ The archive may be corrupted or in an unexpected format.`
     );
   }
   const executableChecksum = await calculateFileChecksum(executablePath);
-  const metadataPath = path.join(versionDir, INSTALL_METADATA_FILE_NAME2);
+  const metadataPath = path4.join(versionDir, INSTALL_METADATA_FILE_NAME2);
   writeInstallMetadata2({
     metadataPath,
     version,

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { runCli } from './chunk-2ZDLQAO4.js';
-import './chunk-OUI734ME.js';
+import { runCli } from './chunk-OMLNCNSZ.js';
+import './chunk-44I5ROCB.js';
 
 // src/cli/main.ts
 runCli().catch((error) => {

package/dist/index.js

@@ -1,2 +1,2 @@
-export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-2ZDLQAO4.js';
-export { createChildLogger, e2e_exports as e2e, getConfig, getLocalQaTools, getLogger, getQaTools, local_exports as localQa, mcp_exports as mcp, e2e_exports as qa, src_exports as shared } from './chunk-OUI734ME.js';
+export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-OMLNCNSZ.js';
+export { createChildLogger, e2e_exports as e2e, getConfig, getLocalQaTools, getLogger, getQaTools, local_exports as localQa, mcp_exports as mcp, e2e_exports as qa, src_exports as shared } from './chunk-44I5ROCB.js';

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Run real-browser end-to-end (E2E) acceptance tests on your web app from any AI coding agent. Generate test scripts from plain English, replay them on localhost, capture screenshots, and validate user flows like signup, checkout, and dashboards. Works across Claude Code, Cursor, Codex, and Windsurf.",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Ship quality products with AI-powered end-to-end (E2E) acceptance testing that validates your web app like a real user — from Claude Code and Cursor to PR.",
-  "version": "4.8.0",
+  "version": "4.8.2",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/README.md

@@ -15,7 +15,7 @@ For npm installs:
 npm install -g @muggleai/works
 ```
 
-This updates the CLI and syncs `muggle-*` skills into `~/.cursor/skills/` for Cursor. Claude slash commands remain plugin-managed, so use `/plugin update muggleai@muggle-works` to refresh them.
+This updates the CLI, configures Cursor MCP (`~/.cursor/mcp.json`), and syncs `muggle-*` skills into `~/.cursor/skills/`. Claude slash commands remain plugin-managed, so use `/plugin update muggleai@muggle-works` to refresh them.
 
 ## Skills
 

package/dist/plugin/skills/do/e2e-acceptance.md

@@ -1,7 +1,15 @@
-# E2E / acceptance agent
+# E2E / acceptance agent (Stage 6/7)
 
 You are running **end-to-end (E2E) acceptance** test cases against code changes using Muggle AI's local testing infrastructure. These tests simulate real users in a browser — they are not unit tests.
 
+## Turn preamble
+
+Start the turn with:
+
+```
+**Stage 6/7 — E2E acceptance** — running browser tests against the validation target from pre-flight.
+```
+
 ## Design
 
 E2E acceptance testing runs **locally** using the `test-feature-local` approach:
@@ -15,32 +23,35 @@ This guarantees E2E acceptance tests always run — no dependency on cloud repla
 
 ## Input
 
-You receive:
-- The Muggle project ID
+You receive everything from `state.md` already — pre-flight resolved it:
+
+- `localUrl` — the locally running dev server URL
+- `projectId` — the chosen Muggle project
+- The validation strategy (`local-e2e`, `staging-replay`, `unit-only`, `skip`)
+- Test-user credential status (existing / new / skip)
 - The list of changed repos, files, and a summary of changes
 - The requirements goal
-- `localUrl` per repo (from `muggle-repos.json`) — the locally running dev server URL
 
 ## Your Job
 
-### Step 0: Resolve Local URL
+### Step 0: Consume pre-flight (no user questions)
+
+Read `state.md`. If the validation strategy is `unit-only` or `skip`, **do not run this stage** — skip to stage 7 and record the skip reason. Otherwise use `localUrl` directly; **do not ask the user** for it.
+
+If `localUrl` or `projectId` is missing from `state.md`, that is a pre-flight bug. **Do not paper over it by asking the user** — escalate once with the session path and halt. The fix is to expand `pre-flight.md`, not to grow a new question here.
 
-Read `localUrl` for each repo from the context. If it is not provided, ask the user:
-> "E2E acceptance testing requires a running local server. What URL is the `<repo>` app running on? (e.g. `http://localhost:3000`)"
+### Step 0.5: Pre-flight verification probes
 
-**Do not skip E2E acceptance tests.** Wait for the user to provide the URL before proceeding.
+Before launching Electron, run these live checks and fail loudly if any fails:
 
-### Step 1: Check Authentication
+1. `curl -s -o /dev/null -w "%{http_code}" <localUrl>` — expect 2xx or 3xx. If the dev server isn't up, halt with the exact command the user needs to start it.
+2. If a backend URL is recorded, probe its health endpoint. A 5xx or unreachable backend means the dashboard will render in an error state and test results will be meaningless — halt.
+3. `muggle-remote-auth-status` — must be `authenticated`. If not, the pre-flight missed this; escalate.
+4. If test credentials were marked `existing`, confirm the Auth0 tenant in the repo's env matches the tenant the secrets were created under (recorded in `state.md`). Tenant mismatch → halt with "existing secrets target tenant X, local dev targets tenant Y — update pre-flight to collect new credentials."
 
-- `muggle-remote-auth-status`
-- If **authenticated**: print the logged-in email and ask via `AskQuestion`:
-  > "You're logged in as **{email}**. Continue with this account?"
-  - Option 1: "Yes, continue"
-  - Option 2: "No, switch account"
-  If the user picks "switch account", call `muggle-remote-auth-login` with `forceNewSession: true` then `muggle-remote-auth-poll`.
-- If **not signed in or expired**: `muggle-remote-auth-login` then `muggle-remote-auth-poll`
+### Step 1: Authentication already verified
 
-Do not skip or assume auth.
+Pre-flight handled auth. If `muggle-remote-auth-status` somehow shows expired here (session clock skew, etc.), re-auth silently via `muggle-remote-auth-login` + `muggle-remote-auth-poll` — but do not ask the user "continue with this account?" again.
 
 ### Step 2: Get Test Cases
 

package/dist/plugin/skills/do/impact-analysis.md

@@ -1,7 +1,15 @@
-# Impact Analysis Agent
+# Impact Analysis Agent (Stage 3/7)
 
 You are analyzing git repositories to determine which ones have actual code changes that need to go through the dev cycle pipeline.
 
+## Turn preamble
+
+Start the turn with:
+
+```
+**Stage 3/7 — Impact analysis** — diffing each affected repo against its default branch.
+```
+
 ## Input
 
 You receive:

package/dist/plugin/skills/do/open-prs.md

@@ -1,7 +1,29 @@
-# PR Creation Agent
+# PR Creation Agent (Stage 7/7)
 
 You are creating pull requests for each repository that has changes after a successful dev cycle run.
 
+## Turn preamble
+
+Start the turn with:
+
+```
+**Stage 7/7 — Open PR** — rendering the visual walkthrough and pushing the PR.
+```
+
+## Non-negotiable: visual walkthrough is required
+
+**You MUST invoke `muggle-pr-visual-walkthrough` (Mode B) to render the E2E section of the PR body.** Hand-writing the PR body with a text summary and `gh pr create` is a stage failure — reviewers rely on the dashboard links and per-step screenshots the walkthrough produces.
+
+If the E2E stage was skipped (validation was `unit-only` or `skip`), you may omit the walkthrough section — but mark the PR title with `[UNVERIFIED]` or `[UNIT-ONLY]` accordingly, and record the reason in the PR body under `## Validation`.
+
+Before calling `gh pr create`, self-check:
+
+- [ ] `muggle-pr-visual-walkthrough` was invoked (or the skip reason is recorded).
+- [ ] The `body` returned by the skill is embedded verbatim in the PR body.
+- [ ] If `comment` is non-null, it will be posted as a follow-up after the PR is created.
+
+If you cannot check all three, **halt** — do not create the PR. Fix the upstream stage first.
+
 ## Input
 
 You receive: