@muggleai/works 5.28.0-staging.251 → 5.28.0-staging.253

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "muggleai",
       "source": "./plugin",
       "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-      "version": "5.28.0-staging.251"
+      "version": "5.28.0-staging.253"
     }
   ]
 }

package/dist/{chunk-XEFALLR5.js → chunk-N3G4AX6M.js}

@@ -1,4 +1,4 @@
-import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir2, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, resolveElectronAppExecutablePath, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, getActiveElectronAppReleaseStream, buildToolInputJsonSchema, toolRequiresAuth, getCallerCredentials, parseElectronAppDirName, getElectronAppReleaseTagPrefix, hasShownDisclosure, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, ElectronAppReleaseStream, buildElectronAppChecksumsUrl, __require, getDisclosureCopy, buildOnboardingPlan, applyOnboardingAnswers, needsOnboarding, buildLlmSourcePlan, describeLlmSourceStatus, resolveLlmSourceStatus, readRunView, RunViewError, renderRunViewText, writeRunViewHtml, openBrowserUrl, evaluateCheckoutFreshness, runGitCommand, BLOCKING_FRESHNESS_VERDICTS, claimServiceStack, BUSY_EXIT_CODE, checkServiceStack, releaseServiceStack, readServiceStackStatus, resolvePreferences, OnboardingBlanketChoice, PreferenceKey, LlmSource, applyLlmSourceSelection, describeStackMismatch, getDataDir, DEFAULT_LOCAL_LLM_BASE_URL, isValidLocalBaseUrl, local_exports } from './chunk-JRYEMMKU.js';
+import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir2, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, resolveElectronAppExecutablePath, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, getActiveElectronAppReleaseStream, buildToolInputJsonSchema, toolRequiresAuth, getCallerCredentials, parseElectronAppDirName, getElectronAppReleaseTagPrefix, hasShownDisclosure, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, ElectronAppReleaseStream, buildElectronAppChecksumsUrl, __require, getDisclosureCopy, buildOnboardingPlan, applyOnboardingAnswers, needsOnboarding, buildLlmSourcePlan, describeLlmSourceStatus, resolveLlmSourceStatus, readRunView, RunViewError, renderRunViewText, writeRunViewHtml, openBrowserUrl, evaluateCheckoutFreshness, runGitCommand, BLOCKING_FRESHNESS_VERDICTS, claimServiceStack, BUSY_EXIT_CODE, checkServiceStack, releaseServiceStack, readServiceStackStatus, resolvePreferences, OnboardingBlanketChoice, PreferenceKey, LlmSource, applyLlmSourceSelection, describeStackMismatch, getDataDir, DEFAULT_LOCAL_LLM_BASE_URL, isValidLocalBaseUrl, local_exports } from './chunk-YMFQHBLJ.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -1151,7 +1151,7 @@ async function resolveGsScreenshotUrls(report, opts) {
     if (gsUrls.length === 0) {
       return report;
     }
-    const mcps = await import('./src-7OY7RXTE.js');
+    const mcps = await import('./src-OWUW2BBD.js');
     const credentials = await mcps.getCallerCredentialsAsync();
     if (!credentials.bearerToken && !credentials.apiKey) {
       stderrWrite(

package/dist/{chunk-JRYEMMKU.js → chunk-YMFQHBLJ.js}

@@ -7664,7 +7664,7 @@ var projectTools = [
   },
   {
     name: "muggle-remote-project-list",
-    description: "List projects accessible to the authenticated user. Returns up to 10 items per page by default (max 100). Response includes pagination metadata (totalCount, totalPages, hasMore) \u2014 check `hasMore` to decide whether to fetch additional pages.",
+    description: "List projects accessible to the authenticated user: the projects they own plus the projects shared with them. Returns up to 10 items per page by default (max 100). Response includes pagination metadata (totalCount, totalPages, hasMore) \u2014 check `hasMore` to decide whether to fetch additional pages.",
     inputSchema: ProjectListInputSchema,
     dashboardLink: linkToProjects,
     mapToUpstream: (input) => {
@@ -7673,6 +7673,7 @@ var projectTools = [
         method: "GET",
         path: `${MUGGLE_TEST_PREFIX}/projects`,
         queryParams: {
+          includeShared: true,
           page: toolInput.page,
           pageSize: toolInput.pageSize,
           sortBy: toolInput.sortBy,

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { runCli } from './chunk-XEFALLR5.js';
-import './chunk-JRYEMMKU.js';
+import { runCli } from './chunk-N3G4AX6M.js';
+import './chunk-YMFQHBLJ.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-XEFALLR5.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-JRYEMMKU.js';
+export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-N3G4AX6M.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-YMFQHBLJ.js';

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

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.codex-mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.28.0-staging.251",
+        "@muggleai/works@5.28.0-staging.253",
         "serve"
       ],
       "env": {

package/dist/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
   "author": {
     "name": "Muggle AI",

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

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/dist/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.28.0-staging.251",
+        "@muggleai/works@5.28.0-staging.253",
         "serve"
       ]
     }

package/dist/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "release": "5.26.0",
-  "buildId": "run-251-1",
-  "commitSha": "1e6cfe30749385ff8e553c34e1f43494668d3cb2",
-  "buildTime": "2026-10-30T04:38:24Z",
+  "buildId": "run-253-1",
+  "commitSha": "827f3558e259bf1905d25d297bdb875478a1a9e0",
+  "buildTime": "2026-10-30T07:03:59Z",
   "serviceName": "muggle-ai-works-mcp"
 }

package/dist/{src-7OY7RXTE.js → src-OWUW2BBD.js}

@@ -1 +1 @@
-export { ACTION_SCRIPT_FILE_NAME, BASE_REMOTE_NAME, BLOCKING_FRESHNESS_VERDICTS, BRANCH_CREATION_REFLOG_PREFIX, BUSY_EXIT_CODE, CLAUDE_CODE_AUTH_STATUS_ARGS, CLAUDE_CODE_CHECK_TIMEOUT_MS, CLAUDE_CODE_EXECUTABLE, CLAUDE_CODE_EXECUTABLE_NOT_FOUND_CODE, CLAUDE_CODE_SESSION_LINK_ENV_VARS, CLAUDE_CODE_VERSION_ARGS, CheckoutFreshnessVerdict, ClaudeCodeReadiness, DEFAULT_LOCAL_LLM_BASE_URL, DEFAULT_PREFERENCES, ELECTRON_APP_EXECUTABLE_PATH_SEGMENTS, ElectronAppPlatform, ElectronAppReleaseStream, HTML_VIEW_OFFER_LINE, LLM_CREDENTIALS_FILE_MODE, LLM_CREDENTIALS_FILE_NAME, LLM_SOURCE_HEADER, LLM_SOURCE_OPTIONS, LLM_SOURCE_OWNED_ENV_NAMES, LLM_SOURCE_PROMPT, LLM_SOURCE_SCOPE_NOTE, LlmSource, MASKED_API_KEY_PREFIX, MASKED_API_KEY_VISIBLE_CHARS, MAX_LISTED_INHERITED_COMMITS, ONBOARDING_BLANKET_OPTIONS, ONBOARDING_CHOICE_GROUPS, ONBOARDING_MAX_OFFERS, ONBOARDING_PRIMER_BULLETS, ONBOARDING_PRIMER_HEADLINE, ONBOARDING_TOGGLE_GROUPS, ONBOARDING_TOGGLE_PROMPT, ONBOARDING_UNSELECTED_TOGGLE_VALUE, OnboardingBlanketChoice, OnboardingGroupKind, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ProjectPreferencesReconcileOutcome, RUN_SESSIONS_DIR_NAME, RUN_VIEW_DASHBOARD_LINK_LABEL, RunViewError, RuntimeTarget, SCREENSHOT_DIR_RELATIVE_PATH, SCREENSHOT_FILE_EXTENSION, StackCheckVerdict, StackClaimVerdict, StackLeaseEndReason, StackMismatchKind, StackPortAction, WATCHER_LIFETIME_SECONDS, WATCHER_LIFETIME_UNBOUNDED_SECONDS, applyLlmSourceSelection, applyOnboardingAnswers, assertDeviceCodeClientProvisioned, buildElectronAppChecksumsUrl, buildElectronAppDirName, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, buildLlmSourcePlan, buildOnboardingPlan, buildToolInputJsonSchema, calculateFileChecksum, checkServiceStack, claimServiceStack, compareQueuePlaces, completeOnboarding, createApiKeyWithToken, createChildLogger, decideStackClaim, decideStackReap, decideStackRelease, decideStackRunEnd, decideStackRunStart, deleteApiKeyData, deleteCredentials, describeLlmSourceStatus, describeStackMismatch, e2e_exports as e2e, evaluateCheckoutFreshness, findVacatedNeeds, finishStackRun, formatPreferencesOneLiner, getActiveElectronAppReleaseStream, getActiveRuntimeTarget, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDashboardBaseUrl, getDataDir2 as getDataDir, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppReleaseTagPrefix, getElectronAppSignedFromVersion, getElectronAppVersion, getElectronAppVersionSource, getLlmSourceOption, getLocalQaTools, getLogger, getOnboardingToggleKeys, getPlatformKey, getQaTools, getReleaseSignerIdentityUri, getRunSessionsDir, getValidApiKeyData, getValidCredentials, hasApiKey, isElectronAppInstalled, isElectronAppPlatform, isFirstRun, isValidLocalBaseUrl, loadApiKeyData, loadCredentials, local_exports as localQa, lookUpCheckoutPullRequest, markOnboardingCompleted, maskLlmApiKey, mcp_exports as mcp, needsConflict, needsOnboarding, openBrowserUrl, parseElectronAppDirName, performLogin, performLogout, pollDeviceCode, portOfUrl, e2e_exports as qa, readPreferencesMetadata, readRunView, readServiceStackStatus, reapServiceStack, reconcileProjectPreferences, recordOnboardingSkip, releaseServiceStack, renderRunViewHtml, renderRunViewText, resetConfig, resetLogger, resetPreference, resolveActiveProfile, resolveActiveReleaseStream, resolveActiveReleaseTagPrefix, resolveBlanketPreferences, resolveElectronAppExecutablePath, resolveElectronAppPathOrNull, resolveLlmSourceStatus, resolveOnboardingAnswers, resolvePreferences, resolveRunSessionPath, resolveRuntimeTarget, resolveTogglePreferences, runGitCommand, saveApiKey, saveApiKeyData, saveCredentials, startDeviceCodeFlow, startStackRun, stopVacatedServices, toDisplayRef, toolRequiresAuth, validatePreference, verifyFileChecksum, writeLlmEnvBlock, writePreferences, writePreferencesWithMetadata, writeRunViewHtml } from './chunk-JRYEMMKU.js';
+export { ACTION_SCRIPT_FILE_NAME, BASE_REMOTE_NAME, BLOCKING_FRESHNESS_VERDICTS, BRANCH_CREATION_REFLOG_PREFIX, BUSY_EXIT_CODE, CLAUDE_CODE_AUTH_STATUS_ARGS, CLAUDE_CODE_CHECK_TIMEOUT_MS, CLAUDE_CODE_EXECUTABLE, CLAUDE_CODE_EXECUTABLE_NOT_FOUND_CODE, CLAUDE_CODE_SESSION_LINK_ENV_VARS, CLAUDE_CODE_VERSION_ARGS, CheckoutFreshnessVerdict, ClaudeCodeReadiness, DEFAULT_LOCAL_LLM_BASE_URL, DEFAULT_PREFERENCES, ELECTRON_APP_EXECUTABLE_PATH_SEGMENTS, ElectronAppPlatform, ElectronAppReleaseStream, HTML_VIEW_OFFER_LINE, LLM_CREDENTIALS_FILE_MODE, LLM_CREDENTIALS_FILE_NAME, LLM_SOURCE_HEADER, LLM_SOURCE_OPTIONS, LLM_SOURCE_OWNED_ENV_NAMES, LLM_SOURCE_PROMPT, LLM_SOURCE_SCOPE_NOTE, LlmSource, MASKED_API_KEY_PREFIX, MASKED_API_KEY_VISIBLE_CHARS, MAX_LISTED_INHERITED_COMMITS, ONBOARDING_BLANKET_OPTIONS, ONBOARDING_CHOICE_GROUPS, ONBOARDING_MAX_OFFERS, ONBOARDING_PRIMER_BULLETS, ONBOARDING_PRIMER_HEADLINE, ONBOARDING_TOGGLE_GROUPS, ONBOARDING_TOGGLE_PROMPT, ONBOARDING_UNSELECTED_TOGGLE_VALUE, OnboardingBlanketChoice, OnboardingGroupKind, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ProjectPreferencesReconcileOutcome, RUN_SESSIONS_DIR_NAME, RUN_VIEW_DASHBOARD_LINK_LABEL, RunViewError, RuntimeTarget, SCREENSHOT_DIR_RELATIVE_PATH, SCREENSHOT_FILE_EXTENSION, StackCheckVerdict, StackClaimVerdict, StackLeaseEndReason, StackMismatchKind, StackPortAction, WATCHER_LIFETIME_SECONDS, WATCHER_LIFETIME_UNBOUNDED_SECONDS, applyLlmSourceSelection, applyOnboardingAnswers, assertDeviceCodeClientProvisioned, buildElectronAppChecksumsUrl, buildElectronAppDirName, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, buildLlmSourcePlan, buildOnboardingPlan, buildToolInputJsonSchema, calculateFileChecksum, checkServiceStack, claimServiceStack, compareQueuePlaces, completeOnboarding, createApiKeyWithToken, createChildLogger, decideStackClaim, decideStackReap, decideStackRelease, decideStackRunEnd, decideStackRunStart, deleteApiKeyData, deleteCredentials, describeLlmSourceStatus, describeStackMismatch, e2e_exports as e2e, evaluateCheckoutFreshness, findVacatedNeeds, finishStackRun, formatPreferencesOneLiner, getActiveElectronAppReleaseStream, getActiveRuntimeTarget, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDashboardBaseUrl, getDataDir2 as getDataDir, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppReleaseTagPrefix, getElectronAppSignedFromVersion, getElectronAppVersion, getElectronAppVersionSource, getLlmSourceOption, getLocalQaTools, getLogger, getOnboardingToggleKeys, getPlatformKey, getQaTools, getReleaseSignerIdentityUri, getRunSessionsDir, getValidApiKeyData, getValidCredentials, hasApiKey, isElectronAppInstalled, isElectronAppPlatform, isFirstRun, isValidLocalBaseUrl, loadApiKeyData, loadCredentials, local_exports as localQa, lookUpCheckoutPullRequest, markOnboardingCompleted, maskLlmApiKey, mcp_exports as mcp, needsConflict, needsOnboarding, openBrowserUrl, parseElectronAppDirName, performLogin, performLogout, pollDeviceCode, portOfUrl, e2e_exports as qa, readPreferencesMetadata, readRunView, readServiceStackStatus, reapServiceStack, reconcileProjectPreferences, recordOnboardingSkip, releaseServiceStack, renderRunViewHtml, renderRunViewText, resetConfig, resetLogger, resetPreference, resolveActiveProfile, resolveActiveReleaseStream, resolveActiveReleaseTagPrefix, resolveBlanketPreferences, resolveElectronAppExecutablePath, resolveElectronAppPathOrNull, resolveLlmSourceStatus, resolveOnboardingAnswers, resolvePreferences, resolveRunSessionPath, resolveRuntimeTarget, resolveTogglePreferences, runGitCommand, saveApiKey, saveApiKeyData, saveCredentials, startDeviceCodeFlow, startStackRun, stopVacatedServices, toDisplayRef, toolRequiresAuth, validatePreference, verifyFileChecksum, writeLlmEnvBlock, writePreferences, writePreferencesWithMetadata, writeRunViewHtml } from './chunk-YMFQHBLJ.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@muggleai/works",
   "mcpName": "io.github.multiplex-ai/muggle",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "description": "13 years of Microsoft hyperscale engineering, packaged as a harness for your AI coding agent.",
   "type": "module",
   "main": "dist/index.js",
@@ -14,6 +14,7 @@
     "bin/muggle.js",
     ".claude-plugin/marketplace.json",
     "scripts/postinstall.mjs",
+    "scripts/post-install-guide",
     "scripts/claude-marketplace-sync.mjs",
     "scripts/electron-app-install-dir.mjs",
     "scripts/onboarding-backfill.mjs",

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

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.codex-mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.28.0-staging.251",
+        "@muggleai/works@5.28.0-staging.253",
         "serve"
       ],
       "env": {

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
   "author": {
     "name": "Muggle AI",

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

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Real-browser E2E acceptance for your coding agent: test the flows you changed and open the PR with screenshots. Built for flows other tools can't reach: managed test identities with live inboxes (magic links, email OTP and 2FA, verification mail, password resets), an encrypted secret store for login and test credentials, and a test graph that runs prerequisite flows first. Plain-English tests become replayable scripts on localhost or preview URLs.",
-  "version": "5.28.0-staging.251",
+  "version": "5.28.0-staging.253",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.28.0-staging.251",
+        "@muggleai/works@5.28.0-staging.253",
         "serve"
       ]
     }

package/scripts/post-install-guide/constants.mjs

@@ -0,0 +1,41 @@
+/** Terminal device opened on POSIX systems to reach the user's console past npm's output capture. */
+export const POSIX_TERMINAL_DEVICE_PATH = "/dev/tty";
+
+/** Console output device opened on Windows to reach the user's console past npm's output capture. */
+export const WINDOWS_TERMINAL_DEVICE_PATH = "\\\\.\\CONOUT$";
+
+/** Documentation page the guide links to. */
+export const POST_INSTALL_DOCS_URL = "https://www.muggle-ai.com/muggleTestV0/docs/mcp/mcp-overview";
+
+/** Lines of the guide, in print order. Blank strings are spacing. */
+export const POST_INSTALL_GUIDE_LINES = [
+    "Muggle AI Works is installed. Here is how to use it.",
+    "",
+    "See the menu",
+    "  /m   (or /muggle:muggle)   Opens a menu of every command",
+    "",
+    "Import your existing tests first",
+    "  /mimport   (or /muggle:muggle-test-import)",
+    "  Example: /mimport import my Playwright tests from ./e2e",
+    "",
+    "Build something, with acceptance tests",
+    "  /mdo   (or /muggle:muggle-do)",
+    "  Example: /mdo Add a logout button to the header",
+    "  Writes the code and unit tests, checks it in a real browser, opens the PR with",
+    "  screenshots, then watches the PR for reviews and CI.",
+    "",
+    "Run a test, locally or remotely",
+    "  /mtest   (or /muggle:muggle-test)",
+    "  Example: /mtest check my changes on http://localhost:3000",
+    "  Example: /mtest check my changes on https://staging.example.com",
+    "",
+    "Get run guidance",
+    "  muggle help   Full how-to guide, in your terminal",
+    "",
+    "Manage preferences",
+    "  /mprefs   (or /muggle:muggle-preferences)",
+    "  Example: /mprefs show my settings",
+    "",
+    "In Codex, write $muggle:mdo for /mdo.",
+    `Docs: ${POST_INSTALL_DOCS_URL}`,
+];

package/scripts/post-install-guide/index.d.mts

@@ -0,0 +1,17 @@
+export declare const POSIX_TERMINAL_DEVICE_PATH: string;
+export declare const WINDOWS_TERMINAL_DEVICE_PATH: string;
+export declare const POST_INSTALL_DOCS_URL: string;
+export declare const POST_INSTALL_GUIDE_LINES: readonly string[];
+
+export declare function buildPostInstallGuide(): string;
+
+export declare function writeToTerminalDevice(devicePath: string, text: string): void;
+
+export declare function showPostInstallGuide(params: {
+    guide: string;
+    isStdoutTerminal: boolean;
+    env: NodeJS.ProcessEnv;
+    platformName: string;
+    writeToStdout: (text: string) => void;
+    writeToDevice?: (devicePath: string, text: string) => void;
+}): { wroteToStdout: boolean; wroteToTerminalDevice: boolean };

package/scripts/post-install-guide/index.mjs

@@ -0,0 +1,77 @@
+import { closeSync, openSync, writeSync } from "node:fs";
+
+import {
+    POSIX_TERMINAL_DEVICE_PATH,
+    POST_INSTALL_GUIDE_LINES,
+    WINDOWS_TERMINAL_DEVICE_PATH,
+} from "./constants.mjs";
+
+export {
+    POSIX_TERMINAL_DEVICE_PATH,
+    POST_INSTALL_DOCS_URL,
+    POST_INSTALL_GUIDE_LINES,
+    WINDOWS_TERMINAL_DEVICE_PATH,
+} from "./constants.mjs";
+
+/**
+ * Build the getting-started guide shown after install.
+ * @returns {string} The guide as plain text.
+ */
+export function buildPostInstallGuide() {
+    return POST_INSTALL_GUIDE_LINES.join("\n");
+}
+
+/**
+ * Write text straight to the user's console device, bypassing stdout.
+ * @param {string} devicePath - Console device to open.
+ * @param {string} text - Text to write.
+ * @throws When the device cannot be opened, as in a headless environment.
+ */
+export function writeToTerminalDevice(devicePath, text) {
+    const fileDescriptor = openSync(devicePath, "w");
+    try {
+        writeSync(fileDescriptor, text);
+    } finally {
+        closeSync(fileDescriptor);
+    }
+}
+
+/**
+ * Show the guide to whoever ran the install.
+ *
+ * npm captures a lifecycle script's stdout during a global install and discards it on
+ * success, so a plain `console.log` is never seen. When stdout is not a terminal the guide
+ * is also written to the console device directly. CI and headless runs have no console to
+ * reach, so that write is skipped there and its failure is swallowed.
+ * @param {object} params - Output wiring.
+ * @param {string} params.guide - Text to show.
+ * @param {boolean} params.isStdoutTerminal - Whether stdout is an interactive terminal.
+ * @param {NodeJS.ProcessEnv} params.env - Process environment.
+ * @param {string} params.platformName - Value of `os.platform()`.
+ * @param {(text: string) => void} params.writeToStdout - Writes the guide to stdout and the install log.
+ * @param {(devicePath: string, text: string) => void} [params.writeToDevice] - Writes to a console device.
+ * @returns {{ wroteToStdout: boolean, wroteToTerminalDevice: boolean }} Which outputs received the guide.
+ */
+export function showPostInstallGuide({
+    guide,
+    isStdoutTerminal,
+    env,
+    platformName,
+    writeToStdout,
+    writeToDevice = writeToTerminalDevice,
+}) {
+    writeToStdout(guide);
+
+    if (isStdoutTerminal || env.CI) {
+        return { wroteToStdout: true, wroteToTerminalDevice: false };
+    }
+
+    const devicePath = platformName === "win32" ? WINDOWS_TERMINAL_DEVICE_PATH : POSIX_TERMINAL_DEVICE_PATH;
+
+    try {
+        writeToDevice(devicePath, `\n${guide}\n\n`);
+        return { wroteToStdout: true, wroteToTerminalDevice: true };
+    } catch {
+        return { wroteToStdout: true, wroteToTerminalDevice: false };
+    }
+}

package/scripts/postinstall.mjs

@@ -38,6 +38,7 @@ import {
     resolveIntegrityPolicy,
     verifyReleaseSignature,
 } from "./release-integrity/index.mjs";
+import { buildPostInstallGuide, showPostInstallGuide } from "./post-install-guide/index.mjs";
 
 const require = createRequire(import.meta.url);
 const INSTALL_METADATA_FILE_NAME = ".install-metadata.json";
@@ -1056,4 +1057,17 @@ applyWatchServicePreference();
 upsertCursorMcpConfig();
 downloadElectronApp()
     .catch(logError)
-    .finally(() => process.exit(0));
+    .finally(() => {
+        try {
+            showPostInstallGuide({
+                guide: buildPostInstallGuide(),
+                isStdoutTerminal: Boolean(process.stdout.isTTY),
+                env: process.env,
+                platformName: platform(),
+                writeToStdout: log,
+            });
+        } catch (error) {
+            logError(`Failed to show the post-install guide: ${error.message}`);
+        }
+        process.exit(0);
+    });