docs: sync README files with latest repo state

[yyiilluu]

Summary

• Updated OSS code-map README entries for the current LLM client layout.
• Documented _provider_concurrency.py and the REFLEXIO_LLM_PROVIDER_MAX_CONCURRENCY fail-open provider cap.

Repositories/submodules reviewed

• Parent: ReflexioAI/reflexio-enterprise
• Submodules: ReflexioAI/reflexio, ReflexioAI/claude-smart

README files updated

• reflexio/README.md
• reflexio/server/README.md

Validation

• git diff --check
• python /root/.hermes/skills/github/scheduled-code-map-readme-maintenance/scripts/readme_link_check.py /root/reflexio-enterprise/open_source/reflexio reflexio/README.md reflexio/server/README.md

Notes/Risks

• Updates follow /root/reflexio-enterprise/how_to_write_readme.md for model-facing code-map READMEs.
• open_source/reflexio/README.md was intentionally left untouched because it is the public/user-facing README excluded by the guide.

Summary by CodeRabbit

• Documentation
  • Updated project documentation to describe the unified LiteLLM client and its provider adapters.
  • Documented local reranking helpers, structured-output repair, and fail-open behavior.
  • Added details about per-provider concurrency caps, configuration, logging, and continued operation during provider saturation.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 371e515d-c6e6-485f-b7a9-5ad35401f486

📥 Commits

Reviewing files that changed from the base of the PR and between 2945f48 and 0035599.

📒 Files selected for processing (2)

• reflexio/README.md
• reflexio/server/README.md

---

📝 Walkthrough

Walkthrough

The README files now describe the unified LiteLLM client, provider adapters, supporting helpers, and fail-open per-provider concurrency caps controlled by REFLEXIO_LLM_PROVIDER_MAX_CONCURRENCY.

Changes

LLM client documentation

Layer / File(s)	Summary
Document client composition and concurrency behavior reflexio/README.md, reflexio/server/README.md	Updates describe LiteLLM provider adapters, helper behavior, _provider_concurrency.py, the concurrency configuration variable, and saturation logging with continued progress.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

• ReflexioAI/reflexio#278: Updates related LLM client module documentation.
• ReflexioAI/reflexio#347: Documents the same provider concurrency feature.

Suggested reviewers: yilu331, guangyu-reflexio

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the README documentation sync reflected by the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/sync-readmes-20260717

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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