galaaz 2.1.10.pre.8 → 2.1.10.pre.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49086d9d91136759ccda55167c3c7ba0960257b2ea01f552f11ea24c7bf0eb00
-  data.tar.gz: a0227e50a79166c1d05c0609235f68e6be7504ff8fe6872b66821f274603b498
+  metadata.gz: 6c17cdef4fee4cef82633cf115d082b71a23f8bc6c837a144cb9377113b4b86a
+  data.tar.gz: 667874709ce613f990909eea6d952270c26019df5d0a21492addcb752c5cae4e
 SHA512:
-  metadata.gz: 2ca73b7ea17b312f2213095f98215ebc8688e15c2127eda29c863b374e85583e71e78b9259e396e9ad88e876180a561128e05015b72f3d138b8f133fe08f5433
-  data.tar.gz: c2824ae862e18e6f39b4e8590431d45c6ead857727b530d90c8edf95fc5e548c527d8c935ad544fbd3da17b03fa56d16165e0fe24787316ba0ef4dc66ec22def
+  metadata.gz: e48c834304c88e05905e7a33a5e3bedb8e11447459cfa5688c70848fb475b17ce115de36440a75106508bebba858eab3c73757aab7a6f8614e7292428df34711
+  data.tar.gz: 1111967bc3b3b7ac1de61209889015e5ba5fb3a9bd8a39d983e52273aa9a1f7e2388fcd9b18568a888ad927c6e87cb5df70e7d049ebc6d20184cfa2dadece36c

data/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## Unreleased
 
+## 2.1.10.pre.10
+
+### Changed
+
+- Omarchy: split Arrow menu into **Arrow (R only)** (`galaaz add arrow-r`) and
+  **Arrow (Ruby)** (`galaaz add arrow-ruby`). Ruby install always ensures R only
+  first; no Stage A/B labels in the UI. Legacy `galaaz add arrow` aliases to
+  `arrow-ruby`. Ledger/demo pull `arrow-ruby`. Guide, doctor, and Arrow debug
+  use the same wording. Examples tree ships `examples/README.md` with run hints.
+
+## 2.1.10.pre.9
+
+### Fixed
+
+- Omarchy Arrow Stage B: slim arrow-glib build (hide flight/dataset/parquet from
+  pkg-config) to avoid TUI OOM; traced install log; doctor reports arrow C++ /
+  arrow-glib / R arrow / red-arrow; do not mark `profiles/arrow` until Stage B
+  succeeds; menu **Arrow debug** helper; persist `GI_TYPELIB_PATH` /
+  `LD_LIBRARY_PATH` in `~/.config/galaaz/arrow-env.sh` so `require "arrow"` works
+  without manual exports.
+
 ## 2.1.10.pre.8
 
 ### Fixed

data/bin/galaaz_ruby_env.inc.sh

@@ -7,7 +7,23 @@
 #
 # JRuby and CRuby are both first-class. Override with GALAAZ_RUBY=jruby, GALAAZ_RUBY=ruby,
 # or a full path. Extra JRuby flags: GALAAZ_JRUBY_OPTS="-J-Xmx4g" (ignored on CRuby).
-# CRuby red-arrow uses system Arrow GLib (Apache Arrow APT / libarrow-glib-dev).
+# CRuby red-arrow uses system Arrow GLib (Apache Arrow APT / libarrow-glib-dev,
+# or Omarchy build into /usr/local). Typelibs under /usr/local need GI_TYPELIB_PATH.
+if [[ -f "${HOME}/.config/galaaz/arrow-env.sh" ]]; then
+  # shellcheck disable=SC1090
+  source "${HOME}/.config/galaaz/arrow-env.sh"
+else
+  if [[ -d /usr/local/lib/girepository-1.0 ]]; then
+    export GI_TYPELIB_PATH="/usr/local/lib/girepository-1.0${GI_TYPELIB_PATH:+:${GI_TYPELIB_PATH}}"
+  fi
+  if [[ -d /usr/local/lib ]]; then
+    export LD_LIBRARY_PATH="/usr/local/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}"
+  fi
+  if [[ -d /usr/local/lib64 ]]; then
+    export LD_LIBRARY_PATH="/usr/local/lib64${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}"
+  fi
+  export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}}"
+fi
 
 GALAAZ_RUBY_BIN="${GALAAZ_RUBY:-ruby}"
 

data/examples/README.md

@@ -0,0 +1,81 @@
+# Galaaz examples
+
+Copied here by `galaaz add examples` (default: `~/galaaz-examples`).
+
+These are Ruby scripts that use the **installed `galaaz` gem** and GNU R. From a
+git checkout you can also use `bin/run_example` / `bin/galaaz-ruby`; after a gem
+install on Omarchy, use plain `ruby` as below.
+
+## Prerequisites
+
+```bash
+galaaz doctor          # setup OK, gatekeeper, Rcpp
+# plots:      galaaz add knit   (ggplot2 and friends)
+# Arrow IPC:  galaaz add arrow  (Stage A/B)
+# Bio:        galaaz add bio    (DESeq2 / airway)
+```
+
+If you built Arrow GLib under `/usr/local` (Omarchy Stage B):
+
+```bash
+source ~/.config/galaaz/arrow-env.sh   # or open a new shell after menu Arrow
+```
+
+Graphical examples need a display (Omarchy Wayland session is fine).
+
+## Run a script (gem / Omarchy)
+
+```bash
+cd ~/galaaz-examples
+
+# small / misc
+ruby misc/subsetting.rb
+ruby misc/ggplot.rb
+
+# ISLR chapter demos (installs ISLR/MASS on first run)
+ruby islr/ch3_boston.rb
+
+# ggplot gallery (many windows / plots)
+ruby sthda_ggplot/one_variable_continuous/geom_density.rb
+ruby sthda_ggplot/all.rb
+
+# Bioconductor walkthrough (needs galaaz add bio)
+ruby bioconductor_deseq2_airway/deseq2_airway_galaaz.rb
+
+# Arrow shard handoff sketch (needs arrow)
+ruby multithread_shards_to_r/shards_to_r.rb
+```
+
+Under **mise**:
+
+```bash
+mise x ruby -- ruby ~/galaaz-examples/misc/ggplot.rb
+```
+
+## Layout
+
+| Directory | What |
+|-----------|------|
+| `misc/` | Short demos (subsetting, ggplot, moneyball) |
+| `islr/` | ISLR book chapter scripts / specs |
+| `sthda_ggplot/` | ggplot2 gallery (see `sthda_ggplot/README.md`, `RUN.md`) |
+| `bioconductor_deseq2_airway/` | DESeq2 airway pipeline |
+| `multithread_shards_to_r/` | Parallel shards → R / Arrow sketch |
+| `rmarkdown/`, `latex_templates/` | Knit / LaTeX template samples (`gknit`) |
+| `50Plots_MasterList/` | Extra plot scripts |
+
+## From a Galaaz git checkout
+
+```bash
+bin/run_example examples/misc/ggplot.rb
+bin/galaaz-ruby examples/bioconductor_deseq2_airway/deseq2_airway_galaaz.rb
+# JRuby:
+GALAAZ_RUBY=jruby bin/run_example examples/sthda_ggplot/all.rb
+```
+
+## Troubleshooting
+
+- `cannot load such file -- galaaz` → `gem install galaaz` (or `gem list galaaz`)
+- `Typelib file for namespace 'Arrow'` → `source ~/.config/galaaz/arrow-env.sh`
+- Missing R packages → script often calls `R.install_and_loads`; or `galaaz add knit` / `bio`
+- No plot window → run inside a graphical session, not a bare SSH TTY

data/lib/galaaz/arrow_ipc/red_arrow_backend.rb

@@ -44,6 +44,7 @@ module Galaaz
       def load!
         return if defined?(@loaded) && @loaded
 
+        ensure_arrow_glib_runtime_env!
         begin
           require 'arrow'
         rescue LoadError
@@ -60,6 +61,29 @@ module Galaaz
       end
       private_class_method :load!
 
+      # Omarchy / --prefix=/usr/local installs put typelibs and .so under /usr/local,
+      # which gobject-introspection and the dynamic linker do not search by default.
+      def ensure_arrow_glib_runtime_env!
+        gir = '/usr/local/lib/girepository-1.0'
+        if File.directory?(gir)
+          cur = ENV['GI_TYPELIB_PATH'].to_s.split(File::PATH_SEPARATOR)
+          ENV['GI_TYPELIB_PATH'] = ([gir] + cur).uniq.join(File::PATH_SEPARATOR)
+        end
+        %w[/usr/local/lib /usr/local/lib64].each do |lib|
+          next unless File.directory?(lib)
+
+          cur = ENV['LD_LIBRARY_PATH'].to_s.split(File::PATH_SEPARATOR)
+          ENV['LD_LIBRARY_PATH'] = ([lib] + cur).uniq.join(File::PATH_SEPARATOR)
+        end
+        %w[/usr/local/lib/pkgconfig /usr/local/lib64/pkgconfig].each do |pc|
+          next unless File.directory?(pc)
+
+          cur = ENV['PKG_CONFIG_PATH'].to_s.split(File::PATH_SEPARATOR)
+          ENV['PKG_CONFIG_PATH'] = ([pc] + cur).uniq.join(File::PATH_SEPARATOR)
+        end
+      end
+      private_class_method :ensure_arrow_glib_runtime_env!
+
       # bundle exec only exposes Gemfile gems; red-arrow is optional and often
       # user-installed. Put its lib + native extension on $LOAD_PATH.
       def prepend_user_red_arrow_load_path!

data/lib/galaaz/cli.rb

@@ -11,7 +11,7 @@ module Galaaz
     BLOG_NAMES = %w[
       oh_my gknit galaaz_ggplot galaaz_2_0 r_on_rails_ledger manual nse_dplyr ruby_plot
     ].freeze
-    PROFILES = %w[knit arrow tex bio examples ledger demo].freeze
+    PROFILES = %w[knit arrow-r arrow-ruby arrow tex bio examples ledger demo].freeze
     CONFIG_DIR = File.join(Dir.home, '.config', 'galaaz')
     PROFILES_DIR = File.join(CONFIG_DIR, 'profiles')
     DEFAULT_BLOGS_DIR = File.join(Dir.home, 'galaaz-blogs')
@@ -27,6 +27,7 @@ module Galaaz
       ['galaaz-add.sh', 'omarchy-galaaz-add', true],
       ['galaaz-guide.sh', 'omarchy-galaaz-guide', true],
       ['galaaz-gknit.sh', 'omarchy-galaaz-gknit', true],
+      ['galaaz-arrow-debug.sh', 'omarchy-galaaz-arrow-debug', true],
       ['debug-galaaz.sh', 'omarchy-galaaz-debug', true]
     ].freeze
     # Installed under ~/.local/share/nautilus/scripts/Galaaz/ (Scripts → Galaaz).
@@ -477,6 +478,8 @@ module Galaaz
       profiles = listed_profiles
       puts "  profiles: #{profiles.empty? ? '(none)' : profiles.join(', ')}"
 
+      print_arrow_doctor_lines
+
       pdf = command_present?('pdflatex')
       puts "  pdflatex: #{pdf ? `pdflatex --version 2>/dev/null`.lines.first.to_s.strip : 'MISSING (galaaz add tex)'}"
 
@@ -485,6 +488,41 @@ module Galaaz
       setup_ok ? 0 : 1
     end
 
+    def print_arrow_doctor_lines
+      ENV['PKG_CONFIG_PATH'] = [
+        '/usr/local/lib/pkgconfig',
+        '/usr/local/lib64/pkgconfig',
+        ENV['PKG_CONFIG_PATH']
+      ].compact.reject(&:empty?).join(File::PATH_SEPARATOR)
+
+      arrow_cpp = system('pkg-config', '--exists', 'arrow')
+      arrow_cpp_ver = arrow_cpp ? `pkg-config --modversion arrow 2>/dev/null`.strip : nil
+      arrow_glib = system('pkg-config', '--exists', 'arrow-glib')
+      arrow_glib_ver = arrow_glib ? `pkg-config --modversion arrow-glib 2>/dev/null`.strip : nil
+      r_arrow = command_present?('Rscript') && r_namespace?('arrow')
+      red =
+        begin
+          Gem::Specification.find_by_name('red-arrow')
+          true
+        rescue LoadError, Gem::LoadError
+          false
+        end
+
+      puts "  arrow C++:  #{arrow_cpp ? "OK (#{arrow_cpp_ver})" : 'MISSING (Omarchy: menu Arrow (Ruby) installs Arch arrow)'}"
+      puts "  arrow-glib: #{arrow_glib ? "OK (#{arrow_glib_ver})" : 'MISSING (needed for Arrow (Ruby) / red-arrow)'}"
+      puts "  R arrow:    #{r_arrow ? 'OK' : 'MISSING (menu: Arrow (R only))'}"
+      puts "  red-arrow:  #{red ? 'OK' : 'MISSING (menu: Arrow (Ruby))'}"
+      if listed_profiles.include?('arrow') && !(arrow_glib && (RUBY_ENGINE != 'ruby' || red))
+        puts '  arrow tip:  legacy profiles/arrow set but Ruby bridge incomplete —'
+        puts '              rm ~/.config/galaaz/profiles/arrow ~/.config/galaaz/profiles/arrow-ruby'
+        puts '              then: omarchy-galaaz-add arrow-ruby'
+        puts '              or: omarchy-galaaz-arrow-debug status'
+      elsif listed_profiles.include?('arrow-ruby') && !(arrow_glib && (RUBY_ENGINE != 'ruby' || red))
+        puts '  arrow tip:  profiles/arrow-ruby set but bridge incomplete —'
+        puts '              rm ~/.config/galaaz/profiles/arrow-ruby && omarchy-galaaz-add arrow-ruby'
+      end
+    end
+
     def print_ruby_engines
       puts "  this:     #{RUBY_DESCRIPTION}"
       puts "  engine:   #{RUBY_ENGINE}  (interpreter running doctor)"
@@ -584,7 +622,9 @@ module Galaaz
 
       case profile
       when 'knit' then add_knit
-      when 'arrow' then add_arrow
+      when 'arrow-r' then add_arrow_r
+      when 'arrow-ruby' then add_arrow_ruby
+      when 'arrow' then add_arrow_ruby # alias: full Ruby bridge (includes R)
       when 'tex' then add_tex
       when 'bio' then add_bio
       when 'examples' then add_examples
@@ -593,7 +633,7 @@ module Galaaz
     end
 
     def add_demo
-      %w[knit arrow ledger].each do |p|
+      %w[knit arrow-ruby ledger].each do |p|
         code = cmd_add([p])
         return code unless code.zero?
       end
@@ -637,40 +677,77 @@ module Galaaz
       0
     end
 
-    def add_arrow
-      # R 'arrow' needs a matching libarrow. Compiling Arrow C++ + Boost from the
-      # CRAN source tarball is fragile (especially Arch/Omarchy). Distro libarrow
-      # (e.g. Arch extra/arrow) often mismatches the CRAN package major and then
-      # pkg-config configure fails. Apache's version-matched prebuilt libarrow is
-      # the reliable automated path — HTTPS from Apache, no interactive steps.
+    # Arrow (R only): CRAN arrow via Apache prebuilt libarrow.
+    def add_arrow_r
+      if profile_marked?('arrow-r') && r_namespace?('arrow')
+        puts 'galaaz add arrow-r: already installed'
+        return 0
+      end
       prepare_arrow_cran_env!
       pkgs = read_pkg_list('arrow.txt')
       install_cran!(pkgs)
+      mark_profile!('arrow-r')
+      puts 'galaaz add arrow-r: OK (R only)'
+      0
+    end
+
+    # Arrow (Ruby): R arrow first, then arrow-glib + red-arrow (CRuby) / JARs tip (JRuby).
+    def add_arrow_ruby
+      if profile_marked?('arrow-ruby') &&
+         (RUBY_ENGINE != 'ruby' || begin
+           Gem::Specification.find_by_name('red-arrow')
+           true
+         rescue Gem::LoadError
+           false
+         end)
+        puts 'galaaz add arrow-ruby: already installed'
+        return 0
+      end
+
+      code = add_arrow_r
+      return code unless code.zero?
+
       if RUBY_ENGINE == 'ruby'
+        ENV['GI_TYPELIB_PATH'] = [
+          '/usr/local/lib/girepository-1.0',
+          ENV['GI_TYPELIB_PATH']
+        ].compact.reject(&:empty?).join(File::PATH_SEPARATOR)
+        ENV['LD_LIBRARY_PATH'] = [
+          '/usr/local/lib',
+          '/usr/local/lib64',
+          ENV['LD_LIBRARY_PATH']
+        ].compact.reject(&:empty?).join(File::PATH_SEPARATOR)
         ENV['PKG_CONFIG_PATH'] = [
           '/usr/local/lib/pkgconfig',
           '/usr/local/lib64/pkgconfig',
+          '/usr/lib/pkgconfig',
           ENV['PKG_CONFIG_PATH']
         ].compact.reject(&:empty?).join(File::PATH_SEPARATOR)
         glib_ok = system('pkg-config', '--exists', 'arrow-glib')
         if glib_ok
-          puts 'galaaz add arrow: gem install red-arrow (CRuby Stage B writer; MAKEFLAGS=-j1)'
-          # Parallel native builds often OOM small Omarchy/TryOmarchy VMs.
+          puts 'galaaz add arrow-ruby: gem install red-arrow (MAKEFLAGS=-j1)'
           ok = system({ 'MAKEFLAGS' => '-j1', 'PKG_CONFIG_PATH' => ENV['PKG_CONFIG_PATH'] },
                       'gem', 'install', 'red-arrow', '--no-document')
           unless ok
-            warn 'galaaz add arrow: red-arrow gem install failed. R arrow is installed; ' \
+            warn 'galaaz add arrow-ruby: red-arrow gem install failed. R arrow is installed; ' \
                  'Ruby IPC writer may be unavailable.'
+            warn 'galaaz add arrow-ruby: profile NOT marked — fix then re-run ' \
+                 '(omarchy-galaaz-arrow-debug status)'
+            return 1
           end
         else
-          warn 'galaaz add arrow: arrow-glib not found (pkg-config); skipping red-arrow. ' \
-               'On Omarchy use omarchy-galaaz-add arrow so Stage B GLib is built first.'
+          warn 'galaaz add arrow-ruby: arrow-glib not found (pkg-config); skipping red-arrow. ' \
+               'On Omarchy use: omarchy-galaaz-add arrow-ruby (builds GLib first).'
+          warn 'galaaz add arrow-ruby: profile NOT marked'
+          return 1
         end
       else
-        warn 'galaaz add arrow: on JRuby, set GALAAZ_ARROW_JARS (or ~/arrow_jars) and JAVA_OPTS nio opens for Arrow Java'
+        warn 'galaaz add arrow-ruby: on JRuby, set GALAAZ_ARROW_JARS (or ~/arrow_jars) ' \
+             'and JAVA_OPTS nio opens for Arrow Java'
       end
-      mark_profile!('arrow')
-      puts 'galaaz add arrow: OK'
+      mark_profile!('arrow-ruby')
+      mark_profile!('arrow') # legacy marker (older menus / scripts)
+      puts 'galaaz add arrow-ruby: OK'
       0
     end
 
@@ -682,7 +759,7 @@ module Galaaz
       ENV['LIBARROW_BUILD'] = 'false'
       # Avoid linking against a mismatched system libarrow (e.g. pacman 24.x vs CRAN 25.x).
       ENV['ARROW_USE_PKG_CONFIG'] = 'false'
-      puts 'galaaz add arrow: LIBARROW_BINARY=true (Apache prebuilt libarrow; no source build)'
+      puts 'galaaz add arrow-r: LIBARROW_BINARY=true (Apache prebuilt libarrow; no source build)'
     end
 
     def add_tex
@@ -736,13 +813,17 @@ module Galaaz
       File.write(File.join(dest, EXAMPLES_MARKER), "galaaz add examples\n")
       mark_profile!('examples')
       puts "galaaz add examples: #{dest}"
+      puts 'Try:'
+      puts "  ruby #{File.join(dest, 'misc', 'ggplot.rb')}"
+      puts "  ruby #{File.join(dest, 'sthda_ggplot', 'one_variable_continuous', 'geom_density.rb')}"
+      puts "  less #{File.join(dest, 'README.md')}"
       0
     end
 
     def add_ledger
-      unless profile_marked?('arrow') || r_namespace?('arrow')
-        puts 'galaaz add ledger: installing arrow profile first'
-        code = add_arrow
+      unless profile_marked?('arrow-ruby') || profile_marked?('arrow')
+        puts 'galaaz add ledger: installing arrow-ruby first (includes Arrow R only)'
+        code = add_arrow_ruby
         return code unless code.zero?
       end
 

data/script/omarchy/README.md

@@ -73,14 +73,16 @@ Core configures **setup + blogs + doctor** using the gem you already installed
 (it does **not** run `gem install` again). It fails if the gatekeeper `.so` is
 missing — “gem installed” alone is not success.
 
-4. After core finishes, the same submenu shows Knit / Arrow / TeX / Bio / Examples / Ledger.
+4. After core finishes, the same submenu shows Knit / Arrow (R only) / Arrow (Ruby) /
+   TeX / Bio / Examples / Ledger.
 
 5. **Ledger (required dogfood / pitch):** Install → Development → **Galaaz → Ledger**
-   (or `omarchy-galaaz-add ledger` / `galaaz add ledger`). That pulls **arrow** if
-   needed using Apache’s **LIBARROW_BINARY** prebuilt libarrow (no manual steps;
-   Arch `pacman` arrow is not used for the R package — version skew breaks
-   configure), clones `~/r_on_rails_ledger`, rewrites any `path:` gem to RubyGems
-   galaaz, then `bundle install` + fast seed.
+   (or `omarchy-galaaz-add ledger` / `galaaz add ledger`). That pulls **arrow-ruby**
+   if needed (Arrow R only first, then arrow-glib / red-arrow). R’s CRAN arrow uses
+   Apache’s **LIBARROW_BINARY** prebuilt libarrow (no manual steps; Arch `pacman`
+   arrow is not used for the R package — version skew breaks configure), clones
+   `~/r_on_rails_ledger`, rewrites any `path:` gem to RubyGems galaaz, then
+   `bundle install` + fast seed.
 
    **Knit / TeX pandoc:** the add wrapper does **not** install Arch `pandoc` /
    `pandoc-cli` (Haskell mega-deps; often fails on TryOmarchy). It uses

data/script/omarchy/galaaz-add.sh

@@ -3,13 +3,13 @@
 # - Installs system deps the gem cannot (e.g. pandoc for knit)
 # - Keeps the TUI open on success/failure so errors are readable
 #
-# Usage: omarchy-galaaz-add knit|arrow|tex|bio|examples|ledger|demo
+# Usage: omarchy-galaaz-add knit|arrow-r|arrow-ruby|arrow|tex|bio|examples|ledger|demo
 set -euo pipefail
 
 PROFILE="${1:-}"
 if [[ -z "${PROFILE}" ]]; then
   echo "Usage: omarchy-galaaz-add <profile>"
-  echo "Profiles: knit arrow tex bio examples ledger demo"
+  echo "Profiles: knit arrow-r arrow-ruby arrow tex bio examples ledger demo"
   exit 1
 fi
 
@@ -142,32 +142,57 @@ pkg_add_synced() {
   return 0
 }
 
-# red-arrow (Stage B) needs pkg-config "arrow" + "arrow-glib" at the same version.
-# Arch ships C++ Arrow (extra/arrow) but not Arrow GLib — build GLib from the
-# matching Apache tarball. Keep ARROW_USE_PKG_CONFIG=false for CRAN R arrow
-# (LIBARROW_BINARY); pacman arrow is only for the Ruby gem.
-#
-# Small Omarchy/TryOmarchy VMs OOM and kill the TUI during unlimited ninja builds.
-# We: default -j1, optional build swap, compile in a systemd user scope, heartbeat.
+# Persist runtime env for red-arrow (typelibs + .so under /usr/local).
+write_arrow_runtime_env() {
+  local dest="${HOME}/.config/galaaz/arrow-env.sh"
+  mkdir -p "$(dirname "${dest}")"
+  cat >"${dest}" <<'EOF'
+# Generated by omarchy-galaaz-add arrow — red-arrow / GObject Introspection
+export GI_TYPELIB_PATH="/usr/local/lib/girepository-1.0${GI_TYPELIB_PATH:+:${GI_TYPELIB_PATH}}"
+export LD_LIBRARY_PATH="/usr/local/lib:/usr/local/lib64${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}"
+export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig:/usr/lib/pkgconfig${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}}"
+EOF
+  # shellcheck disable=SC1090
+  source "${dest}"
+  echo "arrow runtime env: ${dest}"
+}
+
+# red-arrow (Arrow Ruby) needs pkg-config "arrow" + "arrow-glib" at the same version.
+# Arch ships C++ Arrow but not Arrow GLib. We build only c_glib from the Apache
+# tarball against pacman arrow — with a *slim* PKG_CONFIG_PATH so meson does not
+# also link flight/dataset/parquet (those explode RAM on TryOmarchy and kill the TUI).
 ensure_arrow_for_red_arrow() {
   local major ver tmp tarball url build_dir jobs cache log swapfile avail_mb swap_mb
-  local compile_st=0
+  local compile_st=0 pc_slim pc_src free_kb need_kb
+  local trace_log="${HOME}/.local/share/galaaz/arrow-install-trace.log"
   major=25
   jobs="${GALAAZ_ARROW_GLIB_JOBS:-1}"
   cache="${HOME}/.cache/galaaz"
   log="${HOME}/.local/share/galaaz/arrow-glib-build.log"
   swapfile="${cache}/arrow-glib.swap"
-  mkdir -p "${cache}" "$(dirname "${log}")"
+  pc_slim="${cache}/pkgconfig-slim"
+  mkdir -p "${cache}" "$(dirname "${log}")" "$(dirname "${trace_log}")"
+
+  atracel() {
+    echo "[$(date -Iseconds)] $*" | tee -a "${trace_log}"
+    sync 2>/dev/null || true
+  }
+
+  : >"${trace_log}"
+  atracel "ensure_arrow_for_red_arrow start"
+  echo "==> system: Apache Arrow C++ + GLib (Arrow Ruby / red-arrow)"
+  echo "    build log:  ${log}"
+  echo "    trace log:  ${trace_log}"
 
-  echo "==> system: Apache Arrow C++ + GLib (Stage B / red-arrow)"
-  echo "    build log: ${log}"
   export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}}"
 
   if ! command -v pkg-config >/dev/null 2>&1; then
+    atracel "install pkgconf"
     pkg_add_synced pkgconf || return 1
   fi
 
   if ! pkg-config --exists "arrow >= ${major}" 2>/dev/null; then
+    atracel "install Arch package arrow"
     echo "==> install Arch package: arrow"
     if ! pkg_add_synced arrow; then
       echo "ERROR: failed to install Arch arrow (Apache Arrow C++)" >&2
@@ -177,139 +202,161 @@ ensure_arrow_for_red_arrow() {
 
   if ! pkg-config --exists "arrow >= ${major}" 2>/dev/null; then
     echo "ERROR: Apache Arrow C++ >= ${major} still missing after pacman install" >&2
-    echo "  pkg-config --modversion arrow: $(pkg-config --modversion arrow 2>/dev/null || echo none)" >&2
     return 1
   fi
   ver="$(pkg-config --modversion arrow)"
+  atracel "arrow C++ ${ver}"
   echo "arrow (C++): ${ver}"
 
-  if pkg-config --exists "arrow-glib = ${ver}" 2>/dev/null; then
+  if pkg-config --exists "arrow-glib = ${ver}" 2>/dev/null || pkg-config --exists arrow-glib 2>/dev/null; then
+    atracel "arrow-glib already present $(pkg-config --modversion arrow-glib)"
     echo "arrow-glib: $(pkg-config --modversion arrow-glib) (already installed)"
+    write_arrow_runtime_env
     return 0
   fi
 
-  echo "==> Arrow GLib ${ver} missing — building from Apache source (required for Stage B)"
-  echo "    ninja jobs: ${jobs} (override with GALAAZ_ARROW_GLIB_JOBS)"
-  # glib2-devel provides glib-mkenums (split from glib2 on Arch); without it meson fails.
+  atracel "arrow-glib missing — slim source build"
+  echo "==> Arrow GLib ${ver} missing — building slim c_glib from Apache source"
+  echo "    (flight/dataset/parquet disabled via slim pkg-config to avoid OOM)"
   pkg_add_synced meson ninja gobject-introspection glib2 glib2-devel cmake || return 1
 
+  # Slim pkg-config: only core Arrow modules + GLib (hide flight/dataset/parquet/…).
+  rm -rf "${pc_slim}"
+  mkdir -p "${pc_slim}"
+  for mod in arrow arrow-compute arrow-csv arrow-json arrow-filesystem \
+             glib-2.0 gobject-2.0 gio-2.0 gmodule-2.0 gthread-2.0 libffi zlib; do
+    pc_src="$(pkg-config --variable=pcfiledir "${mod}" 2>/dev/null || true)"
+    if [[ -n "${pc_src}" && -f "${pc_src}/${mod}.pc" ]]; then
+      cp "${pc_src}/${mod}.pc" "${pc_slim}/"
+      atracel "pc slim: ${mod}"
+    fi
+  done
+  export PKG_CONFIG_PATH="${pc_slim}:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig"
+  atracel "PKG_CONFIG_PATH=${PKG_CONFIG_PATH}"
+
   avail_mb="$(awk '/MemAvailable:/ {print int($2/1024)}' /proc/meminfo 2>/dev/null || echo 0)"
   swap_mb="$(awk '/SwapFree:/ {print int($2/1024)}' /proc/meminfo 2>/dev/null || echo 0)"
+  atracel "memory MemAvailable=${avail_mb}MiB SwapFree=${swap_mb}MiB"
   echo "    memory: MemAvailable=${avail_mb}MiB SwapFree=${swap_mb}MiB"
-  if (( avail_mb + swap_mb < 3500 )); then
-    echo "==> low RAM — enabling 4GiB build swap at ${swapfile}"
+  if (( avail_mb + swap_mb < 3000 )); then
+    free_kb="$(df -Pk "${cache}" | awk 'NR==2{print $4}')"
+    need_kb=$((2200 * 1024))
+    if [[ -n "${free_kb}" ]] && (( free_kb < need_kb )); then
+      echo "ERROR: need ~2.2GiB free disk under ${cache} for build swap (have $((free_kb/1024))MiB)" >&2
+      atracel "ABORT disk free ${free_kb}KB"
+      return 1
+    fi
+    echo "==> low RAM — enabling 2GiB build swap at ${swapfile}"
+    atracel "create/enable swap ${swapfile}"
     if [[ ! -f "${swapfile}" ]]; then
-      if ! dd if=/dev/zero of="${swapfile}" bs=1M count=4096 status=none; then
-        echo "ERROR: could not create build swap file (need ~4GiB free disk)" >&2
-        return 1
+      if command -v fallocate >/dev/null 2>&1; then
+        fallocate -l 2G "${swapfile}" || dd if=/dev/zero of="${swapfile}" bs=1M count=2048 status=none
+      else
+        dd if=/dev/zero of="${swapfile}" bs=1M count=2048 status=none
       fi
       chmod 600 "${swapfile}"
       mkswap "${swapfile}" >/dev/null
     fi
-    if ! sudo swapon "${swapfile}"; then
-      echo "ERROR: swapon ${swapfile} failed" >&2
+    sudo swapon "${swapfile}" || {
+      echo "ERROR: swapon failed" >&2
       return 1
-    fi
+    }
   fi
 
   tarball="apache-arrow-${ver}.tar.gz"
   url="https://dlcdn.apache.org/arrow/arrow-${ver}/${tarball}"
-  # Prefer ~/.cache over /tmp — /tmp is often tmpfs and competes with the compile for RAM.
   tmp="${cache}/arrow-${ver}-src"
   rm -rf "${tmp}"
   mkdir -p "${tmp}"
   build_dir="${tmp}/apache-arrow-${ver}"
   : >"${log}"
+  atracel "download ${url}"
   echo "==> download: ${url}"
   if ! curl -fsSL -o "${tmp}/${tarball}" "${url}"; then
     url="https://archive.apache.org/dist/arrow/arrow-${ver}/${tarball}"
+    atracel "fallback ${url}"
     echo "==> fallback: ${url}"
     if ! curl -fsSL -o "${tmp}/${tarball}" "${url}"; then
       echo "ERROR: failed to download Apache Arrow ${ver} sources" >&2
       sudo swapoff "${swapfile}" 2>/dev/null || true
-      rm -rf "${tmp}"
       return 1
     fi
   fi
-  if ! tar -xzf "${tmp}/${tarball}" -C "${tmp}"; then
-    echo "ERROR: failed to extract ${tarball}" >&2
+  atracel "extract ${tarball}"
+  tar -xzf "${tmp}/${tarball}" -C "${tmp}" || {
     sudo swapoff "${swapfile}" 2>/dev/null || true
-    rm -rf "${tmp}"
     return 1
-  fi
-  if [[ ! -d "${build_dir}/c_glib" ]]; then
-    echo "ERROR: c_glib missing from ${tarball}" >&2
+  }
+  [[ -d "${build_dir}/c_glib" ]] || {
+    echo "ERROR: c_glib missing" >&2
     sudo swapoff "${swapfile}" 2>/dev/null || true
-    rm -rf "${tmp}"
     return 1
-  fi
+  }
 
-  echo "==> meson setup arrow-glib ${ver}"
+  atracel "meson setup"
+  echo "==> meson setup arrow-glib ${ver} (slim)"
   if ! meson setup "${build_dir}/c_glib.build" "${build_dir}/c_glib" \
       --buildtype=release \
       --prefix=/usr/local \
       -Dgtk_doc=false \
       -Ddoc=false \
       -Dvapi=false >>"${log}" 2>&1; then
-    echo "ERROR: meson setup for arrow-glib failed" >&2
+    echo "ERROR: meson setup failed — see ${log}" >&2
     tail -n 40 "${log}" || true
     sudo swapoff "${swapfile}" 2>/dev/null || true
-    rm -rf "${tmp}"
     return 1
   fi
 
-  echo "==> meson compile arrow-glib ${ver} (-j${jobs}) — can take several minutes"
-  echo "    leave this window open; progress also in ${log}"
-  # Isolate from the TUI cgroup when possible so an OOM kills the build, not the terminal.
+  atracel "meson compile -j${jobs} begin"
+  echo "==> meson compile arrow-glib ${ver} (-j${jobs}) — leave window open"
   set +e
-  if command -v systemd-run >/dev/null 2>&1; then
-    systemd-run --user --scope --quiet \
-      -p MemoryMax=8G \
-      -E "PKG_CONFIG_PATH=${PKG_CONFIG_PATH:-}" \
-      -E "PATH=${PATH}" \
-      meson compile -C "${build_dir}/c_glib.build" -j "${jobs}" >>"${log}" 2>&1 &
-  else
-    meson compile -C "${build_dir}/c_glib.build" -j "${jobs}" >>"${log}" 2>&1 &
-  fi
+  meson compile -C "${build_dir}/c_glib.build" -j "${jobs}" >>"${log}" 2>&1 &
   local compile_pid=$!
   while kill -0 "${compile_pid}" 2>/dev/null; do
-    echo "    … still compiling arrow-glib ($(date +%H:%M:%S))"
-    sleep 20
+    echo "    … compiling arrow-glib ($(date +%H:%M:%S))  log: ${log}"
+    atracel "heartbeat compile pid=${compile_pid}"
+    sleep 15
   done
   wait "${compile_pid}"
   compile_st=$?
   set -e
+  atracel "meson compile exit ${compile_st}"
 
   if [[ "${compile_st}" -ne 0 ]]; then
-    echo "ERROR: meson compile for arrow-glib failed (exit ${compile_st}) — often OOM" >&2
-    echo "  log: ${log}" >&2
-    tail -n 40 "${log}" || true
-    echo "  Retry with more swap free disk, close other apps, or GALAAZ_ARROW_GLIB_JOBS=1" >&2
+    echo "ERROR: meson compile failed (exit ${compile_st})" >&2
+    tail -n 60 "${log}" || true
+    dmesg -T 2>/dev/null | grep -iE 'oom|killed process' | tail -5 || true
     sudo swapoff "${swapfile}" 2>/dev/null || true
-    rm -rf "${tmp}"
     return 1
   fi
 
+  atracel "meson install"
   echo "==> meson install arrow-glib ${ver}"
   if ! sudo meson install -C "${build_dir}/c_glib.build" >>"${log}" 2>&1; then
-    echo "ERROR: meson install for arrow-glib failed" >&2
-    tail -n 40 "${log}" || true
+    echo "ERROR: meson install failed — see ${log}" >&2
     sudo swapoff "${swapfile}" 2>/dev/null || true
-    rm -rf "${tmp}"
     return 1
   fi
-
   sudo ldconfig 2>/dev/null || true
   sudo swapoff "${swapfile}" 2>/dev/null || true
   rm -rf "${tmp}"
 
+  # Restore normal pkg-config path so arrow-glib in /usr/local is visible.
+  export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}}"
   if ! pkg-config --exists "arrow-glib = ${ver}" 2>/dev/null; then
-    echo "ERROR: arrow-glib ${ver} still missing after build" >&2
-    echo "  pkg-config --modversion arrow-glib: $(pkg-config --modversion arrow-glib 2>/dev/null || echo none)" >&2
-    echo "  log: ${log}" >&2
+    # arrow-glib.pc may only need to exist; version equality with slim build
+    if pkg-config --exists arrow-glib 2>/dev/null; then
+      atracel "arrow-glib present $(pkg-config --modversion arrow-glib)"
+      echo "arrow-glib: $(pkg-config --modversion arrow-glib)"
+      return 0
+    fi
+    echo "ERROR: arrow-glib still missing after install" >&2
+    atracel "ABORT arrow-glib missing"
     return 1
   fi
-  echo "arrow-glib: $(pkg-config --modversion arrow-glib) (built from Apache ${ver})"
+  atracel "OK arrow-glib $(pkg-config --modversion arrow-glib)"
+  echo "arrow-glib: $(pkg-config --modversion arrow-glib) (slim build from Apache ${ver})"
+  write_arrow_runtime_env
   return 0
 }
 
@@ -342,10 +389,17 @@ case "${PROFILE}" in
       pause 1
     fi
     ;;
-  arrow|ledger|demo)
-    # R package arrow: do NOT link pacman arrow (version skew vs CRAN) —
-    # LIBARROW_BINARY uses Apache's version-matched prebuilt. pacman arrow +
-    # built arrow-glib are only for CRuby red-arrow (Stage B).
+  arrow-r)
+    # R package arrow only — Apache prebuilt libarrow (no system GLib / red-arrow).
+    export LIBARROW_BINARY=true
+    export NOT_CRAN=true
+    export LIBARROW_BUILD=false
+    export ARROW_USE_PKG_CONFIG=false
+    echo "==> arrow env: LIBARROW_BINARY=true LIBARROW_BUILD=false ARROW_USE_PKG_CONFIG=false"
+    ;;
+  arrow-ruby|arrow|ledger|demo)
+    # Arrow (Ruby) needs R arrow first, then pacman arrow + arrow-glib + red-arrow.
+    # LIBARROW_* is for CRAN R arrow; pacman arrow + glib are for the Ruby gem only.
     export LIBARROW_BINARY=true
     export NOT_CRAN=true
     export LIBARROW_BUILD=false

data/script/omarchy/galaaz-arrow-debug.sh

@@ -0,0 +1,225 @@
+#!/bin/bash
+# Stepwise Arrow/Stage-B diagnostics for Omarchy.
+# Does NOT install by default — prints where things stand and what would run.
+#
+# Usage:
+#   omarchy-galaaz-arrow-debug           # status (safe)
+#   omarchy-galaaz-arrow-debug status
+#   omarchy-galaaz-arrow-debug probe     # light checks + write report
+#   omarchy-galaaz-arrow-debug last-log  # show build log tails + dmesg OOM
+#   omarchy-galaaz-arrow-debug install   # run omarchy-galaaz-add arrow-ruby with tracing
+#
+# Report: ~/.local/share/galaaz/arrow-debug.log
+set -uo pipefail
+
+LOG_DIR="${HOME}/.local/share/galaaz"
+REPORT="${LOG_DIR}/arrow-debug.log"
+BUILD_LOG="${LOG_DIR}/arrow-glib-build.log"
+TRACE="${LOG_DIR}/arrow-install-trace.log"
+mkdir -p "${LOG_DIR}"
+
+export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}}"
+export PATH="${HOME}/.local/bin:${PATH}"
+
+CMD="${1:-status}"
+
+trace() {
+  # shellcheck disable=SC3037
+  echo -e "[$(date -Iseconds)] $*" | tee -a "${REPORT}"
+  sync 2>/dev/null || true
+}
+
+section() {
+  echo | tee -a "${REPORT}"
+  trace "======== $* ========"
+}
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+run_status() {
+  : >"${REPORT}"
+  section "galaaz arrow debug (status)"
+  trace "host: $(uname -a 2>/dev/null || true)"
+  trace "user: $(id -un) home=${HOME}"
+  trace "PATH=${PATH}"
+
+  section "memory / disk"
+  if [[ -r /proc/meminfo ]]; then
+    awk '/MemTotal:|MemAvailable:|SwapTotal:|SwapFree:/ {printf "  %s\n", $0}' /proc/meminfo | tee -a "${REPORT}"
+  fi
+  df -h "${HOME}" /tmp /usr/local 2>/dev/null | tee -a "${REPORT}" || true
+  free -h 2>/dev/null | tee -a "${REPORT}" || true
+
+  section "tools"
+  for c in pacman omarchy-pkg-add pkg-config meson ninja cmake curl sudo systemd-run \
+           galaaz omarchy-galaaz-add ruby gem Rscript mise; do
+    if have "${c}"; then
+      trace "OK  ${c}: $(command -v "${c}")"
+    else
+      trace "MISS ${c}"
+    fi
+  done
+
+  section "pkg-config Arrow"
+  if have pkg-config; then
+    trace "PKG_CONFIG_PATH=${PKG_CONFIG_PATH}"
+    if pkg-config --exists arrow; then
+      trace "OK  arrow: $(pkg-config --modversion arrow)"
+    else
+      trace "MISS arrow (C++)"
+    fi
+    if pkg-config --exists arrow-glib; then
+      trace "OK  arrow-glib: $(pkg-config --modversion arrow-glib)"
+    else
+      trace "MISS arrow-glib (needed for Arrow (Ruby) / red-arrow)"
+    fi
+  fi
+
+  section "Ruby red-arrow gem"
+  if have mise; then
+    mise x ruby -- gem list -e red-arrow 2>/dev/null | tee -a "${REPORT}" || trace "red-arrow: not installed"
+  elif have gem; then
+    gem list -e red-arrow 2>/dev/null | tee -a "${REPORT}" || trace "red-arrow: not installed"
+  fi
+
+  section "R package arrow"
+  if have Rscript; then
+    Rscript -e 'if (requireNamespace("arrow", quietly=TRUE)) cat("OK  R arrow", as.character(packageVersion("arrow")), "\n") else cat("MISS R arrow\n")' 2>&1 | tee -a "${REPORT}"
+  fi
+
+  section "galaaz profile markers"
+  ls -la "${HOME}/.config/galaaz/profiles/" 2>/dev/null | tee -a "${REPORT}" || trace "no profiles dir"
+  if [[ -f "${HOME}/.config/galaaz/profiles/arrow-r" ]]; then
+    trace "OK   profiles/arrow-r (Arrow R only) — menu row disabled"
+  else
+    trace "MISS profiles/arrow-r"
+  fi
+  if [[ -f "${HOME}/.config/galaaz/profiles/arrow-ruby" ]]; then
+    trace "OK   profiles/arrow-ruby (Arrow Ruby) — menu row disabled"
+  else
+    trace "MISS profiles/arrow-ruby"
+  fi
+  if [[ -f "${HOME}/.config/galaaz/profiles/arrow" ]]; then
+    trace "NOTE: legacy profiles/arrow also present"
+  fi
+
+  section "prior build / install logs"
+  for f in "${BUILD_LOG}" "${TRACE}" "${REPORT}"; do
+    if [[ -f "${f}" ]]; then
+      trace "file ${f} ($(wc -c <"${f}") bytes, mtime $(date -r "${f}" -Iseconds 2>/dev/null || true))"
+    fi
+  done
+
+  section "verdict"
+  local a=0 g=0 r=0 ra=0
+  pkg-config --exists arrow 2>/dev/null && a=1
+  pkg-config --exists arrow-glib 2>/dev/null && g=1
+  if have Rscript; then
+    Rscript -e 'quit(status=if (requireNamespace("arrow", quietly=TRUE)) 0 else 1)' 2>/dev/null && r=1 || true
+  fi
+  if have mise; then
+    mise x ruby -- ruby -e 'gem "red-arrow"; puts' 2>/dev/null && ra=1 || true
+  elif have ruby; then
+    ruby -e 'gem "red-arrow"; puts' 2>/dev/null && ra=1 || true
+  fi
+  trace "Arrow (R only):        $([[ ${r} -eq 1 ]] && echo OK || echo MISSING)"
+  trace "Arrow C++ (pkg-config): $([[ ${a} -eq 1 ]] && echo OK || echo MISSING)"
+  trace "Arrow GLib:            $([[ ${g} -eq 1 ]] && echo OK || echo MISSING)"
+  trace "Arrow (Ruby)/red-arrow:$([[ ${ra} -eq 1 ]] && echo OK || echo MISSING)"
+  if [[ ${r} -eq 1 && ${g} -eq 1 && ${ra} -eq 1 ]]; then
+    trace "RESULT: Arrow (R only) + Arrow (Ruby) look OK"
+  elif [[ ${r} -eq 1 ]]; then
+    trace "RESULT: Arrow (R only) OK; Arrow (Ruby) incomplete — menu: Arrow (Ruby)"
+  else
+    trace "RESULT: Arrow not fully installed — start with menu: Arrow (R only)"
+  fi
+  trace "Full report: ${REPORT}"
+}
+
+run_last_log() {
+  section "arrow-glib-build.log (last 80 lines)"
+  if [[ -f "${BUILD_LOG}" ]]; then
+    tail -n 80 "${BUILD_LOG}" | tee -a "${REPORT}"
+  else
+    trace "no ${BUILD_LOG}"
+  fi
+  section "arrow-install-trace.log (last 80 lines)"
+  if [[ -f "${TRACE}" ]]; then
+    tail -n 80 "${TRACE}" | tee -a "${REPORT}"
+  else
+    trace "no ${TRACE}"
+  fi
+  section "kernel OOM / kill hints"
+  dmesg -T 2>/dev/null | grep -iE 'oom|killed process|out of memory' | tail -20 | tee -a "${REPORT}" \
+    || journalctl -k -b --no-pager 2>/dev/null | grep -iE 'oom|killed process|out of memory' | tail -20 | tee -a "${REPORT}" \
+    || trace "(no dmesg/journal access)"
+  trace "Done. Report: ${REPORT}"
+}
+
+run_install() {
+  section "traced install via omarchy-galaaz-add arrow-ruby"
+  trace "If the terminal dies, re-open a terminal and run:"
+  trace "  omarchy-galaaz-arrow-debug last-log"
+  trace "  omarchy-galaaz-arrow-debug status"
+  local add="${HOME}/.local/bin/omarchy-galaaz-add"
+  if [[ ! -x "${add}" ]]; then
+    add="$(command -v omarchy-galaaz-add || true)"
+  fi
+  if [[ -z "${add}" || ! -x "${add}" ]]; then
+    trace "ERROR: omarchy-galaaz-add missing — run: galaaz omarchy install"
+    return 1
+  fi
+  # Clear stale markers so menu/add can redo Arrow (Ruby).
+  for m in arrow arrow-ruby; do
+    if [[ -f "${HOME}/.config/galaaz/profiles/${m}" ]]; then
+      trace "removing incomplete/stale profiles/${m}"
+      rm -f "${HOME}/.config/galaaz/profiles/${m}"
+    fi
+  done
+  export GALAAZ_ARROW_TRACE=1
+  export GALAAZ_ARROW_GLIB_JOBS="${GALAAZ_ARROW_GLIB_JOBS:-1}"
+  trace "exec: GALAAZ_ARROW_TRACE=1 GALAAZ_ARROW_GLIB_JOBS=${GALAAZ_ARROW_GLIB_JOBS} ${add} arrow-ruby"
+  sync
+  "${add}" arrow-ruby
+}
+
+pause_end() {
+  local st=$1
+  echo
+  echo "Report: ${REPORT}"
+  if [[ "${st}" -ne 0 ]]; then
+    echo "FAILED (exit ${st}). Press Enter to close."
+  else
+    echo "OK. Press Enter to close."
+  fi
+  read -r _ || true
+  exit "${st}"
+}
+
+case "${CMD}" in
+  -h|--help|help)
+    sed -n '1,20p' "$0"
+    exit 0
+    ;;
+  status|probe)
+    run_status
+    pause_end 0
+    ;;
+  last-log|logs)
+    : >>"${REPORT}"
+    run_last_log
+    pause_end 0
+    ;;
+  install|add)
+    run_status
+    run_install
+    st=$?
+    run_status
+    pause_end "${st}"
+    ;;
+  *)
+    echo "Unknown command: ${CMD}"
+    echo "Use: status | last-log | install"
+    pause_end 1
+    ;;
+esac

data/script/omarchy/galaaz-guide.sh

@@ -56,11 +56,14 @@ After: galaaz add knit   (Install → Development → Galaaz → Knit)
   Or from the menu:  Knit demo (oh_my)
 
 Other add-ons
-  galaaz add arrow     # Apache Arrow
-  galaaz add ledger    # R-on-Rails demo app → ~/r_on_rails_ledger && bin/dev
-  galaaz add examples  # Ruby examples → ~/galaaz-examples
-  galaaz add tex       # TinyTeX / PDF (large)
-  galaaz add bio       # Bioconductor DESeq2 (large)
+  galaaz add arrow-r      # Arrow (R only) — CRAN arrow / Apache prebuilt
+  galaaz add arrow-ruby   # Arrow (Ruby) — installs R only first, then red-arrow
+  galaaz add ledger       # R-on-Rails demo app → ~/r_on_rails_ledger && bin/dev
+  galaaz add examples     # Ruby examples → ~/galaaz-examples
+                          #   ruby ~/galaaz-examples/misc/ggplot.rb
+                          #   less ~/galaaz-examples/README.md
+  galaaz add tex          # TinyTeX / PDF (large)
+  galaaz add bio          # Bioconductor DESeq2 (large)
 
 Check:  galaaz doctor
 Menu:   Super+Space → Install → Development → Galaaz

data/script/omarchy/install-galaaz.sh

@@ -316,6 +316,11 @@ if [[ -f "${SCRIPT_DIR}/galaaz-gknit.sh" ]]; then
   chmod +x "${HOME}/.local/bin/omarchy-galaaz-gknit"
   log "gknit helper: ${HOME}/.local/bin/omarchy-galaaz-gknit"
 fi
+if [[ -f "${SCRIPT_DIR}/galaaz-arrow-debug.sh" ]]; then
+  cp "${SCRIPT_DIR}/galaaz-arrow-debug.sh" "${HOME}/.local/bin/omarchy-galaaz-arrow-debug"
+  chmod +x "${HOME}/.local/bin/omarchy-galaaz-arrow-debug"
+  log "arrow debug: ${HOME}/.local/bin/omarchy-galaaz-arrow-debug"
+fi
 
 # Nautilus right-click → Scripts → Galaaz → gknit
 NAUTILUS_SCRIPTS_SRC="${SCRIPT_DIR}/nautilus-scripts"

data/script/omarchy/omarchy-menu.jsonc

@@ -54,12 +54,28 @@
     "action": "omarchy-launch-tui omarchy-galaaz-add knit",
     "disabled": "test -f ~/.config/galaaz/profiles/knit"
   },
-  "install.development.galaaz.arrow": {
+  "install.development.galaaz.arrow-r": {
     "icon": "\uE90E",
     "iconFont": "omarchy",
-    "label": "Arrow",
-    "action": "omarchy-launch-tui omarchy-galaaz-add arrow",
-    "disabled": "test -f ~/.config/galaaz/profiles/arrow"
+    "label": "Arrow (R only)",
+    "description": "CRAN arrow via Apache prebuilt libarrow",
+    "action": "omarchy-launch-tui omarchy-galaaz-add arrow-r",
+    "disabled": "test -f ~/.config/galaaz/profiles/arrow-r -o -f ~/.config/galaaz/profiles/arrow"
+  },
+  "install.development.galaaz.arrow-ruby": {
+    "icon": "\uE90E",
+    "iconFont": "omarchy",
+    "label": "Arrow (Ruby)",
+    "description": "R arrow + arrow-glib / red-arrow (installs R only first)",
+    "action": "omarchy-launch-tui omarchy-galaaz-add arrow-ruby",
+    "disabled": "test -f ~/.config/galaaz/profiles/arrow-ruby -o -f ~/.config/galaaz/profiles/arrow"
+  },
+  "install.development.galaaz.arrow-debug": {
+    "icon": "\uE90E",
+    "iconFont": "omarchy",
+    "label": "Arrow debug",
+    "description": "Diagnose R-only / Ruby Arrow; show logs if install crashed",
+    "action": "omarchy-launch-tui omarchy-galaaz-arrow-debug status"
   },
   "install.development.galaaz.bio": {
     "icon": "\uE90E",

data/version.rb

@@ -1,2 +1,2 @@
 $gem_name = "galaaz"
-$version="2.1.10.pre.8"
+$version="2.1.10.pre.10"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: galaaz
 version: !ruby/object:Gem::Version
-  version: 2.1.10.pre.8
+  version: 2.1.10.pre.10
 platform: ruby
 authors:
 - Rodrigo Botafogo
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-09 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: msgpack
@@ -86,11 +87,11 @@ description: |
 email: rodrigo.a.botafogo@gmail.com
 executables:
 - galaaz
-- gbookdown
+- gstudio
 - gknit
-- gknit-draft
+- gbookdown
 - grun
-- gstudio
+- gknit-draft
 extensions: []
 extra_rdoc_files: []
 files:
@@ -250,6 +251,7 @@ files:
 - examples/Bibliography/stats.bib
 - examples/R/calc.R
 - examples/R/java_interop.R
+- examples/README.md
 - examples/bioconductor_deseq2_airway/Documentation/DESeq2-airway-walkthrough.md
 - examples/bioconductor_deseq2_airway/bench_galaaz_three_same_process.rb
 - examples/bioconductor_deseq2_airway/bench_r_three_same_process.R
@@ -446,6 +448,7 @@ files:
 - script/omarchy/fonts/galaaz.ttf
 - script/omarchy/fonts/omarchy-with-galaaz.ttf
 - script/omarchy/galaaz-add.sh
+- script/omarchy/galaaz-arrow-debug.sh
 - script/omarchy/galaaz-gknit.sh
 - script/omarchy/galaaz-guide.sh
 - script/omarchy/install-galaaz.sh
@@ -548,6 +551,7 @@ metadata:
   documentation_uri: https://rbotafogo.github.io/galaaz/
   changelog_uri: https://github.com/rbotafogo/galaaz/blob/galaaz2_0/CHANGELOG.md
   yard.run: yri
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -562,7 +566,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: 'R-on-Rails: tightly couple Ruby and GNU R for data science on the web'
 test_files: []