OG audit

curl -X POST https://api.ogstack.dev/audits \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/post", "includeAi": true }'

GET /api/audits/{id}

{
  "id": "5b5...",
  "url": "https://example.com/post",
  "overallScore": 78,
  "letterGrade": "B+",
  "categoryScores": { "og": 85, "twitter": 70, "seo": 75 },
  "metadata": {
    "title": "How we built OGStack",
    "description": "From idea to production in six weeks.",
    "image": "https://example.com/og.png",
    "twitterCardType": "summary_large_image"
  },
  "issues": [
    {
      "id": "twitter-creator-missing",
      "category": "twitter",
      "severity": "warning",
      "pass": false,
      "title": "Missing twitter:creator",
      "message": "Twitter shows author attribution when twitter:creator is set.",
      "fix": "Add `<meta name=\"twitter:creator\" content=\"@yourhandle\">`"
    }
  ],
  "ai": {
    "status": "READY",
    "error": null,
    "analysis": {
      "priorityActions": [
        {
          "title": "Rewrite og:description for clarity",
          "rationale": "Current description trails off mid-sentence.",
          "impact": "high"
        }
      ],
      "suggestions": {
        "og": {
          "title": "How we built OGStack in six weeks",
          "description": "The architecture, tradeoffs, and three things we'd do differently."
        },
        "twitter": {
          "title": "How we built OGStack in six weeks",
          "description": "From idea to production in six weeks — architecture, tradeoffs, and three things we'd do differently."
        }
      },
      "audienceFit": "strong",
      "severity": "low",
      "confidence": "high"
    }
  }
}