Fix & ship — API reference

Typed remediations, the evals-from-failures flywheel, and deploy-event correlation.

remediations

GET /remediations

Get Remediations

GET /remediations/agent-context

Get Agent Context

Return the project’s optional agent context (nulls when unset).

PUT /remediations/agent-context

Put Agent Context

Upsert the project’s agent context (improves future grounded generations).

GET /remediations/efficacy-report

Efficacy Report

Per-project post-merge efficacy + MTTR report from LIVE close-out data: failure volume before/after, fixes shipped/verified/regressed/pending, median MTTR, and a monthly trend.

POST /remediations/generate

Generate Remediation

GET /remediations/items

List Remediations

GET /remediations/items/{rid}

Get Remediation

PATCH /remediations/items/{rid}

Patch Remediation

DELETE /remediations/items/{rid}

Delete Remediation

GET /remediations/items/{rid}/closeout

Get Closeout

The single most-recent close-out for this remediation, or 404.

GET /remediations/items/{rid}/efficacy

Efficacy

GET /remediations/items/{rid}/fix-bundle

Get Fix Bundle

Assemble a remediation’s root cause + typed fix spec + proof evals + anonymized failing exemplars into ONE coding-agent-ready pack (markdown + structured JSON + a pre-generated neens eval run CI command). Pure assembly of data Neens already computes — no LLM, no egress, no repo access. Read-only; mirrors the sibling GET-detail routes.

POST /remediations/items/{rid}/record-merge

Record Merge Route

Record that a Neens-opened fix PR for this remediation was MERGED (the manual + MCP path): stamp a deploy event + a pending close-out watch. The webhook (POST /webhooks/github) is the automated sibling. Returns the close-out dict.

POST /remediations/items/{rid}/regenerate

Regenerate Remediation Item

Re-run the CURRENT grounded engine for this remediation’s source (cluster or failure mode), producing a FRESH remediation and archiving this one as a superseded predecessor. Force-capable on ANY status — the old proposal (and its PR/verification state) is preserved, never mutated in place and never deleted. Runs synchronously (one generation). 404 if rid is not in the caller’s project scope; 409 if it is already superseded. Returns the NEW remediation dict with regeneratedFromId set and an embedded compact predecessor.

POST /remediations/items/{rid}/simulate

Simulate

GET /remediations/items/{rid}/simulation-plan

Simulation Plan

Describe what a simulate run WOULD do WITHOUT running any replay. Shares the exact target-selection + judge/model resolution used by POST.../simulate. The optional override query params mirror SimulateRequest (minus the explicit cohort — the UI holds the selected ids client-side) so the Configure panel gets a live preview of a tuned run.

POST /remediations/regenerate-bulk

Regenerate Remediations Bulk

Regenerate a SET of remediations with the current engine. Resolves the target id list under project scope from exactly one selector (remediation_ids | failure_mode_id | all_open), caps it at a server-side maximum, then:

GET /remediations/stats

Remediation Stats

GET /remediations/trend

Remediations Trend

Throughput trend for the Remediations page: per-day (or per-hour) count of fix tasks created over the selected window, plus a period-over-period total. Scoped to the current project. Creation volume is counted regardless of later archive state, so a historical trend doesn’t drift as tasks are archived.

flywheel

POST /flywheel/failure-modes/{mode_id}/generate-eval

Generate Eval

GET /flywheel/gates

List Gates

GET /flywheel/gates/{gate_id}

Get Gate

Rich single-gate detail: the stored gate row PLUS the provenance it binds together (failure mode / judge / dataset / deployment) and a bounded history of its recent eval runs, so the UI can explain what this gate checks, when it last ran, and how it has been trending on one click. Every cross-table read is best-effort and project-scoped.

PATCH /flywheel/gates/{gate_id}

Patch Gate

POST /flywheel/gates/{gate_id}/run

Run Gate

deploy-events

GET /deploy-events

List Deploy Events

POST /deploy-events

Create Deploy Event

GET /deploy-events/what-changed

What Changed