docs: sync README files with latest repo state

[yyiilluu]

Summary

• Updates model-facing evaluation overview code maps for the latest source-set comparison and server-side aggregation flow.
• Documents that source_sets and source_set_comparison live in eval_overview_schema.py and are keyed by (user_id, session_id).

Repositories/submodules reviewed

• ReflexioAI/reflexio submodule, following the parent policy in how_to_write_readme.md.

README files updated

• reflexio/server/README.md
• reflexio/server/services/evaluation_overview/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/server/README.md reflexio/server/services/evaluation_overview/README.md

Notes/Risks

• README-only change; no code changes.
• Does not alter the public, user-facing root README.

Summary by CodeRabbit

• Documentation
  • Expanded evaluation overview documentation to cover metrics, citations, scores, and optional verdicts.
  • Documented source-set cohorts, comparison output, grouping behavior, session identity handling, and validation rules.
  • Updated the public request and response schema documentation with source-set comparison details.

[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

Run ID: 8632a5be-b49b-4e47-a97c-c4266e3d572c

📥 Commits

Reviewing files that changed from the base of the PR and between dda3c0d and ec1de7b.

📒 Files selected for processing (2)

• reflexio/server/README.md
• reflexio/server/services/evaluation_overview/README.md

Included review availability: 4 reviews are currently available. Based on recent review activity, included reviews refill at 5 per hour.

---

📝 Walkthrough

Walkthrough

The documentation describes expanded evaluation overview data sources, API schemas, source-set cohorts, comparison output, identity handling, and validation rules.

Changes

Evaluation overview documentation

Layer / File(s)	Summary
Evaluation overview contract and behavior reflexio/server/README.md, reflexio/server/services/evaluation_overview/README.md	The documentation covers bulk-loaded results, first-request sources, citations, Braintrust scores, optional shadow verdicts, source-set comparison output, collision-safe identities, and validation for duplicate labels or overlapping source values.

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

Merge Risk: ⚪ Minimal · up to ec1de

This PR only synchronizes documentation with the current repository structure and does not change code or runtime behavior; no actionable merge-blocking risk remains after normal checks and review.

Possibly related PRs

• ReflexioAI/reflexio#448: Implements the evaluation overview schemas, service, and storage functionality described by this documentation update.

Suggested reviewers: guangyu-reflexio, yilu331

🚥 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 clearly describes the README-only documentation changes and matches the pull request objectives.
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-20260818

---

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