fix formatting, complete clangd system install

tasks/pkgs/air.yml

@@ -3,8 +3,7 @@
 ## Package: air
 ## Description: application auto reload for go
 ## Version: latest
-## Methods:
+## Methods: source
-##   - source (go install)
 ## Helpers: go_install
 ---
 - name: Set air default facts # {{{

tasks/pkgs/alacritty.yml

@@ -3,11 +3,8 @@
 ## Package: alacritty
 ## Description: GPU accelerated terminal emulator written in rust
 ## Version: v0.16.1
-## Methods:
+## Methods: [source, system]
-##   - system
+## Helpers: cargo_build
-##   - source (cargo build)
-## Helpers:
-##   - cargo_build
 ---
 - name: Set alacritty default facts # {{{
   ansible.builtin.set_fact:

tasks/pkgs/ansible.yml

@@ -3,15 +3,15 @@
 ## Package: ansible
 ## Description: simple infrastructure as code tool
 ## Version: latest
-## Methods:
+## Methods: [system, source]
-##   - system
+## Helpers: pipx
-##   - source (pipx)
 ---
 - name: Set ansible default facts # {{{
   ansible.builtin.set_fact:
     ansible:
       install_methods:
         - system
+        - source
       pkgname:
         RedHat: ansible
         Debian: ansible

tasks/pkgs/ansible_ls.yml

@@ -3,9 +3,7 @@
 ## Package: ansible_ls
 ## Description: language server for ansible yaml
 ## Version: latest
-## Methods:
+## Methods: [source, system]
-##   - source (npm)
-##   - system
 ## Helpers: npm
 ---
 - name: Set ansible_ls default facts # {{{

tasks/pkgs/bashls.yml

@@ -3,8 +3,7 @@
 ## Package: bashls
 ## Description: language server for bash (sh compatible)
 ## Version: latest
-## Methods:
+## Methods: source
-##   - source (npm)
 ## Helpers: npm
 ---
 - name: Set bashls default facts # {{{

tasks/pkgs/bat.yml

@@ -3,8 +3,8 @@
 ## Package: bat
 ## Description: cat replacement with style
 ## Version: latest
-## Methods:
+## Methods: source
-##   - source
+## Helpers: cargo
 ---
 - name: Start bat configuration
   when:

tasks/pkgs/btop.yml

@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: btop
+## Description: TUI system monitor that looks
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default btop options
   ansible.builtin.set_fact:

tasks/pkgs/buf.yml

@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: buf
+## Description: A CLI tool for working with protocols buffers
+## Version: latest
+## Methods: source
+## Helpers: go_install
 ---
 - name: Set default buf values
   ansible.builtin.set_fact:

tasks/pkgs/bufls.yml

@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: bufls
+## Description: a language server for protocol buffers
+## Version: latest
+## Methods: source
+## Helpers: go_install
 ---
 - name: Set default bufls options
   ansible.builtin.set_fact:

tasks/pkgs/cargo.yml

@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: cargo
+## Description: the Rust package manager
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default cargo values
   ansible.builtin.set_fact:

tasks/pkgs/cbfmt.yml

@@ -1,7 +1,10 @@
 # vim: set filetype=yaml.ansible :
 #
 ## Package: cbfmt
-## Description
+## Description: code block formatter
+## Version: system
+## Methods: system
+## Helpers: -
 ---
 - name: Set default cbfmt values
   ansible.builtin.set_fact:

tasks/pkgs/cheat.yml

@@ -1,9 +1,10 @@
 # vim: set filetype=yaml.ansible :
 #
 ## Package: cheet
+## Description: create and view interactive cheat sheets
 ## Version: latest
 ## Methods: source
-## Helpers: go
+## Helpers: go_install
 ---
 - name: Set cheat default facts # {{{
   ansible.builtin.set_fact:

tasks/pkgs/checkmake.yml

@@ -4,7 +4,7 @@
 ## Description: linter for makefiles
 ## Version: latest
 ## Methods: source
-## Helpers: go
+## Helpers: go_install
 ---
 - name: Set checkmake default facts
   ansible.builtin.set_fact:

tasks/pkgs/choose.yml

@@ -1,4 +1,10 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: choose
+## Description:
+## Version: latest
+## Methods: source
+## Helpers: cargo
 ---
 - name: Add choose
   block:

tasks/pkgs/clangd.yml

@@ -1,9 +1,38 @@
 # vim: set filetype=yaml.ansible :
+#
+## Package: clangd
+## Description: a c/c++ language server for the clang llvm compiler
+## Version: system
+## Methods: system
+## Helpers: -
 ---
-- name: Load clangd config
+- name: Set clangd default facts
-  ansible.builtin.include_tasks:
-    file: config/clangd.yml
-
-- name: Append clangd to pkg_sys
   ansible.builtin.set_fact:
-    pkg_sys: "{{ pkg_sys + clangd.pkgs }}"
+    clangd:
+      install_methods:
+        - system
+      pkgname:
+        RedHat: clang-devel
+        Debian: clang-12
+        Darwin: llvm
+        Alpine: clang19
+
+- name: Configure clangd
+  when:
+    - "'clangd' not in __configured"
+  block:
+    - name: Set clangd install method
+      when:
+        - clangd_install_method is undefined
+      ansible.builtin.set_fact:
+        clangd_install_method: "{{ install_method if install_method in clangd.install_methods else clangd.install_methods[0] }}"
+
+    - name: Queue clangd system install
+      when:
+        - clangd_install_methods == 'system'
+      ansible.builtin.set_fact:
+        pkg_sys: "{{ pkg_sys + clangd[os_family] }}"
+
+    - name: Finalise clangd configuration
+      ansible.builtin.set_fact:
+        __configured: "{{ __configured | combine( { 'clangd': clangd_install_method } ) }}"