docs: fact-check and refresh the project + site documentation

[VforVitorio]

Three parallel reviewers audited the project docs (root) and the docs.f1stratlab.com site (docs/pages/), verifying every claim/command/path/signature/example against the current code before editing — the repo's standing rule that docs must not 'teach the bugs'. 22 files, +856/-159.

Highlights

• Root: Python 3.10-3.12; correct F1-StratLab URLs; CLI defaults to lmstudio (not OpenAI); full CI job set + security workflows; INDEX.md now documents engine.py::run_lap (the shared per-lap pipeline) + the strategy router.
• backend-api.md: real auth / rate-limit / /mcp layers, actual endpoints + 422-vs-500 split, removed a phantom auth router.
• agents-api.md: new fix(agents): every LLM-facing tool except one accepts unvalidated free text #476 LLM input-validation section; full 14-field StrategyRecommendation table incl the Strategy: expected_stint_end is unvalidated LLM free text (can exceed the system's own tyre capacity) #433 clamp + vsc_active; fixed a fabricated tire warning level.
• architecture.md: RaceState corrected to a per-lap single-driver snapshot.
• simulation.md: dropped the dead Kafka / /ws/replay path.
• ci-cd.md: branching diagram feature -> dev, release-please v5, missing jobs.
• changelog / home / meet-the-author / roadmap: refreshed to the defended 10/10 project, 6 sub-agents, Babel dropped. Streamlit docs left accurate (v2 migration not done yet).

Flags for a human check (reviewers could not verify)

• URL conflict: home.md/meet-the-author.md link f1stratlab.com while README.md links the GitHub-Pages subdomain.
• Your current NTT DATA internship title (in meet-the-author.md).
• Dead --provider CLI flag in src/arcade/main.py (code, not docs).

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a59c5608-f6d4-40d3-b2a5-d790e002198b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/update

---

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.}