# Retrieval-Augmented Generation (RAG) configuration.
#
# SIC treats the knowledge base as an external service. The RAG service is
# expected to expose:
#   POST {endpoint}/search
#     body: { query, limit, min_relevance, include_tags, exclude_tags }
#     returns: { items: [{ id, title, source, tags, relevance, excerpt, content? }] }
#   GET  {endpoint}/docs/:id
#     returns: { id, title, source, tags, owner?, updated?, headings, content }
#
# For local dev (or when no endpoint is configured) the docs repository
# falls back to reading Markdown files from `knowledge/` and applying the
# token-overlap scoring in apps/api/src/docs/repository.ts.
#
# Fields:
#   endpoint           external RAG service base URL (no trailing slash).
#                      Leave empty to use the local fallback.
#   auth_token         optional bearer token sent in the Authorization header.
#   timeout_ms         HTTP request timeout. Default: 10000.
#   fallback_to_local when true (default), use the local knowledge/ directory
#                      if the external endpoint fails. Set to false to fail
#                      closed.
#   chunk_strategy     how to split a Markdown doc into chunks (local mode only)
#     - "heading"  : split on H1/H2/H3, each chunk is a section
#     - "paragraph": split on blank lines, each chunk is a paragraph block
#     - "fixed"    : split on a fixed character length (chunk_size_chars)
#   chunk_size_chars   only used by "fixed" strategy (local mode only)
#   top_k              max chunks returned per query
#   min_relevance      chunks with relevance below this are dropped
#   include_tags       optional global include filter
#   exclude_tags       optional global exclude filter
rag:
  endpoint: ${RAG_ENDPOINT_URL:}
  auth_token: ${RAG_AUTH_TOKEN:}
  timeout_ms: 10000
  fallback_to_local: true
  chunk_strategy: heading
  chunk_size_chars: 1500
  top_k: 5
  min_relevance: 0.0
  include_tags: []
  exclude_tags: []