@muggleai/works 5.16.0-staging.111 → 5.17.0-staging.113

package/README.md

@@ -387,6 +387,8 @@ muggle serve --e2e        # Cloud E2E tools only (muggle-remote-*)
 muggle serve --local      # Local E2E tools only (muggle-local-*)
 
 # Setup and Diagnostics
+muggle init               # First-run walkthrough: explains Muggle Test, saves preferences
+muggle init --json        # Emit the walkthrough for another front-end to render
 muggle setup              # Download/update browser test runner
 muggle setup --force      # Force re-download
 muggle doctor             # Diagnose installation issues
@@ -514,6 +516,7 @@ muggle-ai-works/
 │   │   ├── muggle-repair/                 # /muggle:muggle-repair
 │   │   └── muggle-upgrade/                # /muggle:muggle-upgrade
 │   ├── hooks/               #   Session hooks (hooks.json)
+│   ├── config/              #   Data the hooks read (preference defaults, onboarding limits)
 │   ├── scripts/             #   Hook scripts (ensure-electron-app.sh)
 │   ├── .mcp.json            #   MCP server config
 │   └── README.md            #   Plugin install and usage docs

package/dist/{chunk-FK7XVMVA.js → chunk-6ILUPFM5.js}

@@ -1,4 +1,4 @@
-import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, toolRequiresAuth, getCallerCredentials, hasShownDisclosure, getDisclosureCopy, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require } from './chunk-VQZLKLAY.js';
+import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getActiveRuntimeTarget, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, reconcileProjectPreferences, getDataDir, PREFERENCES_FILE_NAME, isFirstRun, writePreferences, DEFAULT_PREFERENCES, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, getElectronAppSignedFromVersion, getReleaseSignerIdentityUri, verifyFileChecksum, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, assertDeviceCodeClientProvisioned, performLogin, toolRequiresAuth, getCallerCredentials, hasShownDisclosure, markDisclosureShown, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require, getDisclosureCopy, buildOnboardingPlan, applyOnboardingAnswers, needsOnboarding, OnboardingBlanketChoice, PreferenceKey } from './chunk-EKSYEVM2.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -12,6 +12,7 @@ import { fileURLToPath } from 'url';
 import { Command } from 'commander';
 import axios from 'axios';
 import { platform, homedir, arch } from 'os';
+import { createInterface } from 'readline/promises';
 import { execFile } from 'child_process';
 import { pipeline } from 'stream/promises';
 import { readFile } from 'fs/promises';
@@ -753,7 +754,7 @@ async function resolveGsScreenshotUrls(report, opts) {
     if (gsUrls.length === 0) {
       return report;
     }
-    const mcps = await import('./src-EHF3T2T2.js');
+    const mcps = await import('./src-52J7RTUV.js');
     const credentials = await mcps.getCallerCredentialsAsync();
     if (!credentials.bearerToken && !credentials.apiKey) {
       stderrWrite(
@@ -806,7 +807,7 @@ var withSentinel = (s) => s ? `${REPORT_SECTION_SENTINEL}
 ${s}` : s;
 async function resolveDashboardBaseUrl(stderrWrite) {
   try {
-    const mcps = await import('./src-EHF3T2T2.js');
+    const mcps = await import('./src-52J7RTUV.js');
     return mcps.resolveActiveProfile().dashboardBaseUrl;
   } catch (err) {
     stderrWrite(
@@ -1536,6 +1537,7 @@ function getHelpGuidance() {
     `    ${cmd("muggle serve --local")}    Start with local E2E tools only`,
     "",
     `  ${colorize("Setup & Diagnostics:", COLORS.bold)}`,
+    `    ${cmd("muggle init")}             Explain Muggle Test and save your preferences`,
     `    ${cmd("muggle setup")}            Download/update Electron app`,
     `    ${cmd("muggle setup --force")}    Force re-download`,
     `    ${cmd("muggle doctor")}           Diagnose installation issues`,
@@ -1617,6 +1619,173 @@ function getHelpGuidance() {
 function helpCommand() {
   console.log(getHelpGuidance());
 }
+var ACCEPT_HINT = "press Enter to accept";
+function printPrimer() {
+  const plan = buildOnboardingPlan();
+  console.log("");
+  console.log(plan.primerHeadline);
+  console.log("");
+  for (const bullet of plan.primerBullets) {
+    console.log(`  - ${bullet}`);
+  }
+  console.log("");
+}
+async function askOptionNumber(rl, optionCount, defaultIndex) {
+  for (; ; ) {
+    const answer = (await rl.question(`Choose 1-${optionCount} (${ACCEPT_HINT}): `)).trim();
+    if (answer.length === 0) {
+      return defaultIndex;
+    }
+    const picked = Number.parseInt(answer, 10);
+    if (Number.isInteger(picked) && picked >= 1 && picked <= optionCount) {
+      return picked - 1;
+    }
+    console.log(`Enter a number between 1 and ${optionCount}.`);
+  }
+}
+async function askBlanketChoice(rl) {
+  const options = buildOnboardingPlan().blanketOptions;
+  options.forEach((option, index) => {
+    console.log(`  ${index + 1}. ${option.label}`);
+    console.log(`     ${option.description}`);
+  });
+  console.log("");
+  const picked = await askOptionNumber(rl, options.length, 0);
+  return options[picked].choice;
+}
+async function askToggleGroup(rl, group, selected) {
+  console.log("");
+  console.log(`- ${group.header} -`);
+  console.log(group.prompt);
+  group.entries.forEach((entry, index) => {
+    if (entry.isSelectedByDefault) {
+      selected.add(entry.key);
+    }
+    const mark = entry.isSelectedByDefault ? "x" : " ";
+    console.log(`  [${mark}] ${index + 1}. ${entry.key} \u2014 ${entry.description}`);
+  });
+  const answer = (await rl.question(`Numbers to flip, comma-separated (${ACCEPT_HINT}): `)).trim();
+  if (answer.length === 0) {
+    return;
+  }
+  for (const token of answer.split(",")) {
+    const picked = Number.parseInt(token.trim(), 10);
+    if (!Number.isInteger(picked) || picked < 1 || picked > group.entries.length) {
+      continue;
+    }
+    const { key } = group.entries[picked - 1];
+    if (selected.has(key)) {
+      selected.delete(key);
+    } else {
+      selected.add(key);
+    }
+  }
+}
+async function askChoiceGroup(rl, group, choices) {
+  console.log("");
+  console.log(`- ${group.header} -`);
+  console.log(group.prompt);
+  const defaultIndex = Math.max(
+    group.options.findIndex((option) => option.isDefault),
+    0
+  );
+  group.options.forEach((option, index) => {
+    const mark = option.isDefault ? "*" : " ";
+    console.log(`  ${mark} ${index + 1}. ${option.label}`);
+  });
+  const picked = await askOptionNumber(rl, group.options.length, defaultIndex);
+  choices[group.key] = group.options[picked].value;
+}
+async function runTerminalWalkthrough() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    printPrimer();
+    const blanket = await askBlanketChoice(rl);
+    if (blanket !== "customize" /* Customize */) {
+      return { blanket };
+    }
+    const selected = /* @__PURE__ */ new Set();
+    const choices = {};
+    for (const group of buildOnboardingPlan().groups) {
+      if (group.kind === "toggle" /* Toggle */) {
+        await askToggleGroup(rl, group, selected);
+      } else {
+        await askChoiceGroup(rl, group, choices);
+      }
+    }
+    return {
+      blanket,
+      selectedToggleKeys: [...selected],
+      choices
+    };
+  } finally {
+    rl.close();
+  }
+}
+
+// src/cli/init/init-command.ts
+function isBlanketChoice(value) {
+  return Object.values(OnboardingBlanketChoice).includes(value);
+}
+function parseAnswersFile(filePath) {
+  const parsed = JSON.parse(readFileSync(filePath, "utf-8"));
+  if (!isBlanketChoice(parsed.blanket)) {
+    throw new Error(
+      `Answers file must set "blanket" to one of: ${Object.values(OnboardingBlanketChoice).join(", ")}`
+    );
+  }
+  const validKeys = Object.values(PreferenceKey);
+  for (const key of parsed.selectedToggleKeys ?? []) {
+    if (!validKeys.includes(key)) {
+      throw new Error(`Unknown preference key in selectedToggleKeys: ${key}`);
+    }
+  }
+  return {
+    blanket: parsed.blanket,
+    selectedToggleKeys: parsed.selectedToggleKeys,
+    choices: parsed.choices
+  };
+}
+function reportOutcome(result) {
+  if (result.skip && !result.skip.isRetired) {
+    console.log("Skipped. Muggle will offer this again next session.");
+    return;
+  }
+  if (result.skip) {
+    console.log("Skipped. Muggle will not ask again \u2014 run `muggle init` whenever you want it.");
+    return;
+  }
+  const summary = Object.entries(result.preferences).map(([key, value]) => `${key}=${value}`).join(" ");
+  console.log("");
+  console.log("Preferences saved.");
+  console.log(summary);
+}
+async function initCommand(options) {
+  if (options.json) {
+    console.log(JSON.stringify(buildOnboardingPlan(), null, 2));
+    return;
+  }
+  if (options.apply) {
+    try {
+      reportOutcome(applyOnboardingAnswers(parseAnswersFile(options.apply)));
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : String(error));
+      process.exitCode = 1;
+    }
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    console.error(
+      "`muggle init` needs an interactive terminal. Use `--json` to render the walkthrough elsewhere and `--apply <file>` to save the answers."
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (!needsOnboarding()) {
+    console.log("Muggle is already set up. Re-running the walkthrough \u2014 your current values are pre-selected.");
+  }
+  reportOutcome(applyOnboardingAnswers(await runTerminalWalkthrough()));
+}
 
 // src/cli/login.ts
 var logger4 = getLogger();
@@ -1687,12 +1856,26 @@ async function statusCommand() {
   }
 }
 
+// src/cli/disclosure/disclosure-constants.ts
+var DISCLOSURE_OPT_OUT_MARKER = "To opt out,";
+var DISCLOSURE_OPT_OUT_COPY = 'To opt out, set MUGGLE_TELEMETRY_DISABLED=1 in your environment, or set "telemetryEnabled": false at the top level of ~/.muggle-ai/preferences.json.';
+
+// src/cli/disclosure/disclosure-copy.ts
+function resolveDisclosureCopy() {
+  const upstream = getDisclosureCopy();
+  const markerIndex = upstream.indexOf(DISCLOSURE_OPT_OUT_MARKER);
+  if (markerIndex < 0) {
+    return `${upstream} ${DISCLOSURE_OPT_OUT_COPY}`;
+  }
+  return `${upstream.slice(0, markerIndex)}${DISCLOSURE_OPT_OUT_COPY}`;
+}
+
 // src/cli/serve.ts
 var APPLICATIONINSIGHTS_CONNECTION_STRING = "InstrumentationKey=0e28df42-b98e-4089-b3b5-6decefb99447;IngestionEndpoint=https://westus3-1.in.applicationinsights.azure.com/;LiveEndpoint=https://westus3.livediagnostics.monitor.azure.com/;ApplicationId=b64a932f-85ec-40cd-a74b-e181a3660f6c";
 function showDisclosureIfNeeded() {
   try {
     if (hasShownDisclosure()) return;
-    process.stderr.write(getDisclosureCopy() + "\n");
+    process.stderr.write(resolveDisclosureCopy() + "\n");
     markDisclosureShown();
   } catch {
   }
@@ -2448,6 +2631,7 @@ function createProgram() {
   const program = new Command();
   program.name("muggle").description("Unified MCP server for Muggle AI \u2014 cloud E2E and local E2E testing").version(packageVersion);
   program.command("serve").description("Start the MCP server").option("--e2e", "Only enable cloud E2E tools (remote URLs; muggle-remote-* prefix)").option("--local", "Only enable local E2E tools (localhost; muggle-local-* prefix)").option("--stdio", "Use stdio transport (default)").action(serveCommand);
+  program.command("init").description("Set up Muggle Test \u2014 explains how it works and saves your preferences").option("--json", "Emit the walkthrough as JSON instead of prompting").option("--apply <file>", "Apply answers from a JSON file").action(initCommand);
   program.command("setup").description("Download/update the Electron app for local testing").option("--force", "Force re-download even if already installed").action(setupCommand);
   program.command("upgrade").description("Check for and install the latest electron-app version").option("--force", "Force re-download even if already on latest").option("--check", "Check for updates only, don't download").option("--version <version>", "Download a specific version (e.g., 1.0.2)").action(upgradeCommand);
   program.command("versions").description("List installed electron-app versions").action(versionsCommand);

package/dist/{chunk-VQZLKLAY.js → chunk-EKSYEVM2.js}

@@ -31,6 +31,16 @@ var src_exports = {};
 __export(src_exports, {
   DEFAULT_PREFERENCES: () => DEFAULT_PREFERENCES,
   ElectronAppReleaseStream: () => ElectronAppReleaseStream,
+  ONBOARDING_BLANKET_OPTIONS: () => ONBOARDING_BLANKET_OPTIONS,
+  ONBOARDING_CHOICE_GROUPS: () => ONBOARDING_CHOICE_GROUPS,
+  ONBOARDING_MAX_OFFERS: () => ONBOARDING_MAX_OFFERS,
+  ONBOARDING_PRIMER_BULLETS: () => ONBOARDING_PRIMER_BULLETS,
+  ONBOARDING_PRIMER_HEADLINE: () => ONBOARDING_PRIMER_HEADLINE,
+  ONBOARDING_TOGGLE_GROUPS: () => ONBOARDING_TOGGLE_GROUPS,
+  ONBOARDING_TOGGLE_PROMPT: () => ONBOARDING_TOGGLE_PROMPT,
+  ONBOARDING_UNSELECTED_TOGGLE_VALUE: () => ONBOARDING_UNSELECTED_TOGGLE_VALUE,
+  OnboardingBlanketChoice: () => OnboardingBlanketChoice,
+  OnboardingGroupKind: () => OnboardingGroupKind,
   PREFERENCES_FILE_NAME: () => PREFERENCES_FILE_NAME,
   PREFERENCES_PROJECT_DIR_NAME: () => PREFERENCES_PROJECT_DIR_NAME,
   PREFERENCES_SCHEMA: () => PREFERENCES_SCHEMA,
@@ -42,11 +52,14 @@ __export(src_exports, {
   RuntimeTarget: () => RuntimeTarget,
   WATCHER_LIFETIME_SECONDS: () => WATCHER_LIFETIME_SECONDS,
   WATCHER_LIFETIME_UNBOUNDED_SECONDS: () => WATCHER_LIFETIME_UNBOUNDED_SECONDS,
+  applyOnboardingAnswers: () => applyOnboardingAnswers,
   assertDeviceCodeClientProvisioned: () => assertDeviceCodeClientProvisioned,
   buildElectronAppChecksumsUrl: () => buildElectronAppChecksumsUrl,
   buildElectronAppReleaseAssetUrl: () => buildElectronAppReleaseAssetUrl,
   buildElectronAppReleaseTag: () => buildElectronAppReleaseTag,
+  buildOnboardingPlan: () => buildOnboardingPlan,
   calculateFileChecksum: () => calculateFileChecksum,
+  completeOnboarding: () => completeOnboarding,
   createApiKeyWithToken: () => createApiKeyWithToken,
   createChildLogger: () => createChildLogger,
   deleteApiKeyData: () => deleteApiKeyData,
@@ -74,6 +87,7 @@ __export(src_exports, {
   getElectronAppVersionSource: () => getElectronAppVersionSource,
   getLocalQaTools: () => getLocalQaTools,
   getLogger: () => getLogger,
+  getOnboardingToggleKeys: () => getOnboardingToggleKeys,
   getPlatformKey: () => getPlatformKey,
   getQaTools: () => getQaTools,
   getReleaseSignerIdentityUri: () => getReleaseSignerIdentityUri,
@@ -85,22 +99,29 @@ __export(src_exports, {
   loadApiKeyData: () => loadApiKeyData,
   loadCredentials: () => loadCredentials,
   localQa: () => local_exports2,
+  markOnboardingCompleted: () => markOnboardingCompleted,
   mcp: () => mcp_exports,
+  needsOnboarding: () => needsOnboarding,
   openBrowserUrl: () => openBrowserUrl,
   performLogin: () => performLogin,
   performLogout: () => performLogout,
   pollDeviceCode: () => pollDeviceCode,
   qa: () => e2e_exports2,
+  readPreferencesMetadata: () => readPreferencesMetadata,
   reconcileProjectPreferences: () => reconcileProjectPreferences,
+  recordOnboardingSkip: () => recordOnboardingSkip,
   resetConfig: () => resetConfig,
   resetLogger: () => resetLogger,
   resetPreference: () => resetPreference,
   resolveActiveProfile: () => resolveActiveProfile,
   resolveActiveReleaseStream: () => resolveActiveReleaseStream,
   resolveActiveReleaseTagPrefix: () => resolveActiveReleaseTagPrefix,
+  resolveBlanketPreferences: () => resolveBlanketPreferences,
   resolveElectronAppPathOrNull: () => resolveElectronAppPathOrNull,
+  resolveOnboardingAnswers: () => resolveOnboardingAnswers,
   resolvePreferences: () => resolvePreferences,
   resolveRuntimeTarget: () => resolveRuntimeTarget,
+  resolveTogglePreferences: () => resolveTogglePreferences,
   saveApiKey: () => saveApiKey,
   saveApiKeyData: () => saveApiKeyData,
   saveCredentials: () => saveCredentials,
@@ -108,7 +129,8 @@ __export(src_exports, {
   toolRequiresAuth: () => toolRequiresAuth,
   validatePreference: () => validatePreference,
   verifyFileChecksum: () => verifyFileChecksum,
-  writePreferences: () => writePreferences2
+  writePreferences: () => writePreferences2,
+  writePreferencesWithMetadata: () => writePreferencesWithMetadata
 });
 
 // packages/mcps/src/shared/runtime-target-types.ts
@@ -6940,6 +6962,27 @@ function writePreferences2(prefs, dataDirOverride2) {
   const existing = readPreferencesFile(filePath);
   writePreferencesFile(filePath, { ...existing, ...prefs });
 }
+function readPreferencesMetadata(dataDirOverride2) {
+  const metadata = {
+    ...readRawPreferencesFile(getGlobalPreferencesFilePath(dataDirOverride2))
+  };
+  delete metadata.preferences;
+  return metadata;
+}
+function writePreferencesWithMetadata(prefs, metadata, dataDirOverride2) {
+  const dir = dataDirOverride2 ?? getDataDir();
+  fs6.mkdirSync(dir, { recursive: true });
+  const filePath = path11.join(dir, PREFERENCES_FILE_NAME);
+  const existing = readRawPreferencesFile(filePath);
+  const file = {
+    ...existing,
+    ...metadata,
+    version: PREFERENCES_VERSION,
+    preferences: { ...existing.preferences ?? {}, ...prefs }
+  };
+  fs6.writeFileSync(filePath, `${JSON.stringify(file, null, 2)}
+`, "utf-8");
+}
 function resetPreference(key, dataDirOverride2) {
   const filePath = getGlobalPreferencesFilePath(dataDirOverride2);
   if (!fs6.existsSync(filePath)) {
@@ -7923,4 +7966,238 @@ var WATCHER_LIFETIME_SECONDS = {
   ["never" /* Never */]: WATCHER_LIFETIME_UNBOUNDED_SECONDS
 };
 
-export { DEFAULT_PREFERENCES, ElectronAppReleaseStream, EventName, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ProjectPreferencesReconcileOutcome, RuntimeTarget, ServiceName, Surface, WATCHER_LIFETIME_SECONDS, WATCHER_LIFETIME_UNBOUNDED_SECONDS, __export, __require, assertDeviceCodeClientProvisioned, buildElectronAppChecksumsUrl, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, calculateFileChecksum, createApiKeyWithToken, createChildLogger, deleteApiKeyData, deleteCredentials, e2e_exports2 as e2e_exports, formatPreferencesOneLiner, getActiveElectronAppReleaseStream, getActiveRuntimeTarget, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDataDir2 as getDataDir, getDisclosureCopy, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppReleaseTagPrefix, getElectronAppSignedFromVersion, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getPlatformKey, getQaTools, getReleaseSignerIdentityUri, getValidApiKeyData, getValidCredentials, hasApiKey, hasShownDisclosure, initTelemetry, isElectronAppInstalled, isFirstRun, loadApiKeyData, loadCredentials, local_exports2 as local_exports, markDisclosureShown, mcp_exports, openBrowserUrl, performLogin, performLogout, pollDeviceCode, reconcileProjectPreferences, resetConfig, resetLogger, resetPreference, resolveActiveProfile, resolveActiveReleaseStream, resolveActiveReleaseTagPrefix, resolveElectronAppPathOrNull, resolvePreferences, resolveRuntimeTarget, saveApiKey, saveApiKeyData, saveCredentials, src_exports, startDeviceCodeFlow, toolRequiresAuth, track, validatePreference, verifyFileChecksum, writePreferences2 as writePreferences };
+// packages/mcps/src/shared/onboarding/onboarding-types.ts
+var OnboardingGroupKind = /* @__PURE__ */ ((OnboardingGroupKind2) => {
+  OnboardingGroupKind2["Toggle"] = "toggle";
+  OnboardingGroupKind2["Choice"] = "choice";
+  return OnboardingGroupKind2;
+})(OnboardingGroupKind || {});
+var OnboardingBlanketChoice = /* @__PURE__ */ ((OnboardingBlanketChoice2) => {
+  OnboardingBlanketChoice2["AcceptDefaults"] = "accept-defaults";
+  OnboardingBlanketChoice2["AskEverything"] = "ask-everything";
+  OnboardingBlanketChoice2["Customize"] = "customize";
+  OnboardingBlanketChoice2["Skip"] = "skip";
+  return OnboardingBlanketChoice2;
+})(OnboardingBlanketChoice || {});
+
+// packages/mcps/src/shared/onboarding/onboarding-constants.ts
+var ONBOARDING_PRIMER_HEADLINE = "Muggle Test drives a real browser against your app.";
+var ONBOARDING_PRIMER_BULLETS = [
+  "Tests are plain English",
+  "Scripts replay as regressions",
+  "Run locally or in the cloud",
+  "Real logins, real inboxes",
+  "Screenshots land on your PR"
+];
+var ONBOARDING_MAX_OFFERS = 3;
+var ONBOARDING_UNSELECTED_TOGGLE_VALUE = "ask" /* Ask */;
+var ONBOARDING_TOGGLE_PROMPT = 'Which of these should Muggle do on its own? Anything you leave off is set to "ask".';
+var ONBOARDING_TOGGLE_GROUPS = [
+  {
+    header: "Auth & session",
+    keys: [
+      "autoLogin" /* AutoLogin */,
+      "autoSelectProject" /* AutoSelectProject */,
+      "checkForUpdates" /* CheckForUpdates */,
+      "verboseOutput" /* VerboseOutput */
+    ]
+  },
+  {
+    header: "Test setup",
+    keys: [
+      "autoSelectLocalHost" /* AutoSelectLocalHost */,
+      "autoDetectChanges" /* AutoDetectChanges */,
+      "autoReuseValidationContext" /* AutoReuseValidationContext */,
+      "reusePreparePlan" /* ReusePreparePlan */
+    ]
+  },
+  {
+    header: "Test run",
+    keys: ["showElectronBrowser" /* ShowElectronBrowser */, "openTestResultsAfterRun" /* OpenTestResultsAfterRun */]
+  },
+  {
+    header: "Suggestions",
+    keys: ["suggestRelatedUseCases" /* SuggestRelatedUseCases */, "suggestRelatedTestCases" /* SuggestRelatedTestCases */]
+  },
+  {
+    header: "PR",
+    keys: [
+      "postPRVisualWalkthrough" /* PostPRVisualWalkthrough */,
+      "autoCreatePR" /* AutoCreatePR */,
+      "autoWatchPR" /* AutoWatchPR */,
+      "autoRouteBuildToMuggleDo" /* AutoRouteBuildToMuggleDo */
+    ]
+  },
+  {
+    header: "Branch hygiene",
+    keys: [
+      "autoUseWorktree" /* AutoUseWorktree */,
+      "autoRebase" /* AutoRebase */,
+      "autoCleanup" /* AutoCleanup */,
+      "autoResolveConflicts" /* AutoResolveConflicts */
+    ]
+  }
+];
+var ONBOARDING_CHOICE_GROUPS = [
+  {
+    header: "E2E acceptance",
+    key: "autoE2ETest" /* AutoE2ETest */,
+    prompt: "Run E2E acceptance at the end of every dev cycle?",
+    optionLabels: [
+      { value: "always" /* Always */, label: "Always run it at the end" },
+      { value: "ask" /* Ask */, label: "Ask each cycle" }
+    ]
+  },
+  {
+    header: "Default mode",
+    key: "defaultExecutionMode" /* DefaultExecutionMode */,
+    prompt: "Where should tests run by default?",
+    optionLabels: [
+      { value: "local" /* Local */, label: "Local \u2014 run on my computer" },
+      { value: "remote" /* Remote */, label: "Remote \u2014 run in the Muggle Test cloud" },
+      { value: "ask" /* Ask */, label: "Ask each time" }
+    ]
+  },
+  {
+    header: "PR watcher",
+    key: "watcherLifetime" /* WatcherLifetime */,
+    prompt: "How long should a PR watcher keep polling for new reviews?",
+    optionLabels: [
+      { value: "1d" /* OneDay */, label: "Retire after 1 day" },
+      { value: "7d" /* SevenDays */, label: "Retire after 7 days" },
+      { value: "never" /* Never */, label: "Never retire \u2014 no time-based reaper for an orphaned loop" }
+    ]
+  }
+];
+var ONBOARDING_BLANKET_OPTIONS = [
+  {
+    choice: "accept-defaults" /* AcceptDefaults */,
+    label: "Accept recommended defaults",
+    description: "Automate the safe parts, run tests locally, show the browser. Done in one keystroke."
+  },
+  {
+    choice: "ask-everything" /* AskEverything */,
+    label: "Ask me before everything",
+    description: "Nothing proceeds unattended. Features stay available; Muggle just checks with you first."
+  },
+  {
+    choice: "customize" /* Customize */,
+    label: "Walk me through the questions",
+    description: "Go group by group, with the recommended answer pre-selected."
+  },
+  {
+    choice: "skip" /* Skip */,
+    label: "Skip for now",
+    description: "Use defaults without saving a choice. Offered again next session."
+  }
+];
+
+// packages/mcps/src/shared/onboarding/onboarding-service.ts
+function needsOnboarding(dataDirOverride2) {
+  const completedAt = readPreferencesMetadata(dataDirOverride2).onboardingCompletedAt;
+  return typeof completedAt !== "string" || completedAt.length === 0;
+}
+function getOnboardingToggleKeys() {
+  return ONBOARDING_TOGGLE_GROUPS.flatMap((group) => group.keys);
+}
+function buildOnboardingPlan() {
+  const toggleGroups = ONBOARDING_TOGGLE_GROUPS.map((group) => ({
+    kind: "toggle" /* Toggle */,
+    header: group.header,
+    prompt: ONBOARDING_TOGGLE_PROMPT,
+    entries: group.keys.map((key) => ({
+      key,
+      description: PREFERENCES_SCHEMA[key].description,
+      isSelectedByDefault: DEFAULT_PREFERENCES[key] === "always" /* Always */
+    }))
+  }));
+  const choiceGroups = ONBOARDING_CHOICE_GROUPS.map((group) => ({
+    kind: "choice" /* Choice */,
+    header: group.header,
+    prompt: group.prompt,
+    key: group.key,
+    description: PREFERENCES_SCHEMA[group.key].description,
+    options: group.optionLabels.map((option) => ({
+      label: option.label,
+      value: option.value,
+      isDefault: DEFAULT_PREFERENCES[group.key] === option.value
+    }))
+  }));
+  return {
+    primerHeadline: ONBOARDING_PRIMER_HEADLINE,
+    primerBullets: [...ONBOARDING_PRIMER_BULLETS],
+    blanketOptions: [...ONBOARDING_BLANKET_OPTIONS],
+    groups: [...toggleGroups, ...choiceGroups]
+  };
+}
+function resolveBlanketPreferences(choice) {
+  if (choice === "ask-everything" /* AskEverything */) {
+    const prefs = {};
+    for (const key of Object.values(PreferenceKey)) {
+      prefs[key] = PREFERENCE_ALLOWED_VALUES[key].includes("ask" /* Ask */) ? "ask" /* Ask */ : DEFAULT_PREFERENCES[key];
+    }
+    return prefs;
+  }
+  return { ...DEFAULT_PREFERENCES };
+}
+function resolveUnselectedValue(key) {
+  return DEFAULT_PREFERENCES[key] === "never" /* Never */ ? "never" /* Never */ : ONBOARDING_UNSELECTED_TOGGLE_VALUE;
+}
+function resolveTogglePreferences(selectedKeys) {
+  const selected = new Set(selectedKeys);
+  const prefs = {};
+  for (const key of getOnboardingToggleKeys()) {
+    prefs[key] = selected.has(key) ? "always" /* Always */ : resolveUnselectedValue(key);
+  }
+  return prefs;
+}
+function completeOnboarding(prefs, dataDirOverride2, now = /* @__PURE__ */ new Date()) {
+  writePreferencesWithMetadata(
+    prefs,
+    { onboardingCompletedAt: now.toISOString() },
+    dataDirOverride2
+  );
+}
+function recordOnboardingSkip(dataDirOverride2, now = /* @__PURE__ */ new Date()) {
+  const offerCount = (readPreferencesMetadata(dataDirOverride2).onboardingOfferCount ?? 0) + 1;
+  const isRetired = offerCount >= ONBOARDING_MAX_OFFERS;
+  writePreferencesWithMetadata(
+    {},
+    {
+      onboardingOfferCount: offerCount,
+      ...isRetired ? { onboardingCompletedAt: now.toISOString() } : {}
+    },
+    dataDirOverride2
+  );
+  return { offerCount, isRetired };
+}
+function markOnboardingCompleted(dataDirOverride2, now = /* @__PURE__ */ new Date()) {
+  writePreferencesWithMetadata({}, { onboardingCompletedAt: now.toISOString() }, dataDirOverride2);
+}
+function resolveOnboardingAnswers(answers) {
+  if (answers.blanket === "skip" /* Skip */) {
+    return {};
+  }
+  if (answers.blanket !== "customize" /* Customize */) {
+    return resolveBlanketPreferences(answers.blanket);
+  }
+  const prefs = resolveTogglePreferences(answers.selectedToggleKeys ?? []);
+  for (const [key, value] of Object.entries(answers.choices ?? {})) {
+    if (!validatePreference(key, value)) {
+      throw new Error(`Invalid onboarding choice: ${key}=${value}`);
+    }
+    prefs[key] = value;
+  }
+  return prefs;
+}
+function applyOnboardingAnswers(answers, dataDirOverride2, now = /* @__PURE__ */ new Date()) {
+  if (answers.blanket === "skip" /* Skip */) {
+    const skip = recordOnboardingSkip(dataDirOverride2, now);
+    return { isCompleted: skip.isRetired, preferences: {}, skip };
+  }
+  const prefs = resolveOnboardingAnswers(answers);
+  completeOnboarding(prefs, dataDirOverride2, now);
+  return { isCompleted: true, preferences: prefs };
+}
+
+export { DEFAULT_PREFERENCES, ElectronAppReleaseStream, EventName, 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, RuntimeTarget, ServiceName, Surface, WATCHER_LIFETIME_SECONDS, WATCHER_LIFETIME_UNBOUNDED_SECONDS, __export, __require, applyOnboardingAnswers, assertDeviceCodeClientProvisioned, buildElectronAppChecksumsUrl, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, buildOnboardingPlan, calculateFileChecksum, completeOnboarding, createApiKeyWithToken, createChildLogger, deleteApiKeyData, deleteCredentials, e2e_exports2 as e2e_exports, formatPreferencesOneLiner, getActiveElectronAppReleaseStream, getActiveRuntimeTarget, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDataDir2 as getDataDir, getDisclosureCopy, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppReleaseTagPrefix, getElectronAppSignedFromVersion, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getOnboardingToggleKeys, getPlatformKey, getQaTools, getReleaseSignerIdentityUri, getValidApiKeyData, getValidCredentials, hasApiKey, hasShownDisclosure, initTelemetry, isElectronAppInstalled, isFirstRun, loadApiKeyData, loadCredentials, local_exports2 as local_exports, markDisclosureShown, markOnboardingCompleted, mcp_exports, needsOnboarding, openBrowserUrl, performLogin, performLogout, pollDeviceCode, readPreferencesMetadata, reconcileProjectPreferences, recordOnboardingSkip, resetConfig, resetLogger, resetPreference, resolveActiveProfile, resolveActiveReleaseStream, resolveActiveReleaseTagPrefix, resolveBlanketPreferences, resolveElectronAppPathOrNull, resolveOnboardingAnswers, resolvePreferences, resolveRuntimeTarget, resolveTogglePreferences, saveApiKey, saveApiKeyData, saveCredentials, src_exports, startDeviceCodeFlow, toolRequiresAuth, track, validatePreference, verifyFileChecksum, writePreferences2 as writePreferences, writePreferencesWithMetadata };

package/dist/cli.js

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

package/dist/plugin/config/onboarding-limits.json

@@ -0,0 +1,3 @@
+{
+  "maxOffers": 3
+}

package/dist/plugin/config/preference-defaults.json

@@ -0,0 +1,25 @@
+{
+  "autoLogin": "always",
+  "autoSelectProject": "always",
+  "autoSelectLocalHost": "always",
+  "showElectronBrowser": "always",
+  "openTestResultsAfterRun": "always",
+  "defaultExecutionMode": "local",
+  "suggestRelatedUseCases": "always",
+  "suggestRelatedTestCases": "always",
+  "autoDetectChanges": "always",
+  "postPRVisualWalkthrough": "always",
+  "autoCreatePR": "always",
+  "checkForUpdates": "always",
+  "verboseOutput": "never",
+  "autoUseWorktree": "always",
+  "autoRebase": "always",
+  "autoCleanup": "always",
+  "autoE2ETest": "always",
+  "autoResolveConflicts": "always",
+  "autoReuseValidationContext": "always",
+  "autoRouteBuildToMuggleDo": "always",
+  "autoWatchPR": "always",
+  "reusePreparePlan": "always",
+  "watcherLifetime": "7d"
+}