docs: sync README files with latest repo state#381
Conversation
📝 WalkthroughWalkthroughChangesAgent Success Sampling Documentation
Estimated code review effort: 1 (Trivial) | ~3 minutes Suggested reviewers: 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 inconclusive)
✅ Passed checks (4 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@reflexio/server/README.md`:
- Line 427: Update the README flow description around the sampling entry to
distinguish inactivity scheduling from publish admission: show that
generation_service.py and sampling.py own publish-path sampling, while
agent_success_evaluation/scheduler.py handles the separate inactivity path.
Ensure the documented flow no longer implies that publish admission routes
directly through the inactivity scheduler.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro Plus
Run ID: 1663b6a8-ac8b-406a-a5e6-c16a1bbc2452
📒 Files selected for processing (3)
reflexio/server/README.mdreflexio/server/services/README.mdreflexio/server/services/agent_success_evaluation/README.md
| - `agent_success_evaluation_constants.py`: Output schema (`AgentSuccessEvaluationOutput`) | ||
| - `agent_success_evaluation_utils.py`: Message construction utilities | ||
| - `scheduler.py`: `GroupEvaluationScheduler` singleton - min-heap priority queue with daemon thread, defers evaluation until 10 min after last request in session | ||
| - `sampling.py`: deterministic per-session sampling for the session-success and retrieved-learning judge families; the publish scheduler samples once and passes explicit booleans to the runner |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Align the flow description with the documented sampling owner.
This new entry correctly says generation_service.py performs publish-path sampling, but the adjacent flow still routes directly through agent_success_evaluation/scheduler.py. Clarify that the inactivity scheduler and publish admission are separate paths, or update the flow to include generation_service.py/sampling.py.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@reflexio/server/README.md` at line 427, Update the README flow description
around the sampling entry to distinguish inactivity scheduling from publish
admission: show that generation_service.py and sampling.py own publish-path
sampling, while agent_success_evaluation/scheduler.py handles the separate
inactivity path. Ensure the documented flow no longer implies that publish
admission routes directly through the inactivity scheduler.
Summary
agent_success_evaluation/sampling.pymodule.Repositories/submodules reviewed
ReflexioAI/reflexio-enterpriseReflexioAI/claude-smart,ReflexioAI/reflexioREADME files updated
reflexio/server/README.mdreflexio/server/services/README.mdreflexio/server/services/agent_success_evaluation/README.mdValidation
git diff --checkpython /root/.hermes/skills/github/scheduled-code-map-readme-maintenance/scripts/readme_link_check.py . reflexio/server/README.md reflexio/server/services/README.md reflexio/server/services/agent_success_evaluation/README.mdNotes/Risks
how_to_write_readme.mdfor model-facing code-map READMEs.Summary by CodeRabbit