Skip to content

[BUG] OpenAI specs expected in repositories with no functionality that requires a REST API #475

@meyrevived

Description

@meyrevived

Bug Description

When scanning Konflux-ci/multi-platform-controller AgentReady score for the repo was falsly low over lack of any OpenAI/Swagger specs. However, multi-platform-controller is a Kubernetes controller that reconciles CRDs (TaskRuns). It does not expose REST API endpoints.
The API surface is defined by Kubernetes CRDs, not OpenAPI specs. The OTP server has a minimal HTTP interface but documenting it via OpenAPI would be over-engineering.

To Reproduce

  1. Clone Konflux-ci/multi-platform-controller
  2. Run AgentReady scan using the uvx command
  3. Review the results

Expected Behavior

No findings in the report revolve aroun OpenAPI/Swagger, or the section exists in the report with an indication that this is irrelevant for the repo - final score reflects that.

Actual Behavior

Scan report contains OpenAPI/Swagger Specifications section with 0/100 score due to "No OpenAPI specification found"

assessment-20260526-105424.json

Environment

  • OS: Fedora CSB 42 (64 bit)
  • Version: v2.40.0
  • Python Version: 3.14.4

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions