{
 "openapi": "3.1.0",
 "info": {
  "title": "sshh.io read API",
  "version": "1.0.0",
  "description": "Read-only, unauthenticated API for Shrivu Shankar's personal site: structured project data, agent guides, and markdown mirrors. Errors follow the site's HTTP semantics: unknown paths return 404. For richer interactions (blog search, full post text), use the MCP server at https://sshh.io/mcp (Streamable HTTP, no auth).",
  "contact": {
   "name": "Shrivu Shankar",
   "url": "https://sshh.io/contact"
  }
 },
 "servers": [
  {
   "url": "https://sshh.io"
  }
 ],
 "paths": {
  "/projects.json": {
   "get": {
    "operationId": "listProjects",
    "summary": "List all public projects",
    "description": "Structured metadata for 100 software projects: title, tagline, language, domain, tags, coolness (1-10), start date, and links.",
    "responses": {
     "200": {
      "description": "Project list",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "generated": {
           "type": "string",
           "format": "date"
          },
          "count": {
           "type": "integer"
          },
          "projects": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "tagline": {
              "type": "string"
             },
             "language": {
              "type": "string"
             },
             "domain": {
              "type": "string"
             },
             "tags": {
              "type": "string"
             },
             "coolness": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10
             },
             "start": {
              "type": "string"
             },
             "github": {
              "type": "string",
              "format": "uri"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "article": {
              "type": "string",
              "format": "uri"
             },
             "desc": {
              "type": "array",
              "items": {
               "type": "string"
              }
             }
            },
            "required": [
             "title",
             "tagline",
             "language",
             "domain",
             "coolness",
             "start"
            ]
           }
          }
         },
         "required": [
          "count",
          "projects"
         ]
        }
       }
      }
     }
    }
   }
  },
  "/llms.txt": {
   "get": {
    "operationId": "getAgentGuide",
    "summary": "Site guide for AI agents (llms.txt)",
    "description": "Markdown index of the site: bio, writing, projects, contact, and when-to-use guidance.",
    "responses": {
     "200": {
      "description": "llms.txt content",
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/llms-full.txt": {
   "get": {
    "operationId": "getFullCorpus",
    "summary": "Full content corpus (bio + projects + all blog posts as markdown)",
    "responses": {
     "200": {
      "description": "Full corpus",
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/writing.md": {
   "get": {
    "operationId": "listPosts",
    "summary": "Index of all blog posts (markdown)",
    "description": "Dated list of every post with canonical blog.sshh.io URLs. Full text of any post is available via the MCP server get_post tool or llms-full.txt.",
    "responses": {
     "200": {
      "description": "Post index",
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "externalDocs": {
  "description": "Developer & agent guide",
  "url": "https://sshh.io/developers"
 }
}