galaaz 2.1.6 → 2.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e648f82c6009651209b9d83f4679a394c1bb37aedaaeab41fc35edbe4a87245b
-  data.tar.gz: '097fec3901ebd4e65d8df655fb365ebae90478c04cada0bd48778fafb2ea7c19'
+  metadata.gz: 8cee9e5a57aa8b29ef17b8b525511b422cf8c06d5d486addaa025c981045f34e
+  data.tar.gz: 2e399270c32d42df217b966c5478434f28e9aa5844db4243ef440d07f162b097
 SHA512:
-  metadata.gz: cc861f04cd57d1730ef7228dc9328a88bf951fd2e49fd704d9198a08a5f2410289cc976d83e05682682bbf136e66e6a0d81bad79e30f6e16fc72c4770e3492c9
-  data.tar.gz: 658fab7d7dcdcd023679439111e15dcdee4ba5a565170fc9b50586687d26b40ca14a508f42e0a181f924c2c1465fa25bd7b13812f0817a7ea702122b741ce995
+  metadata.gz: 5d48ebe0a5e37459dd44237a9c0ceae8809718eb2f3396999ec6bb8123e524bf34f06e6da67467d8a0ef7b2955e99e5fc4099d14a46e56ef08e69cf25ca37c4e
+  data.tar.gz: 5e461b9065b98c347ef94665ecc809717e715da2145ebaab3410c4897c7dbc42df04492a932ada657b2b5767f3074a88c687dea2530875642f69803541b83a6b

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 2.1.7
+
+### Added
+
+- **`galaaz omarchy`**: install the Omarchy menu overlay from files bundled in the gem
+  (`script/omarchy/` → `~/.local/bin` + `~/.config/omarchy/extensions/`).
+- **`galaaz omarchy install --from-git [--ref REF]`**: same install, but pull overlay
+  files from GitHub (default ref `galaaz2_0`, or `GALAAZ_OMARCHY_REF`) without waiting
+  for a new gem release.
+- **`galaaz omarchy status`**: report whether overlay helpers and menu jsonc are present.
+
 ## 2.1.6
 
 ### Fixed

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)

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.7+**).
+
+## 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}"

data/script/omarchy/galaaz-gknit.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# Safe/debug gknit for Omarchy: force HTML, log everything, keep the window open.
+#
+# Usage:
+#   omarchy-galaaz-gknit [path/to/file.Rmd]
+#   omarchy-galaaz-gknit ~/galaaz-blogs/gknit/gknit.Rmd
+#
+# Many shipped blogs list pdf_document before html_document in YAML. A bare
+# `gknit file.Rmd` then tries PDF first (LaTeX) — that often fails hard or OOMs
+# a small VM. This wrapper always requests html_document and tees a log.
+set -uo pipefail
+
+LOG_DIR="${HOME}/.local/share/galaaz"
+LOG="${LOG_DIR}/gknit-debug.log"
+mkdir -p "${LOG_DIR}"
+
+RMD="${1:-${HOME}/galaaz-blogs/oh_my/oh_my.Rmd}"
+if [[ ! -f "${RMD}" ]]; then
+  echo "Missing Rmd: ${RMD}"
+  echo "Press Enter to close..."
+  read -r _ || true
+  exit 1
+fi
+
+{
+  echo "=== gknit debug $(date -Iseconds) ==="
+  echo "rmd: ${RMD}"
+  echo "cwd: $(pwd)"
+  echo "forcing: --output_format html_document"
+  echo "log: ${LOG}"
+  command -v pandoc >/dev/null && pandoc --version | head -1 || echo "pandoc: MISSING"
+  command -v gknit >/dev/null && echo "gknit: $(command -v gknit)" || echo "gknit: via mise/wrapper"
+  free -h 2>/dev/null | head -2 || true
+  echo
+} | tee "${LOG}"
+
+# Prefer HTML explicitly — do not let YAML's pdf_document win.
+set +e
+(
+  cd "$(dirname "${RMD}")" || exit 1
+  base="$(basename "${RMD}")"
+  if command -v mise >/dev/null 2>&1; then
+    mise x ruby -- gknit --output_format html_document --no_clean "${base}"
+  else
+    gknit --output_format html_document --no_clean "${base}"
+  fi
+) 2>&1 | tee -a "${LOG}"
+st=${PIPESTATUS[0]}
+set -e
+
+{
+  echo
+  echo "exit: ${st}"
+  echo "--- recent kernel/OOM hints (if any) ---"
+  dmesg -T 2>/dev/null | grep -iE 'oom|killed process|out of memory' | tail -5 || echo "(no dmesg access or no OOM lines)"
+  html="${RMD%.Rmd}.html"
+  if [[ -f "${html}" ]]; then
+    echo "html: ${html}"
+  else
+    echo "html: not found (knit likely failed before write)"
+  fi
+  echo "FULL LOG: ${LOG}"
+} | tee -a "${LOG}"
+
+echo
+if [[ "${st}" -ne 0 ]]; then
+  echo "FAILED (exit ${st}). Scroll up or: less ${LOG}"
+else
+  echo "OK."
+fi
+echo "Press Enter to close (so a crash mid-run still leaves this log on disk)..."
+read -r _ || true
+exit "${st}"

data/script/omarchy/galaaz-guide.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# Omarchy helpers for Galaaz discovery (docs + example knits).
+# Installed as ~/.local/bin/omarchy-galaaz-guide (and thin aliases).
+set -euo pipefail
+
+DOCS_WEB="https://rbotafogo.github.io/galaaz/"
+DOCS_GH="https://github.com/rbotafogo/galaaz"
+DOCS_README="https://github.com/rbotafogo/galaaz/blob/galaaz2_0/README.md"
+DOCS_OMARCHY="https://github.com/rbotafogo/galaaz/blob/galaaz2_0/script/omarchy/README.md"
+BLOGS="${HOME}/galaaz-blogs"
+GALAAZ_BIN="${HOME}/.local/bin/galaaz"
+[[ -x "${GALAAZ_BIN}" ]] || GALAAZ_BIN="galaaz"
+
+open_url() {
+  local url="$1"
+  # Omarchy Learn menu uses launch-webapp; try browser helpers before xdg-open.
+  if command -v omarchy-launch-webapp >/dev/null 2>&1; then
+    omarchy-launch-webapp "${url}"
+  elif command -v omarchy-launch-browser >/dev/null 2>&1; then
+    omarchy-launch-browser "${url}"
+  elif command -v omarchy-launch-web >/dev/null 2>&1; then
+    omarchy-launch-web "${url}"
+  elif command -v xdg-open >/dev/null 2>&1; then
+    xdg-open "${url}" >/dev/null 2>&1 &
+  elif command -v open >/dev/null 2>&1; then
+    open "${url}"
+  else
+    echo "Open in a browser: ${url}"
+    return 1
+  fi
+}
+
+cmd="${1:-tips}"
+case "${cmd}" in
+  tips|guide|help|"")
+    cat <<EOF
+
+Galaaz — what you can do next
+=============================
+
+Core is installed. Blog sources live in:
+  ${BLOGS}
+
+Documentation
+  Website:  ${DOCS_WEB}
+  GitHub:   ${DOCS_GH}
+  README:   ${DOCS_README}
+
+After: galaaz add knit   (Install → Development → Galaaz → Knit)
+  Needs system pandoc (Omarchy installs it via omarchy-galaaz-add knit).
+  Example knits (HTML — force html_document; bare gknit may try PDF first):
+    gknit --output_format html_document ${BLOGS}/oh_my/oh_my.Rmd
+    gknit --output_format html_document ${BLOGS}/gknit/gknit.Rmd
+    omarchy-galaaz-gknit ${BLOGS}/gknit/gknit.Rmd   # logged, HTML-only, waits
+
+  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)
+
+Check:  galaaz doctor
+Menu:   Super+Space → Install → Development → Galaaz
+
+Heavy CRAN installs / long R (gem 2.1.7+): R::Job keeps the bridge free.
+  See README → “Background R jobs (R::Job)” (${DOCS_README})
+
+EOF
+    if [[ -d "${BLOGS}" ]]; then
+      echo "Blog folders found:"
+      ls -1 "${BLOGS}" 2>/dev/null | sed 's/^/  /' || true
+      echo
+    fi
+    echo "Press Enter to close..."
+    read -r _ || true
+    ;;
+  docs|web)
+    echo "Opening ${DOCS_WEB}"
+    open_url "${DOCS_WEB}"
+    ;;
+  github|gh)
+    echo "Opening ${DOCS_GH}"
+    open_url "${DOCS_GH}"
+    ;;
+  knit-demo|demo)
+    rmd="${BLOGS}/oh_my/oh_my.Rmd"
+    if [[ ! -f "${rmd}" ]]; then
+      echo "Missing ${rmd}"
+      echo "Run core install first (blogs init), then: galaaz add knit"
+      exit 1
+    fi
+    if [[ ! -f "${HOME}/.config/galaaz/profiles/knit" ]]; then
+      echo "Knit profile not installed yet. Run: galaaz add knit"
+      exit 1
+    fi
+    # Prefer debug wrapper (HTML-only + log) when installed.
+    if [[ -x "${HOME}/.local/bin/omarchy-galaaz-gknit" ]]; then
+      exec "${HOME}/.local/bin/omarchy-galaaz-gknit" "${rmd}"
+    fi
+    echo "Knitting demo (HTML only): ${rmd}"
+    if command -v mise >/dev/null 2>&1; then
+      mise x ruby -- gknit --output_format html_document "${rmd}"
+    elif command -v gknit >/dev/null 2>&1; then
+      gknit --output_format html_document "${rmd}"
+    else
+      ruby -S gknit --output_format html_document "${rmd}"
+    fi
+    html="${BLOGS}/oh_my/oh_my.html"
+    if [[ -f "${html}" ]]; then
+      echo "Wrote ${html}"
+      open_url "file://${html}"
+    fi
+    echo "Press Enter to close..."
+    read -r _ || true
+    ;;
+  *)
+    echo "Usage: omarchy-galaaz-guide [tips|docs|github|knit-demo]"
+    exit 1
+    ;;
+esac

data/script/omarchy/install-galaaz.sh

@@ -0,0 +1,308 @@
+#!/bin/bash
+# Omarchy-shaped core installer for Galaaz (R-on-Rails).
+# omarchy:summary=Install Galaaz (R-on-Rails)
+# omarchy:name=galaaz
+#
+# Debug log (always written, even if TUI tee fails):
+#   ~/.local/share/galaaz/install-core.log
+set -euo pipefail
+
+# Optional pin: GALAAZ_GEM_VERSION=2.1.2 omarchy-install-galaaz
+# Default: latest from RubyGems (Omarchy/Rails shape).
+GALAAZ_GEM_VERSION="${GALAAZ_GEM_VERSION:-}"
+LOG_DIR="${HOME}/.local/share/galaaz"
+LOG="${LOG_DIR}/install-core.log"
+mkdir -p "${LOG_DIR}"
+
+# Plain file logging — process-substitution tee often dies under omarchy-launch-tui.
+: >"${LOG}"
+log() {
+  # shellcheck disable=SC3037
+  echo -e "$*" | tee -a "${LOG}"
+}
+log_cmd() {
+  log "+ $*"
+  # Capture status without aborting set -e mid-pipeline awkwardly
+  set +e
+  "$@" >>"${LOG}" 2>&1
+  local st=$?
+  set -e
+  if [[ ${st} -ne 0 ]]; then
+    log "ERROR: command failed (exit ${st}): $*"
+    log "---- last 40 log lines ----"
+    tail -n 40 "${LOG}" | tee -a /dev/tty 2>/dev/null || tail -n 40 "${LOG}"
+  fi
+  return "${st}"
+}
+
+on_err() {
+  local st=$?
+  log ""
+  log "FAILED (exit ${st}) at line ${BASH_LINENO[0]:-?} — see full log:"
+  log "  ${LOG}"
+  log "Copy out with: cat ${LOG}"
+  exit "${st}"
+}
+trap on_err ERR
+
+log "=== galaaz core install $(date -Iseconds) ==="
+log "log file: ${LOG}"
+log "script: ${BASH_SOURCE[0]}"
+log "pwd: $(pwd)"
+log "user: $(id -un) home=${HOME}"
+log "PATH: ${PATH}"
+log "GALAAZ_GEM_VERSION=${GALAAZ_GEM_VERSION:-latest}"
+log ""
+
+pkg_add() {
+  if command -v omarchy-pkg-add >/dev/null 2>&1; then
+    log_cmd omarchy-pkg-add "$@"
+  elif command -v pacman >/dev/null 2>&1; then
+    log_cmd sudo pacman -S --noconfirm --needed "$@"
+  else
+    log "WARN: skipping Arch packages ($*); install GNU R + build tools yourself"
+  fi
+}
+
+log "==> packages"
+pkg_add r make gcc gcc-libs libyaml pkgconf
+
+if ! command -v ruby >/dev/null 2>&1; then
+  if command -v mise >/dev/null 2>&1; then
+    mise settings add ruby.compile false 2>/dev/null || true
+    mise settings add idiomatic_version_file_enable_tools ruby 2>/dev/null || true
+    log_cmd mise use --global ruby@latest
+  else
+    log "ERROR: ruby not found and mise missing"
+    exit 1
+  fi
+fi
+
+if command -v mise >/dev/null 2>&1; then
+  if ! mise x ruby -- ruby -e 'exit(RUBY_ENGINE == "ruby" ? 0 : 1)' 2>/dev/null; then
+    log "Active Ruby is not CRuby; installing MRI via mise..."
+    mise use --global ruby@3.4 2>/dev/null || mise use --global ruby@latest
+  fi
+  if ! mise x ruby -- ruby -e 'exit(RUBY_ENGINE == "ruby" ? 0 : 1)'; then
+    log "ERROR: need CRuby (MRI) for the gatekeeper .so"
+    mise x ruby -- ruby -v >>"${LOG}" 2>&1 || true
+    exit 1
+  fi
+fi
+
+if ! command -v R >/dev/null 2>&1 || ! command -v Rscript >/dev/null 2>&1; then
+  log "ERROR: R/Rscript missing after package install"
+  log "which R: $(command -v R || echo none) Rscript: $(command -v Rscript || echo none)"
+  exit 1
+fi
+
+log "R: $(R --version 2>/dev/null | head -1)"
+log "RHOME: $(R RHOME 2>/dev/null || echo '?')"
+log "ruby: $(mise x ruby -- ruby -v 2>/dev/null || ruby -v)"
+log "engine: $(mise x ruby -- ruby -e 'print RUBY_ENGINE' 2>/dev/null || ruby -e 'print RUBY_ENGINE')"
+
+# Arch/Omarchy: system R library (/usr/lib/R/library) is root-only.
+# Without a user lib, install.packages("Rcpp") fails with "lib is not writable".
+ensure_user_r_lib() {
+  export R_LIBS_USER="${R_LIBS_USER:-${HOME}/.local/lib/R/library}"
+  mkdir -p "${R_LIBS_USER}"
+  local renviron="${HOME}/.Renviron"
+  if [[ ! -f "${renviron}" ]] || ! grep -q '^R_LIBS_USER=' "${renviron}" 2>/dev/null; then
+    echo "R_LIBS_USER=${R_LIBS_USER}" >>"${renviron}"
+  fi
+  log "R_LIBS_USER=${R_LIBS_USER}"
+  log "Renviron: ${renviron}"
+}
+ensure_user_r_lib
+
+{
+  echo "---- R CMD config ----"
+  R CMD config CXX || true
+  R CMD config CXXFLAGS || true
+  R CMD config --cppflags || true
+  R CMD config --ldflags || true
+  echo "---- which ----"
+  command -v make; command -v gcc; command -v g++; command -v mise || true
+  command -v ruby; command -v gem || true
+  mise ls 2>/dev/null || true
+  echo "---- .libPaths ----"
+  Rscript -e '.libPaths()' || true
+} >>"${LOG}" 2>&1
+
+echo "gem: --no-document" >"${HOME}/.gemrc"
+
+run_ruby() {
+  if command -v mise >/dev/null 2>&1; then
+    mise x ruby -- "$@"
+  else
+    "$@"
+  fi
+}
+
+gem_root() {
+  run_ruby ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path"
+}
+
+gatekeeper_path() {
+  run_ruby ruby -e "puts File.join(Gem::Specification.find_by_name('galaaz').full_gem_path, 'ext', 'new_bridge', 'galaaz_gatekeeper.so')"
+}
+
+# Invoke gem CLI without `ruby -S galaaz` (that finds ~/.local/bin/galaaz wrapper).
+galaaz_cli() {
+  run_ruby ruby -e 'load Gem.activate_bin_path("galaaz", "galaaz")' -- "$@"
+}
+
+install_wrapper() {
+  mkdir -p "${HOME}/.local/bin"
+  cat >"${HOME}/.local/bin/galaaz" <<'WRAP'
+#!/bin/bash
+set -euo pipefail
+# Do not use `ruby -S galaaz`: PATH often includes this wrapper → LoadError.
+if command -v mise >/dev/null 2>&1; then
+  exec mise x ruby -- ruby -e 'load Gem.activate_bin_path("galaaz", "galaaz")' -- "$@"
+fi
+exec ruby -e 'load Gem.activate_bin_path("galaaz", "galaaz")' -- "$@"
+WRAP
+  chmod +x "${HOME}/.local/bin/galaaz"
+  log "wrapper: ${HOME}/.local/bin/galaaz"
+}
+
+run_ruby gem uninstall galaaz -x -a --ignore-dependencies >>"${LOG}" 2>&1 || true
+if [[ -n "${GALAAZ_GEM_VERSION}" ]]; then
+  log "==> gem install galaaz -v ${GALAAZ_GEM_VERSION}"
+  set +e
+  run_ruby gem install galaaz -v "${GALAAZ_GEM_VERSION}" --no-document --source https://rubygems.org 2>&1 | tee -a "${LOG}"
+  st=${PIPESTATUS[0]}
+  set -e
+  [[ ${st} -eq 0 ]] || exit "${st}"
+else
+  LATEST="$(curl -fsSL https://rubygems.org/api/v1/versions/galaaz/latest.json 2>/dev/null \
+    | sed -n 's/.*"version":"\([^"]*\)".*/\1/p' || true)"
+  if [[ -n "${LATEST}" ]]; then
+    log "==> gem install galaaz ${LATEST} (latest on RubyGems)"
+  else
+    log "==> gem install galaaz (latest on RubyGems)"
+  fi
+  set +e
+  run_ruby gem install galaaz --no-document --source https://rubygems.org 2>&1 | tee -a "${LOG}"
+  st=${PIPESTATUS[0]}
+  set -e
+  [[ ${st} -eq 0 ]] || exit "${st}"
+fi
+
+INSTALLED="$(run_ruby ruby -e "puts Gem::Specification.find_by_name('galaaz').version")"
+log "installed galaaz ${INSTALLED}"
+
+ROOT="$(gem_root)"
+BRIDGE="${ROOT}/ext/new_bridge"
+log "gem root: ${ROOT}"
+log "bridge: ${BRIDGE}"
+ls -la "${BRIDGE}" >>"${LOG}" 2>&1 || true
+if [[ ! -f "${BRIDGE}/Makefile" ]]; then
+  log "ERROR: bridge Makefile missing: ${BRIDGE}/Makefile"
+  exit 1
+fi
+
+log "==> ensure Rcpp (CRAN, user library)"
+log_cmd Rscript -e "
+  lib <- Sys.getenv('R_LIBS_USER')
+  if (!nzchar(lib)) lib <- file.path(Sys.getenv('HOME'), '.local', 'lib', 'R', 'library')
+  dir.create(lib, recursive=TRUE, showWarnings=FALSE)
+  .libPaths(c(lib, .libPaths()))
+  if (!requireNamespace('Rcpp', quietly=TRUE))
+    install.packages('Rcpp', lib=lib, repos='https://cloud.r-project.org')
+  cat('Rcpp=', requireNamespace('Rcpp', quietly=TRUE), ' lib=', lib, '\n', sep='')
+  if (!requireNamespace('Rcpp', quietly=TRUE)) quit(status=1)
+"
+
+log "==> build gatekeeper (make -C ext/new_bridge)"
+rm -f "${BRIDGE}/galaaz_gatekeeper.so" "${BRIDGE}"/*.o
+
+# Older gems hardcoded -L$(R_HOME)/lib -lR which fails on Arch (RHOME=/usr/lib64/R).
+# 2.1.2+ ships a fixed Makefile; still override LDFLAGS for safety.
+R_LDFLAGS="$(R CMD config --ldflags)"
+log "R CMD config --ldflags: ${R_LDFLAGS}"
+log "Rcpp include: $(Rscript -e "cat(system.file('include', package='Rcpp'))")"
+if grep -q 'LDFLAGS := -L\$(R_HOME)/lib -lR' "${BRIDGE}/Makefile" 2>/dev/null; then
+  log "patching gem Makefile LDFLAGS for Arch/Omarchy"
+  sed -i 's|^LDFLAGS := -L\$(R_HOME)/lib -lR.*|LDFLAGS := \$(shell R CMD config --ldflags) -Wl,-rpath,\$(R_HOME)/lib|' "${BRIDGE}/Makefile" || true
+fi
+
+set +e
+make -C "${BRIDGE}" all LDFLAGS="${R_LDFLAGS} -Wl,-rpath,$(R RHOME)/lib" 2>&1 | tee -a "${LOG}"
+make_st=${PIPESTATUS[0]}
+set -e
+if [[ ${make_st} -ne 0 ]]; then
+  log "ERROR: make failed (exit ${make_st}) — retry verbose"
+  make -C "${BRIDGE}" all LDFLAGS="${R_LDFLAGS} -Wl,-rpath,$(R RHOME)/lib" 2>&1 | tee -a "${LOG}" || true
+  log "---- bridge dir ----"
+  ls -la "${BRIDGE}" 2>&1 | tee -a "${LOG}" || true
+  log "Full log: ${LOG}"
+  exit 1
+fi
+
+SO="$(gatekeeper_path)"
+log "expected so: ${SO}"
+ls -la "${SO}" >>"${LOG}" 2>&1 || true
+if [[ ! -f "${SO}" ]]; then
+  log "ERROR: gatekeeper missing after make"
+  ls -la "${BRIDGE}" 2>&1 | tee -a "${LOG}" || true
+  exit 1
+fi
+log "gatekeeper OK: ${SO}"
+
+log "==> galaaz setup (CLI)"
+galaaz_cli setup >>"${LOG}" 2>&1 || log "WARN: galaaz setup non-zero (so exists; continuing)"
+
+log "==> galaaz blogs init"
+galaaz_cli blogs init "${HOME}/galaaz-blogs" >>"${LOG}" 2>&1
+
+install_wrapper
+
+log "==> doctor"
+export PATH="${HOME}/.local/bin:${PATH}"
+hash -r 2>/dev/null || true
+if ! "${HOME}/.local/bin/galaaz" doctor >>"${LOG}" 2>&1; then
+  log "ERROR: doctor incomplete"
+  log "so exists=$([[ -f ${SO} ]] && echo yes || echo no)"
+  "${HOME}/.local/bin/galaaz" doctor 2>&1 | tee -a "${LOG}" || true
+  exit 1
+fi
+"${HOME}/.local/bin/galaaz" doctor 2>&1 | tee -a "${LOG}" || true
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+mkdir -p "${HOME}/.config/omarchy/extensions" "${HOME}/.local/bin"
+if [[ -f "${SCRIPT_DIR}/omarchy-menu.jsonc" ]]; then
+  cp "${SCRIPT_DIR}/omarchy-menu.jsonc" "${HOME}/.config/omarchy/extensions/omarchy-menu.jsonc"
+fi
+cp "${BASH_SOURCE[0]}" "${HOME}/.local/bin/omarchy-install-galaaz"
+chmod +x "${HOME}/.local/bin/omarchy-install-galaaz"
+if [[ -f "${SCRIPT_DIR}/remove-galaaz.sh" ]]; then
+  cp "${SCRIPT_DIR}/remove-galaaz.sh" "${HOME}/.local/bin/omarchy-remove-galaaz"
+  chmod +x "${HOME}/.local/bin/omarchy-remove-galaaz"
+fi
+if [[ -f "${SCRIPT_DIR}/galaaz-guide.sh" ]]; then
+  cp "${SCRIPT_DIR}/galaaz-guide.sh" "${HOME}/.local/bin/omarchy-galaaz-guide"
+  chmod +x "${HOME}/.local/bin/omarchy-galaaz-guide"
+  log "guide: ${HOME}/.local/bin/omarchy-galaaz-guide"
+fi
+if [[ -f "${SCRIPT_DIR}/galaaz-add.sh" ]]; then
+  cp "${SCRIPT_DIR}/galaaz-add.sh" "${HOME}/.local/bin/omarchy-galaaz-add"
+  chmod +x "${HOME}/.local/bin/omarchy-galaaz-add"
+  log "add helper: ${HOME}/.local/bin/omarchy-galaaz-add"
+fi
+if [[ -f "${SCRIPT_DIR}/galaaz-gknit.sh" ]]; then
+  cp "${SCRIPT_DIR}/galaaz-gknit.sh" "${HOME}/.local/bin/omarchy-galaaz-gknit"
+  chmod +x "${HOME}/.local/bin/omarchy-galaaz-gknit"
+  log "gknit helper: ${HOME}/.local/bin/omarchy-galaaz-gknit"
+fi
+
+mkdir -p "${HOME}/.config/galaaz/profiles"
+date -Iseconds >"${HOME}/.config/galaaz/profiles/core"
+
+log ""
+log "Core install complete."
+log "Next: Super+Space → Install → Development → Galaaz → Guide (what's next)"
+log "Docs: https://rbotafogo.github.io/galaaz/"
+log "FULL LOG: ${LOG}"
+log "Done!"

data/script/omarchy/omarchy-menu.jsonc

@@ -0,0 +1,92 @@
+{
+  // Galaaz overlay for ~/.config/omarchy/extensions/omarchy-menu.jsonc
+  // Copy/merge into that path on TryOmarchy. Whole-line // comments only.
+  //
+  // Use ~/.local/bin/galaaz (installer wrapper). Do not quote the whole
+  // "galaaz add …" as one word — omarchy-launch-tui then does nothing useful.
+
+  "install.development.galaaz": {
+    "icon": "󰫏",
+    "label": "Galaaz",
+    "description": "R on Rails"
+  },
+  "install.development.galaaz.core": {
+    "icon": "󰫏",
+    "label": "Galaaz (core)",
+    "description": "gem + setup + blogs (not just gem install)",
+    "action": "omarchy-launch-tui omarchy-install-galaaz",
+    "disabled": "test -f ~/.config/galaaz/profiles/core"
+  },
+  "install.development.galaaz.guide": {
+    "icon": "󰋗",
+    "label": "Guide (what's next)",
+    "description": "Example knits, docs links, add-ons",
+    "action": "omarchy-launch-tui omarchy-galaaz-guide",
+    "when": "test -f ~/.config/galaaz/profiles/core"
+  },
+  "install.development.galaaz.docs": {
+    "icon": "󰂺",
+    "label": "Documentation (website)",
+    "description": "Open rbotafogo.github.io/galaaz",
+    "action": "omarchy-launch-webapp https://rbotafogo.github.io/galaaz/",
+    "when": "test -f ~/.config/galaaz/profiles/core"
+  },
+  "install.development.galaaz.github": {
+    "icon": "󰊤",
+    "label": "GitHub repository",
+    "description": "Open github.com/rbotafogo/galaaz",
+    "action": "omarchy-launch-webapp https://github.com/rbotafogo/galaaz",
+    "when": "test -f ~/.config/galaaz/profiles/core"
+  },
+  "install.development.galaaz.knit": {
+    "icon": "󰫏",
+    "label": "Knit (HTML blogs)",
+    "description": "pandoc + knitr/rmarkdown",
+    "action": "omarchy-launch-tui omarchy-galaaz-add knit",
+    "disabled": "test -f ~/.config/galaaz/profiles/knit"
+  },
+  "install.development.galaaz.knit-demo": {
+    "icon": "󰐊",
+    "label": "Knit demo (oh_my)",
+    "description": "gknit ~/galaaz-blogs/oh_my/oh_my.Rmd",
+    "action": "omarchy-launch-tui omarchy-galaaz-guide knit-demo",
+    "when": "test -f ~/.config/galaaz/profiles/knit"
+  },
+  "install.development.galaaz.arrow": {
+    "icon": "󰫏",
+    "label": "Arrow",
+    "action": "omarchy-launch-tui omarchy-galaaz-add arrow",
+    "disabled": "test -f ~/.config/galaaz/profiles/arrow"
+  },
+  "install.development.galaaz.tex": {
+    "icon": "󰫏",
+    "label": "TeX (PDF blogs)",
+    "action": "omarchy-launch-tui omarchy-galaaz-add tex",
+    "disabled": "test -f ~/.config/galaaz/profiles/tex"
+  },
+  "install.development.galaaz.bio": {
+    "icon": "󰫏",
+    "label": "Bioconductor (DESeq2)",
+    "action": "omarchy-launch-tui omarchy-galaaz-add bio",
+    "disabled": "test -f ~/.config/galaaz/profiles/bio"
+  },
+  "install.development.galaaz.examples": {
+    "icon": "󰫏",
+    "label": "Examples",
+    "action": "omarchy-launch-tui omarchy-galaaz-add examples",
+    "disabled": "test -f ~/.config/galaaz/profiles/examples"
+  },
+  "install.development.galaaz.ledger": {
+    "icon": "󰫏",
+    "label": "Ledger (R-on-Rails demo)",
+    "description": "Clone app, seed, bin/dev",
+    "action": "omarchy-launch-tui omarchy-galaaz-add ledger",
+    "disabled": "test -f ~/.config/galaaz/profiles/ledger"
+  },
+  "remove.development.galaaz": {
+    "icon": "󰫏",
+    "label": "Galaaz",
+    "description": "Core gem (add-on R packages stay)",
+    "action": "omarchy-launch-tui omarchy-remove-galaaz"
+  }
+}

data/script/omarchy/remove-galaaz.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Remove Galaaz core gem + blogs we created. Leaves Ruby, R, and add-on R packages.
+set -euo pipefail
+
+echo -e "Removing Galaaz...\n"
+
+run_ruby() {
+  if command -v mise >/dev/null 2>&1; then
+    mise x ruby -- "$@"
+  else
+    "$@"
+  fi
+}
+
+if command -v gem >/dev/null 2>&1 || command -v mise >/dev/null 2>&1; then
+  run_ruby gem uninstall galaaz -x -a --ignore-dependencies 2>/dev/null || true
+fi
+
+blogs="${HOME}/galaaz-blogs"
+if [[ -f "${blogs}/.galaaz-blogs" ]]; then
+  echo "Removing ${blogs} (galaaz blogs marker present)"
+  rm -rf "${blogs}"
+else
+  echo "Leaving ${blogs} untouched (no .galaaz-blogs marker)"
+fi
+
+# Profile markers only — do not uninstall CRAN/Bioconductor/TinyTeX.
+if [[ -d "${HOME}/.config/galaaz/profiles" ]]; then
+  rm -rf "${HOME}/.config/galaaz/profiles"
+  echo "Cleared ~/.config/galaaz/profiles"
+fi
+
+echo -e "\nNote: GNU R and language packages (arrow, knitr, …) were left installed."
+echo "Done!"

data/version.rb

@@ -1,2 +1,2 @@
 $gem_name = "galaaz"
-$version="2.1.6"
+$version="2.1.7"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: galaaz
 version: !ruby/object:Gem::Version
-  version: 2.1.6
+  version: 2.1.7
 platform: ruby
 authors:
 - Rodrigo Botafogo
@@ -394,6 +394,14 @@ files:
 - r_requires/knit-extras.txt
 - r_requires/knit.txt
 - r_requires/knitr.rb
+- script/omarchy/README.md
+- script/omarchy/debug-galaaz.sh
+- script/omarchy/galaaz-add.sh
+- script/omarchy/galaaz-gknit.sh
+- script/omarchy/galaaz-guide.sh
+- script/omarchy/install-galaaz.sh
+- script/omarchy/omarchy-menu.jsonc
+- script/omarchy/remove-galaaz.sh
 - specs/all.rb
 - specs/arrow_from_ruby_batches_spec.rb
 - specs/arrow_ipc_export_spec.rb