error-mom 0.5.0 → 0.7.0

package/dist/cli.js

@@ -2,17 +2,73 @@
 
 // src/cli.ts
 import { execFileSync } from "child_process";
-import { chmod, mkdir, readFile, readdir, stat, writeFile } from "fs/promises";
+import { chmod, mkdir, readFile as readFile2, stat, writeFile } from "fs/promises";
 import { existsSync } from "fs";
 import { homedir } from "os";
-import { basename, join } from "path";
+import { basename as basename2, join as join2 } from "path";
 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 CONFIG_DIR = join(homedir(), ".error-mom");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+
+// src/sourcemap-files.ts
+import { readFile, readdir } from "fs/promises";
+import { basename, dirname, join } from "path";
+async function associateMaps(dir) {
+  const { jsFiles, mapFiles } = await findBuildFiles(dir);
+  const associations = /* @__PURE__ */ new Map();
+  const referencedMaps = /* @__PURE__ */ new Set();
+  for (const jsFile of jsFiles) {
+    const contents = await readFile(jsFile, "utf8");
+    const matches = [...contents.matchAll(/\/\/[#@] sourceMappingURL=([^\s'"]+)/g)];
+    const reference = matches[matches.length - 1]?.[1];
+    if (!reference || reference.startsWith("data:")) continue;
+    const mapFile = join(dirname(jsFile), decodeURIComponent(reference));
+    if (!mapFiles.includes(mapFile)) continue;
+    const fileName = basename(jsFile);
+    referencedMaps.add(mapFile);
+    associations.set(`${mapFile}\0${fileName}`, { mapFile, fileName });
+  }
+  for (const mapFile of mapFiles) {
+    if (referencedMaps.has(mapFile)) continue;
+    associations.set(`${mapFile}\0`, {
+      mapFile,
+      fileName: basename(mapFile).replace(/\.map$/, "")
+    });
+  }
+  return [...associations.values()].sort((a, b) => a.fileName.localeCompare(b.fileName));
+}
+async function findBuildFiles(dir) {
+  const jsFiles = [];
+  const mapFiles = [];
+  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") {
+      const nested = await findBuildFiles(fullPath);
+      jsFiles.push(...nested.jsFiles);
+      mapFiles.push(...nested.mapFiles);
+    } else if (entry.isFile() && entry.name.endsWith(".map")) {
+      mapFiles.push(fullPath);
+    } else if (entry.isFile() && /\.(js|mjs|cjs)$/.test(entry.name)) {
+      jsFiles.push(fullPath);
+    }
+  }
+  return { jsFiles: jsFiles.sort(), mapFiles: mapFiles.sort() };
+}
+
+// src/cli.ts
+var VERSION = "0.7.0";
+var CONFIG_DIR = join2(homedir(), ".error-mom");
+var CONFIG_FILE = join2(CONFIG_DIR, "config.json");
+function slugifyName(value) {
+  return value.toLowerCase().normalize("NFKD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 64);
+}
 var program = new Command().name("error-mom").description("Query and operate a self-hosted Error Mom incident desk").version(VERSION);
 program.command("login").description("Save the URL and private admin token for one Error Mom deployment").argument("<server>", "Error Mom server URL").requiredOption("--token <token>", "ERROR_MOM_ADMIN_TOKEN value").action(async (server, options) => {
   const normalized = normalizeServer(server);
@@ -75,7 +131,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,19 +148,42 @@ 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();
   const packageJson = await readPackageJson(process.cwd());
-  const name = options.name ?? (typeof packageJson.name === "string" ? packageJson.name : basename(process.cwd()));
+  const name = options.name ?? (typeof packageJson.name === "string" ? packageJson.name : basename2(process.cwd()));
   const projectResponse = await request(
     config.server,
     config.adminToken,
     "/api/v1/projects"
   );
   let project = options.project ? projectResponse.projects.find((candidate) => candidate.slug === options.project) : projectResponse.projects.find(
-    (candidate) => candidate.name.toLowerCase() === name.toLowerCase()
+    (candidate) => candidate.name.toLowerCase() === name.toLowerCase() || candidate.slug === slugifyName(name)
   );
   if (!project) {
     const created = await request(config.server, config.adminToken, "/api/v1/projects", {
@@ -134,13 +216,14 @@ program.command("init").description("Create/select a project, install the SDK, a
 });
 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) {
+  const associations = await associateMaps(dir);
+  if (associations.length === 0) {
     throw new Error(`No .map files found under ${dir}. Build with source maps enabled first.`);
   }
   const uploaded = [];
   const skipped = [];
-  for (const mapFile of mapFiles) {
+  const warnings = [];
+  for (const { mapFile, fileName } of associations) {
     const info = await stat(mapFile);
     if (info.size > 20 * 1024 * 1024) {
       skipped.push({ file: mapFile, reason: "larger than 20 MB" });
@@ -148,12 +231,17 @@ program.command("sourcemaps").description("Upload production source maps so mini
     }
     let map;
     try {
-      map = JSON.parse(await readFile(mapFile, "utf8"));
+      map = JSON.parse(await readFile2(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 }
@@ -166,7 +254,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 +325,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",
     {
@@ -268,7 +373,7 @@ async function loadConfig() {
     };
   }
   try {
-    const config = JSON.parse(await readFile(CONFIG_FILE, "utf8"));
+    const config = JSON.parse(await readFile2(CONFIG_FILE, "utf8"));
     if (!config.server || !config.adminToken) throw new Error("Incomplete config");
     return { server: normalizeServer(config.server), adminToken: config.adminToken };
   } catch {
@@ -294,7 +399,7 @@ async function request(server, token, path, options = {}) {
 }
 async function readPackageJson(cwd) {
   try {
-    return JSON.parse(await readFile(join(cwd, "package.json"), "utf8"));
+    return JSON.parse(await readFile2(join2(cwd, "package.json"), "utf8"));
   } catch {
     throw new Error(
       "Run error-mom init from a JavaScript or TypeScript project containing package.json."
@@ -422,8 +527,8 @@ function detectFramework(packageJson) {
   };
 }
 function detectPackageManager(cwd) {
-  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync(join2(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join2(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
 function installSdk(packageManager) {
@@ -438,8 +543,8 @@ function installSdk(packageManager) {
   });
 }
 async function writeSetup(framework, server, ingestKey) {
-  const sourceDirectory = existsSync(join(process.cwd(), "src")) ? "src" : ".";
-  const relativePath = join(sourceDirectory, "error-mom.ts");
+  const sourceDirectory = existsSync(join2(process.cwd(), "src")) ? "src" : ".";
+  const relativePath = join2(sourceDirectory, "error-mom.ts");
   if (framework.id === "next") await writeNextInstrumentation(sourceDirectory, server, ingestKey);
   const environment = framework.envStyle === "next" ? "process.env.NEXT_PUBLIC_" : framework.envStyle === "vite" ? "import.meta.env.VITE_" : "process.env.";
   const moduleName = framework.envStyle === "node" ? "@kenkaiiii/error-mom/node" : "@kenkaiiii/error-mom";
@@ -458,11 +563,11 @@ export const errorMom = initErrorMom({
   ...(release ? { release } : {}),
 });
 `;
-  await writeFile(join(process.cwd(), relativePath), contents);
+  await writeFile(join2(process.cwd(), relativePath), contents);
   return relativePath;
 }
 async function writeNextInstrumentation(sourceDirectory, configuredServer, ingestKey) {
-  const file = join(process.cwd(), sourceDirectory, "instrumentation.ts");
+  const file = join2(process.cwd(), sourceDirectory, "instrumentation.ts");
   if (existsSync(file)) return;
   const contents = `import type { Instrumentation } from "next";
 
@@ -510,23 +615,30 @@ function syntheticEvent() {
     context: {}
   };
 }
-async function findMapFiles(dir) {
-  const found = [];
-  let entries;
+async function releaseMismatchWarning(config, projectIdOrSlug, release) {
   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);
+    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 [];
   }
-  return found.sort();
 }
 function normalizeServer(server) {
   return server.replace(/\/$/, "");

package/package.json

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