.editorconfig

@@ -3,6 +3,19 @@ root = true
 [*]
 indent_style = space
 indent_size = 2
+end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+
+[*.go]
+indent_style = tab
+
+[*.py]
+indent_size = 4
+
+[*.fish]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false

.git-blame-ignore-revs

@@ -0,0 +1,15 @@
+# Run shfmt on bash files
+b8dc5f160447baabab9c69683824512ded577254
+
+# fix: Remove == inside [ (#1421)
+d81b81f9de2dc5961624464df04cef7cafae588c
+
+# chore: Fix ShellCheck errors in tests
+407a6696c0739f5e368543c4fc1b14e41458f177
+998180e3625643644603504bea75e3bcc668465f
+6f64aa8d847d53f272d30bcf2532937c02826080
+b5e981cf1d9a37af17e48f6a871ff692720df810
+28b348a041b3dfd1898eb0073aa1e83bdae70e4a
+720fd172004c9f29045eb2ad19f35eba47ae31c7
+ffa018763c10de63e6548372e7eaad2ae53643d6
+90ead5ea0ae06418c58a47f4c7732797af5fe336

.gitattributes

@@ -0,0 +1,66 @@
+## GITATTRIBUTES
+#
+# Details per file setting:
+#   text    These files should be normalized (i.e. convert CRLF to LF).
+#   binary  These files are binary and should be left untouched.
+#
+# Note that binary is a macro for -text -diff.
+######################################################################
+
+## AUTO-DETECT
+##   Handle line endings automatically for files detected as
+##   text and leave all files detected as binary untouched.
+##   This will handle all files NOT defined below.
+* text=auto
+
+## SOURCE CODE
+*.bats     text
+*.css      text
+*.htm      text
+*.html     text
+*.js       text
+*.sh       text
+*.bash     text
+*.fish     text
+*.elv      text
+#### asdf/bin/* explicitly define as text
+*asdf      text
+*asdf-exec text
+*_asdf     text
+#### asdf/test/fixtures/* should be covered by * text=auto on L14
+
+## DOCKER
+*.dockerignore    text
+Dockerfile        text
+
+## DOCUMENTATION
+*.markdown   text
+*.md         text
+*.mdwn       text
+*.mdown      text
+*.mkd        text
+*.mkdn       text
+*.mdtxt      text
+*.mdtext     text
+*.txt        text
+AUTHORS      text
+CHANGELOG    text
+CHANGES      text
+CONTRIBUTING text
+COPYING      text
+copyright    text
+*COPYRIGHT*  text
+INSTALL      text
+license      text
+LICENSE      text
+NEWS         text
+readme       text
+*README*     text
+TODO         text
+
+## CONFIGS
+.editorconfig  text
+.gitattributes text
+.gitconfig     text
+*.yaml         text
+*.yml          text

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owners for all the code in this repo
+* @asdf-vm/core

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,55 @@
+name: Bug Report
+description: Create a report to help us improve
+title: "bug: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the Bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Tell us what actions you performed before the issue occurred
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behaviour
+      description: Tell us what should have happened?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behaviour
+      description: Tell us what happened instead
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Copy the output of `asdf info` here
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: plugins
+    attributes:
+      label: asdf plugins affected (if relevant)
+      description: The plugins you list here should appear in the list from `asdf info`

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,6 @@
+# Force users to use one of our predefined issue templates
+blank_issues_enabled: false
+contact_links:
+  - name: Question (StackOverflow)
+    url: https://stackoverflow.com/questions/tagged/asdf-vm
+    about: Ask new or browse existing questions on StackOverflow.

.github/ISSUE_TEMPLATE/documentation.yaml

@@ -0,0 +1,16 @@
+name: Documentation
+description: Suggest a documentation improvements for this project
+labels: "documentation"
+body: 
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help improve our docs!
+  - type: textarea
+    id: problem
+    attributes:
+      label: How can we improve the documentation?
+      description: Please provide a clear and concise description of the problem. The more information you can provide here, the better.
+      placeholder: The documentation can be improved by...
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,38 @@
+name: Feature Request
+description: Suggest an idea for this project
+labels: "enhancement"
+body: 
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to request this feature!
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe
+      description: Please provide a clear and concise description the problem this feature would solve. The more information you can provide here, the better.
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the proposed solution
+      description: Please provide a clear and concise description of what you would like to happen.
+      placeholder: I would like to see...
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "Describe similar `asdf` features and why they are not sufficient"
+      description: "Describe asdf features you tried to use to accomplish what you wanted. Explain why they are insufficient for the task you were trying to accomplish."
+    validations:
+      required: true
+  - type: textarea
+    id: workarounds
+    attributes:
+      label: "Describe other workarounds you've considered"
+      description: "A clear and concise description of any alternative solutions or features you've considered."
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,12 +1,9 @@
 # Summary
 
-Provide a general description of the code changes in your pull request.
+<!-- Provide a general description of the code changes in your pull request. -->
 
 Fixes: List issue numbers here
 
 ## Other Information
 
-If there is anything else that is relevant to your pull request include that
-information here.
-
-Thank you for contributing to asdf!
+<!-- If there is anything else that is relevant to your pull request include that information here. Thank you for contributing to asdf! -->

.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    reviewers:
+      - "jthegedus"
+      - "stratus3d"
+  # Maintain dependencies for npm used in Documentation site
+  - package-ecosystem: "npm"
+    directory: "/docs"
+    schedule:
+      interval: "monthly"
+    reviewers:
+      - "jthegedus"
+    groups:
+      docs:
+        patterns:
+          - "*"

.github/workflows/documentation.yml

@@ -0,0 +1,59 @@
+name: Documentation
+
+on:
+  # trigger deployment on push to master branch when changes to docs/**
+  push:
+    paths:
+      - "docs/**"
+    branches:
+      - master
+  # trigger deployment manually
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs/
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # fetch all commits to get last updated time or other git log info
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        id: npm-cache
+        with:
+          path: |
+            **/node_modules
+          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-
+
+      - name: Install dependencies
+        if: steps.npm-cache.outputs.cache-hit != 'true'
+        run: npm install
+
+      - name: Build VitePress site
+        run: npm run build
+
+      - name: Bundle CNAME with site dist
+        run: cp CNAME .vitepress/dist
+
+      - name: Deploy to GitHub Pages
+        uses: crazy-max/ghaction-github-pages@v4
+        with:
+          # deploy to gh-pages branch
+          target_branch: gh-pages
+          # deploy the default output dir of VitePress
+          build_dir: docs/.vitepress/dist
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/lint.yml

@@ -0,0 +1,54 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+env:
+  PYTHON_MIN_VERSION: "3.13.1"
+
+jobs:
+  asdf-bash:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: asdf-vm/actions/install@v3
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_MIN_VERSION }}
+      - run: scripts/install_dependencies.bash
+      - run: scripts/lint.bash --check
+
+  asdf-golang:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.23.4'
+      - name: Install dependencies
+        run: go get ./...
+      - name: Run 'gofumpt'
+        run: go run mvdan.cc/gofumpt -l -w .
+      - name: Check format
+        run: '[ -z "$(gofmt -l ./...)" ]'
+      - name: Run 'revive'
+        run: go run github.com/mgechev/revive -set_exit_status ./...
+      - name: Vet
+        run: go vet ./...
+      - name: Lint
+        run: go run honnef.co/go/tools/cmd/staticcheck -tests -show-ignored ./...
+      - name: Build
+        run: go build -v ./...
+
+  actions:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check workflow files
+        uses: docker://rhysd/actionlint:1.6.24
+        with:
+          args: -color