Sonatype Nexus Repository Manager — Reconcile Plan

naftiko: 1.0.0-alpha2
info:
  label: Sonatype Nexus Repository Manager — Reconcile Plan
  description: 'Sonatype Nexus Repository Manager — Reconcile Plan. 8 operations. Lead operation: Delete all non executed
    reconciliation plans. Self-contained Naftiko capability covering one Sonatype Nexus business surface.'
  tags:
  - Sonatype Nexus
  - Reconcile Plan
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SONATYPE_NEXUS_API_KEY: SONATYPE_NEXUS_API_KEY
capability:
  consumes:
  - type: http
    namespace: repository-reconcile-plan
    baseUri: ''
    description: Sonatype Nexus Repository Manager — Reconcile Plan business capability. Self-contained, no shared references.
    resources:
    - name: v1-plan
      path: /v1/plan
      operations:
      - name: deleteallplans
        method: DELETE
        description: Delete all non executed reconciliation plans
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getavailableplans
        method: GET
        description: Get list of currently available plans
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: continuationToken
          in: query
          type: string
          description: A token returned by a prior request. If present, the next page of results are returned
      - name: createreconciliationplans
        method: POST
        description: Create reconciliation plans with selected parameters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: repositories
          in: query
          type: array
          description: repository(ies) which should be processed with high priority
        - name: blobStores
          in: query
          type: array
        - name: startDate
          in: query
          type: string
        - name: endDate
          in: query
          type: string
        - name: sinceDays
          in: query
          type: integer
        - name: sinceHours
          in: query
          type: integer
        - name: sinceMinutes
          in: query
          type: integer
      - name: executereconciletasks
        method: PUT
        description: Execute all non executed reconciliation plans
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-plan-details
      path: /v1/plan/details
      operations:
      - name: getplandetails
        method: GET
        description: Get reconciliation plan details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: planId
          in: query
          type: integer
          description: Id of the plan
        - name: state
          in: query
          type: string
        - name: repository
          in: query
          type: string
        - name: continuationToken
          in: query
          type: string
          description: A token returned by a prior request. If present, the next page of results are returned
    - name: v1-plan-planId
      path: /v1/plan/{planId}
      operations:
      - name: deleteplan
        method: DELETE
        description: Delete a reconciliation plan based on its Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: planId
          in: path
          type: integer
          description: Id of the plan to delete
          required: true
      - name: getsingleplanwithdetails
        method: GET
        description: Get single reconciliation plan with details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: planId
          in: path
          type: integer
          description: Id of the plan
          required: true
        - name: repository
          in: query
          type: string
        - name: continuationToken
          in: query
          type: string
          description: A token returned by a prior request. If present, the next page of results are returned
      - name: executereconciletaskbyid
        method: PUT
        description: Execute a reconciliation plan based on its Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: planId
          in: path
          type: integer
          description: Id of the plan to execute
          required: true
    authentication:
      type: basic
      username: '{{env.SONATYPE_NEXUS_USER}}'
      password: '{{env.SONATYPE_NEXUS_PASS}}'
  exposes:
  - type: rest
    namespace: repository-reconcile-plan-rest
    port: 8080
    description: REST adapter for Sonatype Nexus Repository Manager — Reconcile Plan. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/v1/plan
      name: v1-plan
      description: REST surface for v1-plan.
      operations:
      - method: DELETE
        name: deleteallplans
        description: Delete all non executed reconciliation plans
        call: repository-reconcile-plan.deleteallplans
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getavailableplans
        description: Get list of currently available plans
        call: repository-reconcile-plan.getavailableplans
        with:
          continuationToken: rest.continuationToken
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createreconciliationplans
        description: Create reconciliation plans with selected parameters
        call: repository-reconcile-plan.createreconciliationplans
        with:
          repositories: rest.repositories
          blobStores: rest.blobStores
          startDate: rest.startDate
          endDate: rest.endDate
          sinceDays: rest.sinceDays
          sinceHours: rest.sinceHours
          sinceMinutes: rest.sinceMinutes
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: executereconciletasks
        description: Execute all non executed reconciliation plans
        call: repository-reconcile-plan.executereconciletasks
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/plan/details
      name: v1-plan-details
      description: REST surface for v1-plan-details.
      operations:
      - method: GET
        name: getplandetails
        description: Get reconciliation plan details
        call: repository-reconcile-plan.getplandetails
        with:
          planId: rest.planId
          state: rest.state
          repository: rest.repository
          continuationToken: rest.continuationToken
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/plan/{planid}
      name: v1-plan-planid
      description: REST surface for v1-plan-planId.
      operations:
      - method: DELETE
        name: deleteplan
        description: Delete a reconciliation plan based on its Id
        call: repository-reconcile-plan.deleteplan
        with:
          planId: rest.planId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getsingleplanwithdetails
        description: Get single reconciliation plan with details
        call: repository-reconcile-plan.getsingleplanwithdetails
        with:
          planId: rest.planId
          repository: rest.repository
          continuationToken: rest.continuationToken
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: executereconciletaskbyid
        description: Execute a reconciliation plan based on its Id
        call: repository-reconcile-plan.executereconciletaskbyid
        with:
          planId: rest.planId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: repository-reconcile-plan-mcp
    port: 9090
    transport: http
    description: MCP adapter for Sonatype Nexus Repository Manager — Reconcile Plan. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: delete-all-non-executed-reconciliation
      description: Delete all non executed reconciliation plans
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: repository-reconcile-plan.deleteallplans
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-currently-available-plans
      description: Get list of currently available plans
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repository-reconcile-plan.getavailableplans
      with:
        continuationToken: tools.continuationToken
      outputParameters:
      - type: object
        mapping: $.
    - name: create-reconciliation-plans-selected-parameters
      description: Create reconciliation plans with selected parameters
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: repository-reconcile-plan.createreconciliationplans
      with:
        repositories: tools.repositories
        blobStores: tools.blobStores
        startDate: tools.startDate
        endDate: tools.endDate
        sinceDays: tools.sinceDays
        sinceHours: tools.sinceHours
        sinceMinutes: tools.sinceMinutes
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-all-non-executed-reconciliation
      description: Execute all non executed reconciliation plans
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: repository-reconcile-plan.executereconciletasks
      outputParameters:
      - type: object
        mapping: $.
    - name: get-reconciliation-plan-details
      description: Get reconciliation plan details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repository-reconcile-plan.getplandetails
      with:
        planId: tools.planId
        state: tools.state
        repository: tools.repository
        continuationToken: tools.continuationToken
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-reconciliation-plan-based-its
      description: Delete a reconciliation plan based on its Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: repository-reconcile-plan.deleteplan
      with:
        planId: tools.planId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-single-reconciliation-plan-details
      description: Get single reconciliation plan with details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repository-reconcile-plan.getsingleplanwithdetails
      with:
        planId: tools.planId
        repository: tools.repository
        continuationToken: tools.continuationToken
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-reconciliation-plan-based-its
      description: Execute a reconciliation plan based on its Id
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: repository-reconcile-plan.executereconciletaskbyid
      with:
        planId: tools.planId
      outputParameters:
      - type: object
        mapping: $.