Fix issue #159: Pre-populate Navi Cheatsheets

.bash_profile

@@ -0,0 +1 @@
+test

.config/docs/common/contributing/header.md

@@ -2,4 +2,4 @@
   <center><h1 align="center">Contributing Guide</h1></center>
 </div>
 
-First of all, thanks for visiting this page 😊 ❤️ ! We are *stoked* that you may be considering contributing to this project. You should read this guide if you are considering creating a pull request or plan to modify the code for your own purposes.
+First of all, thanks for visiting this page 😊 ❤️ ! We are _stoked_ that you may be considering contributing to this project. You should read this guide if you are considering creating a pull request or plan to modify the code for your own purposes.

.config/docs/common/contributing/styleguides.md

@@ -6,11 +6,11 @@ All code projects have their own style. Coding style will vary from coder to cod
 
 Style guides are generally written for a specific language but a great place to start learning about the best coding practices is on [Google Style Guides](https://google.github.io/styleguide/). Follow the link and you will see style guides for most popular languages. We also recommend that you look through the following style guides, depending on what language you are coding with:
 
-* [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript)
-* [Angular Style Guide](https://angular.io/guide/styleguide)
-* [Effective Go](https://go.dev/doc/effective_go)
-* [PEP 8 Python Style Guide](https://www.python.org/dev/peps/pep-0008/)
-* [Git Style Guide](https://github.com/agis/git-style-guide)
+- [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript)
+- [Angular Style Guide](https://angular.io/guide/styleguide)
+- [Effective Go](https://go.dev/doc/effective_go)
+- [PEP 8 Python Style Guide](https://www.python.org/dev/peps/pep-0008/)
+- [Git Style Guide](https://github.com/agis/git-style-guide)
 
 For more informative links, refer to the [GitHub Awesome Guidelines List](https://github.com/Kristories/awesome-guidelines).
 

.config/docs/readme-playbook/introduction.md

@@ -4,7 +4,7 @@ Welcome to a new way of doing things. Born out of complete paranoia and a relent
 
 Gas Station a collection of Ansible playbooks, configurations, scripts, and roles meant to provision computers and networks with the "best of GitHub". By leveraging Ansible, you can provision your whole network relatively fast in the event of a disaster or scheduled network reset. This project is also intended to increase the security of your network by allowing you to frequently wipe, reinstall, and re-provision your network, bringing it back to its original state. This is done by backing up container storage volumes (like database files and Docker volumes) to encrypted S3 buckets, storing configurations in encrypted git repositories, and leveraging GitHub-sourced power tools to make the job easy-peasy.
 
-This project started when a certain somebody changed their desktop wallpaper to an _cute_ picture of a cat 🐱 when, all of a sudden, their computer meowed. Well, it actually started before that but no one believes someone who claims that time travelers hacked them on a regular basis. *Tip: If you are stuck in spiritual darkness involving time travelers, save yourself some headaches by adopting an other-people first mentality that may include volunteering, tithing, and surrendering to Jesus Christ.* Anyway, enough preaching!
+This project started when a certain somebody changed their desktop wallpaper to an _cute_ picture of a cat 🐱 when, all of a sudden, their computer meowed. Well, it actually started before that but no one believes someone who claims that time travelers hacked them on a regular basis. _Tip: If you are stuck in spiritual darkness involving time travelers, save yourself some headaches by adopting an other-people first mentality that may include volunteering, tithing, and surrendering to Jesus Christ._ Anyway, enough preaching!
 
 Gas Station is:
 

.config/docs/readme-playbook/quick-start.md

@@ -32,4 +32,4 @@ To setup Qubes, run the following on a fresh install in dom0:
 
 ```shell
 qvm-run --pass-io sys-firewall "curl -sSL https://install.doctor/qubes" > ./setup.sh && bash ./setup.sh
-```
+```

.config/flake8.toml

@@ -1,4 +1,4 @@
 [flake8]
-exclude = .autodoc, .cache, .common, .config, .git, .modules, .npm, .pnpm-store, .shared, .task, .venv, .vscode, build, dist, node_modules, roles, venv
-ignore = E402
+exclude = ".autodoc, .cache, .common, .config, .git, .modules, .npm, .pnpm-store, .shared, .task, .venv, .vscode, build, dist, node_modules, roles, venv"
+ignore = "E402"
 max-line-length = 120

.config/husky/prepare-commit-msg

@@ -21,12 +21,12 @@ if [ -f "$(dirname "$0")/_/husky.sh" ]; then
    logger info 'This git hook is configured to run even when --no-verify is used. In order to bypass this prompt, use the -n flag instead.'
     logger info 'Opening a `git commit` dialog'
     if ! type pnpx > /dev/null && type npm > /dev/null; then
-      npm install -g pnpm
+      npm install --no-progress -g pnpm
     elif ! type pnpx > /dev/null; then
       logger error '`pnpm` or `npm` must be installed'
     fi
     if ! type git-cz &> /dev/null; then
-      pnpm install -g commitizen
+      pnpm install --no-progress -g commitizen
     fi
     exec < /dev/tty && (git-cz --hook || true)
   fi

.config/log

@@ -25,7 +25,6 @@
 #   If the `docker` environment variable is not set, the script / library will ensure both Gum and Glow are installed.
 
 # @description Installs glow (a markdown renderer) from GitHub releases
-# @example installGlow
 installGlow() {
   # TODO: Add support for other architecture types
   if [ -d '/Applications' ] && [ -d '/Library' ] && [ -d '/Users' ]; then
@@ -57,13 +56,20 @@ installGlow() {
 }
 
 # @description Installs gum (a logging CLI) from GitHub releases
-# @example installGum
 installGum() {
   # TODO: Add support for other architecture types
   if [ -d '/Applications' ] && [ -d '/Library' ] && [ -d '/Users' ]; then
-    GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.4.0/gum_0.4.0_Darwin_x86_64.tar.gz"
+    if [ "$(uname -r)" == "arm64" ]; then
+      GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.14.5/gum_0.14.5_Darwin_arm64.tar.gz"
+    else
+      GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.14.5/gum_0.14.5_Darwin_x86_64.tar.gz"
+    fi
   elif [ -f '/etc/ubuntu-release' ] || [ -f '/etc/debian_version' ] || [ -f '/etc/redhat-release' ] || [ -f '/etc/SuSE-release' ] || [ -f '/etc/arch-release' ] || [ -f '/etc/alpine-release' ]; then
-    GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.4.0/gum_0.4.0_linux_x86_64.tar.gz"
+    if [ "$(uname -r)" == "arm64" ]; then
+      GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.14.5/gum_0.14.5_Linux_arm64.tar.gz"
+    else
+      GUM_DOWNLOAD_URL="https://github.com/charmbracelet/gum/releases/download/v0.14.5/gum_0.14.5_Linux_x86_64.tar.gz"
+    fi
   fi
   if type curl &> /dev/null; then
     if { [ -d '/Applications' ] && [ -d '/Library' ] && [ -d '/Users' ]; } || [ -f '/etc/ubuntu-release' ] || [ -f '/etc/debian_version' ] || [ -f '/etc/redhat-release' ] || [ -f '/etc/SuSE-release' ] || [ -f '/etc/arch-release' ] || [ -f '/etc/alpine-release' ]; then
@@ -117,7 +123,6 @@ if [ -n "$SEMANTIC_RELEASE" ]; then
 fi
 
 # @description Logs using Node.js
-# @example logger info "An informative log"
 logger() {
   if [ "$1" == 'error' ]; then
     "$GUM_PATH" style --border="thick" "$("$GUM_PATH" style --foreground="#ff0000" "✖") $("$GUM_PATH" style --bold --background="#ff0000" --foreground="#ffffff"  " ERROR ") $("$GUM_PATH" style --bold "$(format "$2")")"
@@ -171,7 +176,6 @@ format() {
 }
 
 # @description Display prompt that allows you to choose between options
-# @example RESPONSE="$(.config/log choose "file.png" "another-file.jpg")"
 choose() {
   if type gum &> /dev/null; then
     CHOOSE_ARGS="gum choose"
@@ -185,7 +189,6 @@ choose() {
 }
 
 # @description Display a confirmation prompt that returns an exit code if "No" is selected
-# @example RESPONSE="$(.config/log confirm "Are you sure?" "Yeah" "Naa")"
 confirm() {
   if type gum &> /dev/null; then
     GUM_OPTS=""
@@ -211,7 +214,6 @@ confirm() {
 }
 
 # @description Logs an error message
-# @example .config/log error "Something happened!"
 error() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -223,7 +225,6 @@ error() {
 }
 
 # @description Display a filterable prompt that is populated with options from a text file
-# @example echo Strawberry >> flavors.text && echo Banana >> flavors.text && RESPONSE="$(.config/log filter flavors.txt)"
 filter() {
   if type gum &> /dev/null; then
     TMP="$(mktemp)"
@@ -234,7 +235,6 @@ filter() {
 }
 
 # @description Logs an info message
-# @example .config/log info "Here is some information"
 info() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -246,7 +246,6 @@ info() {
 }
 
 # @description Displays an input with masked characters
-# @example INPUT="$(.config/log input 'Enter the value..')"
 input() {
   if type gum &> /dev/null; then
     if [ -n "$1" ]; then
@@ -260,8 +259,6 @@ input() {
 }
 
 # @description Logs a message written in markdown
-# @example .config/log md "[styled_link](https://google.com)"
-# @example .config/log md mymarkdown/file.md
 md() {
   if [ ! -f "$1" ]; then
     echo "ERROR: A markdown file must be passed in as the parameter" && exit 1
@@ -272,7 +269,6 @@ md() {
 }
 
 # @description Displays an input with masked characters
-# @example PASSWORD="$(.config/log password 'Enter the Ansible vault password')"
 password() {
   if type gum &> /dev/null; then
     if [ -n "$1" ]; then
@@ -286,7 +282,6 @@ password() {
 }
 
 # @description Logs a message that describes a prompt
-# @example .config/log prompt "Enter text into the following prompt"
 prompt() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -298,7 +293,6 @@ prompt() {
 }
 
 # @description Display a spinner that stays until a command is completed
-# @example .config/log spin "brew install yq" "Installing yq..")"
 spin() {
   if type gum &> /dev/null; then
     if [ -n "$1" ] && [ -n "$2" ]; then
@@ -314,7 +308,6 @@ spin() {
 }
 
 # @description Logs a message that starts with a star emoji
-# @example .config/log star "Congratulations"
 star() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -326,7 +319,6 @@ star() {
 }
 
 # @description Logs a message at the beginning of a task
-# @example .config/log start "Starting the process.."
 start() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -338,7 +330,6 @@ start() {
 }
 
 # @description Logs a success message
-# @example .config/log success "Yay!"
 success() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -350,7 +341,6 @@ success() {
 }
 
 # @description Logs a warning message
-# @example .config/log warn "Just so you know.."
 warn() {
   if [ -z "$NO_LOGGING" ]; then
     if [ -n "$ENHANCED_LOGGING" ]; then
@@ -362,7 +352,6 @@ warn() {
 }
 
 # @description Displays a multi-line prompt for text input
-# @example .config/log write "Write something..")"
 write() {
   if type gum &> /dev/null; then
     if [ -n "$1" ]; then

.config/taskfiles/ansible/Taskfile.yml

@@ -28,7 +28,7 @@ tasks:
         sh: jq --arg collections "$(yq eval -o=json '.collections' {{.REQUIREMENTS_PATH}})" '.{{.COLLECTION_DEPS}} = ($collections | fromjson) |
           .{{.COLLECTION_DEPS}}[] | "<a href=\"" + .source + "/" + (.name | split(".") | join("/")) + "\" title=\"" + .name +
           " collection on Ansible Galaxy\" target=\"_blank\"><img alt=\"" + .name + " Ansible Galaxy badge\"
-          src=\"https://img.shields.io/badge/Ansible%20Galaxy-" + .name + "-000000?logo=ansible&logoColor=white&style=for-the-badge\"></a>"'
+          src=\"https://img.shields.io/badge/Ansible%20Galaxy-" + .name + "-000000?logo=ansible&logoColor=white&style=for-the-badge\" /></a>"'
           -r  {{.VARIABLES_PATH}} | jq --raw-input --slurp 'split("\n") | .[0:((. | length) - 1)]'
       TMP:
         sh: mktemp

.config/taskfiles/common/Taskfile-update.yml

@@ -256,6 +256,11 @@ tasks:
       - >
         readme generate --headingPrefix '{}' --silent --config .variables.json
         --input ".config/docs/{{.README_TEMPLATE}}"
+      - |
+        if [ -f docs/img/logo-full.png ]; then
+          sed -i 's/\/-\/raw\/master\/logo.png/\/-\/raw\/master\/docs\/img\/logo-full.png/' README.md
+          sed -i 's/width="148" height="148"/height="69"/' README.md
+        fi
       - task: markdown:scrub
         vars:
           SCRUB_FILE: README.md

.config/taskfiles/common/Taskfile.yml

@@ -134,10 +134,10 @@ tasks:
         sh: mktemp
     cmds:
       - |
-        curl -sSL '{{.MODEL_TASKFILE}}' > '{{.MODEL_TMP}}'
-        export ZXXXY="$(yq e '.' {{.MODEL_TMP}})"
+        curl -sSL '{{.MODEL_TASKFILE}}' > '{{.MODEL_TMP}}.yml'
+        export ZXXXY="$(yq e '.' {{.MODEL_TMP}}.yml)"
         yq e -i '. | .vars = (env(ZXXXY) | .vars) | .env = (env(ZXXXY) | .env)' Taskfile.yml
-        yq eval-all -i 'select(fileIndex == 0) * select(fileIndex == 1)' '{{.MODEL_TMP}}' Taskfile.yml
+        yq eval-all -i 'select(fileIndex == 0) * select(fileIndex == 1)' '{{.MODEL_TMP}}.yml' Taskfile.yml
 
   requirements:
     deps:

.config/taskfiles/fix/Taskfile.yml

@@ -277,11 +277,11 @@ tasks:
       start: Running Prettier on {{if .CLI_ARGS}}`{{.CLI_ARGS}}`{{else}}project{{end}}
     cmds:
       - cmd: |
-          prettier --plugin node_modules/prettier-plugin-toml-fixed --ignore-path {{.PRETTIERIGNORE_CONFIG}} \
+          prettier --ignore-path {{.PRETTIERIGNORE_CONFIG}} \
           --write {{if .CLI_ARGS}}{{.CLI_ARGS}}{{else}}.{{end}} || EXIT_CODE=$?
           if [ -n "$EXIT_CODE" ]; then
             .config/log warn 'Failed to run `prettier` - falling back to `prettier`'
-            prettier --plugin node_modules/prettier-plugin-toml-fixed --ignore-path {{.PRETTIERIGNORE_CONFIG}} \
+            prettier --ignore-path {{.PRETTIERIGNORE_CONFIG}} \
             --write {{if .CLI_ARGS}}{{.CLI_ARGS}}{{else}}.{{end}}
           fi
         ignore_error: true

.config/taskfiles/git/Taskfile-hook.yml

@@ -88,6 +88,9 @@ tasks:
           # remote_ref -> refs/heads/master
           # remote_sha -> 9901a2eb2f34d5744276a80c4b339a88a92a7b53
           REMOTE_BRANCH="$(echo $remote_ref | sed 's/^[^\/]*\/[^\/]*\///')"
+          if [ "$(echo "$HOST" | cut -c1-8)" == 'https://' ]; then
+            HOST="$(echo "$HOST" | cut -c8)"
+          fi
           .config/log star "Repository -----> https://$HOST/$ORG/$PROJECT"
           if [ "$HOST" == 'gitlab.com' ]; then
             if [ "$REMOTE_BRANCH" != 'master' ]; then

.config/taskfiles/git/Taskfile.yml

@@ -70,14 +70,14 @@ tasks:
       - git init
       - git remote add origin "{{.GITLAB_REPO}}"
       - git add --all
-      - git commit --quiet -m "🧐 refactor(submodule): Adding folder/project to its own git repository."
+      - git commit --quiet -m "🧐 refactor(submodule) Adding folder/project to its own git repository."
       - git push --quiet -u --no-progress origin master
       - cd .. && rm -rf {{.BASENAME}}
       - cd .. && git add {{.BASENAME}}
-      - cd .. && git commit --quiet -m "🧐 refactor(submodule): Removing folder which will now be a submodule."
+      - git commit --quiet -m "🧐 refactor(submodule) Removing folder which will now be a submodule."
       - cd .. && git submodule add -b master "{{.GITLAB_REPO}}" {{.BASENAME}}
       - cd .. && git add {{.BASENAME}}
-      - cd .. && git commit --quiet -m "🧐 refactor(submodule): Adding new submodule which was previously a directory."
+      - cd .. && git commit --quiet -m "🧐 refactor(submodule) Adding new submodule which was previously a directory."
       - cd .. && git push --quiet -u --no-progress origin HEAD
     preconditions:
       - sh: '[[ ! $(git rev-parse --git-dir) =~ ".git/modules" ]]'

.github/ISSUE_TEMPLATE/BugReport.yml

@@ -1,7 +1,7 @@
 ---
 name: 🐛 Bug Report
 description: Stumbled upon an error? Submit a bug report.
-labels: [question]
+labels: [bug]
 body:
   - type: markdown
     attributes:

.github/workflows/chatgpt-review.yml

@@ -0,0 +1,30 @@
+name: Code Review
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  pull_request:
+  pull_request_review_comment:
+    types: [created]
+
+concurrency:
+  group:
+    ${{ github.repository }}-${{ github.event.number || github.head_ref ||
+    github.sha }}-${{ github.workflow }}-${{ github.event_name ==
+    'pull_request_review_comment' && 'pr_comment' || 'pr' }}
+  cancel-in-progress: ${{ github.event_name != 'pull_request_review_comment' }}
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: fluxninja/openai-pr-reviewer@latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        with:
+          debug: false
+          review_simple_changes: false
+          review_comment_lgtm: false

.github/workflows/openhands.yml

@@ -0,0 +1,34 @@
+name: Resolve Issue with OpenHands
+
+on:
+  issues:
+    types: [labeled]
+  pull_request:
+    types: [labeled]
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  pull_request_review:
+    types: [submitted]
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+jobs:
+  call-openhands-resolver:
+    uses: All-Hands-AI/OpenHands/.github/workflows/openhands-resolver.yml@main
+    with:
+      macro: ${{ vars.OPENHANDS_MACRO || '@openhands-agent' }}
+      max_iterations: ${{ fromJson(vars.OPENHANDS_MAX_ITER || 50) }}
+      base_container_image: ${{ vars.OPENHANDS_BASE_CONTAINER_IMAGE || '' }}
+      LLM_MODEL: ${{ vars.LLM_MODEL || 'anthropic/claude-sonnet-4-20250514' }}
+      target_branch: ${{ vars.TARGET_BRANCH || 'main' }}
+      runner: ${{ vars.TARGET_RUNNER }}
+    secrets:
+      PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
+      PAT_USERNAME: ${{ secrets.PAT_USERNAME }}
+      LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
+      LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}