error-mom 0.4.1 → 0.6.0

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { execFileSync } from "child_process";
-import { chmod, mkdir, readFile, writeFile } from "fs/promises";
+import { chmod, mkdir, readFile, readdir, stat, writeFile } from "fs/promises";
 import { existsSync } from "fs";
 import { homedir } from "os";
 import { basename, join } from "path";
@@ -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.4.1";
+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();
@@ -132,6 +158,50 @@ program.command("init").description("Create/select a project, install the SDK, a
     nextAction: `Wire it up: ${framework.wiring} If the app routes caught errors through a central handler or error-broadcast function, call errorMom.captureError(err) inside it \u2014 that is where framework-caught and LLM errors surface. For handlers where a framework catches errors itself (queue/cron jobs, webhooks, MCP tools), wrap each with errorMom.wrap(fn, { culprit: "<name>" }). The setup file has the write-only project key baked in (safe to commit; ERROR_MOM_* env vars override when set), so production builds report without any configuration. Then run error-mom doctor --project-key ${project.ingestKey}.`
   });
 });
+program.command("sourcemaps").description("Upload production source maps so minified stacks symbolicate on ingest").argument("<dir>", "Build output directory containing *.map files (e.g. dist)").requiredOption("--release <release>", "Release the maps belong to (must match the SDK release)").requiredOption("--project <id-or-slug>", "Project id or slug").action(async (dir, options) => {
+  const config = await loadConfig();
+  const mapFiles = await findMapFiles(dir);
+  if (mapFiles.length === 0) {
+    throw new Error(`No .map files found under ${dir}. Build with source maps enabled first.`);
+  }
+  const uploaded = [];
+  const skipped = [];
+  const warnings = [];
+  for (const mapFile of mapFiles) {
+    const info = await stat(mapFile);
+    if (info.size > 20 * 1024 * 1024) {
+      skipped.push({ file: mapFile, reason: "larger than 20 MB" });
+      continue;
+    }
+    let map;
+    try {
+      map = JSON.parse(await readFile(mapFile, "utf8"));
+    } catch {
+      skipped.push({ file: mapFile, reason: "not valid JSON" });
+      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 }
+      });
+      uploaded.push(fileName);
+    } catch (error) {
+      skipped.push({
+        file: mapFile,
+        reason: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  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();
 });
@@ -200,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",
     {
@@ -474,6 +560,49 @@ 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;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    throw new Error(`Cannot read directory ${dir}.`);
+  }
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory() && entry.name !== "node_modules") {
+      found.push(...await findMapFiles(fullPath));
+    } else if (entry.isFile() && entry.name.endsWith(".map")) {
+      found.push(fullPath);
+    }
+  }
+  return found.sort();
+}
 function normalizeServer(server) {
   return server.replace(/\/$/, "");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-mom",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Agent-first CLI and MCP tools for self-hosted Error Mom",
   "type": "module",
   "bin": {
@@ -11,6 +11,11 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts --clean",
+    "check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^15.0.0",
@@ -23,10 +28,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup src/cli.ts --format esm --dts --clean",
-    "check": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests"
-  }
-}
+  "license": "MIT"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Ken Kai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.