openapi: 3.1.0
info:
  title: Gabriel Lopez Romero Portfolio API
  version: 1.0.0
  description: Public machine-readable API and agent discovery interface for Gabriel
    Lopez Romero (Backend & Systems Engineer). Provides structured developer profile,
    technical projects, academic research publications, and skill sets.
  contact:
    name: Gabriel Lopez Romero
    email: gabriellopezromero@gmail.com
    url: https://lopezromerogabriel.vercel.app/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://lopezromerogabriel.vercel.app
  description: Production deployment on Vercel
paths:
  /:
    get:
      summary: Portfolio Homepage
      description: 'Returns the portfolio homepage. Supports HTTP content negotiation:
        requests with Accept: text/markdown receive a full markdown representation
        (acceptmarkdown.com compliant); requests with Accept: text/html receive standard
        HTML.'
      operationId: getHomepage
      responses:
        '200':
          description: Successful homepage response
          headers:
            Vary:
              schema:
                type: string
              description: Accept, Accept-Encoding
          content:
            text/html:
              schema:
                type: string
            text/markdown:
              schema:
                type: string
  /api/profile:
    get:
      summary: Developer Profile
      description: Returns Gabriel Lopez Romero full developer profile, biography,
        contact information, education, and career summary.
      operationId: getProfile
      parameters:
      - name: lang
        in: query
        description: 'Language code for localization (en or es). Default: en'
        required: false
        schema:
          type: string
          enum:
          - en
          - es
          default: en
      responses:
        '200':
          description: Successful profile payload
          content:
            application/json:
              schema:
                ? ''
                : '#/components/schemas/Profile'
        '400':
          description: Bad request or invalid parameters
          content:
            application/json:
              schema:
                ? ''
                : '#/components/schemas/ErrorResponse'
  /api/projects:
    get:
      summary: Software Projects
      description: Returns the list of featured engineering projects with repository
        URLs, descriptions, and technical stacks.
      operationId: getProjects
      responses:
        '200':
          description: List of featured projects
          content:
            application/json:
              schema:
                type: object
                properties:
                  projects:
                    type: array
                    items:
                      ? ''
                      : '#/components/schemas/Project'
  /api/research:
    get:
      summary: Research Publications & Papers
      description: Returns academic publications, technical reports, and scientific
        conference abstracts.
      operationId: getResearch
      responses:
        '200':
          description: List of research publications and abstracts
          content:
            application/json:
              schema:
                type: object
                properties:
                  research:
                    type: array
                    items:
                      ? ''
                      : '#/components/schemas/ResearchItem'
  /api/skills:
    get:
      summary: Categorized Technical Skills
      description: Returns the complete taxonomy of technical skills categorized into
        Backend & Systems, Cloud & DevOps, Databases & Storage, and Observability
        & Tooling.
      operationId: getSkills
      responses:
        '200':
          description: Categorized technical skill sets
          content:
            application/json:
              schema:
                type: object
                properties:
                  categories:
                    type: array
                    items:
                      ? ''
                      : '#/components/schemas/SkillCategory'
  /llms.txt:
    get:
      summary: LLM Discovery Index
      description: Curated LLM context following the /llms.txt specification.
      operationId: getLlmsTxt
      responses:
        '200':
          description: llms.txt markdown index
          content:
            text/plain:
              schema:
                type: string
            text/markdown:
              schema:
                type: string
  /llms-full.txt:
    get:
      summary: Comprehensive Full LLM Context
      description: Complete markdown document containing all profile data, project
        deep dives, research papers, and technical skills for LLMs.
      operationId: getLlmsFullTxt
      responses:
        '200':
          description: Full markdown curriculum
          content:
            text/plain:
              schema:
                type: string
            text/markdown:
              schema:
                type: string
components:
  schemas:
    Profile:
      type: object
      properties:
        name:
          type: string
          example: Gabriel Lopez Romero
        title:
          type: string
          example: Backend Engineer | Systems, Cloud & Performance
        email:
          type: string
          example: gabriellopezromero@gmail.com
        website:
          type: string
          example: https://lopezromerogabriel.vercel.app/
        bio:
          type: string
        links:
          type: object
          properties:
            github:
              type: string
            linkedin:
              type: string
            orcid:
              type: string
            scholar:
              type: string
        education:
          type: array
          items:
            type: object
            properties:
              degree:
                type: string
              institution:
                type: string
              period:
                type: string
      required:
      - name
      - title
      - email
      - bio
    Project:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        status:
          type: string
        description:
          type: string
        tags:
          type: array
          items:
            type: string
        repositoryUrl:
          type: string
        demoUrl:
          type: string
          nullable: true
      required:
      - id
      - name
      - description
      - tags
      - repositoryUrl
    ResearchItem:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        status:
          type: string
        venue:
          type: string
        abstract:
          type: string
        tags:
          type: array
          items:
            type: string
        proceedingsUrl:
          type: string
          nullable: true
        scholarUrl:
          type: string
          nullable: true
      required:
      - id
      - title
      - status
      - abstract
      - tags
    SkillCategory:
      type: object
      properties:
        name:
          type: string
        skills:
          type: array
          items:
            type: string
      required:
      - name
      - skills
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: NOT_FOUND
            message:
              type: string
              example: The requested resource was not found.
            status:
              type: integer
              example: 404
            resolution:
              type: string
              example: Consult /openapi.json for available endpoints or /llms.txt
                for site map.
          required:
          - code
          - message
          - status
          - resolution
      required:
      - error