Skip to content

docs(error-feed): explain the root cause confidence badge - #1130

Open
jedigalt wants to merge 3 commits into
mainfrom
chintan/th-10430-docs-root-cause-analysis-doesnt-explain-its
Open

jedigalt wants to merge 3 commits into
mainfrom
chintan/th-10430-docs-root-cause-analysis-doesnt-explain-its

Conversation

@jedigalt

Copy link
Copy Markdown
Member

What

Error Feed's root cause analysis rates its result High confidence, Medium confidence or Low confidence, but the docs never said what those mean. This PR adds a "Read the result" section to Run a root cause analysis and a pointer from Investigate an issue.

  • Read the result (new): the Synthesis card, the Fix line, and a table of what each confidence level means. The badge rates the root cause, not the fix. The same root cause and fix appear on the Overview tab's Cluster Analysis card, with View reasoning and Create Linear issue.
  • If it fails: a failed run's message also appears in a Synthesis card, with a Low confidence badge and no Fix line. It's an error, not a result. The two messages quoted there are now examples, since the product has more.
  • Names: "Cluster analysis card" and "headline card" become Cluster Analysis, as the UI labels it.
  • Investigate an issue: one sentence on the Cluster Analysis card at the top of the Overview tab.

Evidence (future-agi/future-agi main @08de832)

  • Labels: frontend/src/pages/dashboard/error-feed/constants.js:83-87.
  • Synthesis card: components/AnalyzeTab.jsx:784-886.
  • Cluster Analysis card: components/ClusterHeadlineCard.jsx:195-299, 382-387, 431. It mounts only on the Overview tab (ErrorFeedDetailView.jsx:489-501).
  • Rubric: futureagi/ee/agenthub/cluster_rca/prompts.py:157-161, with one confidence field per synthesis (tools.py:340-367).
  • Failure messages: built as Synthesis messages with Low confidence and an empty fix (clusterAnalyzeSocket.js:440-470, 621, 641, 693).

Left out on purpose

The trace drawer's "Recommendation / Immediate Fix" panel and the Overview "Recommendations & Fixes" section exist in code, but no routed UI mounts them on main, so they aren't documented. TH-10431 tracks the related per-trace scores page.

Checks

  • node scripts/audit-links.mjs: 0 broken links. On astro dev, both pages return 200, and the #read-the-result anchor exists.
  • Review. A Fable 5.1 review checked every label and claim against main: PASS WITH FIXES. Its fixes are in the last commit:
    • The Overview card shows confidence only in its collapsed header, not as a badge.
    • The collapsed-header example is dropped, because the fix layer renders lowercase there.
    • The failure messages are described as examples, not "one of two".

TH-10430

🤖 Generated with Claude Code

jedigalt and others added 3 commits November 19, 2026 02:00
…esults show

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant