docs(docstrings): improve tool usage guidance for new Claude sessions (v1.4.1)

- get_wall_posts: clarify mixed content (status posts + activity entries)
- get_activities: expand description and distinguish from get_wall_posts
- like_post: extend post_id examples (wall/, task/, taskList/ IDs)
- get_recipe_categories: add usage notes (IDs, free-tier categories, family-wide)
- add_meal_note: clarify create-only behavior (delete then recreate to update)
- clear_list: move risk warning (default deletes all) to opening line
- create_recipe: verify IMPORTANT confirmation line present

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-04-17 23:47:42 +02:00
parent 09bd24a9e1
commit dd42dc2845
3 changed files with 46 additions and 7 deletions
+16
View File
@@ -10,6 +10,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
This project follows Semantic Versioning (SemVer).
Breaking changes (removed tools, changed parameters) increment the major version.
## [1.4.1] 2026-04-17
### Improved
- **Docstring enhancements** — clearer tool usage guidance for new Claude sessions:
- `get_wall_posts`: Added note that results include automatic activity entries (task updates, list changes)
- `get_activities`: Expanded description and added distinction from `get_wall_posts`
- `like_post`: Extended post_id examples to include `task/` and `taskList/` IDs from activities
- `get_recipe_categories`: Added usage notes (IDs for create/update, 5 free-tier categories, family-wide scope)
- `add_meal_note`: Clarified create-only behavior; to update, delete then recreate
- `clear_list`: Moved risk warning (default deletes all tasks) to opening line for visibility
- `create_recipe`: Verified IMPORTANT confirmation line present
### Notes
- No breaking changes; docstring improvements only
- All tools remain backward compatible
## [1.4.0] 2026-04-17
### Added