chore: finalize v1.0.0 — cleanup, unified errors, date validation

- Move integration tests to tests/; fix .gitignore to scope root-only
- Remove tracked debug artefacts (probe2_stderr/stdout.txt)
- __init__.py: version via importlib.metadata; export create_server in __all__
- server.py: unified JSON error format {"error":"..."} for all tools
- server.py: date validation (YYYY-MM-DD) for all meal-plan tools
- server.py: clear_list reports partial failures (failed_count, failed_ids)
- server.py: -> str annotations on get_circles, get_tasks, get_activities
- server.py: document TODO:94 as known limitation (no name in sortingIndexByTaskList)
- server.py: date validation also added to get_meal_plan
- Add LICENSE (MIT, Marcus van Elst)
- Add CHANGELOG.md (Keep a Changelog, v0.1.0–v1.0.0)
- README.md: restructured by use case; 🔒 marks write tools
- CLAUDE.md: update to v1.0.0 state; condense roadmap history
- SPEC.md: add version stamp
- pyproject.toml: version 1.0.0 (single source of truth)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -1,47 +1,63 @@
 # mcp-familywall
 
-MCP server for [Family Wall](https://www.familywall.com) -- read and manage your family's circles, lists, tasks, and recipes directly from Claude.
+MCP server for [Family Wall](https://www.familywall.com) — manage your family's circles, lists, tasks, recipes, and meal plan directly from Claude.
 
-## Features (v0.11.8)
+## Tools (v1.0.0)
 
-### Read
+### Circles & Members
 
-- `get_circles` -- list all family circles
-- `get_members` -- list members of a circle (or all circles)
-- `get_lists` -- list all task lists (includes `emoji`, `color`, `circle_id`; `null` when unset; list types: `SHOPPING_LIST`, `TODOS`, `OTHER`); without scope parameter returns lists from **all circles**; optional `scope` parameter filters by circle metaId or circle name
-- `get_tasks` -- list tasks in a specific list (includes `category_id`, `due_date`, `assignee_ids`, `recurrency`, `rrule`, `reminder`)
-- `get_categories` -- list categories for a list (locale-filtered; custom categories always included; `custom` flag marks user-created ones)
-- `get_activities` -- list recent wall activities (author resolved to display name)
-- `get_recipes` -- list all family recipes (compact summary: id, name, prep/cook time, serves)
-- `get_recipe_box` -- list only real recipes from the recipe box (excludes stubs created for free-text meal entries)
-- `get_recipe` -- get a single recipe in full detail (ingredients, instructions, ingredients_parsed, category_ids, etc.; ingredients_parsed generated from free-text field to avoid parser bugs)
-- `get_recipe_categories` -- list all available recipe categories (always returns all 5 standard categories: Bei Kindern beliebt, Wirklich einfach, Nachspeisen, Schmeckt toll, Gemüse; plus any additional categories found in existing recipes)
-- `get_meal_plan` -- get meal plan entries for a date range (Premium feature; merges dish and meal entries, sorted by date + type; fields: id, date, type, name, recipe_id, is_from_recipe_box, note, serves, can_update, can_delete)
+| Tool | Description |
+|---|---|
+| `get_circles` | List all family circles |
+| `get_members` | List members of a circle (or all circles) |
+| `create_circle` 🔒 | Create a new Family Wall circle |
+| `update_circle` 🔒 | Rename a circle (primary circle protected) |
+| `add_member_to_circle` 🔒 | Invite a person to a circle by e-mail |
+| `delete_circle` 🔒 | Permanently delete a circle and all its content |
 
-### Write (with confirmation prompt)
+### Lists & Tasks
 
-- `create_task` -- create a new task in a list (supports `category_id`, `due_date`, `assignee_ids`); use `"Äpfel (5x)"` format for quantities
-- `update_task` -- update text, description, category, due date, assignees, or move to a different list; supports `clear_due_date=True` to remove a due date
-- `toggle_task` -- mark a task complete or reopen it
-- `delete_task` -- permanently delete a task
-- `clear_list` -- delete all tasks in a list in a single session (bulk delete; optional `only_open=True` to keep completed tasks)
-- `create_list` -- create a new task list (`SHOPPING_LIST`, `TODOS`, or `OTHER`; optional `emoji`, `color`, and `circle_id` to target a specific circle)
-- `update_list` -- rename a list or change its emoji/color (partial update — omitted fields unchanged; system lists are protected)
-- `delete_list` -- permanently delete a list and all its tasks (system lists are protected)
-- `create_category` -- create a custom category for a shopping list (with optional icon)
-- `delete_category` -- delete a custom category (system categories are protected)
-- `like_post` -- like a wall post/activity
-- `create_recipe` -- create a new recipe (name, description, ingredients, instructions, prep/cook time, serves, url, category_ids); use `\n` to separate ingredient lines
-- `update_recipe` -- update any field of an existing recipe (partial update — omitted fields unchanged; supports `category_ids` list to change categories)
-- `delete_recipe` -- permanently delete a recipe (only own recipes)
-- `add_recipe_to_meal_plan` -- add a recipe from the recipe box to the meal plan for a specific date and meal slot (BREAKFAST/LUNCH/SNACK/DINNER)
-- `add_meal_to_meal_plan` -- add a free-text meal entry (no recipe) to the meal plan for a specific date and meal slot
-- `add_meal_note` -- add a note and/or serving count to a meal plan slot (creates a `meal/` entry; at least one of `note` or `serves` required)
-- `delete_meal_plan_entry` -- permanently delete a meal plan entry (works for both `dish/…` and `meal/…` entries)
-- `create_circle` -- create a new Family Wall circle (group)
-- `update_circle` -- rename a circle (server capitalises first letter; only name is changeable via API; primary circle is protected)
-- `delete_circle` -- permanently delete a circle and all its content (primary circle is protected)
-- `add_member_to_circle` -- invite a person to a circle by e-mail (for new Family Wall users only; existing accounts require in-app invitation)
+| Tool | Description |
+|---|---|
+| `get_lists` | List all task lists (emoji, color, circle; optional `scope` filter) |
+| `get_tasks` | List tasks in a list (category, due date, assignees, recurrency, reminder) |
+| `get_categories` | List categories for a list (locale-filtered; custom categories always shown) |
+| `get_activities` | List recent wall activities (author resolved to display name) |
+| `create_list` 🔒 | Create a task list (`SHOPPING_LIST`, `TODOS`, or `OTHER`; optional emoji, color, circle) |
+| `update_list` 🔒 | Rename a list or change its emoji/color (partial update; system lists protected) |
+| `delete_list` 🔒 | Permanently delete a list and all its tasks (system lists protected) |
+| `create_category` 🔒 | Create a custom category (with optional icon) |
+| `delete_category` 🔒 | Delete a custom category (system categories protected) |
+| `create_task` 🔒 | Create a task (supports category, due date, assignees; use `"Äpfel (5x)"` for quantities) |
+| `update_task` 🔒 | Update text, category, due date, assignees, or move to a different list |
+| `toggle_task` 🔒 | Mark a task complete or reopen it |
+| `delete_task` 🔒 | Permanently delete a task |
+| `clear_list` 🔒 | Bulk-delete all tasks in a list (optional `only_open=True` keeps completed tasks) |
+| `like_post` 🔒 | Like a wall post/activity |
+
+### Recipe Box
+
+| Tool | Description |
+|---|---|
+| `get_recipe_categories` | List all recipe categories |
+| `get_recipe_box` | List real recipes only (excludes free-text meal stubs) |
+| `get_recipes` | List all recipe entries including stubs (compact summary) |
+| `get_recipe` | Get a single recipe in full detail (ingredients, instructions, parsed ingredients) |
+| `create_recipe` 🔒 | Create a new recipe (name, ingredients, instructions, prep/cook time, serves, url, categories) |
+| `update_recipe` 🔒 | Update any field of a recipe (partial update; supports category_ids) |
+| `delete_recipe` 🔒 | Permanently delete a recipe |
+
+### Meal Planner (Premium)
+
+| Tool | Description |
+|---|---|
+| `get_meal_plan` | Get meal plan entries for a date range (dish + meal entries, sorted by date + slot) |
+| `add_recipe_to_meal_plan` 🔒 | Add a recipe-box recipe to a meal slot (BREAKFAST/LUNCH/SNACK/DINNER) |
+| `add_meal_to_meal_plan` 🔒 | Add a free-text meal entry to a meal slot |
+| `add_meal_note` 🔒 | Add a note and/or serving count to a meal slot |
+| `delete_meal_plan_entry` 🔒 | Delete a meal plan entry (`dish/…` or `meal/…`) |
+
+🔒 = requires user confirmation before calling
 
 ## Requirements
 
@@ -107,4 +123,4 @@ Credentials are resolved in this order:
 
 ## License
 
-MIT
+[MIT](LICENSE) — © 2026 Marcus van Elst