Sprint OS

1. Deploy the Convex backend in scripts/convex-setup.md 2. Set CONVEX_SPRINT_URL to your Convex HTTP site URL (e.g., https://your-deployment.convex.site) 3. Sprints will auto-log on step 7 of each loop

Endpoints

| Method | Path | Purpose | |--------|------|---------| | POST | /sprints/log | Log a completed sprint | | GET | /sprints/recent?project=X&limit=N | Recent sprint history | | GET | /sprints/stats?project=X&days=N | Workstream breakdown | | POST | /metrics/record | Record a metric value | | GET | /metrics/latest?metric=X | Current metric value | | GET | /metrics/trend?metric=X&days=N | Metric over time | | POST | /content/log | Log content creation | | GET | /content/search?query=X | Deduplication check |

Sprint Log Payload

curl -X POST $CONVEX_SPRINT_URL/sprints/log \
  -H "Content-Type: application/json" \
  -d '{
    "sprintId": 1,
    "project": "my-project",
    "workstream": "marketing",
    "task": "Write homepage headline variants",
    "artifact": "3 headline variants in headlines.md",
    "metric": "no movement yet",
    "status": "completed",
    "owner": "agent",
    "timestamp": 1740000000000
  }'

Script

Use scripts/log-sprint.sh for quick CLI logging:

./scripts/log-sprint.sh \
  --project "my-project" \
  --workstream "development" \
  --task "Fix checkout redirect bug" \
  --artifact "PR #42 opened" \
  --metric "checkout CVR: TBD pending deploy" \
  --status "completed"