mkdocs.yml

# Material MkDocs Configuration
site_name: Prodigy Documentation
site_description: AI-powered workflow orchestration for development teams
site_author: Glen Baker
site_url: https://entropicdrift.com

# Repository
repo_name: iepathos/prodigy
repo_url: https://github.com/iepathos/prodigy
edit_uri: edit/main/docs/

# Copyright
copyright: Copyright © 2024 Glen Baker

# Documentation source (MkDocs-specific, enhanced with Material features)
# mdbook uses book/src/ separately
docs_dir: docs
site_dir: site

# Theme Configuration
theme:
  name: material
  palette:
    - scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-4
        name: Switch to light mode

  features:
    - navigation.tabs
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.tracking
    - navigation.indexes
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.code.annotate

  icon:
    repo: fontawesome/brands/github

# Plugins
plugins:
  - search:
      lang: en

# Extensions
markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true

  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true

# Navigation - mirrors SUMMARY.md structure (shared with mdbook)
nav:
  - Home: index.md
  - Installation: installation.md

  - User Guide:
    - Workflow Basics:
      - workflow-basics/index.md
      - Workflow Structure: workflow-basics/workflow-structure.md
      - Full Workflow Structure: workflow-basics/full-workflow-structure.md
      - Available Fields: workflow-basics/available-fields.md
      - Command Types: workflow-basics/command-types.md
      - Command-Level Options:
        - workflow-basics/command-options/index.md
        - Core Options: workflow-basics/command-options/core-options.md
        - Output Capture: workflow-basics/command-options/output-capture.md
        - Error and Conditional: workflow-basics/command-options/error-conditional.md
        - Advanced Options: workflow-basics/command-options/advanced-options.md
      - Conditional Execution: workflow-basics/conditional-execution.md
      - Error Handling:
        - workflow-basics/error-handling/index.md
        - Command-Level: workflow-basics/error-handling/command-level.md
        - Workflow-Level: workflow-basics/error-handling/workflow-level.md
        - Dead Letter Queue: workflow-basics/error-handling/dlq.md
        - Best Practices: workflow-basics/error-handling/best-practices.md
      - Variables: workflow-basics/variables.md
      - Environment:
        - workflow-basics/environment/index.md
        - Environment Basics: workflow-basics/environment/basics.md
        - Secrets and Profiles: workflow-basics/environment/secrets-profiles.md
        - Workflow Usage: workflow-basics/environment/workflow-usage.md
        - Patterns and Troubleshooting: workflow-basics/environment/patterns.md
      - Environment Configuration: workflow-basics/environment-configuration.md
      - Merge Workflows: workflow-basics/merge-workflows.md
      - Complete Example: workflow-basics/complete-example.md
      - Next Steps: workflow-basics/next-steps.md
    - MapReduce Workflows:
      - mapreduce/index.md
      - Overview: mapreduce/overview.md
      - Work Distribution:
        - mapreduce/work-distribution/index.md
        - Input Sources: mapreduce/work-distribution/input-sources.md
        - Filtering and Sorting: mapreduce/work-distribution/filtering-sorting.md
        - Pagination: mapreduce/work-distribution/pagination.md
        - Examples: mapreduce/work-distribution/examples.md
      - Environment Variables in Configuration: mapreduce/environment-variables-in-configuration.md
      - Backoff Strategies: mapreduce/backoff-strategies.md
      - Error Collection Strategies: mapreduce/error-collection-strategies.md
      - Setup Phase (Advanced): mapreduce/setup-phase-advanced.md
      - Global Storage Architecture: mapreduce/global-storage-architecture.md
      - Event Tracking: mapreduce/event-tracking.md
      - Checkpoint and Resume: mapreduce/checkpoint-and-resume.md
      - Dead Letter Queue (DLQ):
        - mapreduce/dlq/index.md
        - DLQ Overview: mapreduce/dlq/overview.md
        - DLQ Commands: mapreduce/dlq/commands.md
        - Debugging with DLQ: mapreduce/dlq/debugging.md
        - Storage Internals: mapreduce/dlq/internals.md
      - Troubleshooting: mapreduce/troubleshooting.md
      - Workflow Format Comparison: mapreduce/workflow-format-comparison.md
    - Command Types: commands.md
    - Variables and Interpolation:
      - variables/index.md
      - Available Variables:
        - variables/available-variables/index.md
        - Standard Variables: variables/available-variables/standard-variables.md
        - MapReduce Variables: variables/available-variables/mapreduce-variables.md
        - Git and Merge Variables: variables/available-variables/git-merge-variables.md
        - Interpolation Reference: variables/available-variables/interpolation-reference.md
      - Custom Variable Capture: variables/custom-variable-capture.md
      - Troubleshooting Variable Interpolation: variables/troubleshooting-variable-interpolation.md
    - Environment Configuration:
      - environment/index.md
      - MapReduce Environment Variables: environment/mapreduce-environment-variables.md
      - Environment Files: environment/environment-files.md
      - Secrets Management: environment/secrets-management.md
      - Environment Profiles: environment/environment-profiles.md
      - Per-Command Environment Overrides: environment/per-command-environment-overrides.md
      - Environment Precedence: environment/environment-precedence.md
      - Common Patterns: environment/common-patterns.md
    - Configuration:
      - configuration/index.md
      - Configuration Precedence Rules: configuration/configuration-precedence-rules.md
      - Global Config: configuration/global-config.md
      - Global Configuration Structure: configuration/global-configuration-structure.md
      - Project Configuration Structure: configuration/project-configuration-structure.md
      - Workflow Configuration: configuration/workflow-configuration.md
      - Storage Configuration: configuration/storage-configuration.md
      - Environment Variables: configuration/environment-variables.md
      - Complete Configuration Examples: configuration/complete-configuration-examples.md
      - Default Values Reference: configuration/default-values-reference.md
      - Troubleshooting: configuration/troubleshooting.md

  - Advanced:
    - Advanced Features:
      - advanced/index.md
      - Step Identification: advanced/step-identification.md
      - Timeout Configuration: advanced/timeout-configuration.md
      - Implementation Validation: advanced/implementation-validation.md
      - Parallel Iteration with Foreach: advanced/parallel-iteration-with-foreach.md
      - Composition: advanced/composition.md
      - Git Integration: advanced/git-integration.md
      - Observability:
        - advanced/observability/index.md
        - Event Tracking: advanced/observability/event-tracking.md
        - Claude Observability: advanced/observability/claude-observability.md
        - Debugging and Metrics: advanced/observability/debugging.md
        - Log Management: advanced/observability/log-management.md
      - Sessions: advanced/sessions.md
      - Storage:
        - advanced/storage/index.md
        - Storage Structure: advanced/storage/structure.md
        - Session and DLQ Storage: advanced/storage/session-dlq.md
        - Worktree Storage: advanced/storage/worktree-storage.md
        - Maintenance: advanced/storage/maintenance.md
    - Git Context:
      - git-context/index.md
      - Overview: git-context/overview.md
      - Shell Filtering: git-context/shell-filtering.md
      - Use Cases: git-context/use-cases.md
      - Best Practices: git-context/best-practices.md
    - Stillwater Patterns:
      - stillwater-patterns/index.md
      - Error Accumulation: stillwater-patterns/error-accumulation.md
      - Testability: stillwater-patterns/testability.md
      - Error Context: stillwater-patterns/error-context.md
      - State Management: stillwater-patterns/state-management.md
      - Semigroup Composition: stillwater-patterns/semigroup-composition.md
    - Workflow Composition:
      - composition/index.md
      - Workflow Extension (Inheritance): composition/workflow-extension-inheritance.md
      - Template System: composition/template-system.md
      - Parameter Definitions: composition/parameter-definitions.md
      - Default Values: composition/default-values.md
      - Sub-Workflows: composition/sub-workflows.md
      - Composition Metadata: composition/composition-metadata.md
      - Complete Examples: composition/complete-examples.md
      - Troubleshooting: composition/troubleshooting.md
    - Retry Configuration:
      - retry-configuration/index.md
      - Basic Retry Configuration: retry-configuration/basic-retry-configuration.md
      - Backoff Strategies: retry-configuration/backoff-strategies.md
      - Backoff Strategy Comparison: retry-configuration/backoff-strategy-comparison.md
      - Jitter for Distributed Systems: retry-configuration/jitter-for-distributed-systems.md
      - Conditional Retry with Error Matchers: retry-configuration/conditional-retry-with-error-matchers.md
      - Retry Budget: retry-configuration/retry-budget.md
      - Failure Actions: retry-configuration/failure-actions.md
      - Complete Examples: retry-configuration/complete-examples.md
      - Workflow-Level vs Command-Level Retry: retry-configuration/workflow-level-vs-command-level-retry.md
      - Retry Metrics and Observability: retry-configuration/retry-metrics-and-observability.md
      - Troubleshooting: retry-configuration/troubleshooting.md
      - Implementation References: retry-configuration/implementation-references.md
    - MapReduce Worktree Architecture: mapreduce-worktree-architecture.md
    - Automated Documentation:
      - automated-documentation/index.md
      - Quick Start: automated-documentation/quick-start.md
      - Tutorial (30 Minutes): automated-documentation/tutorial.md
      - Understanding the Workflow: automated-documentation/understanding-the-workflow.md
      - MkDocs Workflow:
        - automated-documentation/mkdocs-workflow/index.md
        - Getting Started: automated-documentation/mkdocs-workflow/getting-started.md
        - Workflow Phases: automated-documentation/mkdocs-workflow/workflow-phases.md
        - Advanced Usage: automated-documentation/mkdocs-workflow/advanced-usage.md
      - Gap Detection:
        - automated-documentation/gap-detection/index.md
        - Overview: automated-documentation/gap-detection/overview.md
        - Validation Phases: automated-documentation/gap-detection/validation-phases.md
        - Topic Normalization: automated-documentation/gap-detection/topic-normalization.md
        - Gap Report: automated-documentation/gap-detection/gap-report.md
      - GitHub Actions Integration: automated-documentation/github-actions-integration.md
      - Troubleshooting: automated-documentation/troubleshooting.md
      - Advanced Configuration: automated-documentation/advanced-configuration.md
      - 'Real-World Example: Prodigy''s Own Documentation': automated-documentation/real-world-example-prodigys-own-documentation.md
      - Documentation Versioning: automated-documentation/documentation-versioning.md

  - Reference:
    - Examples:
      - examples/index.md
      - Basic Workflows: examples/basic-workflows.md
      - Conditional Workflows: examples/conditional-workflows.md
      - MapReduce Examples: examples/mapreduce-examples.md
      - Advanced Examples: examples/advanced-examples.md
      - Composition Examples: examples/composition-examples.md
    - Troubleshooting:
      - troubleshooting/index.md
      - Quick Reference: reference/troubleshooting.md
      - FAQ: troubleshooting/faq.md
      - Common Error Messages: troubleshooting/common-error-messages.md