Skip to content

docs(observer): expand Test Failure Extraction and Analysis README section#418

Closed
ProtocolWarden wants to merge 2 commits into
mainfrom
goal/c2c5588c
Closed

docs(observer): expand Test Failure Extraction and Analysis README section#418
ProtocolWarden wants to merge 2 commits into
mainfrom
goal/c2c5588c

Conversation

@ProtocolWarden

Copy link
Copy Markdown
Owner

Summary

  • Rewrites the "Test Failure Extraction and Analysis" README section (lines 1038–1353) to cover all extraction capabilities shipped since it was first written
  • Adds four new subsections: Monitoring Extraction Health (extraction-health CLI, JSON/table examples, field reference table), Gaps and Edge Cases (all three sample lists with per-value meaning tables), Alert Integration (threshold table, channel routing, programmatic example), and Troubleshooting (message_quality_rate interpretation table + diagnostic pattern)
  • Updates the overview with the two-axis model (presence success_rate vs. quality message_quality_rate) and reorders sections so health monitoring comes before querying

Accuracy verification

All examples were verified against the actual source before merging:

  • JSON field reference table matches ExtractionHealth dataclass fields (query_flaky.py:107)
  • Table output format matches cli.py:1079–1106 character-for-character
  • history object shape matches cli.py:1058–1070 including trend, weekly_trend, slope, anomalies, observations, recent, snapshots_pruned
  • Alert thresholds (95/80/50/10%) match FlakyTestAlertConfig (flaky_test_alert_config.py:131–142)
  • Channel routing matches config for EXTRACTION_SUCCESS_RATE_LOW and MESSAGE_QUALITY_RATE_LOW
  • FlakyTestAlertManager.check_message_quality_rate() signature and description format verified
  • TimeRange import from operations_center.observer.query confirmed correct

Test plan

  • 167 extraction-related unit tests pass (test_extraction_health_queries.py, test_cli_extraction_health.py, test_assertion_extractor.py)
  • Full test suite: 10,163 passed, 5 pre-existing sandbox failures unchanged (unrelated to this change)
  • Ruff: 0 violations
  • README structural checks: balanced code fences, no broken table rows, cross-links resolve

🤖 Generated with Claude Code

Operations Center Bot and others added 2 commits June 26, 2026 02:34
…ction

Rewrites README.md:1038–1340 to cover all extraction capabilities introduced
since the section was last updated. Adds four new subsections — Monitoring
Extraction Health, Gaps and Edge Cases, Alert Integration, and Troubleshooting
— documenting the extraction-health CLI command, ExtractionHealth fields
(success_rate, message_quality_rate, gaps, edge_cases, low_quality_messages),
alert thresholds, and diagnostic guidance. All code examples verified against
the live implementation (cli.py, ExtractionHealth dataclass, FlakyTestAlertConfig).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ProtocolWarden

Copy link
Copy Markdown
Owner Author

Needs human attention (reason=ci_misconfigured_check). Left open — not merged (unresolved) and not closed (work preserved).

CI has not gone green after 20 checks (1 failing: audit: failure). Not merged (red CI) and not closed (work preserved) — needs a human to fix CI.

@ProtocolWarden

Copy link
Copy Markdown
Owner Author

Closing: CONFLICTING with main (superseded by the observer changes in #417) and stuck in reviewer escalation, blocking the goal lane via OPEN_PR_GATE. The underlying docs task (c2c5588c) can be re-readied to regenerate cleanly against current main. — operator-driven cleanup

@ProtocolWarden ProtocolWarden deleted the goal/c2c5588c branch June 26, 2026 07:06
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