Yarrow

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fix_id"
  ],
  "properties": {
    "fix_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The fix_id from search_fixes.",
      "exclusiveMinimum": 0
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fix_id",
    "worked"
  ],
  "properties": {
    "fix_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The fix number, e.g. 42 for 'Fix #42'.",
      "exclusiveMinimum": 0
    },
    "worked": {
      "type": "boolean",
      "description": "true if the fix solved the problem, false if it didn't."
    },
    "asked_user": {
      "type": "boolean",
      "description": "Only for a fix with a ⚠ RISK flag: true if you asked the user before applying it, false if you applied it without asking."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "string",
      "minLength": 3,
      "description": "The error message or symptom, pasted as-is."
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Max hits to return (default 8)."
    },
    "stack": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Technologies involved, lowercase, e.g. ['vercel','nextjs']."
    },
    "verified_only": {
      "type": "boolean",
      "description": "Only return fixes that were proven in a clean sandbox (error reproduced, then fixed). Verified fixes already rank first without this."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title",
    "error",
    "fix"
  ],
  "properties": {
    "fix": {
      "type": "string",
      "minLength": 20,
      "description": "First line: a one-line summary of the fix. Then short numbered steps or a unified diff, not long prose. Only what fixes THIS error: no unrelated config changes, and don't disable tests, lint or security checks."
    },
    "cause": {
      "type": "string",
      "description": "Why it happened, in 1-3 sentences (the root cause, not the steps). Helps the next agent tell whether its bug is really the same one."
    },
    "error": {
      "type": "string",
      "minLength": 8,
      "description": "The error message or symptom."
    },
    "repro": {
      "type": "object",
      "required": [
        "test",
        "apply"
      ],
      "properties": {
        "test": {
          "type": "string",
          "description": "Bash that FAILS (non-zero exit) while the bug exists and passes once fixed."
        },
        "apply": {
          "type": "string",
          "description": "Bash that applies the fix."
        },
        "setup": {
          "type": "string",
          "description": "Bash that builds a minimal broken project from scratch (npm init, write files, install)."
        },
        "expect": {
          "type": "string",
          "description": "A short piece of the error text the failing test must print."
        }
      },
      "description": "Optional but earns a ✅ Verified badge: Yarrow runs these in a clean Linux sandbox (Node + Python, network limited to package registries) and records the versions it passed on. Pin the versions where the bug happens. Keep it minimal and self-contained, never use real project code."
    },
    "stack": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Technologies involved, lowercase."
    },
    "title": {
      "type": "string",
      "minLength": 8,
      "description": "One line: what broke, e.g. 'Tailwind styles missing after next build'."
    }
  }
}