feat: Suppress macOS dylib warnings during startup and update tool documentation for profiles and core tools.

AGENT.md

@@ -24,7 +24,7 @@ reachy_mini_minder/
 │   ├── src/hooks/                     # Data hooks (see hooks/AGENT.md)
 │   └── src/registry/                  # GenUI components (see registry/AGENT.md)
 ├── tests/                              # Test suite (see tests/AGENT.md)
-├── documentation/                      # Project docs and plans
+├── documentation/                      # Docs, design system, case studies, guides
 ├── .agent/                             # Agent rules and skills
 └── pyproject.toml                      # Package configuration
 ```

frontend/AGENT.md

@@ -49,29 +49,46 @@ The frontend has **no direct database access**. All state flows through these in
 | `ui.dismiss`                                        | `emit_ui_dismiss()`                        | `useConversation`                                |
 | `ui.navigate`                                       | `emit_ui_navigate()`                       | `useConversation` → `ChatInterface`              |
 | `ui.settings_updated`                               | `emit_settings_updated()`                  | `useConversation` → `SettingsPanel`              |
+| `ui.dashboard_updated`                              | `emit_dashboard_updated()`                 | `useConversation` → `DashboardGrid`              |
 | `session.wakeword_detected` / `.started` / `.ended` | `emit_session_event()`                     | `useConversation` → `useSession` (via DOM event) |
 | `cost.update`                                       | `emit_cost_event()`                        | `useObservability`                               |
 | `camera.frame`                                      | `emit_camera_frame()`                      | `useConversation` → `CameraView`                 |
-| `system.database_reset`                             | `reset_database()` endpoint                | `useConversation`                                |
-
-#### REST Endpoints
-
-| Endpoint                      | Method     | Hook/Component     |
-| ----------------------------- | ---------- | ------------------ |
-| `/api/session`                | GET/POST   | `useSession`       |
-| `/api/session/inject-text`    | POST       | `useConversation`  |
-| `/api/listening`              | GET/POST   | `useListening`     |
-| `/api/provider`               | GET/POST   | `useSettings`      |
-| `/api/profile`                | GET/PUT    | `SettingsPanel`    |
-| `/api/medications`            | GET        | `SettingsPanel`    |
-| `/api/wakeword`               | GET/PUT    | `SettingsPanel`    |
-| `/api/consent`                | GET/POST   | `useConsent`       |
-| `/api/conversation-log`       | GET/DELETE | `SettingsPanel`    |
-| `/api/stream/dashboard-stats` | GET        | `useDashboardData` |
-| `/api/stream/observability`   | GET        | `useObservability` |
-| `/api/stream/cost-summary`    | GET        | `useObservability` |
-| `/api/stream/reset-db`        | POST       | `SettingsPanel`    |
-| `/api/move-head`              | POST       | `CameraView`       |
+
+#### REST Endpoints — `console.py` (api_app)
+
+| Endpoint                   | Method     | Hook/Component    |
+| -------------------------- | ---------- | ----------------- |
+| `/api/session`             | GET/POST   | `useSession`      |
+| `/api/session/inject-text` | POST       | `useConversation` |
+| `/api/listening`           | GET/POST   | `useListening`    |
+| `/api/provider`            | GET/POST   | `useSettings`     |
+| `/api/profile`             | GET/PUT    | `SettingsPanel`   |
+| `/api/medications`         | GET        | `SettingsPanel`   |
+| `/api/wakeword`            | GET/PUT    | `SettingsPanel`   |
+| `/api/consent`             | GET/POST   | `useConsent`      |
+| `/api/conversation-log`    | GET/DELETE | `SettingsPanel`   |
+| `/api/missed-doses`        | GET        | (missed dose UI)  |
+| `/api/missed-doses/notify` | POST       | (missed dose UI)  |
+| `/api/appointment-export`  | GET        | `ReportsPanel`    |
+| `/api/move-head`           | POST       | `CameraView`      |
+| `/api/data`                | DELETE     | `SettingsPanel`   |
+| `/api/langgraph`           | DELETE     | `SettingsPanel`   |
+
+#### REST Endpoints — `stream_api.py` (stream router, prefixed `/api/stream/`)
+
+| Endpoint                      | Method | Hook/Component       |
+| ----------------------------- | ------ | -------------------- |
+| `/api/stream/ws`              | WS     | `useConversation`    |
+| `/api/stream/dashboard-stats` | GET    | `useDashboardData`   |
+| `/api/stream/observability`   | GET    | `useObservability`   |
+| `/api/stream/cost-summary`    | GET    | `useObservability`   |
+| `/api/stream/session-log`     | GET    | `ObservabilityPanel` |
+| `/api/stream/status`          | GET    | (health check)       |
+| `/api/stream/reset-db`        | POST   | `SettingsPanel`      |
+| `/api/stream/clear-neo4j`     | POST   | `SettingsPanel`      |
+| `/api/stream/emit-component`  | POST   | (dev tooling)        |
+| `/api/stream/reports`         | GET    | `ReportsPanel`       |
+| `/api/stream/reports/{id}`    | GET    | `ReportsPanel`       |
 
 ### External Dependencies
 
@@ -86,7 +103,7 @@ The frontend has **no direct database access**. All state flows through these in
 
 ## When Adding Features
 
-1. If the feature needs backend data → add REST endpoint in `console.py` → consume in a hook
+1. If the feature needs backend data → add REST endpoint in `console.py` or `stream_api.py` → consume in a hook
 2. If the feature needs real-time updates → add `emit_*()` in `stream_api.py` → handle in `useConversation`
 3. If the feature renders LLM-driven UI → add GenUI component in `registry/` → trigger via `emit_ui_component()` in a backend tool
 4. Update this `AGENT.md` tables when adding new endpoints or events

frontend/src/registry/AGENT.md

@@ -12,24 +12,26 @@ Components are registered in `index.tsx` and rendered by `ComponentOverlay` / `C
 
 | GenUI Component                        | Triggered By (Backend Tool)                                  | Tool Location                                                                      |
 | -------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
-| `OnboardingProgress`                   | `show_onboarding_step`                                       | `profiles/_locked_profile/show_onboarding_step.py`                                 |
+| `OnboardingProgress`                   | `show_onboarding_step`, `get_onboarding_status`              | `profiles/_locked_profile/show_onboarding_step.py`, `get_onboarding_status.py`     |
+| `OnboardingReview`                     | `show_onboarding_review`                                     | `profiles/_locked_profile/show_onboarding_review.py`                               |
 | `OnboardingSummary`                    | `complete_onboarding`                                        | `profiles/_locked_profile/complete_onboarding.py`                                  |
 | `ProfileCard`                          | `complete_onboarding`                                        | `profiles/_locked_profile/complete_onboarding.py`                                  |
-| `MedicationCard`                       | `setup_medication`                                           | `profiles/_locked_profile/setup_medication.py`                                     |
+| `MedicationCard`                       | `setup_medication`, `update_my_medication`                   | `profiles/_locked_profile/setup_medication.py`, `update_my_medication.py`          |
 | `MedLog`                               | `start_medication_entry`, `update_medication_entry`          | `profiles/_locked_profile/start_medication_entry.py`, `update_medication_entry.py` |
 | `HeadacheLog`                          | `start_headache_entry`, `update_headache_entry`              | `profiles/_locked_profile/start_headache_entry.py`, `update_headache_entry.py`     |
 | `ConfirmationCard`                     | `save_current_entry`                                         | `profiles/_locked_profile/save_current_entry.py`                                   |
 | `EntryCard`                            | `entry_control`                                              | `profiles/_locked_profile/entry_control.py`                                        |
 | `HistoryTimeline`                      | `get_recent_entries`                                         | `profiles/_locked_profile/get_recent_entries.py`                                   |
-| `MyMedsList`                           | `get_my_medications`                                         | `profiles/_locked_profile/get_my_medications.py`                                   |
+| `MyMedsList`                           | `get_my_medications`, `update_my_medication`                 | `profiles/_locked_profile/get_my_medications.py`, `update_my_medication.py`        |
 | `OptionsPicker`                        | `entry_control`                                              | `profiles/_locked_profile/entry_control.py`                                        |
 | `QuickReply`                           | `log_entry`                                                  | `profiles/_locked_profile/log_entry.py`                                            |
 | `ReportPreview` / `ReportConfirmation` | `send_report`                                                | `profiles/_locked_profile/send_report.py`                                          |
+| `TrendChart`                           | `query_health_history`                                       | `tools/query_health_history.py`                                                    |
 | `SessionSummary`                       | `session_summary` tool                                       | `tools/session_summary.py`                                                         |
 | `DailySnapshot`                        | `check_medication`                                           | `tools/check_medication.py`                                                        |
 | `CheckInCard`                          | `check_medication`                                           | `tools/check_medication.py`                                                        |
 | `MedStatus`                            | `check_medication`, `log_entry`                              | `tools/check_medication.py`, `profiles/_locked_profile/log_entry.py`               |
-| `MusicPicker`                          | `media_control`                                              | `tools/media_control.py`                                                           |
+| `MusicPicker`                          | `media_control`, `list_music`                                | `tools/media_control.py`, `tools/list_music.py`                                    |
 | `NowPlaying`                           | `media_control`, `resume_music`, `pause_music`, `stop_music` | `tools/media_control.py`, `resume_music.py`, etc.                                  |
 | `VolumeControl`                        | `set_volume`                                                 | `tools/set_volume.py`                                                              |
 | `SettingsConfirmation`                 | `update_settings`                                            | `profiles/_locked_profile/update_settings.py`                                      |

src/AGENT.md

@@ -8,19 +8,48 @@ Contains the main Python package `reachy_mini_conversation_app`. This is the cor
 
 ```
 src/reachy_mini_conversation_app/
-├── console.py           # FastAPI server (API endpoints + audio pipeline)
-├── main.py              # ReachyMiniApp entry point (robot mode)
-├── stream_api.py        # WebSocket streaming + REST endpoints → frontend bridge
-├── openai_realtime.py   # OpenAI Realtime API handler
-├── database.py          # SQLite CRUD operations
-├── tools/               # LLM tools (see tools/AGENT.md)
-├── prompts/             # System prompts (see prompts/AGENT.md)
-├── profiles/            # Conversation profiles (see profiles/AGENT.md)
+├── console.py              # FastAPI server (API endpoints + audio pipeline)
+├── main.py                 # ReachyMiniApp entry point (robot mode)
+├── stream_api.py           # WebSocket streaming + REST endpoints → frontend bridge
+├── openai_realtime.py      # OpenAI Realtime API handler
+├── realtime_handler.py     # Base handler class
+├── handler_factory.py      # Creates OpenAI handler
+├── database.py             # SQLite CRUD operations
+├── config.py               # Application configuration
+├── schemas.py              # Pydantic models / data schemas
+├── utils.py                # Shared utilities
+├── entry_state.py          # Health entry state machine
+├── prompts.py              # Prompt builder/combiner
+├── session_enrichment.py   # Neo4j graph enrichment at session start
+├── session_summary.py      # Session summary generation
+├── appointment_export.py   # Clinical report export
+├── email_service.py        # Email delivery service
+├── memory_graph.py         # Neo4j knowledge graph operations
+├── memory_notes.py         # Session memory notes
+├── graph_query_engine.py   # Neo4j query engine
+├── pattern_detector.py     # Health pattern detection
+├── missed_dose_detection.py # Missed dose tracking
+├── pii_guard.py            # PII redaction
+├── checkin_scheduler.py    # Proactive check-in scheduling
+├── computer_audio.py       # Host audio routing (music playback)
+├── wakeword_detector.py    # Wakeword detection
+├── camera_worker.py        # Camera frame capture
+├── moves.py                # Robot movement definitions
+├── dance_emotion_moves.py  # Dance & emotion sequences
+├── headless_personality.py # Headless mode personality
+├── headless_personality_ui.py # Headless personality UI
+├── robot_control_api.py    # Robot control REST API router
+├── tools/                  # LLM tools (see tools/AGENT.md)
+├── prompts/                # System prompts (see prompts/AGENT.md)
+├── profiles/               # Conversation profiles (see profiles/AGENT.md)
 │   └── _reachy_mini_minder_locked_profile/  # Clinical tools + GenUI emitters
-├── session_enrichment.py  # Neo4j graph enrichment
-├── wakeword_detector.py   # Wakeword detection
-├── computer_audio.py      # Host audio routing (music playback)
-└── camera_worker.py       # Camera frame capture
+├── langgraph_agent/        # LangGraph agent integration
+├── audio/                  # Audio utilities
+├── vision/                 # Vision processing
+├── models/                 # Data models
+├── static/                 # Static assets
+├── templates/              # HTML templates
+└── images/                 # Image assets
 ```
 
 ### Key Entry Points
@@ -53,4 +82,4 @@ python src/reachy_mini_conversation_app/console.py
 
 ## Configuration
 
-Database stored at `src/reachy_mini_conversation_app/mini_minder.db`.
+Database stored at project root: `mini_minder.db`.

src/reachy_mini_conversation_app/main.py

@@ -8,6 +8,32 @@ import argparse
 import threading
 from typing import Optional
 from pathlib import Path
+from contextlib import contextmanager
+
+
+@contextmanager
+def _suppress_duplicate_dylib_warnings():
+    """Suppress macOS ObjC duplicate class warnings from cv2/av FFmpeg dylibs.
+
+    Both opencv-python and PyAV (via aiortc) bundle their own FFmpeg libavdevice,
+    which registers identical ObjC classes (AVFFrameReceiver, AVFAudioReceiver).
+    The warning is cosmetic and harmless, but noisy. We redirect C-level stderr
+    (fd 2) to /dev/null during the imports that trigger these registrations.
+    """
+    if sys.platform != "darwin":
+        yield
+        return
+
+    devnull_fd = os.open(os.devnull, os.O_WRONLY)
+    original_stderr_fd = os.dup(2)
+    try:
+        os.dup2(devnull_fd, 2)
+        yield
+    finally:
+        os.dup2(original_stderr_fd, 2)
+        os.close(original_stderr_fd)
+        os.close(devnull_fd)
+
 
 from fastapi import FastAPI
 
@@ -35,13 +61,15 @@ def run(
 ) -> None:
     """Run the Reachy Mini conversation app."""
     # Putting these dependencies here makes the dashboard faster to load when the conversation app is installed
-    from reachy_mini_conversation_app.moves import MovementManager
-    from reachy_mini_conversation_app.console import LocalStream
-    from reachy_mini_conversation_app.handler_factory import create_handler
-    from reachy_mini_conversation_app.tools.core_tools import ToolDependencies
-    from reachy_mini_conversation_app.audio.head_wobbler import HeadWobbler
-    from reachy_mini_conversation_app.database import MiniMinderDB
-    from reachy_mini_conversation_app.entry_state import EntryStateManager
+    # Suppress macOS ObjC duplicate class warnings from cv2/av bundled FFmpeg libs
+    with _suppress_duplicate_dylib_warnings():
+        from reachy_mini_conversation_app.moves import MovementManager
+        from reachy_mini_conversation_app.console import LocalStream
+        from reachy_mini_conversation_app.handler_factory import create_handler
+        from reachy_mini_conversation_app.tools.core_tools import ToolDependencies
+        from reachy_mini_conversation_app.audio.head_wobbler import HeadWobbler
+        from reachy_mini_conversation_app.database import MiniMinderDB
+        from reachy_mini_conversation_app.entry_state import EntryStateManager
 
     logger = setup_logger(args.debug)
     logger.info("Starting Reachy Mini Conversation App")

src/reachy_mini_conversation_app/profiles/AGENT.md

@@ -20,14 +20,18 @@ profiles/
 
 | Tool File                    | Purpose                     | Emits GenUI                                          |
 | ---------------------------- | --------------------------- | ---------------------------------------------------- |
-| `show_onboarding_step.py`    | Onboarding wizard           | `OnboardingProgress`                                 |
+| `show_onboarding_step.py`    | Onboarding wizard step      | `OnboardingProgress`                                 |
+| `show_onboarding_review.py`  | Onboarding review/edit      | `OnboardingReview`                                   |
+| `get_onboarding_status.py`   | Check onboarding state      | `OnboardingProgress`                                 |
 | `complete_onboarding.py`     | Finish onboarding           | `OnboardingSummary`, `ProfileCard`                   |
 | `setup_medication.py`        | Add medication to schedule  | `MedicationCard`                                     |
+| `update_my_medication.py`    | Edit existing medication    | `MedicationCard`, `MyMedsList`                       |
 | `start_medication_entry.py`  | Begin med log               | `MedLog`                                             |
 | `update_medication_entry.py` | Update med fields           | `MedLog`                                             |
 | `start_headache_entry.py`    | Begin headache log          | `HeadacheLog`                                        |
 | `update_headache_entry.py`   | Update headache fields      | `HeadacheLog`                                        |
 | `save_current_entry.py`      | Save entry to DB            | `ConfirmationCard`                                   |
+| `discard_current_entry.py`   | Discard in-progress entry   | —                                                    |
 | `entry_control.py`           | Entry list/selection        | `EntryCard`, `OptionsPicker`                         |
 | `log_entry.py`               | Quick log (med or headache) | `MedStatus`, `QuickReply`                            |
 | `get_recent_entries.py`      | History view                | `HistoryTimeline`                                    |
@@ -36,18 +40,21 @@ profiles/
 | `update_settings.py`         | Voice settings update       | `SettingsConfirmation` + `ui.settings_updated` event |
 | `ui_control.py`              | Voice navigation            | (emits `ui.navigate` event)                          |
 | `dismiss_ui.py`              | Close GenUI overlay         | (emits `ui.dismiss` event)                           |
+| `get_current_datetime.py`    | Get current date/time       | —                                                    |
+| `sweep_look.py`              | Robot sweep look animation  | —                                                    |
+| `custom_tool.py`             | Custom tool base/template   | —                                                    |
 
 ## Profile Naming
 
 - `_locked` suffix: Profile cannot be modified by users
 - Profile names must match folder names exactly
 
-## Adding New Profiles
+## Adding New Profile Tools
 
-1. Create folder with profile name
-2. Add `config.yaml` with required fields
-3. Add `system_prompt.txt` for base personality
-4. Register in `__init__.py` if needed
+1. Create tool `.py` file in the profile directory
+2. Register in `tools.txt`
+3. If tool emits GenUI → create component in `frontend/src/registry/` and register in `index.tsx`
+4. Update this `AGENT.md`
 
 ## Dependencies & Connections
 

src/reachy_mini_conversation_app/prompts/AGENT.md

@@ -8,10 +8,19 @@ System prompts and personality fragments for the conversation agent. These are l
 
 ```
 prompts/
-├── default_prompt.txt       # Base system prompt
-├── passion_for_lobster_jokes.txt  # Personality fragment
-├── behaviors/               # Behavioral modifiers
-└── identities/              # Identity/persona definitions
+├── default_prompt.txt              # Base system prompt
+├── passion_for_lobster_jokes.txt   # Personality fragment
+├── behaviors/                      # Behavioral modifiers
+├── identities/                     # Identity/persona definitions
+└── sections/                       # Modular prompt sections
+    ├── core_identity.txt           # Core identity definition
+    ├── health_logging.txt          # Health logging instructions
+    ├── music_volume.txt            # Music & volume control
+    ├── onboarding.txt              # Onboarding flow instructions
+    ├── reporting.txt               # Report generation rules
+    ├── safety_rules.txt            # Safety & medical guardrails
+    ├── tool_budget.txt             # Tool call budgets
+    └── ui_navigation.txt           # UI navigation rules
 ```
 
 ## Usage
@@ -35,4 +44,4 @@ Prompts are loaded by `prompts.py` and combined with profile-specific instructio
 - **Used by**: `openai_realtime.py`, `handler_factory.py` — injected into LLM session
 - **Profile link**: `profiles/_reachy_mini_minder_locked_profile/instructions.txt` contains the main profile prompt
 - **Dynamic assembly**: `session_enrichment.py` may inject context-aware sections at session start
-- **Frontend impact**: Prompt changes affect LLM behavior, which indirectly affects tool calls and GenUI output
+- **Frontend impact**: Prompt changes affect LLM behaviour, which indirectly affects tool calls and GenUI output

src/reachy_mini_conversation_app/tools/AGENT.md

@@ -6,24 +6,30 @@ LLM tool definitions for the Mini Minder conversation agent. These tools are reg
 
 ## Structure & Navigation
 
-| File                                | Purpose                            | Emits GenUI                                 | Emits Event             |
-| ----------------------------------- | ---------------------------------- | ------------------------------------------- | ----------------------- |
-| `check_medication.py`               | Medication check-in                | `DailySnapshot`, `CheckInCard`, `MedStatus` | `ui.component`          |
-| `media_control.py`                  | Consolidated play/pause/stop music | `MusicPicker`, `NowPlaying`                 | `ui.component`          |
-| `play_music.py`                     | Play a specific track              | `NowPlaying`                                | `ui.component`          |
-| `pause_music.py`                    | Pause playback                     | `NowPlaying`                                | `ui.component`          |
-| `resume_music.py`                   | Resume playback                    | `NowPlaying`                                | `ui.component`          |
-| `stop_music.py`                     | Stop playback                      | `NowPlaying`                                | `ui.component`          |
-| `set_volume.py`                     | Adjust volume                      | `VolumeControl`                             | `ui.component`          |
-| `session_summary.py`                | End-of-session summary             | `SessionSummary`                            | `ui.component`          |
-| `end_session.py`                    | End current session                | —                                           | `session.end_requested` |
-| `play_emotion.py`                   | Trigger robot expressions          | —                                           | —                       |
-| `move_head.py`                      | Control robot head                 | —                                           | —                       |
-| `dance.py`                          | Start dance sequences              | —                                           | —                       |
-| `stop_dance.py` / `stop_emotion.py` | Cancel ongoing actions             | —                                           | —                       |
-| `camera.py`                         | Camera control                     | —                                           | —                       |
-| `head_tracking.py`                  | Face/object tracking               | —                                           | —                       |
-| `do_nothing.py`                     | Explicit no-op                     | —                                           | —                       |
+| File                       | Purpose                            | Emits GenUI                                 | Emits Event             |
+| -------------------------- | ---------------------------------- | ------------------------------------------- | ----------------------- |
+| `check_medication.py`      | Medication check-in                | `DailySnapshot`, `CheckInCard`, `MedStatus` | `ui.component`          |
+| `check_health_patterns.py` | Health pattern analysis            | —                                           | —                       |
+| `query_health_history.py`  | Query health history               | `TrendChart`                                | `ui.component`          |
+| `core_tools.py`            | Shared tool utilities              | —                                           | —                       |
+| `media_control.py`         | Consolidated play/pause/stop music | `MusicPicker`, `NowPlaying`                 | `ui.component`          |
+| `list_music.py`            | List available music               | `MusicPicker`                               | `ui.component`          |
+| `play_music.py`            | Play a specific track              | `NowPlaying`                                | `ui.component`          |
+| `pause_music.py`           | Pause playback                     | `NowPlaying`                                | `ui.component`          |
+| `resume_music.py`          | Resume playback                    | `NowPlaying`                                | `ui.component`          |
+| `stop_music.py`            | Stop playback                      | `NowPlaying`                                | `ui.component`          |
+| `set_volume.py`            | Adjust volume                      | `VolumeControl`                             | `ui.component`          |
+| `session_summary.py`       | End-of-session summary             | `SessionSummary`                            | `ui.component`          |
+| `end_session.py`           | End current session                | —                                           | `session.end_requested` |
+| `play_emotion.py`          | Trigger robot expressions          | —                                           | —                       |
+| `robot_expression.py`      | Robot expression utilities         | —                                           | —                       |
+| `move_head.py`             | Control robot head                 | —                                           | —                       |
+| `dance.py`                 | Start dance sequences              | —                                           | —                       |
+| `stop_dance.py`            | Cancel ongoing dance               | —                                           | —                       |
+| `stop_emotion.py`          | Cancel ongoing emotion             | —                                           | —                       |
+| `camera.py`                | Camera control                     | —                                           | —                       |
+| `head_tracking.py`         | Face/object tracking               | —                                           | —                       |
+| `do_nothing.py`            | Explicit no-op                     | —                                           | —                       |
 
 **Note:** Additional clinical tools live in `profiles/_reachy_mini_minder_locked_profile/` (see `profiles/AGENT.md`).
 

tests/AGENT.md

@@ -6,15 +6,25 @@ Test suite for Mini Minder. Uses pytest with fixtures for database mocking.
 
 ## Structure & Navigation
 
-| Test File                     | Tests Module                      | Key Assertions                     |
-| ----------------------------- | --------------------------------- | ---------------------------------- |
-| `test_database.py`            | `database.py`                     | CRUD operations, schema migrations |
-| `test_database_onboarding.py` | `database.py` (onboarding)        | Profile creation, onboarding flow  |
-| `test_minder_tools.py`        | `tools/*.py`                      | Tool schemas, execution, DB writes |
-| `test_onboarding_tools.py`    | `profiles/_locked_profile/` tools | Onboarding step progression        |
-| `test_openai_realtime.py`     | `openai_realtime.py`              | OpenAI Realtime session lifecycle  |
-| `test_handler_factory.py`     | `handler_factory.py`              | Factory pattern, handler creation  |
-| `conftest.py`                 | —                                 | Shared fixtures (`test_db`, mocks) |
+| Test File                          | Tests Module                                  | Key Assertions                     |
+| ---------------------------------- | --------------------------------------------- | ---------------------------------- |
+| `test_database.py`                 | `database.py`                                 | CRUD operations, schema migrations |
+| `test_database_onboarding.py`      | `database.py` (onboarding)                    | Profile creation, onboarding flow  |
+| `test_minder_tools.py`             | `tools/*.py`                                  | Tool schemas, execution, DB writes |
+| `test_onboarding_tools.py`         | `profiles/_locked_profile/` tools             | Onboarding step progression        |
+| `test_openai_realtime.py`          | `openai_realtime.py`                          | OpenAI Realtime session lifecycle  |
+| `test_update_settings.py`          | `profiles/_locked_profile/update_settings.py` | Settings update tool               |
+| `test_memory_graph.py`             | `memory_graph.py`                             | Neo4j knowledge graph ops          |
+| `test_memory_notes.py`             | `memory_notes.py`                             | Session memory notes               |
+| `test_graph_query_engine.py`       | `graph_query_engine.py`                       | Neo4j query engine                 |
+| `test_pattern_detector.py`         | `pattern_detector.py`                         | Health pattern detection           |
+| `test_pii_guard.py`                | `pii_guard.py`                                | PII redaction                      |
+| `test_session_enrichment.py`       | `session_enrichment.py`                       | Session enrichment pipeline        |
+| `test_session_logging.py`          | Session logging                               | Session log persistence            |
+| `test_output_escaping.py`          | Output escaping                               | XSS/injection prevention           |
+| `test_robot_control_api.py`        | `robot_control_api.py`                        | Robot control REST API             |
+| `test_wakeword_and_end_session.py` | `wakeword_detector.py`, `end_session.py`      | Wakeword + session end lifecycle   |
+| `conftest.py`                      | —                                             | Shared fixtures (`test_db`, mocks) |
 
 ## Development Workflow
 
@@ -34,7 +44,7 @@ pytest tests/ --cov=src/reachy_mini_conversation_app
 - **Test location**: `tests/`
 - **Fixtures**: `conftest.py` provides `test_db` fixture
 - **Markers**: None currently defined
-- **Special cases**: Audio tests require fixtures in `tests/audio/`
+- **Special cases**: Audio tests require fixtures in `tests/audio/`, vision tests in `tests/vision/`
 
 ## Dependencies & Connections