agent-works 0.10.0

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

env:
  CARGO_TERM_COLOR: always

jobs:
  # ── Code quality checks ──
  check:
    name: check (stable)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt, clippy

      - uses: Swatinem/rust-cache@v2

      - name: Format check
        run: cargo fmt --all --check

      - name: Clippy
        run: cargo clippy --all-targets --features full -- -D warnings

  # ── Build & test ──
  #
  # All tools are behind opt-in feature flags (default = []), so `--features full`
  # is required to build and exercise the full crate.
  test:
    name: test (stable)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: dtolnay/rust-toolchain@stable

      - uses: Swatinem/rust-cache@v2

      - name: Build
        run: cargo build --features full --verbose

      - name: Test
        run: cargo test --features full --verbose

  # ── Documentation check ──
  doc:
    name: doc
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: dtolnay/rust-toolchain@stable

      - name: Check documentation
        run: cargo doc --features full --no-deps --document-private-items
        env:
          RUSTDOCFLAGS: -D warnings

  # ── Coverage gate ──
  #
  # Fails the build if line coverage drops below the threshold.
  #
  # Measured 2026-08-14 after the coverage backfill: 88.80% line coverage
  # (cargo llvm-cov --features full). MCP (~1590 lines) is exercised through an
  # in-process wiremock HTTP transport. Threshold is set at 85 to ratchet the
  # floor while leaving headroom to absorb CI machine variance.
  coverage:
    name: coverage
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: dtolnay/rust-toolchain@stable
        with:
          components: llvm-tools-preview

      - uses: Swatinem/rust-cache@v2

      - name: Install cargo-llvm-cov
        uses: taiki-e/install-action@cargo-llvm-cov

      - name: Coverage gate
        run: cargo llvm-cov --features full --fail-under-lines 85 --lcov --output-path lcov.info

      - name: Upload coverage
        uses: codecov/codecov-action@v5
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
          files: lcov.info