codecov.yml

# Codecov configuration for the Observability-Benchmarking monorepo.
#
# Each language/module uploads coverage with a dedicated flag (set in the
# GitHub Actions workflow).  Flags map to source paths so Codecov can
# correctly attribute lines and produce per-component dashboards.
#
# Docs: https://docs.codecov.com/docs/codecov-yaml
# Validate: curl -X POST --data-binary @codecov.yml https://codecov.io/validate

# ── General ───────────────────────────────────────────────────────────
codecov:
  require_ci_to_pass: true
  notify:
    wait_for_ci: true

# ── Coverage status checks ────────────────────────────────────────────
# Informational only — the existing Coverage Gate job in java_coverage.yml
# handles enforcement.  Codecov status checks appear on PRs but never
# block merges.
coverage:
  status:
    project:
      default:
        informational: true
    patch:
      default:
        informational: true

# ── PR comment ────────────────────────────────────────────────────────
comment:
  layout: "condensed_header, condensed_files, condensed_footer"
  behavior: default
  require_changes: true
  require_base: false
  require_head: true

# ── Flag definitions ──────────────────────────────────────────────────
# Naming convention: java-{matrix.name} | nextjs-dash-{env} | go-{module} | python-{module}
#
# `carryforward: true` keeps previous coverage data for flags that were
# not uploaded in the current commit.  This is important in a monorepo
# where not every workflow runs on every push (e.g., path-filtered
# triggers or future per-module path filters).
#
# `paths` tells Codecov which source files belong to this flag so
# coverage is attributed correctly in the file viewer and PR diff.

flags:
  # ── Java services (uploaded by java_coverage.yml) ───────────────────
  java-spring-tomcat:
    paths: [services/java/spring/jvm/tomcat/]
    carryforward: true
  java-spring-netty:
    paths: [services/java/spring/jvm/netty/]
    carryforward: true
  java-quarkus-jvm:
    paths: [services/java/quarkus/jvm/]
    carryforward: true
  java-micronaut-jvm:
    paths: [services/java/micronaut/jvm/]
    carryforward: true
  java-helidon-se-jvm:
    paths: [services/java/helidon/se/jvm/]
    carryforward: true
  java-helidon-mp-jvm:
    paths: [services/java/helidon/mp/jvm/]
    carryforward: true
  java-spark-jvm:
    paths: [services/java/spark/jvm/]
    carryforward: true
  java-javalin-jvm:
    paths: [services/java/javalin/jvm/]
    carryforward: true
  java-dropwizard-jvm:
    paths: [services/java/dropwizard/jvm/]
    carryforward: true
  java-vertx-jvm:
    paths: [services/java/vertx/jvm/]
    carryforward: true
  java-pekko-jvm:
    paths: [services/java/pekko/jvm/]
    carryforward: true
  java-orchestrator:
    paths: [utils/orchestrator/]
    carryforward: true

  # ── Next.js dashboard (uploaded by nextjs_dash_coverage.yml) ─────────
  nextjs-dash-node:
    paths: [utils/nextjs-dash/lib/, utils/nextjs-dash/app/api/]
    carryforward: true
  nextjs-dash-dom:
    paths: [utils/nextjs-dash/app/components/, utils/nextjs-dash/app/hooks/, utils/nextjs-dash/app/theme.ts, utils/nextjs-dash/app/Providers.tsx]
    carryforward: true

  # ── Go services (future — uploaded by go_quality.yml) ───────────────
  # go-enhanced:
  #   paths: [services/go/enhanced/]
  #   carryforward: true
  # go-simple:
  #   paths: [services/go/simple/]
  #   carryforward: true

  # ── Python services (future — uploaded by django_python_quality.yml) ─
  # python-django-platform:
  #   paths: [services/python/django/]
  #   carryforward: true
  # python-django-reactive:
  #   paths: [services/python/django/]
  #   carryforward: true

# ── Component definitions ─────────────────────────────────────────────
# Components aggregate flags into language-level groups.  The Codecov
# dashboard shows per-component coverage trends and PR diffs.

component_management:
  default_rules:
    statuses:
      - type: project
        target: auto
        informational: true
  individual_components:
    - component_id: java_services
      name: Java Services
      paths:
        - services/java/**
        - utils/orchestrator/**
    - component_id: nextjs_dashboard
      name: Next.js Dashboard
      paths:
        - utils/nextjs-dash/**
    - component_id: go_services
      name: Go Services
      paths:
        - services/go/**
    - component_id: python_services
      name: Python Services
      paths:
        - services/python/**

# ── Ignored paths ─────────────────────────────────────────────────────
# Files listed here are excluded from Codecov's coverage denominator.
# Only exclude files that cannot be meaningfully unit-tested or that
# contain no runtime logic (pure types, static data, framework wiring).
#
# Categories:
#   1. Native-image modules — duplicate JVM source, no tests/JaCoCo
#   2. Application entry points — bootstrap wiring only
#   3. Pure interfaces / trivial enums — no executable logic
#   4. CDI/Spring startup listeners — framework event observers
#   5. Metrics wiring — CDI producers / static binder registration
#   6. Pure DTO records — auto-generated accessors, no methods
#   7. JAX-RS application / annotation classes — framework boilerplate
#   8. Next.js Server Components — require Next.js runtime, untestable
#      with Vitest + jsdom
#   9. Next.js inline <Script> components — inject raw JS strings,
#      untestable without a real browser
#  10. Pure type / constant files — no logic to exercise
#  11. Non-source directories
ignore:
  # ── 1. Native-image modules ──────────────────────────────────────────
  - "services/java/spring/native/**"
  - "services/java/quarkus/native/**"
  - "services/java/micronaut/native/**"
  - "services/java/helidon/se/native/**"
  - "services/java/helidon/mp/native/**"

  # ── 2. Application entry-point / bootstrap classes ───────────────────
  - "services/java/spring/jvm/tomcat/src/main/java/**/TomcatApplication.java"
  - "services/java/spring/jvm/netty/src/main/java/**/NettyApplication.java"
  - "services/java/micronaut/jvm/src/main/java/**/MicronautApplication.java"
  - "services/java/helidon/se/jvm/src/main/java/**/HelidonApplication.java"
  - "services/java/spark/jvm/src/main/java/**/SparkApplication.java"
  - "services/java/javalin/jvm/src/main/java/**/JavalinApplication.java"
  - "services/java/dropwizard/jvm/src/main/java/**/DropwizardApplication.java"
  - "services/java/vertx/jvm/src/main/java/**/VertxApplication.java"
  - "services/java/pekko/jvm/src/main/java/**/PekkoApplication.java"

  # ── 3. Pure interfaces and trivial enums (no executable logic) ───────
  # Port interfaces define contracts only — implementations are tested.
  - "services/java/**/port/CachePort.java"
  - "services/java/**/port/SleepPort.java"
  - "services/java/**/port/MetricsPort.java"
  - "services/java/**/port/TimeUnit.java"
  # Orchestrator port interfaces
  - "utils/orchestrator/**/job/CommandRunner.java"
  - "utils/orchestrator/**/job/JobAdmissionPolicy.java"
  - "utils/orchestrator/**/job/JobEventPublisher.java"
  - "utils/orchestrator/**/job/JobStore.java"
  - "utils/orchestrator/**/job/HeartbeatScheduler.java"
  # Simple enum — five constants, no methods
  - "utils/orchestrator/**/domain/JobStatus.java"

  # ── 4. CDI / startup listeners (framework observers, logging only) ──
  - "services/java/quarkus/jvm/**/bootstrap/StartupDiagnosticsLogger.java"
  - "services/java/quarkus/jvm/**/bootstrap/MetricsWarmupStartupObserver.java"
  - "services/java/helidon/mp/jvm/**/infra/JulBridgeStartupListener.java"

  # ── 5. Metrics wiring (CDI producers / static binder registration) ──
  # These produce MeterBinder beans or call bindTo() — pure plumbing.
  - "services/java/quarkus/jvm/**/metrics/JvmExtrasMetricsConfiguration.java"
  - "services/java/spark/jvm/**/infra/MetricsProvider.java"
  - "services/java/vertx/jvm/**/infra/MetricsProvider.java"
  - "services/java/javalin/jvm/**/infra/MetricsProvider.java"
  - "services/java/pekko/jvm/**/infra/MetricsProvider.java"

  # ── 6. Pure DTO records (auto-generated accessors, no methods) ───────
  - "utils/orchestrator/**/api/RunRequest.java"
  - "utils/orchestrator/**/api/RunResponse.java"
  - "utils/orchestrator/**/api/ErrorResponse.java"
  - "utils/orchestrator/**/api/CommandPreset.java"
  - "utils/orchestrator/**/api/JobStatusResponse.java"
  - "utils/orchestrator/**/api/ServiceHealthResponse.java"
  - "utils/orchestrator/**/api/HealthAggregateResponse.java"

  # ── 7. JAX-RS application / annotation classes ───────────────────────
  - "services/java/helidon/mp/jvm/**/web/HelloApplication.java"
  - "utils/orchestrator/**/security/RequireOrchestratorAuth.java"

  # ── 8. Next.js untestable files (Server Components / build config) ───
  # These require the Next.js server runtime, React streaming SSR, or are
  # build-time configuration with no runtime logic.
  # A future Playwright e2e phase would cover the Server Components.
  # NOTE: Providers.tsx and theme.ts are 'use client' with testable logic
  # — they are NOT excluded; they have dedicated Vitest tests.
  - "utils/nextjs-dash/app/page.tsx"
  - "utils/nextjs-dash/app/layout.tsx"
  - "utils/nextjs-dash/next.config.ts"

  # ── 9. Inline <Script> components (need real browser, not jsdom) ─────
  - "utils/nextjs-dash/app/components/PreHydrationScript.tsx"
  - "utils/nextjs-dash/app/components/RuntimeConfigScript.tsx"
  # Side-effect-only component (returns null); excluded from Vitest DOM coverage.
  - "utils/nextjs-dash/app/components/BootLogger.tsx"

  # ── 10. Pure type definitions / static defaults (no logic) ───────────
  - "utils/nextjs-dash/lib/runtimeConfigTypes.ts"
  - "utils/nextjs-dash/lib/loggingTypes.ts"

  # ── 11. Non-source directories ───────────────────────────────────────
  - "docs/**"
  - "config/**"
  - "compose/**"
  - "data/**"
  - "scripts/**"
  - "integration-tests/**"
  - "results/**"

  # ── 12. Test directories ────────────────────────────────────────────
  - "utils/nextjs-dash/__tests__/**"