traces.ribdsp.com

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "One line naming the bug, e.g. \"Province dropdown is empty, so checkout cannot be completed\". At most 120 characters."
    },
    "summary": {
      "type": "string",
      "description": "A short paragraph on what happened and why it matters. At most 600 characters."
    },
    "steps": {
      "type": "array",
      "description": "The reproduction steps, in order, at most 12. Pass an empty array to have the page reconstruct them from the recorded events instead of writing them yourself.",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "One action, e.g. \"Open the province dropdown\". At most 200 characters."
          },
          "atMs": {
            "type": "number",
            "description": "When the recording shows this step happening, in milliseconds from the start, e.g. 28412. Give it whenever you know it: a step with no timestamp cannot be matched against the recorded events and is shown to the human as unverified."
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false
      }
    },
    "expected": {
      "type": "string",
      "description": "What should have happened, e.g. \"The dropdown lists the provinces for the selected country.\""
    },
    "actual": {
      "type": "string",
      "description": "What did happen, e.g. \"The dropdown opened with no options and the Pay button stayed disabled.\""
    },
    "rootCause": {
      "type": "string",
      "description": "Your explanation of the cause, in one or two sentences, based on what you found in the recording."
    },
    "evidence": {
      "type": "array",
      "description": "The moments that back the report, at most 10. Each becomes a clickable timestamp in the report.",
      "items": {
        "type": "object",
        "properties": {
          "atMs": {
            "type": "number",
            "description": "When it happened, in milliseconds from the start of the recording, e.g. 28412."
          },
          "note": {
            "type": "string",
            "description": "What that moment shows, in a few words, e.g. \"GET /provinces returned 500\"."
          }
        },
        "required": [
          "atMs"
        ],
        "additionalProperties": false
      }
    },
    "ticket": {
      "type": "string",
      "description": "Only when retrying a call that previously returned status \"pending\". Do not invent one — pass back exactly the ticket you were given, e.g. \"ask-1a2b3c4d\"."
    }
  },
  "required": [
    "title",
    "steps",
    "rootCause"
  ],
  "additionalProperties": false
}