Add skill: ricardofrantz/bun-do-api

skills/ricardofrantz/bun-do-api/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: bun-do-api
+description: >
+  Manage bun-do tasks and projects — add tasks, edit tasks, delete tasks,
+  toggle done, manage subtasks, and log project progress entries. Use when the
+  user says "add a todo", "update task", "remove task", "mark done", "add
+  subtask", "log progress", "update project", or any variant of managing
+  tasks/projects. Also use when an agent finishes work and needs to record
+  progress. Triggers on: "todo", "task", "remind me", "due", "deadline",
+  "payment", "bill", "backlog", "what do I need to do", "what's overdue",
+  "add to my list".
+---
+
+# bun-do — your local task backend
+
+> "Add P1 task: renew passport, due March 30, recurring yearly, with €85 payment"
+
+bun-do is a local-first todo app. REST API at `http://localhost:8000`. All data persists to JSON on disk. Nothing leaves your machine.
+
+**Start**: `bun-do start` (install: `bun install -g bun-do`)
+**Data**: `~/.bun-do/` (override: `BUNDO_DATA_DIR`)
+**Port**: 8000 (override: `--port=PORT`)
+
+## How users talk (map these to API calls)
+
+| User says | Action |
+|-----------|--------|
+| "add task: buy milk" | POST `/api/tasks` `{"title": "Buy milk"}` |
+| "remind me to call dentist tomorrow" | POST with `{"title": "Call dentist", "date": "TOMORROW", "type": "reminder"}` |
+| "P0 deadline: submit proposal by Friday" | POST with `{"title": "Submit proposal", "date": "FRIDAY", "priority": "P0", "type": "deadline"}` |
+| "add monthly payment: rent €1200 on the 1st" | POST with `{"title": "Rent", "type": "payment", "amount": "1200", "currency": "EUR", "recurrence": {"type": "monthly", "day": 1}}` |
+| "what's overdue?" | GET `/api/tasks`, filter `done=false` where `date < today` |
+| "mark passport task done" | Search by title → PUT `{"done": true}` |
+| "what should I do today?" | GET `/api/tasks`, filter for today's date, sort by priority |
+| "move it to next week" | PUT with `{"date": "NEXT_MONDAY"}` |
+| "add subtask: book flight" | POST `/api/tasks/{id}/subtasks` `{"title": "Book flight"}` |
+| "log progress on bun-do: shipped v1.3" | POST `/api/projects/{id}/entries` `{"summary": "Shipped v1.3"}` |
+
+**Important**: Always resolve relative dates ("tomorrow", "next Friday") to `YYYY-MM-DD` before sending.
+
+## API reference
+
+| Action | Method | Endpoint |
+|--------|--------|----------|
+| List tasks | GET | `/api/tasks` |
+| Add task | POST | `/api/tasks` |
+| Edit task | PUT | `/api/tasks/{id}` |
+| Delete task | DELETE | `/api/tasks/{id}` |
+| Add subtask | POST | `/api/tasks/{id}/subtasks` |
+| Edit subtask | PUT | `/api/tasks/{id}/subtasks/{sid}` |
+| Delete subtask | DELETE | `/api/tasks/{id}/subtasks/{sid}` |
+| Reorder backlog | POST | `/api/tasks/reorder` |
+| Clear done | POST | `/api/tasks/clear-done` |
+| List projects | GET | `/api/projects` |
+| Add project | POST | `/api/projects` |
+| Edit project | PUT | `/api/projects/{id}` |
+| Delete project | DELETE | `/api/projects/{id}` |
+| Add log entry | POST | `/api/projects/{id}/entries` |
+| Delete log entry | DELETE | `/api/projects/{id}/entries/{eid}` |
+
+## Task fields
+
+```json
+{
+  "title": "string (required)",
+  "date": "YYYY-MM-DD (default: today)",
+  "priority": "P0 | P1 | P2 | P3 (default: P2)",
+  "type": "task | deadline | reminder | payment (default: task)",
+  "notes": "string",
+  "done": false,
+  "amount": "string (for payments)",
+  "currency": "CHF | USD | EUR | BRL (default: CHF)",
+  "recurrence": null | {"type": "weekly", "dow": 0-6} | {"type": "monthly", "day": 1-31} | {"type": "yearly", "month": 1-12, "day": 1-31}
+}
+```
+
+**Priorities**: P0 = critical/drop everything, P1 = high/do today, P2 = normal, P3 = backlog (not on calendar).
+**Types**: `task` = actionable, `deadline` = hard date, `reminder` = FYI, `payment` = bill/invoice tracker.
+**Recurring**: When a recurring task is marked done, the next occurrence is auto-created.
+
+## Curl patterns
+
+### Before any operation — check server is up
+
+```bash
+curl -sf http://localhost:8000/api/tasks > /dev/null && echo "OK" || echo "Server not running — run: bun-do start"
+```
+
+### Add a task
+
+```bash
+curl -s -X POST http://localhost:8000/api/tasks \
+  -H 'Content-Type: application/json' \
+  -d '{"title": "Buy milk", "date": "2026-03-01", "priority": "P2"}'
+```
+
+### Add a recurring payment
+
+```bash
+curl -s -X POST http://localhost:8000/api/tasks \
+  -H 'Content-Type: application/json' \
+  -d '{"title": "Server hosting", "date": "2026-03-01", "priority": "P1", "type": "payment", "amount": "29", "currency": "USD", "recurrence": {"type": "monthly", "day": 1}}'
+```
+
+### Find task by title → get ID
+
+```bash
+curl -s http://localhost:8000/api/tasks | python3 -c "
+import sys, json
+for t in json.load(sys.stdin)['tasks']:
+    if 'SEARCH' in t['title'].lower(): print(t['id'], t['title'])
+"
+```
+
+### Edit (only send fields to change)
+
+```bash
+curl -s -X PUT http://localhost:8000/api/tasks/TASK_ID \
+  -H 'Content-Type: application/json' \
+  -d '{"priority": "P0", "date": "2026-03-15"}'
+```
+
+### Mark done
+
+```bash
+curl -s -X PUT http://localhost:8000/api/tasks/TASK_ID \
+  -H 'Content-Type: application/json' \
+  -d '{"done": true}'
+```
+
+### Delete
+
+```bash
+curl -s -X DELETE http://localhost:8000/api/tasks/TASK_ID
+```
+
+### Add subtask
+
+```bash
+curl -s -X POST http://localhost:8000/api/tasks/TASK_ID/subtasks \
+  -H 'Content-Type: application/json' \
+  -d '{"title": "Step one"}'
+```
+
+### Log project progress
+
+```bash
+curl -s -X POST http://localhost:8000/api/projects/PROJECT_ID/entries \
+  -H 'Content-Type: application/json' \
+  -d '{"summary": "Shipped v1.3 with MCP server and OpenClaw skill"}'
+```
+
+## Proactive patterns
+
+Use these patterns for scheduled/autonomous behavior:
+
+**Morning briefing**: GET `/api/tasks`, filter for today + overdue, summarize by priority.
+**End of day**: Mark completed tasks done, add entries to active projects.
+**Weekly review**: List all tasks, highlight overdue + P0/P1 without progress.
+**Payment forecast**: List tasks where `type=payment`, group by month, sum amounts.
+
+## Rules
+
+- Always verify the server is running before any API call.
+- Never guess IDs — search by title first, then use the UUID.
+- Dates must be `YYYY-MM-DD`. Resolve "tomorrow", "next Monday", etc. before sending.
+- Only send fields you want to change on PUT requests.
+- The API returns the created/updated object on success.
+- `GET /api/tasks` auto-carries overdue non-payment tasks to today.

skills/ricardofrantz/bun-do-api/_meta.json

@@ -0,0 +1,11 @@
+{
+  "owner": "ricardofrantz",
+  "slug": "bun-do-api",
+  "displayName": "bun-do",
+  "latest": {
+    "version": "1.3.0",
+    "publishedAt": 1739888400000,
+    "commit": ""
+  },
+  "history": []
+}