{
  "openapi": "3.1.0",
  "info": {
    "title": "Kan Ninomiya Public Context API",
    "version": "1.1.0",
    "description": "Public, reviewed, read-only context. HTML, Markdown, JSON, and MCP are generated from the same Git-reviewed data."
  },
  "servers": [
    {
      "url": "https://kan.run"
    }
  ],
  "paths": {
    "/api/v1/profile": {
      "get": {
        "operationId": "getProfile",
        "responses": {
          "200": {
            "description": "Public profile"
          }
        }
      }
    },
    "/api/v1/projects": {
      "get": {
        "operationId": "listProjects",
        "responses": {
          "200": {
            "description": "Public projects"
          }
        }
      }
    },
    "/api/v1/projects/{id}": {
      "get": {
        "operationId": "getProject",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public project"
          },
          "404": {
            "description": "Project not found"
          }
        }
      }
    },
    "/api/v1/now": {
      "get": {
        "operationId": "getCurrentFocus",
        "responses": {
          "200": {
            "description": "Current public focus"
          }
        }
      }
    },
    "/api/v1/search": {
      "get": {
        "operationId": "searchPublicKnowledge",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ranked public search results"
          },
          "400": {
            "description": "Missing query"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "MCP discovery",
    "url": "https://kan.run/.well-known/mcp.json"
  }
}