@muggleai/works 5.8.1 → 5.10.0

package/dist/{chunk-LVUJ4E62.js → chunk-OCLMXAVJ.js}

@@ -37,6 +37,7 @@ __export(src_exports, {
   PREFERENCE_ALLOWED_VALUES: () => PREFERENCE_ALLOWED_VALUES,
   PreferenceKey: () => PreferenceKey,
   PreferenceValue: () => PreferenceValue,
+  ProjectPreferencesReconcileOutcome: () => ProjectPreferencesReconcileOutcome,
   buildElectronAppChecksumsUrl: () => buildElectronAppChecksumsUrl,
   buildElectronAppReleaseAssetUrl: () => buildElectronAppReleaseAssetUrl,
   buildElectronAppReleaseTag: () => buildElectronAppReleaseTag,
@@ -80,8 +81,7 @@ __export(src_exports, {
   performLogout: () => performLogout,
   pollDeviceCode: () => pollDeviceCode,
   qa: () => e2e_exports2,
-  readGlobalPreferences: () => readGlobalPreferences,
-  readProjectPreferences: () => readProjectPreferences,
+  reconcileProjectPreferences: () => reconcileProjectPreferences,
   resetConfig: () => resetConfig,
   resetLogger: () => resetLogger,
   resetPreference: () => resetPreference,
@@ -542,14 +542,14 @@ function getPlatformKey() {
   }
 }
 async function calculateFileChecksum(filePath) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const hash = crypto.createHash("sha256");
     const stream = fs5.createReadStream(filePath);
     stream.on("data", (data) => {
       hash.update(data);
     });
     stream.on("end", () => {
-      resolve4(hash.digest("hex"));
+      resolve5(hash.digest("hex"));
     });
     stream.on("error", (error) => {
       reject(error);
@@ -627,7 +627,7 @@ function getOpenCommand(url) {
   }
 }
 async function openBrowserUrl(options) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     try {
       const command = getOpenCommand(options.url);
       logger2.debug("[Browser] Opening URL", { url: options.url, command });
@@ -637,13 +637,13 @@ async function openBrowserUrl(options) {
             url: options.url,
             error: error.message
           });
-          resolve4({
+          resolve5({
             opened: false,
             error: error.message
           });
         } else {
           logger2.info("[Browser] URL opened successfully", { url: options.url });
-          resolve4({ opened: true });
+          resolve5({ opened: true });
         }
       });
     } catch (error) {
@@ -652,7 +652,7 @@ async function openBrowserUrl(options) {
         url: options.url,
         error: errorMessage
       });
-      resolve4({
+      resolve5({
         opened: false,
         error: errorMessage
       });
@@ -1357,9 +1357,9 @@ function resetAuthService() {
   serviceInstance = null;
 }
 function sleep(params) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     setTimeout(() => {
-      resolve4();
+      resolve5();
     }, params.durationMs);
   });
 }
@@ -2620,7 +2620,7 @@ async function executeElectronAppAsync(params) {
     capturedStderr: ""
   };
   activeProcesses.set(params.runId, processInfo);
-  return await new Promise((resolve4, reject) => {
+  return await new Promise((resolve5, reject) => {
     let settled = false;
     const finalize = (result) => {
       if (settled) {
@@ -2632,7 +2632,7 @@ async function executeElectronAppAsync(params) {
       }
       activeProcesses.delete(params.runId);
       if (result.ok) {
-        resolve4(result.payload);
+        resolve5(result.payload);
       } else {
         reject(result.payload);
       }
@@ -3493,9 +3493,9 @@ function isValid2(value) {
 function readReleaseManifest2() {
   if (cachedManifest2 !== void 0)
     return cachedManifest2;
-  const path16 = MANIFEST_PATH2;
+  const path15 = MANIFEST_PATH2;
   try {
-    const raw = readFileSync(path16, "utf8");
+    const raw = readFileSync(path15, "utf8");
     const parsed = JSON.parse(raw);
     cachedManifest2 = isValid2(parsed) ? parsed : DEV_MANIFEST2;
     return cachedManifest2;
@@ -4274,17 +4274,17 @@ var PromptServiceClient = class {
    * @param path - Path to validate.
    * @throws GatewayError if path is not allowed.
    */
-  validatePath(path16) {
-    const isAllowed = ALLOWED_UPSTREAM_PREFIXES.some((prefix) => path16.startsWith(prefix));
+  validatePath(path15) {
+    const isAllowed = ALLOWED_UPSTREAM_PREFIXES.some((prefix) => path15.startsWith(prefix));
     if (!isAllowed) {
       const logger6 = getLogger();
       logger6.error("Path not in allowlist", {
-        path: path16,
+        path: path15,
         allowedPrefixes: ALLOWED_UPSTREAM_PREFIXES
       });
       throw new GatewayError({
         code: "FORBIDDEN" /* FORBIDDEN */,
-        message: `Path '${path16}' is not allowed`
+        message: `Path '${path15}' is not allowed`
       });
     }
   }
@@ -6431,12 +6431,15 @@ var PREFERENCES_SCHEMA = {
 // packages/mcps/src/mcp/local/contracts/preferences-schemas.ts
 var preferenceKeyValues = Object.values(PreferenceKey);
 var preferenceValueValues = Object.values(PreferenceValue);
-var PreferencesSetInputSchema = z.object({
-  key: z.enum(preferenceKeyValues).describe("The preference key to set."),
-  value: z.enum(preferenceValueValues).describe("The value. Most keys accept always/ask/never; defaultExecutionMode accepts local/remote/ask."),
-  scope: z.enum(["global", "project"]).default("global").describe("Write to global (~/.muggle-ai/) or project (.muggle-ai/) preferences."),
-  cwd: z.string().optional().describe("Project root directory. Required when scope is 'project'.")
-}).superRefine((data, ctx) => {
+var PreferencesSetInputSchema = z.object(
+  {
+    key: z.enum(preferenceKeyValues).describe("The preference key to set."),
+    value: z.enum(preferenceValueValues).describe("The value. Most keys accept always/ask/never; defaultExecutionMode accepts local/remote/ask.")
+  },
+  {
+    error: "Expected only { key, value }: per-project preferences were removed, so scope and cwd are no longer accepted."
+  }
+).strict().superRefine((data, ctx) => {
   const allowed = PREFERENCE_ALLOWED_VALUES[data.key];
   if (!allowed.includes(data.value)) {
     ctx.addIssue({
@@ -6518,9 +6521,21 @@ function appendFailureEvent(record) {
     });
   }
 }
+
+// packages/mcps/src/shared/project-preferences-reconcile-types.ts
+var ProjectPreferencesReconcileOutcome = /* @__PURE__ */ ((ProjectPreferencesReconcileOutcome2) => {
+  ProjectPreferencesReconcileOutcome2["NoAction"] = "noAction";
+  ProjectPreferencesReconcileOutcome2["CopiedToGlobal"] = "copiedToGlobal";
+  ProjectPreferencesReconcileOutcome2["KeysShadowed"] = "keysShadowed";
+  return ProjectPreferencesReconcileOutcome2;
+})(ProjectPreferencesReconcileOutcome || {});
+
+// packages/mcps/src/shared/preferences-service.ts
+function getGlobalPreferencesFilePath(dataDirOverride2) {
+  return path9.join(dataDirOverride2 ?? getDataDir(), PREFERENCES_FILE_NAME);
+}
 function isFirstRun(dataDirOverride2) {
-  const filePath = path9.join(dataDirOverride2 ?? getDataDir(), PREFERENCES_FILE_NAME);
-  return !fs5.existsSync(filePath);
+  return !fs5.existsSync(getGlobalPreferencesFilePath(dataDirOverride2));
 }
 function readPreferencesFile(filePath) {
   try {
@@ -6537,53 +6552,64 @@ function readPreferencesFile(filePath) {
     return {};
   }
 }
-function readGlobalPreferences(dataDirOverride2) {
-  const filePath = path9.join(dataDirOverride2 ?? getDataDir(), PREFERENCES_FILE_NAME);
-  const partial = readPreferencesFile(filePath);
-  return { ...DEFAULT_PREFERENCES, ...partial };
-}
-function readProjectPreferences(cwd) {
-  const filePath = path9.join(cwd, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_FILE_NAME);
-  return readPreferencesFile(filePath);
-}
-function resolvePreferences(dataDirOverride2, cwd) {
-  const global = readGlobalPreferences(dataDirOverride2);
-  if (!cwd) {
-    return global;
-  }
-  const project = readProjectPreferences(cwd);
-  return { ...global, ...project };
-}
-function writePreferences2(prefs, scope, dataDirOverride2, cwd) {
-  const dir = scope === "project" && cwd ? path9.join(cwd, PREFERENCES_PROJECT_DIR_NAME) : dataDirOverride2 ?? getDataDir();
-  fs5.mkdirSync(dir, { recursive: true });
-  const filePath = path9.join(dir, PREFERENCES_FILE_NAME);
-  const existing = readPreferencesFile(filePath);
-  const merged = { ...existing, ...prefs };
+function writePreferencesFile(filePath, prefs) {
   const file = {
     version: PREFERENCES_VERSION,
-    preferences: merged
+    preferences: prefs
   };
   fs5.writeFileSync(filePath, `${JSON.stringify(file, null, 2)}
 `, "utf-8");
 }
-function resetPreference(key, scope, dataDirOverride2, cwd) {
-  const dir = scope === "project" && cwd ? path9.join(cwd, PREFERENCES_PROJECT_DIR_NAME) : dataDirOverride2 ?? getDataDir();
+function resolvePreferences(dataDirOverride2) {
+  const saved = readPreferencesFile(getGlobalPreferencesFilePath(dataDirOverride2));
+  return { ...DEFAULT_PREFERENCES, ...saved };
+}
+function writePreferences2(prefs, dataDirOverride2) {
+  const dir = dataDirOverride2 ?? getDataDir();
+  fs5.mkdirSync(dir, { recursive: true });
   const filePath = path9.join(dir, PREFERENCES_FILE_NAME);
+  const existing = readPreferencesFile(filePath);
+  writePreferencesFile(filePath, { ...existing, ...prefs });
+}
+function resetPreference(key, dataDirOverride2) {
+  const filePath = getGlobalPreferencesFilePath(dataDirOverride2);
   if (!fs5.existsSync(filePath)) {
     return;
   }
   if (!key) {
-    const file2 = { version: PREFERENCES_VERSION, preferences: {} };
-    fs5.writeFileSync(filePath, `${JSON.stringify(file2, null, 2)}
-`, "utf-8");
+    writePreferencesFile(filePath, {});
     return;
   }
   const existing = readPreferencesFile(filePath);
   delete existing[key];
-  const file = { version: PREFERENCES_VERSION, preferences: existing };
-  fs5.writeFileSync(filePath, `${JSON.stringify(file, null, 2)}
-`, "utf-8");
+  writePreferencesFile(filePath, existing);
+}
+function reconcileProjectPreferences(cwd, dataDirOverride2) {
+  const projectFilePath = path9.join(cwd, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_FILE_NAME);
+  const projectPreferences = readPreferencesFile(projectFilePath);
+  const projectKeys = Object.keys(projectPreferences);
+  if (projectKeys.length === 0) {
+    return {
+      outcome: "noAction" /* NoAction */,
+      projectFilePath,
+      shadowedKeys: []
+    };
+  }
+  if (isFirstRun(dataDirOverride2)) {
+    writePreferences2(projectPreferences, dataDirOverride2);
+    return {
+      outcome: "copiedToGlobal" /* CopiedToGlobal */,
+      projectFilePath,
+      shadowedKeys: []
+    };
+  }
+  const resolved = resolvePreferences(dataDirOverride2);
+  const shadowedKeys = projectKeys.filter((key) => projectPreferences[key] !== resolved[key]);
+  return {
+    outcome: shadowedKeys.length > 0 ? "keysShadowed" /* KeysShadowed */ : "noAction" /* NoAction */,
+    projectFilePath,
+    shadowedKeys
+  };
 }
 function validatePreference(key, value) {
   const validKeys = Object.values(PreferenceKey);
@@ -6596,77 +6622,134 @@ function validatePreference(key, value) {
 function formatPreferencesOneLiner(prefs) {
   return Object.entries(prefs).map(([key, value]) => `${key}=${value}`).join(" ");
 }
-var LAST_PROJECT_FILE_NAME = "last-project.json";
-var LAST_PROJECT_DIR_NAME = ".muggle-ai";
-var LAST_PROJECT_VERSION = 1;
-function readLastProject(cwd) {
-  const filePath = path9.join(cwd, LAST_PROJECT_DIR_NAME, LAST_PROJECT_FILE_NAME);
+
+// packages/mcps/src/shared/cwd-keyed-cache-constants.ts
+var CWD_KEYED_CACHE_VERSION = 1;
+var LEGACY_CACHE_DIR_NAME = ".muggle-ai";
+var MUGGLE_HOME_DISPLAY_DIR = "~/.muggle-ai";
+
+// packages/mcps/src/shared/cwd-keyed-cache.ts
+function resolveHomeFilePath(cache) {
+  return path9.join(getDataDir(), cache.fileName);
+}
+function resolveLegacyFilePath(cache, cwd) {
+  return path9.join(cwd, LEGACY_CACHE_DIR_NAME, cache.fileName);
+}
+function parseJsonFile(filePath) {
   try {
     if (!fs5.existsSync(filePath)) {
       return null;
     }
-    const raw = JSON.parse(fs5.readFileSync(filePath, "utf-8"));
-    return raw.lastProject ?? null;
+    return JSON.parse(fs5.readFileSync(filePath, "utf-8"));
   } catch (error) {
-    getLogger().warn("Failed to read last-project file", {
+    getLogger().warn("Failed to read cache file", {
       path: filePath,
       error: error instanceof Error ? error.message : String(error)
     });
     return null;
   }
 }
-function writeLastProject(cwd, lastProject) {
-  const dir = path9.join(cwd, LAST_PROJECT_DIR_NAME);
-  fs5.mkdirSync(dir, { recursive: true });
-  const filePath = path9.join(dir, LAST_PROJECT_FILE_NAME);
+function readHomeEntries(cache) {
+  const parsed = parseJsonFile(resolveHomeFilePath(cache));
+  return parsed?.entries ?? {};
+}
+function writeHomeEntries(cache, entries) {
+  fs5.mkdirSync(getDataDir(), { recursive: true });
   const file = {
-    version: LAST_PROJECT_VERSION,
-    lastProject: { ...lastProject, savedAt: (/* @__PURE__ */ new Date()).toISOString() }
+    version: CWD_KEYED_CACHE_VERSION,
+    entries
   };
-  fs5.writeFileSync(filePath, `${JSON.stringify(file, null, 2)}
-`, "utf-8");
+  fs5.writeFileSync(
+    resolveHomeFilePath(cache),
+    `${JSON.stringify(file, null, 2)}
+`,
+    "utf-8"
+  );
 }
-function clearLastProject(cwd) {
-  const filePath = path9.join(cwd, LAST_PROJECT_DIR_NAME, LAST_PROJECT_FILE_NAME);
-  if (fs5.existsSync(filePath)) {
-    fs5.unlinkSync(filePath);
-  }
+function readLegacyEntry(cache, cwd) {
+  const parsed = parseJsonFile(
+    resolveLegacyFilePath(cache, cwd)
+  );
+  return parsed?.[cache.legacyEntryKey] ?? null;
 }
-var LAST_HOST_FILE_NAME = "last-host.json";
-var LAST_HOST_DIR_NAME = ".muggle-ai";
-var LAST_HOST_VERSION = 1;
-function readLastHost(cwd) {
-  const filePath = path9.join(cwd, LAST_HOST_DIR_NAME, LAST_HOST_FILE_NAME);
+function readCwdEntry(cache, cwd) {
+  const cwdKey = path9.resolve(cwd);
+  const entries = readHomeEntries(cache);
+  const homeEntry = entries[cwdKey];
+  if (homeEntry) {
+    return homeEntry;
+  }
+  const legacyEntry = readLegacyEntry(cache, cwd);
+  if (!legacyEntry) {
+    return null;
+  }
   try {
-    if (!fs5.existsSync(filePath)) {
-      return null;
-    }
-    const raw = JSON.parse(fs5.readFileSync(filePath, "utf-8"));
-    return raw.lastHost ?? null;
+    writeHomeEntries(cache, { ...entries, [cwdKey]: legacyEntry });
   } catch (error) {
-    getLogger().warn("Failed to read last-host file", {
-      path: filePath,
+    getLogger().warn("Failed to migrate cache entry to the home directory", {
+      path: resolveHomeFilePath(cache),
       error: error instanceof Error ? error.message : String(error)
     });
-    return null;
   }
+  return legacyEntry;
+}
+function writeCwdEntry(cache, cwd, entry) {
+  const entries = readHomeEntries(cache);
+  writeHomeEntries(cache, { ...entries, [path9.resolve(cwd)]: entry });
+}
+function clearCwdEntry(cache, cwd) {
+  const entries = readHomeEntries(cache);
+  const cwdKey = path9.resolve(cwd);
+  if (cwdKey in entries) {
+    delete entries[cwdKey];
+    writeHomeEntries(cache, entries);
+  }
+  const legacyFilePath = resolveLegacyFilePath(cache, cwd);
+  if (fs5.existsSync(legacyFilePath)) {
+    fs5.unlinkSync(legacyFilePath);
+  }
+}
+
+// packages/mcps/src/shared/last-project-constants.ts
+var LAST_PROJECT_FILE_NAME = "last-project.json";
+var LAST_PROJECT_CACHE = {
+  fileName: LAST_PROJECT_FILE_NAME,
+  legacyEntryKey: "lastProject"
+};
+
+// packages/mcps/src/shared/last-project.ts
+function readLastProject(cwd) {
+  return readCwdEntry(LAST_PROJECT_CACHE, cwd);
+}
+function writeLastProject(cwd, lastProject) {
+  writeCwdEntry(LAST_PROJECT_CACHE, cwd, {
+    ...lastProject,
+    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function clearLastProject(cwd) {
+  clearCwdEntry(LAST_PROJECT_CACHE, cwd);
+}
+
+// packages/mcps/src/shared/last-host-constants.ts
+var LAST_HOST_FILE_NAME = "last-host.json";
+var LAST_HOST_CACHE = {
+  fileName: LAST_HOST_FILE_NAME,
+  legacyEntryKey: "lastHost"
+};
+
+// packages/mcps/src/shared/last-host.ts
+function readLastHost(cwd) {
+  return readCwdEntry(LAST_HOST_CACHE, cwd);
 }
 function writeLastHost(cwd, host) {
-  const dir = path9.join(cwd, LAST_HOST_DIR_NAME);
-  fs5.mkdirSync(dir, { recursive: true });
-  const filePath = path9.join(dir, LAST_HOST_FILE_NAME);
-  const file = {
-    version: LAST_HOST_VERSION,
-    lastHost: { host, savedAt: (/* @__PURE__ */ new Date()).toISOString() }
-  };
-  fs5.writeFileSync(filePath, `${JSON.stringify(file, null, 2)}
-`, "utf-8");
+  writeCwdEntry(LAST_HOST_CACHE, cwd, {
+    host,
+    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
 }
 function clearLastHost(cwd) {
-  const filePath = path9.join(cwd, LAST_HOST_DIR_NAME, LAST_HOST_FILE_NAME);
-  if (fs5.existsSync(filePath)) {
-    fs5.unlinkSync(filePath);
-  }
+  clearCwdEntry(LAST_HOST_CACHE, cwd);
 }
 
 // packages/mcps/src/mcp/tools/local/tool-registry.ts
@@ -6765,42 +6848,42 @@ var runResultGetTool = {
     logger6.info("Executing muggle-local-run-result-get");
     const input = RunResultGetInputSchema.parse(ctx.input);
     const storage = getRunResultStorageService();
-    const result = storage.getRunResult(input.runId);
-    if (!result) {
+    const storedRunResult = storage.getRunResult(input.runId);
+    if (!storedRunResult) {
       return { content: `Run result not found: ${input.runId}`, isError: true };
     }
     const contentParts = [
       "## Run Result Details",
       "",
-      `**ID:** ${result.id}`,
-      `**Type:** ${result.runType}`,
-      `**Status:** ${result.status}`,
-      `**Cloud Test Case:** ${result.cloudTestCaseId}`,
-      `**Duration:** ${result.executionTimeMs ?? 0}ms`,
-      result.errorMessage ? `**Error:** ${result.errorMessage}` : "",
+      `**ID:** ${storedRunResult.id}`,
+      `**Type:** ${storedRunResult.runType}`,
+      `**Status:** ${storedRunResult.status}`,
+      `**Cloud Test Case:** ${storedRunResult.cloudTestCaseId}`,
+      `**Duration:** ${storedRunResult.executionTimeMs ?? 0}ms`,
+      storedRunResult.errorMessage ? `**Error:** ${storedRunResult.errorMessage}` : "",
       // The studio publishes the run during execution; these are its returned cloud refs.
-      result.viewUrl ? `**View URL:** ${result.viewUrl}` : "",
-      result.cloudTestScriptId ? `**Cloud Test Script ID:** ${result.cloudTestScriptId}` : "",
-      result.cloudActionScriptId ? `**Cloud Action Script ID:** ${result.cloudActionScriptId}` : ""
+      storedRunResult.viewUrl ? `**View URL:** ${storedRunResult.viewUrl}` : "",
+      storedRunResult.cloudTestScriptId ? `**Cloud Test Script ID:** ${storedRunResult.cloudTestScriptId}` : "",
+      storedRunResult.cloudActionScriptId ? `**Cloud Action Script ID:** ${storedRunResult.cloudActionScriptId}` : ""
     ];
     let testScriptSteps;
-    if (result.testScriptId) {
-      const testScript = storage.getTestScript(result.testScriptId);
+    if (storedRunResult.testScriptId) {
+      const testScript = storage.getTestScript(storedRunResult.testScriptId);
       testScriptSteps = testScript?.actionScript?.length;
     }
-    if (result.artifactsDir && fs5.existsSync(result.artifactsDir)) {
+    if (storedRunResult.artifactsDir && fs5.existsSync(storedRunResult.artifactsDir)) {
       contentParts.push(
         "",
         "### Artifacts (view action script + screenshots)",
         "",
-        `**Location:** \`${result.artifactsDir}\``,
+        `**Location:** \`${storedRunResult.artifactsDir}\``,
         ""
       );
-      const actionScriptPath = path9.join(result.artifactsDir, "action-script.json");
-      const resultsMdPath = path9.join(result.artifactsDir, "results.md");
-      const screenshotsDir = path9.join(result.artifactsDir, "screenshots");
-      const stdoutLogPath = path9.join(result.artifactsDir, "stdout.log");
-      const stderrLogPath = path9.join(result.artifactsDir, "stderr.log");
+      const actionScriptPath = path9.join(storedRunResult.artifactsDir, "action-script.json");
+      const resultsMdPath = path9.join(storedRunResult.artifactsDir, "results.md");
+      const screenshotsDir = path9.join(storedRunResult.artifactsDir, "screenshots");
+      const stdoutLogPath = path9.join(storedRunResult.artifactsDir, "stdout.log");
+      const stderrLogPath = path9.join(storedRunResult.artifactsDir, "stderr.log");
       const artifactItems = [];
       if (fs5.existsSync(actionScriptPath)) {
         artifactItems.push("- `action-script.json` \u2014 generated test steps");
@@ -6826,13 +6909,13 @@ var runResultGetTool = {
       "",
       "### Ending state",
       "",
-      `- **Status:** ${result.status}`,
-      `- **Duration:** ${result.executionTimeMs ?? 0}ms`,
+      `- **Status:** ${storedRunResult.status}`,
+      `- **Duration:** ${storedRunResult.executionTimeMs ?? 0}ms`,
       testScriptSteps !== void 0 ? `- **Steps generated:** ${testScriptSteps}` : "",
-      result.artifactsDir ? `- **Artifacts path:** \`${result.artifactsDir}\`` : ""
+      storedRunResult.artifactsDir ? `- **Artifacts path:** \`${storedRunResult.artifactsDir}\`` : ""
     );
     const content = contentParts.filter(Boolean).join("\n");
-    return { content, isError: false, data: result };
+    return { content, isError: false, data: storedRunResult };
   }
 };
 var testScriptListTool = {
@@ -6892,7 +6975,7 @@ var executeTestGenerationTool = {
     const input = ExecuteTestGenerationInputSchema.parse(ctx.input);
     const showUi = input.showUi !== false;
     try {
-      const result = await executeTestGeneration({
+      const generationRun = await executeTestGeneration({
         testCase: input.testCase,
         localUrl: input.localUrl,
         cwd: input.cwd,
@@ -6902,19 +6985,19 @@ var executeTestGenerationTool = {
         freshSession: input.freshSession
       });
       const content = [
-        "## Test Generation " + (result.status === "passed" ? "Successful" : "Failed"),
+        "## Test Generation " + (generationRun.status === "passed" ? "Successful" : "Failed"),
         "",
-        `**Run ID:** ${result.id}`,
-        `**Test Script ID:** ${result.testScriptId}`,
-        `**Status:** ${result.status}`,
-        `**Duration:** ${result.executionTimeMs}ms`,
+        `**Run ID:** ${generationRun.id}`,
+        `**Test Script ID:** ${generationRun.testScriptId}`,
+        `**Status:** ${generationRun.status}`,
+        `**Duration:** ${generationRun.executionTimeMs}ms`,
         `**UI:** ${showUi ? "visible GUI" : "headless"}`,
-        result.errorMessage ? `**Error:** ${result.errorMessage}` : ""
+        generationRun.errorMessage ? `**Error:** ${generationRun.errorMessage}` : ""
       ].filter(Boolean).join("\n");
       return {
         content,
-        isError: result.status !== "passed",
-        data: result
+        isError: generationRun.status !== "passed",
+        data: generationRun
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -6933,7 +7016,7 @@ var executeReplayTool = {
     const input = ExecuteReplayInputSchema.parse(ctx.input);
     const showUi = input.showUi !== false;
     try {
-      const result = await executeReplay({
+      const replayRun = await executeReplay({
         testScript: input.testScript,
         actionScript: input.actionScript,
         localUrl: input.localUrl,
@@ -6944,19 +7027,19 @@ var executeReplayTool = {
         freshSession: input.freshSession
       });
       const content = [
-        "## Test Replay " + (result.status === "passed" ? "Successful" : "Failed"),
+        "## Test Replay " + (replayRun.status === "passed" ? "Successful" : "Failed"),
         "",
-        `**Run ID:** ${result.id}`,
-        `**Test Script ID:** ${result.testScriptId}`,
-        `**Status:** ${result.status}`,
-        `**Duration:** ${result.executionTimeMs}ms`,
+        `**Run ID:** ${replayRun.id}`,
+        `**Test Script ID:** ${replayRun.testScriptId}`,
+        `**Status:** ${replayRun.status}`,
+        `**Duration:** ${replayRun.executionTimeMs}ms`,
         `**UI:** ${showUi ? "visible GUI" : "headless"}`,
-        result.errorMessage ? `**Error:** ${result.errorMessage}` : ""
+        replayRun.errorMessage ? `**Error:** ${replayRun.errorMessage}` : ""
       ].filter(Boolean).join("\n");
       return {
         content,
-        isError: result.status !== "passed",
-        data: result
+        isError: replayRun.status !== "passed",
+        data: replayRun
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -6982,27 +7065,22 @@ var cancelExecutionTool = {
 };
 var preferencesSetTool = {
   name: "muggle-local-preferences-set",
-  description: "Set a Muggle AI user preference. Preferences control automation behavior (auto-login, show browser, suggest test cases, etc.). Values: 'always' (proceed without asking), 'ask' (prompt each time), 'never' (skip without asking). Scope: 'global' writes to ~/.muggle-ai/preferences.json, 'project' writes to .muggle-ai/preferences.json in the repo root.",
+  description: "Set a Muggle AI user preference. Preferences control automation behavior (auto-login, show browser, suggest test cases, etc.). Values: 'always' (proceed without asking), 'ask' (prompt each time), 'never' (skip without asking). Preferences are user-level: they always write to ~/.muggle-ai/preferences.json and apply to every repo.",
   inputSchema: PreferencesSetInputSchema,
   execute: async (ctx) => {
     const logger6 = createChildLogger2(ctx.correlationId);
     logger6.info("Executing muggle-local-preferences-set");
     const input = PreferencesSetInputSchema.parse(ctx.input);
-    writePreferences2(
-      { [input.key]: input.value },
-      input.scope,
-      void 0,
-      input.cwd
-    );
+    writePreferences2({ [input.key]: input.value });
     return {
-      content: `**${input.key}** set to **${input.value}** (${input.scope}).`,
+      content: `**${input.key}** set to **${input.value}**.`,
       isError: false
     };
   }
 };
 var lastProjectGetTool = {
   name: "muggle-local-last-project-get",
-  description: "Get the cached last-used Muggle Test project for a repo (read from <cwd>/.muggle-ai/last-project.json). Returns the project ID, URL, name, and saved-at timestamp, or null if no cache exists. Skills consult this when 'autoSelectProject = always' to silently reuse the project the user picked previously, instead of presenting the project picker every time.",
+  description: `Get the cached last-used Muggle Test project for a repo (read from the entry keyed on <cwd> in ${MUGGLE_HOME_DISPLAY_DIR}/${LAST_PROJECT_FILE_NAME}). Returns the project ID, URL, name, and saved-at timestamp, or null if no cache exists. Skills consult this when 'autoSelectProject = always' to silently reuse the project the user picked previously, instead of presenting the project picker every time.`,
   inputSchema: LastProjectGetInputSchema,
   execute: async (ctx) => {
     const logger6 = createChildLogger2(ctx.correlationId);
@@ -7013,7 +7091,7 @@ var lastProjectGetTool = {
       const content2 = [
         "No cached last-used project for this repo.",
         "",
-        `Looked at: \`${input.cwd}/.muggle-ai/${LAST_PROJECT_FILE_NAME}\``,
+        `Looked at: \`${MUGGLE_HOME_DISPLAY_DIR}/${LAST_PROJECT_FILE_NAME}\` (entry for \`${input.cwd}\`)`,
         "",
         "The cache is populated when a user picks an existing project AND chooses 'Yes, save it' on the memory picker (the autoSelectProject preference)."
       ].join("\n");
@@ -7032,7 +7110,7 @@ var lastProjectGetTool = {
 };
 var lastProjectSetTool = {
   name: "muggle-local-last-project-set",
-  description: "Save the user's selected Muggle Test project as the cached last-used project for this repo. Writes to <cwd>/.muggle-ai/last-project.json. Subsequent skill invocations honor 'autoSelectProject = always' by silently reusing this entry \u2014 no project picker shown. Always pair this call with 'muggle-local-preferences-set autoSelectProject=always' when the user chose 'Yes, save it'.",
+  description: `Save the user's selected Muggle Test project as the cached last-used project for this repo. Writes the entry keyed on <cwd> in ${MUGGLE_HOME_DISPLAY_DIR}/${LAST_PROJECT_FILE_NAME}. Subsequent skill invocations honor 'autoSelectProject = always' by silently reusing this entry \u2014 no project picker shown. Always pair this call with 'muggle-local-preferences-set autoSelectProject=always' when the user chose 'Yes, save it'.`,
   inputSchema: LastProjectSetInputSchema,
   execute: async (ctx) => {
     const logger6 = createChildLogger2(ctx.correlationId);
@@ -7046,7 +7124,7 @@ var lastProjectSetTool = {
     const content = [
       `Cached **${input.projectName}** as the last-used project for this repo.`,
       "",
-      `Written to: \`${input.cwd}/.muggle-ai/${LAST_PROJECT_FILE_NAME}\``,
+      `Written to: \`${MUGGLE_HOME_DISPLAY_DIR}/${LAST_PROJECT_FILE_NAME}\` (entry for \`${input.cwd}\`)`,
       "",
       "Skills will silently reuse this project on future runs when `autoSelectProject = always`."
     ].join("\n");
@@ -7065,14 +7143,14 @@ var lastProjectClearTool = {
     const content = [
       "Cleared the cached last-used project for this repo.",
       "",
-      `Path: \`${input.cwd}/.muggle-ai/${LAST_PROJECT_FILE_NAME}\``
+      `Path: \`${MUGGLE_HOME_DISPLAY_DIR}/${LAST_PROJECT_FILE_NAME}\` (entry for \`${input.cwd}\`)`
     ].join("\n");
     return { content, isError: false };
   }
 };
 var lastHostGetTool = {
   name: "muggle-local-last-host-get",
-  description: "Get the cached last-used local dev server URL for a repo (read from <cwd>/.muggle-ai/last-host.json). Returns the URL and saved-at timestamp, or null if no cache exists. Skills consult this when 'autoSelectLocalHost = always' to silently reuse the URL the user used previously.",
+  description: `Get the cached last-used local dev server URL for a repo (read from the entry keyed on <cwd> in ${MUGGLE_HOME_DISPLAY_DIR}/${LAST_HOST_FILE_NAME}). Returns the URL and saved-at timestamp, or null if no cache exists. Skills consult this when 'autoSelectLocalHost = always' to silently reuse the URL the user used previously.`,
   inputSchema: LastHostGetInputSchema,
   execute: async (ctx) => {
     const logger6 = createChildLogger2(ctx.correlationId);
@@ -7083,7 +7161,7 @@ var lastHostGetTool = {
       const content2 = [
         "No cached last-used host for this repo.",
         "",
-        `Looked at: \`${input.cwd}/.muggle-ai/${LAST_HOST_FILE_NAME}\``
+        `Looked at: \`${MUGGLE_HOME_DISPLAY_DIR}/${LAST_HOST_FILE_NAME}\` (entry for \`${input.cwd}\`)`
       ].join("\n");
       return { content: content2, isError: false };
     }
@@ -7098,7 +7176,7 @@ var lastHostGetTool = {
 };
 var lastHostSetTool = {
   name: "muggle-local-last-host-set",
-  description: "Save the user's chosen local dev server URL as the cached last-used host for this repo. Writes to <cwd>/.muggle-ai/last-host.json. Call this on every host pick (independent of 'Remember this URL?' Picker 2) so future runs can offer 'Use {lastHost}' regardless of whether the user opted to set autoSelectLocalHost=always.",
+  description: `Save the user's chosen local dev server URL as the cached last-used host for this repo. Writes the entry keyed on <cwd> in ${MUGGLE_HOME_DISPLAY_DIR}/${LAST_HOST_FILE_NAME}. Call this on every host pick (independent of 'Remember this URL?' Picker 2) so future runs can offer 'Use {lastHost}' regardless of whether the user opted to set autoSelectLocalHost=always.`,
   inputSchema: LastHostSetInputSchema,
   execute: async (ctx) => {
     const logger6 = createChildLogger2(ctx.correlationId);
@@ -7208,7 +7286,7 @@ async function executeTool(name, input, correlationId) {
     props: { toolName: name, toolSurface: ToolSurface.Local, correlationId }
   });
   try {
-    const result = await tool.execute({ input, correlationId });
+    const toolResult = await tool.execute({ input, correlationId });
     safeTrack2({
       name: EventName.McpToolCompleted,
       props: {
@@ -7216,10 +7294,10 @@ async function executeTool(name, input, correlationId) {
         toolSurface: ToolSurface.Local,
         correlationId,
         durationMs: Date.now() - startTime,
-        outcome: result.isError ? Outcome.Error : Outcome.Success
+        outcome: toolResult.isError ? Outcome.Error : Outcome.Success
       }
     });
-    return result;
+    return toolResult;
   } catch (err) {
     safeTrack2({
       name: EventName.McpToolCompleted,
@@ -7463,4 +7541,4 @@ var plugins_exports = {};
 // packages/mcps/src/mcp/agents/index.ts
 var agents_exports = {};
 
-export { DEFAULT_PREFERENCES, EventName, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ServiceName, Surface, __export, __require, buildElectronAppChecksumsUrl, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, calculateFileChecksum, createApiKeyWithToken, createChildLogger, deleteApiKeyData, deleteCredentials, e2e_exports2 as e2e_exports, formatPreferencesOneLiner, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDataDir2 as getDataDir, getDisclosureCopy, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getPlatformKey, getQaTools, getValidApiKeyData, getValidCredentials, hasApiKey, hasShownDisclosure, initTelemetry, isElectronAppInstalled, isFirstRun, loadApiKeyData, loadCredentials, local_exports2 as local_exports, markDisclosureShown, mcp_exports, openBrowserUrl, performLogin, performLogout, pollDeviceCode, readGlobalPreferences, readProjectPreferences, resetConfig, resetLogger, resetPreference, resolveElectronAppPathOrNull, resolvePreferences, saveApiKey, saveApiKeyData, saveCredentials, src_exports, startDeviceCodeFlow, toolRequiresAuth, track, validatePreference, verifyFileChecksum, writePreferences2 as writePreferences };
+export { DEFAULT_PREFERENCES, EventName, PREFERENCES_FILE_NAME, PREFERENCES_PROJECT_DIR_NAME, PREFERENCES_SCHEMA, PREFERENCES_VERSION, PREFERENCE_ALLOWED_VALUES, PreferenceKey, PreferenceValue, ProjectPreferencesReconcileOutcome, ServiceName, Surface, __export, __require, buildElectronAppChecksumsUrl, buildElectronAppReleaseAssetUrl, buildElectronAppReleaseTag, calculateFileChecksum, createApiKeyWithToken, createChildLogger, deleteApiKeyData, deleteCredentials, e2e_exports2 as e2e_exports, formatPreferencesOneLiner, getApiKey, getApiKeyFilePath, getAuthService, getBundledElectronAppVersion, getCallerCredentials, getCallerCredentialsAsync, getChecksumForPlatform, getConfig, getCredentialsFilePath, getDataDir2 as getDataDir, getDisclosureCopy, getDownloadBaseUrl, getElectronAppChecksums, getElectronAppDir, getElectronAppVersion, getElectronAppVersionSource, getLocalQaTools, getLogger, getPlatformKey, getQaTools, 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, resolveElectronAppPathOrNull, resolvePreferences, saveApiKey, saveApiKeyData, saveCredentials, src_exports, startDeviceCodeFlow, toolRequiresAuth, track, validatePreference, verifyFileChecksum, writePreferences2 as writePreferences };