android, ensure permissions are correct for ~/.gradle.

files/scripts/backup_system.sh

@@ -69,7 +69,7 @@ sleep 5
 
 echo "*** Creating backup at '$BACKUP2' ***"
 sudo zip -rv "$BACKUP2" \
-	/root /home /srv/sftp \
+	/root /home \
 	-x "*/.gradle/" -x "*/app/build/*"
 status="$?"
 

files/settings/i3.config

@@ -398,7 +398,7 @@ exec_always --no-startup-id "sleep 00; killall pipewire wireplumber pipewire-pul
 exec_always --no-startup-id "sleep 01; pipewire >~/Reports/pipewire.log 2>&1 &"
 exec_always --no-startup-id "sleep 02; wireplumber >~/Reports/wireplumber.log 2>&1 &"
 exec_always --no-startup-id "sleep 03; pipewire-pulse >~/Reports/pipewire-pulse.log 2>&1 &"
-exec        --no-startup-id "sleep 04; bash -c 'source /usr/local/bin/volume.function && volume 25'"
+exec        --no-startup-id "sleep 04; bash -c 'source /usr/local/bin/volume.function && volume 75'"
 
 # Wallpaper
 exec_always --no-startup-id feh --recursive --randomize --bg-fill ~/Pictures/Wallpapers
@@ -448,4 +448,4 @@ set $refresh_i3status killall -SIGUSR1 i3status
 exec_always --no-startup-id "killall sunset-alarm; /home/ling/Code/sunset_alarm_cli/sunset-alarm -l 32:-111 -m 30 > ~/Reports/sunset-alarm.log 2>&1"
 
 # Bedtime ;)
-exec --no-startup-id "while true; do if [[ `date +'%H'` -ge 20 ]]; then fyi -w -u critical 'Bedtime' 'Go to sleep! >:)'; fi; sleep 150; done"
+exec --no-startup-id "while true; do if [[ `date +'%H'` -ge 20 ]]; then fyi -w -u critical 'Bedtime' 'Go to sleep! >:)'; fi; sleep 600; done"

tasks/general/acct_mgmt/users.yml

@@ -799,14 +799,25 @@
     alias_prod: |
       alias prod="ssh -p {{ prod_port }} {{ prod_user }}@{{ prod_host }}"
     function_clean_code: |
+      function print_size_delete() {
+        f="$1"
+        if [[ -e "$f" ]]; then
+          du -hs "$f" && sh -c "rm -rf '$f'"
+        fi
+
+      }
       function clean-code() {
         echo -e "******* Android *******\n*** Build Caches ***"
         find $HOME/Code/android-*/app -maxdepth 1 -type d -name "build" \
           -exec du -hs {} \; -exec rm -rf {} \;
+
         echo -e "\n*** Gradle Caches ***"
         find $HOME/Code/android-*/ -maxdepth 1 -type d -name ".gradle" \
           -exec du -hs {} \; -exec rm -rf {} \;
 
+        print_size_delete "$HOME/.gradle"
+        mkdir "$HOME/.gradle"
+
         echo -e "******* Flutter *******"
         ls $HOME/Code | grep flutter | while read project; do
           cd $HOME/Code/$project
@@ -816,6 +827,10 @@
         done
         cd
 
+        print_size_delete "$HOME/.pub_cache"
+        print_size_delete "$HOME/.pub-cache"
+        mkdir "$HOME/.pub-cache"
+
         echo -e "******* PDFs *******"
         find $HOME/Code/ebook-* -name "*.pdf" -exec du -h {} \; -delete | sort -h
 

tasks/general/settings/tunnel.yml

@@ -17,10 +17,30 @@
   ansible.builtin.set_fact:
     tunnel_service_name: tunnel
 
+- name: General | Tunnel | Packages [pacman]
+  ansible.builtin.package:
+    name:
+      - openbsd-netcat
+    state: present
+  when: ansible_pkg_mgr == "pacman"
+
+- name: General | Tunnel | Packages [apt]
+  ansible.builtin.package:
+    name:
+      - netcat-openbsd
+    state: present
+  when: ansible_pkg_mgr == "apt"
+
 - name: General | Tunnel | runit
   block:
 
     - name: General | Tunnel | runit | mkdir | /etc/sv
+      ansible.builtin.file:
+        path: /etc/sv/{{ tunnel_service_name }}
+        state: directory
+        mode: "0755"
+
+    - name: General | Tunnel | runit | mkdir | /etc/sv log
       ansible.builtin.file:
         path: /etc/sv/{{ tunnel_service_name }}/log
         state: directory
@@ -38,7 +58,23 @@
         content: |
           #!/bin/sh -e
           exec 2>&1
-          exec chpst -u {{ user }} ssh -v -N \
+
+          # Health check to ensure connection does not go stale.
+          while true; do
+            sleep 300
+            echo -n "RUN-LOOP: "
+            nc -zv {{ tunnel_remote_host }} {{ tunnel_remote_port }}
+            status="$?"
+            echo "RUN-LOOP: Port check returned ${status}."
+            if [[ "$status" != 0 ]]; then
+              echo "RUN-LOOP: Restarting service."
+              sv restart {{ tunnel_service_name }}
+            fi
+            echo "RUN-LOOP: Going back to sleep."
+          done &
+
+          # Do not use `exec` here otherwise the loop may get killed.
+          chpst -u {{ user }} ssh -v -N \
             -R {{ tunnel_remote_port }}:localhost:{{ tunnel_local_port }} \
             -p {{ tunnel_ssh_port }} {{ tunnel_remote_host }}
         mode: "0755"

tasks/general/software/packages.yml

@@ -1,31 +1,78 @@
 ---
 # Cross-platform package management.
 
-- name: General | Software | Packages | Fix Parrot OS (zypper)
-# They have zypper higher in the path, but it's really apt renamed.
-# Probably for "security", but package module does not use the ansible_pkg_mgr variable
-#   so resetting the value to apt doesn't work. Just going to move it.
-  ansible.builtin.shell: "mv `which zypper` `which zypper`.zz.`date +%Y%m%d`"
-  register: parrotos_zypper_removed
-  ignore_errors: true
+- name: General | Software | Packages | Fix Parrot OS
+  block:
+
+    - name: General | Software | Packages | Fix Parrot OS | zypper
+    # They have zypper higher in the path, but it's really apt renamed.
+    # Probably for "security", but package module does not use the ansible_pkg_mgr variable
+    #   so resetting the value to apt doesn't work. Just going to move it.
+      ansible.builtin.shell: "mv `which zypper` `which zypper`.zz.`date +%Y%m%d`"
+      register: parrotos_zypper_removed
+      changed_when: parrotos_zypper_removed.rc == 0
+      ignore_errors: true
+
+    - name: General | Software | Packages | Fix Parrot OS | zypper | Exit Incoming
+      ansible.builtin.debug:
+        msg: "A silly zypper file was renamed successfully. Please try running Ansible again."
+      when: parrotos_zypper_removed is defined and not parrotos_zypper_removed.failed
+
+    - name: General | Software | Packages | Fix Parrot OS | zypper | Exiting
+      ansible.builtin.shell: exit 1
+      register: shell_check
+      changed_when: shell_check.rc == 0
+      when: parrotos_zypper_removed is defined and not parrotos_zypper_removed.failed
+
+    # More Parrot OS junk. They have a command called update in /usr/bin. Doesn't
+    # have sudo or anything in it. Hide it in preference for .bashrc update function.
+    - name: General | Software | Packages | Fix Parrot OS | update
+      ansible.builtin.shell: "mv `which update` `which update`.zz.`date +%Y%m%d`"
+      register: shell_check
+      changed_when: shell_check.rc == 0
+      ignore_errors: true
+
   when: ansible_distribution == "Parrot OS"
 
-- name: General | Software | Packages | Fix Parrot OS (zypper), Exit Incoming
-  ansible.builtin.debug:
-    msg: "A silly zypper file was renamed successfully. Please try running Ansible again."
-  when: ansible_distribution == "Parrot OS" and parrotos_zypper_removed is defined and not parrotos_zypper_removed.failed
+- name: General | Software | Packages | pacman
+  block:
 
-- name: General | Software | Packages | Fix Parrot OS (zypper), Exiting
-  ansible.builtin.shell: exit 1
-  when: ansible_distribution == "Parrot OS" and parrotos_zypper_removed is defined and not parrotos_zypper_removed.failed
+    - name: General | Software | Packages | pacman | pacman.conf
+      ansible.builtin.lineinfile:
+        path: "/etc/pacman.conf"
+        regexp: '{{ item.key }}'
+        line: '{{ item.value }}'
+        state: present
+        create: true
+        backup: true
+        mode: "0644"
+      loop:
+        - { "key": '^[\#]?ParallelDownloads', "value": 'ParallelDownloads = 3'}
 
-# More Parrot OS junk. They have a command called update in /usr/bin. Doesn't
-# have sudo or anything in it. Hide it in preference for .bashrc update function.
-- name: General | Software | Packages | Fix Parrot OS 2 (update)
-  ansible.builtin.shell: "mv `which update` `which update`.zz.`date +%Y%m%d`"
-  ignore_errors: true
-  when: ansible_distribution == "Parrot OS"
+    # TBD / TODO: Do the mirrorlist files and distros based on facts in case ever using Arch, Manjaro, etc.
+    # Same with the blocklist for sites like Berkeley which rate limit VPNs.
+    - name: General | Software | Packages | pacman | Artix
+      block:
 
+        - name: General | Software | Packages | pacman | Artix | rate-mirrors | Install
+          ansible.builtin.package:
+            name:
+              - rate-mirrors
+            state: present
+
+        - name: General | Software | Packages | pacman | Artix | rate-mirrors | Update Lists
+          ansible.builtin.shell: |
+            set -o pipefail
+            {{ item }}
+          register: shell_check
+          changed_when: shell_check.rc == 0
+          loop:
+            - "sudo -u {{ user }} rate-mirrors artix | grep -v berkeley | tee /etc/pacman.d/mirrorlist"
+            - "sudo -u {{ user }} rate-mirrors arch  | grep -v berkeley | tee /etc/pacman.d/mirrorlist-arch"
+
+      when: ansible_service_mgr == "runit"
+
+  when: ansible_pkg_mgr == "pacman"
 
 - name: General | Software | Packages | Cache Refresh (Apt and Pacman)
   ansible.builtin.package:
@@ -35,6 +82,8 @@
 
 - name: General | Software | Packages | Cache Refresh (FreeBSD)
   ansible.builtin.shell: pkg update
+  register: shell_check
+  changed_when: shell_check.rc == 0
   when: ansible_system == "FreeBSD"
 
 - name: General | Software | Packages | Install Software

tasks/workstation/linux/software/ai/llm.yml

@@ -211,9 +211,9 @@
     - name: Workstation | Linux | Software | LLMs | Facts | Choices | Sort
       ansible.builtin.set_fact:
         llm_installs: >-
-          {{ llm_choices | selectattr('size_mb', 'le', ansible_memtotal_mb) | list }}
+          {{ llm_installs | union(llm_choices | selectattr('size_mb', 'le', ansible_memtotal_mb) | list) }}
         llm_removals: >-
-          {{ llm_choices | selectattr('size_mb', 'gt', ansible_memtotal_mb) | list }}
+          {{ llm_removals | union(llm_choices | selectattr('size_mb', 'gt', ansible_memtotal_mb) | list) }}
 
     - name: Workstation | Linux | Software | LLMs | Facts | Merge | Print
       ansible.builtin.debug:
@@ -495,6 +495,17 @@
 
         # Open Terminal - Start #
 
+        - name: Workstation | Linux | Software | LLMs | Sandbox
+          ansible.builtin.import_tasks: tasks/workstation/linux/software/ai/sandbox.yml
+
+        - name: Workstation | Linux | Software | LLMs | runit | open-terminal | Facts
+          ansible.builtin.set_fact:
+            jdk_jvm: "{{ jdk_jvm | default('/usr/lib/jvm') }}"
+            jdk_etc:   "{{ jdk_etc   | default('/etc/java-openjdk') }}"
+            jdk_etc17: "{{ jdk_etc17 | default('/etc/java17-openjdk') }}"
+            jdk_etc21: "{{ jdk_etc21 | default('/etc/java21-openjdk') }}"
+            jdk_etc25: "{{ jdk_etc25 | default('/etc/java25-openjdk') }}"
+
         - name: Workstation | Linux | Software | LLMs | runit | open-terminal | Dir | /etc/sv
           ansible.builtin.file:
             name: "/etc/sv/open-terminal/log"
@@ -516,320 +527,6 @@
             owner: root
             mode: "0755"
 
-        - name: Workstation | Linux | Software | LLMs | runit | open-terminal | AI-Sandbox | Dir
-          ansible.builtin.file:
-            dest: "{{ user_user.home }}/AI-Sandbox"
-            state: directory
-            owner: "{{ user }}"
-            group: "{{ user }}"
-            mode: "0755"
-
-        - name: Workstation | Linux | Software | LLMs | runit | open-terminal | AI-Sandbox | Env
-          ansible.builtin.blockinfile:
-            path: "{{ user_user.home }}/AI-Sandbox/{{ item }}"
-            marker: "# {mark} | MANAGE BY ANSIBLE | Env Vars"
-            content: |
-              if [[ -d "$HOME/bin" ]]; then
-                export PATH="$HOME/bin:$PATH"
-              fi
-
-              export ANDROID_HOME="{{ user_user.home }}/SDKs/Android/Sdk"
-              export GRADLE_USER_HOME={{ user_user.home }}/.gradle
-              export PATH="$ANDROID_HOME/platform-tools:$PATH"
-              export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
-
-              export FLUTTER_HOME="{{ user_user.home }}/SDKs/Flutter/flutter"
-              export PUB_CACHE={{ user_user.home }}/.pub-cache
-              export PATH="$FLUTTER_HOME/bin:$PATH"
-
-              export JAVA_HOME="{{ user_user.home }}/SDKs/Java"
-              export PATH="$JAVA_HOME/bin:$PATH"
-            create: false
-            backup: false
-            owner: "{{ user }}"
-            group: "{{ user }}"
-            mode: "0755"
-          loop:
-            - ".bashrc"
-
-        - name: Workstation | Linux | Software | LLMs | runit | open-terminal | AI-Sandbox | Defaults
-          ansible.builtin.set_fact:
-            jdk_jvm: "{{ jdk_jvm | default('/usr/lib/jvm') }}"
-            jdk_etc:   "{{ jdk_etc   | default('/etc/java-openjdk') }}"
-            jdk_etc17: "{{ jdk_etc17 | default('/etc/java17-openjdk') }}"
-            jdk_etc21: "{{ jdk_etc21 | default('/etc/java21-openjdk') }}"
-            jdk_etc25: "{{ jdk_etc25 | default('/etc/java25-openjdk') }}"
-
-        - name: Workstation | Linux | Software | LLMs | runit | open-terminal | AI-Sandbox | AGENTS.md
-          ansible.builtin.copy:
-            dest: "{{ user_user.home }}/AI-Sandbox/AGENTS.md"
-            content: |
-              # Environment
-
-              You are running in a Docker container called Open Terminal. We are
-              communicating via Open WebUI, also being run in a Docker
-              container. You are the user `user` and have been granted access to
-              the designer's Code and SDKs via mount at `{{ user_user.home }}`.
-
-              Host system is typically (but not always) a systemd-free distro
-              such as Artix or Devuan. User likes the `runit` service manager.
-              `elogind` is used rather than systemd's logind. Desktop is i3 and
-              display manager is lightdm. Servers are run on Debian and Docker
-              containers are typically debian:trixie-slim with a Dockerfile
-              called by compose.yml which adds the necessary packages, sometimes
-              building from source if the Debian executable is too old.
-
-              If the `$GOT_EM` environment variable is `true` then all the
-              necessary packages for compiling Android and Flutter were
-              installed. If it is `false` then they were not installed, and
-              compiling will fail. Please check this before trying and alert me
-              if they need added. If we don't have Internet, then ask me to
-              compile or run whatever command is needed on the host system.
-
-              # Rules
-
-              Never use any `git` subcommands that change the repo, including
-              but not limited to `add`, `commit`, `pull`, `push`, `branch`,
-              `switch`, etc. The user is who controls the respository changes.
-              You may use informational git subcommands such as `git status`,
-              and may occasionally be asked to run `git clone` type commands.
-
-              If any programs need installed in order to work on a project, we
-              need to document that in an `install.sh` script, as well as add it
-              to `~/PACKAGES.txt` so that we can ensure they stay installed.
-              `install.sh` scripts should be for both `apt` systems (Debian,
-              Ubuntu) and pacman system (Arch, Artix). using distribution
-              package managers is preferable over `pip` and `npm` when
-              possible, unless the project is actually Python or Node.js.
-
-              The user manages the `{{ user_user.home }}/SDKs` directory. Do not
-              modify it. Instead, ask if anything needs updated or added.
-
-              Never manually edit, modify, delete, alter, replace, etc any
-              files under system folders such as `/usr`. Anything under `/` is
-              managed by the system. If you need assistance changing anything
-              such as `/usr/lib/jvm`, please ask the user and halt all further
-              operations until you have received feedback.
-
-              # Effort
-
-              It is never okay to brute force a solution if something is not
-              working well. it is better to ask the user for assistance or alert
-              them that you've encountered blockers and then cease the process
-              until you've received feedback. This especially relates to when
-              system errors occur which are not related to the source code, such
-              as a compiler failing to be found or an SDK version mismatch. If
-              the error is with the source code though, troubleshooting and code
-              changes should continue until the program is compiling properly.
-
-              For CLI projects such as script languages, the final result should
-              always be tested both to run successfully and have the proper
-              output. All test cases should be analyzed and walked through,
-              which will help ensure all the requirements have been met.
-
-              For GUI programs (such as Android, Flutter, Kotlin Multiplatform,
-              Kivy, etc), the project should be tested to both compile & build
-              successfully and also generate the proper installation file (APK,
-              Linux Bundle). Once that is confirmed, the user/desginer will test
-              that the application meets the proper requirements.
-
-              # Preferences
-
-              You have free reign over your home directory. Feel free to
-              create memory files or anything else which would benefit you.
-
-              Everything we create should have both Desktop Linux and Android
-              in mind. Windows, MacOS, and iOS will never be compiled for, but
-              if we can do things in a way which makes it easy for others to
-              fork the project and add the support themselves, then that's best.
-
-              # Versions
-
-              These are the versions of plugins and languages we need to use.
-              If you know of an important upgrade from them, please let me know.
-
-              ## Android / Flutter
-
-              - Gradle 9.8.2
-              - AGP 9.5.0
-              - Kotlin 2.4.21
-              - Java JDK 17
-              - Flutter Plugin Loader 1.0.0
-              - compileSdk 37
-              - targetSDK 37
-
-              Regardless of whether AGP bundles Kotlin, we need to specify it to
-              avoid things like "Your project's Kotlin version (2.2.10) is lower
-              than Flutter's minimum supported version of 2.2.20. Please upgrade
-              your Kotlin version." This is exactly why we use these versions,
-              plus it helps document what's actually being used over guessing.
-
-              Only the arm-v8a architecture needs included in the release
-              builds. x86 and others should continue to exist in the debug run.
-              This will help save space on local servers like Gitea and F-Droid.
-              If code for this does not exist, please add splitting or filtering
-              so that when the designer generates a signed APK it's only v8a.
-
-              Android : paths are from the project root.
-              Flutter : paths are under the folder `android`.
-
-              ### All Android Project Types
-
-              #### ./gradle/wrapper/grade-wrapper.properties
-
-              ```
-              distributionUrl=https\://services.gradle.org/distributions/gradle-9.8.2-bin.zip
-              ```
-
-              #### ./settings.gradle.kts
-
-              ```
-              id("com.android.application") version "9.5.0" apply false
-              id("org.jetbrains.kotlin.android") version "2.4.21" apply false
-              ```
-
-              #### ./app/build.gradle.kts
-
-              ```
-              compileOptions {
-                sourceCompatibility = JavaVersion.VERSION_17
-                targetCompatibility = JavaVersion.VERSION_17
-              }
-              kotlin {
-                compilerOptions {
-                  jvmTarget.set(JvmTarget.JVM_17)
-                }
-              }
-              ```
-
-              Also enable minify and shrink while in there.
-
-              ```
-              buildTypes {
-                getByName("release") {
-                  ...
-                  isMinifyEnabled = true
-                  isShrinkResources = true
-                  proguardFiles(
-                      getDefaultProguardFile("proguard-android-optimize.txt"),
-                      "proguard-rules.pro"
-                  )
-                }
-              }
-              ```
-
-              ### Flutter Projects
-
-              #### ./settings.gradle.kts
-
-              ```
-              id("dev.flutter.flutter-plugin-loader") version "1.0.0"
-              ```
-
-              ### Native Kotlin Apps
-
-              These only apply to Android apps which are not Flutter, Kivy, etc.
-
-              #### Plugin Versions
-
-              ##### ./gradle/libs.versions.toml
-
-              ```
-              [versions]
-              agp = "9.5.0"
-              kotlin = "2.4.21"
-              coreKtx = "1.19.1"
-              junit = "4.13.2"
-              junitVersion = "1.3.0"
-              espressoCore = "3.7.0"
-              lifecycleRuntimeKtx = "2.11.0"
-              activityCompose = "1.13.0"
-              composeBom = "2026.09.00"
-              ```
-
-              #### Kotlin Compose Fix
-
-              Also ensure Kotlin is coming from Compose and not Jetbrains.
-
-              ##### ./gradle/libs.versions.toml
-
-              ```
-              [plugins]
-              androidApplication = { id = "com.android.application", version.ref = "agp" }
-              #jetbrainsKotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
-              kotlinCompose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
-              ```
-
-              ##### ./build.gradle.kts
-
-              ```
-              plugins {
-                alias(libs.plugins.androidApplication) apply false
-                //alias(libs.plugins.jetbrainsKotlinAndroid) apply false
-                alias(libs.plugins.kotlinCompose) apply false
-              }
-              ```
-
-              ##### ./app/build.gradle.kts
-
-              ```
-              plugins {
-                alias(libs.plugins.androidApplication)
-                //alias(libs.plugins.jetbrainsKotlinAndroid)
-                alias(libs.plugins.kotlinCompose)
-              }
-              ```
-
-              # Build Processes
-
-              How to compile certain projects. Tools to prefer. If a language
-              or framework is not mentioned, then use the typical commands.
-
-              ## Kotlin Multiplatform (KMP)
-
-              Used to create small native Android apps with the ability to also
-              run against Desktop Linux. APK size is the greatest benefit for
-              using KMP over something like Flutter or KivyMD.
-
-              ### Kotlin Toolchain
-
-              This is the preferred build type when setting up new projects.
-
-              Please use `kotlin` rather than any `amper` commands. `amper` has
-              been deprecated and is intentionally not present on the system.
-              Examples:
-
-              ```
-              # 1. Compile + link ALL targets (JVM, iOS, Android, native, etc.)
-              ./kotlin build
-
-              # 2. (Optional) Run tests across all targets
-              ./kotlin test
-
-              # 3. (Optional) Run all quality checks (tests + registered linters)
-              ./kotlin check
-              ```
-
-              ### Gradle KMP
-
-              This is a legacy method, new projects will not be set up with it.
-              Examples:
-
-              ```
-              # Compile all targets
-              ./gradlew assemble
-
-              # Or more explicitly (if you want to be sure nothing is skipped):
-              ./gradlew jvmJar assembleDebug assembleIosSimulatorArm64  # etc. per target
-
-              # Run all tests
-              ./gradlew allTests
-              ```
-            backup: false
-            owner: "{{ user }}"
-            group: "{{ user }}"
-            mode: "0755"
-
         - name: Workstation | Linux | Software | LLMs | runit | open-terminal | Script | Compose YAML
           ansible.builtin.copy:
             dest: /usr/local/etc/open-terminal/compose.yml

tasks/workstation/linux/software/ai/sandbox.yml

@@ -0,0 +1,496 @@
+---
+# Move the plays related to AGENTS.md to its own file since it is now so large.
+
+- name: Workstation | Linux | Software | AI | Sandbox | Dir
+  ansible.builtin.file:
+    dest: "{{ user_user.home }}/AI-Sandbox"
+    state: directory
+    owner: "{{ user }}"
+    group: "{{ user }}"
+    mode: "0755"
+
+- name: Workstation | Linux | Software | AI | Sandbox | Env
+  ansible.builtin.blockinfile:
+    path: "{{ user_user.home }}/AI-Sandbox/{{ item }}"
+    marker: "# {mark} | MANAGE BY ANSIBLE | Env Vars"
+    content: |
+      if [[ -d "$HOME/bin" ]]; then
+        export PATH="$HOME/bin:$PATH"
+      fi
+
+      export ANDROID_HOME="{{ user_user.home }}/SDKs/Android/Sdk"
+      export GRADLE_USER_HOME={{ user_user.home }}/.gradle
+      export PATH="$ANDROID_HOME/platform-tools:$PATH"
+      export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
+
+      export FLUTTER_HOME="{{ user_user.home }}/SDKs/Flutter/flutter"
+      export PUB_CACHE={{ user_user.home }}/.pub-cache
+      export PATH="$FLUTTER_HOME/bin:$PATH"
+
+      export JAVA_HOME="{{ user_user.home }}/SDKs/Java"
+      export PATH="$JAVA_HOME/bin:$PATH"
+    create: true
+    backup: false
+    owner: "{{ user }}"
+    group: "{{ user }}"
+    mode: "0755"
+  loop:
+    - ".bashrc"
+
+- name: Workstation | Linux | Software | AI | Sandbox | AGENTS.md
+  ansible.builtin.copy:
+    dest: "{{ user_user.home }}/AI-Sandbox/AGENTS.md"
+    content: |
+      # Environment
+
+      You are running in a Docker container called Open Terminal. We are
+      communicating via Open WebUI, also being run in a Docker
+      container. You are the user `user` and have been granted access to
+      the designer's Code and SDKs via mount at `{{ user_user.home }}`.
+
+      Host system is typically (but not always) a systemd-free distro
+      such as Artix or Devuan. User likes the `runit` service manager.
+      `elogind` is used rather than systemd's logind. Desktop is i3 and
+      display manager is lightdm. Servers are run on Debian and Docker
+      containers are typically debian:trixie-slim with a Dockerfile
+      called by compose.yml which adds the necessary packages, sometimes
+      building from source if the Debian executable is too old.
+
+      If the `$GOT_EM` environment variable is `true` then all the
+      necessary packages for compiling Android and Flutter were
+      installed. If it is `false` then they were not installed, and
+      compiling will fail. Please check this before trying and alert me
+      if they need added. If we don't have Internet, then ask me to
+      compile or run whatever command is needed on the host system.
+
+      # Rules
+
+      Never use any `git` subcommands that change the repo, including
+      but not limited to `add`, `commit`, `pull`, `push`, `branch`,
+      `switch`, etc. The user is who controls the respository changes.
+      You may use informational git subcommands such as `git status`,
+      and may occasionally be asked to run `git clone` type commands.
+
+      If any programs need installed in order to work on a project, we
+      need to document that in an `install.sh` script, as well as add it
+      to `~/PACKAGES.txt` so that we can ensure they stay installed.
+      `install.sh` scripts should be for both `apt` systems (Debian,
+      Ubuntu) and pacman system (Arch, Artix). using distribution
+      package managers is preferable over `pip` and `npm` when
+      possible, unless the project is actually Python or Node.js.
+
+      The user manages the `{{ user_user.home }}/SDKs` directory. Do not
+      modify it. Instead, ask if anything needs updated or added.
+
+      Never manually edit, modify, delete, alter, replace, etc any
+      files under system folders such as `/usr`. Anything under `/` is
+      managed by the system. If you need assistance changing anything
+      such as `/usr/lib/jvm`, please ask the user and halt all further
+      operations until you have received feedback.
+
+      # Effort
+
+      It is never okay to brute force a solution if something is not
+      working well. it is better to ask the user for assistance or alert
+      them that you've encountered blockers and then cease the process
+      until you've received feedback. This especially relates to when
+      system errors occur which are not related to the source code, such
+      as a compiler failing to be found or an SDK version mismatch. If
+      the error is with the source code though, troubleshooting and code
+      changes should continue until the program is compiling properly.
+
+      For CLI projects such as script languages, the final result should
+      always be tested both to run successfully and have the proper
+      output. All test cases should be analyzed and walked through,
+      which will help ensure all the requirements have been met.
+
+      For GUI programs (such as Android, Flutter, Kotlin Multiplatform,
+      Kivy, etc), the project should be tested to both compile & build
+      successfully and also generate the proper installation file (APK,
+      Linux Bundle). Once that is confirmed, the user/desginer will test
+      that the application meets the proper requirements.
+
+      # Preferences
+
+      You have free reign over your home directory. Feel free to
+      create memory files or anything else which would benefit you.
+
+      Everything we create should have both Desktop Linux and Android
+      in mind. Windows, MacOS, and iOS will never be compiled for, but
+      if we can do things in a way which makes it easy for others to
+      fork the project and add the support themselves, then that's best.
+
+      # Versions
+
+      These are the versions of plugins and languages we need to use.
+      If you know of an important upgrade from them, please let me know.
+
+      If you find that an application is already a newer version than
+      those listed here, that is acceptable, never attempt to downgrade
+      without explicitly asking the user first and having a good reason.
+
+      ## Android / Flutter
+
+      - Gradle 9.8.2
+      - AGP 9.5.0
+      - Kotlin 2.4.21
+      - Java JDK 17
+      - Flutter Plugin Loader 1.0.0
+      - compileSdk 37
+      - targetSDK 37
+
+      Regardless of whether AGP bundles Kotlin, we need to specify it to
+      avoid things like "Your project's Kotlin version (2.2.10) is lower
+      than Flutter's minimum supported version of 2.2.20. Please upgrade
+      your Kotlin version." This is exactly why we use these versions,
+      plus it helps document what's actually being used over guessing.
+
+      Only the arm-v8a architecture needs included in the release
+      builds. x86 and others should continue to exist in the debug run.
+      This will help save space on local servers like Gitea and F-Droid.
+      If code for this does not exist, please add splitting or filtering
+      so that when the designer generates a signed APK it's only v8a.
+
+      Android : paths are from the project root.
+      Flutter : paths are under the folder `android`.
+
+      ### All Android Project Types
+
+      #### ./gradle/wrapper/grade-wrapper.properties
+
+      ```
+      distributionUrl=https\://services.gradle.org/distributions/gradle-9.8.2-bin.zip
+      ```
+
+      #### ./settings.gradle.kts
+
+      ```
+      id("com.android.application") version "9.5.0" apply false
+      id("org.jetbrains.kotlin.android") version "2.4.21" apply false
+      ```
+
+      #### ./app/build.gradle.kts
+
+      ```
+      compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+      }
+      kotlin {
+        compilerOptions {
+          jvmTarget.set(JvmTarget.JVM_17)
+        }
+      }
+      ```
+
+      Also enable minify and shrink while in there.
+
+      ```
+      buildTypes {
+        getByName("release") {
+          ...
+          isMinifyEnabled = true
+          isShrinkResources = true
+          proguardFiles(
+              getDefaultProguardFile("proguard-android-optimize.txt"),
+              "proguard-rules.pro"
+          )
+        }
+      }
+      ```
+
+      ### Flutter Projects
+
+      #### ./settings.gradle.kts
+
+      ```
+      id("dev.flutter.flutter-plugin-loader") version "1.0.0"
+      ```
+
+      ### Native Kotlin Apps
+
+      These only apply to Android apps which are not Flutter, Kivy, etc.
+
+      #### Plugin Versions
+
+      ##### ./gradle/libs.versions.toml
+
+      ```
+      [versions]
+      agp = "9.5.0"
+      kotlin = "2.4.21"
+      coreKtx = "1.19.1"
+      junit = "4.13.2"
+      junitVersion = "1.3.0"
+      espressoCore = "3.7.0"
+      lifecycleRuntimeKtx = "2.11.0"
+      activityCompose = "1.13.0"
+      composeBom = "2026.09.00"
+      ```
+
+      #### Kotlin Compose Fix
+
+      Also ensure Kotlin is coming from Compose and not Jetbrains.
+
+      ##### ./gradle/libs.versions.toml
+
+      ```
+      [plugins]
+      androidApplication = { id = "com.android.application", version.ref = "agp" }
+      #jetbrainsKotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
+      kotlinCompose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
+      ```
+
+      ##### ./build.gradle.kts
+
+      ```
+      plugins {
+        alias(libs.plugins.androidApplication) apply false
+        //alias(libs.plugins.jetbrainsKotlinAndroid) apply false
+        alias(libs.plugins.kotlinCompose) apply false
+      }
+      ```
+
+      ##### ./app/build.gradle.kts
+
+      ```
+      plugins {
+        alias(libs.plugins.androidApplication)
+        //alias(libs.plugins.jetbrainsKotlinAndroid)
+        alias(libs.plugins.kotlinCompose)
+      }
+      ```
+
+      # Build Processes
+
+      How to compile certain projects. Tools to prefer. If a language
+      or framework is not mentioned, then use the typical commands.
+
+      ## Kotlin Multiplatform (KMP)
+
+      Used to create small native Android apps with the ability to also
+      run against Desktop Linux. APK size is the greatest benefit for
+      using KMP over something like Flutter or KivyMD.
+
+      ### Kotlin Toolchain
+
+      This is the preferred build type when setting up new projects.
+
+      Please use `kotlin` rather than any `amper` commands. `amper` has
+      been deprecated and is intentionally not present on the system.
+      Examples:
+
+      ```
+      # 1. Compile + link ALL targets (JVM, iOS, Android, native, etc.)
+      ./kotlin build
+
+      # 2. (Optional) Run tests across all targets
+      ./kotlin test
+
+      # 3. (Optional) Run all quality checks (tests + registered linters)
+      ./kotlin check
+      ```
+
+      ### Gradle KMP
+
+      This is a legacy method, new projects will not be set up with it.
+      Examples:
+
+      ```
+      # Compile all targets
+      ./gradlew assemble
+
+      # Or more explicitly (if you want to be sure nothing is skipped):
+      ./gradlew jvmJar assembleDebug assembleIosSimulatorArm64  # etc. per target
+
+      # Run all tests
+      ./gradlew allTests
+      ```
+
+      # Coding Conventions
+
+      Preferences related to how code should be written.
+
+      ## All languages
+
+      If a value is going to be used more than once, even a small path or file
+      name, it should exist in a variable.
+
+      Relative shebangs such as `#!/usr/bin/env bash` and `#!/usr/bin/env node`
+      are always preferred over static shebangs such as `#!/bin/bash`, since
+      scripts are run across a multitude of different systems.
+
+      ### Layout
+
+      Programs should be laid out in 5 sections.
+
+      - Variables
+          - Instantiate global variables and defaults used for parameters which
+          do not get passed an explicit value by the user.
+      - Functions
+          - Functions to be used throughout the program, including the Usage.
+      - Parameters / Validation
+          - Parse the parameters, validate the input, and assign any defaults.
+      - Main
+          - The primary logic of the program, completes the task at hand.
+      - Finish / Cleanup
+          - Typically just `exit 0`, but sometimes a summary of what was done.
+
+      All sections may not always apply, such as with Hugo websites. With
+      projects like Android apps this would apply to each individual function,
+      method, and class. If a section does not need anything, it can be blank.
+
+      ```
+      public static void doThing(String thingName) {
+        // Variables //
+        String thingPrefix = "/place/for/thing/"
+
+        // Functions //
+
+        // Parameters //
+        if (thingName.isEmpty) {
+          Exception e = new Exception("No name passed!");
+          throw e;
+        }
+
+        // Main //
+        runStuff(thingPrefix + thingName);
+
+        // Finish //
+      }
+      ```
+
+      The comments do not need to be included, this example is just as valid,
+      what maytters most is that the 5 section are done in order rather than
+      instantiating variable mid-scope.
+
+      ```
+      public static void doThing(String thingName) {
+        String thingPrefix = "/place/for/thing/"
+
+        if (thingName.isEmpty) {
+          Exception e = new Exception("No name passed!");
+          throw e;
+        }
+
+        runStuff(thingPrefix + thingName);
+      }
+      ```
+
+      `if` statements and loops start new scope, so they also need the layout
+      applied to them. Loops may sometimes require a variable assignment before
+      it begins which is completely okay and does not break the layout rule.
+      This example has a Variables, Validation, Main, and Finish section without
+      the use of labels or comments since the code itself is simple and small.
+
+      ```
+      count=0
+      array="cats dogs giraffes rhinos horses"
+      last_animal=""
+      for animal in $array; do
+        if (( count >= 3 )); then
+          echo "That's enough! We finished at the ${last_animal}."
+          break;
+        fi
+
+        echo "We're looking at ${animal}."
+
+        last_animal=$animal
+        (( count++ ))
+      done
+      ```
+
+      Providing the user's input in error messages is really helpful and can aid
+      their troubleshooting if things are not going according to expectations.
+
+      Example using Bash:
+
+      ```
+      #!/usr/bin/env bash
+
+      ### Variables ###
+
+      declare A B
+      typeset -i a b
+
+      ### Functions ###
+
+      function usage() {
+        status="$1"
+        cat << EOF
+      Usage: add.sh -a NUM -b NUM [-h]
+
+        Adds two numbers and prints out the full equation.
+
+      Example:
+
+        $ add.sh -a 5 -b 25
+        5 + 25 = 30
+      EOF
+        exit $status
+      }
+      function add() {
+        num1="$1"
+        num2="$2"
+        sum=""
+
+        if [[ -z $num1 || -z $num2 ]]; then
+          echo "ERROR: Two numnbers must be passed."
+        fi
+
+        sum=$(( num1 + num2 ))
+        echo "${num1} + ${num2} = ${sum}"
+      }
+
+      ### Parameters ###
+
+      while getopts ':a:b:h' opt; do
+        case $opt in
+          a) A="$OPTARG" ;;
+          b) B="$OPTARG" ;;
+          h) usage 0 ;;
+          *) echo "ERROR: Option $OPTARG not recognized." >&2 && usage 1 ;;
+        esac
+      done
+
+      if [[ -z "$A" || -z "$B" ]]; then
+        echo "ERROR: Both numbers need to be passed. A=${A} B=${B}" >&2
+        usage 2
+      fi
+      a="$A" b="$B"
+      if [[ "$a" != "$A" || "$b" != "$B" ]]; then
+        echo "ERROR: Values contain non-numeric data, please try again." >&2
+        echo "A=${A} B=${B}" >&2
+        usage 3
+      fi
+
+      ### Main ###
+
+      add "$a" "$b"
+
+      ### Finish ###
+
+      unset A B usage add
+      exit 0
+      ```
+
+      ## Bash
+
+      `[[ ]]` are preferred over `[ ]`, `test`, etc. `(( ))` are always fine.
+
+      When defining a function please use both the keyword `function` as well as
+      the `()`, such as `function myfunc() {}`.
+
+      When instantiating global variables, please use `typeset` or `declare`
+      rather than just `VAR1=""; VAR2=""`, such as:
+
+      ```
+      declare VAR1="" VAR2="" BOOL="true" BOOL2="false"
+      typeset -i INT1=0 INT2=99
+      ```
+
+      When doing colored output, `tput` is always preferred over literal values.
+    backup: false
+    owner: "{{ user }}"
+    group: "{{ user }}"
+    mode: "0755"

tasks/workstation/linux/software/android.yml

@@ -205,6 +205,15 @@
 - name: Workstation | Linux | Software | Android | SDK
   block:
 
+    - name: Workstation | Linux | Software | Android | Gradle Permissions
+      ansible.builtin.file:
+        path: "{{ user_user.home }}/.gradle"
+        state: directory
+        owner: "{{ user }}"
+        group: "{{ user }}"
+        mode: "0755"
+      when: user_user.home != ""
+
     - name: Workstation | Linux | Software | Android | Download Commandline Tools
       ansible.builtin.get_url:
         url: "{{ android_url }}"

tasks/workstation/linux/software/docker.yml

@@ -81,7 +81,7 @@
           done
         backup: false
         owner: root
-        mode: '0644'
+        mode: '0755'
 
     - name: Workstation | Linux | Software | Docker | Network Sync | runit | Finish
       ansible.builtin.copy:

tasks/workstation/linux/software/flutter.yml

@@ -46,116 +46,123 @@
     get_mime: false
   register: flutter_download_stat
 
-## Packages ##
-
-- name: Workstation | Linux | Software | Flutter | Necessities
-  ansible.builtin.package:
-    name:
-      - curl
-      - git
-      - unzip
-      - "{{ xz }}"
-      - zip
-      - "{{ mesa }}"
-      - "{{ mesa_utils }}"
-    state: present
-  when: coding
-
-# https://docs.flutter.dev/get-started/install/linux/desktop
-- name: Workstation | Linux | Software | Flutter | Linux App Dependencies
-  ansible.builtin.package:
-    name:
-      - clang
-      - cmake
-      - git
-      - "{{ ninja }}"
-      - pkg-config
-      - "{{ gtk3 }}"
-      - "{{ xz_libs }}"
-      - "{{ cpp }}"
-    state: present
-  when: coding
-
-# https://docs.flutter.dev/get-started/install/linux/android
-- name: Workstation | Linux | Software | Flutter | Android App Dependencies
-  ansible.builtin.package:
-    name:
-      - "{{ c_libs }}"
-      - "{{ cpp_libs }}"
-      - "{{ z_libs }}"
-      - "{{ bzip }}"
-    state: present
-  when: coding
-
-## Install SDK ##
-
-- name: Workstation | Linux | Software | Flutter | SDK
+- name: Workstation | Linux | Software | Flutter | Install Block
   block:
 
-    - name: Workstation | Linux | Software | Flutter | Download SDK
-      ansible.builtin.get_url:
-        url: "{{ flutter_url }}"
-        dest: "{{ flutter_download_file }}"
-        owner: "{{ user }}"
-        group: "{{ user }}"
-        mode: '0664'
-      when: not flutter_download_stat.stat.exists
+    ## Packages ##
 
-    - name: Workstation | Linux | Software | Flutter | Create Folder
+    - name: Workstation | Linux | Software | Flutter | Necessities
+      ansible.builtin.package:
+        name:
+          - curl
+          - git
+          - unzip
+          - "{{ xz }}"
+          - zip
+          - "{{ mesa }}"
+          - "{{ mesa_utils }}"
+        state: present
+
+    # https://docs.flutter.dev/get-started/install/linux/desktop
+    - name: Workstation | Linux | Software | Flutter | Linux App Dependencies
+      ansible.builtin.package:
+        name:
+          - clang
+          - cmake
+          - git
+          - "{{ ninja }}"
+          - pkg-config
+          - "{{ gtk3 }}"
+          - "{{ xz_libs }}"
+          - "{{ cpp }}"
+        state: present
+
+    # https://docs.flutter.dev/get-started/install/linux/android
+    - name: Workstation | Linux | Software | Flutter | Android App Dependencies
+      ansible.builtin.package:
+        name:
+          - "{{ c_libs }}"
+          - "{{ cpp_libs }}"
+          - "{{ z_libs }}"
+          - "{{ bzip }}"
+        state: present
+
+    ## Install SDK ##
+
+    - name: Workstation | Linux | Software | Flutter | SDK
+      block:
+
+        - name: Workstation | Linux | Software | Flutter | Pub Cache Permissions
+          ansible.builtin.file:
+            path: "{{ user_user.home }}/.pub-cache"
+            state: directory
+            owner: "{{ user }}"
+            group: "{{ user }}"
+            mode: "0755"
+          when: user_user.home != ""
+
+        - name: Workstation | Linux | Software | Flutter | Download SDK
+          ansible.builtin.get_url:
+            url: "{{ flutter_url }}"
+            dest: "{{ flutter_download_file }}"
+            owner: "{{ user }}"
+            group: "{{ user }}"
+            mode: '0664'
+          when: not flutter_download_stat.stat.exists
+
+        - name: Workstation | Linux | Software | Flutter | Create Folder
+          ansible.builtin.file:
+            path: "{{ flutter_sdk_location }}"
+            state: directory
+            owner: "{{ user }}"
+            group: "{{ user }}"
+            mode: '0755'
+
+        - name: Workstation | Linux | Software | Flutter | Extract SDK
+          ansible.builtin.unarchive:
+            src: "{{ flutter_download_file }}"
+            dest: "{{ flutter_sdk_location }}"
+            owner: "{{ user }}"
+            group: "{{ user }}"
+
+      become: true
+      become_user: "{{ user }}"
+      when: not flutter_sdk_stat.stat.exists
+
+    - name: Workstation | Linux | Software | Flutter | Delete Archive
       ansible.builtin.file:
-        path: "{{ flutter_sdk_location }}"
-        state: directory
-        owner: "{{ user }}"
-        group: "{{ user }}"
-        mode: '0755'
+        path: "{{ flutter_download_file }}"
+        state: absent
 
-    - name: Workstation | Linux | Software | Flutter | Extract SDK
-      ansible.builtin.unarchive:
-        src: "{{ flutter_download_file }}"
-        dest: "{{ flutter_sdk_location }}"
-        owner: "{{ user }}"
-        group: "{{ user }}"
+    ## Configure Environment ##
 
-  become: true
-  become_user: "{{ user }}"
-  when: coding
-    and not flutter_sdk_stat.stat.exists
+    - name: Workstation | Linux | Software | Flutter | Modify PATH (profiles)
+      ansible.builtin.blockinfile:
+        path: "{{ user_user.home }}/{{ item }}"
+        block: |
+          export FLUTTER_HOME="{{ flutter_home }}"
+          export PATH="{{ flutter_bin }}:$PATH"
+        marker: '# {mark} MANAGED BY ANSIBLE | Flutter'
+        state: present
+        create: true
+        backup: true
+        mode: "0755"
+      loop:
+        - ".bash_profile"
+        - ".zprofile"
+        - ".profile"
+      when: user_user.home != ""
 
-- name: Workstation | Linux | Software | Flutter | Delete Archive
-  ansible.builtin.file:
-    path: "{{ flutter_download_file }}"
-    state: absent
-  when: coding
+    ## Test SDK ##
 
-## Configure Environment ##
+    - name: Workstation | Linux | Software | Flutter | Doctor Report
+      ansible.builtin.shell: "{{ item }}"
+      loop: "{{ flutter_report_commands }}"
+      become: true
+      become_user: "{{ user }}"
+      register: shell_check
+      changed_when: shell_check.rc == 0
 
-- name: Workstation | Linux | Software | Flutter | Modify PATH (profiles)
-  ansible.builtin.blockinfile:
-    path: "{{ user_user.home }}/{{ item }}"
-    block: |
-      export FLUTTER_HOME="{{ flutter_home }}"
-      export PATH="{{ flutter_bin }}:$PATH"
-    marker: '# {mark} MANAGED BY ANSIBLE | Flutter'
-    state: present
-    create: true
-    backup: true
-    mode: "0755"
-  loop:
-    - ".bash_profile"
-    - ".zprofile"
-    - ".profile"
-  when: coding
-    and user_user.home != ""
-
-## Test SDK ##
-
-- name: Workstation | Linux | Software | Flutter | Doctor Report
-  ansible.builtin.shell: "{{ item }}"
-  loop: "{{ flutter_report_commands }}"
-  become: true
-  become_user: "{{ user }}"
-  register: shell_check
-  changed_when: shell_check.rc == 0
   when: coding
 
 ## Uninstall SDK ##

test.yml

@@ -21,12 +21,6 @@
     - name: TEST | LLMs
       block:
 
-        - name: Java
-          ansible.builtin.include_tasks: tasks/workstation/linux/software/java.yml
-
-        - name: Docker
-          ansible.builtin.include_tasks: tasks/workstation/linux/software/docker.yml
-
         - name: LLM
           ansible.builtin.include_tasks: tasks/workstation/linux/software/ai/llm.yml