mkdocs.yml

site_name: Integr8sCode
site_description: Run Python scripts online in isolated Kubernetes pods
site_url: https://hardmax71.github.io/Integr8sCode/
repo_url: https://github.com/HardMax71/Integr8sCode
repo_name: HardMax71/Integr8sCode
edit_uri: edit/main/docs/

validation:
  links:
    absolute_links: relative_to_docs

theme:
  name: material
  logo: assets/images/logo.png
  favicon: assets/images/logo.png
  palette:
    # Light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    # Dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  features:
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.footer
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.action.edit
    - toc.follow
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - swagger-ui-tag
  - mermaid2:
      arguments:
        securityLevel: loose
        fontFamily: "'Inter', 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif"
        flowchart:
          curve: basis
          padding: 16
          nodeSpacing: 30
          rankSpacing: 50
        sequence:
          mirrorActors: false
          messageMargin: 40
          actorFontFamily: "'Inter', 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif"
          messageFontFamily: "'Inter', 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif"

markdown_extensions:
  # Python Markdown
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
      toc_depth: 3

  # PyMdown Extensions
  - pymdownx.arithmatex:
      generic: 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
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      check_paths: true
      base_path:
        - .
        - docs
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:mermaid2.fence_mermaid_custom
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

extra:
  generator: false

extra_css:
  - stylesheets/extra.css

nav:
  - Home: index.md
  - Getting Started: getting-started.md

  - Architecture:
    - Overview: architecture/overview.md
    - Services: architecture/services-overview.md
    - Authentication: architecture/authentication.md
    - Rate Limiting: architecture/rate-limiting.md
    - Idempotency: architecture/idempotency.md
    - Execution Queue: architecture/execution-queue.md
    - Runtime Registry: architecture/runtime-registry.md
    - Middleware: architecture/middleware.md
    - Domain Exceptions: architecture/domain-exceptions.md
    - Domain Dataclasses: architecture/domain-dataclasses.md
    - Model Conversion: architecture/model-conversion.md
    - Event Storage: architecture/event-storage.md
    - Event System Design: architecture/event-system-design.md
    - User Settings Events: architecture/user-settings-events.md
    - Frontend Build: architecture/frontend-build.md
    - Svelte 5 Migration: architecture/svelte5-migration.md
    - Kafka Topics: architecture/kafka-topic-architecture.md
    - Service Lifecycle: architecture/lifecycle.md

  - API Reference: reference/api-reference.md
  - Configuration Reference: reference/configuration.md

  - Components:
    - SSE:
      - Architecture: components/sse/sse-architecture.md
      - Partitioned Router: components/sse/sse-partitioned-architecture.md
      - Execution Flow: components/sse/execution-sse-flow.md
    - Workers:
      - Overview: components/workers/index.md
      - Saga Orchestrator: components/workers/saga_orchestrator.md
      - K8s Worker: components/workers/k8s_worker.md
      - Pod Monitor: components/workers/pod_monitor.md
      - Result Processor: components/workers/result_processor.md
      - Event Replay: components/workers/event_replay.md
      - DLQ Processor: components/workers/dlq_processor.md
    - Saga:
      - Resource Allocation: components/saga/resource-allocation.md
    - Dead Letter Queue: components/dead-letter-queue.md
    - Schema Manager: components/schema-manager.md
    - Saved Scripts: components/saved-scripts.md

  - Operations:
    - Deployment: operations/deployment.md
    - CI/CD Pipeline: operations/cicd.md
    - Nginx Configuration: operations/nginx-configuration.md
    - Logging: operations/logging.md
    - Log Aggregation (Loki): operations/loki.md
    - Tracing: operations/tracing.md
    - Metrics:
      - Reference: operations/metrics-reference.md
      - Context Variables: operations/metrics-contextvars.md
      - CPU Time Measurement: operations/cpu-time-measurement.md
    - Notifications: operations/notification-types.md
    - Grafana Integration: operations/grafana-integration.md
    - Admin API: operations/admin-api.md

  - Security:
    - Policy: SECURITY.md
    - Network Isolation: security/policies.md
    - Supply Chain & SBOM: security/supply-chain.md

  - Frontend:
    - Routing: frontend/routing.md
    - Error Handling: frontend/error-handling.md

  - Testing:
    - Contract Testing: testing/contract-testing.md
    - Load Testing: testing/load-testing.md
    - Frontend Testing: testing/frontend-testing.md
    - Kafka Test Stability: testing/kafka-test-stability.md