{
  "openapi": "3.1.0",
  "info": {
    "title": "Content Intelligence OS Agent API",
    "version": "0.1.0",
    "description": "Read-only API for Content Intelligence OS, a category POV engine for AI governance companies. It turns AI governance source signals into profile-specific POV candidates and brief previews."
  },
  "servers": [
    {
      "url": "https://bradleyfernandes.com"
    }
  ],
  "paths": {
    "/api/source-engine/profiles": {
      "get": {
        "operationId": "listCustomerIntelligenceProfiles",
        "summary": "List demo customer intelligence profiles",
        "description": "Returns profile IDs and positioning inputs used to personalize AI governance POV generation.",
        "responses": {
          "200": {
            "description": "Available customer profiles"
          }
        }
      }
    },
    "/api/source-engine": {
      "get": {
        "operationId": "getSourceEngineSnapshot",
        "summary": "Get source engine snapshot",
        "description": "Returns the curated AI governance source registry, ranked seed signals, source scoring, and taxonomy coverage.",
        "responses": {
          "200": {
            "description": "Source engine snapshot"
          }
        }
      }
    },
    "/api/source-engine/run": {
      "get": {
        "operationId": "runGovernancePovEngine",
        "summary": "Run profile-aware AI governance POV scoring",
        "description": "Collects public AI governance source observations, transforms them into POV candidates, applies customer profile scoring, and returns promote/watch/park decisions.",
        "parameters": [
          {
            "name": "profileId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["agent-control-plane", "model-risk-evidence", "ai-procurement-risk"]
            },
            "description": "Customer profile used to personalize scoring and POV construction."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "default": 8
            },
            "description": "Maximum number of public sources to collect."
          }
        ],
        "responses": {
          "200": {
            "description": "Profile-aware weekly run"
          }
        }
      }
    },
    "/api/source-engine/brief": {
      "get": {
        "operationId": "previewGovernancePovBrief",
        "summary": "Preview email-ready POV brief",
        "description": "Returns an email-ready text and HTML brief for a profile-specific AI governance POV candidate. This is a preview only and does not send email.",
        "parameters": [
          {
            "name": "profileId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["agent-control-plane", "model-risk-evidence", "ai-procurement-risk"]
            },
            "description": "Customer profile used to personalize the brief."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "default": 8
            },
            "description": "Maximum number of public sources to collect."
          }
        ],
        "responses": {
          "200": {
            "description": "Brief preview with subject, text, HTML, profile, and top candidate."
          }
        }
      }
    }
  }
}