Admin console · animated

Click to expand

Fix drafts & PRs

The Fixes page shows every draft pull request Mushi opened from a real bug — from the moment a fix run starts to when a PR is ready to review (or the run fails). Multi-repo coordination rows appear when one report spans several repos.

The fixes list

Each row in the list shows:

Coordination rows have a ▶ Expand toggle that reveals the per-repo child attempts grouped underneath.

Streaming view

Click any running fix to open the streaming drawer. It opens a Hono streamSSE connection into the orchestrator and renders AG-UI protocol events live:

• Tool calls — file reads, searches, shell commands, test runs.
• File writes — diffs rendered inline as the agent writes them.
• Test output — pass / fail per test as they stream.
• Sandbox lifecycle — boot, snapshot, restore, teardown events.

The transport sanitises carriage returns per CVE-2026-29085  so injected control sequences can’t forge fake tool-call lines.

Spec-validation warnings

When the fix-worker runs validateAgainstSpec() before opening a PR and finds soft issues — e.g. the diff doesn’t touch any file that references the contract’s required DB table — the warnings land in fix_attempts.spec_validation_warnings and surface as a yellow callout in the streaming drawer:

⚠  Sanity-check before merging
   The diff does not reference table public.users, but the expected_outcome
   contract requires a row_exists assertion on that table.
   Review manually before merging.

Hard errors (removing a json_path field the contract asserts on) abort the run before the PR opens.

Cursor Cloud Agent runs

When agent = cursor_cloud, the fix row shows two additional UI elements:

• Cursor badge — a ◆ bc-… chip that links to the agent run transcript in Cursor’s web interface.
• Artifact gallery — screenshots, videos, and log files the agent produced during the run. These are fetched via agent.listArtifacts() after the run terminates.

The artifact gallery is visible in the expanded fix detail when artifacts are present.

Dispatching a fix

You can dispatch a fix from four places:

1. Report detail → “Dispatch fix” button (single-repo or auto multi-repo).
2. Reports list → kebab menu → “Send to Cursor agent” (dispatches cursor_cloud directly).
3. Fixes list → “New fix” button with a report picker.
4. MCP / A2A / CLI — dispatch_fix tool (agent=cursor_cloud), POST /v1/a2a/tasks, or mushi fix <reportId> --agent cursor_cloud.

All three paths produce the same fix_dispatch_jobs row and emit the same fix.dispatched webhook to subscribed plugins.

Webhooks

Configure webhook endpoints in Settings → Webhooks. Each delivery is logged with the payload, HTTP status, and any retry attempts.

CI feedback on open PRs

When a fix-worker or Cursor agent opens a draft PR, GitHub Actions runs on the branch. The fix detail card shows a CI badge with the latest check-run conclusion (success, failure, pending, etc.).

A background mushi-ci-sync-10m pg_cron also refreshes completed attempts every 10 minutes, but on-demand refresh closes the loop immediately after you push a fix to the PR branch.

From the CLI:

mushi fixes refresh-ci <fixId>

Merging from the console

After CI passes (or you’ve reviewed manually), merge the draft PR without leaving Mushi. This is user-confirmed — Mushi never auto-merges.

Where merge appears

• Report detail → fix card → Merge PR (confirm popover)
• Fixes list → completed row with open PR
• Pipeline flow on the report detail page

The UI picks the primary fix attempt — if a later retry failed but an earlier attempt still has an open PR, the merge button targets the mergeable attempt, not the failed retry.

Merge flow

Draft PRs: fix-worker opens PRs as drafts. Before merge, the API calls GitHub’s GraphQL markPullRequestAsReady (same as gh pr ready). New fix-worker runs also auto-ready immediately after opening the PR.

Merge methods: squash (default), merge commit, or rebase — chosen in the confirm popover.

Already merged: if GitHub shows merged but the webhook was missed, merge is idempotent — finalizeFixMerge() backfills merged_at and report status.

From the CLI (requires mcp:write API key):

mushi fixes merge <fixId>
mushi fixes merge <fixId> --method squash

Prerequisites

See also

• Concepts → Fix drafts & PRs — how auto-fix works internally.
• Concepts → Multi-repo coordinated fixes — coordinated multi-repo runs.
• Connecting your orchestrator — dispatch via MCP, A2A, or REST.