{
  "openapi": "3.1.0",
  "info": {
    "title": "Sergiu Iliev - Machine-to-Machine Profile & Outreach API",
    "version": "1.0.0",
    "description": "Machine-readable API for automated recruitment, technical advisory, and consulting inquiries directed to Sergiu Iliev (Aerospace Systems Engineer, AI Researcher, Entrepreneur). Provides structured credentials, advisory domains, and automated inquiry dispatch endpoints with mailto fallbacks.",
    "contact": {
      "name": "Sergiu Iliev",
      "email": "sergiu@iliev.us",
      "url": "https://iliev.us"
    }
  },
  "servers": [
    {
      "url": "https://iliev.us",
      "description": "Production Web & Agent Gateway"
    }
  ],
  "paths": {
    "/profile": {
      "get": {
        "summary": "Get Engineer Profile & Credentials",
        "description": "Returns verified educational credentials, professional experience (Destinus, Spacept, CMU), key competencies, and verified communication channels for Sergiu Iliev.",
        "operationId": "getProfile",
        "responses": {
          "200": {
            "description": "Structured engineering profile and credentials.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EngineerProfile"
                },
                "example": {
                  "name": "Sergiu Iliev",
                  "degrees": [
                    {
                      "degree": "Master of Engineering (MEng)",
                      "field": "Aeronautical Engineering",
                      "honors": "First Class Honours, ACGI",
                      "institution": "Imperial College London",
                      "period": "2012 - 2016"
                    }
                  ],
                  "experience": [
                    {
                      "organization": "Destinus",
                      "role": "Systems Engineer / Flight Test Engineer",
                      "period": "2021 - Present",
                      "summary": "Hypersonic autonomous aircraft development, liquid/gaseous hydrogen propulsion testing, aerodynamic evaluation, suborbital flight test campaigns across Central Europe."
                    },
                    {
                      "organization": "Spacept",
                      "role": "Co-Founder / Systems & AI",
                      "period": "2019 - 2021",
                      "summary": "Pioneered satellite Earth observation analytics utilizing computer vision to detect infrastructure hazards across power grid lines and railway corridors."
                    },
                    {
                      "organization": "Carnegie Mellon University (CMU)",
                      "role": "Machine Learning Researcher",
                      "period": "2018 - 2019",
                      "summary": "Applied machine learning research, computer vision models, and sensor data pipelines for robotic perception."
                    }
                  ],
                  "core_competencies": [
                    "Hypersonic Aerodynamics & Flight Testing",
                    "Systems Engineering & Avionics Architecture",
                    "Autonomous Unmanned Systems",
                    "Satellite Data & Remote Sensing Computer Vision",
                    "Clean Sustainable Propulsion (Hydrogen)",
                    "Deep-Tech Venture Architecture"
                  ],
                  "contacts": {
                    "email": "sergiu@iliev.us",
                    "phone_ro": "+40741070812",
                    "phone_us": "+14242551216",
                    "linkedin": "https://uk.linkedin.com/in/sergiuiliev",
                    "github": "https://github.com/SergiuIliev",
                    "website": "https://iliev.us"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/consulting": {
      "get": {
        "summary": "Get Technical Advisory Domains & Engagement Models",
        "description": "Returns technical advisory focus areas, consulting engagement structures (fractional CTO, advisory board, systems architecture reviews), and baseline engagement terms.",
        "operationId": "getConsulting",
        "responses": {
          "200": {
            "description": "Advisory domains and engagement models.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConsultingInfo"
                },
                "example": {
                  "advisory_domains": [
                    {
                      "domain": "Aerospace & Autonomous Flight Systems",
                      "focus_areas": [
                        "Hypersonic airframe and propulsion integration",
                        "Suborbital flight test campaign design and telemetry pipelines",
                        "Avionics architecture, hardware-in-the-loop (HIL) testing, and autonomous GNC"
                      ]
                    },
                    {
                      "domain": "Deep-Tech AI & Satellite Analytics",
                      "focus_areas": [
                        "Satellite remote sensing pipelines and geospatial ML models",
                        "Edge computer vision deployment on autonomous aerospace platforms",
                        "Sensor fusion across heterogeneous optical and radar feeds"
                      ]
                    },
                    {
                      "domain": "Venture Architecture & Technical Due Diligence",
                      "focus_areas": [
                        "Dual-use aerospace technology assessment for venture capital",
                        "Seed-to-Series A technical roadmap definition for hardware/deep-tech startups",
                        "Fractional CTO and engineering advisory board governance"
                      ]
                    }
                  ],
                  "engagement_models": [
                    {
                      "model": "Strategic Technical Advisory",
                      "commitment": "Retainer (e.g. 5-15 hrs/month)",
                      "description": "Advisory board role, periodic architecture evaluations, executive sounding board."
                    },
                    {
                      "model": "Sprint-Based Systems Consulting",
                      "commitment": "Project milestone (2-6 weeks)",
                      "description": "Deep-dive systems evaluation, flight test readiness audit, or technical due diligence report."
                    },
                    {
                      "model": "Fractional Systems Lead / CTO",
                      "commitment": "Quarterly engagement",
                      "description": "High-impact leadership steering complex aerospace or AI engineering programs."
                    }
                  ],
                  "preferred_outreach": "Submit inquiry via POST /inquiries or email mailto:sergiu@iliev.us?subject=[AI%20Outreach]%20Consulting%20Inquiry"
                }
              }
            }
          }
        }
      }
    },
    "/inquiries": {
      "post": {
        "summary": "Submit Outreach or Recruitment Proposal",
        "description": "Entry point for automated recruitment bots, venture scout agents, and consulting aggregators to submit a structured engagement proposal. If the HTTP endpoint cannot complete direct delivery, clients should automatically fallback to the specified mailto URI format: `mailto:sergiu@iliev.us?subject=[AI%20Outreach]%20...`.",
        "operationId": "submitInquiry",
        "requestBody": {
          "required": true,
          "description": "Validated inquiry payload from an AI agent or recruiter bot.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InquirySubmission"
              },
              "example": {
                "sender_name": "Dr. Elena Vance",
                "company": "Horizon Aerospace Ventures",
                "role_or_project": "Technical Advisory Board - Hypersonic Propulsion Project",
                "opportunity_type": "technical_advisory",
                "budget_or_compensation": "15,000 USD/quarter retainer + equity grant",
                "message": "We are developing autonomous high-speed atmospheric vehicles and would like to engage Sergiu Iliev for advisory review of our avionics and propulsion architecture.",
                "contact_email": "e.vance@horizonaero.example"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Inquiry accepted and parsed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquiryResponse"
                },
                "example": {
                  "status": "received",
                  "message": "Inquiry successfully recorded. A human review is underway.",
                  "inquiry_id": "inq_78f192b6a",
                  "mailto_fallback": "mailto:sergiu@iliev.us?subject=[AI%20Outreach]%20Horizon%20Aerospace%20Ventures%20-%20Technical%20Advisory&body=Opportunity%20Type:%20technical_advisory%0ACompany:%20Horizon%20Aerospace%20Ventures%0ARole:%20Technical%20Advisory%20Board%20-%20Hypersonic%20Propulsion%20Project%0ACompensation:%2015,000%20USD/quarter%20retainer%20+%20equity%20grant%0AFrom:%20Dr.%20Elena%20Vance%20%3Ce.vance@horizonaero.example%3E%0A%0AMessage:%0AWe%20are%20developing%20autonomous%20high-speed%20atmospheric%20vehicles%20and%20would%20like%20to%20engage%20Sergiu%20Iliev%20for%20advisory%20review%20of%20our%20avionics%20and%20propulsion%20architecture."
                }
              }
            }
          },
          "400": {
            "description": "Validation error in submitted fields.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "EngineerProfile": {
        "type": "object",
        "required": ["name", "degrees", "experience", "contacts"],
        "properties": {
          "name": {
            "type": "string"
          },
          "degrees": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "degree": { "type": "string" },
                "field": { "type": "string" },
                "honors": { "type": "string" },
                "institution": { "type": "string" },
                "period": { "type": "string" }
              }
            }
          },
          "experience": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "organization": { "type": "string" },
                "role": { "type": "string" },
                "period": { "type": "string" },
                "summary": { "type": "string" }
              }
            }
          },
          "core_competencies": {
            "type": "array",
            "items": { "type": "string" }
          },
          "contacts": {
            "type": "object",
            "properties": {
              "email": { "type": "string", "format": "email" },
              "phone_ro": { "type": "string" },
              "phone_us": { "type": "string" },
              "linkedin": { "type": "string", "format": "uri" },
              "github": { "type": "string", "format": "uri" },
              "website": { "type": "string", "format": "uri" }
            }
          }
        }
      },
      "ConsultingInfo": {
        "type": "object",
        "required": ["advisory_domains", "engagement_models"],
        "properties": {
          "advisory_domains": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "domain": { "type": "string" },
                "focus_areas": {
                  "type": "array",
                  "items": { "type": "string" }
                }
              }
            }
          },
          "engagement_models": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "model": { "type": "string" },
                "commitment": { "type": "string" },
                "description": { "type": "string" }
              }
            }
          },
          "preferred_outreach": { "type": "string" }
        }
      },
      "InquirySubmission": {
        "type": "object",
        "required": [
          "sender_name",
          "company",
          "role_or_project",
          "opportunity_type",
          "message",
          "contact_email"
        ],
        "properties": {
          "sender_name": {
            "type": "string",
            "description": "Full name of the sender, recruiter, or partner."
          },
          "company": {
            "type": "string",
            "description": "Company, venture firm, university, or client organization."
          },
          "role_or_project": {
            "type": "string",
            "description": "Title of role, project scope, or advisory engagement."
          },
          "opportunity_type": {
            "type": "string",
            "enum": [
              "consulting_inquiry",
              "executive_recruitment",
              "technical_advisory"
            ],
            "description": "Category of the engagement opportunity."
          },
          "budget_or_compensation": {
            "type": "string",
            "description": "Budget, retainer rate, compensation bracket, or equity range."
          },
          "message": {
            "type": "string",
            "description": "Detailed briefing describing requirements, team context, and objectives."
          },
          "contact_email": {
            "type": "string",
            "format": "email",
            "description": "Direct return email address for correspondence."
          }
        }
      },
      "InquiryResponse": {
        "type": "object",
        "required": ["status", "message", "mailto_fallback"],
        "properties": {
          "status": {
            "type": "string",
            "example": "received"
          },
          "message": {
            "type": "string",
            "example": "Inquiry successfully recorded."
          },
          "inquiry_id": {
            "type": "string",
            "example": "inq_78f192b6a"
          },
          "mailto_fallback": {
            "type": "string",
            "description": "Pre-formatted mailto URL using pattern mailto:sergiu@iliev.us?subject=[AI%20Outreach]%20... for direct human email client invocation.",
            "example": "mailto:sergiu@iliev.us?subject=[AI%20Outreach]%20Opportunity%20from%20AcmeCorp&body=..."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": ["error", "details"],
        "properties": {
          "error": { "type": "string" },
          "details": { "type": "string" }
        }
      }
    }
  }
}