{
  "openapi": "3.0.3",
  "info": {
    "title": "LOTD Platform API",
    "description": "Robot-facing contract surface for the LOTD learner stack. Integrate lessons, proofs, protocols, and telemetry.",
    "version": "2026-03-09",
    "contact": {
      "email": "dallas@lotdpbc.com",
      "url": "https://lotdpbc.com/embed"
    }
  },
  "servers": [
    {
      "url": "https://api.lotdpbc.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/v1": {
      "get": {
        "summary": "API discovery",
        "description": "List available routes and versions",
        "responses": {
          "200": {
            "description": "Discovery payload"
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "summary": "Health check",
        "responses": {
          "200": {
            "description": "Service health"
          }
        }
      }
    },
    "/v1/future-state": {
      "get": {
        "summary": "Future-state contract",
        "description": "Learner OS doctrine, epics, domains",
        "responses": {
          "200": {
            "description": "Future-state document"
          }
        }
      }
    },
    "/v1/topology": {
      "get": {
        "summary": "Platform topology",
        "responses": {
          "200": {
            "description": "Topology document"
          }
        }
      }
    },
    "/v1/status": {
      "get": {
        "summary": "Observability status",
        "responses": {
          "200": {
            "description": "Status snapshot"
          }
        }
      }
    },
    "/v1/benchmarks": {
      "get": {
        "summary": "Benchmarks",
        "responses": {
          "200": {
            "description": "Benchmark data"
          }
        }
      }
    },
    "/v1/search/query": {
      "get": {
        "summary": "Search (GET)",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Search results"
          }
        }
      },
      "post": {
        "summary": "Search (POST)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Search results"
          }
        }
      }
    },
    "/v1/kelly": {
      "get": {
        "summary": "Kelly for All",
        "responses": {
          "200": {
            "description": "Kelly contract"
          }
        }
      }
    },
    "/v1/kelly/remediation": {
      "get": {
        "summary": "Kelly remediation",
        "responses": {
          "200": {
            "description": "Remediation data"
          }
        }
      }
    },
    "/v1/kelly/rebuild-factory": {
      "get": {
        "summary": "Kelly rebuild factory",
        "responses": {
          "200": {
            "description": "Rebuild factory data"
          }
        }
      }
    },
    "/v1/learner/overview": {
      "get": {
        "summary": "Learner overview",
        "responses": {
          "200": {
            "description": "Learner overview"
          }
        }
      }
    },
    "/v1/learner/graph": {
      "get": {
        "summary": "Learner graph",
        "responses": {
          "200": {
            "description": "Learner graph"
          }
        }
      }
    },
    "/v1/learner/runtime": {
      "get": {
        "summary": "Adaptive lesson runtime",
        "responses": {
          "200": {
            "description": "Runtime data"
          }
        }
      }
    },
    "/v1/protocol/compiler": {
      "get": {
        "summary": "Protocol compiler",
        "responses": {
          "200": {
            "description": "Protocol compiler"
          }
        }
      }
    },
    "/v1/trust/fabric": {
      "get": {
        "summary": "Trust fabric",
        "responses": {
          "200": {
            "description": "Trust fabric"
          }
        }
      }
    },
    "/v1/network": {
      "get": {
        "summary": "Network APIs",
        "responses": {
          "200": {
            "description": "Network capabilities"
          }
        }
      }
    }
  }
}