API Overview

GET /plans

{
  "plans": [
    {
      "name": "my-plan",
      "goal": "my-goal",
      "taskCount": 5,
      "progress": 0.4
    }
  ]
}

GET /plans/:name

{
  "apiVersion": "planspec.io/v1alpha1",
  "kind": "Plan",
  "metadata": {
    "name": "my-plan"
  },
  "spec": {
    "goalRef": { "name": "my-goal" },
    "tasks": [...]
  }
}

POST /plans
Content-Type: application/yaml

PUT /plans/:name
Content-Type: application/yaml

DELETE /plans/:name

GET /goals

GET /goals/:name

POST /goals
Content-Type: application/yaml

PATCH /plans/:planName/tasks/:taskId
Content-Type: application/json

{
  "status": "complete"
}

GET /plans/:planName/tasks/:taskId

POST /validate
Content-Type: application/yaml

{
  "valid": true,
  "errors": [],
  "warnings": []
}

{
  "data": {...}
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid plan structure",
    "details": [...]
  }
}

GET /plans?limit=10&offset=0

{
  "data": [...],
  "pagination": {
    "total": 25,
    "limit": 10,
    "offset": 0
  }
}