{
  "$comment": "The questions of the code generator playground (/tools/generator/playground, docs/adrs/228_code_generator_playground.md). The page renders them as plain forms after a run and serves this file at /tools/generator/playground/surveys.json for AI agents. `for` lists the kinds of target a survey is asked about (client, server, schema), `standards` the input standards (openapi, asyncapi, graphql, protobuf; all when left out). The questions ask what matters most, not what is missing, since a target may already do some of what an option names. Ids of surveys and options are stable: answers are counted by them, so reword a label freely and never reuse an id for another meaning.",
  "format": 1,
  "issues": "https://github.com/mykulyak/api-genie/issues/new",
  "surveys": [
    {
      "id": "next-feature",
      "for": [
        "client"
      ],
      "standards": [
        "openapi"
      ],
      "question": "Which of these matter most to you in this client?",
      "multiple": true,
      "options": [
        {
          "id": "retries",
          "label": "Retries and timeouts"
        },
        {
          "id": "pagination",
          "label": "Helpers for paginated lists"
        },
        {
          "id": "auth",
          "label": "Built-in auth flows (OAuth 2.0, refresh tokens)"
        },
        {
          "id": "streaming",
          "label": "Streaming responses and server-sent events"
        },
        {
          "id": "http-library",
          "label": "A choice of HTTP library"
        },
        {
          "id": "smaller",
          "label": "Less code, fewer files"
        },
        {
          "id": "docs",
          "label": "Usage examples in the generated README"
        }
      ],
      "other": true
    },
    {
      "id": "next-feature",
      "for": [
        "server"
      ],
      "standards": [
        "openapi"
      ],
      "question": "Which of these matter most to you in this server?",
      "multiple": true,
      "options": [
        {
          "id": "validation",
          "label": "Stricter request validation"
        },
        {
          "id": "auth",
          "label": "Security handlers wired from the spec"
        },
        {
          "id": "framework-version",
          "label": "Another framework or framework version"
        },
        {
          "id": "observability",
          "label": "Logging, metrics and tracing hooks"
        },
        {
          "id": "stubs",
          "label": "Handler stubs that return the spec's examples"
        },
        {
          "id": "smaller",
          "label": "Less code, fewer files"
        },
        {
          "id": "docs",
          "label": "Usage examples in the generated README"
        }
      ],
      "other": true
    },
    {
      "id": "next-feature",
      "for": [
        "client",
        "server"
      ],
      "standards": [
        "asyncapi"
      ],
      "question": "Which of these matter most to you in this client or server?",
      "multiple": true,
      "options": [
        {
          "id": "reconnect",
          "label": "Reconnects and retries with backoff"
        },
        {
          "id": "request-reply",
          "label": "Request-reply helpers"
        },
        {
          "id": "errors",
          "label": "Typed errors and dead-letter handling"
        },
        {
          "id": "validation",
          "label": "Messages checked against their schemas"
        },
        {
          "id": "observability",
          "label": "Logging, metrics and tracing hooks"
        },
        {
          "id": "framework-version",
          "label": "Another library or framework version"
        },
        {
          "id": "smaller",
          "label": "Less code, fewer files"
        },
        {
          "id": "docs",
          "label": "Usage examples in the generated README"
        }
      ],
      "other": true
    },
    {
      "id": "next-feature",
      "for": [
        "client",
        "server"
      ],
      "standards": [
        "protobuf",
        "graphql"
      ],
      "question": "Which of these matter most to you in this client or server?",
      "multiple": true,
      "options": [
        {
          "id": "deadlines",
          "label": "Deadlines and retries on calls"
        },
        {
          "id": "middleware",
          "label": "Interceptors or middleware for auth and logging"
        },
        {
          "id": "streaming",
          "label": "Streaming calls and subscriptions"
        },
        {
          "id": "framework-version",
          "label": "Another library or framework version"
        },
        {
          "id": "smaller",
          "label": "Less code, fewer files"
        },
        {
          "id": "docs",
          "label": "Usage examples in the generated README"
        }
      ],
      "other": true
    },
    {
      "id": "next-feature",
      "for": [
        "schema"
      ],
      "question": "Which of these matter most to you in these schemas?",
      "multiple": true,
      "options": [
        {
          "id": "formats",
          "label": "More string formats checked"
        },
        {
          "id": "messages",
          "label": "Custom error messages"
        },
        {
          "id": "recursive-types",
          "label": "Inferred types for recursive schemas instead of unknown"
        },
        {
          "id": "smaller",
          "label": "Less code, fewer files"
        }
      ],
      "other": true
    },
    {
      "id": "would-use",
      "for": [
        "client",
        "server",
        "schema"
      ],
      "question": "Would you use this output in a project?",
      "multiple": false,
      "options": [
        {
          "id": "as-is",
          "label": "Yes, as it is"
        },
        {
          "id": "with-changes",
          "label": "Yes, after small changes"
        },
        {
          "id": "not-yet",
          "label": "Not yet: something important is missing"
        },
        {
          "id": "no",
          "label": "No, I'd write it by hand"
        }
      ],
      "other": true
    }
  ]
}