ci(workflows): add workflow ci

  ## what
  - add workflow `ci`
    - lint ansible files
    - run ansible playbook on different OS
      - OS
        - macos
        - ubuntu
      - steps
        - checkout code
        - remove homebrewo (if running on macos)
        - remove built in browsers (if running on macos)
        - install ansible via `pip3`
        - check playbook syntax
        - run ansible playbook
          - using `./dotfiles` script

  ## how
  - obtained from
    - https://github.com/geerlingguy/mac-dev-playbook/blob/master/.github/workflows/ci.yml

  ## why
  - this will be used to run the ansible playbook depending on the OS
  - this will be used to check if ansible playbook works
  - to ensure the script works before the repo is cloned

  ## where
  - ./.github/workflows/ci.yaml

  ## usage

  ## issue or pull request

.github/workflows/ci.yaml

@@ -0,0 +1,156 @@
+---
+
+# run setting up dotfiles using ansible in a CI server.
+# This is to check if the dotfiles are being setup properly without issues.
+#
+# Obtained from https://github.com/geerlingguy/mac-dev-playbook/blob/master/.github/workflows/ci.yml
+
+name: CI
+'on':
+  pull_request:
+  push:
+    branches:
+      - master
+  schedule:
+    - cron: "0 5 * * 4"
+
+env:
+  FORCE_COLOR: true     # display terminal colors
+  ANSIBLE_FORCE_COLOR: '1'
+
+jobs:
+
+  integration:
+    name: Integration
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            playbook: macos
+          # - os: macos-12
+          #   playbook: macos
+          # - os: ubuntu-latest
+          #   playbook: wsl-ubuntu
+          - os: ubuntu-22.04
+            playbook: wsl-ubuntu
+
+    steps:
+      - name: Check out the codebase.
+        uses: actions/checkout@v4
+
+      # - name: Uninstall GitHub Actions' built-in Homebrew.
+      #   if: startsWith(matrix.os, 'macos')
+      #   run: |
+      #     # Download and run the uninstall script.
+      #     curl -sLO https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh ;
+      #     chmod +x ./uninstall.sh ;
+      #     sudo ./uninstall.sh --force ;
+      #     # Clean up Homebrew directories.
+      #     sudo rm -rf /usr/local/Homebrew ;
+      #     sudo rm -rf /usr/local/Caskroom ;
+      #     sudo rm -rf /usr/local/bin/brew ;
+      #
+      # - name: Uninstall GitHub Actions' built-in browser installs.
+      #   if: startsWith(matrix.os, 'macos')
+      #   run: |
+      #     sudo rm -rf /Applications/Firefox.app
+      #     sudo rm -rf /Applications/Google\ Chrome.app
+      #     sudo rm -rf /usr/local/bin/firefox
+
+      - name: Setup locales
+        if: startsWith(matrix.os, 'ubuntu')
+        run: |
+          export LANG=en_CA.UTF-8
+          export LC_ALL=en_CA.UTF-8
+          sudo locale-gen "en_CA.UTF-8"
+          sudo dpkg-reconfigure locales
+
+      - name: Install python build tools
+        if: startsWith(matrix.os, 'ubuntu')
+        shell: bash
+        # Ref: https://github.com/pyenv/pyenv/wiki#suggested-build-environment
+        run: |
+          sudo apt-get update -qq -y ;
+          sudo apt-get install -qq -y make build-essential libssl-dev zlib1g-dev \
+          libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
+          libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev ffmpeg
+
+      - name: Setup pyenv ENV variables
+        shell: bash
+        run: |
+          PYENV_ROOT="$HOME/.pyenv" ;
+          PYENV_BIN="$PYENV_ROOT/bin" ;
+          PYENV_SHIMS="$PYENV_ROOT/shims" ;
+          echo "$PYENV_BIN" >> "$GITHUB_PATH" ;
+          echo "$PYENV_SHIMS" >> "$GITHUB_PATH" ;
+          echo "PYENV_ROOT=$PYENV_ROOT" >> "$GITHUB_ENV" ;
+          # env ;
+
+      - name: Install pyenv
+        shell: bash
+        run: curl https://pyenv.run | bash
+
+      - name: Install latest python version
+        shell: bash
+        run: |
+          # trim whitespace. https://unix.stackexchange.com/a/205854
+          pythonVersion=$(pyenv install --list | grep --extended-regexp "^\s*[0-9][0-9.]*[0-9]\s*$" | tail -1 | awk '{$1=$1;print}')
+          pyenv install --skip-existing "$pythonVersion"
+          pyenv global "$pythonVersion"
+          python --version
+
+      - name: Install ansible
+        shell: bash
+        run: |
+          pip3 install ansible
+          pyenv rehash
+
+      - name: which ansible
+        shell: bash
+        run: |
+          which ansible ;
+          which ansible-galaxy ;
+          which ansible-playbook ;
+          ansible --version
+
+      - name: Install ansible-galaxy requirements
+        shell: bash
+        run: ansible-galaxy install -r requirements.yaml
+
+      - name: print env
+        shell: bash
+        run: env
+
+      - name: print pyenv shims
+        run: |
+          pyenv doctor
+          pyenv shims
+
+      - name: which ansible-playbook after source
+        shell: bash
+        run: |
+          which ansible ;
+          which ansible-galaxy
+          which ansible-playbook ;
+          source tools/zsh/.zshenv
+          echo "$PYENV_ROOT"
+          PYENV_ROOT=$HOME/.pyenv
+          echo "$PYENV_ROOT"
+          which ansible ;
+          which ansible-galaxy
+          which ansible-playbook ;
+
+      - name: Run playbook '${{ matrix.playbook }}'
+        shell: bash
+        run: |
+          which ansible ;
+          which ansible-playbook ;
+          source tools/zsh/.zshenv ;
+          # source tools/zsh/exports.zsh ;
+          PYENV_ROOT=$HOME/.pyenv
+          unset ANSIBLE_HOME ;
+          unset ANSIBLE_CONFIG ;
+          unset ANSIBLE_GALAXY_CACHE_DIR ;
+          ANSIBLE_CONFIG=./ansible.cfg ansible-playbook playbooks/${{ matrix.playbook }}.yaml