mkdocs.yml

site_name: Primr
site_description: Turn any company or organization URL into a sourced strategic intelligence brief.
site_url: https://blisspixel.github.io/primr/
repo_url: https://github.com/blisspixel/primr
repo_name: blisspixel/primr
edit_uri: edit/main/docs/
copyright: Copyright © 2025-2026 Nick Seal - Apache License 2.0

docs_dir: docs
strict: true
exclude_docs: |
  agent/**

theme:
  name: material
  icon:
    repo: fontawesome/brands/github
  features:
    - navigation.tracking
    - navigation.sections
    - navigation.top
    - navigation.indexes
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.action.edit
    - toc.follow
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode

plugins:
  - search

markdown_extensions:
  - admonition
  - tables
  - attr_list
  - md_in_html
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - toc:
      permalink: true

# Curated nav follows the Diataxis split already used in docs/README.md.
# Root-level docs (ROADMAP, CLAUDE, AGENTS) are deliberately linked out to
# GitHub rather than pulled into docs_dir.
nav:
  - Home: README.md
  - Getting started:
      - Zero-cost and host-assisted research: ZERO_COST.md
      - API keys: API_KEYS.md
      - Configuration: CONFIG.md
      - Run modes and costs: RUN_MODES.md
      - Azure quickstart: AZURE_QUICKSTART.md
  - How-to guides:
      - Batch processing: BATCH.md
      - Crash recovery: RECOVERY.md
      - Improve a report: IMPROVE.md
      - Skill packs: SKILL_PACK.md
      - Evaluation: EVAL.md
      - Model onboarding: MODEL_ONBOARDING.md
      - Agent integration: AGENT_INTEGRATION.md
      - OpenClaw: OPENCLAW.md
      - Copilot Cowork: COPILOT_COWORK_GUIDE.md
      - Copilot Studio: COPILOT_STUDIO_GUIDE.md
      - Foundry agent: FOUNDRY_AGENT_GUIDE.md
      - Cloud deployment: CLOUD_DEPLOYMENT.md
      - Security operations: SECURITY_OPS.md
  - Reference:
      - Next steps: NEXT_STEPS.md
      - MCP & A2A API: API.md
      - Job Status Contract: JOB_STATUS.md
      - Strategy portfolio: STRATEGY_PORTFOLIO.md
      - Eval v1.24 decision log: EVAL_V1_24_0.md
      - Changelog: CHANGELOG.md
      - Migration notes: MIGRATION.md
  - Explanation:
      - Architecture: ARCHITECTURE.md
      - Artifact pipeline: ARTIFACTS.md
      - Internals: INTERNALS.md
      - State machines: STATE_MACHINES.md
      - Concurrency: CONCURRENCY.md
      - Security policy: SECURITY.md
  - Design notes:
      - Overview: design/README.md
      - "1.x completion": design/1x-completion.md
      - Agentic balance: design/agentic-balance.md
      - Open Knowledge Format: design/open-knowledge-format.md
      - Engineering excellence: design/engineering-excellence.md
      - Runtime and language boundaries: design/runtime-language-boundaries.md
      - Research tradecraft: design/research-tradecraft.md
      - Eval plan: design/eval-plan.md
      - Provider expansion: design/provider-expansion.md
      - Orchestrator refactor map: design/23-orchestrator-refactor-map.md
      - Architecture cohesion plan: design/24-architecture-cohesion-plan.md
      - "2.0: agent control plane": design/2.0-agent-control-plane.md
      - "2.0: backend freedom": design/2.0-backend-freedom.md
      - "2.0: research memory": design/2.0-research-memory.md
      - "3.0: research frontier": design/3.0-research-frontier.md
  - Contributing: CONTRIBUTING.md