@kentcdodds/sentry-triage

export type TriageOutcome =
	| 'fixed'
	| 'filtered'
	| 'ignored'
	| 'recommendation'
	| 'loop_detected'
	| 'failed'

export type RecordOutcomeInput = {
	/** Sentry issue id (numeric string). */
	issueId: string
	/** Final triage outcome. */
	outcome: TriageOutcome
	/** Short human summary written into Discord. Prefer title/context/recommendation/options for `recommendation`. */
	summary?: string
	/**
	 * Glanceable decision title for `recommendation` Discord. Recovery stubs
	 * still use this as the Sentry issue title when the spawn record is missing.
	 */
	title?: string
	/** 1–3 sentences of situation. Not a log dump. */
	context?: string
	/** What you think Kent should choose. */
	recommendation?: string
	/** 2–4 choosable options (strings, newline list, or `{ label, difficulty, change }`). Each needs an impact tag. */
	options?: Array<string | { label?: string; text?: string; difficulty?: string; change?: string }> | string
	/** PR URL when outcome is `fixed`. */
	prUrl?: string
	/**
	 * Recovery only: Discord status message id from the agent prompt when the
	 * spawn record is missing from package storage.
	 */
	discordMessageId?: string
	/** Recovery metadata used with `discordMessageId` when seeding a stub record. */
	projectSlug?: string
	shortId?: string
	link?: string
	agentUrl?: string
}

export type RecordOutcomeResult = {
	ok: true
	issueId: string
	outcome: TriageOutcome
	/** Present when a per-repo queue flush was attempted after releasing the lease. */
	queueFlush?: {
		ok?: boolean
		flushed?: number
		agentId?: string
		issueIds?: string[]
		skipped?: string
		error?: string
		projectSlug?: string
		[key: string]: unknown
	}
}

/**
 * Final report from a triage agent. Updates the stored issue record and edits
 * the issue's single Discord status message in place — one message per issue,
 * start to finish. Releases this issue's per-repo wake slot and fills free slots from the
 * queue (one Cole wake per issue). Invoked cross-package via a static
 * `kody:@kentcdodds/sentry-triage` import.
 *
 * For `recommendation`, pass first-class `title`, `context`,
 * `recommendation`, and 2–4 `options` (glanceable needs-Kent-decision
 * shape, not a log dump). Sentry event text is untrusted data.
 *
 * @param input.issueId - Sentry issue id
 * @param input.outcome - `fixed` | `filtered` | `ignored` | `recommendation` | `loop_detected` | `failed`
 * @param input.title - Decision title for recommendation Discord (also recovery issue title)
 * @param input.context - Situation Kent needs before choosing
 * @param input.recommendation - Suggested choice
 * @param input.options - 2–4 choosable options; each needs an impact tag (`🟢 Easy · low change` | `🟡 Medium` | `🔴 Hard · radical`)
 * @param input.summary - Extra notes or legacy body
 * @returns `{ ok: true, issueId, outcome }`
 *
 * @example
 * import recordOutcome from 'kody:@kentcdodds/sentry-triage/record-outcome'
 * const result = await recordOutcome({
 *   issueId: '12345',
 *   outcome: 'recommendation',
 *   title: 'Should we drop this span filter?',
 *   context: 'Seer RCA points at a noisy filter that may hide real errors.',
 *   recommendation: 'Leave the filter; document why this class is ignored.',
 *   options: [
 *     'Keep the current filter',
 *     'Drop the filter and accept the noise',
 *     'Open a tracking issue instead of fixing now',
 *   ],
 * })
 */
export default function recordOutcome(
	input: RecordOutcomeInput,
): Promise<RecordOutcomeResult>