🎨 Template bootstrap by kettle-jem v1.0.0

Author: pboling

.devcontainer/scripts/setup-tree-sitter.sh

@@ -9,46 +9,33 @@ set -e
 # - Devcontainer: Can run as root (apt-install feature) or non-root (postCreateCommand)
 # - Auto-detection: Checks if running as root (id -u = 0), uses sudo if non-root
 #
-# This script installs ALL tree-sitter grammars for integration testing
+# Grammar building is delegated to tsdl (https://github.com/stackmystack/tsdl).
+# Configure grammars and versions in parsers.toml at the project root.
 #
 # Options:
 #   --sudo: Force use of sudo (optional, auto-detected by default)
 #   --cli:  Install tree-sitter-cli via npm (optional)
 #   --build: Build and install the tree-sitter C runtime from source when distro packages are missing (optional)
-#   --workspace PATH: Workspace root path for informational/debugging purposes only (defaults to /workspaces/tree_haver)
+#   --tsdl-version VERSION: Pin tsdl release version (default: v2.0.0)
+#   --workspace PATH: Workspace root path for informational/debugging purposes only
 
 SUDO=""
 INSTALL_CLI=false
 BUILD_FROM_SOURCE=false
+TSDL_VERSION="v2.0.0"
 WORKSPACE_ROOT="/workspaces/${PWD##*/}"
 
 # Parse arguments properly using while loop
 while [[ $# -gt 0 ]]; do
   case $1 in
-    --sudo)
-      SUDO="sudo"
-      shift
-      ;;
-    --cli)
-      INSTALL_CLI=true
-      shift
-      ;;
-    --build)
-      BUILD_FROM_SOURCE=true
-      shift
-      ;;
-    --workspace)
-      WORKSPACE_ROOT="$2"
-      shift 2
-      ;;
-    --workspace=*)
-      WORKSPACE_ROOT="${1#*=}"
-      shift
-      ;;
-    *)
-      echo "Unknown option: $1" >&2
-      shift
-      ;;
+    --sudo)           SUDO="sudo"; shift ;;
+    --cli)            INSTALL_CLI=true; shift ;;
+    --build)          BUILD_FROM_SOURCE=true; shift ;;
+    --tsdl-version)   TSDL_VERSION="$2"; shift 2 ;;
+    --tsdl-version=*) TSDL_VERSION="${1#*=}"; shift ;;
+    --workspace)      WORKSPACE_ROOT="$2"; shift 2 ;;
+    --workspace=*)    WORKSPACE_ROOT="${1#*=}"; shift ;;
+    *) echo "Unknown option: $1" >&2; shift ;;
   esac
 done
 
@@ -62,6 +49,7 @@ echo "  Workspace root: $WORKSPACE_ROOT (informational only)"
 echo "  Using sudo: $([ -n "$SUDO" ] && echo "yes" || echo "no")"
 echo "  Install CLI: $INSTALL_CLI"
 echo "  Build from source: $BUILD_FROM_SOURCE"
+echo "  tsdl version: $TSDL_VERSION"
 echo ""
 
 have_cmd() { command -v "$1" >/dev/null 2>&1; }
@@ -74,29 +62,67 @@ have_tree_sitter() {
 }
 
 install_tree_sitter_from_source() {
-  echo "[ubuntu] Attempting to build and install tree-sitter from source..."
+  echo "[tree-sitter] Building runtime from source..."
   tmpdir=$(mktemp -d /tmp/tree-sitter-src-XXXX)
   trap 'rm -rf "$tmpdir"' EXIT
   git clone --depth 1 https://github.com/tree-sitter/tree-sitter.git "$tmpdir" || return 1
   pushd "$tmpdir" >/dev/null || return 1
   if ! make; then
-    echo "[ubuntu] ERROR: 'make' failed while building tree-sitter" >&2
+    echo "[tree-sitter] ERROR: 'make' failed" >&2
     popd >/dev/null
     return 1
   fi
-
   $SUDO mkdir -p /usr/local/include/tree-sitter
   $SUDO cp -r lib/include/* /usr/local/include/tree-sitter/ || true
   $SUDO cp -a lib/libtree-sitter.* /usr/local/lib/ 2>/dev/null || true
-  if have_cmd ldconfig; then
-    $SUDO ldconfig || true
-  fi
-
+  have_cmd ldconfig && $SUDO ldconfig || true
   popd >/dev/null
-  echo "[ubuntu] tree-sitter built and installed to /usr/local (headers + libs)."
+  echo "[tree-sitter] Runtime installed to /usr/local."
   return 0
 }
 
+install_tsdl() {
+  if have_cmd tsdl; then
+    echo "[tsdl] Already installed: $(tsdl --version)"
+    return 0
+  fi
+
+  echo "[tsdl] Installing tsdl ${TSDL_VERSION}..."
+  local arch
+  arch="$(uname -m)"
+  case "$arch" in
+    x86_64)  arch="x64" ;;
+    aarch64) arch="arm64" ;;
+    armv7l)  arch="arm" ;;
+    i686)    arch="x86" ;;
+    *) echo "[tsdl] ERROR: Unsupported architecture: $arch" >&2; return 1 ;;
+  esac
+
+  local os
+  os="$(uname -s | tr '[:upper:]' '[:lower:]')"
+  case "$os" in
+    linux)  os="linux" ;;
+    darwin) os="macos" ;;
+    *) echo "[tsdl] ERROR: Unsupported OS: $os" >&2; return 1 ;;
+  esac
+
+  local url="https://github.com/stackmystack/tsdl/releases/download/${TSDL_VERSION}/tsdl-${os}-${arch}.gz"
+  local tmpbin
+  tmpbin=$(mktemp /tmp/tsdl-XXXX)
+
+  if ! wget -q "$url" -O "${tmpbin}.gz"; then
+    echo "[tsdl] ERROR: Failed to download from $url" >&2
+    return 1
+  fi
+  gunzip -f "${tmpbin}.gz"
+  chmod +x "$tmpbin"
+  $SUDO mv "$tmpbin" /usr/local/bin/tsdl
+  echo "[tsdl] Installed: $(tsdl --version)"
+}
+
+# --- 1. System dependencies ---
+echo "Installing system dependencies..."
+
 echo "Installing tree-sitter system library and dependencies..."
 $SUDO apt-get update -y
 # libtree-sitter-dev is optional when building from source via --build
@@ -117,39 +143,40 @@ if ! $SUDO apt-get install -y \
   libcurl4-openssl-dev \
   software-properties-common \
   libffi-dev; then
-  echo "ERROR: apt-get failed to install required packages."
-  echo "Please check your network, package sources, and re-run this script."
+  echo "ERROR: apt-get failed to install required packages." >&2
   exit 1
 fi
 
-# If the user requested a source-build, skip installing libtree-sitter-dev
+# --- 2. Tree-sitter runtime ---
 if [ "$BUILD_FROM_SOURCE" = true ]; then
-  echo "[ubuntu] --build specified; skipping distro package 'libtree-sitter-dev' and building tree-sitter from source."
+  echo "[tree-sitter] --build specified; building runtime from source."
 fi
 
 # Ensure tree-sitter is available; if not, attempt to build from source
 if ! have_tree_sitter; then
   if [ "$BUILD_FROM_SOURCE" = true ]; then
-    echo "[ubuntu] tree-sitter not found in system paths; attempting to build from source as requested (--build)."
     if ! install_tree_sitter_from_source; then
-      echo "[ubuntu] ERROR: Failed to provide tree-sitter runtime/library. Aborting." >&2
+      echo "[tree-sitter] ERROR: Failed to build runtime. Aborting." >&2
       exit 1
     fi
   else
-    echo "[ubuntu] ERROR: tree-sitter runtime (headers/libs) not found."
-    echo "Install the appropriate distro package (e.g., libtree-sitter-dev) or re-run this script with --build to compile from source."
+    echo "[tree-sitter] ERROR: Runtime (headers/libs) not found." >&2
+    echo "Install libtree-sitter-dev or re-run with --build." >&2
     exit 1
   fi
 fi
 
-# Install tree-sitter CLI via npm (optional)
+# --- 3. tree-sitter-cli (optional) ---
 if [ "$INSTALL_CLI" = true ]; then
   echo "Installing tree-sitter-cli via npm..."
   $SUDO npm install -g tree-sitter-cli
 else
-  echo "Skipping tree-sitter-cli installation (use --cli flag to install)"
+  echo "Skipping tree-sitter-cli (use --cli to install)"
 fi
 
+# --- 4. Install tsdl and build grammars ---
+install_tsdl
+
 # Install all tree-sitter grammars for integration testing
 GRAMMARS=("toml" "json" "jsonc" "bash")
 
@@ -209,7 +236,20 @@ if ! $SUDO ldconfig; then
 fi
 
 echo ""
+echo "Building tree-sitter grammars via tsdl..."
+# Use parsers.toml from the project root if it exists, otherwise build defaults.
+# tsdl automatically reads parsers.toml in the current directory.
+if [ -f parsers.toml ]; then
+  echo "[tsdl] Using parsers.toml config"
+  $SUDO tsdl build --out-dir /usr/local/lib --progress plain
+else
+  echo "[tsdl] No parsers.toml found; building default grammars: toml json bash rbs"
+  $SUDO tsdl build toml json bash rbs --out-dir /usr/local/lib --progress plain
+fi
+
+$SUDO ldconfig || echo "WARNING: ldconfig failed" >&2
 echo "tree-sitter setup complete!"
+
 echo ""
 echo "Detected library paths:"
 
@@ -225,9 +265,11 @@ elif [ -f /usr/lib/libtree-sitter.so ]; then
 else
   echo "  WARNING: Could not find libtree-sitter runtime library!"
 fi
-
 echo ""
 echo "Grammar libraries:"
 for grammar in "${GRAMMARS[@]}"; do
   echo "  TREE_SITTER_${grammar^^}_PATH=/usr/local/lib/libtree-sitter-${grammar}.so"
 done
+for lib in /usr/local/lib/libtree-sitter-*.so; do
+  [ -f "$lib" ] && echo "  $lib"
+done

.github/workflows/auto-assign.yml

@@ -12,7 +12,7 @@ jobs:
       pull-requests: write
     steps:
     - name: 'Auto-assign issue'
-      uses: pozil/auto-assign-issue@v2
+      uses: pozil/auto-assign-issue@39c06395cbac76e79afc4ad4e5c5c6db6ecfdd2e # v2.2.0
       with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           assignees: "pboling"

.github/workflows/codeql-analysis.yml

@@ -38,11 +38,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v6
+      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v4
+      uses: github/codeql-action/init@c10b8064de6f491fea524254123dbe5e09572f13 # v4.35.1
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -53,7 +53,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v4
+      uses: github/codeql-action/autobuild@c10b8064de6f491fea524254123dbe5e09572f13 # v4.35.1
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -67,4 +67,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v4
+      uses: github/codeql-action/analyze@c10b8064de6f491fea524254123dbe5e09572f13 # v4.35.1

.github/workflows/coverage.yml

@@ -55,10 +55,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Ruby & RubyGems
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1.300.0
         with:
           ruby-version: "${{ matrix.ruby }}"
           rubygems: "${{ matrix.rubygems }}"
@@ -89,14 +89,14 @@ jobs:
       # Do SaaS coverage uploads first
       - name: Upload coverage to Coveralls
         if: ${{ !env.ACT }}
-        uses: coverallsapp/github-action@master
+        uses: coverallsapp/github-action@0a51d2e0b5417d06e4ecceb534aec87defc53926 # main
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
         continue-on-error: ${{ matrix.experimental != 'false' }}
 
       - name: Upload coverage to QLTY
         if: ${{ !env.ACT }}
-        uses: qltysh/qlty-action/coverage@main
+        uses: qltysh/qlty-action/coverage@a19242102d17e497f437d7466aa01b528537e899 # v2.2.0
         with:
           token: ${{secrets.QLTY_COVERAGE_TOKEN}}
           files: coverage/.resultset.json
@@ -106,7 +106,7 @@ jobs:
       #   which will hopefully be noticed for the lack of code coverage comments
       - name: Upload coverage to CodeCov
         if: ${{ !env.ACT }}
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@57e3a136b779b570ffcdbf80b3bdc90e7fab3de2 # v6.0.0
         with:
           use_oidc: true
           fail_ci_if_error: false # optional (default = false)
@@ -116,7 +116,7 @@ jobs:
       # Then PR comments
       - name: Code Coverage Summary Report
         if: ${{ !env.ACT && github.event_name == 'pull_request' }}
-        uses: irongut/CodeCoverageSummary@v1.3.0
+        uses: irongut/CodeCoverageSummary@51cc3a756ddcd398d447c044c02cb6aa83fdae95 # v1.3.0
         with:
           filename: ./coverage/coverage.xml
           badge: true
@@ -130,7 +130,7 @@ jobs:
         continue-on-error: ${{ matrix.experimental != 'false' }}
 
       - name: Add Coverage PR Comment
-        uses: marocchino/sticky-pull-request-comment@v3
+        uses: marocchino/sticky-pull-request-comment@d4d6b0936434b21bc8345ad45a440c5f7d2c40ff # v3.0.3
         if: ${{ !env.ACT && github.event_name == 'pull_request' }}
         with:
           recreate: true

.github/workflows/current.yml

@@ -64,11 +64,11 @@ jobs:
     steps:
       - name: Checkout
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1.300.0
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}

.github/workflows/dep-heads.yml

@@ -66,11 +66,11 @@ jobs:
     steps:
       - name: Checkout
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1.300.0
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}

.github/workflows/dependency-review.yml

@@ -15,6 +15,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 'Checkout Repository'
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - name: 'Dependency Review'
-        uses: actions/dependency-review-action@v4
+        uses: actions/dependency-review-action@2031cfc080254a8a887f58cffee85186f0e49e48 # v4.9.0

.github/workflows/heads.yml

@@ -65,11 +65,11 @@ jobs:
     steps:
       - name: Checkout
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT || (! startsWith(matrix.ruby, 'jruby') && !startsWith(matrix.ruby, 'truffleruby')) }}
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1.300.0
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}

.github/workflows/jruby-9.1.yml

@@ -47,11 +47,11 @@ jobs:
     steps:
       - name: Checkout
         if: ${{ !env.ACT }}
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT }}
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@e65c17d16e57e481586a6a5a0282698790062f92 # v1.300.0
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}