ai-model-vault 4.6.1

# AI Model Vault — MkDocs Configuration
# Build: mkdocs build          (outputs to website/public/mkdocs/)
# Serve: mkdocs serve           (dev preview at http://127.0.0.1:8000)
# Deploy to Next.js: mkdocs build && next build  (from website/)

site_name: AI Model Vault
site_description: Universal cross-platform secure vault for AI model storage, versioning, and management
site_author: NERVOSYS AI Team
site_url: https://aimodelvault.nervosys.ai/mkdocs/
repo_url: https://github.com/nervosys/AIModelVault
repo_name: nervosys/AIModelVault
copyright: "© 2025-2026 NERVOSYS. Licensed under AGPL-3.0-or-later."

docs_dir: docs
site_dir: website/public/mkdocs

theme:
  name: material
  language: en
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: blue
      accent: blue
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: blue
      accent: light blue
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  font:
    text: Inter
    code: JetBrains Mono
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.tabs
    - navigation.sections
    - navigation.expand
    - navigation.top
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.tabs.link
    - toc.follow
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - minify:
      minify_html: true

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

  # PyMdown Extensions
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.tasklist:
      custom_checkbox: true

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/nervosys/AIModelVault
  generator: false

# `--strict` promotes warnings to errors. Keep link checking strict — a broken
# cross-reference between docs is a real defect — but allow the one nav entry
# that points at rustdoc output, which the CI `docs` job copies into
# `website/public/mkdocs/api/` after this build runs and which therefore cannot
# exist at build time.
validation:
  nav:
    not_found: info
  links:
    not_found: warn
    unrecognized_links: warn

nav:
  - Home: index.md
  - Getting Started:
      - Quick Start: QUICKSTART.md
      - CLI Reference: CLI.md
      - Demo Guide: DEMO_GUIDE.md
      - Examples Guide: EXAMPLES_GUIDE.md
      - Examples: EXAMPLES.md
  - Core Features:
      - Top 10 Features: TOP_10_FEATURES.md
      - Providers & Formats: PROVIDERS_FORMATS.md
      - Providers & Formats Quick Ref: PROVIDERS_FORMATS_QUICKREF.md
      - Version Control: VERSION_CONTROL.md
      - Version Control Quick Ref: VERSION_CONTROL_QUICKREF.md
      - Model Cards: MODEL_CARDS.md
      - Model Cards Quick Ref: MODEL_CARDS_QUICKREF.md
      - HDF5 Support: HDF5_SUPPORT.md
      - Model Download: MODEL_DOWNLOAD.md
      - Model Signing: MODEL_SIGNING.md
      - Model Diffing: MODEL_DIFFING.md
      - Engine Interop: ENGINE_INTEROP.md
  - Security:
      - Security Audit: SECURITY_AUDIT.md
      - Security Hardening: SECURITY_HARDENING.md
      - Vulnerability Fixes: VULNERABILITY_FIXES.md
      - Safety Scanning: SAFETY_SCANNING.md
      - License Scanning: LICENSE_SCANNING.md
      - Access Control: ACCESS_CONTROL.md
      - External KMS: KMS.md
      - Model Validation: VALIDATION.md
      - Blockchain Audit: BLOCKCHAIN_AUDIT.md
  - AI & RAG:
      - RAG System: RAG.md
      - RAG Quick Ref: RAG_QUICKREF.md
      - MCP Tools: MCP_TOOLS.md
      - MCP Quick Ref: MCP_QUICKREF.md
      - Database: DATABASE.md
  - Cloud & Deployment:
      - Cloud Storage: CLOUD_STORAGE.md
      - Cloud CLI: CLOUD_CLI.md
      - XDG Compliance: XDG_COMPLIANCE.md
      - XDG Quick Ref: XDG_QUICKREF.md
      - Migration Guide: MIGRATION.md
  - Utilities:
      - Utilities Guide: UTILITIES.md
      - Utilities Quick Ref: UTILITIES_QUICKREF.md
      - Utilities Summary: UTILITIES_SUMMARY.md
  - Operations:
      - Quantization Pipeline: QUANTIZATION.md
      - Evaluation Harness: EVALUATION.md
      - Backup Scheduling: BACKUP_SCHEDULING.md
      - Multi-Vault Management: MULTI_VAULT.md
      - Retention Policies: POLICIES.md
      - Garbage Collection: GARBAGE_COLLECTION.md
      - Vault Export/Import: VAULT_BUNDLE.md
      - Tags & Search: TAGS.md
      - Config Profiles: PROFILES.md
      - Webhooks: WEBHOOKS.md
      - Plugins: PLUGINS.md
      - Lineage Graph: LINEAGE_GRAPH.md
      - TUI Dashboard: TUI.md
      - Federation: FEDERATION.md
  - Performance:
      - Performance: PERFORMANCE.md
      - Feature Flags: FEATURE_FLAGS.md
      - Benchmarks: BENCHMARKS.md
  - Architecture:
      - Architecture: ARCHITECTURE.md
      - Architecture V2: ARCHITECTURE_V2.md
      - Project Structure: PROJECT_STRUCTURE.md
      - Project Summary: PROJECT_SUMMARY.md
      - Implementation: IMPLEMENTATION.md
  - Development:
      - Python Bindings: PYTHON_BINDINGS.md
      - PyTorch & UV Guide: PYTORCH_UV_GUIDE.md
      - UV Integration: UV_INTEGRATION.md
      - Telemetry: TELEMETRY.md
      - Executive Summary: EXECUTIVE_SUMMARY.md
  - API Reference: api/ai_model_vault/index.html