Issue — Write docstrings for all services/reasoning/

[Devnil434]

Description: services/reasoning/ now has five files (vlm.py, llm.py, pipeline.py, prompts.py, formatters.py) — all written fast during Phase 4 with minimal documentation. Add Google-style docstrings to every public class and function.

Specific focus areas:

• ReasoningPipeline.run() — document the full 5-step flow: get_sequence → caption → ground_check → reason → store_alert
• OllamaVLMCaptioner.caption() — document the base64 encoding step and timeout behaviour
• GROUNDING_PROMPT — add an inline comment block showing expected GROUNDED vs HALLUCINATION: response formats

Acceptance criteria:

• All public methods have Args / Returns / Raises docstrings
• ruff check services/reasoning/ passes with pydocstyle rules
• No logic changes — documentation only

---

[CodeSparks45]

I am very interested in this issue....can you please assign this issue to me under GSSOC'26 I will start work immediately on this issue

[krrishkhanna]

Hi, I’d like to work on this issue for GSSoC 2026.

I went through the reasoning services and would like to add clear docstrings to make the module easier to understand and maintain.

I’ve forked the repository and can start once assigned.

Could you please assign this to me?