@zibby/workflow-templates 0.3.0 → 0.4.1

package/sentry-triage/state.js

@@ -0,0 +1,134 @@
+/**
+ * sentry-triage — three-schema state model.
+ *
+ * Triage flow:
+ *   1. fetch_issues   (LLM + sentry skill)  — pull recent unresolved
+ *      issues from Sentry
+ *   2. filter_noise   (custom execute)       — drop known-noise patterns
+ *      (browser-extension URLs, ResizeObserver loops, etc.) WITHOUT
+ *      paying an LLM call per issue
+ *   3. classify       (LLM)                  — classify the survivors as
+ *      NOISE / LOW / MEDIUM / HIGH / CRITICAL with reasoning
+ *   4. dispatch_alerts (custom execute)      — sub-graph dispatch to
+ *      notify-slack OR notify-lark for issues above severityThreshold
+ *
+ * Why sub-graph dispatch (not built-in notify here):
+ *   - notify-slack / notify-lark are reusable across MANY parent
+ *     workflows (sentry-autofix, sentry-incident, cron-summary, etc.).
+ *   - Adding a new channel (Discord, Teams) means adding a new child
+ *     workflow — sentry-triage code never changes.
+ *   - In-process sub-graph dispatch is ~5ms overhead in cloud, so the
+ *     architectural cleanliness costs nothing.
+ */
+
+import { z } from 'zod';
+
+export const SEVERITY_LEVELS = /** @type {const} */ (['NOISE', 'LOW', 'MEDIUM', 'HIGH', 'CRITICAL']);
+
+export const sentryTriageInputSchema = z.object({
+  // ── Sentry source ────────────────────────────────────────────────
+  organizationSlug: z.string().min(1)
+    .describe('Sentry organization slug (the URL segment after sentry.io/organizations/).'),
+  projectSlug: z.string().min(1)
+    .describe('Sentry project slug — limits triage to a single project.'),
+  environment: z.string().default('production')
+    .describe('Sentry environment tag to filter by (defaults to production).'),
+  sinceMinutes: z.number().int().min(5).max(1440).default(60)
+    .describe('Look back this many minutes for newly-firstSeen issues. Hourly cron → 60.'),
+
+  // ── Triage thresholds ────────────────────────────────────────────
+  severityThreshold: z.enum(SEVERITY_LEVELS).default('MEDIUM')
+    .describe('Only dispatch alerts for issues at or above this severity. Drop the rest.'),
+  maxIssues: z.number().int().min(1).max(100).default(20)
+    .describe('Cap issues processed per run. Protects against an unexpected error storm.'),
+
+  // ── Where to send alerts ────────────────────────────────────────
+  notifyWorker: z.enum(['notify-slack', 'notify-lark']).default('notify-slack')
+    .describe(
+      'Which child workflow to dispatch alerts to. Both must be deployed in the same project ' +
+      'as this triage workflow. Pick whichever messaging platform your team uses.',
+    ),
+
+  // For notify-slack
+  slackChannel: z.string().min(1).max(120).optional()
+    .describe('Slack channel id (C012345) or #name. Required when notifyWorker=notify-slack.'),
+  slackMentions: z.array(z.string().max(60)).max(10).optional()
+    .describe('Mentions to append on CRITICAL alerts only, e.g. ["<!subteam^S0ONCALL>"].'),
+
+  // For notify-lark
+  larkReceiveId: z.string().min(1).max(120).optional()
+    .describe('Lark chat id (oc_…), open id (ou_…), or email. Required when notifyWorker=notify-lark.'),
+  larkMentions: z.array(z.string().max(200)).max(10).optional()
+    .describe('Lark @-mention strings for CRITICAL alerts.'),
+
+  model: z.string().default('auto')
+    .describe('LLM model override for classify_issues. Default auto-selects.'),
+});
+
+export const sentryTriageContextSchema = z.object({
+  // Runner-injected
+  workspace: z.string().optional()
+    .describe('Workspace path — set by runner. Triage doesn\'t need it but graph.run requires it.'),
+
+  // Node outputs (mid-graph, keyed by node name)
+  fetch_issues: z.object({
+    issues: z.array(z.object({
+      id: z.string(),
+      shortId: z.string().optional(),
+      title: z.string(),
+      culprit: z.string().optional(),
+      level: z.string().optional(),
+      status: z.string().optional(),
+      count: z.union([z.string(), z.number()]).optional(),
+      userCount: z.number().optional(),
+      firstSeen: z.string().optional(),
+      lastSeen: z.string().optional(),
+      permalink: z.string().optional(),
+      metadata: z.object({
+        type: z.string().optional(),
+        value: z.string().optional(),
+        filename: z.string().optional(),
+      }).optional(),
+    })),
+    fetchedAt: z.string().optional(),
+  }).optional(),
+
+  filter_noise: z.object({
+    kept: z.array(z.any()),
+    dropped: z.array(z.object({
+      id: z.string(),
+      reason: z.string(),
+    })),
+  }).optional(),
+
+  classify: z.object({
+    classifications: z.array(z.object({
+      issueId: z.string(),
+      severity: z.enum(SEVERITY_LEVELS),
+      confidence: z.number().min(0).max(1).optional(),
+      reasoning: z.string().optional(),
+      suggestedAction: z.string().optional(),
+      ruleMatched: z.string().optional(),
+    })),
+  }).optional(),
+
+  dispatch_alerts: z.object({
+    dispatched: z.array(z.object({
+      issueId: z.string(),
+      severity: z.enum(SEVERITY_LEVELS),
+      status: z.enum(['sent', 'skipped', 'failed']),
+      detail: z.string().optional(),
+      messageTs: z.string().optional(),
+      messageId: z.string().optional(),
+    })),
+    summary: z.object({
+      total: z.number(),
+      sent: z.number(),
+      skipped: z.number(),
+      failed: z.number(),
+    }),
+  }).optional(),
+});
+
+export const sentryTriageStateSchema =
+  sentryTriageInputSchema.merge(sentryTriageContextSchema);