Water Coach

water-coach 1.7.0 - Fixed: The `water dynamic` command now correctly resets the hourly notification counter when the hour changes, preventing missed notifications at hour boundaries. - Fixed: Weekly and monthly analytics now sum water intake per day using the correct CSV column (`ml_drank`), resolving errors from missing `cumulative_ml`. - Documentation updated to clarify bug fixes and reference correct analytics usage. - No database, config, or CLI changes to user experience expected outside these bug fixes.

Added clear documentation: user data is stored in agent workspace /memory/data, not in skill folder.

Fixed log_water to auto-populate message_id. Improved get_current_message_id to search recursively through recent sessions.

Removed hardcoded 9am schedule - user configures their own. Removed no_log skip logic - notifications always send. Updated first-time setup to ask user about notification preferences.

Updated morning notification to send even if no water logged yet - the notification stimulates user to drink

Updated morning notification to send even if no water logged yet - the notification stimulates user to drink

Added 9am morning notification rule - send even if no water logged yet

Water Coach 1.5.8 - Clarified and simplified first-time setup instructions; made weight/goal the only initial questions. - Updated instructions for other agents: reinforced that only water intake and weight/goal should be asked on setup. - Added sample data files: water_config.json and water_log.csv for configuration and hydration logs. - Minor documentation updates and adjustments in tests.

water-coach 1.5.7 - Minor update to scripts/water.py. - No user-facing changes or updates to documentation. - All functionality and CLI remain the same.

water-coach 1.5.6 - Internal update to scripts/water_coach.py — minor changes only. - No changes to user-facing features, commands, or documented behavior.

- Added explicit water setup status check via water setup command for better detection of first-time vs. returning users. - Updated SKILL.md instructions: agents should use water setup to determine user config presence instead of water config. - Clarified setup logic and behavior for initial user interaction in the documentation. - No changes to CLI, data format, or daily commands—documentation improvements only.

water-coach 1.5.4 - Added guidance for agent developers: clarify detection of first-time vs returning users. - Now instructs agents to ask only for weight on first use and auto-create config with sensible defaults. - Agents should no longer ask about reminder schedules or preferences unless users request. - No changes to CLI or user-facing commands.

water-coach 1.5.3 - Updated core hydration tracking logic in scripts/water.py. - No user-facing command or documentation changes.

- Removed the version field from skill metadata in SKILL.md. - No changes to logic, features, or commands—documentation only.

- Clarified the audit trail feature: audit now only reads conversation transcripts when you explicitly run water audit <message_id>. - Updated privacy notice to specify that audit_auto_capture is off by default and audit logging always saves the message_id. - Described the exact effect of the audit_auto_capture setting on what information is displayed during audits. - Simplified user guidance on why to enable or disable audit context capture.

Security: Audit auto-capture now opt-in (default false). Privacy warning added to SKILL.md.

# Changelog - Water Coach All notable changes to this skill will be documented in this file. --- ## [1.5.0] - 2026-02-18 ### 🚀 Major Features #### New CLI Architecture (Option C) - Unified CLI: `water_coach.py <namespace> <command>` - Namespaces: `water`, `body`, `analytics` - Better agent clarity on available commands #### Audit Trail System - **Two timestamps**: `logged_at` (when user told you) + `drank_at` (when user actually drank) - **Message ID**: Auto-captures conversation message ID for proof - **Audit function**: `water audit <message_id>` - retrieves entry + conversation context - **Cumulative calculated at query time** - not stored (prevents data corruption on edits) #### Dynamic Scheduling (Coach Mode) - Per-hour limits instead of per-day (max 2/hour) - Aggressiveness curve: easier to trigger near cutoff time - Can re-trigger multiple times per day ### ✨ Improvements #### Flexible Paths - No hardcoded paths (e.g., `/home/oriel/`) - Uses environment variables and relative paths - Works on any machine with OpenClaw #### Body Metrics Integration - `water set_body_weight` logs to both config AND body_metrics.csv - Auto-calculates BMI #### User Choice for Goals - weight × 35 = default suggestion only - Agent MUST confirm goal with user at setup - Agent asks to update goal when weight changes ### 📋 Commands Added ```bash # Water water status # Current progress (calculated) water log <ml> # Log intake water log <ml> --drank-at=<ISO> # Log with past time water dynamic # Check if extra notification needed water threshold # Get expected % for current hour water set_body_weight <kg> # Update weight + logs to body_metrics water audit <message_id> # Get entry + conversation context # Body body log --weight=80 --height=1.75 body latest body history 30 # Analytics analytics week analytics month ``` ### 🔧 Technical Changes - 21 unit tests (was ~13) - CSV format: `logged_at,drank_at,date,slot,ml_drank,goal_at_time,message_id` - Auto-captures message_id from session transcript - `.gitignore` in data folder to protect user data --- ## [1.2.0] - 2026-02-16 ### Initial Release - Basic water tracking - Daily cron reminders - Unit conversion (L, ml, oz, glasses) - Body metrics logging - Dynamic scheduling (basic)

# Changelog - Water Coach All notable changes to this skill will be documented in this file. --- ## [1.5.0] - 2026-02-18 ### 🚀 Major Features #### New CLI Architecture (Option C) - Unified CLI: `water_coach.py <namespace> <command>` - Namespaces: `water`, `body`, `analytics` - Better agent clarity on available commands #### Audit Trail System - **Two timestamps**: `logged_at` (when user told you) + `drank_at` (when user actually drank) - **Message ID**: Auto-captures conversation message ID for proof - **Audit function**: `water audit <message_id>` - retrieves entry + conversation context - **Cumulative calculated at query time** - not stored (prevents data corruption on edits) #### Dynamic Scheduling (Coach Mode) - Per-hour limits instead of per-day (max 2/hour) - Aggressiveness curve: easier to trigger near cutoff time - Can re-trigger multiple times per day ### ✨ Improvements #### Flexible Paths - No hardcoded paths (e.g., `/home/oriel/`) - Uses environment variables and relative paths - Works on any machine with OpenClaw #### Body Metrics Integration - `water set_body_weight` logs to both config AND body_metrics.csv - Auto-calculates BMI #### User Choice for Goals - weight × 35 = default suggestion only - Agent MUST confirm goal with user at setup - Agent asks to update goal when weight changes ### 📋 Commands Added ```bash # Water water status # Current progress (calculated) water log <ml> # Log intake water log <ml> --drank-at=<ISO> # Log with past time water dynamic # Check if extra notification needed water threshold # Get expected % for current hour water set_body_weight <kg> # Update weight + logs to body_metrics water audit <message_id> # Get entry + conversation context # Body body log --weight=80 --height=1.75 body latest body history 30 # Analytics analytics week analytics month ``` ### 🔧 Technical Changes - 21 unit tests (was ~13) - CSV format: `logged_at,drank_at,date,slot,ml_drank,goal_at_time,message_id` - Auto-captures message_id from session transcript - `.gitignore` in data folder to protect user data --- ## [1.2.0] - 2026-02-16 ### Initial Release - Basic water tracking - Daily cron reminders - Unit conversion (L, ml, oz, glasses) - Body metrics logging - Dynamic scheduling (basic)

Added: Quick Start (minimal questions), Skip Days, Adjust Goal, Snooze - all with natural language intent detection

Added auto-detect for metric/imperial units from user input