docs: refresh server code map

[yyiilluu]

Summary

• refresh the open-source server README endpoint helper map to match current files
• keep a complete grouped key-endpoint list for navigation clarity
• add a service-boundary map covering the publish pipeline, profile/playbook memory, evaluation, async clarification, search, optimization/integrations, and persistence/config responsibilities
• update the README-writing guide to preserve endpoint maps, contracts, requirements, and problems-to-avoid sections when they are durable navigation guardrails

Tests

• uv run python -c "import reflexio"
• git diff --check

[coderabbitai]

📝 Walkthrough

Walkthrough

The server README condenses the api_endpoints/ documentation into a concise directory overview with grouped core endpoint descriptions and adds a new “Service Boundary” section defining service-layer responsibilities and components.

Changes

Server README Documentation Update

Layer / File(s)	Summary
api_endpoints documentation restructure reflexio/server/README.md	The API Endpoints section is rewritten to provide a shorter api_endpoints/ directory overview, replace the detailed "Key Endpoints" listing with grouped "Core Endpoint Groups", simplify authentication notes, and keep guidance to use get_reflexio(org_id) from the cache in route handlers.
Service Boundary section added reflexio/server/README.md	A new "Service Boundary" section was added describing responsibilities owned by the service layer and enumerating main components: publish pipeline, profile/playbook memory, evaluation, async clarification, search preparation, optimization/integrations, and persistence/config.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A README trimmed, now tidy and bright,
Endpoints grouped and the boundaries right,
Service roles listed, the docs gently sing,
Developers hop in—clear notes they bring! 🥕

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'docs: refresh server code map' directly aligns with the PR's main objective to refresh and update the server README documentation.
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.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/update-readme-code-maps

---

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 and usage tips.}