docs(merge-queue): configuration issues panel

[samgutentag]

Summary

Adds changelog entry and troubleshooting section for the new Issues tab in the Merge Queue dashboard, which surfaces detected ruleset configuration problems with plain-language explanations and remediation links.

Source

• trunk2 PR: https://github.com/trunk-io/trunk2/pull/4090

Test plan

• Check Mintlify preview link (posted on the PR by the Mintlify GitHub app)

---

Generated by Claude Code

[mintlify]

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

Project	Status	Preview	Updated (UTC)
trunk	🟢 Ready	View Preview	Jun 6, 2026, 12:08 PM

[samgutentag]

Verification status (June 6, 2026): staged

On in staging only. Re-run after prod rollout.

• Eng PR: trunk2#4090
• Flag: showMergeConfigIssues
• Flag state: read directly from LaunchDarkly (production: OFF; test: ON_100)
• Signals: LaunchDarkly direct read (production env, test env)

Hold publishing until the flag is enabled in production. Re-run this check after prod rollout.

---

Generated by Claude Code

[samgutentag]

Verification status (June 6, 2026): staged

On in staging only. Re-run after prod rollout.

• Eng PR: trunk2#4090
• Flag: showMergeConfigIssues
• Flag state: read directly from LaunchDarkly (production: OFF; test: ON_100)
• Signals: LaunchDarkly direct read (production env, test env)

Hold publishing until the flag is enabled in production. Re-run this check after prod rollout.

---

Generated by Claude Code

[samgutentag]

Docs PR Verdict — 2026-06-08

Verdict	🟡 staged
Eng refs	trunk2#4090
LD flag	showMergeConfigIssues
Flag (prod / test)	prod OFF, test ON_100
Notes	Flag off in production; gated for release.

Next sweep: 2026-06-09

---

Generated by Claude Code

[samgutentag]

🟡 Verdict: staged — June 9, 2026

Signal	Status
LD showMergeConfigIssues (prod)	🔴 OFF (on: false)

Feature flag is off in production. Keep as draft until the flag is enabled in prod.

Verified by Daily Docs Sweep · June 9, 2026

---

Generated by Claude Code

[samgutentag]

🟡 Verdict: staged — June 10, 2026

Signal	Detail
LD flag	showMergeConfigIssues
Flag (prod / test)	prod on:false (OFF) ❌ / test ON_100 ✅
Linear	none

Feature enabled in staging only; prod flag off. Hold until showMergeConfigIssues turns on in production.

Verified by Daily Docs Sweep · June 10, 2026

---

Generated by Claude Code

[samgutentag]

🟡 Verdict: staged — June 11, 2026

Signal	Detail
LD flag	showMergeConfigIssues
Flag (prod)	❌ OFF — on: false
Flag (test)	✅ ON_100

Feature enabled in staging only; prod flag off. Hold as draft until showMergeConfigIssues is enabled in production.

Verified by Daily Docs Sweep · June 11, 2026

---

Generated by Claude Code