docs(merge-queue): document Chrome Extension 0.8.0 (terminal states + row hiding)

[samgutentag]

Consolidates the Chrome Extension 0.8.0 reference docs into one change to merge-queue/chrome-extension.mdx. This is the docs half of the 0.8.0 changelog work (TRUNK-18467); a separate changelog PR will follow and link to these sections, so this should merge first.

What changed

• Track testing progress: added Waiting to Batch and expanded Merged / Failed / Cancelled with the detail the panel now shows (failed-check list with run-log links, who cancelled).
• New "Resubmit after failure or cancellation" section covering the one-click Resubmit button and the most-recent-attempt caveat.
• Replaced "Automatic bot comment hiding" with "Configuring row hiding" documenting the three Hide rows toggles (Merging is blocked, Branch out of date, Trunk bot comments), all opt-out.
• Updated the settings FAQ to the in-popup Settings cards (Hide rows, Verbose logging, Keyboard shortcuts), with Celebration Mode moved to the full-page Options view.

Supersedes

This replaces three overlapping open PRs, which should be closed once this lands:

• docs(merge-queue): configurable row hiding in Chrome extension #201 (row hiding) — folded in
• docs(merge-queue): Chrome Extension terminal state improvements (v195) #204 (terminal states, Jun 4 batch) — folded in
• docs(devrel): Chrome Extension terminal states + IAM auto-join pending invite fix #180 (terminal states + IAM, Jun 3 batch) — extension content folded in; its unrelated setup-and-administration/managing-your-organization.mdx IAM auto-join change needs its own PR (belongs with TRUNK-18480), it is not included here.

Source: trunk2 #4042 (terminal states), #4075 (row hiding). Extension shipped as 0.8.0 to the Chrome Web Store on 2026-06-04.

🤖 Generated with Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
trunk	🟢 Ready	View Preview	Jun 5, 2026, 4:52 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[samgutentag]

Verification status (2026-06-04): live

Verified: customers can use this. Ready to publish.

• Flag state: none. The 0.8.0 extension features ship in the published Chrome Web Store build, not behind a LaunchDarkly flag (the row-hiding toggles persist in chrome.storage.local).
• Eng PR: trunk-io/trunk2#4042 (terminal states, merged 2026-06-02), trunk-io/trunk2#4075 (row hiding, merged 2026-06-03). Both merge commits are on main and shipped in deploy v195.
• Flag: none (ungated)
• Signals: extension published as 0.8.0 to the Chrome Web Store on 2026-06-04 (announced in #team-merge-queue); no LaunchDarkly flag in either eng diff (no useFlag / flags.ts / LD URL).

Ready to publish. Merge this (#208) before #209 so the changelog deep-links resolve.

[samgutentag]

Code verification (2026-06-04): 8 confirmed / 0 contradicted / 0 ambiguous / 0 unverifiable

Verified the extension UI claims in this docs PR against the extension source in trunk-io/trunk2 (ts/apps/browser-extension).

Claim	Verdict	Source
Failed/Cancelled show a Resubmit button	confirmed	prPageMqNotInQueueView.ts:133
Cancelled shows who cancelled ("Cancelled by alice")	confirmed	mergeItemTerminalDetail.vitest.ts:76
"Waiting to Batch" state exists	confirmed	mergeItemPendingDetail.vitest.ts:35
Failed lists failed checks with run-log links	confirmed	mergeItemFailedCheck.vitest.ts:87
Hide rows toggle labels (incl. "Trunk (bot) GitHub Comments")	confirmed	popupHideableRows.vitest.ts:47
Actionable conflict rows ("must be resolved" / Resolve conflicts) stay visible	confirmed	prMergeRowHeuristics.ts:280
Toggles default on, persist in chrome.storage.local	confirmed	constants.ts:18
Settings cards: Hide rows / Verbose logging (byte size) / Keyboard shortcuts	confirmed	popupSettingsSections.vitest.ts:16

One label was wrong in the first draft and is now fixed in this PR (92333da): the third Hide rows toggle is "Trunk (bot) GitHub Comments", not "Trunk bot comments". Everything else matches source as written.

---

Toggle label correction (confirmed after fix)

File: popupHideableRows.vitest.ts#L47-L51

expect(mergingBlocked?.name).toBe("Merging is blocked");
expect(branchOutOfDate?.name).toBe("Branch out of date");
expect(botComments?.name).toBe("Trunk (bot) GitHub Comments");

Reasoning: The first draft labeled the third toggle "Trunk bot comments". The on-screen label is "Trunk (bot) GitHub Comments". Corrected in the docs PR so the bold label matches the UI exactly, per the nav/UI standard. The other two toggle labels already matched source.

"Cancelled by <actor>" format (confirmed)

File: mergeItemTerminalDetail.vitest.ts#L76-L123

).toBe("Cancelled by eli");
// ...
it("falls back to cancelled by user when no actor is available", () => {
).toBe("Cancelled by user");

Reasoning: The panel renders "Cancelled by <actor>" using the cancelling user when available, falling back to "Cancelled by user". The docs example "Cancelled by alice" matches the format.

Conflict-row exception (confirmed)

File: prMergeRowHeuristics.ts#L280-L281

"this branch has conflicts that must be resolved";
const RESOLVE_CONFLICTS_CONTROL_SNIPPET = "resolve conflicts";

Reasoning: The "Branch out of date" toggle hides only the informational conflicts row. Rows with "must be resolved" copy or a "Resolve conflicts" control are kept visible, exactly as the docs state.