galaaz 2.1.10.pre.9 → 2.1.10.pre.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 581406d58b67e2d86faf8bf90147b41b2e007717c616ec6729c1564bdfdb2a05
-  data.tar.gz: 28bf5eaf5a53824f952efa110850f419f10906ab8b82d1f976c095b9b8e4b648
+  metadata.gz: 6c17cdef4fee4cef82633cf115d082b71a23f8bc6c837a144cb9377113b4b86a
+  data.tar.gz: 667874709ce613f990909eea6d952270c26019df5d0a21492addcb752c5cae4e
 SHA512:
-  metadata.gz: 8426a17da8b08bbf5615b5c4c770fdd1d82f4fb9a91efd74940ed89ee14d89fad37827ca4fe3d008ab4359c95ab8fc362b05b478c8818e67697df0554c49e7f0
-  data.tar.gz: 243175fd0307965e82c5ad6d2fbb9462319f1f1e9ed36171dce80cb4952ae2cc509d6d7beeb8af9922e48b50147c8496373a1ed4d5d7fb1ca3441983604beea0
+  metadata.gz: e48c834304c88e05905e7a33a5e3bedb8e11447459cfa5688c70848fb475b17ce115de36440a75106508bebba858eab3c73757aab7a6f8614e7292428df34711
+  data.tar.gz: 1111967bc3b3b7ac1de61209889015e5ba5fb3a9bd8a39d983e52273aa9a1f7e2388fcd9b18568a888ad927c6e87cb5df70e7d049ebc6d20184cfa2dadece36c

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## 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

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/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')
@@ -508,14 +508,18 @@ module Galaaz
           false
         end
 
-      puts "  arrow C++:  #{arrow_cpp ? "OK (#{arrow_cpp_ver})" : 'MISSING (Omarchy: menu Arrow installs Arch arrow)'}"
-      puts "  arrow-glib: #{arrow_glib ? "OK (#{arrow_glib_ver})" : 'MISSING (needed for Stage B / red-arrow)'}"
-      puts "  R arrow:    #{r_arrow ? 'OK' : 'MISSING (Stage A)'}"
-      puts "  red-arrow:  #{red ? 'OK' : 'MISSING (Stage B CRuby writer)'}"
+      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:  profiles/arrow is set but Stage B incomplete — menu Arrow is disabled.'
-        puts '              rm ~/.config/galaaz/profiles/arrow then re-run menu Arrow,'
+        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
 
@@ -618,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
@@ -627,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
@@ -671,15 +677,36 @@ 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',
@@ -698,27 +725,29 @@ module Galaaz
         ].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)'
+          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: profile NOT marked — fix Stage B then re-run ' \
+            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: profile NOT marked (Stage B incomplete)'
+          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
 
@@ -730,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
@@ -784,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
 
@@ -157,7 +157,7 @@ EOF
   echo "arrow runtime env: ${dest}"
 }
 
-# red-arrow (Stage B) needs pkg-config "arrow" + "arrow-glib" at the same version.
+# 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).
@@ -180,7 +180,7 @@ ensure_arrow_for_red_arrow() {
 
   : >"${trace_log}"
   atracel "ensure_arrow_for_red_arrow start"
-  echo "==> system: Apache Arrow C++ + GLib (Stage B / red-arrow)"
+  echo "==> system: Apache Arrow C++ + GLib (Arrow Ruby / red-arrow)"
   echo "    build log:  ${log}"
   echo "    trace log:  ${trace_log}"
 
@@ -389,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

@@ -7,7 +7,7 @@
 #   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 with tracing
+#   omarchy-galaaz-arrow-debug install   # run omarchy-galaaz-add arrow-ruby with tracing
 #
 # Report: ~/.local/share/galaaz/arrow-debug.log
 set -uo pipefail
@@ -71,7 +71,7 @@ run_status() {
     if pkg-config --exists arrow-glib; then
       trace "OK  arrow-glib: $(pkg-config --modversion arrow-glib)"
     else
-      trace "MISS arrow-glib (Stage B GLib — required for red-arrow)"
+      trace "MISS arrow-glib (needed for Arrow (Ruby) / red-arrow)"
     fi
   fi
 
@@ -89,10 +89,18 @@ run_status() {
 
   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: profiles/arrow exists → Omarchy menu Arrow row is DISABLED"
-    trace "      If Stage B is incomplete, remove it to re-enable the menu:"
-    trace "      rm ~/.config/galaaz/profiles/arrow"
+    trace "NOTE: legacy profiles/arrow also present"
   fi
 
   section "prior build / install logs"
@@ -114,16 +122,16 @@ run_status() {
   elif have ruby; then
     ruby -e 'gem "red-arrow"; puts' 2>/dev/null && ra=1 || true
   fi
-  trace "Stage A (R arrow):     $([[ ${r} -eq 1 ]] && echo OK || echo MISSING)"
+  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 "Stage B (red-arrow):   $([[ ${ra} -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 Stage A+B look OK"
+    trace "RESULT: Arrow (R only) + Arrow (Ruby) look OK"
   elif [[ ${r} -eq 1 ]]; then
-    trace "RESULT: Stage A OK; Stage B incomplete — menu install still needed for GLib/red-arrow"
+    trace "RESULT: Arrow (R only) OK; Arrow (Ruby) incomplete — menu: Arrow (Ruby)"
   else
-    trace "RESULT: Arrow not fully installed"
+    trace "RESULT: Arrow not fully installed — start with menu: Arrow (R only)"
   fi
   trace "Full report: ${REPORT}"
 }
@@ -149,7 +157,7 @@ run_last_log() {
 }
 
 run_install() {
-  section "traced install via omarchy-galaaz-add arrow"
+  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"
@@ -161,16 +169,18 @@ run_install() {
     trace "ERROR: omarchy-galaaz-add missing — run: galaaz omarchy install"
     return 1
   fi
-  # Clear stale profile so menu/add can redo Stage B.
-  if [[ -f "${HOME}/.config/galaaz/profiles/arrow" ]]; then
-    trace "removing incomplete/stale profiles/arrow so install can run cleanly"
-    rm -f "${HOME}/.config/galaaz/profiles/arrow"
-  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"
+  trace "exec: GALAAZ_ARROW_TRACE=1 GALAAZ_ARROW_GLIB_JOBS=${GALAAZ_ARROW_GLIB_JOBS} ${add} arrow-ruby"
   sync
-  "${add}" arrow
+  "${add}" arrow-ruby
 }
 
 pause_end() {

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/omarchy-menu.jsonc

@@ -54,19 +54,27 @@
     "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",
-    "description": "R arrow + Stage B (arrow-glib / red-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 Stage A/B; show logs if install crashed",
+    "description": "Diagnose R-only / Ruby Arrow; show logs if install crashed",
     "action": "omarchy-launch-tui omarchy-galaaz-arrow-debug status"
   },
   "install.development.galaaz.bio": {

data/version.rb

@@ -1,2 +1,2 @@
 $gem_name = "galaaz"
-$version="2.1.10.pre.9"
+$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.9
+  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
@@ -549,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
@@ -563,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: []