galaaz 2.1.6 → 2.1.8

data/lib/galaaz/cli.rb

@@ -4,6 +4,7 @@ require 'fileutils'
 require 'rbconfig'
 require 'open3'
 require 'time'
+require 'tmpdir'
 
 module Galaaz
   module CLI
@@ -15,6 +16,18 @@ module Galaaz
     DEFAULT_EXAMPLES_DIR = File.join(Dir.home, 'galaaz-examples')
     DEFAULT_LEDGER_DIR = File.join(Dir.home, 'r_on_rails_ledger')
     LEDGER_REPO = 'https://github.com/rbotafogo/r_on_rails_ledger.git'
+    OMARCHY_GITHUB_REPO = 'rbotafogo/galaaz'
+    OMARCHY_DEFAULT_GIT_REF = 'galaaz2_0'
+    # [source under script/omarchy/, dest basename under ~/.local/bin, executable?]
+    OMARCHY_BIN_FILES = [
+      ['install-galaaz.sh', 'omarchy-install-galaaz', true],
+      ['remove-galaaz.sh', 'omarchy-remove-galaaz', true],
+      ['galaaz-add.sh', 'omarchy-galaaz-add', true],
+      ['galaaz-guide.sh', 'omarchy-galaaz-guide', true],
+      ['galaaz-gknit.sh', 'omarchy-galaaz-gknit', true],
+      ['debug-galaaz.sh', 'omarchy-galaaz-debug', true]
+    ].freeze
+    OMARCHY_MENU_FILE = 'omarchy-menu.jsonc'
     BLOGS_MARKER = '.galaaz-blogs'
     EXAMPLES_MARKER = '.galaaz-examples'
     CRAN = 'https://cloud.r-project.org'
@@ -41,6 +54,8 @@ module Galaaz
         cmd_doctor
       when 'add'
         cmd_add(argv[1..])
+      when 'omarchy'
+        cmd_omarchy(argv[1..] || [])
       else
         # Legacy: `galaaz some:rake_task` forwarded to rake (see README / blogs).
         Dir.chdir(root) do
@@ -68,6 +83,9 @@ module Galaaz
           doctor                Report Ruby, R, gatekeeper, Rcpp, sty, profiles
           add PROFILE           Install an add-on (idempotent)
                                 Profiles: #{PROFILES.join(', ')}
+          omarchy [install]     Install Omarchy menu overlay (bundled in gem)
+                                Options: --from-git [--ref REF]
+          omarchy status        Show whether overlay helpers are installed
 
         Legacy: any other argument is passed to rake in the Galaaz root
         (e.g. galaaz master_list:scatter_plot).
@@ -91,10 +109,146 @@ module Galaaz
       mark_profile!('core')
       puts 'galaaz setup: OK'
       puts "You can now run: galaaz doctor"
-      puts 'Omarchy menu: Install → Development → Galaaz (add-ons appear after core)'
+      puts 'On Omarchy: galaaz omarchy   # install menu overlay (gem-bundled)'
       0
     end
 
+    # ---- omarchy overlay ----
+
+    def cmd_omarchy(argv)
+      argv = argv.dup
+      case argv[0]
+      when nil, 'install'
+        argv.shift if argv[0] == 'install'
+        omarchy_install(argv)
+      when 'status'
+        omarchy_status
+      when '-h', '--help', 'help'
+        print_omarchy_help
+        0
+      else
+        if argv[0].to_s.start_with?('-')
+          omarchy_install(argv)
+        else
+          raise CliError, "unknown omarchy subcommand: #{argv[0].inspect} (try: install|status)"
+        end
+      end
+    end
+
+    def print_omarchy_help
+      puts <<~HELP
+        Usage: galaaz omarchy [install|status] [options]
+
+          install           Copy menu helpers from the gem (default)
+          install --from-git [--ref REF]
+                            Pull script/omarchy from GitHub instead of the gem
+                            Default REF: #{OMARCHY_DEFAULT_GIT_REF} (or GALAAZ_OMARCHY_REF)
+          status            Show installed overlay paths
+
+        Writes:
+          ~/.local/bin/omarchy-install-galaaz (and add/remove/guide/gknit/debug)
+          ~/.config/omarchy/extensions/omarchy-menu.jsonc
+
+        Then: Super+Space → Install → Development → Galaaz
+      HELP
+    end
+
+    def omarchy_install(argv)
+      argv = argv.dup
+      from_git = argv.delete('--from-git') || argv.delete('--github')
+      ref = nil
+      if (i = argv.index('--ref'))
+        argv.delete_at(i)
+        ref = argv.delete_at(i)
+        raise CliError, '--ref requires a branch/tag/commit' if ref.nil? || ref.empty?
+      end
+      raise CliError, "unknown omarchy install args: #{argv.join(' ')}" unless argv.empty?
+
+      src =
+        if from_git
+          ref = ENV['GALAAZ_OMARCHY_REF'] if ref.nil? || ref.empty?
+          ref = OMARCHY_DEFAULT_GIT_REF if ref.nil? || ref.empty?
+          fetch_omarchy_overlay_from_git!(ref)
+        else
+          omarchy_overlay_dir_bundled
+        end
+
+      begin
+        install_omarchy_overlay_from!(src)
+      ensure
+        FileUtils.rm_rf(src) if from_git && src && src.start_with?(Dir.tmpdir)
+      end
+      puts 'galaaz omarchy: OK'
+      puts 'Next: Super+Space → Install → Development → Galaaz → Galaaz (core)'
+      puts 'Or: omarchy-install-galaaz'
+      0
+    end
+
+    def omarchy_status
+      bin = File.expand_path('~/.local/bin')
+      menu = File.expand_path('~/.config/omarchy/extensions/omarchy-menu.jsonc')
+      puts 'galaaz omarchy status'
+      OMARCHY_BIN_FILES.each do |_src, dest, _exe|
+        path = File.join(bin, dest)
+        puts "  #{dest}: #{File.file?(path) ? path : 'MISSING'}"
+      end
+      puts "  menu: #{File.file?(menu) ? menu : 'MISSING'}"
+      bundled = File.join(root, 'script', 'omarchy')
+      puts "  gem overlay: #{File.directory?(bundled) ? bundled : 'MISSING (reinstall gem)'}"
+      0
+    end
+
+    def omarchy_overlay_dir_bundled
+      d = File.join(root, 'script', 'omarchy')
+      abort_unless(File.directory?(d), "Omarchy overlay missing from gem (#{d}). Reinstall galaaz.")
+      abort_unless(
+        File.file?(File.join(d, 'install-galaaz.sh')) && File.file?(File.join(d, OMARCHY_MENU_FILE)),
+        "incomplete Omarchy overlay in gem (#{d})"
+      )
+      d
+    end
+
+    def fetch_omarchy_overlay_from_git!(ref)
+      need_cmd!('curl')
+      tmp = Dir.mktmpdir('galaaz-omarchy-')
+      base = "https://raw.githubusercontent.com/#{OMARCHY_GITHUB_REPO}/#{ref}/script/omarchy"
+      puts "galaaz omarchy: fetching #{base}/…"
+      names = OMARCHY_BIN_FILES.map(&:first) + [OMARCHY_MENU_FILE]
+      names.uniq.each do |name|
+        url = "#{base}/#{name}"
+        dest = File.join(tmp, name)
+        ok = system('curl', '-fsSL', '-o', dest, url)
+        unless ok && File.file?(dest) && File.size(dest).positive?
+          FileUtils.rm_rf(tmp)
+          raise CliError, "failed to download #{url} (check --ref #{ref})"
+        end
+        puts "  got #{name}"
+      end
+      tmp
+    end
+
+    def install_omarchy_overlay_from!(src_dir)
+      bin = File.expand_path('~/.local/bin')
+      ext = File.expand_path('~/.config/omarchy/extensions')
+      FileUtils.mkdir_p(bin)
+      FileUtils.mkdir_p(ext)
+
+      OMARCHY_BIN_FILES.each do |src_name, dest_name, executable|
+        src = File.join(src_dir, src_name)
+        abort_unless(File.file?(src), "missing #{src}")
+        dest = File.join(bin, dest_name)
+        FileUtils.cp(src, dest)
+        FileUtils.chmod(0o755, dest) if executable
+        puts "galaaz omarchy: #{dest}"
+      end
+
+      menu_src = File.join(src_dir, OMARCHY_MENU_FILE)
+      abort_unless(File.file?(menu_src), "missing #{menu_src}")
+      menu_dest = File.join(ext, OMARCHY_MENU_FILE)
+      FileUtils.cp(menu_src, menu_dest)
+      puts "galaaz omarchy: #{menu_dest}"
+    end
+
     # ---- blogs ----
 
     def cmd_blogs(argv)
@@ -433,18 +587,26 @@ module Galaaz
 
       Dir.chdir(dest) do
         need_cmd!('bundle')
-        # Lockfile often still pins path: ../galaaz @ an old version — pull latest RubyGems.
+        ensure_ledger_bundler!
+        # Fresh clone: install the full lockfile under the app's Ruby (mise .ruby-version).
+        # Do not run `bundle update` first — that can mix PATH Ruby with app Ruby and skip install.
+        puts 'galaaz add ledger: bundle install'
+        abort_unless(ledger_bundle('install'), 'bundle install failed')
         puts 'galaaz add ledger: bundle update galaaz'
-        unless system('bundle', 'update', 'galaaz')
-          abort_unless(system('bundle', 'install'), 'bundle install failed')
-        end
-        # Setup the gem Bundler will load (not PATH galaaz, which may differ).
+        ledger_bundle('update', 'galaaz') ||
+          warn('galaaz add ledger: bundle update galaaz returned non-zero (continuing with installed galaaz)')
         puts 'galaaz add ledger: bundle exec galaaz setup'
-        system('bundle', 'exec', 'galaaz', 'setup') ||
-          warn('galaaz add ledger: bundle exec galaaz setup returned non-zero; check gatekeeper')
-        abort_unless(system('bin/rails', 'db:prepare'), 'rails db:prepare failed')
-        abort_unless(system('bin/rails', 'db:migrate'), 'rails db:migrate failed')
-        abort_unless(system({ 'SEED_PROFILE' => 'fast' }, 'bin/rails', 'db:seed'), 'rails db:seed failed')
+        unless ledger_bundle('exec', 'galaaz', 'setup')
+          warn('galaaz add ledger: bundle exec galaaz setup failed; trying PATH galaaz setup')
+          system('galaaz', 'setup') ||
+            warn('galaaz add ledger: galaaz setup returned non-zero; check gatekeeper')
+        end
+        abort_unless(ledger_bundle('exec', 'rails', 'db:prepare'), 'rails db:prepare failed')
+        abort_unless(ledger_bundle('exec', 'rails', 'db:migrate'), 'rails db:migrate failed')
+        abort_unless(
+          ledger_bundle_env({ 'SEED_PROFILE' => 'fast' }, 'exec', 'rails', 'db:seed'),
+          'rails db:seed failed'
+        )
       end
 
       mark_profile!('ledger')
@@ -454,6 +616,39 @@ module Galaaz
       0
     end
 
+    # Run bundle under mise so .ruby-version / .tool-versions match Omarchy PATH ruby.
+    def ledger_bundle(*args)
+      if command_present?('mise')
+        system('mise', 'x', '--', 'bundle', *args)
+      else
+        system('bundle', *args)
+      end
+    end
+
+    def ledger_bundle_env(env, *args)
+      if command_present?('mise')
+        system(env, 'mise', 'x', '--', 'bundle', *args)
+      else
+        system(env, 'bundle', *args)
+      end
+    end
+
+    def ensure_ledger_bundler!
+      locked = nil
+      if File.file?('Gemfile.lock')
+        locked = File.read('Gemfile.lock')[/BUNDLED WITH\s+(\d+\.\d+(?:\.\d+)?)/, 1]
+      end
+      puts "galaaz add ledger: ensure bundler#{locked ? " #{locked}" : ''}"
+      if command_present?('mise')
+        cmd = ['mise', 'x', '--', 'gem', 'install', 'bundler', '--no-document']
+        cmd.insert(-2, '-v', locked) if locked
+        system(*cmd) || warn('galaaz add ledger: gem install bundler returned non-zero')
+      elsif locked
+        system('gem', 'install', 'bundler', '-v', locked, '--no-document') ||
+          warn('galaaz add ledger: gem install bundler returned non-zero')
+      end
+    end
+
     # Ledger repo may ship `gem "galaaz", path: "..."`. Standalone installs use RubyGems
     # (CRuby or JRuby), unpinned, so `bundle update galaaz` takes the newest published gem.
     def ensure_ledger_galaaz_gemfile!(gemfile)

data/script/omarchy/README.md

@@ -0,0 +1,94 @@
+# Omarchy dogfood (overlay + scripts)
+
+Not an official Omarchy package. Community overlay for [TryOmarchy](https://tryomarchy.com/)
+or a real Omarchy install. Works **with or without** an upstream Omarchy PR.
+
+## Recommended: `galaaz omarchy` (gem-bundled)
+
+```bash
+gem install galaaz
+galaaz setup
+galaaz omarchy              # A: copy overlay from this gem
+# optional, newer overlay than the gem:
+# galaaz omarchy install --from-git
+# galaaz omarchy install --from-git --ref galaaz2_0
+galaaz omarchy status
+```
+
+Then Super+Space → Install → Development → **Galaaz**.
+
+**Important:** `gem install galaaz` alone does **not** add an Omarchy menu until you run
+`galaaz omarchy` (or an upstream catalog row exists).
+
+## Files
+
+| File | Role |
+|------|------|
+| `install-galaaz.sh` | Core install; always writes `~/.local/share/galaaz/install-core.log` |
+| `galaaz-guide.sh` | Guide / docs / knit-demo helper (`omarchy-galaaz-guide`) |
+| `galaaz-add.sh` | Add-on wrapper (`omarchy-galaaz-add`) — pandoc without Arch Haskell stack |
+| `galaaz-gknit.sh` | Safe HTML gknit helper |
+| `debug-galaaz.sh` | Snapshot doctor/PATH/gem/bridge |
+| `remove-galaaz.sh` | Uninstall gem + marked blogs; leave R |
+| `omarchy-menu.jsonc` | Menu overlay submenu under Install → Development |
+
+After core, the menu includes **Guide (what's next)**, **Documentation (website)**, and **GitHub repository**. After Knit, **Knit demo (oh_my)** runs an example blog.
+
+Docs: https://rbotafogo.github.io/galaaz/ · https://github.com/rbotafogo/galaaz
+
+Heavy CRAN installs (`R.install_and_loads`) and long R (`R::Job.eval` / `script`) run in a
+child `Rscript` so the bridge stays free — see **Background R jobs (`R::Job`)** in the
+README / manual (gem **2.1.8+**).
+
+## Manual copy (legacy)
+
+Only if you cannot run `galaaz omarchy` yet:
+
+```bash
+mkdir -p ~/.local/bin ~/.config/omarchy/extensions
+cp install-galaaz.sh ~/.local/bin/omarchy-install-galaaz
+cp remove-galaaz.sh ~/.local/bin/omarchy-remove-galaaz
+cp galaaz-add.sh ~/.local/bin/omarchy-galaaz-add
+cp galaaz-guide.sh ~/.local/bin/omarchy-galaaz-guide
+cp galaaz-gknit.sh ~/.local/bin/omarchy-galaaz-gknit
+cp debug-galaaz.sh ~/.local/bin/omarchy-galaaz-debug
+cp omarchy-menu.jsonc ~/.config/omarchy/extensions/omarchy-menu.jsonc
+chmod +x ~/.local/bin/omarchy-*
+```
+
+## TryOmarchy steps
+
+1. Install → Development → Ruby on Rails (mise Ruby).
+2. `gem install galaaz && galaaz setup && galaaz omarchy`
+3. Super+Space → search **Galaaz**, or Install → Development → **Galaaz** → **Galaaz (core)**.
+
+That action must finish **gem + setup + blogs + doctor**. 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.
+
+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.
+
+   **Knit / TeX pandoc:** the add wrapper does **not** install Arch `pandoc` /
+   `pandoc-cli` (Haskell mega-deps; often fails on TryOmarchy). It uses
+   `pandoc-bin` when available, else the latest official GitHub linux tarball
+   into `~/.local/bin` (override with `PANDOC_RELEASE_VER=…`).
+
+   Pass when:
+
+   ```bash
+   grep galaaz ~/r_on_rails_ledger/Gemfile   # no path: "../galaaz"
+   test -f ~/.config/galaaz/profiles/ledger
+   cd ~/r_on_rails_ledger && bin/dev
+   ```
+
+   Open http://localhost:3000 → portfolio → **Run stress test** (Local R / Arrow).
+
+6. Before the upstream Omarchy PR: wipe TryOmarchy (`%LOCALAPPDATA%\TryOmarchy`),
+   reinstall, and repeat steps 1–5 on a clean guest (plan Phase E, including Ledger).
+
+See `Documentation/PLAN_OMARCHY_INTEGRATION.md` for full phases and tests (D-T10 / D-T11 / E-T3).

data/script/omarchy/debug-galaaz.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# Collect Galaaz / Omarchy debug info into one file you can paste or copy out.
+# Usage: bash debug-galaaz.sh
+# Writes: ~/.local/share/galaaz/debug.log  (+ Desktop copy if Desktop exists)
+set -u
+
+LOG_DIR="${HOME}/.local/share/galaaz"
+OUT="${LOG_DIR}/debug.log"
+mkdir -p "${LOG_DIR}"
+: >"${OUT}"
+
+say() { echo -e "$*" | tee -a "${OUT}"; }
+
+say "=== galaaz debug $(date -Iseconds) ==="
+say "user=$(id -un) home=${HOME}"
+say "PATH=${PATH}"
+say ""
+
+say "== which =="
+for c in ruby gem mise R Rscript make gcc g++ galaaz omarchy-install-galaaz; do
+  say "  ${c}: $(command -v "${c}" 2>/dev/null || echo MISSING)"
+done
+
+say ""
+say "== versions =="
+{ ruby -v; gem -v; mise -v; R --version | head -1; } >>"${OUT}" 2>&1 || true
+say "RUBY_ENGINE=$(ruby -e 'print RUBY_ENGINE' 2>/dev/null || echo '?')"
+if command -v mise >/dev/null 2>&1; then
+  say "mise ruby -v: $(mise x ruby -- ruby -v 2>/dev/null || echo fail)"
+  say "mise engine: $(mise x ruby -- ruby -e 'print RUBY_ENGINE' 2>/dev/null || echo fail)"
+  mise ls >>"${OUT}" 2>&1 || true
+fi
+
+say ""
+say "== gem galaaz =="
+{
+  gem list galaaz
+  gem which galaaz 2>/dev/null || true
+  ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path" 2>/dev/null || echo 'gem root: FAIL'
+  if command -v mise >/dev/null 2>&1; then
+    echo '--- mise x ruby ---'
+    mise x ruby -- gem list galaaz
+    mise x ruby -- ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path"
+  fi
+} >>"${OUT}" 2>&1 || true
+
+ROOT="$(ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path" 2>/dev/null || true)"
+if [[ -z "${ROOT}" ]] && command -v mise >/dev/null 2>&1; then
+  ROOT="$(mise x ruby -- ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path" 2>/dev/null || true)"
+fi
+say "gem root: ${ROOT:-UNKNOWN}"
+if [[ -n "${ROOT}" ]]; then
+  BRIDGE="${ROOT}/ext/new_bridge"
+  say "bridge: ${BRIDGE}"
+  ls -la "${BRIDGE}" >>"${OUT}" 2>&1 || say "bridge ls FAILED"
+  SO="${BRIDGE}/galaaz_gatekeeper.so"
+  say "gatekeeper: ${SO} exists=$([[ -f ${SO} ]] && echo YES || echo NO)"
+fi
+
+say ""
+say "== galaaz doctor =="
+{
+  command -v galaaz && galaaz doctor
+  [[ -x "${HOME}/.local/bin/galaaz" ]] && echo '--- ~/.local/bin/galaaz ---' && "${HOME}/.local/bin/galaaz" doctor
+  command -v mise && mise x ruby -- ruby -S galaaz doctor
+} >>"${OUT}" 2>&1 || true
+
+say ""
+say "== profiles / blogs =="
+ls -la "${HOME}/.config/galaaz/profiles" >>"${OUT}" 2>&1 || say "no profiles dir"
+ls -la "${HOME}/galaaz-blogs" >>"${OUT}" 2>&1 || say "no galaaz-blogs"
+say "install-core.log present=$([[ -f ${LOG_DIR}/install-core.log ]] && echo YES || echo NO)"
+
+say ""
+say "== prior install-core.log (tail 80) =="
+if [[ -f "${LOG_DIR}/install-core.log" ]]; then
+  tail -n 80 "${LOG_DIR}/install-core.log" | tee -a "${OUT}"
+else
+  say "(none yet — run omarchy-install-galaaz first)"
+fi
+
+for d in "${HOME}/Desktop" "${HOME}/desktop"; do
+  if [[ -d "${d}" ]]; then
+    cp "${OUT}" "${d}/galaaz-debug.log"
+    say "copied to ${d}/galaaz-debug.log"
+  fi
+done
+
+say ""
+say "FULL DEBUG LOG: ${OUT}"
+say "Paste that file contents back for diagnosis."

data/script/omarchy/galaaz-add.sh

@@ -0,0 +1,176 @@
+#!/bin/bash
+# Omarchy wrapper for `galaaz add PROFILE`.
+# - 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
+set -euo pipefail
+
+PROFILE="${1:-}"
+if [[ -z "${PROFILE}" ]]; then
+  echo "Usage: omarchy-galaaz-add <profile>"
+  echo "Profiles: knit arrow tex bio examples ledger demo"
+  exit 1
+fi
+
+GALAAZ="${HOME}/.local/bin/galaaz"
+[[ -x "${GALAAZ}" ]] || GALAAZ="galaaz"
+
+# Prefer user-local bin (installer / static pandoc land here).
+export PATH="${HOME}/.local/bin:${PATH}"
+
+# Official static release — avoid Arch extra/pandoc|pandoc-cli (pulls ~200 Haskell pkgs
+# and often fails on TryOmarchy nested VMs).
+# Default: latest GitHub release. Pin with PANDOC_RELEASE_VER=3.6.4 if needed.
+latest_pandoc_ver() {
+  if [[ -n "${PANDOC_RELEASE_VER:-}" ]]; then
+    echo "${PANDOC_RELEASE_VER}"
+    return 0
+  fi
+  local ver
+  ver="$(
+    curl -fsSL https://api.github.com/repos/jgm/pandoc/releases/latest \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -1
+  )"
+  if [[ -z "${ver}" ]]; then
+    echo "ERROR: could not resolve latest pandoc release from GitHub API" >&2
+    return 1
+  fi
+  echo "${ver}"
+}
+
+# Install pandoc without Arch's Haskell stack. Order:
+# 1) already on PATH  2) AUR pandoc-bin  3) GitHub linux tarball → ~/.local/bin
+ensure_pandoc() {
+  if command -v pandoc >/dev/null 2>&1; then
+    echo "pandoc: $(pandoc --version | head -1) (already installed)"
+    return 0
+  fi
+
+  echo "==> pandoc missing — installing (not Arch pandoc / pandoc-cli)"
+
+  if command -v omarchy-pkg-add >/dev/null 2>&1; then
+    echo "==> try: omarchy-pkg-add pandoc-bin"
+    if omarchy-pkg-add pandoc-bin && command -v pandoc >/dev/null 2>&1; then
+      echo "pandoc: $(pandoc --version | head -1) (pandoc-bin)"
+      return 0
+    fi
+    echo "WARN: pandoc-bin via omarchy-pkg-add failed; trying GitHub binary" >&2
+  elif command -v yay >/dev/null 2>&1; then
+    echo "==> try: yay -S pandoc-bin"
+    if yay -S --noconfirm --needed pandoc-bin && command -v pandoc >/dev/null 2>&1; then
+      echo "pandoc: $(pandoc --version | head -1) (pandoc-bin)"
+      return 0
+    fi
+    echo "WARN: yay pandoc-bin failed; trying GitHub binary" >&2
+  fi
+
+  local arch asset url tmp ver
+  case "$(uname -m)" in
+    x86_64|amd64) arch="amd64" ;;
+    aarch64|arm64) arch="arm64" ;;
+    *)
+      echo "ERROR: unsupported arch $(uname -m) for pandoc binary; install pandoc yourself" >&2
+      return 1
+      ;;
+  esac
+
+  if ! ver="$(latest_pandoc_ver)"; then
+    return 1
+  fi
+  echo "==> pandoc release: ${ver}"
+
+  asset="pandoc-${ver}-linux-${arch}.tar.gz"
+  url="https://github.com/jgm/pandoc/releases/download/${ver}/${asset}"
+  tmp="$(mktemp -d)"
+  echo "==> download: ${url}"
+  if ! curl -fsSL -o "${tmp}/${asset}" "${url}"; then
+    echo "ERROR: failed to download pandoc ${ver}" >&2
+    rm -rf "${tmp}"
+    return 1
+  fi
+  tar -xzf "${tmp}/${asset}" -C "${tmp}"
+  mkdir -p "${HOME}/.local/bin"
+  if ! cp "${tmp}/pandoc-${ver}/bin/pandoc" "${HOME}/.local/bin/pandoc"; then
+    echo "ERROR: pandoc binary missing from tarball" >&2
+    rm -rf "${tmp}"
+    return 1
+  fi
+  chmod +x "${HOME}/.local/bin/pandoc"
+  rm -rf "${tmp}"
+
+  if ! command -v pandoc >/dev/null 2>&1; then
+    echo "ERROR: pandoc still not on PATH after install to ~/.local/bin" >&2
+    return 1
+  fi
+  echo "pandoc: $(pandoc --version | head -1) (~/.local/bin, static)"
+  return 0
+}
+
+pause() {
+  local st=$1
+  echo
+  if [[ "${st}" -ne 0 ]]; then
+    echo "FAILED (exit ${st}). Read the messages above, then press Enter to close."
+  else
+    echo "OK. Press Enter to close."
+  fi
+  read -r _ || true
+  exit "${st}"
+}
+
+echo "=== galaaz add ${PROFILE} ==="
+echo
+
+case "${PROFILE}" in
+  knit)
+    # rmarkdown/gknit need system pandoc >= 2.8 — not shipped by CRAN packages alone.
+    echo "==> system: pandoc"
+    if ! ensure_pandoc; then
+      pause 1
+    fi
+    ;;
+  tex)
+    echo "==> system: pandoc (TinyTeX is installed by galaaz add tex)"
+    if ! ensure_pandoc; then
+      pause 1
+    fi
+    ;;
+  arrow|ledger|demo)
+    # R package arrow: do NOT rely on pacman "arrow" for linking — Arch libarrow
+    # often lags CRAN and breaks configure. galaaz add arrow sets LIBARROW_BINARY
+    # (Apache version-matched prebuilt). Export here too so a stale gem still works
+    # if the user only refreshed this wrapper.
+    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"
+    ;;
+  bio|examples) ;;
+  *)
+    echo "Unknown profile: ${PROFILE}" >&2
+    pause 1
+    ;;
+esac
+
+echo "==> ${GALAAZ} add ${PROFILE}"
+set +e
+"${GALAAZ}" add "${PROFILE}"
+st=$?
+set -e
+
+if [[ "${PROFILE}" == "knit" && "${st}" -eq 0 ]]; then
+  echo
+  echo "Try: gknit ~/galaaz-blogs/oh_my/oh_my.Rmd"
+  echo "Or menu: Knit demo (oh_my)"
+fi
+
+if [[ "${PROFILE}" == "ledger" && "${st}" -eq 0 ]]; then
+  echo
+  echo "Try: cd ~/r_on_rails_ledger && bin/dev"
+  echo "Then http://localhost:3000 — portfolio → Run stress test"
+fi
+
+pause "${st}"