@mind-your-now/myn 0.4.0

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

@@ -0,0 +1,148 @@
+# Profile API
+
+User information, goals, and preferences.
+
+## Base Path
+
+`/api/v1/customers`
+
+## Endpoints
+
+### Get User Info
+
+```
+GET /api/v1/customers/me
+```
+
+**Response:**
+
+```json
+{
+  "id": "uuid",
+  "email": "user@example.com",
+  "name": "John Doe",
+  "timezone": "America/New_York",
+  "language": "en",
+  "createdAt": "2026-01-15T00:00:00Z",
+  "households": [
+    { "id": "uuid", "name": "Home", "role": "owner" }
+  ],
+  "subscription": {
+    "tier": "pro",
+    "expiresAt": "2027-01-15T00:00:00Z"
+  },
+  "stats": {
+    "totalTasksCompleted": 1234,
+    "currentStreak": 45,
+    "longestStreak": 120
+  }
+}
+```
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/v1/customers/me"
+```
+
+### Get Goals
+
+```
+GET /api/v1/customers/goals
+```
+
+**Response:** `{ goals[{ id, title, description?, targetDate?, priority, status, progress, createdAt, updatedAt, relatedTasks?[] }], activeCount, completedCount }`
+
+- `priority`: `low`, `medium`, `high`
+- `status`: `active`, `completed`, `paused`, `abandoned`
+- `progress`: 0–100
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/v1/customers/goals"
+```
+
+### Create Goals
+
+```
+POST /api/v1/customers/goals
+```
+
+**Body:**
+
+```json
+{
+  "goals": [
+    {
+      "title": "Run a marathon",
+      "description": "Complete a full marathon by end of year",
+      "targetDate": "2026-12-31",
+      "priority": "high"
+    }
+  ]
+}
+```
+
+**Response:** `{ created[{ goalId, title }] }`
+
+```bash
+curl -X POST "$MYN_API_URL/api/v1/customers/goals" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"goals": [{"title": "Read 24 books this year", "priority": "medium"}]}'
+```
+
+### Update Goal
+
+```
+PUT /api/v1/customers/goals/{goalId}
+```
+
+**Body:** `{ title?, description?, targetDate?, priority?, status? }`
+
+**Response:** `{ goalId, updated }`
+
+```bash
+curl -X PUT "$MYN_API_URL/api/v1/customers/goals/aabb0000-0000-0000-0000-000000000001" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"status": "completed"}'
+```
+
+### Get Preferences
+
+```
+GET /api/v1/customers/preferences
+GET /api/v1/customers/preferences/{key}
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `category` | string | Filter: `notifications`, `display`, `ai`, `privacy`, `integrations` |
+
+**Response (all):** `{ preferences: { key: value, ... }, categories[] }`
+**Response (specific):** `{ key, value, category, updatedAt }`
+
+```bash
+# Get all preferences
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/v1/customers/preferences"
+
+# Get AI preferences only
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/v1/customers/preferences?category=ai"
+```
+
+### Set Preference
+
+```
+PUT /api/v1/customers/preferences
+```
+
+**Body:** `{ key, value, category? }`
+
+**Response:** `{ key, updated }`
+
+```bash
+curl -X PUT "$MYN_API_URL/api/v1/customers/preferences" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"key": "ai.tone", "value": "friendly", "category": "ai"}'
+```

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

@@ -0,0 +1,127 @@
+# Projects API
+
+Project and category management for organizing tasks.
+
+## Base Path
+
+`/api/project`
+
+## Endpoints
+
+### List Projects
+
+```
+GET /api/project
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `includeArchived` | boolean | Include archived projects (default: false) |
+| `includeStats` | boolean | Include task statistics (default: true) |
+
+**Response:**
+
+```json
+{
+  "projects": [
+    {
+      "id": "uuid",
+      "name": "Q1 Planning",
+      "description": "First quarter objectives",
+      "color": "#3B82F6",
+      "icon": "target",
+      "parentId": null,
+      "createdAt": "2026-01-01T00:00:00Z",
+      "stats": {
+        "totalTasks": 12,
+        "completedTasks": 8,
+        "criticalTasks": 2
+      }
+    }
+  ]
+}
+```
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/project?includeStats=true"
+```
+
+### Get Project
+
+```
+GET /api/project/{projectId}
+```
+
+**Response:**
+
+```json
+{
+  "id": "uuid",
+  "name": "Q1 Planning",
+  "description": "First quarter objectives",
+  "color": "#3B82F6",
+  "icon": "target",
+  "parentId": null,
+  "createdAt": "2026-01-01T00:00:00Z",
+  "tasks": [
+    {
+      "id": "uuid",
+      "title": "Prepare budget",
+      "priority": "CRITICAL",
+      "status": "PENDING",
+      "startDate": "2026-03-01"
+    }
+  ],
+  "subProjects": [
+    { "id": "uuid", "name": "Budget", "taskCount": 3 }
+  ]
+}
+```
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" "$MYN_API_URL/api/project/PROJECT_ID"
+```
+
+### Create Project
+
+```
+POST /api/project
+```
+
+**Body:**
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | string | Yes | Project name (1–100 chars) |
+| `description` | string | No | Description (max 500 chars) |
+| `color` | string | No | Hex color (`#3B82F6`) |
+| `icon` | string | No | Icon identifier |
+| `parentId` | UUID | No | Parent project for nesting |
+
+**Response:** `{ id, name, created }`
+
+```bash
+curl -X POST "$MYN_API_URL/api/project" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Home Renovation", "color": "#10B981", "icon": "home"}'
+```
+
+### Move Task to Project
+
+```
+PUT /api/v2/unified-tasks/{taskId}/project
+```
+
+**Body:** `{ projectId: "target-project-uuid" }`
+
+**Response:** `{ taskId, previousProjectId?, newProjectId, moved }`
+
+```bash
+curl -X PUT "$MYN_API_URL/api/v2/unified-tasks/TASK_ID/project" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"projectId": "TARGET_PROJECT_ID"}'
+```

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

@@ -0,0 +1,97 @@
+# Search API
+
+Unified search across all MYN entity types with filtering, pagination, and relevance highlighting.
+
+## Base Path
+
+`/api/v2/search`
+
+## Endpoints
+
+### Search
+
+```
+POST /api/v2/search
+```
+
+Performs a full-text search across tasks, habits, chores, events, projects, notes, and memories.
+
+**Body Parameters:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `query` | string | **Required.** Search query text |
+| `types` | string[] | Entity types to search. Options: `task`, `habit`, `chore`, `event`, `project`, `note`, `memory`. Omit to search all types. |
+| `filters` | object | Optional filters to narrow results |
+| `filters.status` | string | Filter by status (e.g., `PENDING`, `COMPLETED`) |
+| `filters.priority` | string | Filter by priority (e.g., `CRITICAL`, `OPPORTUNITY_NOW`) |
+| `filters.projectId` | UUID | Filter by project |
+| `filters.dateFrom` | date | Results from this date onward (YYYY-MM-DD) |
+| `filters.dateTo` | date | Results up to this date (YYYY-MM-DD) |
+| `limit` | number | Max results (default: 20, max: 100) |
+| `offset` | number | Pagination offset (default: 0) |
+
+**Response Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `results` | object[] | Array of search result objects |
+| `results[].id` | UUID | Entity identifier |
+| `results[].type` | string | Entity type (`task`, `habit`, `chore`, `event`, `project`, `note`, `memory`) |
+| `results[].title` | string | Entity title |
+| `results[].description` | string | Entity description (nullable) |
+| `results[].relevance` | number | Relevance score (0.0 to 1.0) |
+| `results[].highlights` | object[] | Matched text snippets |
+| `results[].highlights[].field` | string | Field where the match occurred (e.g., `title`, `description`) |
+| `results[].highlights[].snippet` | string | Text snippet with match context |
+| `results[].metadata` | object | Type-specific metadata (e.g., `priority`, `status`, `dueDate`) |
+| `total` | number | Total matching results |
+| `limit` | number | Limit used in this request |
+| `offset` | number | Offset used in this request |
+| `query` | string | The query that was executed |
+| `suggestions` | string[] | Alternative search suggestions (nullable) |
+
+```bash
+# Basic search
+curl -X POST "$MYN_API_URL/api/v2/search" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"query": "quarterly report"}'
+
+# Search only tasks and notes
+curl -X POST "$MYN_API_URL/api/v2/search" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "quarterly report",
+    "types": ["task", "note"],
+    "limit": 10
+  }'
+
+# Search with filters
+curl -X POST "$MYN_API_URL/api/v2/search" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "budget",
+    "types": ["task", "project"],
+    "filters": {
+      "status": "PENDING",
+      "priority": "CRITICAL",
+      "dateFrom": "2026-01-01",
+      "dateTo": "2026-03-31"
+    },
+    "limit": 50,
+    "offset": 0
+  }'
+
+# Paginated search
+curl -X POST "$MYN_API_URL/api/v2/search" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "meeting notes",
+    "limit": 20,
+    "offset": 20
+  }'
+```

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

@@ -0,0 +1,187 @@
+# Tasks API
+
+Unified task management covering Tasks, Habits, and Chores.
+
+## Base Path
+
+`/api/v2/unified-tasks`
+
+## Endpoints
+
+### List Tasks
+
+```
+GET /api/v2/unified-tasks
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `status` | string | Filter: `PENDING`, `IN_PROGRESS`, `COMPLETED`, `ARCHIVED` |
+| `priority` | string | Filter: `CRITICAL`, `OPPORTUNITY_NOW`, `OVER_THE_HORIZON`, `PARKING_LOT` |
+| `projectId` | UUID | Filter by project |
+| `startDate` | date | Filter by start date (YYYY-MM-DD) |
+| `endDate` | date | Filter by end date (YYYY-MM-DD) |
+| `limit` | number | Max results (default: 20) |
+| `offset` | number | Pagination offset (default: 0) |
+
+```bash
+# List Critical Now tasks
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v2/unified-tasks?priority=CRITICAL&status=PENDING"
+
+# List tasks for a date range
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v2/unified-tasks?startDate=2026-03-01&endDate=2026-03-07"
+```
+
+### Get Task
+
+```
+GET /api/v2/unified-tasks/{taskId}
+```
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v2/unified-tasks/550e8400-e29b-41d4-a716-446655440000"
+```
+
+### Create Task
+
+```
+POST /api/v2/unified-tasks
+```
+
+**Required Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | UUID | Client-generated UUID |
+| `title` | string | Task title (1–200 chars) |
+| `taskType` | string | `TASK`, `HABIT`, or `CHORE` |
+| `priority` | string | `CRITICAL`, `OPPORTUNITY_NOW`, `OVER_THE_HORIZON`, `PARKING_LOT` |
+| `startDate` | date | Start date (YYYY-MM-DD) |
+
+**Optional Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `description` | string | Description (max 2000 chars) |
+| `duration` | string | Duration: `"30m"`, `"1h"`, `"1h30m"` (NOT ISO PT prefix) |
+| `projectId` | UUID | Assign to project |
+| `recurrenceRule` | string | RRULE for HABIT/CHORE types (**required** for HABIT and CHORE) |
+
+**Type-Specific Rules:**
+
+- `TASK`: Basic task, can be shared
+- `HABIT`: MUST have `recurrenceRule`, CANNOT be shared
+- `CHORE`: MUST have `recurrenceRule`, always household-scoped
+
+```bash
+# Create a regular task
+curl -X POST "$MYN_API_URL/api/v2/unified-tasks" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id": "550e8400-e29b-41d4-a716-446655440000",
+    "title": "Prepare quarterly report",
+    "taskType": "TASK",
+    "priority": "CRITICAL",
+    "startDate": "2026-03-01",
+    "duration": "2h",
+    "description": "Q1 financials and projections"
+  }'
+
+# Create a habit
+curl -X POST "$MYN_API_URL/api/v2/unified-tasks" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "id": "660e8400-e29b-41d4-a716-446655440001",
+    "title": "Morning meditation",
+    "taskType": "HABIT",
+    "priority": "OPPORTUNITY_NOW",
+    "startDate": "2026-03-01",
+    "duration": "15m",
+    "recurrenceRule": "FREQ=DAILY"
+  }'
+```
+
+### Update Task
+
+```
+PATCH /api/v2/unified-tasks/{taskId}
+```
+
+Send only the fields to update:
+
+```bash
+curl -X PATCH "$MYN_API_URL/api/v2/unified-tasks/550e8400-e29b-41d4-a716-446655440000" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"priority": "OPPORTUNITY_NOW", "startDate": "2026-03-05"}'
+```
+
+### Complete Task
+
+```
+POST /api/v2/unified-tasks/{taskId}/complete
+```
+
+```bash
+curl -X POST "$MYN_API_URL/api/v2/unified-tasks/550e8400-e29b-41d4-a716-446655440000/complete" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+### Archive Task
+
+```
+POST /api/v2/unified-tasks/{taskId}/archive
+```
+
+```bash
+curl -X POST "$MYN_API_URL/api/v2/unified-tasks/550e8400-e29b-41d4-a716-446655440000/archive" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+### Search (via unified search)
+
+```
+GET /api/v2/search
+```
+
+See [search-api.md](search-api.md) for full search documentation.
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v2/search?q=quarterly+report&limit=10"
+```
+
+### Get Habit Streak
+
+```
+GET /api/v2/unified-tasks/{taskId}/streak
+```
+
+```bash
+curl -H "X-API-KEY: $MYN_API_KEY" \
+  "$MYN_API_URL/api/v2/unified-tasks/660e8400-e29b-41d4-a716-446655440001/streak"
+```
+
+### Move Task to Project
+
+```
+PUT /api/v2/unified-tasks/{taskId}/project
+```
+
+```bash
+curl -X PUT "$MYN_API_URL/api/v2/unified-tasks/550e8400-e29b-41d4-a716-446655440000/project" \
+  -H "X-API-KEY: $MYN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"projectId": "770e8400-e29b-41d4-a716-446655440002"}'
+```