@debugbundle/mcp 1.1.1 → 1.3.0

package/dist/main.cjs

@@ -15094,7 +15094,7 @@ var ProjectMetricsSchema = external_exports.object({
   monthly_raw_ingested_events: external_exports.number().int().nonnegative(),
   retained_bundles: external_exports.number().int().nonnegative(),
   monthly_alert_deliveries: external_exports.number().int().nonnegative()
-}).strict();
+});
 var ProjectRecordSchema = external_exports.object({
   project_id: external_exports.string(),
   organization_id: external_exports.string(),
@@ -15111,13 +15111,13 @@ var ProjectRecordSchema = external_exports.object({
   metrics: ProjectMetricsSchema,
   created_at: external_exports.string(),
   updated_at: external_exports.string()
-}).strict();
+});
 var ProjectListResponseSchema = external_exports.object({
   projects: external_exports.array(ProjectRecordSchema)
-}).strict();
+});
 var ProjectCreateResponseSchema = external_exports.object({
   project: ProjectRecordSchema
-}).strict();
+});
 var DeletedProjectRecordSchema = external_exports.object({
   project_id: external_exports.string(),
   organization_id: external_exports.string(),
@@ -15133,10 +15133,10 @@ var DeletedProjectRecordSchema = external_exports.object({
   organization_plan: external_exports.enum(["free", "solo", "team"]),
   created_at: external_exports.string(),
   updated_at: external_exports.string()
-}).strict();
+});
 var ProjectDeleteResponseSchema = external_exports.object({
   project: DeletedProjectRecordSchema
-}).strict();
+});
 var ApiErrorResponseSchema4 = external_exports.object({
   error: external_exports.string()
 }).strict();
@@ -16501,25 +16501,74 @@ var CaptureProbeEventsSchema = external_exports.enum(CaptureProbeEventsValues);
 var RequestSignalClassificationValues = ["incident_signal", "context_signal"];
 var RequestSignalClassificationSchema = external_exports.enum(RequestSignalClassificationValues);
 var RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES = [401, 403, 409, 422];
+var HTTP_METHOD_VALUES = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 var ImmediateClientErrorStatusSchema = external_exports.number().int().min(400).max(499);
+var HttpMethodSchema = external_exports.enum(HTTP_METHOD_VALUES);
 function normalizeImmediateClientErrorStatuses(statuses) {
   return Array.from(new Set(statuses)).sort((left, right) => left - right);
 }
 var ImmediateClientErrorStatusesSchema = external_exports.array(ImmediateClientErrorStatusSchema).max(12).transform((statuses) => normalizeImmediateClientErrorStatuses(statuses));
+function normalizePathPattern(value) {
+  return value.trim().replace(/\/{2,}/g, "/");
+}
+function isValidPathPattern(value) {
+  const normalized = normalizePathPattern(value);
+  if (!normalized.startsWith("/") || normalized.includes("?") || normalized.includes("#")) {
+    return false;
+  }
+  const wildcardIndex = normalized.indexOf("*");
+  return wildcardIndex === -1 || wildcardIndex === normalized.length - 1;
+}
+function normalizeHttpMethods(methods) {
+  if (methods === void 0 || methods.length === 0) {
+    return [];
+  }
+  const normalized = methods.map((method) => method.toUpperCase()).filter(
+    (method) => HTTP_METHOD_VALUES.includes(method)
+  );
+  return Array.from(new Set(normalized)).sort();
+}
+function normalizeImmediateClientErrorPathRules(rules) {
+  const normalized = rules.map((rule) => ({
+    status_code: rule.status_code,
+    path_pattern: normalizePathPattern(rule.path_pattern),
+    methods: normalizeHttpMethods(rule.methods)
+  }));
+  const deduped = /* @__PURE__ */ new Map();
+  for (const rule of normalized) {
+    deduped.set(`${rule.status_code}:${rule.path_pattern}:${rule.methods.join(",")}`, rule);
+  }
+  return Array.from(deduped.values()).sort((left, right) => {
+    if (left.status_code !== right.status_code) return left.status_code - right.status_code;
+    const pathComparison = left.path_pattern.localeCompare(right.path_pattern);
+    if (pathComparison !== 0) return pathComparison;
+    return left.methods.join(",").localeCompare(right.methods.join(","));
+  });
+}
+var ImmediateClientErrorPathRuleSchema = external_exports.object({
+  status_code: ImmediateClientErrorStatusSchema,
+  path_pattern: external_exports.string().min(1).max(256).transform(normalizePathPattern).refine(isValidPathPattern, {
+    message: "path_pattern must start with / and may only use a terminal * wildcard"
+  }),
+  methods: external_exports.array(HttpMethodSchema).max(7).optional().default([]).transform(normalizeHttpMethods)
+});
+var ImmediateClientErrorPathRulesSchema = external_exports.array(ImmediateClientErrorPathRuleSchema).max(25).transform((rules) => normalizeImmediateClientErrorPathRules(rules));
 var ResolvedCapturePolicySchema = external_exports.object({
   preset: CapturePresetSchema,
   capture_logs: CaptureLogsSchema,
   capture_request_events: CaptureRequestEventsSchema,
   capture_breadcrumbs: CaptureBreadcrumbsSchema,
   capture_probe_events: CaptureProbeEventsSchema,
-  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema,
+  immediate_client_error_path_rules: ImmediateClientErrorPathRulesSchema.default([])
 });
 var CapturePolicyOverridesSchema = external_exports.object({
   capture_logs: CaptureLogsSchema.nullable(),
   capture_request_events: CaptureRequestEventsSchema.nullable(),
   capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable(),
   capture_probe_events: CaptureProbeEventsSchema.nullable(),
-  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable()
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable(),
+  immediate_client_error_path_rules: ImmediateClientErrorPathRulesSchema.nullable().default(null)
 });
 var CapturePolicyResponseSchema = external_exports.object({
   access_mode: external_exports.enum(["manage", "preview"]),
@@ -16534,6 +16583,7 @@ var CapturePolicySchema = external_exports.object({
   capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable(),
   capture_probe_events: CaptureProbeEventsSchema.nullable(),
   immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable(),
+  immediate_client_error_path_rules: ImmediateClientErrorPathRulesSchema.nullable().default(null),
   updated_at: external_exports.string().datetime()
 });
 var CapturePolicyUpdateSchema = external_exports.object({
@@ -16542,7 +16592,8 @@ var CapturePolicyUpdateSchema = external_exports.object({
   capture_request_events: CaptureRequestEventsSchema.nullable().optional(),
   capture_breadcrumbs: CaptureBreadcrumbsSchema.nullable().optional(),
   capture_probe_events: CaptureProbeEventsSchema.nullable().optional(),
-  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable().optional()
+  immediate_client_error_statuses: ImmediateClientErrorStatusesSchema.nullable().optional(),
+  immediate_client_error_path_rules: ImmediateClientErrorPathRulesSchema.nullable().optional()
 });
 var PRESET_DEFAULTS = {
   minimal: {
@@ -16550,30 +16601,69 @@ var PRESET_DEFAULTS = {
     capture_request_events: "failures_only",
     capture_breadcrumbs: "local_only",
     capture_probe_events: "buffer_only",
-    immediate_client_error_statuses: []
+    immediate_client_error_statuses: [],
+    immediate_client_error_path_rules: []
   },
   balanced: {
     capture_logs: "warning",
     capture_request_events: "failures_only",
     capture_breadcrumbs: "exception_only",
     capture_probe_events: "buffer_only",
-    immediate_client_error_statuses: []
+    immediate_client_error_statuses: [],
+    immediate_client_error_path_rules: []
   },
   investigative: {
     capture_logs: "info",
     capture_request_events: "all",
     capture_breadcrumbs: "standalone",
     capture_probe_events: "standalone_when_activated",
-    immediate_client_error_statuses: [...RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES]
+    immediate_client_error_statuses: [...RECOMMENDED_IMMEDIATE_CLIENT_ERROR_STATUSES],
+    immediate_client_error_path_rules: []
   }
 };
 var BALANCED_IMMEDIATE_REQUEST_STATUSES = /* @__PURE__ */ new Set([408, 423, 424, 425, 429]);
 var INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES = /* @__PURE__ */ new Set([...BALANCED_IMMEDIATE_REQUEST_STATUSES, 409]);
-var BALANCED_STANDARD_ANOMALY_STATUSES = /* @__PURE__ */ new Set([401, 403, 404, 409, 422]);
-var BALANCED_HIGH_VOLUME_ANOMALY_STATUSES = /* @__PURE__ */ new Set([400, 410]);
-var INVESTIGATIVE_ANOMALY_STATUSES = /* @__PURE__ */ new Set([...BALANCED_STANDARD_ANOMALY_STATUSES, ...BALANCED_HIGH_VOLUME_ANOMALY_STATUSES]);
+function normalizeRequestPath(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return null;
+  }
+  const path = trimmed.startsWith("http://") || trimmed.startsWith("https://") ? (() => {
+    try {
+      return new URL(trimmed).pathname;
+    } catch {
+      return trimmed;
+    }
+  })() : trimmed;
+  return (path.split(/[?#]/, 1)[0] ?? path).replace(/\/{2,}/g, "/");
+}
+function pathPatternMatches(rulePattern, requestPath) {
+  const pattern = normalizePathPattern(rulePattern);
+  if (!pattern.endsWith("*")) {
+    return requestPath === pattern;
+  }
+  const prefix = pattern.slice(0, -1);
+  return requestPath.startsWith(prefix);
+}
+function matchesImmediateClientErrorPathRule(input) {
+  const { responseStatus, immediateClientErrorPathRules = [] } = input;
+  if (responseStatus === null || !Number.isFinite(responseStatus) || immediateClientErrorPathRules.length === 0) {
+    return false;
+  }
+  const requestPath = normalizeRequestPath(input.requestPath);
+  if (requestPath === null) {
+    return false;
+  }
+  const httpMethod = typeof input.httpMethod === "string" ? input.httpMethod.toUpperCase() : null;
+  return immediateClientErrorPathRules.some(
+    (rule) => rule.status_code === responseStatus && (rule.methods.length === 0 || httpMethod !== null && rule.methods.includes(httpMethod)) && pathPatternMatches(rule.path_pattern, requestPath)
+  );
+}
 function classifyRequestStatus(input) {
-  const { responseStatus, capturePreset, immediateClientErrorStatuses = [] } = input;
+  const { responseStatus, capturePreset, immediateClientErrorStatuses = [], immediateClientErrorPathRules = [] } = input;
   if (responseStatus === null || !Number.isFinite(responseStatus)) {
     return "context_signal";
   }
@@ -16583,6 +16673,14 @@ function classifyRequestStatus(input) {
   if (immediateClientErrorStatuses.includes(responseStatus)) {
     return "incident_signal";
   }
+  if (matchesImmediateClientErrorPathRule({
+    responseStatus,
+    requestPath: input.requestPath,
+    httpMethod: input.httpMethod,
+    immediateClientErrorPathRules
+  })) {
+    return "incident_signal";
+  }
   if (capturePreset === "investigative") {
     return INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES.has(responseStatus) ? "incident_signal" : "context_signal";
   }
@@ -16592,35 +16690,103 @@ function classifyRequestStatus(input) {
   return "context_signal";
 }
 function getRequestAnomalyThreshold(input) {
-  const { responseStatus, capturePreset } = input;
+  const { responseStatus } = input;
   if (responseStatus === null || !Number.isFinite(responseStatus) || responseStatus < 400 || responseStatus >= 500) {
     return null;
   }
-  if (capturePreset === "minimal") {
-    return null;
+  return null;
+}
+
+// ../../packages/shared-types/src/request-failure-noise.ts
+function isLowValueExternalProbeRequestFailure404(input) {
+  if (input.responseStatus !== 404 || input.httpMethod.toUpperCase() !== "GET") {
+    return false;
   }
-  if (capturePreset === "investigative") {
-    return INVESTIGATIVE_ANOMALY_STATUSES.has(responseStatus) ? {
-      minimum_occurrences_5m: 8,
-      minimum_ratio_5m_to_1h: 2
-    } : null;
+  const normalizedRoute = input.routeTemplate.toLowerCase().replace(/\/+$/, "") || "/";
+  const normalizedPath = normalizePath(input.requestPath ?? input.routeTemplate);
+  const routesToCheck = /* @__PURE__ */ new Set([normalizedRoute, normalizedPath]);
+  for (const route of routesToCheck) {
+    if (isRouteOnlyExternalProbe(route)) {
+      return true;
+    }
   }
-  if (BALANCED_STANDARD_ANOMALY_STATUSES.has(responseStatus)) {
-    return {
-      minimum_occurrences_5m: 20,
-      minimum_ratio_5m_to_1h: 3
-    };
+  return isDirectIpRequest(input.headers ?? null) && [...routesToCheck].some(isGenericDirectIpProbeRoute);
+}
+function normalizePath(path) {
+  const withoutQuery = path.split("?")[0] ?? path;
+  return withoutQuery.toLowerCase().replace(/\/+$/, "") || "/";
+}
+function isRouteOnlyExternalProbe(normalizedRoute) {
+  const exactRoutes = /* @__PURE__ */ new Set([
+    "/.env",
+    "/__debug__/render_panel",
+    "/actuator",
+    "/autodiscover/autodiscover.json",
+    "/developmentserver/metadatauploader",
+    "/cpanel",
+    "/favicon.ico",
+    "/geoserver/web",
+    "/hnap1",
+    "/logon/logonpoint/index.html",
+    "/owa/auth/logon.aspx",
+    "/robots.txt",
+    "/rdweb/pages",
+    "/web",
+    "/webclient/login.xhtml",
+    "/webconsole",
+    "/webui",
+    "/whm",
+    "/wp-admin",
+    "/wp-login.php",
+    "/wsman",
+    "/xmlrpc.php"
+  ]);
+  if (exactRoutes.has(normalizedRoute)) {
+    return true;
   }
-  if (BALANCED_HIGH_VOLUME_ANOMALY_STATUSES.has(responseStatus)) {
-    return {
-      minimum_occurrences_5m: 50,
-      minimum_ratio_5m_to_1h: 5
-    };
+  return normalizedRoute.includes("/.git/") || normalizedRoute.includes("/.svn/") || normalizedRoute.includes("/api_keys") || normalizedRoute.includes("/backup/api_keys") || normalizedRoute.includes("/phpmyadmin") || normalizedRoute.includes("/pma/") || normalizedRoute.includes("/vendor/phpunit/") || normalizedRoute.startsWith("/autodiscover/") || normalizedRoute.startsWith("/cgi-bin/") || normalizedRoute.startsWith("/ecp/") || normalizedRoute.endsWith("/.git/config") || normalizedRoute.endsWith("/composer.json") || normalizedRoute.endsWith("/composer.lock") || normalizedRoute.endsWith("/package-lock.json") || normalizedRoute.endsWith("/package.json") || normalizedRoute.endsWith("/server-status") || normalizedRoute.includes("wp-config") || normalizedRoute.startsWith("/owa/") || normalizedRoute.startsWith("/rdweb/") || normalizedRoute.startsWith("/vpn/") || normalizedRoute.startsWith("/wp-") || isSensitiveBackupFileProbe(normalizedRoute);
+}
+function isSensitiveBackupFileProbe(normalizedRoute) {
+  if (!/\.(?:bak|backup|dump|old|orig|save|sql|swp|tar|tar\.gz|zip)$/.test(normalizedRoute)) {
+    return false;
+  }
+  return /(?:^|\/|\.)(?:backup|config|database|db|dump|env|secret|site|www|wp-config)(?:\/|\.|_|-|$)/.test(normalizedRoute);
+}
+function isGenericDirectIpProbeRoute(normalizedRoute) {
+  return [
+    "/admin",
+    "/administrator",
+    "/login",
+    "/logincheck",
+    "/remote/logincheck"
+  ].includes(normalizedRoute);
+}
+function isDirectIpRequest(headers) {
+  if (headers === null) {
+    return false;
+  }
+  const host = readHeader(headers, "x-forwarded-host") ?? readHeader(headers, "host");
+  if (host === null) {
+    return false;
+  }
+  return isIpLikeHost(host);
+}
+function readHeader(headers, name) {
+  const direct = headers[name] ?? headers[name.toLowerCase()];
+  if (typeof direct === "string") {
+    return direct;
+  }
+  if (Array.isArray(direct) && typeof direct[0] === "string") {
+    return direct[0];
   }
   return null;
 }
+function isIpLikeHost(value) {
+  const host = value.trim().replace(/:\d+$/, "");
+  return /^(?:\d{1,3}\.){3}\d{1,3}$/.test(host) || /^\[[0-9a-f:]+\]$/i.test(host) || host.includes(":") && /^[0-9a-f:]+$/i.test(host);
+}
 
-// ../../packages/shared-types/src/capture-rules.ts
+// ../../packages/shared-types/src/capture-rule-schemas.ts
 var CAPTURE_RULE_EVENT_TYPES = [
   "backend_exception",
   "request_event",
@@ -16648,6 +16814,7 @@ var CaptureRuleSampleEventClassSchema = external_exports.enum(CaptureRuleSampleE
 var CaptureRuleRuntimeSchema = external_exports.enum(CAPTURE_RULE_RUNTIME_VALUES);
 var CaptureRuleEventTypeSchema = external_exports.enum(CAPTURE_RULE_EVENT_TYPES);
 var BrowserEventKindSchema = external_exports.enum(["window_error", "resource_error"]);
+var CaptureRuleClientKindSchema = external_exports.enum(["human", "bot", "unknown"]);
 function normalizeOptionalTrimmedString(value) {
   const trimmed = value?.trim();
   return trimmed && trimmed.length > 0 ? trimmed : void 0;
@@ -16725,6 +16892,9 @@ var CaptureRuleMatcherSchema = external_exports.object({
   message_contains: external_exports.string().min(1).max(500).optional(),
   message_equals: external_exports.string().min(1).max(500).optional(),
   browser_event_kind: BrowserEventKindSchema.optional(),
+  browser_event_opaque: external_exports.boolean().optional(),
+  client_kind: CaptureRuleClientKindSchema.optional(),
+  bot_family: external_exports.string().min(1).max(120).optional(),
   resource_url: UrlMatcherSchema.optional(),
   request_url: UrlMatcherSchema.optional(),
   status_codes: external_exports.array(external_exports.number().int().min(100).max(599)).min(1).optional(),
@@ -16739,6 +16909,7 @@ var CaptureRuleMatcherSchema = external_exports.object({
   const errorName = normalizeOptionalTrimmedString(value.error_name);
   const messageContains = normalizeOptionalTrimmedString(value.message_contains);
   const messageEquals = normalizeOptionalTrimmedString(value.message_equals);
+  const botFamily = normalizeOptionalTrimmedString(value.bot_family);
   const statusCodes = normalizeNumberArray(value.status_codes);
   if (eventTypes !== void 0) {
     normalized.event_types = eventTypes;
@@ -16767,6 +16938,15 @@ var CaptureRuleMatcherSchema = external_exports.object({
   if (value.browser_event_kind !== void 0) {
     normalized.browser_event_kind = value.browser_event_kind;
   }
+  if (value.browser_event_opaque !== void 0) {
+    normalized.browser_event_opaque = value.browser_event_opaque;
+  }
+  if (value.client_kind !== void 0) {
+    normalized.client_kind = value.client_kind;
+  }
+  if (botFamily !== void 0) {
+    normalized.bot_family = botFamily;
+  }
   if (value.resource_url !== void 0) {
     normalized.resource_url = value.resource_url;
   }
@@ -16793,6 +16973,9 @@ var CaptureRuleMatcherSchema = external_exports.object({
     "message_contains",
     "message_equals",
     "browser_event_kind",
+    "browser_event_opaque",
+    "client_kind",
+    "bot_family",
     "resource_url",
     "request_url",
     "status_codes",
@@ -16975,6 +17158,8 @@ var CaptureRulesFileSchema = external_exports.object({
   version: external_exports.literal(1),
   rules: external_exports.array(CaptureRuleSchema)
 });
+
+// ../../packages/shared-types/src/capture-rule-evaluation.ts
 var CaptureRuleEvaluationUrlSchema = external_exports.object({
   host: external_exports.string().min(1).transform((value) => value.toLowerCase()).optional(),
   path: external_exports.string().min(1).transform((value) => value.startsWith("/") ? value : `/${value}`)
@@ -16990,11 +17175,40 @@ var CaptureRuleEvaluationContextSchema = external_exports.object({
   error_name: external_exports.string().min(1).optional(),
   message: external_exports.string().min(1).optional(),
   browser_event_kind: BrowserEventKindSchema.optional(),
+  browser_event_opaque: external_exports.boolean().optional(),
+  client_kind: CaptureRuleClientKindSchema.optional(),
+  bot_family: external_exports.string().min(1).max(120).optional(),
   resource_url: CaptureRuleEvaluationUrlSchema.optional(),
   request_url: CaptureRuleEvaluationUrlSchema.optional(),
   status_code: external_exports.number().int().min(0).max(599).optional(),
   fingerprint: CaptureRuleFingerprintSchema.optional()
 });
+function classifyCaptureRuleClientFromUserAgent(userAgent) {
+  if (userAgent === null || userAgent === void 0) {
+    return { client_kind: "unknown" };
+  }
+  const lower = userAgent.toLowerCase();
+  const knownBots = [
+    { family: "Googlebot", markers: ["googlebot", "adsbot-google", "google-inspectiontool"] },
+    { family: "Bingbot", markers: ["bingbot", "msnbot"] },
+    { family: "DuckDuckBot", markers: ["duckduckbot"] },
+    { family: "Applebot", markers: ["applebot"] },
+    { family: "YandexBot", markers: ["yandexbot"] },
+    { family: "Baiduspider", markers: ["baiduspider"] },
+    { family: "FacebookBot", markers: ["facebookexternalhit", "facebot"] },
+    { family: "LinkedInBot", markers: ["linkedinbot"] },
+    { family: "TwitterBot", markers: ["twitterbot"] },
+    { family: "Slackbot", markers: ["slackbot"] }
+  ];
+  const knownBot = knownBots.find((entry) => entry.markers.some((marker) => lower.includes(marker)));
+  if (knownBot !== void 0) {
+    return { client_kind: "bot", bot_family: knownBot.family };
+  }
+  if (["bot", "crawler", "spider", "slurp"].some((marker) => lower.includes(marker))) {
+    return { client_kind: "bot", bot_family: "OtherBot" };
+  }
+  return { client_kind: "human" };
+}
 
 // ../../packages/shared-types/src/capture-rule-suggestions.ts
 var CaptureRuleSuggestionConfidenceSchema = external_exports.enum(["high", "medium", "low"]);
@@ -17204,6 +17418,12 @@ var BrowserExceptionEventSchema = external_exports.object({
   }).strict().optional(),
   opaque: external_exports.boolean()
 }).strict();
+var FrontendRejectionReasonSchema = external_exports.object({
+  kind: external_exports.enum(["error", "string", "object", "null", "undefined", "unknown"]),
+  name: external_exports.string().min(1).optional(),
+  message: external_exports.string().min(1).optional(),
+  preview: external_exports.string().min(1).optional()
+}).strict();
 var FrontendExceptionPayloadSchema = external_exports.object({
   name: external_exports.string().min(1),
   message: external_exports.string().min(1),
@@ -17216,6 +17436,7 @@ var FrontendExceptionPayloadSchema = external_exports.object({
   breadcrumbs: external_exports.array(FrontendExceptionBreadcrumbSchema).optional(),
   device: DeviceInfoSchema.nullable().optional(),
   browser_event: BrowserExceptionEventSchema.optional(),
+  rejection_reason: FrontendRejectionReasonSchema.optional(),
   dom_context: external_exports.object({
     mode: external_exports.literal("lightweight"),
     html_excerpt: external_exports.string().min(1)
@@ -17650,7 +17871,7 @@ function buildSkill() {
     "2. Inspect the incident bundle and reproduction artifact before proposing a fix.",
     "3. Run `debugbundle analyze --type improvement --local` after local processing when you need a deterministic change plan.",
     "4. Apply the narrowest fix, then validate it with the repository test workflow from `.debugbundle/profile.json`.",
-    "5. When the fix is confirmed, or when the incident was intentionally generated for smoke, verification, or dogfooding, resolve it with `debugbundle resolve <incident-id>` or MCP `resolve_incident` so the open queue stays actionable.",
+    "5. When the fix is confirmed, or when the incident was intentionally generated for smoke, verification, or dogfooding, resolve it with `debugbundle resolve <incident-id> [incident-id ...]` or MCP `resolve_incident` / `resolve_incidents` so the open queue stays actionable.",
     "",
     "## Incident Hygiene",
     "",
@@ -17659,6 +17880,15 @@ function buildSkill() {
     "- Reopen or leave open if the failure is still present, the validation is incomplete, or the incident represents a live unresolved problem.",
     "- If a resolved incident regresses, let the platform move it back to `regressed` through normal incident lifecycle behavior.",
     "",
+    "## Noise Management",
+    "",
+    "When incident evidence shows repeated low-value operational noise rather than a product bug, evaluate whether a scoped capture rule or capture-policy path rule should handle future matches.",
+    "",
+    "- Run `debugbundle capture-rule suggest <incident-id> --json` before creating a manual rule. Apply deterministic suggestions with `debugbundle capture-rule create-from-suggestion <incident-id> --suggestion-id <id>` after confirming the scope is safe.",
+    "- Prefer project capture rules for operational noise because they are centralized, auditable, and enforced by ingestion and processing. Use SDK `beforeSend` only for app-owned local policy such as final redaction or events that must never leave the runtime.",
+    "- Scope frontend noise by structured evidence such as service, environment, `browser_event_kind`, `browser_event_opaque`, `client_kind`, `bot_family`, and message fields. Do not broadly demote generic `Unhandled promise rejection` incidents without bot-scoped or otherwise narrow evidence.",
+    "- For expected or intentionally promoted 4xx responses on known routes, use capture-policy client-error path rules instead of promoting all client errors: `debugbundle capture-policy set --client-error-path-rule <status=/path/*@GET>`.",
+    "",
     "## Profile Validation",
     "",
     "Use this task after setup or whenever architecture changes make the static profile stale.",
@@ -17721,10 +17951,21 @@ function buildCliReference() {
     "- `debugbundle explain <incident-id> [--source <local|cloud>] [--json]`",
     "- `debugbundle bundle <incident-id> [--source <local|cloud>] [--json]`",
     "- `debugbundle reproduce <incident-id> [--source <local|cloud>] [--json]`",
-    "- `debugbundle resolve <incident-id> [--source <local|cloud>] [--json]`",
-    "- `debugbundle reopen <incident-id> [--source <local|cloud>] [--json]`",
+    "- `debugbundle resolve <incident-id> [incident-id ...] [--source <local|cloud>] [--json]`",
+    "- `debugbundle reopen <incident-id> [incident-id ...] [--source <local|cloud>] [--json]`",
     "- `debugbundle analyze --type improvement --local`",
     "",
+    "## Noise Management",
+    "",
+    "- `debugbundle capture-rule suggest <incident-id> [--auth-file <path>] [--json]`",
+    "- `debugbundle capture-rule create-from-suggestion <incident-id> --suggestion-id <id> [--name <name>] [--expires-at <ISO8601>] [--auth-file <path>] [--json]`",
+    "- `debugbundle capture-rule list --project-id <id> [--auth-file <path>] [--json]`",
+    "- `debugbundle capture-rule create --project-id <id> --name <name> --action <demote|sample|drop> --matcher-json <json> [--auth-file <path>] [--json]`",
+    "- `debugbundle capture-policy get [--project <id>] [--json]`",
+    "- `debugbundle capture-policy set [--project <id>] --client-error-path-rule <404=/path/*@GET,POST> [--json]`",
+    "",
+    "Use capture-rule suggestions for repeated operational noise after inspecting an incident bundle. Use capture-policy client-error path rules for route-scoped 4xx incidents instead of promoting all client errors.",
+    "",
     "## Operational Paths",
     "",
     "- `.debugbundle/profile.json` \u2014 committed project map and agent validation state",
@@ -17755,7 +17996,7 @@ function buildCliReference() {
     "```bash",
     "debugbundle incidents --status open --json \\",
     `  | jq -r '.incidents[] | select(.title | test("smoke test|dogfood|verification|synthetic"; "i")) | .incident_id' \\`,
-    "  | xargs -n1 debugbundle resolve",
+    "  | xargs debugbundle resolve",
     "```",
     ""
   ].join("\n");
@@ -17774,19 +18015,28 @@ function buildMcpReference() {
     "- `get_incident_context` \u2014 fetch deterministic explanation context for triage.",
     "- `get_bundle` \u2014 fetch the full debug bundle before proposing a fix.",
     "- `get_reproduction` \u2014 fetch reproduction guidance before editing code.",
-    "- `resolve_incident` / `reopen_incident` \u2014 update lifecycle state after validation.",
+    "- `resolve_incident` / `resolve_incidents` / `reopen_incident` / `reopen_incidents` \u2014 update lifecycle state after validation.",
     "- `analyze` \u2014 run local agent-oriented analysis from local bundles and skill schemas.",
     "",
     "- Prefer bundle retrieval tools before reading raw repository files.",
     "- Use MCP bundle access when the current issue originated in production.",
-    "- Resolve fixed or intentionally generated incidents with `resolve_incident` so open incidents stay actionable.",
+    "- Resolve fixed or intentionally generated incidents with `resolve_incident` or `resolve_incidents` so open incidents stay actionable.",
     "- Fall back to local CLI processing when the project is local-only.",
     "",
+    "## Noise and Capture Policy Tools",
+    "",
+    "- `suggest_capture_rules_from_incident` \u2014 generate deterministic capture-rule suggestions from an incident bundle.",
+    "- `create_capture_rule_from_incident_suggestion` \u2014 apply a confirmed suggestion.",
+    "- `list_capture_rules`, `create_capture_rule`, `update_capture_rule`, `delete_capture_rule` \u2014 manage project capture rules.",
+    "- `get_capture_policy`, `update_capture_policy` \u2014 review or update capture policy, including path-scoped client-error incident rules.",
+    "",
+    "Use these tools for repeated low-value operational noise only after inspecting incident evidence. Keep frontend suppression scoped by structured browser and client signals, and use path-scoped capture policy for known 4xx routes.",
+    "",
     "## Smoke-Test Cleanup Recipe",
     "",
     '1. Call `list_incidents` with `status: "open"`.',
     "2. Filter incidents whose titles show they were intentionally generated for smoke, dogfood, verification, or synthetic checks.",
-    "3. Call `resolve_incident` for each verified synthetic incident.",
+    "3. Call `resolve_incidents` for verified synthetic incidents, or `resolve_incident` for a single incident.",
     "4. Call `list_incidents` again and confirm the open queue only contains actionable failures.",
     ""
   ].join("\n");
@@ -17906,6 +18156,16 @@ function buildSkillEvals() {
             "Leave unresolved incidents open when the failure is still live or unverified."
           ]
         },
+        {
+          name: "noise_management_guidance",
+          prompt: "The same low-value frontend incident keeps reopening. Confirm the skill tells the agent how to evaluate operational noise without hiding real bugs.",
+          expected_behavior: [
+            "Inspect incident evidence before creating a rule.",
+            "Use capture-rule suggestions for repeated operational noise.",
+            "Keep generic frontend suppression narrow with structured browser or bot signals.",
+            "Use capture-policy path rules for known route-scoped 4xx incidents."
+          ]
+        },
         {
           name: "artifact_path_discovery",
           prompt: "The user reports an unknown local runtime error. Confirm the skill tells the agent which DebugBundle paths and commands to inspect first.",
@@ -19236,7 +19496,7 @@ function getRequestResponseStatus(payload) {
   const status = payload?.["response_status"];
   return typeof status === "number" && Number.isFinite(status) ? status : null;
 }
-function classifyEvent(eventType, logLevel, probeActivationId, payload, capturePreset = "minimal", immediateClientErrorStatuses = []) {
+function classifyEvent(eventType, logLevel, probeActivationId, payload, capturePreset = "minimal", immediateClientErrorStatuses = [], immediateClientErrorPathRules = []) {
   switch (eventType) {
     case "backend_exception":
     case "frontend_exception":
@@ -19248,7 +19508,14 @@ function classifyEvent(eventType, logLevel, probeActivationId, payload, captureP
       return "context_signal";
     case "request_event": {
       const responseStatus = getRequestResponseStatus(payload);
-      return classifyRequestStatus({ responseStatus, capturePreset, immediateClientErrorStatuses });
+      return classifyRequestStatus({
+        responseStatus,
+        requestPath: payload?.["path"],
+        httpMethod: payload?.["method"],
+        capturePreset,
+        immediateClientErrorStatuses,
+        immediateClientErrorPathRules
+      });
     }
     case "frontend_breadcrumb":
     case "deploy_metadata":
@@ -19955,6 +20222,33 @@ function buildRedactionRecord(bundleBody) {
     notes: readString(redaction["notes"])
   };
 }
+function buildBrowserSignalRecord(bundleBody) {
+  const bundle = isRecord(bundleBody) ? bundleBody : {};
+  const context = isRecord(bundle["context"]) ? bundle["context"] : {};
+  const frontend = isRecord(context["frontend"]) ? context["frontend"] : {};
+  const exceptions = Array.isArray(frontend["exceptions"]) ? frontend["exceptions"] : [];
+  let exception;
+  for (let index = exceptions.length - 1; index >= 0; index -= 1) {
+    const candidate = exceptions[index];
+    if (isRecord(candidate) && isRecord(candidate["browser_event"])) {
+      exception = candidate;
+      break;
+    }
+  }
+  const browserEvent = isRecord(exception) && isRecord(exception["browser_event"]) ? exception["browser_event"] : null;
+  const device = isRecord(context["device"]) ? context["device"] : {};
+  const client = classifyCaptureRuleClientFromUserAgent(readString(device["user_agent"]) ?? void 0);
+  if (browserEvent === null && client.client_kind === "unknown") {
+    return null;
+  }
+  return {
+    browser_event_kind: readString(browserEvent?.["kind"]),
+    browser_event_opaque: readBoolean(browserEvent?.["opaque"]),
+    browser_event_message: readString(browserEvent?.["message"]),
+    client_kind: client.client_kind,
+    bot_family: client.bot_family ?? null
+  };
+}
 function buildVisibilityRecord(input) {
   const routeTarget = input.primarySignal.route_template ?? input.primarySignal.request_path;
   const matchedFields = input.incident.matched_fields.length === 0 ? "none" : input.incident.matched_fields.join(", ");
@@ -19992,6 +20286,14 @@ function buildSuggestedNextChecks(input) {
   if (input.deploy.regression_window === true || input.incident.status === "regressed") {
     suggestions.push("Compare this incident against the most recent deploy and recent regressions.");
   }
+  if (input.browserSignal?.browser_event_opaque === true) {
+    suggestions.push("Treat the browser event as opaque; inspect CSP, cross-origin scripts, resource loading, and framework error boundaries before changing application code.");
+  }
+  if (input.browserSignal?.client_kind === "bot") {
+    suggestions.push(
+      `Review whether ${input.browserSignal.bot_family ?? "bot"} traffic is operational noise before applying a bot-scoped capture rule.`
+    );
+  }
   if (input.reproduction.status === "pending") {
     suggestions.push("Recheck reproduction guidance after the reproduction artifact is ready.");
   }
@@ -20012,6 +20314,7 @@ function buildIncidentContextRecord(input) {
     primarySignal
   });
   const redaction = buildRedactionRecord(bundleBody);
+  const browserSignal = buildBrowserSignalRecord(bundleBody);
   return {
     incident: input.incident,
     incident_reason: incidentReason,
@@ -20027,13 +20330,15 @@ function buildIncidentContextRecord(input) {
     },
     visibility,
     redaction,
+    browser_signal: browserSignal,
     suggested_next_checks: buildSuggestedNextChecks({
       incident: input.incident,
       bundle: input.bundle,
       reproduction: input.reproduction,
       logs,
       primarySignal,
-      deploy
+      deploy,
+      browserSignal
     })
   };
 }
@@ -20445,6 +20750,7 @@ var STORAGE_BOOTSTRAP_STATEMENTS = [
       capture_breadcrumbs text,
       capture_probe_events text,
       immediate_client_error_statuses jsonb,
+      immediate_client_error_path_rules jsonb,
       updated_at timestamptz NOT NULL DEFAULT now()
     )
   `,
@@ -21800,6 +22106,13 @@ var STORAGE_SCHEMA_MIGRATIONS = [
         ON plan_cleanup_tasks (completed_at, next_attempt_at, created_at)
       `
     ]
+  }),
+  defineStorageSchemaMigration({
+    id: "202606080001_add_capture_policy_client_error_path_rules",
+    description: "Add path-scoped client error incident promotion rules to capture policies.",
+    statements: [
+      "ALTER TABLE capture_policies ADD COLUMN IF NOT EXISTS immediate_client_error_path_rules jsonb"
+    ]
   })
 ];
 
@@ -23080,6 +23393,15 @@ function collectRequestAnomalyAggregates(batches, capturePreset) {
       if (threshold === null || responseStatus === null || method === null || routeTemplate === null) {
         continue;
       }
+      if (isLowValueExternalProbeRequestFailure404({
+        httpMethod: method,
+        requestPath: event.payload.path,
+        routeTemplate,
+        responseStatus,
+        headers: event.payload.headers
+      })) {
+        continue;
+      }
       const projectId = requireProjectId(event);
       const incidentFingerprint = buildRequestAnomalyFingerprint({
         projectId,
@@ -28486,7 +28808,7 @@ var zodToJsonSchema = (schema, options) => {
 var package_default = {
   name: "@debugbundle/mcp",
   mcpName: "com.debugbundle/mcp",
-  version: "1.1.1",
+  version: "1.3.0",
   private: false,
   description: "Model Context Protocol server for DebugBundle",
   license: "AGPL-3.0-only",
@@ -29247,7 +29569,12 @@ var MCP_TOOL_CATALOG = [
         capture_request_events: external_exports.string().nullable().optional(),
         capture_breadcrumbs: external_exports.string().nullable().optional(),
         capture_probe_events: external_exports.string().nullable().optional(),
-        immediate_client_error_statuses: external_exports.array(external_exports.number().int().min(400).max(499)).nullable().optional()
+        immediate_client_error_statuses: external_exports.array(external_exports.number().int().min(400).max(499)).nullable().optional(),
+        immediate_client_error_path_rules: external_exports.array(external_exports.object({
+          status_code: external_exports.number().int().min(400).max(499),
+          path_pattern: external_exports.string(),
+          methods: external_exports.array(external_exports.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"])).optional()
+        })).nullable().optional()
       })
     })
   },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@debugbundle/mcp",
   "mcpName": "com.debugbundle/mcp",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "private": false,
   "description": "Model Context Protocol server for DebugBundle",
   "license": "AGPL-3.0-only",

package/server.json

@@ -8,13 +8,13 @@
     "source": "github",
     "subfolder": "apps/mcp"
   },
-  "version": "1.1.1",
+  "version": "1.3.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@debugbundle/mcp",
-      "version": "1.1.1",
+      "version": "1.3.0",
       "transport": {
         "type": "stdio"
       },