From 5142c2c0a6f9edb231572800cccea6beddcbe7a2 Mon Sep 17 00:00:00 2001
From: Brad Harris <bmharris@gmail.com>
Date: Mon, 13 Jul 2026 22:06:49 -0600
Subject: [PATCH] docs: fix review resolution states and add human-side review
 interactions

The review feedback resolution simplified from three states (fixed/ignored/wont_fix)
to two (fixed/dismissed). Updated tools.tsx, agents.tsx, and the diff-review tip.
Also documented that humans can now reply, resolve, and reopen review feedback items
directly from the UI (inline in the diff and from the Reviews sidebar tab).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 apps/web/src/components/app/docs-sections/agents.tsx | 12 +++++++++---
 apps/web/src/components/app/docs-sections/tools.tsx  |  2 +-
 apps/web/src/lib/tips/tips.ts                        |  2 +-
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/apps/web/src/components/app/docs-sections/agents.tsx b/apps/web/src/components/app/docs-sections/agents.tsx
index d9dd71a7..4f362f23 100644
--- a/apps/web/src/components/app/docs-sections/agents.tsx
+++ b/apps/web/src/components/app/docs-sections/agents.tsx
@@ -205,9 +205,15 @@ export function AgentsContent() {
           <strong>Submit review</strong> button. Keep adding draft comments
           across different files, then submit them all at once with an optional
           summary. Each comment becomes a feedback item the agent can see via
-          its <Code>dispatch_review_list_feedback</Code> tool. The agent can
-          reply to individual items, resolve them, or ask clarifying questions —
-          all visible in the <strong>Reviews</strong> tab of the media sidebar.
+          its <Code>dispatch_review_list_feedback</Code> tool.
+        </P>
+        <P>
+          Feedback threads are interactive from both sides. The agent can reply,
+          resolve items as <strong>fixed</strong> or <strong>dismissed</strong>,
+          or ask clarifying questions via MCP tools. You can do the same from
+          the UI — reply to a thread, mark an item resolved, or reopen it —
+          either inline in the diff or from the <strong>Reviews</strong> tab of
+          the media sidebar.
         </P>
       </Section>
 
diff --git a/apps/web/src/components/app/docs-sections/tools.tsx b/apps/web/src/components/app/docs-sections/tools.tsx
index 0daf1706..af2c155e 100644
--- a/apps/web/src/components/app/docs-sections/tools.tsx
+++ b/apps/web/src/components/app/docs-sections/tools.tsx
@@ -177,7 +177,7 @@ export function ToolsContent() {
           </li>
           <li>
             <Code>dispatch_review_resolve</Code> — resolve a review feedback
-            item as fixed, ignored, or wont_fix
+            item as fixed or dismissed
           </li>
           <li>
             <Code>dispatch_review_add_message</Code> — reply to a review
diff --git a/apps/web/src/lib/tips/tips.ts b/apps/web/src/lib/tips/tips.ts
index b0708747..447b3bb7 100644
--- a/apps/web/src/lib/tips/tips.ts
+++ b/apps/web/src/lib/tips/tips.ts
@@ -167,7 +167,7 @@ export const tips: Tip[] = [
   {
     id: "diff-review",
     title: "Diff Review",
-    body: "Select lines in the Changes tab and submit review comments. The agent can respond, resolve items, or ask questions in threaded conversations.",
+    body: "Select lines in the Changes tab and submit review comments. Both you and the agent can reply, resolve, or reopen items in threaded conversations.",
     docsSection: "agents",
     since: "0.27.0",
     surfaces: ["ambient"],