docs: update CLAUDE.md and README.md with recent improvements

[frankbria]

Updated both documentation files to reflect recent enhancements and fixes:

CLAUDE.md Changes:

• Added comprehensive Core Architecture section detailing main scripts and lib/ components
• Documented lib/circuit_breaker.sh and lib/response_analyzer.sh modular architecture
• Added detailed Exit Conditions and Thresholds section with circuit breaker thresholds
• Documented advanced two-stage error detection process to eliminate false positives
• Documented multi-line error matching for accurate stuck loop detection
• Added Recent Improvements section highlighting v0.9.0 circuit breaker enhancements
• Updated Global Installation section to include lib/ directory and ralph-import command
• Test coverage details: 13 error detection + 9 stuck loop tests

README.md Changes:

• Updated "What's Working Now" section with circuit breaker enhancements
• Added "Recent Improvements" section highlighting v0.9.0 updates
• Updated test count from 75 to 97 tests (75 core + 13 error detection + 9 stuck loop)
• Enhanced circuit breaker description with two-stage filtering details
• Added circuit breaker thresholds to Exit Thresholds section
• Updated test commands to include error detection and stuck loop test scripts
• Updated current test status with specialized test file counts

Key improvements documented:

• Multi-line error matching fix for detect_stuck_loop function
• JSON field false positive elimination (e.g., "is_error": false)
• Two-stage error filtering for accurate error detection
• Installation fix for lib/ directory components
• 22 new tests added for circuit breaker functionality

These updates ensure documentation accurately reflects the current state of the
codebase following PR #6 (circuit-breaker false positives fix) and PR #4
(installation lib/ directory fix).

Summary by CodeRabbit

• Documentation
  • Enhanced documentation for Circuit Breaker capabilities, including two-stage error filtering and multi-line error matching for improved stuck loop detection.
  • Expanded test suite documentation: 97 total tests (75 core, 13 error detection, 9 stuck loop tests) with 100% pass rate.
  • Added detailed sections for exit thresholds, circuit breaker thresholds, and configuration examples.
  • Updated installation guidance and feature documentation.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Documentation updates to CLAUDE.md and README.md introduce comprehensive coverage of v0.9.0 improvements, including Circuit Breaker enhancements, error detection mechanisms, library installation paths, and expanded testing metrics (75 to 97 tests). No code-level changes are present.

Changes

Cohort / File(s)	Summary
Documentation Expansion CLAUDE.md	Adds extensive sections for Main Scripts, Library Components (lib/), Global Installation (including ralph-import and library paths), Exit Conditions and Thresholds (with two-stage JSON filtering and multi-line error matching), Recent Improvements (Circuit Breaker Enhancements v0.9.0), and testing/quality standards with feature completion checklist.
Feature & Metrics Updates README.md	Updates Circuit Breaker documentation with advanced error detection and two-stage filtering details; expands Response Analyzer description; increases test suite metrics from 75 to 97 tests with breakdown (75 core + 13 error detection + 9 stuck loop); adds Recent Improvements section for v0.9.0; updates quick-start commands and circuit breaker threshold criteria (3/no progress or 5 repeated errors).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 Documentation blooms with care,
v0.9.0 improvements laid bare,
Ninety-seven tests now shine,
Error detection so fine,
The circuit breaker stands tall and fair! ✨

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude/update-docs-x8G2u

---

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8158e38 and 38aa53c.

📒 Files selected for processing (2)

• CLAUDE.md
• README.md

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}