# Turnstone context doc manifest — Heimdall home lab cluster
# Run: python scripts/harvest_docs.py --manifest scripts/manifests/heimdall-devops.yaml
#
# Sections:
#   infrastructure/  — network topology, machine specs, service ports
#   runbooks/        — incident postmortems and operational procedures
#   tdarr/           — media transcoding failure modes and recovery
#
# Files intentionally excluded from this manifest:
#   - WireGuard .conf files and KEYS.txt (contain private keys)
#   - SESSION_* and HANDOFF_* files (Claude session prompts, not operational docs)
#   - CLAUDE.md files (Claude context prompts, not operational docs)
#   - Raw tdarr scan data (tdarr/data/*.txt — scan output, not prose)
#   - projects/helmet-3d, projects/mycroft-precise (unrelated to cluster ops)
#   - collapse-stack/ (resilience planning, not daily log triage material)
#   - bastion/sdcard-config, bastion/rpi-config (one-time setup artifacts)

base_url: http://localhost:8534

sources:
  # ── Service inventory (most immediately useful for log attribution) ────────
  - path: /Library/Development/CircuitForge/circuitforge-infra/inventory/services.md
    label: service-inventory.md

  # ── Infrastructure topology (partially outdated — note added at top of file)
  - path: /Library/Development/CircuitForge/circuitforge-infra/infrastructure/docs/INFRASTRUCTURE.md
    label: infrastructure-topology.md

  - path: /Library/Development/CircuitForge/circuitforge-infra/infrastructure/docs/GPU_CLUSTERING.md
    label: gpu-clustering.md

  - path: /Library/Development/CircuitForge/circuitforge-infra/infrastructure/ssh_configs/PROXYJUMP_CONFIG.md
    label: ssh-proxyjump-config.md

  # ── Runbooks ───────────────────────────────────────────────────────────────
  - path: /Library/Development/CircuitForge/circuitforge-infra/runbooks/cf-orch-coordinator.md
    label: runbook-cf-orch-coordinator.md

  - path: /Library/Development/CircuitForge/circuitforge-infra/runbooks/docker-nfs-boot-race-and-image-security.md
    label: runbook-docker-nfs-boot-race.md

  - path: /Library/Development/CircuitForge/circuitforge-infra/runbooks/PIHOLE_DNS_HANDOFF.md
    label: runbook-pihole-dns.md

  # ── Media server / Tdarr ───────────────────────────────────────────────────
  - path: /Library/Development/devl/Devops/tdarr/docs/TDARR_RECOVERY_README.md
    label: tdarr-recovery.md

  - path: /Library/Development/devl/Devops/tdarr/docs/NVENC_CORRUPTION_DETECTION.md
    label: tdarr-nvenc-corruption.md

  - path: /Library/Development/devl/Devops/tdarr/docs/TDARR_ROBUST_WORKFLOW.md
    label: tdarr-robust-workflow.md