error-mom 0.7.0 → 0.7.2

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/README.md

@@ -1,14 +1,105 @@
 # error-mom
 
-Agent-first CLI and MCP tools for a self-hosted Error Mom incident desk.
+Agent-first CLI and MCP tools for a self-hosted [Error Mom](https://github.com/KenKaiii/error-mom) deployment.
+
+## Install and authenticate
 
 ```bash
 npm install --global error-mom
 error-mom login https://errors.example.com --token "$ERROR_MOM_ADMIN_TOKEN"
+```
+
+Login stores the server URL and private admin token in `~/.error-mom/config.json` with private file permissions. You can instead set `ERROR_MOM_SERVER` and `ERROR_MOM_ADMIN_TOKEN`.
+
+## Connect an app
+
+Run this from the app you want to monitor:
+
+```bash
+error-mom init
+```
+
+`init` creates or reuses a project, installs `@kenkaiiii/error-mom`, generates a setup file, detects the framework, and returns exact wiring instructions. For a pnpm or Yarn workspace, use `error-mom init --skip-install` and install the SDK with the workspace package manager.
+
+The generated project key is write-only and safe to commit or ship. It can submit events but cannot read issues, manage projects, or upload source maps. Keep the admin token private.
+
+Verify health and ingestion with the exact `error-mom doctor --project-key ...` command printed by `init`. Synthetic doctor events are validated but never stored as issues.
+
+## Work with projects and issues
+
+```bash
 error-mom projects
 error-mom issues
+error-mom issues --project <project-id>
+error-mom issues --status observed
 error-mom inspect <issue-id>
+error-mom inspect <issue-id> --samples 5
 error-mom resolve <issue-id> --release 1.4.2
 ```
 
-Run `error-mom mcp` as a stdio MCP server. It exposes `list_projects`, `list_issues`, `get_issue`, and `resolve_issue`.
+Operational quota and transient failures plus low-volume tool failures begin in `observed` status and promote to `open` after three occurrences. The default unresolved list returns `open` and `regressed` issues; request `--status observed` to inspect low-volume noise. Resolved issues stay hidden by default. If the same issue returns in the fixed release or a newer release, Error Mom marks it as regressed.
+
+Permanently deleting a project also deletes its issues, samples, ingest keys, and receipts:
+
+```bash
+error-mom delete-project <project-id>
+```
+
+## Source maps
+
+Upload source maps immediately after a production build. The release must exactly match the release reported by the SDK.
+
+```bash
+error-mom sourcemaps <build-directory> \
+  --release <app-version> \
+  --project <project-slug>
+```
+
+The command discovers JavaScript/source-map pairs and warns about missing `sourcesContent` or release mismatches. Uploads require the admin token; project ingest keys are rejected.
+
+Test symbolication without storing an event or map:
+
+```bash
+error-mom doctor --symbolication
+```
+
+## MCP server
+
+Run `error-mom mcp` as a stdio MCP server. It exposes:
+
+- `list_projects`
+- `list_issues`
+- `get_issue`
+- `resolve_issue`
+- `check_symbolication`
+- `delete_project`
+
+Example client configuration:
+
+```json
+{
+  "mcpServers": {
+    "error-mom": {
+      "command": "error-mom",
+      "args": ["mcp"],
+      "env": {
+        "ERROR_MOM_SERVER": "https://errors.example.com",
+        "ERROR_MOM_ADMIN_TOKEN": "set-this-in-your-secret-store"
+      }
+    }
+  }
+}
+```
+
+Prefer your MCP client's secure environment or secret configuration instead of committing the admin token.
+
+## Command help
+
+```bash
+error-mom --help
+error-mom <command> --help
+```
+
+Operational commands write machine-readable JSON to stdout, making the CLI suitable for coding agents and automation.
+
+See the [repository README](https://github.com/KenKaiii/error-mom#readme) for deployment, SDK, framework, dashboard, and security instructions.

package/dist/cli.js

@@ -63,7 +63,7 @@ async function findBuildFiles(dir) {
 }
 
 // src/cli.ts
-var VERSION = "0.7.0";
+var VERSION = "0.7.2";
 var CONFIG_DIR = join2(homedir(), ".error-mom");
 var CONFIG_FILE = join2(CONFIG_DIR, "config.json");
 function slugifyName(value) {
@@ -89,7 +89,11 @@ program.command("projects").description("List every project and unresolved issue
   const config = await loadConfig();
   print(await request(config.server, config.adminToken, "/api/v1/projects"));
 });
-program.command("issues").description("List compact issue summaries; unresolved issues are returned by default").option("--project <id>", "Filter by project ID").option("--status <status>", "unresolved, open, regressed, resolved, or all", "unresolved").action(async (options) => {
+program.command("issues").description("List compact issue summaries; unresolved issues are returned by default").option("--project <id>", "Filter by project ID").option(
+  "--status <status>",
+  "unresolved, observed, open, regressed, resolved, or all",
+  "unresolved"
+).action(async (options) => {
   const config = await loadConfig();
   const query = new URLSearchParams({ status: options.status });
   if (options.project) query.set("projectId", options.project);
@@ -281,7 +285,7 @@ async function runMcpServer() {
       description: "List compact issues. Defaults to unresolved so fixed work does not consume context.",
       inputSchema: {
         projectId: z.string().optional(),
-        status: z.enum(["unresolved", "open", "regressed", "resolved", "all"]).default("unresolved")
+        status: z.enum(["unresolved", "observed", "open", "regressed", "resolved", "all"]).default("unresolved")
       }
     },
     async ({ projectId, status }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-mom",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Agent-first CLI and MCP tools for self-hosted Error Mom",
   "type": "module",
   "bin": {
@@ -11,11 +11,6 @@
     "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",
@@ -28,5 +23,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts --clean",
+    "check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}