error-mom 0.5.0 → 0.6.0

package/dist/cli.js

@@ -10,7 +10,7 @@ import { Command } from "commander";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-var VERSION = "0.5.0";
+var VERSION = "0.6.0";
 var CONFIG_DIR = join(homedir(), ".error-mom");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 var program = new Command().name("error-mom").description("Query and operate a self-hosted Error Mom incident desk").version(VERSION);
@@ -75,7 +75,10 @@ program.command("delete-project").description("Permanently delete one project an
     )
   );
 });
-program.command("doctor").description("Verify collector health, credentials, and optional project ingestion").option("--project-key <key>", "Send and verify a synthetic event with this write-only key").action(async (options) => {
+program.command("doctor").description("Verify collector health, credentials, and optional project ingestion").option("--project-key <key>", "Send and verify a synthetic event with this write-only key").option(
+  "--symbolication",
+  "Round-trip a synthetic minified stack through the server's symbolication engine"
+).action(async (options) => {
   const config = await loadConfig();
   const health = await request(config.server, void 0, "/api/health");
   const projects = await request(config.server, config.adminToken, "/api/v1/projects");
@@ -89,7 +92,30 @@ program.command("doctor").description("Verify collector health, credentials, and
       }
     });
   }
-  print({ healthy: true, health, projects, ingestion });
+  let symbolication = "not tested";
+  if (options.symbolication) {
+    const result = await request(config.server, config.adminToken, "/api/v1/sourcemaps/check", {
+      body: {
+        stack: "ErrorMomDoctor: synthetic minified stack\n    at t.xyz (https://app.example/assets/doctor-abc.js:1:11)",
+        fileName: "doctor-abc.js",
+        map: {
+          version: 3,
+          file: "doctor-abc.js",
+          sources: ["src/doctor-fixture.ts"],
+          names: ["doctorBoom"],
+          mappings: "UAIEA"
+        }
+      }
+    });
+    const roundTripped = result.symbolicated === true && typeof result.stack === "string" && result.stack.includes("doctorBoom (src/doctor-fixture.ts:5:3)");
+    if (!roundTripped) {
+      throw new Error(
+        `Symbolication round-trip failed: expected the synthetic frame to rewrite to src/doctor-fixture.ts:5:3, got ${JSON.stringify(result)}`
+      );
+    }
+    symbolication = { verified: true, rewrittenFrame: "doctorBoom (src/doctor-fixture.ts:5:3)" };
+  }
+  print({ healthy: true, health, projects, ingestion, symbolication });
 });
 program.command("init").description("Create/select a project, install the SDK, and generate framework-aware setup").option("--name <name>", "Project name").option("--project <slug>", "Use an existing project slug").option("--skip-install", "Generate setup without invoking the package manager").action(async (options) => {
   const config = await loadConfig();
@@ -140,6 +166,7 @@ program.command("sourcemaps").description("Upload production source maps so mini
   }
   const uploaded = [];
   const skipped = [];
+  const warnings = [];
   for (const mapFile of mapFiles) {
     const info = await stat(mapFile);
     if (info.size > 20 * 1024 * 1024) {
@@ -154,6 +181,12 @@ program.command("sourcemaps").description("Upload production source maps so mini
       continue;
     }
     const fileName = basename(mapFile).replace(/\.map$/, "");
+    const sourcesContent = map.sourcesContent;
+    if (!Array.isArray(sourcesContent) || sourcesContent.every((entry) => entry == null)) {
+      warnings.push(
+        `${fileName}: no sourcesContent \u2014 frames still symbolicate to file:line, but agents cannot read the original code from the map. Enable it in the bundler if you want richer context.`
+      );
+    }
     try {
       await request(config.server, config.adminToken, "/api/v1/sourcemaps", {
         body: { projectId: options.project, release: options.release, fileName, map }
@@ -166,7 +199,8 @@ program.command("sourcemaps").description("Upload production source maps so mini
       });
     }
   }
-  print({ release: options.release, project: options.project, uploaded, skipped });
+  warnings.push(...await releaseMismatchWarning(config, options.project, options.release));
+  print({ release: options.release, project: options.project, uploaded, skipped, warnings });
 });
 program.command("mcp").description("Run Error Mom tools over MCP stdio for coding agents").action(async () => {
   await runMcpServer();
@@ -236,6 +270,22 @@ async function runMcpServer() {
       )
     )
   );
+  server.registerTool(
+    "check_symbolication",
+    {
+      description: "Dry-run a minified stack against a project's uploaded source maps to verify frames rewrite to original file:line. Nothing is stored.",
+      inputSchema: {
+        projectId: z.string().min(1).describe("Project id or slug"),
+        release: z.string().min(1),
+        stack: z.string().min(1).max(5e4)
+      }
+    },
+    async ({ projectId, release, stack }) => toolResult(
+      await request(config.server, config.adminToken, "/api/v1/sourcemaps/check", {
+        body: { projectId, release, stack }
+      })
+    )
+  );
   server.registerTool(
     "delete_project",
     {
@@ -510,6 +560,31 @@ function syntheticEvent() {
     context: {}
   };
 }
+async function releaseMismatchWarning(config, projectIdOrSlug, release) {
+  try {
+    const { projects } = await request(config.server, config.adminToken, "/api/v1/projects");
+    const project = projects.find(
+      (candidate) => candidate.id === projectIdOrSlug || candidate.slug === projectIdOrSlug
+    );
+    if (!project) return [];
+    const { issues } = await request(
+      config.server,
+      config.adminToken,
+      `/api/v1/issues?${new URLSearchParams({ projectId: project.id, status: "all" })}`
+    );
+    const seenReleases = [
+      ...new Set(issues.map((issue) => issue.latestRelease).filter((value) => value !== null))
+    ];
+    if (seenReleases.length > 0 && !seenReleases.includes(release)) {
+      return [
+        `release "${release}" has not been reported by any event yet (recent releases: ${seenReleases.slice(0, 5).join(", ")}). Maps only apply when the SDK's release matches --release exactly.`
+      ];
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
 async function findMapFiles(dir) {
   const found = [];
   let entries;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-mom",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Agent-first CLI and MCP tools for self-hosted Error Mom",
   "type": "module",
   "bin": {