hiiro 0.1.366 → 0.1.367

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97e9a140ccea0c61c6efe48395bda803e10bec8c0a933a95efb4a949a8788cdf
-  data.tar.gz: 24c45d70c07d018be4cca31368d91d55b8c8caa89d326e65803c512dcdf3b93e
+  metadata.gz: 9f4708a4c90c2b72668cc5f42c6a28ad1b06c5833986e45eb547e8215f6ec64e
+  data.tar.gz: e870242d4e60b6dd633a280733456ade72d0cdf999b733e39223cbf46647dd2f
 SHA512:
-  metadata.gz: e1b139bc6a4286240311b0106413abed936ebef51771b267d4284ecff70783c5df7a4a0a7b368251e481c8f72ed0cc5d0bc094fe513cffa1563df08123fa65dc
-  data.tar.gz: 37b32e60d486151dad01c08fdff82db9e9cff23506c8dad72636421b91e77c9e2e7a342b145770d86c615cc982035c4dcc80f3039ec3e457809e431f0bcc5aa2
+  metadata.gz: 184881124f6711f940214c20510527d1790c800ea56e3e3b37b74a7060f71aeb564300b12179419cf0ec0099a041df6189ddb41137f132b5c0e0b4f691742572
+  data.tar.gz: 1372760dfa76e22fe9305c83c826b72fd2f0e2328b2cd6c0c41f0b1f8baf23720460c150aeb66c434bd666a8779a49f40a7d2338482216dc8edc9bf89a2d1b40

data/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 ## [Unreleased]
 
+## [0.1.367] - 2026-09-14
+
+### Added
+- Add `h env add NAME VALUE` and `h alias add NAME COMMAND...` to append safely quoted shell definitions, preferring existing zsh module files and falling back to the root dotfiles. Use native Hiiro options, including `opts.global` and `--`.
+- Add `h bin add NAME [COMMAND ...]` to generate executable `Hiiro.run` templates with optional empty `add_cmd` blocks. Serialize command names as Ruby symbols and refuse existing files or symlinks.
+- `t ls` and `t list` root commands list tasks like bare `t`
+- `Hiiro::Error`: `Hiiro#run` prints only `ERROR: message` for it, no backtrace
+- `builtin_commands: false` option for `Hiiro.run`/`run_child` to skip the automatic `pry` and `edit` commands
+- `Hiiro#open_default(target)` opens a path or URL with `open`/`xdg-open`
+- `t` and `tt` are gem executables (`exe/t`, `exe/tt`) installed with Hiiro
+- `t TASK tree new|rm|resume`, `t TASK tree`, `t TASK path`, `t TASK branch`, `t TASK sh`, and `t TASK cd` bring worktree and shell commands from `h task` into `t`; subtasks are `parent/child` names
+- `Hiiro::CurrentTask`: one resolver for the current task (Herdr workspace, working directory, saved pin) used by `t` and by `Environment#task`
+- `Hiiro::Git.repo_dir` so worktree commands work when `~/work/.git` is a gitfile pointing at the bare repo
+
+### Fixed
+- `h task start` and worktree listing failed with "Not a directory" when `~/work/.git` is a gitfile; git now runs in the parent directory
+
+### Changed
+- Move the task CLI into `lib/hiiro/task_cli.rb` (`Hiiro::TaskCli`); `exe/t` and `exe/tt` are thin `Hiiro.run` launchers and `bin/t`, `bin/tt` are symlinks
+- `t` requires `hiiro` like other bins instead of editing the load path; `task_scope` and `task_sessions` load with `hiiro`
+- `t` errors print without a backtrace; task, scope, and session errors subclass `Hiiro::Error`
+- `t` saves the current task through the `PinRecord` model and resolves resources, documents, tabs, and panes with `Hiiro::Matcher`, accepting unique prefixes and offering fuzzyfind when no reference is given
+- `tt` runs the todo scope in-process instead of exec'ing `t`
+- `h task` is now a symlink to `t` (`bin/h-task` -> `exe/t`); the inline `h task` and `h subtask` subcommands are gone, and `h task start|stop|resume|switch|sh|cd|path|branch|todo` map to `t` commands (see docs/h-task.md)
+- `Environment#task` also matches the working directory against task homes, primary directories, and registered directories
+- `TaskManager#start_task` uses the extracted `create_tree`
+- Task listing prints aligned columns with the open todo count after each name, e.g. `prez (3)`, plus `next:`/`waiting:` text
+- `ls` and `list` are now reserved root words in `t`; tasks with those exact names need a unique prefix
+
 ## [0.1.366] - 2026-09-14
 
 ### Changed

data/CLAUDE.md

@@ -508,6 +508,7 @@ ALWAYS update `README.md` and any files in `docs/` or other markdown files that
 ## Key Files
 
 - `exe/h` - Entry point that loads lib/hiiro.rb
+- `exe/t`, `exe/tt` - Task CLI launchers over `Hiiro::TaskCli` (`lib/hiiro/task_cli.rb`)
 - `bin/h-*` - External subcommands (tmux wrappers, git helpers, jumplist, etc.)
 - `plugins/*.rb` - Reusable plugin modules (Pins, Project, Tasks, Notify)
 - `lib/hiiro.rb` - Main Hiiro class and Runners

data/README.md

@@ -61,13 +61,15 @@ h ping
 
 ### Task CLI
 
-The repository's `bin/t` contains the task commands and helpers, using Hiiro's
-`add_cmd` DSL and existing task records. `~/bin/t` and `~/bin/tt` are symlinks to
-the repository launchers; installing the gem does not install them. `t NAME new`
+`t` and `tt` are gem executables in `exe/`, installed alongside `h`. They are thin
+`Hiiro.run` launchers over `Hiiro::TaskCli` in `lib/hiiro/task_cli.rb`, which uses
+the `add_cmd` DSL and existing task records. `bin/t` and `bin/tt` are symlinks to
+the `exe/` files for running from a checkout with `ruby -Ilib bin/t`. `t NAME new`
 creates a task and its notes directory without creating a Git worktree.
 
-Use `t TASK COMMAND...`. Bare `t` lists every task, including done and archived
-tasks. `t TASK` shows a task. Only exact root `t help` displays generic usage and
+Use `t TASK COMMAND...`. Bare `t`, `t ls`, or `t list` lists every task, including
+done and archived tasks, with the count of open todos after each name. `t TASK`
+shows a task. Only exact root `t help` displays generic usage and
 native scoped help without looking up a task. Other first words are task
 references, even `new`, `show`, `edit`, or `he`.
 
@@ -112,7 +114,7 @@ without creating a task.
 Todos share the existing `todos` table with `h todo`. `t` writes only to the
 database and does not rewrite `todo.yml`. Adding or removing a todo does not
 change the task's next action, status, or saved selection. Task completion and
-archival preserve todos; `h task` behavior is unchanged.
+archival preserve todos. `h task` is a symlink to `t`, so both share one grammar.
 
 `t TASK omp`, `t TASK codex` or `cdx`, and `t TASK claude` or `cld` start fresh
 native CLI sessions in new focused Herdr tabs. Claude always runs `claude`.
@@ -139,18 +141,20 @@ See the [task command reference](docs/t.md) for all commands and the [workflow i
 | `h setup` | Install plugins and subcommands to system paths |
 | `h edit` | Open the h script in your editor |
 | `h alert` | macOS desktop notifications via terminal-notifier |
-| `h task` | Task management across git worktrees, including existing external worktrees (via Tasks plugin) |
-| `h subtask` | Subtask management within tasks (via Tasks plugin) |
+| `h task` | Same program as `t`: task records, todos, worktrees (`t NAME tree new`), and Herdr workspaces |
 
 ### External Subcommands
 
 | Command | Description |
 |---------|-------------|
+| `h alias` | Append safely quoted zsh aliases |
 | `h app` | Manage app directories within tasks/projects |
+| `h bin` | Create, list, and edit Hiiro executables |
 | `h branch` | Git branch management with fuzzy selection and copy |
 | `h claude` | Claude CLI wrapper with Herdr split support |
 | `h commit` | Select commits using fuzzy finder |
 | `h config` | Open config files (vim, git, Herdr, zsh, starship, claude) |
+| `h env` | Append safely quoted environment variables |
 | `h link` | Manage saved links with URL, description, and shorthand |
 | `h pane` | Herdr pane management |
 | `h plugin` | Manage hiiro plugins (list, edit, search) |
@@ -168,6 +172,33 @@ See the [task command reference](docs/t.md) for all commands and the [workflow i
 
 `h claude agents|commands|skills -a` prints the absolute file path for each matching `.claude` tool, including `SKILL.md` for skills.
 
+### Shell helpers
+
+```sh
+h env add exam ple
+h alias add ll 'ls -al'
+h alias add --global PAGER '| less'
+h bin add scratch
+h bin add josh list show
+```
+
+`h env add NAME VALUE` appends a literal `export NAME="VALUE"` to
+`~/.zshenv.d/vars.zsh` when that file exists, otherwise to `~/.zshenv`.
+`h alias add NAME COMMAND...` similarly prefers `~/.zshrc.d/aliases.zsh`,
+falling back to `~/.zshrc`. Existing contents are preserved. A single quoted
+command string preserves shell syntax; separate command arguments retain their
+argument boundaries. Use `--global` or `-g` for a global zsh alias.
+
+These commands use native Hiiro option parsing and help. Use `--` before
+flag-like data, for example `h env add LABEL -- --literal` or
+`h alias add inspect -- tool --help`. Start a new shell or source the relevant
+configuration file to apply additions.
+
+`h bin add NAME [COMMAND ...]` creates an executable `~/bin/h-NAME` using
+`Hiiro.run`. Without commands its block is empty; each command adds an empty
+`add_cmd` block with a Ruby symbol. Existing files and symlinks are never
+overwritten. See the [bin command reference](docs/h-bin.md).
+
 ## Abbreviations
 
 Any subcommand can be abbreviated as long as the prefix uniquely matches:
@@ -187,7 +218,7 @@ Plugins are Ruby modules loaded from `~/.config/hiiro/plugins/`:
 |--------|-------------|
 | Pins | Per-command YAML key-value storage |
 | Project | Project directory navigation with Herdr workspace management |
-| Tasks | Task lifecycle management across git worktrees with external-worktree registration and subtask support |
+| Tasks | `Hiiro::TaskManager` worktree creation and current-task environment used by `t`, `h service`, `h run`, and `h file` |
 | Notify | Herdr desktop notifications |
 
 ## Adding Subcommands
@@ -294,6 +325,13 @@ shared with nested groups without consuming its name again.
 For a CLI that should dispatch only registered blocks, pass
 `external_commands: false` to `Hiiro.run` and its `run_child` or `make_child` calls. This
 prevents unrelated same-prefix executables on `PATH` from taking precedence.
+Pass `builtin_commands: false` as well to skip the automatic `pry` and `edit`
+commands, for CLIs whose first word is data rather than a command name.
+
+Raise `Hiiro::Error` (or a subclass) for expected user-facing failures such as
+bad arguments or missing records. `Hiiro#run` prints `ERROR: message` to stderr
+and exits 1 without a backtrace; any other exception still prints its backtrace.
+`open_default(target)` opens a path or URL with the OS handler (`open` or `xdg-open`).
 
 ## Writing Plugins
 

data/bin/h-bin

@@ -3,6 +3,26 @@
 require 'hiiro'
 
 Hiiro.run do
+  add_cmd :add, args: ['NAME', 'COMMAND...'] do
+    name, *commands = opts.args
+    name = name&.delete_prefix('h-')
+    abort 'Use a command name containing letters, digits, underscores, or hyphens' unless name&.match?(/\A[A-Za-z0-9][A-Za-z0-9_-]*\z/)
+    abort 'Subcommand names cannot be empty' if commands.any?(&:empty?)
+
+    path = File.join(Dir.home, 'bin', "h-#{name}")
+    body = commands.map { |command| "  add_cmd #{command.to_sym.inspect} do\n  end" }.join("\n\n")
+    template = "#!/usr/bin/env ruby\n\nrequire 'hiiro'\n\nHiiro.run do\n"
+    template << "#{body}\n" unless body.empty?
+    template << "end\n"
+
+    FileUtils.mkdir_p(File.dirname(path))
+    File.open(path, File::WRONLY | File::CREAT | File::EXCL, 0o755) do |file|
+      file.write(template)
+      file.chmod(0o755)
+    end
+    puts path
+  end
+
   add_subcmd(:list) do |*subcmd_names|
     patterns = subcmd_names.flatten.compact.map { |sc|
       sc.sub(/^(?!h-)/, '{h-,}')

data/bin/h-task

@@ -0,0 +1 @@
+../exe/t

data/bin/t

@@ -0,0 +1 @@
+../exe/t

data/bin/tt

@@ -0,0 +1 @@
+../exe/tt

data/docs/h-bin.md

@@ -1,8 +1,8 @@
 # h-bin
 
-List and edit hiiro bin scripts (`h-*` executables found in PATH).
+Create, list, and edit Hiiro bin scripts.
 
-`h bin` uses `Hiiro::Bins` to scan the current `PATH` for executable files.
+`h bin add` creates executables in `~/bin`. The `list` and `edit` commands use `Hiiro::Bins` to scan the current `PATH`.
 
 ## Synopsis
 
@@ -14,9 +14,56 @@ h bin <subcommand> [names...]
 
 | Subcommand | Description |
 |------------|-------------|
+| `add NAME [COMMAND ...]` | Create an executable template without overwriting an existing file |
 | `list [names]` | List matching bin files |
 | `edit [names]` | Open matching bin files in editor |
 
+### add
+
+Create `~/bin/h-NAME`. An optional `h-` prefix is accepted. Executable names must
+start with a letter or digit and contain only letters, digits, underscores, or
+hyphens.
+
+```sh
+h bin add scratch
+```
+
+With no command arguments, the generated file contains:
+
+```ruby
+#!/usr/bin/env ruby
+
+require 'hiiro'
+
+Hiiro.run do
+end
+```
+
+To include empty command blocks:
+
+```sh
+h bin add josh list show
+```
+
+```ruby
+#!/usr/bin/env ruby
+
+require 'hiiro'
+
+Hiiro.run do
+  add_cmd :list do
+  end
+
+  add_cmd :show do
+  end
+end
+```
+
+Command names are serialized as Ruby symbols, including quoted symbols for
+names such as `hello-world`. Generated files are executable. Existing files
+and symlinks are refused, and no editor or generated command is launched.
+Native Hiiro options handle `--help` and the `--` end-of-options marker.
+
 ### edit
 
 Open matching `h-*` bin files in your editor. With no arguments, opens `h-bin` itself.

data/docs/h-subtask.md

@@ -1,50 +1,11 @@
 # h subtask
 
-Manage subtasks within the current parent task. Subtasks follow the same worktree + Herdr workspace model as top-level tasks, but are scoped under the current task (for example, `my-feature/auth`).
-
-All subcommands are identical to [h task](h-task.md) but operate on the subtask scope. Subtask names are relative (e.g. `auth` rather than `my-feature/auth`).
-
-## Synopsis
+`h subtask` was removed when `h task` became a symlink to `t`. A subtask is a task whose name is `parent/child`:
 
 ```bash
-h subtask <subcommand> [args]
+t my-feature/auth tree new    # worktree at ~/work/my-feature/auth, workspace "my-feature/auth"
+t my-feature/auth todo add Wire the login form
+t my-feature/auth tree rm
 ```
 
-## Scope behavior
-
-When in a task workspace, `h subtask` lists and operates on subtasks of the current parent task. A synthetic `main` subtask is always shown, representing the parent task's primary worktree.
-
-Subtask names are stored as `parent/child` (e.g. `my-feature/auth`) but displayed as their short name (`auth`) in subtask context.
-
-## Subcommands
-
-All subcommands from [h task](h-task.md) are available. Key ones:
-
-| Subcommand | Description |
-|------------|-------------|
-| `ls` / `list` | List subtasks of the current task |
-| `start <name>` | Create or switch to a subtask |
-| `switch [name]` | Switch to a subtask workspace |
-| `stop [name]` | Stop a subtask (preserves worktree) |
-| `current` | Print the current subtask name |
-| `status` / `st` | Show current subtask details |
-| `branch [name]` | Print branch for a subtask |
-| `tree [name]` | Print worktree name for a subtask |
-| `session [name]` | Print session name for a subtask |
-| `cd [name] [app]` | Send `cd` to current pane |
-| `path [name] [app]` | Print path to subtask directory |
-| `todo [args]` | Manage todos for current subtask |
-| `queue [args]` | Claude queue scoped to current subtask |
-
-## Examples
-
-```bash
-h subtask ls
-h subtask start auth
-h subtask switch
-h subtask switch auth
-h subtask current
-h subtask status
-h subtask cd auth
-h subtask stop auth
-```
+See [t](t.md) and [h task](h-task.md).