mkdocs.yml

site_name: DAIV
site_url: https://srtab.github.io/daiv/
repo_url: https://github.com/srtab/daiv
site_description: Documentation for DAIV
site_author: Sandro Rodrigues
strict: true
edit_uri: edit/main/docs/

theme:
  name: material
  logo: assets/logo.svg

  font:
    text: Inter
    code: JetBrains Mono

  features:
    - search.highlight
    - navigation.instant
    - navigation.instant.prefetch
    - navigation.instant.preview
    - navigation.instant.progress
    - navigation.tracking
    - navigation.path
    - content.code.annotate
    - content.code.copy
    - content.action.edit

  palette:
    # Palette toggle for automatic mode
    - media: "(prefers-color-scheme)"
      toggle:
        icon: material/brightness-auto
        name: Switch to light mode

    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode

    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/brightness-4
        name: Switch to system preference

plugins:
  - search
  - git-revision-date-localized:
      enable_creation_date: true
      fallback_to_build_date: true
  - llmstxt:
      full_output: llms-full.txt
      markdown_description: >
        DAIV is an open-source async software engineering agent that integrates
        natively with GitLab and GitHub through webhooks. Create an issue, get a
        merge request. Mention DAIV in a review, get the fix. Licensed under
        Apache 2.0.
      sections:
        Getting Started:
        - getting-started/deployment.md: How to deploy DAIV with Docker
        - getting-started/platform-setup.md: Setting up GitLab or GitHub integration
        - getting-started/llm-providers.md: Configuring LLM providers
        Features:
        - features/issue-addressing.md: Automated issue-to-merge-request workflow
        - features/pull-request-assistant.md: AI-powered pull request reviews and fixes
        - features/jobs-api.md: REST API for programmatic agent triggering
        - features/scheduled-jobs.md: Recurring agent runs on a cron schedule
        - features/mcp-endpoint.md: MCP server endpoint for AI coding assistants
        - features/activity-tracking.md: Unified log of all agent executions
        - features/merge-metrics.md: Code merge analytics and DAIV contribution tracking
        - features/slash-commands.md: Slash commands and custom skills
        - features/subagents.md: Specialized subagents for exploration and execution
        - features/sandbox.md: Secure sandboxed code execution
        Integrations:
        - integrations/rt/index.md: Request Tracker triage on ticket create via RT Scrip
        Customization:
        - customization/repository-config.md: Per-repository configuration
        - customization/agent-skills.md: Creating custom agent skills
        - customization/mcp-tools.md: MCP tool integrations
        Reference:
        - reference/env-variables.md: Environment variables reference
        - reference/agent-architecture.md: Agent architecture overview
        - reference/monitoring.md: Monitoring and observability

markdown_extensions:
  - attr_list
  - admonition
  - tables
  - md_in_html
  - pymdownx.highlight:
      linenums: true
      anchor_linenums: true
      auto_title: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

extra_css:
  - assets/extra.css

extra:
  generator: false
  version:
    provider: mike

nav:
  - Home: index.md
  - Getting Started:
    - Deployment: getting-started/deployment.md
    - Platform Setup: getting-started/platform-setup.md
    - LLM Providers: getting-started/llm-providers.md
  - Features:
    - Issue Addressing: features/issue-addressing.md
    - Pull Request Assistant: features/pull-request-assistant.md
    - Jobs API: features/jobs-api.md
    - Scheduled Jobs: features/scheduled-jobs.md
    - MCP Endpoint: features/mcp-endpoint.md
    - Activity Tracking: features/activity-tracking.md
    - Merge Metrics: features/merge-metrics.md
    - Slash Commands & Skills: features/slash-commands.md
    - Subagents: features/subagents.md
    - Sandbox: features/sandbox.md
  - Integrations:
    - Request Tracker Triage: integrations/rt/index.md
  - Customization:
    - Repository Config: customization/repository-config.md
    - Agent Skills: customization/agent-skills.md
    - MCP Tools: customization/mcp-tools.md
  - Reference:
    - Environment Variables: reference/env-variables.md
    - Agent Architecture: reference/agent-architecture.md
    - Monitoring: reference/monitoring.md
  - Community: community.md