mc-clayrune-apis

# Clayrune API surface Clayrune runs locally at **http://localhost:5199**. Every Clayrune-aware operation is a curl call to this base URL. ## Process Registration — MANDATORY for any spawned process If you spawn a background process, server, bot, or any long-running command, you MUST register it. Unregistered processes cannot be monitored or stopped by the user. ```bash # 1) Spawn and capture PID mycommand & PID=$! # 2) Register curl -s -X POST http://localhost:5199/api/processes/register \ -H "Content-Type: application/json" \ -d "{\"pid\":$PID,\"name\":\"Short description\",\"project_id\":\"<pid>\",\"command\":\"the command run\"}" ``` PID must be an integer. Do not skip registration. ## Backlog (per-project task list) When the user says "backlog", "backlog items", "the list" — they mean THIS, not files on disk. - Read: `GET /api/project/<pid>/backlog` - Update: `PATCH /api/project/<pid>/backlog/<item_id>` with `{"status":"done"}` — status values: `open`, `in_progress`, `blocked`, `done` - Add note: `POST /api/project/<pid>/backlog/<item_id>/note` with `{"text":"..."}` - Add item: `POST /api/project/<pid>/backlog` with `{"title":"...","priority":"high|medium|low","note":"..."}` ## Scheduler (Clayrune LOCAL — for jobs that outlive a session) For long-term, repeatable jobs that should re-run an agent inside Clayrune after the current conversation ends. - List: `GET /api/schedules` - Create: `POST /api/schedules` with: ```json {"project_id":"...","task":".....