- synthesizer: 3 system prompts (sysadmin/homelab/executive) selected by tech_level pref - settings: tech_level selector (UI + backend) persisted in preferences.json - QuickCapture: shows active level label in diagnosis card header - TURNSTONE_OFFLINE_MODE=1: sets HF_HUB_OFFLINE + TRANSFORMERS_OFFLINE before lib load - TURNSTONE_API_KEY: bearer token auth on all /api/ routes (hmac.compare_digest) - /health always open; unset key = no auth (backward compatible) - docs/air-gapped-deployment.md: full offline deployment guide - scripts/harvest_docs.py: generalized context doc bulk-uploader with manifest support - scripts/manifests/: heimdall-devops.yaml (10 docs ingested) + example.yaml template - fix: _ingest_upload -> _glean_upload in context doc upload endpoint (was 500) Closes: #56 Closes: #45 Closes: #47 Closes: #49 Closes: #21
53 lines
2.8 KiB
YAML
53 lines
2.8 KiB
YAML
# 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
|