@mind-your-now/myn 0.8.1 → 0.8.3

package/skills/myn/references/habits-api.md

@@ -2,49 +2,25 @@
 
 Habit streaks, habit chains, scheduling, and reminders.
 
-## Base Path
+## Actions
 
-- Streaks and chains: `/api/v1/habit-chains`
-- Reminders: `/api/habits/reminders`
+The `myn_habits` tool supports these actions: `streaks`, `skip`, `chains`, `schedule`, `reminders`.
 
 ## Endpoints
 
-### List All Habit Streaks
+### Get Habit Streak
 
 ```
-GET /api/v1/habit-chains/streaks
+GET /api/v2/unified-tasks/{habitId}/streak
 ```
 
-Returns streak data for all habits.
-
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `habits` | object[] | Array of habit streak objects |
-| `habits[].habitId` | UUID | Habit identifier |
-| `habits[].title` | string | Habit title |
-| `habits[].currentStreak` | number | Current consecutive completions |
-| `habits[].longestStreak` | number | All-time longest streak |
-| `habits[].totalCompletions` | number | Total times completed |
-| `habits[].lastCompletedAt` | datetime | Last completion timestamp |
-
-```bash
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/streaks"
-```
-
-### Get Specific Habit Streak
-
-```
-GET /api/v1/habit-chains/{habitId}/streaks
-```
+Returns streak data for a specific habit. Requires `habitId`.
 
 **Query Parameters:**
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `includeHistory` | boolean | Include day-by-day streak history |
+| `includeHistory` | boolean | Include day-by-day streak history (default: false) |
 
 **Response Fields:**
 
@@ -54,7 +30,7 @@ GET /api/v1/habit-chains/{habitId}/streaks
 | `currentStreak` | number | Current consecutive completions |
 | `longestStreak` | number | All-time longest streak |
 | `totalCompletions` | number | Total times completed |
-| `lastCompletedAt` | datetime | Last completion timestamp |
+| `lastCompletedAt` | datetime | Last completion timestamp (nullable) |
 | `streakHistory` | object[] | Day-by-day history (only if `includeHistory=true`) |
 | `streakHistory[].date` | date | Calendar date |
 | `streakHistory[].completed` | boolean | Whether the habit was completed that day |
@@ -62,26 +38,30 @@ GET /api/v1/habit-chains/{habitId}/streaks
 ```bash
 # Basic streak info
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/660e8400-e29b-41d4-a716-446655440001/streaks"
+  "$MYN_API_URL/api/v2/unified-tasks/HABIT_ID/streak"
 
 # With full history
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/660e8400-e29b-41d4-a716-446655440001/streaks?includeHistory=true"
+  "$MYN_API_URL/api/v2/unified-tasks/HABIT_ID/streak?includeHistory=true"
 ```
 
+**Note:** There is no bulk streaks endpoint. Use the `schedule` action to see all habits.
+
 ### Skip Habit (Preserve Streak)
 
 ```
-POST /api/v1/habit-chains/{habitId}/skip
+POST /api/v2/unified-tasks/{habitId}/skip
 ```
 
 Marks a habit as skipped for a day without breaking the streak.
 
+**Required:** `habitId`
+
 **Body Parameters:**
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `skipDate` | date | Date to skip (default: today, YYYY-MM-DD) |
+| `skipDate` | date | Date to skip (YYYY-MM-DD, default: today) |
 | `reason` | string | Optional reason for skipping |
 
 **Response Fields:**
@@ -94,7 +74,7 @@ Marks a habit as skipped for a day without breaking the streak.
 | `newStreakCount` | number | Updated streak count |
 
 ```bash
-curl -X POST "$MYN_API_URL/api/v1/habit-chains/660e8400-e29b-41d4-a716-446655440001/skip" \
+curl -X POST "$MYN_API_URL/api/v2/unified-tasks/HABIT_ID/skip" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
@@ -106,7 +86,7 @@ curl -X POST "$MYN_API_URL/api/v1/habit-chains/660e8400-e29b-41d4-a716-446655440
 ### List All Chains
 
 ```
-GET /api/v1/habit-chains
+GET /api/habits/chains
 ```
 
 Returns all habit chains (grouped sequences of habits).
@@ -120,17 +100,17 @@ Returns all habit chains (grouped sequences of habits).
 | `chains[].name` | string | Chain name |
 | `chains[].habitCount` | number | Number of habits in the chain |
 | `chains[].totalCompletions` | number | Total completions across all habits |
-| `chains[].lastCompletedAt` | datetime | Last completion in this chain |
+| `chains[].lastCompletedAt` | datetime | Last completion in this chain (nullable) |
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains"
+  "$MYN_API_URL/api/habits/chains"
 ```
 
 ### Get Specific Chain
 
 ```
-GET /api/v1/habit-chains/{chainId}
+GET /api/habits/chains/{chainId}/status
 ```
 
 **Response Fields:**
@@ -149,13 +129,13 @@ GET /api/v1/habit-chains/{chainId}
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/770e8400-e29b-41d4-a716-446655440002"
+  "$MYN_API_URL/api/habits/chains/CHAIN_ID/status"
 ```
 
 ### Get Habit Schedule
 
 ```
-GET /api/v1/habit-chains/schedule
+GET /api/v2/unified-tasks/schedule
 ```
 
 Returns the habit schedule for the upcoming days.
@@ -172,7 +152,7 @@ Returns the habit schedule for the upcoming days.
 |-------|------|-------------|
 | `schedule` | object[] | Array of daily schedules |
 | `schedule[].date` | date | Calendar date |
-| `schedule[].dayOfWeek` | string | Day name (e.g., `Monday`) |
+| `schedule[].dayOfWeek` | number | Day of week number |
 | `schedule[].habits` | object[] | Habits due on that day |
 | `schedule[].habits[].habitId` | UUID | Habit identifier |
 | `schedule[].habits[].title` | string | Habit title |
@@ -184,11 +164,11 @@ Returns the habit schedule for the upcoming days.
 ```bash
 # Default 7-day schedule
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/schedule"
+  "$MYN_API_URL/api/v2/unified-tasks/schedule"
 
 # 14-day schedule
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/habit-chains/schedule?days=14"
+  "$MYN_API_URL/api/v2/unified-tasks/schedule?days=14"
 ```
 
 ### List All Reminders
@@ -208,7 +188,7 @@ Returns reminder settings for all habits.
 | `reminders[].title` | string | Habit title |
 | `reminders[].enabled` | boolean | Whether the reminder is active |
 | `reminders[].reminderTime` | time | Time of day for the reminder (nullable, HH:mm) |
-| `reminders[].reminderDays` | string[] | Days the reminder fires (e.g., `["MON", "WED", "FRI"]`) |
+| `reminders[].reminderDays` | number[] | Days the reminder fires |
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
@@ -221,9 +201,18 @@ curl -H "X-API-KEY: $MYN_API_KEY" \
 GET /api/habits/reminders/{habitId}
 ```
 
+**Response Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `habitId` | UUID | Habit identifier |
+| `remindersEnabled` | boolean | Whether reminders are active |
+| `reminderTime` | time | Time of day (nullable, HH:mm) |
+| `reminderDays` | number[] | Days the reminder fires |
+
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/habits/reminders/660e8400-e29b-41d4-a716-446655440001"
+  "$MYN_API_URL/api/habits/reminders/HABIT_ID"
 ```
 
 ### Update Reminder
@@ -240,18 +229,11 @@ PUT /api/habits/reminders/{habitId}
 | `time` | time | Time of day for the reminder (HH:mm) |
 
 ```bash
-# Enable a reminder at 7:30 AM
-curl -X PUT "$MYN_API_URL/api/habits/reminders/660e8400-e29b-41d4-a716-446655440001" \
+curl -X PUT "$MYN_API_URL/api/habits/reminders/HABIT_ID" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
     "enabled": true,
     "time": "07:30"
   }'
-
-# Disable a reminder
-curl -X PUT "$MYN_API_URL/api/habits/reminders/660e8400-e29b-41d4-a716-446655440001" \
-  -H "X-API-KEY: $MYN_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{"enabled": false}'
 ```

package/skills/myn/references/household-api.md

@@ -8,13 +8,14 @@ Household members, invites, and chore management.
 
 ## Getting the Household ID
 
-Most endpoints require a `householdId`. Get it from the user profile:
+Most endpoints require a `householdId`. The plugin auto-resolves it via:
 
-```bash
-curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/v1/customers/me"
-# → { "households": [{ "id": "uuid", "name": "Home" }] }
+```
+GET /api/v1/households/current
 ```
 
+Response: `{ "id": "uuid" }`
+
 ## Endpoints
 
 ### List Members
@@ -78,12 +79,20 @@ curl -X POST "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/invites" \
   -d '{"email": "jane@example.com", "role": "member"}'
 ```
 
-### List Chores
+### List Chores (Today)
 
 ```
-GET /api/v2/chores?householdId={householdId}
+GET /api/v2/chores/today?householdId={householdId}
 ```
 
+Returns today's chores for the household.
+
+**Query Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `householdId` | UUID | Required |
+
 **Response:**
 
 ```json
@@ -106,22 +115,31 @@ GET /api/v2/chores?householdId={householdId}
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/chores?householdId=HOUSEHOLD_ID"
+  "$MYN_API_URL/api/v2/chores/today?householdId=HOUSEHOLD_ID"
 ```
 
 ### Get Chore Schedule
 
 ```
-GET /api/v2/chores/schedule
+GET /api/v2/chores/schedule/range
 ```
 
+Returns chore schedule for a date range.
+
 **Query Parameters:**
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `householdId` | UUID | Required |
-| `date` | date | Specific date (YYYY-MM-DD) |
-| `weekStart` | date | Start of week to view |
+| `startDate` | date | Start date (YYYY-MM-DD, defaults to today) |
+| `endDate` | date | End date (YYYY-MM-DD, defaults to startDate + 7 days) |
+
+**Tool Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `date` | date | Specific date (sets both startDate and endDate) |
+| `weekStart` | date | Start of week (endDate computed as +7 days) |
 
 **Response:**
 
@@ -137,7 +155,9 @@ GET /api/v2/chores/schedule
           "title": "Take out trash",
           "assignedTo": "member-uuid",
           "estimatedMinutes": 10,
-          "completed": false
+          "completed": false,
+          "completedAt": null,
+          "completedBy": null
         }
       ]
     }
@@ -149,15 +169,17 @@ GET /api/v2/chores/schedule
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v2/chores/schedule?householdId=HOUSEHOLD_ID&date=2026-03-01"
+  "$MYN_API_URL/api/v2/chores/schedule/range?householdId=HOUSEHOLD_ID&startDate=2026-03-01&endDate=2026-03-07"
 ```
 
 ### Complete Chore
 
 ```
-POST /api/v2/chores/{choreId}/complete
+POST /api/v2/chores/instances/{choreId}/complete
 ```
 
+**Uses read-before-write guard** — reads chore instance state hash before completing.
+
 **Body:**
 
 | Field | Type | Required | Description |
@@ -168,8 +190,9 @@ POST /api/v2/chores/{choreId}/complete
 **Response:** `{ choreId, completed, completedAt, nextDueDate? }`
 
 ```bash
-curl -X POST "$MYN_API_URL/api/v2/chores/CHORE_ID/complete" \
+curl -X POST "$MYN_API_URL/api/v2/chores/instances/CHORE_ID/complete" \
   -H "X-API-KEY: $MYN_API_KEY" \
+  -H "X-MYN-State-Hash: abc123" \
   -H "Content-Type: application/json" \
   -d '{"note": "Both bins taken to curb"}'
 ```

package/skills/myn/references/lists-api.md

@@ -6,15 +6,16 @@ Grocery and shopping list management scoped to households.
 
 `/api/v1/households/{householdId}/grocery-list`
 
+## Actions
+
+The `myn_lists` tool supports these actions: `get`, `add`, `update`, `toggle`, `delete`, `delete_checked`, `bulk_add`, `convert_to_tasks`.
+
 ## Prerequisites
 
-All list endpoints require a `householdId`. Retrieve it from the current user profile:
+All list endpoints require a `householdId`. The plugin auto-resolves it via:
 
-```bash
-# Get your household ID
-curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/customers/me"
-# Response includes: households[0].id
+```
+GET /api/v1/households/current
 ```
 
 ## Endpoints
@@ -31,7 +32,7 @@ Returns the full grocery list for the household.
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `householdId` | UUID | Household identifier |
+| `success` | boolean | Operation success |
 | `items` | object[] | Array of list items |
 | `items[].id` | UUID | Item identifier |
 | `items[].name` | string | Item name |
@@ -40,19 +41,22 @@ Returns the full grocery list for the household.
 | `items[].notes` | string | Additional notes (nullable) |
 | `items[].checked` | boolean | Whether the item has been picked up |
 | `items[].addedAt` | datetime | When the item was added |
-| `items[].addedBy` | string | Name of the user who added the item |
-| `categories` | string[] | All distinct categories in the list |
-| `lastModified` | datetime | Last modification timestamp |
+| `items[].addedBy` | number | User ID who added the item |
+| `items[].addedByName` | string | Name of the user who added the item (nullable) |
+| `items[].position` | number | Sort position |
+| `items[].householdId` | UUID | Household ID |
+| `items[].createdAt` | datetime | Creation timestamp |
+| `items[].updatedAt` | datetime | Last update timestamp |
 
 ```bash
 curl -H "X-API-KEY: $MYN_API_KEY" \
-  "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-446655440003/grocery-list"
+  "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list"
 ```
 
 ### Add Item
 
 ```
-POST /api/v1/households/{householdId}/grocery-list/items
+POST /api/v1/households/{householdId}/grocery-list
 ```
 
 **Body Parameters:**
@@ -64,15 +68,10 @@ POST /api/v1/households/{householdId}/grocery-list/items
 | `quantity` | string | Optional quantity (e.g., `2 lbs`, `1 gallon`) |
 | `notes` | string | Optional notes |
 
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `itemId` | UUID | New item identifier |
-| `added` | boolean | Whether the item was successfully added |
+**Response:** `{ success, item: { id, name, category?, quantity?, notes?, checked, addedAt, addedByName? } }`
 
 ```bash
-curl -X POST "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-446655440003/grocery-list/items" \
+curl -X POST "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
@@ -83,37 +82,83 @@ curl -X POST "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-44665544000
   }'
 ```
 
-### Toggle Item Checked
+### Update Item
 
 ```
-PATCH /api/v1/households/{householdId}/grocery-list/items/{itemId}
+PATCH /api/v1/households/{householdId}/grocery-list/{itemId}
 ```
 
+Updates an existing grocery list item. At least one field is required.
+
 **Body Parameters:**
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `checked` | boolean | Set checked state (toggles if omitted by some clients) |
+| `name` | string | New item name |
+| `category` | string | New category |
+| `quantity` | string | New quantity |
+| `notes` | string | New notes |
 
-**Response Fields:**
+**Response:** `{ success, item: { id, name, category?, quantity?, notes?, checked } }`
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `itemId` | UUID | Item identifier |
-| `checked` | boolean | New checked state |
+```bash
+curl -X PATCH "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/ITEM_ID" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"quantity": "6", "notes": "Updated quantity"}'
+```
+
+### Toggle Item Checked
+
+```
+PATCH /api/v1/households/{householdId}/grocery-list/{itemId}/toggle
+```
+
+Toggles the checked state of a grocery list item.
+
+**Response:** `{ success, item: { id, name, checked }, checked }`
 
 ```bash
-# Mark an item as picked up
-curl -X PATCH "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-446655440003/grocery-list/items/990e8400-e29b-41d4-a716-446655440004" \
+curl -X PATCH "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/ITEM_ID/toggle" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
-  -d '{"checked": true}'
+  -d '{}'
+```
+
+### Delete Item
+
+```
+DELETE /api/v1/households/{householdId}/grocery-list/{itemId}
+```
+
+Deletes a single grocery list item.
+
+**Response:** `{ success, deleted }`
+
+```bash
+curl -X DELETE "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/ITEM_ID" \
+  -H "X-API-KEY: $MYN_API_KEY"
+```
+
+### Delete Checked Items
+
+```
+DELETE /api/v1/households/{householdId}/grocery-list/checked
+```
+
+Deletes all checked (completed) items from the grocery list.
+
+**Response:** `{ success, deletedCount, undoAvailable }`
+
+```bash
+curl -X DELETE "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/checked" \
+  -H "X-API-KEY: $MYN_API_KEY"
 ```
 
 ### Bulk Add Items
 
 ```
-POST /api/v1/households/{householdId}/grocery-list/items/bulk
+POST /api/v1/households/{householdId}/grocery-list/bulk
 ```
 
 **Body Parameters:**
@@ -125,15 +170,10 @@ POST /api/v1/households/{householdId}/grocery-list/items/bulk
 | `items[].category` | string | Optional category |
 | `items[].quantity` | string | Optional quantity |
 
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `addedCount` | number | Number of items added |
-| `itemIds` | UUID[] | IDs of the newly created items |
+**Response:** `{ success, items: [{ id, name, category?, quantity?, checked }], count }`
 
 ```bash
-curl -X POST "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-446655440003/grocery-list/items/bulk" \
+curl -X POST "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/bulk" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
@@ -161,16 +201,10 @@ Converts grocery list items into MYN tasks (e.g., for a shopping trip).
 | `uncheckedOnly` | boolean | Only convert unchecked items (default: true) |
 | `priority` | string | Priority for created tasks (e.g., `OPPORTUNITY_NOW`) |
 
-**Response Fields:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `convertedCount` | number | Number of items converted to tasks |
-| `taskIds` | UUID[] | IDs of the created tasks |
+**Response:** `{ success, tasks: [{ id, title }], count }`
 
 ```bash
-# Convert unchecked items to Opportunity Now tasks
-curl -X POST "$MYN_API_URL/api/v1/households/880e8400-e29b-41d4-a716-446655440003/grocery-list/convert-to-tasks" \
+curl -X POST "$MYN_API_URL/api/v1/households/HOUSEHOLD_ID/grocery-list/convert-to-tasks" \
   -H "X-API-KEY: $MYN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{