hiiro 0.1.101.pre.1 → 0.1.101

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4527fe0aa477f01194723db640e4b86a0ec1776b95e3abdc8e5434d7646d8c57
-  data.tar.gz: 5241c8faa013b8e3df039dbbe863bed8ffe1fa4e08241b75f200fab920c77c8a
+  metadata.gz: 2a0868dda489ffdfa214f45a591fa2f8e5375afce1e1b5224313eb78d2b3330c
+  data.tar.gz: ea0ee2867a93460a4417a699f4a6486afd2315ab3d40a3c6ff1f7a7346682482
 SHA512:
-  metadata.gz: 6c562bb508e429ce9584a1d2f8e1a1ceca7be83a4535596568460621bc18fa809465f3b6db73e6d9892db44186587d964789d0ec486227f3739bc9fb68285059
-  data.tar.gz: a87e98e4b21bdcd588c7f59776c8acee9ddac3e1ef074669e38ee566fc04bdd53cb6c39d3ddf8ee33c75cff26fa73fa924f25d2a0d02fe10528f67722f9f2cfb
+  metadata.gz: e98de821ad4e4c654fdbf6dad34aa27fcce13431e671af6620aa6252a12b2a6aba6a18f1ada056888fc36ece651a743b461a1a3245908f637a3c9383f0f9adb6
+  data.tar.gz: 4d95da4f77b667c544451740bb809b87178cf321b4b30bddc6d9478480902fd164d15d43454d94cfd421e298d421719b0e6c27456b419dd63447a3bbab680604

data/CLAUDE.md

@@ -26,7 +26,20 @@ ruby -c bin/h
 ruby -c plugins/*.rb
 ```
 
-There is no build step or test suite. This is a pure Ruby CLI tool.
+## Testing
+
+Run the test suite with:
+
+```bash
+bundle exec rake test
+```
+
+Tests are organized under `test/`:
+- `test/hiiro/` - Core library tests (Matcher, Options, Shell, Fuzzyfind, Todo, etc.)
+- `test/plugins/` - Plugin tests (Pins, Tasks, Notify, Project)
+- `test/bin/` - Bin file tests using `Hiiro::TestHarness`
+
+The `Hiiro::TestHarness` class (in `test/test_helper.rb`) enables testing bin files by capturing the block passed to `Hiiro.run` and evaluating it in a test context with stubbed `system` calls.
 
 ## Architecture
 
@@ -157,9 +170,9 @@ Main entry point with class methods:
 Instance methods available in subcommand blocks:
 - `git` - Returns `Hiiro::Git` instance for git operations
 - `fuzzyfind(lines)` - Interactive selection via skim
+- `fuzzyfind_from_map(hash)` - Interactive selection returning mapped value
 - `pins` - Key-value storage per command
 - `todo_manager` - Todo item management
-- `history` - Command history tracking
 - `attach_method(name, &block)` - Add methods to hiiro instance dynamically
 - `make_child(subcmd, *args)` - Create nested Hiiro for sub-subcommands
 
@@ -232,30 +245,52 @@ tm.active                         # Items not done/skipped
 tm.filter_by_task("feature")      # Items for specific task
 ```
 
-### Hiiro::History (lib/hiiro/history.rb)
+### Hiiro::Shell (lib/hiiro/shell.rb)
+
+Utility for piping content to external commands:
+
+```ruby
+Hiiro::Shell.pipe("content", "pbcopy")           # Pipe string to command
+Hiiro::Shell.pipe_lines(["a", "b"], "command")   # Join array with newlines and pipe
+```
+
+### Hiiro::Options (lib/hiiro/options.rb)
+
+Argument parsing with flag and option support:
+
+```ruby
+opts = Hiiro::Options.parse(args) do
+  option(:output, short: :o, desc: "Output file")
+  option(:verbose, short: :v, type: :flag, desc: "Verbose output")
+end
+opts.output    # Value of --output or -o
+opts.verbose   # true if --verbose or -v was passed
+opts.args      # Remaining non-option arguments
+```
+
+### Hiiro::Notification (lib/hiiro/notification.rb)
 
-Command history tracking with tmux/git/task context:
+macOS notification wrapper using terminal-notifier:
 
 ```ruby
-History.track(cmd: full_command, hiiro: self)  # Auto-called after commands
-History.by_task("feature")                      # Filter by task
-History.by_branch("main")                       # Filter by git branch
-History.by_session("work")                      # Filter by tmux session
+Hiiro::Notification.show(hiiro)   # Show notification based on hiiro.args
+# Supports: -m message, -t title, -l link, -c command, -s sound
 ```
 
 ## Key Files
 
-- `bin/h` - Core framework (~420 lines)
-- `bin/h-*` - External subcommands (tmux wrappers, video operations)
-- `plugins/*.rb` - Reusable plugin modules (Pins, Project, Task, Tmux, Notify)
+- `bin/h` - Entry point that loads lib/hiiro.rb
+- `bin/h-*` - External subcommands (tmux wrappers, git helpers, todo, links, etc.)
+- `plugins/*.rb` - Reusable plugin modules (Pins, Project, Tasks, Notify)
 - `lib/hiiro.rb` - Main Hiiro class and Runners
-- `lib/hiiro/*.rb` - Supporting classes (Git, Matcher, Fuzzyfind, Todo, History)
+- `lib/hiiro/*.rb` - Supporting classes (Git, Matcher, Fuzzyfind, Todo, Shell, Options, Notification, Tmux)
 
 ## External Dependencies
 
 - Ruby with `pry` gem
 - `tmux` for session/window/pane management
-- `ffmpeg`/`ffprobe` for video operations (h-video)
+- `sk` (skim) or `fzf` for fuzzy finding
+- `gh` CLI for GitHub operations (h-pr)
 - `terminal-notifier` for macOS notifications (notify plugin)
 
 ## Configuration Locations

data/README.md

@@ -24,7 +24,7 @@ h setup
 
 This installs:
 - Plugins to `~/.config/hiiro/plugins/`
-- Subcommands (`h-video`, `h-buffer`, etc.) to `~/bin/`
+- Subcommands (`h-buffer`, `h-todo`, etc.) to `~/bin/`
 
 Ensure `~/bin` is in your `$PATH`.
 
@@ -37,6 +37,9 @@ brew install terminal-notifier
 
 # For fuzzy-finder
 brew install sk # (or fzf)
+
+# For GitHub PR management
+brew install gh
 ```
 
 ## Quick Start
@@ -60,41 +63,28 @@ h ping
 | `h ping` | Simple test command (returns "pong") |
 | `h setup` | Install plugins and subcommands to system paths |
 | `h edit` | Open the h script in your editor |
-| `h path` | Print the current directory |
-| `h ppath` | Print project path (git root + relative dir) |
-| `h rpath` | Print relative path from git root |
-| `h pin` | Per-command key-value storage (via Pins plugin) |
-| `h project` | Project navigation with tmux integration (via Project plugin) |
-| `h task` | Task management across git worktrees (via Task plugin) |
-| `h notify` | macOS desktop notifications via terminal-notifier (via Notify plugin) |
+| `h alert` | macOS desktop notifications via terminal-notifier |
+| `h task` | Task management across git worktrees (via Tasks plugin) |
+| `h subtask` | Subtask management within tasks (via Tasks plugin) |
 
 ### External Subcommands
 
 | Command | Description |
 |---------|-------------|
-| `h branch` | Record and manage git branch history for tasks |
+| `h app` | Manage app directories within tasks/projects |
+| `h branch` | Git branch management with fuzzy selection and copy |
 | `h buffer` | Tmux paste buffer management |
-| `h dot` | Compare directories and generate symlink/diff commands |
-| `h dotfiles` | Manage dotfiles in ~/proj/home |
-| `h home` | Manage home directory files with edit and search |
-| `h html` | Generate an HTML index of MP4 videos in current directory |
+| `h claude` | Claude CLI wrapper with tmux split support |
+| `h commit` | Select commits using fuzzy finder |
+| `h config` | Open config files (vim, git, tmux, zsh, starship, claude) |
 | `h link` | Manage saved links with URL, description, and shorthand |
-| `h mic` | Control macOS microphone input volume |
-| `h note` | Create, edit, list, and display notes |
 | `h pane` | Tmux pane management |
 | `h plugin` | Manage hiiro plugins (list, edit, search) |
-| `h pr` | Record PR information linked to tasks |
-| `h pr-monitor` | Monitor pull requests |
-| `h pr-watch` | Watch pull requests for updates |
-| `h project` | Open projects with tmux session management |
-| `h runtask` | Run templated task scripts |
-| `h serve` | Start a miniserve HTTP server on port 1111 |
+| `h pr` | GitHub PR management via gh CLI |
+| `h project` | Project navigation with tmux session management |
 | `h session` | Tmux session management |
 | `h sha` | Extract short SHA from git log |
-| `h subtask` | Shorthand for task subtask management |
-| `h task` | Comprehensive task manager for git worktrees |
-| `h video` | Video inspection and operations via ffprobe/ffmpeg |
-| `h vim` | Manage nvim configuration with edit and search |
+| `h todo` | Todo list management with tags and task association |
 | `h window` | Tmux window management |
 | `h wtree` | Git worktree management |
 
@@ -103,9 +93,9 @@ h ping
 Any subcommand can be abbreviated as long as the prefix uniquely matches:
 
 ```sh
-h ex hel    # matches h example hello
-h te        # matches h test (if unique)
-h pp        # matches h ppath
+h buf ls      # matches h buffer ls
+h ses ls      # matches h session ls
+h win         # matches h window
 ```
 
 If multiple commands match, the first match wins and a warning is logged (when logging is enabled).
@@ -118,8 +108,7 @@ Plugins are Ruby modules loaded from `~/.config/hiiro/plugins/`:
 |--------|-------------|
 | Pins | Per-command YAML key-value storage |
 | Project | Project directory navigation with tmux session management |
-| Task | Task lifecycle management across git worktrees with subtask support |
-| Tmux | Tmux session helpers used by Project and Task |
+| Tasks | Task lifecycle management across git worktrees with subtask support |
 | Notify | macOS desktop notifications via terminal-notifier |
 
 ## Adding Subcommands
@@ -145,12 +134,12 @@ For nested subcommands, use hiiro in your script:
 #!/usr/bin/env ruby
 # ~/bin/h-example
 
-load File.join(Dir.home, 'bin/h')
+require 'hiiro'
 
-Hiiro.init(*ARGV) do |hiiro|
-  hiiro.add_subcommand(:hello) { puts "Hi!" }
-  hiiro.add_subcommand(:bye)   { puts "Goodbye!" }
-end.run
+Hiiro.run(*ARGV) do
+  add_subcmd(:hello) { puts "Hi!" }
+  add_subcmd(:bye)   { puts "Goodbye!" }
+end
 ```
 
 ```sh
@@ -160,23 +149,21 @@ h example bye    # => Goodbye!
 
 ### Method 2: Inline Subcommands
 
-Modify `bin/h` directly to add subcommands to the base `h` command:
+Modify `exe/h` directly to add subcommands to the base `h` command:
 
 ```ruby
-hiiro = Hiiro.init(*ARGV, plugins: [Pins, Project, Task], cwd: Dir.pwd)
-
-hiiro.add_subcommand(:hello) do |*args|
-  puts "Hello, #{args.first || 'World'}!"
+Hiiro.run(*ARGV, plugins: [Tasks], cwd: Dir.pwd) do
+  add_subcmd(:hello) do |*args|
+    puts "Hello, #{args.first || 'World'}!"
+  end
 end
-
-hiiro.run
 ```
 
-Global values (like `cwd`) are passed to all subcommand handlers via keyword arguments:
+Global values (like `cwd`) are accessible via `get_value`:
 
 ```ruby
-hiiro.add_subcommand(:pwd) do |*args, **values|
-  puts values[:cwd]  # Access the cwd passed during init
+add_subcmd(:pwd) do |*args|
+  puts get_value(:cwd)
 end
 ```
 
@@ -212,7 +199,7 @@ end
 Load plugins in your command:
 
 ```ruby
-Hiiro.init(*ARGV, plugins: [MyPlugin]) do |hiiro|
+Hiiro.run(*ARGV, plugins: [MyPlugin]) do
   # ...
 end
 ```
@@ -228,6 +215,15 @@ All configuration lives in `~/.config/hiiro/`:
   tasks/          # Task metadata
   projects.yml    # Project aliases
   apps.yml        # App directory mappings
+  todo.yml        # Todo items
+```
+
+## Testing
+
+Run the test suite:
+
+```sh
+bundle exec rake test
 ```
 
 ## License

data/bin/h-todo

@@ -90,7 +90,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:rm) do |*rm_args|
     id_or_index = rm_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo rm <id|index>"
+      puts "Usage: h todo rm <id>"
       exit 1
     end
 
@@ -110,7 +110,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:change) do |*change_args|
     id_or_index = change_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo change <id|index> [--text TEXT] [--tags TAGS] [--status STATUS]"
+      puts "Usage: h todo change <id> [--text TEXT] [--tags TAGS] [--status STATUS]"
       exit 1
     end
 
@@ -146,7 +146,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:start) do |*start_args|
     id_or_index = start_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo start <id|index>"
+      puts "Usage: h todo start <id>"
       exit 1
     end
 
@@ -162,7 +162,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:done) do |*done_args|
     id_or_index = done_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo done <id|index>"
+      puts "Usage: h todo done <id>"
       exit 1
     end
 
@@ -178,7 +178,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:skip) do |*skip_args|
     id_or_index = skip_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo skip <id|index>"
+      puts "Usage: h todo skip <id>"
       exit 1
     end
 
@@ -194,7 +194,7 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
   add_subcmd(:reset) do |*reset_args|
     id_or_index = reset_args.shift
     if id_or_index.nil?
-      puts "Usage: h todo reset <id|index>"
+      puts "Usage: h todo reset <id>"
       exit 1
     end
 
@@ -245,23 +245,27 @@ Hiiro.run(*ARGV, todo_file: tm.todo_file) do
         add [text] [-t tags]  Add todo item(s)
                               With no args, opens editor for YAML input
 
-        rm, remove <id|index> Remove a todo item
+        rm, remove <id>       Remove a todo item
 
-        change <id|index>     Modify a todo item
+        change <id>           Modify a todo item
           --text TEXT         New text
           --tags TAGS         New tags
           --status STATUS     New status
 
-        start <id|index>      Mark item as started
-        done <id|index>       Mark item as done
-        skip <id|index>       Mark item as skipped
-        reset <id|index>      Reset item to not_started
+        start <id>            Mark item as started
+        done <id>             Mark item as done
+        skip <id>             Mark item as skipped
+        reset <id>            Reset item to not_started
 
         search <query>        Search items by text, tags, or task
 
         path                  Print path to todo.yml
         editall               Open todo.yml in editor
 
+      Item IDs:
+        Items are identified by a permanent numeric ID (1, 2, 3, ...).
+        IDs are never reused, even after items are deleted.
+
       Status icons:
         [ ] not_started
         [>] started

data/docs/README.md

@@ -8,29 +8,20 @@ This directory contains detailed documentation for all Hiiro subcommands.
 
 | Command | Description |
 |---------|-------------|
+| h-app | Manage app directories within tasks/projects |
+| h-branch | Git branch management with fuzzy selection and copy |
 | [h-buffer](h-buffer.md) | Tmux paste buffer management |
-| h-branch | Record and manage git branch history for tasks |
-| h-dot | Compare directories and generate symlink/diff commands |
-| h-dotfiles | Manage dotfiles in ~/proj/home |
-| h-home | Manage home directory files with edit and search |
-| h-html | Generate an HTML index of MP4 videos in current directory |
+| h-claude | Claude CLI wrapper with tmux split support |
+| h-commit | Select commits using fuzzy finder |
+| h-config | Open config files (vim, git, tmux, zsh, starship, claude) |
 | h-link | Manage saved links with URL, description, and shorthand |
-| h-mic | Control macOS microphone input volume |
-| h-note | Create, edit, list, and display notes |
 | [h-pane](h-pane.md) | Tmux pane management |
 | [h-plugin](h-plugin.md) | Manage hiiro plugins (list, edit, search) |
-| h-pr | Record PR information linked to tasks |
-| h-pr-monitor | Monitor pull requests |
-| h-pr-watch | Watch pull requests for updates |
-| h-project | Open projects with tmux session management |
-| h-runtask | Run templated task scripts |
-| h-serve | Start a miniserve HTTP server on port 1111 |
+| h-pr | GitHub PR management via gh CLI |
+| h-project | Project navigation with tmux session management |
 | [h-session](h-session.md) | Tmux session management |
 | h-sha | Extract short SHA from git log |
-| h-subtask | Shorthand for task subtask management |
-| h-task | Comprehensive task manager for git worktrees |
-| [h-video](h-video.md) | Video inspection and operations via ffprobe/ffmpeg |
-| h-vim | Manage nvim configuration with edit and search |
+| h-todo | Todo list management with tags and task association |
 | [h-window](h-window.md) | Tmux window management |
 | h-wtree | Git worktree management |
 
@@ -44,13 +35,9 @@ The main `h` command includes these built-in subcommands:
 | `h ping` | Simple test command (returns "pong") |
 | `h setup` | Install plugins and subcommands to system paths |
 | `h edit` | Open the h script in your editor |
-| `h path` | Print the current directory |
-| `h ppath` | Print project path (git root + relative dir) |
-| `h rpath` | Print relative path from git root |
-| `h pin` | Per-command key-value storage (via Pins plugin) |
-| `h project` | Project navigation with tmux integration (via Project plugin) |
-| `h task` | Task management across git worktrees (via Task plugin) |
-| `h notify` | macOS desktop notifications via terminal-notifier (via Notify plugin) |
+| `h alert` | macOS desktop notifications via terminal-notifier |
+| `h task` | Task management across git worktrees (via Tasks plugin) |
+| `h subtask` | Subtask management within tasks (via Tasks plugin) |
 
 ## Plugins
 
@@ -58,8 +45,7 @@ The main `h` command includes these built-in subcommands:
 |--------|-------------|
 | Pins | Per-command YAML key-value storage |
 | Project | Project directory navigation with tmux session management |
-| Task | Task lifecycle management across git worktrees with subtask support |
-| Tmux | Tmux session helpers used by Project and Task |
+| Tasks | Task lifecycle management across git worktrees with subtask support |
 | Notify | macOS desktop notifications via terminal-notifier |
 
 ## Abbreviations
@@ -69,5 +55,5 @@ All commands support prefix abbreviation:
 ```sh
 h buf ls      # h buffer ls
 h ses ls      # h session ls
-h vid info    # h video info
+h win         # h window
 ```