@muggleai/works 5.31.0-staging.277 → 5.31.0-staging.279

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.31.0-staging.277"
+      "version": "5.31.0-staging.279"
     }
   ]
 }

package/dist/{chunk-FVG7CYB7.js → chunk-CGKARU5D.js}

@@ -2937,6 +2937,11 @@ var MUGGLE_MCP_SERVER_PATTERN = /@muggleai[\\/]works\b.*\bserve\b/;
 var PR_WATCH_LOOP_PATTERN = /pr-watch-loop\.sh\b.*?--slot\s+(?:"([^"]+)"|(\S+))/;
 var CLAUDE_SESSION_REGISTRY_DIR_NAME = "sessions";
 var CLAUDE_PROJECTS_DIR_NAME = "projects";
+var CLAUDE_JOBS_DIR_NAME = "jobs";
+var CLAUDE_JOB_STATE_FILE_NAME = "state.json";
+var SESSION_NAME_FLAG = "--name";
+var CLAUDE_PROMPT_NAME_MAX_LENGTH = 200;
+var CUSTOM_TITLE_ENTRY_TYPE = "custom-title";
 var CLAUDE_INSTALLED_PLUGINS_RELATIVE_PATH = ["plugins", "installed_plugins.json"];
 var CLAUDE_GLOBAL_CONFIG_FILE_NAME = ".claude.json";
 var CLAUDE_SETTINGS_FILE_NAME = "settings.json";
@@ -3004,6 +3009,7 @@ function resolveWatchPaths(env = process.env) {
     slotsDir: join(muggleDataDir, ...PR_WATCH_SLOTS_RELATIVE_PATH),
     claudeSessionRegistryDir: join(claudeConfigDir, CLAUDE_SESSION_REGISTRY_DIR_NAME),
     claudeProjectsDir: join(claudeConfigDir, CLAUDE_PROJECTS_DIR_NAME),
+    claudeJobsDir: join(claudeConfigDir, CLAUDE_JOBS_DIR_NAME),
     claudeInstalledPluginsFile: join(claudeConfigDir, ...CLAUDE_INSTALLED_PLUGINS_RELATIVE_PATH),
     claudeGlobalConfigFile: join(env.CLAUDE_CONFIG_DIR || homedir(), CLAUDE_GLOBAL_CONFIG_FILE_NAME),
     claudeSettingsFile: join(claudeConfigDir, CLAUDE_SETTINGS_FILE_NAME),
@@ -5167,6 +5173,44 @@ function readCodexSessions(sessionsDir, nowMs) {
   }
   return sessions;
 }
+function jobStatePath(jobsDir, shortId) {
+  return join(jobsDir, shortId, CLAUDE_JOB_STATE_FILE_NAME);
+}
+function readJobState(statePath) {
+  try {
+    const parsed = JSON.parse(readFileSync(statePath, "utf-8"));
+    return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function respawnFlagsOf(state) {
+  return Array.isArray(state.respawnFlags) ? state.respawnFlags.filter((flag) => typeof flag === "string") : [];
+}
+function nameFlagOf(respawnFlags) {
+  const flagIndex = respawnFlags.lastIndexOf(SESSION_NAME_FLAG);
+  return flagIndex === -1 ? void 0 : optionalString(respawnFlags[flagIndex + 1]);
+}
+function readClaudeJob(jobsDir, shortId) {
+  const state = readJobState(jobStatePath(jobsDir, shortId));
+  if (state === void 0) return void 0;
+  const intent = optionalString(state.intent);
+  return { respawnFlags: respawnFlagsOf(state), ...intent === void 0 ? {} : { intent } };
+}
+function pinClaudeJobName(jobsDir, shortId, name) {
+  const statePath = jobStatePath(jobsDir, shortId);
+  const state = readJobState(statePath);
+  if (state === void 0) return false;
+  const respawnFlags = respawnFlagsOf(state);
+  if (nameFlagOf(respawnFlags) === name) return true;
+  const otherFlags = respawnFlags.filter((flag, index) => flag !== SESSION_NAME_FLAG && respawnFlags[index - 1] !== SESSION_NAME_FLAG);
+  try {
+    writeFileSync(statePath, JSON.stringify({ ...state, respawnFlags: [...otherFlags, SESSION_NAME_FLAG, name] }, null, 2));
+    return true;
+  } catch {
+    return false;
+  }
+}
 function findTranscriptPath(projectsDir, sessionId) {
   let projectDirNames;
   try {
@@ -5211,6 +5255,23 @@ function readLimitStop(projectsDir, sessionId) {
   }
   return void 0;
 }
+function readCustomTitle(projectsDir, sessionId) {
+  const transcriptPath = findTranscriptPath(projectsDir, sessionId);
+  if (transcriptPath === void 0) return void 0;
+  let transcript;
+  try {
+    transcript = readFileSync(transcriptPath, "utf-8");
+  } catch {
+    return void 0;
+  }
+  let customTitle;
+  for (const line of transcript.split("\n")) {
+    if (!line.includes(CUSTOM_TITLE_ENTRY_TYPE)) continue;
+    const entry = parseTranscriptLine(line);
+    if (entry?.type === CUSTOM_TITLE_ENTRY_TYPE) customTitle = optionalString(entry.customTitle) ?? customTitle;
+  }
+  return customTitle;
+}
 function findClaudeSessionCwd(projectsDir, sessionId) {
   const transcriptPath = findTranscriptPath(projectsDir, sessionId);
   if (transcriptPath === void 0) return void 0;
@@ -5430,7 +5491,7 @@ function startServiceLoops(assessments, nowMs, isPollingDisabled, ownerSessionOf
 }
 
 // src/watch/session-restart.ts
-function resumeSession(target, runCommand, waitForExit, isSessionRunning2) {
+function resumeSession(target, runCommand, waitForExit, isSessionRunning2, pinSessionName) {
   const runningSessionId = target.runningSessionId ?? target.sessionId;
   if (target.runningShortId !== void 0) {
     runCommand("claude", ["stop", target.runningShortId]);
@@ -5438,6 +5499,7 @@ function resumeSession(target, runCommand, waitForExit, isSessionRunning2) {
   } else if (isSessionRunning2(runningSessionId)) {
     return { outcome: "still-running" /* StillRunning */ };
   }
+  pinSessionName(target.sessionId, target.runningShortId ?? shortSessionId(target.sessionId));
   const resumed = runCommand("claude", ["--resume", target.sessionId, "--bg", target.prompt], { cwd: target.cwd, isStderrCaptured: true });
   if (resumed?.exitCode !== 0) return { outcome: "failed" /* Failed */ };
   const backgroundedShortId = resumed.stdout.match(BACKGROUNDED_SESSION_ID_PATTERN)?.[1];
@@ -5530,7 +5592,8 @@ function executeWatcherRecoveries(planned, attemptsByOwner, deps) {
       { sessionId: recovery.ownerSessionId, cwd, prompt, runningShortId: recovery.ownerShortId, runningSessionId: recovery.ownerRunningSessionId },
       deps.runCommand,
       deps.waitForExit,
-      deps.isSessionRunning
+      deps.isSessionRunning,
+      deps.pinSessionName
     );
     if (resumed.outcome === "continued" /* Continued */) {
       markServiceLoopReportDelivered(recovery.slotDir);
@@ -5889,7 +5952,8 @@ function executeLimitResumes(planned, attemptsBySession, deps) {
         { sessionId: decision.sessionId, cwd, prompt: LIMIT_RESUME_PROMPT, runningShortId: decision.runningShortId },
         deps.runCommand,
         deps.waitForExit,
-        deps.isSessionRunning
+        deps.isSessionRunning,
+        deps.pinSessionName
       );
       outcome = continuedOutcomeOf(resumed.outcome);
       message = continueMessageOf(resumed, decision.reason);
@@ -6159,7 +6223,7 @@ function planReloadFanOut(sessions, pending, watchOwnerSessionIds, maxRestarts =
   }
   return decisions;
 }
-function executeReloadFanOut(decisions, runCommand, canRestartIn) {
+function executeReloadFanOut(decisions, runCommand, canRestartIn, pinSessionName) {
   const restartableByCwd = /* @__PURE__ */ new Map();
   const isRestartable = (cwd) => {
     if (!restartableByCwd.has(cwd)) restartableByCwd.set(cwd, canRestartIn(cwd));
@@ -6172,6 +6236,7 @@ function executeReloadFanOut(decisions, runCommand, canRestartIn) {
       report.untrustedSessionIds.push(decision.sessionId);
       continue;
     }
+    pinSessionName(decision.sessionId, decision.shortId);
     const isRestarted = runCommand("claude", ["respawn", decision.shortId])?.exitCode === 0;
     (isRestarted ? report.respawnedSessionIds : report.failedSessionIds).push(decision.sessionId);
   }
@@ -6372,6 +6437,16 @@ function stampSessionLoads(sessions, table, tracked, installs, nowMs) {
   });
 }
 
+// src/watch/session-names.ts
+function isPlaceholderSessionName(name, shortId) {
+  return name === void 0 || name === shortId || name === LIMIT_RESUME_PROMPT || name.startsWith("/");
+}
+function resolveSessionName(sources) {
+  const promptName = sources.job?.intent?.replace(/\s+/g, " ").trim().slice(0, CLAUDE_PROMPT_NAME_MAX_LENGTH);
+  const candidates = [sources.customTitle, sources.job && nameFlagOf(sources.job.respawnFlags), sources.registeredName, promptName];
+  return candidates.find((candidate) => !isPlaceholderSessionName(candidate, sources.shortId));
+}
+
 // src/watch/terminal-pr-cache.ts
 function isRecheckDue(record, nowMs) {
   if (!record) return true;
@@ -6677,12 +6752,12 @@ function reloadRecordFor(state, targetAtMs) {
 }
 function runReloadPass(record, claudeSessions, watchOwnerSessionIds, deps, at) {
   const decisions = planReloadFanOut(claudeSessions, record, watchOwnerSessionIds);
-  const report = executeReloadFanOut(decisions, deps.runCommand, canRestartVia(deps));
+  const report = executeReloadFanOut(decisions, deps.runCommand, canRestartVia(deps), pinSessionNameVia(deps, claudeSessions));
   return { report, pendingReload: advancePendingReload(record, report), events: reloadEvents(report, at) };
 }
 function runRemoteControlPass(login, claudeSessions, restartsBySession, maxRestarts, deps, at) {
   const plan = planRemoteControlRestarts(claudeSessions, login, restartsBySession, deps.nowMs, maxRestarts);
-  const executed = executeReloadFanOut(plan.decisions, deps.runCommand, canRestartVia(deps));
+  const executed = executeReloadFanOut(plan.decisions, deps.runCommand, canRestartVia(deps), pinSessionNameVia(deps, claudeSessions));
   return {
     report: { ...executed, connectedSessionIds: plan.connectedSessionIds },
     restartsBySession: recordRemoteControlRestarts(restartsBySession, executed, deps.nowMs),
@@ -6698,14 +6773,26 @@ function waitForExitVia(deps) {
 function isSessionRunningVia(deps) {
   return (sessionId) => isSessionRunning(deps.runCommand, deps.paths.claudeSessionRegistryDir, sessionId) !== false;
 }
-function resumeDepsOf(deps) {
+function pinSessionNameVia(deps, claudeSessions) {
+  return (sessionId, shortId) => {
+    const name = resolveSessionName({
+      shortId,
+      customTitle: readCustomTitle(deps.paths.claudeProjectsDir, sessionId),
+      job: readClaudeJob(deps.paths.claudeJobsDir, shortId),
+      registeredName: claudeSessions?.find((session) => session.sessionId === sessionId)?.name
+    });
+    if (name !== void 0) pinClaudeJobName(deps.paths.claudeJobsDir, shortId, name);
+  };
+}
+function resumeDepsOf(deps, claudeSessions) {
   return {
     runCommand: deps.runCommand,
     claudeProjectsDir: deps.paths.claudeProjectsDir,
     nowMs: deps.nowMs,
     canRestartIn: canRestartVia(deps),
     waitForExit: waitForExitVia(deps),
-    isSessionRunning: isSessionRunningVia(deps)
+    isSessionRunning: isSessionRunningVia(deps),
+    pinSessionName: pinSessionNameVia(deps, claudeSessions)
   };
 }
 function runLimitResumePass(claudeSessions, attemptsBySession, maxContinues, deps) {
@@ -6722,7 +6809,7 @@ function runLimitResumePass(claudeSessions, attemptsBySession, maxContinues, dep
     isClaudeUsageLimitInForce(deps.paths.claudeGlobalConfigFile, deps.nowMs),
     maxContinues
   );
-  const executed = executeLimitResumes(planned, attemptsBySession, resumeDepsOf(deps));
+  const executed = executeLimitResumes(planned, attemptsBySession, resumeDepsOf(deps, claudeSessions));
   return { report: { decisions: executed.decisions }, attemptsBySession: executed.attemptsBySession, events: executed.events };
 }
 function reloadTargetAtMs(deps, installs) {
@@ -6787,7 +6874,7 @@ function runTickUnlocked(deps) {
       sessionsById,
       isClaudeUsageLimitInForce(deps.paths.claudeGlobalConfigFile, deps.nowMs)
     );
-    const executed = executeWatcherRecoveries(planned, recoveryAttemptsByOwner, resumeDepsOf(deps));
+    const executed = executeWatcherRecoveries(planned, recoveryAttemptsByOwner, resumeDepsOf(deps, claudeSessions));
     recoveries = executed.recoveries;
     recoveryAttemptsByOwner = executed.attemptsByOwner;
     events.push(...executed.events);

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runCli } from './chunk-FVG7CYB7.js';
+import { runCli } from './chunk-CGKARU5D.js';
 import './chunk-NTEBYUCA.js';
 
 // src/cli/main.ts

package/dist/index.js

@@ -1,2 +1,2 @@
-export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-FVG7CYB7.js';
+export { src_exports as commands, createUnifiedMcpServer, server_exports as server } from './chunk-CGKARU5D.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-NTEBYUCA.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.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "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.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.279",
         "serve"
       ],
       "env": {

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

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "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.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "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.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.279",
         "serve"
       ]
     }

package/dist/plugin/scripts/guardrails.mjs

@@ -446,6 +446,7 @@ var USER_WAIVE_PHRASE = "SKIP E2E";
 var MIN_NOT_APPLICABLE_REASON_WORDS = 4;
 var DEV_SERVER_PROBE_TIMEOUT_MS = 2e3;
 var GIT_PROBE_TIMEOUT_MS = 5e3;
+var BASE_REMOTE = "origin";
 var WEB_SERVER_COMMAND = /\b(vite|next\s+(dev|start)|react-scripts|ng\s+serve|nuxt|astro\s+dev|remix\s+dev|webpack(-dev)?-server|http-server|serve\s+-s|gatsby\s+develop|vue-cli-service\s+serve)\b/;
 var BROWSER_FRAMEWORK_PACKAGES = [
   "react-dom",
@@ -635,6 +636,68 @@ var defaultSkipProbes = {
   isReachable
 };
 
+// src/git-dir/constants.ts
+var DOT_GIT = ".git";
+var GITDIR_POINTER = /^gitdir:\s*(.+?)\s*$/m;
+var HEAD_BRANCH_REF = /^ref:\s*refs\/heads\/(.+?)\s*$/;
+var REMOTE_HEAD_REF = /^ref:\s*refs\/remotes\/(.+?)\s*$/;
+var CONFIG_SECTION_HEADER = /^\s*\[\s*([A-Za-z0-9.-]+)(?:\s+"((?:[^"\\]|\\.)*)")?\s*\]/;
+var CONFIG_KEY_VALUE = /^\s*([A-Za-z][A-Za-z0-9-]*)\s*=\s*(.*)$/;
+var CONFIG_INDIRECTION = /^\s*(?:\[\s*include(?:If)?\b|[^#;]*\binsteadOf\s*=)/im;
+
+// src/git-dir/gitDir.ts
+function locateGitDir(cwd, readTextFile2) {
+  let dir = resolve(cwd);
+  for (; ; ) {
+    const dotGit = join(dir, DOT_GIT);
+    const pointer = readTextFile2(dotGit)?.match(GITDIR_POINTER);
+    const gitDir = pointer ? resolve(dir, pointer[1]) : readTextFile2(join(dotGit, "HEAD")) !== null ? dotGit : null;
+    if (gitDir) {
+      const commonDirPointer = readTextFile2(join(gitDir, "commondir"))?.trim();
+      return { gitDir, commonDir: commonDirPointer ? resolve(gitDir, commonDirPointer) : gitDir };
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readCurrentBranch(cwd, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const head = location ? readTextFile2(join(location.gitDir, "HEAD")) : null;
+  if (head === null) return null;
+  return head.match(HEAD_BRANCH_REF)?.[1] ?? "";
+}
+function parseConfigValue(rawValue) {
+  const value = rawValue.trim();
+  if (value.startsWith('"')) {
+    const closingQuote = value.slice(1).search(/(?<!\\)"/);
+    const quoted = closingQuote < 0 ? value.slice(1) : value.slice(1, closingQuote + 1);
+    return quoted.replace(/\\(["\\])/g, "$1");
+  }
+  return value.replace(/\s*[#;].*$/, "");
+}
+function readRemoteUrl(cwd, remote, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const config = location ? readTextFile2(join(location.commonDir, "config")) : null;
+  if (config === null || CONFIG_INDIRECTION.test(config)) return null;
+  let isInRemoteSection = false;
+  for (const line of config.split(/\r?\n/)) {
+    const header = line.match(CONFIG_SECTION_HEADER);
+    if (header) {
+      isInRemoteSection = header[1].toLowerCase() === "remote" && header[2] === remote;
+      continue;
+    }
+    const entry = isInRemoteSection ? line.match(CONFIG_KEY_VALUE) : null;
+    if (entry && entry[1].toLowerCase() === "url") return parseConfigValue(entry[2]) || null;
+  }
+  return null;
+}
+function readRemoteHeadBranch(cwd, remote, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const ref = location ? readTextFile2(join(location.commonDir, "refs", "remotes", remote, "HEAD")) : null;
+  return ref?.match(REMOTE_HEAD_REF)?.[1] ?? null;
+}
+
 // src/guardrails/changeIdentity.ts
 function toRepoKey(host2, path) {
   const repoPath = path.replace(/^\/+|\/+$/g, "").replace(/\.git$/i, "");
@@ -661,21 +724,24 @@ function repoKeyOfRemoteUrl(remoteUrl) {
     return void 0;
   }
 }
-function resolveTreeChange(cwd, runGit2 = defaultSkipProbes.runGit) {
+function resolveTreeChange(cwd, probes = defaultSkipProbes) {
   if (!cwd) return void 0;
-  const remoteUrl = runGit2(["remote", "get-url", CHANGE_REPO_REMOTE], cwd);
-  const repo = remoteUrl ? repoKeyOfRemoteUrl(remoteUrl) : void 0;
-  const branch = runGit2(["branch", "--show-current"], cwd)?.trim();
-  return repo && branch ? { repo, branch } : void 0;
+  const writtenUrl = readRemoteUrl(cwd, CHANGE_REPO_REMOTE, probes.readTextFile);
+  const writtenRepo = writtenUrl ? repoKeyOfRemoteUrl(writtenUrl) : void 0;
+  const remoteUrl = writtenRepo ? null : probes.runGit(["remote", "get-url", CHANGE_REPO_REMOTE], cwd);
+  const repo = writtenRepo ?? (remoteUrl ? repoKeyOfRemoteUrl(remoteUrl) : void 0);
+  if (!repo) return void 0;
+  const branch = (readCurrentBranch(cwd, probes.readTextFile) ?? probes.runGit(["branch", "--show-current"], cwd))?.trim();
+  return branch ? { repo, branch } : void 0;
 }
-function resolveOpenedPrChange(command, prUrl, cwd, runGit2 = defaultSkipProbes.runGit) {
+function resolveOpenedPrChange(command, prUrl, cwd, probes = defaultSkipProbes) {
   const repo = repoKeyOfPrUrl(prUrl);
   if (!repo) return void 0;
   const openAt = command.search(PR_OPEN_COMMAND);
   const headFlag = openAt < 0 ? null : command.slice(openAt).match(PR_HEAD_BRANCH_FLAG);
   if (headFlag) return { repo, branch: headFlag[1].slice(headFlag[1].lastIndexOf(":") + 1) };
   if (DIRECTORY_CHANGE_COMMAND.test(command)) return void 0;
-  const treeChange = resolveTreeChange(cwd, runGit2);
+  const treeChange = resolveTreeChange(cwd, probes);
   return treeChange?.repo === repo ? treeChange : void 0;
 }
 function isSameChange(left, right) {
@@ -2378,8 +2444,7 @@ var verifyDevServerUnreachable = (context, detail) => {
 };
 var verifyEmptyDiff = (context) => {
   if (!context.cwd) return refuted("no working directory was available to inspect");
-  const head = context.probe.runGit(["symbolic-ref", "refs/remotes/origin/HEAD", "--short"], context.cwd);
-  const base = head?.trim();
+  const base = (readRemoteHeadBranch(context.cwd, BASE_REMOTE, context.probe.readTextFile) ?? context.probe.runGit(["symbolic-ref", `refs/remotes/${BASE_REMOTE}/HEAD`, "--short"], context.cwd))?.trim();
   if (!base) return refuted("the repo's base branch could not be resolved");
   const diff = context.probe.runGit(["diff", `${base}...HEAD`, "--stat"], context.cwd);
   if (diff === null) return refuted("the diff against the base branch could not be read");

package/dist/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "release": "5.26.0",
-  "buildId": "run-277-1",
-  "commitSha": "fea69b3dd04919c685e56559e6ceba0b6d57129e",
-  "buildTime": "2026-11-01T19:01:29Z",
+  "buildId": "run-279-1",
+  "commitSha": "999126987b03bfc3a3b2f8fbc337415e695fbbab",
+  "buildTime": "2026-11-02T08:18:32Z",
   "serviceName": "muggle-ai-works-mcp"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@muggleai/works",
   "mcpName": "io.github.multiplex-ai/muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "description": "13 years of Microsoft hyperscale engineering, packaged as a harness for your AI coding agent.",
   "type": "module",
   "main": "dist/index.js",

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.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "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.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.279",
         "serve"
       ],
       "env": {

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

@@ -1,6 +1,6 @@
 {
   "name": "muggle",
-  "version": "5.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "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.31.0-staging.277",
+  "version": "5.31.0-staging.279",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@muggleai/works@5.31.0-staging.277",
+        "@muggleai/works@5.31.0-staging.279",
         "serve"
       ]
     }

package/plugin/scripts/guardrails.mjs

@@ -446,6 +446,7 @@ var USER_WAIVE_PHRASE = "SKIP E2E";
 var MIN_NOT_APPLICABLE_REASON_WORDS = 4;
 var DEV_SERVER_PROBE_TIMEOUT_MS = 2e3;
 var GIT_PROBE_TIMEOUT_MS = 5e3;
+var BASE_REMOTE = "origin";
 var WEB_SERVER_COMMAND = /\b(vite|next\s+(dev|start)|react-scripts|ng\s+serve|nuxt|astro\s+dev|remix\s+dev|webpack(-dev)?-server|http-server|serve\s+-s|gatsby\s+develop|vue-cli-service\s+serve)\b/;
 var BROWSER_FRAMEWORK_PACKAGES = [
   "react-dom",
@@ -635,6 +636,68 @@ var defaultSkipProbes = {
   isReachable
 };
 
+// src/git-dir/constants.ts
+var DOT_GIT = ".git";
+var GITDIR_POINTER = /^gitdir:\s*(.+?)\s*$/m;
+var HEAD_BRANCH_REF = /^ref:\s*refs\/heads\/(.+?)\s*$/;
+var REMOTE_HEAD_REF = /^ref:\s*refs\/remotes\/(.+?)\s*$/;
+var CONFIG_SECTION_HEADER = /^\s*\[\s*([A-Za-z0-9.-]+)(?:\s+"((?:[^"\\]|\\.)*)")?\s*\]/;
+var CONFIG_KEY_VALUE = /^\s*([A-Za-z][A-Za-z0-9-]*)\s*=\s*(.*)$/;
+var CONFIG_INDIRECTION = /^\s*(?:\[\s*include(?:If)?\b|[^#;]*\binsteadOf\s*=)/im;
+
+// src/git-dir/gitDir.ts
+function locateGitDir(cwd, readTextFile2) {
+  let dir = resolve(cwd);
+  for (; ; ) {
+    const dotGit = join(dir, DOT_GIT);
+    const pointer = readTextFile2(dotGit)?.match(GITDIR_POINTER);
+    const gitDir = pointer ? resolve(dir, pointer[1]) : readTextFile2(join(dotGit, "HEAD")) !== null ? dotGit : null;
+    if (gitDir) {
+      const commonDirPointer = readTextFile2(join(gitDir, "commondir"))?.trim();
+      return { gitDir, commonDir: commonDirPointer ? resolve(gitDir, commonDirPointer) : gitDir };
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readCurrentBranch(cwd, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const head = location ? readTextFile2(join(location.gitDir, "HEAD")) : null;
+  if (head === null) return null;
+  return head.match(HEAD_BRANCH_REF)?.[1] ?? "";
+}
+function parseConfigValue(rawValue) {
+  const value = rawValue.trim();
+  if (value.startsWith('"')) {
+    const closingQuote = value.slice(1).search(/(?<!\\)"/);
+    const quoted = closingQuote < 0 ? value.slice(1) : value.slice(1, closingQuote + 1);
+    return quoted.replace(/\\(["\\])/g, "$1");
+  }
+  return value.replace(/\s*[#;].*$/, "");
+}
+function readRemoteUrl(cwd, remote, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const config = location ? readTextFile2(join(location.commonDir, "config")) : null;
+  if (config === null || CONFIG_INDIRECTION.test(config)) return null;
+  let isInRemoteSection = false;
+  for (const line of config.split(/\r?\n/)) {
+    const header = line.match(CONFIG_SECTION_HEADER);
+    if (header) {
+      isInRemoteSection = header[1].toLowerCase() === "remote" && header[2] === remote;
+      continue;
+    }
+    const entry = isInRemoteSection ? line.match(CONFIG_KEY_VALUE) : null;
+    if (entry && entry[1].toLowerCase() === "url") return parseConfigValue(entry[2]) || null;
+  }
+  return null;
+}
+function readRemoteHeadBranch(cwd, remote, readTextFile2) {
+  const location = locateGitDir(cwd, readTextFile2);
+  const ref = location ? readTextFile2(join(location.commonDir, "refs", "remotes", remote, "HEAD")) : null;
+  return ref?.match(REMOTE_HEAD_REF)?.[1] ?? null;
+}
+
 // src/guardrails/changeIdentity.ts
 function toRepoKey(host2, path) {
   const repoPath = path.replace(/^\/+|\/+$/g, "").replace(/\.git$/i, "");
@@ -661,21 +724,24 @@ function repoKeyOfRemoteUrl(remoteUrl) {
     return void 0;
   }
 }
-function resolveTreeChange(cwd, runGit2 = defaultSkipProbes.runGit) {
+function resolveTreeChange(cwd, probes = defaultSkipProbes) {
   if (!cwd) return void 0;
-  const remoteUrl = runGit2(["remote", "get-url", CHANGE_REPO_REMOTE], cwd);
-  const repo = remoteUrl ? repoKeyOfRemoteUrl(remoteUrl) : void 0;
-  const branch = runGit2(["branch", "--show-current"], cwd)?.trim();
-  return repo && branch ? { repo, branch } : void 0;
+  const writtenUrl = readRemoteUrl(cwd, CHANGE_REPO_REMOTE, probes.readTextFile);
+  const writtenRepo = writtenUrl ? repoKeyOfRemoteUrl(writtenUrl) : void 0;
+  const remoteUrl = writtenRepo ? null : probes.runGit(["remote", "get-url", CHANGE_REPO_REMOTE], cwd);
+  const repo = writtenRepo ?? (remoteUrl ? repoKeyOfRemoteUrl(remoteUrl) : void 0);
+  if (!repo) return void 0;
+  const branch = (readCurrentBranch(cwd, probes.readTextFile) ?? probes.runGit(["branch", "--show-current"], cwd))?.trim();
+  return branch ? { repo, branch } : void 0;
 }
-function resolveOpenedPrChange(command, prUrl, cwd, runGit2 = defaultSkipProbes.runGit) {
+function resolveOpenedPrChange(command, prUrl, cwd, probes = defaultSkipProbes) {
   const repo = repoKeyOfPrUrl(prUrl);
   if (!repo) return void 0;
   const openAt = command.search(PR_OPEN_COMMAND);
   const headFlag = openAt < 0 ? null : command.slice(openAt).match(PR_HEAD_BRANCH_FLAG);
   if (headFlag) return { repo, branch: headFlag[1].slice(headFlag[1].lastIndexOf(":") + 1) };
   if (DIRECTORY_CHANGE_COMMAND.test(command)) return void 0;
-  const treeChange = resolveTreeChange(cwd, runGit2);
+  const treeChange = resolveTreeChange(cwd, probes);
   return treeChange?.repo === repo ? treeChange : void 0;
 }
 function isSameChange(left, right) {
@@ -2378,8 +2444,7 @@ var verifyDevServerUnreachable = (context, detail) => {
 };
 var verifyEmptyDiff = (context) => {
   if (!context.cwd) return refuted("no working directory was available to inspect");
-  const head = context.probe.runGit(["symbolic-ref", "refs/remotes/origin/HEAD", "--short"], context.cwd);
-  const base = head?.trim();
+  const base = (readRemoteHeadBranch(context.cwd, BASE_REMOTE, context.probe.readTextFile) ?? context.probe.runGit(["symbolic-ref", `refs/remotes/${BASE_REMOTE}/HEAD`, "--short"], context.cwd))?.trim();
   if (!base) return refuted("the repo's base branch could not be resolved");
   const diff = context.probe.runGit(["diff", `${base}...HEAD`, "--stat"], context.cwd);
   if (diff === null) return refuted("the diff against the base branch could not be read");