doomer

openapi: 3.1.0
info:
  title: Marxist Theory API
  version: 1.0.0
  description: |
    A dialectical interface for understanding class struggle, capital, and historical materialism.
    All endpoints are subject to contradiction and eventual supersession.

servers:
  - url: https://historical-materialism.org/api
    description: Primary mode of production

tags:
  - name: Class
    description: Endpoints related to social classes and their relations.
  - name: Capital
    description: Endpoints for accumulation, circulation, and exploitation.
  - name: Ideology
    description: Endpoints for superstructure, culture, and false consciousness.
  - name: Revolution
    description: Endpoints for praxis, struggle, and systemic transformation.

paths:
  /class:
    get:
      tags: [Class]
      summary: List all classes in a given mode of production
      description: |
        Returns the dominant and subordinate classes for the current historical stage.
      parameters:
        - name: modeOfProduction
          in: query
          required: true
          schema:
            type: string
            enum: [feudalism, capitalism, socialism, communism]
          description: The dominant mode of production shaping class relations.
      responses:
        '200':
          description: A list of classes and their relations.
          content:
            application/json:
              schema:
                type: object
                properties:
                  classes:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          example: "bourgeoisie"
                        role:
                          type: string
                          example: "owners of the means of production"
                        antagonisticTo:
                          type: array
                          items:
                            type: string
                          example: ["proletariat"]
                  contradictions:
                    type: array
                    items:
                      type: string
                    example:
                      - "Private ownership vs. social production"
                      - "Use value vs. exchange value"

  /capital/accumulation:
    post:
      tags: [Capital]
      summary: Accumulate capital through exploitation of labor
      description: |
        Simulates the process of capital accumulation by extracting surplus value from wage labor.
        Warning: This endpoint inherently generates class antagonism.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                variableCapital:
                  type: number
                  description: Wages paid to workers.
                  example: 1000
                constantCapital:
                  type: number
                  description: Machinery, raw materials, infrastructure.
                  example: 5000
                workingDayHours:
                  type: number
                  example: 12
      responses:
        '201':
          description: Capital accumulation result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  surplusValue:
                    type: number
                    description: Unpaid labor appropriated by capital.
                  rateOfExploitation:
                    type: number
                    description: Ratio of surplus labor to necessary labor.
                  classTension:
                    type: string
                    description: Qualitative measure of rising antagonism.
                    example: "escalating"

  /ideology:
    get:
      tags: [Ideology]
      summary: Retrieve dominant ideology
      description: |
        Returns the dominant ideology that naturalizes existing class relations and obscures exploitation.
      parameters:
        - name: rulingClass
          in: query
          required: true
          schema:
            type: string
            example: "bourgeoisie"
      responses:
        '200':
          description: Dominant ideology payload.
          content:
            application/json:
              schema:
                type: object
                properties:
                  narratives:
                    type: array
                    items:
                      type: string
                    example:
                      - "The market is neutral and self-regulating."
                      - "Success is purely individual merit."
                  functions:
                    type: array
                    items:
                      type: string
                    example:
                      - "Legitimize existing property relations"
                      - "Fragment class consciousness"
                  falseConsciousnessLevel:
                    type: string
                    enum: [low, moderate, high]
                    example: "high"

  /praxis:
    post:
      tags: [Revolution]
      summary: Initiate praxis
      description: |
        Combines theory and practice to transform material conditions.
        This endpoint is idempotent only in theory; in practice, it changes the system.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                classConsciousness:
                  type: string
                  enum: [low, emerging, organized, revolutionary]
                  example: "organized"
                organizationForm:
                  type: string
                  enum: [union, party, council, commune]
                  example: "party"
                demands:
                  type: array
                  items:
                    type: string
                  example:
                    - "Seize the means of production"
                    - "Abolish wage labor"
      responses:
        '202':
          description: Praxis initiated.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: "in-progress"
                  repressionLevel:
                    type: string
                    enum: [none, legal, police, military]
                    example: "police"
                  solidarityRequired:
                    type: string
                    example: "high"
                  nextSteps:
                    type: array
                    items:
                      type: string
                    example:
                      - "Deepen class consciousness"
                      - "Build international solidarity"
                      - "Resist co-optation"

  /history/materialism:
    get:
      tags: [Class]
      summary: Get historical stage
      description: |
        Returns the current historical stage and its internal contradictions,
        based on the material conditions and productive forces.
      parameters:
        - name: productiveForcesLevel
          in: query
          required: true
          schema:
            type: string
            enum: [low, developing, advanced]
            example: "advanced"
      responses:
        '200':
          description: Historical stage and contradictions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  stage:
                    type: string
                    enum: [primitive_communism, slavery, feudalism, capitalism, socialism, communism]
                    example: "capitalism"
                  keyContradictions:
                    type: array
                    items:
                      type: string
                    example:
                      - "Socialized production vs. private appropriation"
                      - "Global integration vs. national fragmentation"
                  revolutionaryPotential:
                    type: string
                    enum: [low, medium, high]
                    example: "medium"

components:
  schemas:
    ModeOfProduction:
      type: string
      enum: [primitive_communism, slavery, feudalism, capitalism, socialism, communism]

    Class:
      type: object
      properties:
        name:
          type: string
        ownsMeansOfProduction:
          type: boolean
        sellsLaborPower:
          type: boolean
        positionInProduction:
          type: string

  securitySchemes:
    ClassPower:
      type: http
      scheme: bearer
      description: |
        Bearer token representing control over the means of production.
        Only the ruling class is authorized by default. Revolution modifies permissions.

security:
  - ClassPower: []