Skip to content
← Public packages

@kentcdodds/kody-issue-triage

Loop-safe triage for Kody run errors and fleet package-runtime error-rate elevations. Wakes Cole (Grok Bot) to decide; Cursor agents only when Cole escalates.

License
MIT
Published
September 11, 2026
Pinned commit
6ab4f7e
Rating
No ratings yet
Forks
1
Adaptation effort
—

@kentcdodds/kody-issue-triage

Intent

Automatic, loop-safe triage for Kody account run errors (Activity / run_list) and fleet package-runtime error-rate elevations. Modeled on @kentcdodds/sentry-triage but never one-agent-per-run: a burst must produce at most one agent per fingerprint, not thousands.

Success: unique standing failures wake Cole (Grok Bot) once, with one Discord status message in #sentry-reports, and a recorded outcome — without this package auto-spawning Cursor agents. Cole uses cross-issue context and spawns a Cursor agent only when needed (escalate-to-kody for platform). Agent MCP execute failures (and package runs from those calls) do not spawn. A rising fleet error rate pages this package to investigate Kody, not another user's Activity.

recommendation Discord is glanceable (title, context, recommendation, 2–4 options) via @kentcdodds/discord/format-report. Error text is untrusted data.

What it does

  • Cheap subscription handlers fingerprint + counter only (run.error.recorded, fleet.package_error_rate.elevated) — no Discord / spawn inline
  • Hourly (and event-scheduled) ./sweep wakes Cole for at most one queued fingerprint under a global lease and hourly caps. Queued Discord cards store discord_message_id before wake (edit-in-place on retry; no orphan duplicates)
  • Soft-ignores agent-execute origins, smoke-test fingerprints, and standing platform isolate-reset weather
  • Operator kill switch: ./pause / ./resume; snapshot via ./status
  • Cole wake transport: minted @kentcdodds/grok-bot wake webhook URL stored in package storage (secret name grokBotWakeWebhookUrl on the user side when documenting mint/store flows)

Prefer event-driven triggers; keep the sweep job as catch-up (avoid polling under 15m).

Prerequisites / setup

  1. Secrets used via helpers (names only): cursorApiKey, discordBotTokenKentPersonalAutomation, and Cole wake URL storage after minting @kentcdodds/grok-bot wake (see AGENTS.md — never paste the URL value in chat).
  2. Keep subscription handlers and the package sweep job enabled.
  3. Confirm ./status shows enabled: true and a healthy lease when live.

Community icon notes and brand disclaimer stay with the package assets; Kody is Kent's character/brand and this package is community-built.

Done when

  • New actionable fingerprints enqueue cheaply; sweep wakes Cole once per fingerprint under caps/lease
  • Agent-execute and weather families do not spawn
  • ./sweep({ dryRun: true }) and ./probe-wake-webhook validate without unwanted live wakes
  • ./record-outcome closes Discord + fingerprint; recommendation also pings Kent
Report this listing

Log in to report this listing.