@cpenned/mcp 0.8.3 → 0.8.5

package/skills/open-brain-mcp/SKILL.md

@@ -122,7 +122,9 @@ pre-guessing constraints.
   `assignee: "me"|"unassigned"|<userId>` filters the home vault by assignee),
   `get_task`, `update_task` (drives status), `delete_task`, batch
   `create_tasks`/`update_tasks`, `add_task_tags`/`remove_task_tags`.
-  `create_task`/`update_task` accept `eventId` to link a synced calendar event
+  `create_task`/`create_tasks` accept an initial `status` (default `todo`;
+  e.g. `backlog` to park it). `create_task`/`update_task` accept `eventId` to
+  link a synced calendar event
   (read-only mirror); `eventId: null` on update unlinks it.
   `create_task`/`create_tasks`/`update_task`/`update_tasks` also accept
   `assigneeUserId` (a user id, `"me"`, or `null` to unassign) - only
@@ -132,6 +134,10 @@ pre-guessing constraints.
   `sharedFrom` marker).
 - **Projects**: `create_project`, `list_projects`, `get_project`,
   `update_project`, `delete_project`, `create_projects`/`update_projects`.
+  `create_project(s)` accept an initial `status` (default `todo`).
+  Project reads carry `taskCounts {open, done}` (canceled in neither) and
+  `nextTaskId` (first open task by manual order; `get_task` it to see what's
+  next), so progress needs no extra task listing.
 - **Gardens**: `create_garden`, `list_gardens`, `get_garden`, `update_garden`,
   `delete_garden` (archives).
 - **Tags**: `create_tag`, `list_tags`, `get_tag`, `update_tag`, `delete_tag`
@@ -142,8 +148,8 @@ pre-guessing constraints.
   (null clears a field, e.g. `contactInterval: null`; `archived: false`
   restores), `delete_person` (archives, links kept), `mark_contacted`
   (optional `at` backdates the touch), `add_person_links`/`remove_person_links`
-  (`{id, taskIds?, projectIds?, gardenIds?, readingListItemIds?, bookIds?,
-  people?}` — `people` is `[{id, label?}]` for person-to-person connections;
+  (`{id, taskIds?, projectIds?, gardenIds?, readingListItemIds?, habitIds?,
+  bookIds?, people?}`: `people` is `[{id, label?}]` for person-to-person connections;
   symmetric, shown on both people, re-link with a new label to change it or
   `label: null` to clear it; unlink takes the same shape, ids only for
   `people`). `create_task(s)` accept `personIds` inline; `list_tasks` filters
@@ -156,9 +162,10 @@ pre-guessing constraints.
   `archived`/`deleted` toggle independently of status), `delete_reading_item`
   (true soft delete, hidden everywhere; restore with `update_reading_item
   {deleted: false}`),   `add_reading_tags`/`remove_reading_tags`.
-- **Habits**: `create_habit`, `list_habits`, `get_habit`, `update_habit`,
+- **Habits**: `create_habit`, `list_habits` (pages; pass `cursor`), `get_habit`, `update_habit`,
   `archive_habit`/`unarchive_habit`, `complete_habit` (`quantity?`, `durationMinutes?`,
-  `force?` skips time window), `remove_habit_completion` (by `completionId` or `day`),
+  `force?` skips time window), `remove_habit_completion` (by `completionId` or `day`;
+  a `day` lookup reaches back through the newest 200 check-ins),
   `reorder_habits`, `add_habit_tags`/`remove_habit_tags`.
   Schedules: `{kind: daily}`, `{kind: weekly, times, byWeekday?}`, `{kind: monthly, times}`,
   `{kind: every_n_days, interval}`. Optional `graceDays` (daily streak tolerance),
@@ -194,14 +201,21 @@ pre-guessing constraints.
   `bookIds`.
 - **Saved lists** (named, reusable task-list filters): `list_saved_lists`,
   `create_saved_list`, `update_saved_list`, `delete_saved_list`.
-- **Views & reviews**: `get_view` (today/upcoming/overdue, timezone-aware),
+- **Attachments** (read-only; upload is web/app-only): `list_task_attachments
+  {taskId}`, `get_attachment {id}` (metadata), `get_attachment_url {id,
+  variant?}` (short-lived signed URL; `variant` is `served` (default),
+  `original`, or `thumbnail`). Needs `tasks:read`.
+- **Views & reviews**: `get_view` (today/upcoming/overdue, timezone-aware;
+  without `tz` it uses the timezone of the machine running the MCP server),
   `get_reviews` (due queue), `review_garden` (deep review),
   `request_garden_review`, `mark_task_reviewed`, `mark_project_reviewed`.
 - **AI**: `find_tasks` (hybrid keyword + semantic search), `ai_triage`
   (brain dump → garden-assigned tasks, recurring habits, reading-list
   saves/edits/cancels, and books - see Workflows).
-- **UI (read-only)**: `ui_view`, `ui_review_queue`, `ui_garden_board` return
-  `ui://` HTML resources.
+- **UI (read-only)**: `ui_view`, `ui_review_queue`, `ui_garden_board`,
+  `ui_habits` return `ui://` HTML resources. `ui_view` and `ui_habits` take a
+  `cursor`; when a page is cut short the result adds a text note with the
+  cursor for the next page.
 - **Settings**: `get_settings`, `update_settings` (the default review period
   applied to new tasks/projects; `defaultReviewInterval: null` disables it;
   `defaultTimezone`, an IANA string, is also settable - it's what date-only
@@ -217,7 +231,9 @@ pre-guessing constraints.
   `update_profile {displayName}` (1-60 chars; avatar upload is web-only).
 - **Keys**: `create_key` (optional `includeGrants` to let the new key see
   gardens shared with its owner - only settable if the calling key itself
-  has it), `list_keys`, `rotate_key`, `revoke_key`.
+  has it), `list_keys`, `rotate_key`, `revoke_key`. `rotate_key` and
+  `revoke_key` refuse the key this MCP server itself authenticates with (it
+  would lock the server out); rotate or revoke that one from the CLI or web app.
 
 ## Workflows
 
@@ -232,8 +248,9 @@ pre-guessing constraints.
   archives it, reversibly, independent of status) — it matches existing
   items by exact title, so an unmatched or ambiguous reference comes back as a
   reading-list clarification rather than a silent no-op or a task.
-- **Plan today** → `get_view today`. Pass the user's IANA `tz` if known so the
-  day boundary is correct.
+- **Plan today** → `get_view today`. It defaults to this machine's timezone;
+  pass the user's IANA `tz` if they are somewhere else so the day boundary is
+  correct.
 - **Add a task** → need a garden: `list_gardens` first, then `create_task` with
   `gardenId`. Set `deadline` for "today"/hard dates — that's what lands it in
   the Today view. `create_task`/`create_tasks` accept `tagIds`, `recurrence`,
@@ -241,7 +258,9 @@ pre-guessing constraints.
   habit) **inline** — set them at creation, never create-then-patch.
   `deferDate`/`deadline` are calendar days `"YYYY-MM-DD"` (no timezone); inputs
   also accept relative tokens (`"today"`, `"tomorrow"`, `"+3d"`), so no
-  client-side date math. Returned values are always `"YYYY-MM-DD"`.
+  client-side date math. The local (stdio) server sends the machine's
+  timezone, so relative tokens resolve in the user's zone; the hosted server
+  falls back to the vault timezone. Returned values are always `"YYYY-MM-DD"`.
 - **Recurring task** → set `recurrence` at creation:
   `{mode, frequency, interval, byWeekday?}`. `mode`: `on_schedule` (next = prior
   due + interval; self-heals missed days) or `on_completion` (next = completed +
@@ -295,8 +314,9 @@ pre-guessing constraints.
   `people:read|write`, settings tools `settings:read|write`, reading list tools
   `reading:read|write`, Strava tools `strava:read|write`, book tools
   `books:read|write`, calendar tools `calendar:read|write`), review tools
-  `reviews:*`, `find_tasks`/`ai_triage` need
-  `ai:invoke`, the `*_key` tools need `keys:manage`. A missing scope returns a
+  `reviews:*`, `find_tasks` needs `ai:invoke` + `tasks:read`, `ai_triage` needs
+  `ai:invoke` + `tasks:write`, `reading:write`, `habits:write`, and
+  `books:write` (it can create any of those), the `*_key` tools need `keys:manage`. A missing scope returns a
   403 tool error. Keys minted before a feature shipped won't carry its scope
   unless they hold `*`. There is no upload tool here (cover uploads are a
   web-only flow, `POST /v1/uploads` before setting `coverStorageId`), but a