diff --git a/10-systems/hosts/gntasks.md b/10-systems/hosts/gntasks.md index 02ee803..44cc9ba 100644 --- a/10-systems/hosts/gntasks.md +++ b/10-systems/hosts/gntasks.md @@ -6,7 +6,7 @@ owner: gmikcon status: active confidence: "100" -last_reviewed: "2026-09-30" +last_reviewed: "2026-10-02" review_interval: "90d" source_of_truth: "ssh-host-and-owner-confirmed" --- @@ -71,6 +71,13 @@ - **rei (192.168.1.168):** config /home/ubuntu/navi-1/mcp_servers.d/gntodo.json (transport streamable_http, Bearer header, groups read/write), profile server_admin config.json got `gntodo: [read, write]` in tools.agent.mcp and tools.subagent.mcp. Applied via navi.service restart (restart kills the running agent turn — service enters deactivating until the turn ends, then systemd starts the new process; Restart=always). - **Other instances (ayame, tsukiko, pilar, kael, zoe):** same config shape applies; not yet deployed there. +## REST API (verified 2026-10-02, rei) + +- The same per-user Bearer MCP token also authorizes the plain REST API: `Authorization: Bearer ` on https://tasks.gnexus.space/api/* — no separate token needed. Without the header → 401 {"detail":"Not authenticated"}. +- Verified endpoints: GET /api/projects (list), GET /api/tasks?project_id=&limit=200 (flat task list with status/tags/project/description), DELETE /api/tasks/{id} → 200 {"ok":true}, PATCH /api/tasks/{id} with JSON body (e.g. {"status":"done"}) → 200 with updated task. /openapi.json returns the SPA HTML (no spec), /api/projects/{id}/tasks → 404. +- **Use REST for bulk operations** (imports, deduplication, mass status changes): it is fast and reliable, while MCP tools/call over SSE can split a JSON-RPC response into chunks — a naive parser sees a broken response, retries, and the server has already committed the change → duplicates. This happened during the SmartHome Trello import (2026-10-02): ~150 duplicate tasks created by retries, cleaned up by title-based deduplication via REST DELETE. MCP remains fine for single interactive calls. +- Task statuses: to_do / in_progress / done / cancelled. create_task (MCP) cannot set status at creation — create then PATCH/update_task. + ## Deploy notes (navi ayame) - Docker 29.1.3 was preinstalled; docker compose plugin v5.5.1 installed manually to /usr/local/lib/docker/cli-plugins/docker-compose before install.sh