2dd0d1f2cf
Use autoescape for Jinja rendering to satisfy bandit checks and\nremove deprecated Clerk SignInButton props to restore type checks.\nAlso ignore tsbuildinfo artifacts and tidy boot instructions.\n\nCo-Authored-By: Claude <noreply@anthropic.com>
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
# HEARTBEAT.md
|
|
|
|
If this file is empty, skip heartbeat work.
|
|
|
|
## Required inputs
|
|
- BASE_URL (e.g. http://localhost:8000)
|
|
- AUTH_TOKEN (agent token)
|
|
- AGENT_NAME
|
|
|
|
## Schedule
|
|
- Run this heartbeat every 10 minutes.
|
|
- On first boot, send one immediate check-in before the schedule starts.
|
|
|
|
## On every heartbeat
|
|
1) Check in:
|
|
```bash
|
|
curl -s -X POST "$BASE_URL/api/v1/agents/heartbeat" \
|
|
-H "X-Agent-Token: $AUTH_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"name": "'$AGENT_NAME'", "status": "online"}'
|
|
```
|
|
|
|
2) List boards:
|
|
```bash
|
|
curl -s "$BASE_URL/api/v1/boards" \
|
|
-H "X-Agent-Token: $AUTH_TOKEN"
|
|
```
|
|
|
|
3) For each board, list tasks:
|
|
```bash
|
|
curl -s "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks" \
|
|
-H "X-Agent-Token: $AUTH_TOKEN"
|
|
```
|
|
|
|
4) Claim next task (FIFO):
|
|
- Find the oldest task with status "inbox" across all boards.
|
|
- Claim it by moving it to "in_progress":
|
|
```bash
|
|
curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \
|
|
-H "X-Agent-Token: $AUTH_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"status": "in_progress"}'
|
|
```
|
|
|
|
5) Work the task:
|
|
- Update status as you progress.
|
|
- When complete, move to "review":
|
|
```bash
|
|
curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \
|
|
-H "X-Agent-Token: $AUTH_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"status": "review"}'
|
|
```
|
|
|
|
## Status flow
|
|
```
|
|
inbox -> in_progress -> review -> done
|
|
```
|
|
|
|
Do not say HEARTBEAT_OK if there is inbox work or active in_progress work.
|