Audit sourcemap coverage for minified errors

Find which production errors cannot be unmangled because sourcemaps are missing, stale, or uploaded under the wrong release.

Published

difficulty intermediate · time to value 5 minutes
#errors #sourcemaps #releases #frontend #ops #sentry-alternative

Start from this 

Audit sourcemap coverage for current open client-side errors. Which cases still have minified stacks, and which release/source_url pairs need maps uploaded?

Why this matters

Minified stacks turn an easy frontend bug into archaeology. The fastest fix is often not code; it is uploading the missing .map for the right release and source URL.

What you get

  • Open client-side cases with minified frames
  • Which sourcemaps are already uploaded
  • Missing release/source URL pairs
  • A suggested upload command or CI step

Walk through it

You

Which production errors still need sourcemaps?

Agent

I’ll list client-side cases, try local unmangling, then compare against uploaded sourcemaps.

Endpoint: GET /v1/projects/:project_id/cases
Exact shape: /v1/openapi.json?path=%2Fv1%2Fprojects%2F%7Bproject_id%7D%2Fcases&method=get
Use query parameters, not a JSON body.
Query/filter concept:
  status: "open"
Endpoint: GET /v1/sourcemaps/:project_id/
Exact shape: /v1/openapi.json?path=%2Fv1%2Fsourcemaps%2F%7Bproject_id%7D%2F&method=get
Use query parameters, not a JSON body.

The output

The agent returns a punch list of missing maps. For each top case, it should include release, source URL, and whether local translation succeeded.

Setting it up

Upload sourcemaps after every frontend build. Keep release identifiers consistent between error events and uploaded artifacts.

Variations

  • “Only audit the latest release.”
  • “Generate the CI upload step for Vite.”
  • “Which cases became readable after the last sourcemap upload?”

Related playbooks

debugging 2 minutes

Find IE/Safari/old-Chrome-only crashes

Split client-side errors by browser and version. Surface fingerprints concentrated in one engine — usually older Safari or a stale Chromium.

debugging 30 seconds

Find what broke after your last deploy

Diff error fingerprints before and after the latest deploy SHA. Surface regressions in 30 seconds, including a candidate fix.

debugging 2 minutes

Diagnose a bug from the session replay, not the stack

Customer reported a checkout error. Pull their session replay, read what they did in the 60s before the error. Some bugs only make sense when you see the user's screen.

Adapt this playbook in your own agent.

Ask your agent to map the starter prompt to your saved signal map, live events, and the current HTTP API before answering.

Set up Agentry in this repo by following https://agentry.sh/install.md. I authorize you to: run its device-code login and save the key to ~/.agentry/credentials.json, read this repo, propose an instrumentation plan for my approval, and edit code after I approve it.

+ Full access
5.5 Extra High
  1. 1. Open your repo in Codex, Claude Code, Cursor etc.
  2. 2. Paste the install prompt.
  3. 3. Your agent reads the install doc and shows you an implementation plan for approval.
← all playbooks