@muggleai/works 4.10.0 → 4.10.1

package/README.md

@@ -19,7 +19,7 @@ Your AI assistant writes code fast. But does the feature actually work? Does the
 
 muggle-ai-works closes the gap between "code complete" and "actually works."
 
-- **Catch UX regressions before your users do** — AI drives a real browser against your localhost across desktop and mobile resolutions, clicks through flows like a user would, and reports failures with step-by-step screenshots. No Playwright scripts to maintain.
+- **Catch UX regressions before your users do** — `/muggle:muggle-test` AI drives a real browser against your localhost across desktop and mobile resolutions, clicks through flows like a user would, and reports failures with step-by-step screenshots. No Playwright scripts to maintain.
 - **Go from requirement to merged PR in one command** — `/muggle:muggle-do` handles the full cycle: code the feature, run unit tests, run E2E acceptance tests against the app in a real browser at multiple viewports, triage failures, and open a PR with evidence attached.
 - **70+ MCP tools for custom workflows** — manage projects, generate test cases from plain English, replay test scripts, batch-run regressions, and publish results to your team. Works in Claude Code, Cursor, and any MCP client.
 
@@ -27,7 +27,7 @@ muggle-ai-works closes the gap between "code complete" and "actually works."
 
 ## Quick Start
 
-### 1. Install (choose your client)
+### 1. Install skills and mcps (choose your client)
 
 **Claude Code (full plugin experience)**
 
@@ -613,4 +613,4 @@ See `internal/skills/optimize-descriptions/SKILL.md` for the full guide.
 
 [MIT](LICENSE) — Use it, fork it, make it yours.
 
-If this helps your development workflow, consider giving it a star. It helps others find it.
+If this helps your development workflow, consider giving it a star. It helps others find it.

package/dist/{chunk-RK6XKSZK.js → chunk-Q7WNEMN4.js}

@@ -1,4 +1,4 @@
-import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, isFirstRun, writePreferences, DEFAULT_PREFERENCES, getDataDir, PREFERENCES_FILE_NAME, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, verifyFileChecksum, calculateFileChecksum, getQaTools, getLocalQaTools, performLogout, performLogin, toolRequiresAuth, getCallerCredentials, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require } from './chunk-UVXOHXY2.js';
+import { __export, getLogger, getConfig, createChildLogger, buildElectronAppReleaseAssetUrl, getAuthService, hasApiKey, getElectronAppVersion, getElectronAppDir, getPlatformKey, isFirstRun, writePreferences, DEFAULT_PREFERENCES, getDataDir, PREFERENCES_FILE_NAME, isElectronAppInstalled, getElectronAppChecksums, getChecksumForPlatform, verifyFileChecksum, calculateFileChecksum, initTelemetry, Surface, ServiceName, track, EventName, getQaTools, getLocalQaTools, performLogout, performLogin, toolRequiresAuth, getCallerCredentials, getBundledElectronAppVersion, getElectronAppVersionSource, getCredentialsFilePath, buildElectronAppChecksumsUrl, __require } from './chunk-ZKRHFTIC.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { v4 } from 'uuid';
@@ -6,7 +6,7 @@ import { z, ZodError } from 'zod';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import * as fs from 'fs';
 import { readFileSync, existsSync, rmSync, mkdirSync, readdirSync, createWriteStream, writeFileSync, statSync } from 'fs';
-import * as path4 from 'path';
+import * as path from 'path';
 import { dirname, resolve, join } from 'path';
 import { fileURLToPath } from 'url';
 import { Command } from 'commander';
@@ -338,10 +338,31 @@ function countTests(report) {
   const total = report.tests.length;
   const passed = report.tests.filter((t) => t.status === "passed").length;
   const failed = report.tests.filter((t) => t.status === "failed").length;
-  return { total, passed, failed };
+  const inconclusive = report.tests.filter((t) => t.status === "inconclusive").length;
+  return { total, passed, failed, inconclusive };
 }
 function statusEmoji(test) {
-  return test.status === "passed" ? "\u2705" : "\u274C";
+  if (test.status === "passed") return "\u2705";
+  if (test.status === "failed") return "\u274C";
+  return "\u26A0\uFE0F";
+}
+function computeVerdict(report) {
+  if (report.tests.length === 0) return "none";
+  if (report.tests.some((t) => t.status === "failed")) return "fail";
+  if (report.tests.some((t) => t.status === "inconclusive")) return "inconclusive";
+  return "pass";
+}
+function renderVerdictLine(verdict) {
+  switch (verdict) {
+    case "pass":
+      return "**Verdict: \u2705 PASS**";
+    case "fail":
+      return "**Verdict: \u274C FAIL**";
+    case "inconclusive":
+      return "**Verdict: \u26A0\uFE0F INCONCLUSIVE**";
+    case "none":
+      return null;
+  }
 }
 function endingScreenshot(test) {
   if (test.steps.length === 0) {
@@ -360,6 +381,9 @@ function defaultEndingCaption(test) {
   if (test.status === "failed") {
     return `Failure at step ${test.failureStepIndex}`;
   }
+  if (test.status === "inconclusive") {
+    return "Last frame before run was cut short";
+  }
   return "Final page after the test completed";
 }
 function endingFrame(test) {
@@ -392,12 +416,14 @@ function buildTestNumbering(report) {
   return map;
 }
 function renderOverview(report) {
-  const { total, passed, failed } = countTests(report);
-  const lines = [
-    "## E2E Acceptance Results",
-    "",
-    `**${total} tests ran \u2014 ${passed} passed / ${failed} failed**`
-  ];
+  const { total, passed, failed, inconclusive } = countTests(report);
+  const verdict = computeVerdict(report);
+  const verdictLine = renderVerdictLine(verdict);
+  const lines = ["## E2E Acceptance Results", ""];
+  if (verdictLine) {
+    lines.push(verdictLine, "");
+  }
+  lines.push(`**${total} tests ran \u2014 ${passed} passed / ${failed} failed / ${inconclusive} inconclusive**`);
   if (total === 0) {
     lines.push("", "_No tests were executed._");
     return lines.join("\n");
@@ -458,12 +484,12 @@ ${body.join("\n")}
 </details>`;
 }
 function renderSummaryLine(test, testNumber) {
-  const base = `<b>${testNumber}. ${test.name}</b> ${statusEmoji(test)}`;
-  const tail = " <i>\u25B6 click to expand</i>";
+  const base = `<b>${test.name}</b> ${statusEmoji(test)}`;
+  const head = "<i>\u25B6 click to expand</i> ";
   if (test.description) {
-    return `${base} \u2014 ${test.description}${tail}`;
+    return `<b>${testNumber}. </b>${head}${base} \u2014 ${test.description}`;
   }
-  return `${base}${tail}`;
+  return `<b>${testNumber}. </b>${head}${base}`;
 }
 function renderEndingFrame(test) {
   const frame = endingFrame(test);
@@ -481,12 +507,15 @@ function renderResultSummary(test, projectId) {
   const lines = [];
   if (test.status === "passed") {
     lines.push(`**Result:** \u2705 PASSED`);
-  } else {
+  } else if (test.status === "failed") {
     lines.push(`**Result:** \u274C FAILED at step ${test.failureStepIndex}`);
     lines.push(`**Error:** \`${safeInlineCode(test.error)}\``);
+  } else {
+    lines.push(`**Result:** \u26A0\uFE0F INCONCLUSIVE`);
+    lines.push(`**Reason:** \`${safeInlineCode(test.reason)}\``);
   }
   lines.push(`**Steps:** ${test.steps.length}`);
-  lines.push(`[View steps on Muggle AI \u2192](${dashboardUrl})`);
+  lines.push(`<a href="${dashboardUrl}" target="_blank" rel="noopener noreferrer">View steps on Muggle AI \u2192</a>`);
   return lines;
 }
 function renderBody(report, opts) {
@@ -577,9 +606,25 @@ var FailedTestSchema = z.object({
   endingScreenshotUrl: z.string().url().optional(),
   endingScreenshotCaption: z.string().min(1).optional()
 });
+var InconclusiveTestSchema = z.object({
+  name: z.string().min(1),
+  testCaseId: z.string().min(1),
+  testScriptId: z.string().min(1).optional(),
+  runId: z.string().min(1),
+  viewUrl: z.string().url(),
+  status: z.literal("inconclusive"),
+  steps: z.array(StepSchema),
+  reason: z.string().min(1),
+  artifactsDir: z.string().min(1).optional(),
+  useCaseName: z.string().min(1).optional(),
+  description: z.string().min(1).optional(),
+  endingScreenshotUrl: z.string().url().optional(),
+  endingScreenshotCaption: z.string().min(1).optional()
+});
 var TestResultSchema = z.discriminatedUnion("status", [
   PassedTestSchema,
-  FailedTestSchema
+  FailedTestSchema,
+  InconclusiveTestSchema
 ]);
 var E2eReportSchema = z.object({
   projectId: z.string().min(1),
@@ -686,7 +731,7 @@ async function resolveGsScreenshotUrls(report, opts) {
     if (gsUrls.length === 0) {
       return report;
     }
-    const mcps = await import('./src-GD3YFCCW.js');
+    const mcps = await import('./src-2G7ENRGI.js');
     const credentials = await mcps.getCallerCredentialsAsync();
     if (!credentials.bearerToken && !credentials.apiKey) {
       stderrWrite(
@@ -805,15 +850,28 @@ var ELECTRON_APP_DIR = "electron-app";
 var CURSOR_SKILLS_DIR = ".cursor";
 var CURSOR_SKILLS_SUBDIR = "skills";
 var MUGGLE_SKILL_PREFIX = "muggle";
+function loadMuggleAliasSkills() {
+  let dir = path.dirname(fileURLToPath(import.meta.url));
+  while (dir !== path.dirname(dir)) {
+    const manifestPath = path.join(dir, "plugin", "skills", "_aliases.json");
+    if (existsSync(manifestPath)) {
+      const parsed = JSON.parse(readFileSync(manifestPath, "utf-8"));
+      return new Set(parsed.aliases);
+    }
+    dir = path.dirname(dir);
+  }
+  throw new Error("Could not locate plugin/skills/_aliases.json relative to cleanup module");
+}
+var MUGGLE_ALIAS_SKILLS = loadMuggleAliasSkills();
 var INSTALL_MANIFEST_FILE = "install-manifest.json";
 function getElectronAppBaseDir() {
-  return path4.join(getDataDir(), ELECTRON_APP_DIR);
+  return path.join(getDataDir(), ELECTRON_APP_DIR);
 }
 function getCursorSkillsDir() {
-  return path4.join(homedir(), CURSOR_SKILLS_DIR, CURSOR_SKILLS_SUBDIR);
+  return path.join(homedir(), CURSOR_SKILLS_DIR, CURSOR_SKILLS_SUBDIR);
 }
 function getInstallManifestPath() {
-  return path4.join(getDataDir(), INSTALL_MANIFEST_FILE);
+  return path.join(getDataDir(), INSTALL_MANIFEST_FILE);
 }
 function readInstallManifest() {
   const manifestPath = getInstallManifestPath();
@@ -845,13 +903,13 @@ function listObsoleteSkills() {
       if (!entry.isDirectory()) {
         continue;
       }
-      if (!entry.name.startsWith(MUGGLE_SKILL_PREFIX)) {
+      if (!entry.name.startsWith(MUGGLE_SKILL_PREFIX) && !MUGGLE_ALIAS_SKILLS.has(entry.name)) {
         continue;
       }
       if (manifestSkills.has(entry.name)) {
         continue;
       }
-      const skillPath = path4.join(skillsDir, entry.name);
+      const skillPath = path.join(skillsDir, entry.name);
       const sizeBytes = getDirectorySize(skillPath);
       obsoleteSkills.push({
         name: entry.name,
@@ -897,7 +955,7 @@ function getDirectorySize(dirPath) {
   try {
     const entries = readdirSync(dirPath, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path4.join(dirPath, entry.name);
+      const fullPath = path.join(dirPath, entry.name);
       if (entry.isDirectory()) {
         totalSize += getDirectorySize(fullPath);
       } else if (entry.isFile()) {
@@ -950,7 +1008,7 @@ function listInstalledVersions() {
       if (!/^\d+\.\d+\.\d+$/.test(entry.name)) {
         continue;
       }
-      const versionPath = path4.join(baseDir, entry.name);
+      const versionPath = path.join(baseDir, entry.name);
       const sizeBytes = getDirectorySize(versionPath);
       versions.push({
         version: entry.name,
@@ -1106,11 +1164,11 @@ function getExpectedExecutablePath(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path4.join(versionDir, "MuggleAI.exe");
+      return path.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path4.join(versionDir, "MuggleAI");
+      return path.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -1119,7 +1177,7 @@ function verifyElectronAppInstallation() {
   const version = getElectronAppVersion();
   const versionDir = getElectronAppDir(version);
   const executablePath = getExpectedExecutablePath(versionDir);
-  const metadataPath = path4.join(versionDir, ".install-metadata.json");
+  const metadataPath = path.join(versionDir, ".install-metadata.json");
   const result = {
     valid: false,
     versionDir,
@@ -1591,6 +1649,14 @@ async function serveCommand(options) {
     enableLocal,
     transport: "stdio"
   });
+  try {
+    initTelemetry({ serviceName: ServiceName.MuggleMcp, surface: Surface.McpLocal });
+    track({ name: EventName.SystemStartup, props: { serviceName: ServiceName.MuggleMcp } });
+  } catch (err) {
+    logger5.warn("Telemetry init skipped", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
   try {
     if (enableQa) {
       const qaTools = getQaTools();
@@ -1640,11 +1706,11 @@ function getExpectedExecutablePath2(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path4.join(versionDir, "MuggleAI.exe");
+      return path.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path4.join(versionDir, "MuggleAI");
+      return path.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -1741,8 +1807,8 @@ function cleanupFailedInstall(versionDir) {
   }
 }
 function upsertCursorMcpConfig() {
-  const cursorMcpConfigPath = path4.join(homedir(), ".cursor", "mcp.json");
-  const cursorDir = path4.join(homedir(), ".cursor");
+  const cursorMcpConfigPath = path.join(homedir(), ".cursor", "mcp.json");
+  const cursorDir = path.join(homedir(), ".cursor");
   let config = {};
   if (existsSync(cursorMcpConfigPath)) {
     try {
@@ -1779,7 +1845,7 @@ async function setupCommand(options) {
   upsertCursorMcpConfig();
   if (isFirstRun()) {
     writePreferences(DEFAULT_PREFERENCES, "global");
-    console.log(`Default preferences written to ${path4.join(getDataDir(), PREFERENCES_FILE_NAME)}`);
+    console.log(`Default preferences written to ${path.join(getDataDir(), PREFERENCES_FILE_NAME)}`);
     console.log("All preferences default to 'ask'. You can customize them anytime by editing the file or telling the agent to change a preference.");
   }
   if (!options.force && isElectronAppInstalled()) {
@@ -1799,7 +1865,7 @@ async function setupCommand(options) {
       rmSync(versionDir, { recursive: true, force: true });
     }
     mkdirSync(versionDir, { recursive: true });
-    const tempFile = path4.join(versionDir, binaryName);
+    const tempFile = path.join(versionDir, binaryName);
     await downloadWithRetry(downloadUrl, tempFile);
     console.log("Download complete, verifying checksum...");
     const checksums = getElectronAppChecksums();
@@ -1835,7 +1901,7 @@ The archive may be corrupted or in an unexpected format.`
       );
     }
     const executableChecksum = await calculateFileChecksum(executablePath);
-    const metadataPath = path4.join(versionDir, INSTALL_METADATA_FILE_NAME);
+    const metadataPath = path.join(versionDir, INSTALL_METADATA_FILE_NAME);
     writeInstallMetadata({
       metadataPath,
       version,
@@ -1877,7 +1943,7 @@ function extractVersionFromTag(tag) {
   return match ? match[1] : null;
 }
 function getVersionOverridePath() {
-  return path4.join(getDataDir(), VERSION_OVERRIDE_FILE);
+  return path.join(getDataDir(), VERSION_OVERRIDE_FILE);
 }
 function getEffectiveElectronAppVersion() {
   const overridePath = getVersionOverridePath();
@@ -1965,11 +2031,11 @@ function getExpectedExecutablePath3(versionDir) {
   const os = platform();
   switch (os) {
     case "darwin":
-      return path4.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
+      return path.join(versionDir, "MuggleAI.app", "Contents", "MacOS", "MuggleAI");
     case "win32":
-      return path4.join(versionDir, "MuggleAI.exe");
+      return path.join(versionDir, "MuggleAI.exe");
     case "linux":
-      return path4.join(versionDir, "MuggleAI");
+      return path.join(versionDir, "MuggleAI");
     default:
       throw new Error(`Unsupported platform: ${os}`);
   }
@@ -2081,7 +2147,7 @@ async function downloadAndInstall(version, downloadUrl, checksum) {
   if (!response.ok) {
     throw new Error(`Download failed: ${response.status} ${response.statusText}`);
   }
-  const tempFile = path4.join(versionDir, binaryName);
+  const tempFile = path.join(versionDir, binaryName);
   const fileStream = createWriteStream(tempFile);
   if (!response.body) {
     throw new Error("No response body");
@@ -2123,7 +2189,7 @@ The archive may be corrupted or in an unexpected format.`
     );
   }
   const executableChecksum = await calculateFileChecksum(executablePath);
-  const metadataPath = path4.join(versionDir, INSTALL_METADATA_FILE_NAME2);
+  const metadataPath = path.join(versionDir, INSTALL_METADATA_FILE_NAME2);
   writeInstallMetadata2({
     metadataPath,
     version,