hiiro 0.1.333 → 0.1.334

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95465d649a9d286d4b0cb434cf889fe03d225b8ec4227fa108864fdf5130c65a
-  data.tar.gz: 8104f616921af22bba7de68002157ee22b7cecd20dc6333490403d7769ea7469
+  metadata.gz: 1393ef224407fe149858ba4e6ab28d25d9b1ea8234c38295b7248db64f05fc18
+  data.tar.gz: 0cb6c207d70bc9b366fe82ad91b0f22d48a3e23d0efd58bb4ce5a9746deb5935
 SHA512:
-  metadata.gz: 2785db9671bc137c09d2ec024b2fb807c121f6ff17c3ea19bb649949bdca925f0acf38e9ed3528d49a57ab3d7aabb138afaa454d57abc94fbfba9d49d1ab48d7
-  data.tar.gz: 452ca83fce6bb36d69e63ff82d3464c8b2dfc6edac54883e8880f666b3e148566a5cfe8f07d2c710f7da988ad882f168d7aea102c5b105ce757c12895789556f
+  metadata.gz: e5c17a94ccb9381d940fd594b7c5736433c565c99e78a003b2cf02c6993bf59d727a212e0e98e64ba79812b6b608f9e3472c86702fdb59972fc0d3c5cd9254cb
+  data.tar.gz: 1bce72784775186056d106cb55aa253ea9a0ce0fb5fef4b3c9b6800b37e822a7b0ff0be4cabcb5f46b64ae89733b23c3b9ecb7988391c9d8cf8f1e2536ff707c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.334] - 2026-04-07
+
+### Added
+- New `h-ps` bin file for process utilities:
+  - `search <pattern>` - find processes matching a substring
+  - `indir <path> [path2 ...]` - list processes with files open in specified paths
+  - `getdir <pattern>` - list working directories of processes matching pattern
+
 ## [0.1.333] - 2026-04-04
 
 ### Changed

data/bin/h-ps

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+
+require "hiiro"
+
+Hiiro.run(*ARGV) do
+  add_subcmd(:search) { |pattern = nil|
+    if pattern.nil?
+      puts "Usage: h ps search <pattern>"
+      next
+    end
+
+    output = `ps auxww`.lines
+    header = output.first
+    matches = output[1..].select { |line| line.include?(pattern) }
+
+    if matches.any?
+      puts header
+      matches.each { |line| puts line }
+    else
+      puts "No processes found matching '#{pattern}'"
+    end
+  }
+
+  add_subcmd(:indir) { |*paths|
+    if paths.empty?
+      puts "Usage: h ps indir <path> [path2 ...]"
+      next
+    end
+
+    pids = Set.new
+    paths.each do |path|
+      expanded = File.expand_path(path)
+      lsof_output = `lsof +D #{expanded.shellescape} 2>/dev/null`.lines[1..]
+      next unless lsof_output
+
+      lsof_output.each do |line|
+        fields = line.split
+        pids << fields[1] if fields[1]
+      end
+    end
+
+    if pids.empty?
+      puts "No processes found with files open in: #{paths.join(', ')}"
+      next
+    end
+
+    ps_output = `ps auxww`.lines
+    header = ps_output.first
+    matches = ps_output[1..].select { |line| pids.include?(line.split[1]) }
+
+    puts header
+    matches.each { |line| puts line }
+  }
+
+  add_subcmd(:getdir) { |pattern = nil|
+    if pattern.nil?
+      puts "Usage: h ps getdir <pattern>"
+      next
+    end
+
+    ps_output = `ps auxww`.lines
+    pids = ps_output[1..].select { |line| line.include?(pattern) }.map { |line| line.split[1] }
+
+    if pids.empty?
+      puts "No processes found matching '#{pattern}'"
+      next
+    end
+
+    dirs = {}
+    pids.each do |pid|
+      cwd = `lsof -p #{pid} 2>/dev/null | grep cwd`.strip
+      if cwd && !cwd.empty?
+        # lsof cwd line format: COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
+        dir = cwd.split.last
+        dirs[pid] = dir
+      end
+    end
+
+    if dirs.empty?
+      puts "Could not determine working directories for matching processes"
+      next
+    end
+
+    dirs.each do |pid, dir|
+      process_line = ps_output.find { |l| l.split[1] == pid }
+      cmd = process_line.split[10..].join(' ') rescue '(unknown)'
+      puts "#{pid}\t#{dir}\t#{cmd}"
+    end
+  }
+end

data/docs/h-app.md

@@ -0,0 +1,189 @@
+# h-app
+
+Manage named application subdirectories within a git repo or task worktree. Provides shortcuts to navigate, search, and run tools scoped to each app.
+
+## Synopsis
+
+```bash
+h app <subcommand> [args]
+```
+
+## Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `ls` | List all configured apps |
+| `add <name> <path>` | Register a new app |
+| `rm <name>` | Remove an app |
+| `cd [name]` | Send a `cd` to the current tmux pane |
+| `path [name]` | Print relative path to app (from cwd) |
+| `abspath [name]` | Print absolute path to app |
+| `fd <name> [args]` | Run `fd` scoped to an app directory |
+| `rg <name> [args]` | Run `rg` scoped to an app directory |
+| `vim <name> [args]` | Open vim scoped to an app directory |
+| `sh <name> [cmd]` | Open a shell (or run a command) in an app directory |
+| `config` | Edit `~/.config/hiiro/apps.yml` |
+| `service` | Manage services (delegates to `h service`) |
+| `run` | Run tools against changed files (delegates to `h run`) |
+| `file` | Manage tracked app files (delegates to `h file`) |
+
+### abspath
+
+Print the absolute path to the app.
+
+**Examples**
+
+```bash
+h app abspath api
+```
+
+### add
+
+Register an app with a name and relative path from the repo root.
+
+**Examples**
+
+```bash
+h app add api backend/api
+h app add web frontend/web
+```
+
+### cd
+
+Send a `cd` command to the current tmux pane to navigate to an app directory. Resolves the app path relative to the git repo root or current task tree. With no name, `cd`s to the repo root.
+
+**Examples**
+
+```bash
+h app cd
+h app cd api
+```
+
+### config
+
+Edit the apps config file (`~/.config/hiiro/apps.yml`) in your editor.
+
+**Examples**
+
+```bash
+h app config
+```
+
+### fd
+
+Run `fd` in the app's directory. All extra arguments are forwarded to `fd`.
+
+**Examples**
+
+```bash
+h app fd api '*.rb'
+h app fd web --type f
+```
+
+### file
+
+Delegate to the app file tracking system.
+
+**Examples**
+
+```bash
+h app file ls
+h app file add myapp src/main.rb
+```
+
+### ls
+
+List all configured apps with their relative paths.
+
+**Examples**
+
+```bash
+h app ls
+```
+
+### path
+
+Print the relative path (from current directory) to the app. With no name, prints the repo root path.
+
+**Examples**
+
+```bash
+h app path api
+h app path
+```
+
+### rg
+
+Run `rg` (ripgrep) in the app's directory. All extra arguments are forwarded to `rg`.
+
+**Examples**
+
+```bash
+h app rg api 'def foo'
+```
+
+### rm / remove
+
+Remove a registered app.
+
+**Examples**
+
+```bash
+h app rm api
+```
+
+### run
+
+Delegate to the runner tool system for running linters/tests against changed files.
+
+**Examples**
+
+```bash
+h app run
+h app run lint ruby
+```
+
+### service
+
+Delegate to the `h service` subcommand system, scoped to the current app context. All `h service` subcommands (`ls`, `start`, `stop`, `attach`, `open`, `url`, `port`, `status`, `add`, `rm`, `config`, `groups`, `env`) are available.
+
+**Examples**
+
+```bash
+h app service ls
+h app service start my-rails
+```
+
+### sh
+
+Open a shell in the app's directory. If additional arguments are provided, run them as a command instead.
+
+**Examples**
+
+```bash
+h app sh api
+h app sh api bundle exec rails console
+```
+
+### vim
+
+Open vim in the app's directory. Extra arguments are forwarded.
+
+**Examples**
+
+```bash
+h app vim api
+h app vim api src/main.rb
+```
+
+## Configuration
+
+Apps are stored in `~/.config/hiiro/apps.yml`:
+
+```yaml
+api: backend/api
+web: frontend/web
+workers: backend/workers
+```
+
+Paths are relative to the git repo root (or current task tree path).

data/docs/h-bg.md

@@ -0,0 +1,76 @@
+# h-bg
+
+Run commands in background tmux windows with command history tracking.
+
+## Synopsis
+
+```bash
+h bg <subcommand> [args]
+```
+
+## Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `run <cmd>` | Run a command in a new background tmux window |
+| `popup` | Open an editor to write and launch a background command |
+| `attach` / `a` | Switch to the background tmux session |
+| `history` / `hist` | Show recent background command history |
+| `setup` | Print tmux.conf snippet for a keybinding |
+
+Background commands run in the `hbg` tmux session (created if it doesn't exist). Each command opens in a new window named after the first word of the command. History is stored in `~/.config/hiiro/bg-history.txt` (last 50 commands).
+
+### attach / a
+
+Switch the current tmux client to the `hbg` background session.
+
+**Examples**
+
+```bash
+h bg attach
+h bg a
+```
+
+### history / hist
+
+Print recent background command history, one per line with index.
+
+**Examples**
+
+```bash
+h bg history
+h bg hist
+```
+
+### popup
+
+Open your `$EDITOR` with a template pre-populated from recent history (commented out). Write your command, save, and quit — it runs in the background. Empty or all-comment files are a no-op.
+
+**Examples**
+
+```bash
+h bg popup
+```
+
+### run
+
+Run a shell command in a new detached background tmux window. The command is appended to the history file.
+
+**Examples**
+
+```bash
+h bg run bundle exec rake test
+h bg run sleep 60
+h bg run ./scripts/long_job.sh
+```
+
+### setup
+
+Print the tmux.conf snippet needed to bind `h bg popup` to a key (prefix + b by default). Add the output to your `~/.tmux.conf`.
+
+**Examples**
+
+```bash
+h bg setup >> ~/.tmux.conf
+tmux source-file ~/.tmux.conf
+```

data/docs/h-bin.md

@@ -0,0 +1,39 @@
+# h-bin
+
+List and edit hiiro bin scripts (`h-*` executables found in PATH).
+
+## Synopsis
+
+```bash
+h bin <subcommand> [names...]
+```
+
+## Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `list [names]` | List matching bin files |
+| `edit [names]` | Open matching bin files in editor |
+
+### edit
+
+Open matching `h-*` bin files in your editor. With no arguments, opens `h-bin` itself.
+
+**Examples**
+
+```bash
+h bin edit
+h bin edit branch
+h bin edit pr notify
+```
+### list
+
+List `h-*` executables found in PATH. With no arguments, lists all. With names, filters to those matching `h-<name>` or `<name>` patterns. Deduplicates by basename (first occurrence wins).
+
+**Examples**
+
+```bash
+h bin list
+h bin list branch pr
+```
+