---
# ------------------------------------------------------------------------------
# FILE: roles/llm-inference/tasks/foundation.yml
# DESCRIPTION: Phase 1 — Foundation.
#              - Asserts vault secret is defined
#              - Adds jarvis user to nvidia GPU groups
#              - Creates HuggingFace cache directory
#              - Creates venv parent directory
# NOTE: NVIDIA driver install (Phase 2) already performed manually on
#       2026-08-03 (nvidia-driver-595-open, DKMS built, nvidia-smi verified).
#       Phase 2 tasks are idempotent and will no-op on astro-orbiter.
# ------------------------------------------------------------------------------

- name: Assert HuggingFace token is defined in vault
  ansible.builtin.assert:
    that:
      - vault_hf_token is defined
      - vault_hf_token | length > 0
    fail_msg: >
      vault_hf_token is not defined. Add it to group_vars/all/vault:
        vault_hf_token: "hf_xxxxxxxxxxxxxxxxxxxx"

- name: Add jarvis user to nvidia GPU groups
  ansible.builtin.user:
    name: jarvis
    groups:
      - video
      - render
    append: true

- name: Create HuggingFace cache directory
  ansible.builtin.file:
    path: "{{ llm_hf_cache_dir }}"
    state: directory
    owner: jarvis
    group: jarvis
    mode: "0755"

- name: Create venv parent directory
  ansible.builtin.file:
    path: "{{ llm_venv_path | dirname }}"
    state: directory
    owner: jarvis
    group: jarvis
    mode: "0755"