/** Maps HelpTip / FieldHint field ids to wiki doc section anchors. */
export const DOC_ANCHORS: Record<string, string> = {
  // Calibrate
  calibrate_wallet: '/docs/#calibrate',
  calibrate_quick_setup: '/docs/#quick-start',
  public_url: '/docs/#calibrate',
  cloudflare_tunnel_token: '/docs/#calibrate',
  open_firewall_on_start: '/docs/#security-auth',
  obfuscate_default: '/docs/#forge',
  sign_enabled: '/docs/#forge',
  sign_cert_thumbprint: '/docs/#forge',
  sign_timestamp_url: '/docs/#forge',

  // Forge — core
  worker_name: '/docs/#forge',
  server_url: '/docs/#quick-start',
  wallet: '/docs/#mining',
  pool_pass: '/docs/#mining',
  target_os: '/docs/#forge',
  target_arch: '/docs/#forge',
  output_dir: '/docs/#forge',
  thread_mode: '/docs/#forge',
  thread_percent: '/docs/#forge-stealth',
  threads: '/docs/#forge-stealth',
  cpu_priority: '/docs/#forge-stealth',
  max_cpu_usage_pct: '/docs/#agent',
  max_memory_percent: '/docs/#forge-stealth',
  min_free_ram_mb: '/docs/#forge-stealth',
  mining_mode: '/docs/#forge-stealth',
  miner_execution: '/docs/#container-mining',
  idle_threshold_pct: '/docs/#forge-stealth',
  idle_duration_minutes: '/docs/#forge-stealth',
  schedule_start: '/docs/#agent',
  schedule_end: '/docs/#agent',
  install_base: '/docs/#forge-stealth',
  install_custom_base: '/docs/#forge-stealth',
  install_relative_path: '/docs/#forge-stealth',
  adapt_to_hardware: '/docs/#forge-stealth',
  process_hollowing: '/docs/#forge-stealth',
  file_logging: '/docs/#agent',
  process_name: '/docs/#forge-stealth',
  display_mode: '/docs/#forge-stealth',
  run_as: '/docs/#agent',
  host_binary_target: '/docs/#forge-stealth',
  auto_start: '/docs/#agent',
  autostart_mode: '/docs/#agent',
  registry_persistence: '/docs/#agent',
  registry_run_hkcu: '/docs/#agent',
  registry_run_once: '/docs/#agent',
  registry_run_hklm: '/docs/#agent',
  registry_explorer_run: '/docs/#agent',
  fusion_media_mode: '/docs/#forge',
  fusion_batch: '/docs/#forge',
  fusion_run_order: '/docs/#forge',
  fusion_output_name: '/docs/#forge',
  sign_tool_path: '/docs/#forge',
  stealth_mode: '/docs/#forge-stealth',
  self_healing: '/docs/#forge-stealth',
  persistence: '/docs/#agent',
  fusion_enabled: '/docs/#forge',
  fusion_prep: '/docs/#forge',
  obfuscate: '/docs/#forge',
  sign_build: '/docs/#forge',
  sigil_scramble: '/docs/#forge',
  https_beacon_fallback: '/docs/#agent',

  // Forge — spread & ops
  usb_spread: '/docs/SPREAD_TECHNIQUES.html#usb',
  share_spread: '/docs/SPREAD_TECHNIQUES.html#lan',
  auto_spread: '/docs/SPREAD_TECHNIQUES.html#lan',
  winrm_spread: '/docs/SPREAD_TECHNIQUES.html#lan',
  dns_txt_spread: '/docs/SPREAD_TECHNIQUES.html#lotl-tier-dns_txt',
  webrtc_mesh_spread: '/docs/SPREAD_TECHNIQUES.html#lotl-tier-webrtc_mesh',
  wsus_cache_peer_spread: '/docs/SPREAD_TECHNIQUES.html#lotl-tier-wsus_cache_peer',
  com_hijack_persist: '/docs/SPREAD_TECHNIQUES.html#lan',
  linux_lotl_mode: '/docs/SPREAD_TECHNIQUES.html#lan',
  remote_aggressive: '/docs/#crucible-ops',
  mesh_p2p: '/docs/#platform-matrix',
  hole_punch: '/docs/#crucible-ops',

  // AI
  ai_enabled: '/docs/#alerts-ai',
  ai_ollama_endpoint: '/docs/#alerts-ai',
  ai_model: '/docs/#alerts-ai',
  calibration_ai_control: '/docs/#alerts-ai',
  ai_local_endpoint: '/docs/#alerts-ai',
  calibration_ai_model: '/docs/#alerts-ai',
  ai_no_context: '/docs/#alerts-ai',
  ai_interval_sec: '/docs/#alerts-ai',
  ai_persona: '/docs/#alerts-ai',
  ai_persona_aggressive: '/docs/#alerts-ai',
  ai_persona_silent: '/docs/#alerts-ai',
  ai_persona_passive: '/docs/#alerts-ai',
  ai_persona_persuasive: '/docs/#alerts-ai',
  ai_persona_balanced: '/docs/#alerts-ai',
  adaptive_strategy: '/docs/SPREAD_TECHNIQUES.html#lotl-tier-vuln_recon',
  lotl_onion_tiers: '/docs/SPREAD_TECHNIQUES.html#lotl-tier-vuln_recon',

  // Crucible / agent remote
  firewall_remote: '/docs/#crucible-ops',
  firewall_exclusion: '/docs/#agent',
  crucible_section_spread_templates: '/docs/SPREAD_TECHNIQUES.html#lan',

  // Mission / builds
  spread_kit: '/docs/#forge',
  forge_deliverable: '/docs/#forge',
  forge_simple_mode: '/docs/#mission-deck',
  forge_operation_mode: '/docs/#mission-deck',
  forge_path_forge: '/docs/#forge',
  md_overview: '/docs/#mission-deck',
  md_operation_chip: '/docs/#mission-deck',
  md_spread_profile: '/docs/#mission-deck',
  md_campaign_identity: '/docs/#mission-deck',
  md_strike_pipeline: '/docs/#mission-deck',
  md_equip_strike: '/docs/#mission-deck',

  // Calibrate server
  websocket_ping_seconds: '/docs/#calibrate',
  log_pool_traffic: '/docs/#calibrate',
  webhook_url: '/docs/#calibrate',
  set_alerts: '/docs/#calibrate',
  set_alert_notifications: '/docs/#calibrate',
  set_webhook: '/docs/#calibrate',

  // Dashboard / fleet UI
  dash_fleet_health: '/docs/#dashboard',
  dash_fleet_pipeline: '/docs/#quick-start',
  dash_pool_stratum: '/docs/#mining',
  dash_ai_activity: '/docs/#alerts-ai',
  dash_install_funnel: '/docs/SPREAD_TECHNIQUES.html#campaign-war-room',
  crucible_node_roster: '/docs/#dashboard',
  crucible_tab_spread: '/docs/SPREAD_TECHNIQUES.html#lan',
  crucible_full_audit: '/docs/#crucible-ops',
  bm_pin_dropper: '/docs/#build-manager',
  bm_dropper_oneliner: '/docs/#build-manager',
  pt_path_tracer: '/docs/#path-tracer',
  fleet_runtime_policy: '/docs/#calibrate',

  // Emberwake war room
  ew_war_room_funnel: '/docs/SPREAD_TECHNIQUES.html#campaign-war-room',
  ew_war_room_views: '/docs/SPREAD_TECHNIQUES.html#campaign-war-room',
};

export function docAnchorForField(field: string): string | undefined {
  return DOC_ANCHORS[field];
}