.coderabbit.yaml

# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
#
# CodeRabbit configuration. Only the settings that differ from CodeRabbit's defaults
# are listed here; everything else stays at the default.
#
# inheritance: without this, a repository .coderabbit.yaml is the sole config source and
# REPLACES any organization/UI settings (the docstring ERROR gate itself lives in the UI,
# since the YAML default is `warning`). Enabling inheritance keeps every UI/org setting —
# path filters, request_changes_workflow, custom checks — and only overrides the one value
# defined below, so this change stays scoped to docstrings.
inheritance: true
reviews:
  # When CodeRabbit is rate-limited (or otherwise errors), do not fail the outward
  # review/commit status (monorepo#2344, devantler-tech/actions#730). A failing `CodeRabbit`
  # status forces mergeStateStatus=UNSTABLE even when every required check is green. The
  # schema default is already false; pin it so an inherited UI/org override cannot re-enable
  # failing statuses.
  fail_commit_status: false
  pre_merge_checks:
    # Docstring Coverage measures a single coverage percentage across a PR's changed files
    # and cannot be scoped per-path (the only path mechanism, reviews.path_filters, would
    # drop the files from the whole review rather than from just this metric).
    #
    # This repository is mostly declarative org configuration (deploy/**.yaml), workflows,
    # composite actions, docs and shell tests; its little Go is test fixtures and one small
    # validator. So the metric mostly has nothing to measure and can report 0.00% against an
    # 80% threshold, blocking merges on a documentation gap that does not exist (e.g. #103,
    # whose only failed pre-merge check was Docstring Coverage 0.00% on a changeset of YAML
    # manifests, a bash test and Markdown).
    #
    # Keep the check as an advisory WARNING — CodeRabbit still reports coverage — instead of
    # a hard merge ERROR. Mirrors devantler-tech/ksail#6145, which made the same change for
    # the same un-scopeable-metric reason.
    docstrings:
      mode: warning