naftiko: 1.0.0-alpha2
info:
  label: SVN Version Control
  description: Unified version control workflow capability for Apache Subversion. Combines repository browsing, file operations,
    commit lifecycle management, and historical revision access into a single workflow-oriented interface for developers and
    automation tools.
  tags:
  - Apache
  - Repository
  - Source Control
  - Subversion
  - Version Control
  - Webdav
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    SVN_USERNAME: SVN_USERNAME
    SVN_PASSWORD: SVN_PASSWORD
capability:
  consumes:
  - type: http
    namespace: svn-webdav
    baseUri: https://svn.example.com/repos/{repository}
    description: Apache Subversion WebDAV/DeltaV HTTP repository interface
    authentication:
      type: basic
      username: '{{SVN_USERNAME}}'
      password: '{{SVN_PASSWORD}}'
    resources:
    - name: repository
      path: /
      description: Repository root and metadata
      operations:
      - name: get-repository-root
        method: GET
        description: Retrieve the repository root listing
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: files
      path: /{path}
      description: File and directory content
      operations:
      - name: get-file-or-directory
        method: GET
        description: Retrieve file content or directory listing
        inputParameters:
        - name: path
          in: path
          type: string
          required: true
          description: Path within the repository
        - name: p
          in: query
          type: integer
          required: false
          description: Peg revision number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: put-file
        method: PUT
        description: Upload file content as part of an active commit transaction
        inputParameters:
        - name: path
          in: path
          type: string
          required: true
          description: Path to write
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: octet-stream
          data:
            content: '{{tools.content}}'
      - name: delete-file-or-directory
        method: DELETE
        description: Delete a file or directory within an active commit transaction
        inputParameters:
        - name: path
          in: path
          type: string
          required: true
          description: Path to delete
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: transactions
      path: /$svn/act/
      description: Commit transaction management
      operations:
      - name: create-commit-transaction
        method: POST
        description: Create a new commit transaction (MKACTIVITY)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: versioned-resources
      path: /!svn/rvr/{revision}/{path}
      description: Historical versioned resource access
      operations:
      - name: get-revision-versioned-resource
        method: GET
        description: Get file content at a specific historical revision
        inputParameters:
        - name: revision
          in: path
          type: integer
          required: true
          description: Revision number
        - name: path
          in: path
          type: string
          required: true
          description: Repository path
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: svn-version-control-api
    description: Unified REST API for Apache Subversion version control operations.
    resources:
    - path: /v1/repository
      name: repository
      description: Repository root information and metadata
      operations:
      - method: GET
        name: get-repository-root
        description: Get repository root listing and metadata
        call: svn-webdav.get-repository-root
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/files/{path}
      name: files
      description: File and directory access
      operations:
      - method: GET
        name: get-file
        description: Get file content or directory listing at HEAD
        call: svn-webdav.get-file-or-directory
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: upload-file
        description: Upload file content as part of an active commit
        call: svn-webdav.put-file
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-file
        description: Delete a file or directory in an active commit
        call: svn-webdav.delete-file-or-directory
        with:
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/commits
      name: commits
      description: Commit transaction lifecycle
      operations:
      - method: POST
        name: create-commit
        description: Create a new commit transaction
        call: svn-webdav.create-commit-transaction
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/history/{revision}/files/{path}
      name: history
      description: Historical file access by revision
      operations:
      - method: GET
        name: get-file-at-revision
        description: Retrieve file content at a specific historical revision
        call: svn-webdav.get-revision-versioned-resource
        with:
          revision: rest.revision
          path: rest.path
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: svn-version-control-mcp
    transport: http
    description: MCP server for AI-assisted Subversion version control operations.
    tools:
    - name: browse-repository
      description: Browse the SVN repository root and see available projects
      hints:
        readOnly: true
        idempotent: true
      call: svn-webdav.get-repository-root
      outputParameters:
      - type: object
        mapping: $.
    - name: get-file
      description: Retrieve the content of a file or directory listing from SVN
      hints:
        readOnly: true
        idempotent: true
      call: svn-webdav.get-file-or-directory
      with:
        path: tools.path
      outputParameters:
      - type: object
        mapping: $.
    - name: upload-file
      description: Upload a file to an active SVN commit transaction
      hints:
        readOnly: false
        idempotent: false
      call: svn-webdav.put-file
      with:
        path: tools.path
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-file
      description: Schedule a file or directory for deletion in an active SVN commit
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: svn-webdav.delete-file-or-directory
      with:
        path: tools.path
      outputParameters:
      - type: object
        mapping: $.
    - name: create-commit
      description: Start a new SVN commit transaction to stage file changes
      hints:
        readOnly: false
        idempotent: false
      call: svn-webdav.create-commit-transaction
      outputParameters:
      - type: object
        mapping: $.
    - name: get-file-at-revision
      description: Retrieve the historical content of a file at a specific SVN revision number
      hints:
        readOnly: true
        idempotent: true
      call: svn-webdav.get-revision-versioned-resource
      with:
        revision: tools.revision
        path: tools.path
      outputParameters:
      - type: object
        mapping: $.