RubyGems - hiiro - Versions diffs - 0.1.366 → 0.1.367 - Mend

hiiro 0.1.366 → 0.1.367

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

data/docs/h-task.md CHANGED Viewed

@@ -8,9 +8,9 @@ Task todos use the existing `todos` table shared with `h todo`. `t` writes to th
 ## t
-The command implementation lives in the repository's `bin/t`, not a `Hiiro::TaskCLI` library class. `~/bin/t` is a symlink to that executable, which loads the repository library. Installing the gem does not install this launcher. `bin/tt` delegates to its todo scope. `t` does not run `h task` or discover legacy `t-*` executables.
+The command implementation is `Hiiro::TaskCli` in `lib/hiiro/task_cli.rb`; `exe/t` and `exe/tt` are gem executables that call `Hiiro::TaskCli.setup` and `Hiiro::TaskCli.setup_todo` from `Hiiro.run`. Installing the gem installs both. `tt` runs the todo scope in-process. `t` does not run `h task` or discover legacy `t-*` executables.
-The grammar is `t TASK COMMAND...`. Bare `t` lists all tasks, including done and archived tasks. `t TASK` shows the task. Only exact root `t help` displays generic usage and native scoped help without looking up a task. First words such as `new`, `show`, `edit`, `pry`, and `he` are task references, not root commands or help abbreviations.
+The grammar is `t TASK COMMAND...`. Bare `t`, `t ls`, or `t list` lists all tasks, including done and archived tasks, with open todo counts. `t TASK` shows the task. Only exact root `t help` displays generic usage and native scoped help without looking up a task. First words such as `new`, `show`, `edit`, `pry`, and `he` are task references, not root commands or help abbreviations.
 Named references match an exact name first, then a unique case-sensitive prefix. Ambiguous prefixes are errors. Unknown names fail except with `t NAME new` or `t NAME todo add TEXT...`. Explicit `new` creates exactly `NAME` without prefix resolution. `t TASK help` shows task commands, and `t TASK todo help` shows todo commands. Native command abbreviations apply inside these scopes.
@@ -33,7 +33,7 @@ t TASK done
 t TASK archive
 ```
-Bare `t` lists tasks regardless of context or the saved task. There is no root `list`, `ls`, `new`, or `show` action. `next`, `waiting`, and `status` without a payload display the selected task's current value.
+Bare `t`, `t ls`, and `t list` list tasks regardless of context or the saved task, showing each name with its open todo count, e.g. `prez (3)`. There is no root `new` or `show` action. `next`, `waiting`, and `status` without a payload display the selected task's current value.
 `t NAME new` creates a record and `~/notes/work/NAME`. It never creates a Git worktree, moves code, or launches Herdr. Repeating `new` keeps the exact existing record and ensures its home exists. Names contain 1-120 ASCII letters, digits, dots, underscores, or hyphens and start with a letter or digit. Existing names that contain other characters remain usable, with those characters percent-encoded in the computed home directory name.
@@ -169,561 +169,24 @@ The launcher scopes live-pane lookup to the task workspace. Persisted session di
 ## h task
-The existing `h task` commands below retain their coding-worktree operations. Unlike `t NAME new`, `h task start` can create a worktree for a new task. For a task without a worktree, path resolution uses its task home. Starting an existing noncoding task switches to that home without creating a worktree.
+`h task` is the same program as `t`: `bin/h-task` is a symlink to `exe/t`, so `h task ARGS...` behaves exactly like `t ARGS...` with the task-first grammar above. `h subtask` is gone; a subtask is a task named `parent/child`, and `t parent/child tree new` creates its worktree under `~/work/parent/child`.
-## Synopsis
+Worktree operations that used to live only under `h task` are now task commands:
-```bash
-h task <subcommand> [args]
-```
-## Subcommands
-### app
-Open a named app in a new Herdr tab within the current task workspace. With no argument, opens a fuzzyfind selector over configured apps.
-**Examples**
-```bash
-h task app
-h task app api
-```
----
-### apps
-List all configured apps and their relative paths.
-**Examples**
-```bash
-h task apps
-```
----
-### branch
-Print the git branch for a task. With no argument, opens a fuzzyfind selector. Outputs nothing if the tree is detached.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--all` | `-a` | Print branch for every task; positional args become prefix filters (OR'd) | false |
-**Examples**
-```bash
-h task branch
-h task branch my-feature
-h task branch -a               # print branch for every task
-h task branch -a feat bug      # tasks whose name starts with "feat" or "bug"
-```
----
-### branches
-List branches for the current task. Delegates to `h branch`.
----
-### cbranch
-Print the git branch of the **current** task. Exits with an error if not in a task.
-**Examples**
-```bash
-h task cbranch
-```
----
-### cd
-Send a `cd` command to the current Herdr pane, navigating to a task's worktree or app subdirectory.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-**Examples**
-```bash
-h task cd
-h task cd my-feature
-h task cd my-feature api
-h task cd -t my-feature
-```
----
-### csession
-Print the Herdr workspace label stored for the **current** task.
-**Examples**
-```bash
-h task csession
-```
----
-### ctree
-Print the worktree name of the **current** task.
-**Examples**
-```bash
-h task ctree
-```
----
-### current
-Print the name of the current task based on the Herdr workspace or worktree match. Exits with an error if not in a task.
-**Examples**
-```bash
-h task current
-```
----
-### edit
-Open the `tasks.rb` source file in your editor.
-### file
-Manage tracked app files for the current task. Delegates to the app files system.
-**Examples**
-```bash
-h task file ls
-h task file add myapp path/to/file.rb
-```
----
-### from
-Register an existing git worktree as a Hiiro task and switch to it. The path is normalized to the worktree root with `git rev-parse --show-toplevel`, then stored as the task's tree path.
-**Examples**
-```bash
-h task from ~/ic_repos/other_repo_base_dir other-task
-h task path other-task
-h task switch other-task
-```
-Stored task shape:
-```js
-{
-  name: "other-task",
-  tree: "/Users/josh/ic_repos/other_repo_base_dir",
-  session: "other-task"
-}
-```
----
-### ls / list
-List all tasks with their worktree, branch, and workspace label. It also shows available worktrees and extra Herdr workspaces.
-A `*` prefix marks the current task. An `@` prefix indicates the Herdr workspace is focused.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--tag` | `-t` | Filter by tag (OR logic; repeatable) | all |
-**Examples**
-```bash
-h task ls
-h task ls -t urgent
-h task ls -t api -t frontend
-```
----
-### path
-Print the absolute path to a task's worktree or app subdirectory. With glob patterns, lists matching files.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--all` | `-a` | Print path for every task; positional args become prefix filters (OR'd). App / glob args are ignored in this mode. | false |
-**Examples**
-```bash
-h task path
-h task path my-feature
-h task path my-feature api
-h task path my-feature api "**/*.rb"
-h task path -a                 # print worktree path for every task
-h task path -a feat bug        # tasks whose name starts with "feat" or "bug"
-```
----
-### prune
-Detach worktree associations whose directories are missing. The task record, metadata, and resource references remain. Tasks without worktrees are not pruned. Defaults to a dry-run.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--force` | `-f` | Detach missing worktrees | false |
-**Examples**
-```bash
-h task prune        # show what would be pruned
-h task prune -f     # detach missing worktrees, retaining task records
-```
----
-### prs
-List PRs for the current task. Delegates to `h pr`.
----
-### queue
-Run the Claude prompt queue scoped to the current task. All `h queue` subcommands are available. See [h-queue](h-queue.md).
-**Examples**
-```bash
-h task queue ls
-h task queue add "Fix the login bug"
-h task queue hadd
-```
----
-### resume
-Associate an available worktree with a new task or an existing task whose worktree was detached, then switch to it. Existing task metadata is preserved. With no argument, opens a fuzzyfind selector over available worktrees.
-**Examples**
-```bash
-h task resume
-h task resume my-feature/main
-```
----
-### run
-Run linters, tests, or formatters against changed files for the current task. Delegates to the runner tool system.
-**Examples**
-```bash
-h task run
-h task run lint
-h task run test ruby
-```
----
-### save
-Read and report the current task's Herdr tab state.
-**Examples**
-```bash
-h task save
-```
----
-### service
-Manage dev services scoped to the current task. All `h service` subcommands are available. See [h-service](h-service.md).
-**Examples**
-```bash
-h task service ls
-h task service start my-rails
-```
----
-### name
-Print the full task name. With no argument, opens a fuzzyfind selector. Useful for scripting alongside `tree -a`, `branch -a`, and `path -a` (results are sorted by name across all four, so they line up).
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--all` | `-a` | Print every task's name; positional args become prefix filters (OR'd) | false |
-**Examples**
-```bash
-h task name -a                            # list every task name
-h task name -a feat                       # only tasks starting with "feat"
-paste <(h task name -a) <(h task path -a) # name <-> path mapping
-```
----
-### session
-Print the stored Herdr workspace label for a task. The `session` command name remains for compatibility. With no argument, it opens a fuzzyfind selector.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--all` | `-a` | Print workspace label for every task; positional args become prefix filters (OR'd) | false |
-**Examples**
-```bash
-h task session
-h task session my-feature
-h task session -a
-```
----
-### sh
-Open a shell (or run a command) in the current task's worktree. With `--session`, create a new Herdr tab in the specified workspace.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--session` | `-s` | Run in a new tab in this Herdr workspace | none |
-**Examples**
-```bash
-h task sh
-h task sh -t my-feature
-h task sh my-feature bundle exec rails s
-h task sh -s my-session
-```
----
-### sparse
-Manage sparse checkout for the current task's worktree.
-**Options**
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--list` | `-l` | List all configured sparse groups |
-| `--disable` | `-d` | Disable sparse checkout on current task |
-**Examples**
-```bash
-h task sparse              # show active sparse checkout
-h task sparse default      # apply 'default' group
-h task sparse -l           # list all groups
-h task sparse -d           # disable sparse checkout
-```
----
-### start
-Create a new task (worktree + Herdr workspace) and switch to it. If the task already exists, switch to it instead. Reuse an available unassigned worktree when possible; otherwise create a new one.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--sparse` | `-s` | Apply a sparse checkout group (repeatable) | none |
-**Examples**
-```bash
-h task start my-feature
-h task start my-feature api        # open in app subdirectory
-h task start my-feature -s default
-```
----
-### status / st
-Show detailed info about the current task: name, worktree, path, workspace, and parent (if subtask).
-**Examples**
-```bash
-h task status
-h task st
-```
----
-### stop
-Detach a task's worktree association and those of its subtasks. The task records, metadata, workspace labels, and resources remain. The former worktree path becomes a directory reference, and the worktree is available for reuse through `resume`. With no arguments, opens a fuzzyfind selector.
-**Examples**
-```bash
-h task stop my-feature
-h task stop
-```
----
-### switch
-Switch to an existing task's Herdr workspace. With no arguments, open a fuzzyfind selector over tasks and workspaces. If the name matches a Herdr workspace rather than a task, focus it directly.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--force` | `-f` | Accepted for compatibility; Herdr workspace focus does not require it | false |
-**Examples**
-```bash
-h task switch
-h task switch my-feature
-h task switch my-feature api
-h task switch my-session -f
-```
----
-### tag
-Add tags to a task. With `--edit`, opens a YAML editor for bulk tagging.
-**Options**
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--edit` | `-e` | Open YAML editor to bulk-tag tasks |
-**Examples**
-```bash
-h task tag my-feature urgent
-h task tag my-feature api backend
-h task tag -e
-```
----
-### tags
-List all tagged tasks, grouped by tag.
-**Examples**
-```bash
-h task tags
-```
----
-### todo
-Manage todo items scoped to the current task. See [h-todo](h-todo.md) for the full todo system.
-**Subcommands:** `ls`, `add`, `rm`, `start`, `done`, `skip`, `search`
-**Examples**
-```bash
-h task todo
-h task todo add "Fix the login bug"
-h task todo add -t urgent "Refactor auth"
-h task todo done 0
-```
----
-### tree
-Print the worktree name for a task. With no argument, opens a fuzzyfind selector.
-**Options**
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--task` | `-t` | Task name | current task |
-| `--find` | `-f` | Choose task interactively | false |
-| `--all` | `-a` | Print tree name for every task; positional args become prefix filters (OR'd) | false |
-**Examples**
-```bash
-h task tree
-h task tree my-feature
-h task tree -a
-h task tree -a feat bug
-```
----
-### untag
-Remove tags from a task. With no tags, removes all tags.
-**Examples**
-```bash
-h task untag my-feature urgent
-h task untag my-feature          # remove all tags
-```
----
-### wtrees
+| Old | Now |
+|---|---|
+| `h task start NAME [APP] [-s GROUP]` | `t NAME tree new [--app APP] [--sparse GROUP]` (creates the task record if needed, then the worktree, then the Herdr workspace) |
+| `h task switch NAME [APP]` | `t NAME switch [--directory DIR]` |
+| `h task stop NAME` | `t NAME tree rm` (detaches the worktree, keeps the directory, registers it as a directory resource) |
+| `h task resume [TREE]` | `t NAME tree resume [TREE]` |
+| `h task path`, `h task branch`, `h task tree` | `t TASK path`, `t TASK branch`, `t TASK tree` |
+| `h task sh [CMD...]` | `t TASK sh [CMD...]` |
+| `h task cd` | `t TASK cd` |
+| `h task todo ...` | `t TASK todo ...` or `tt TASK ...` |
+| `h task ls` | `t ls` |
+| `h task current` | `t . current` |
+| `h task queue`, `service`, `run`, `file` | `h queue`, `h service`, `h run`, `h file` |
-List worktrees for the current task. Delegates to `h wtree`.
+`h task tag`, `untag`, `tags`, `sparse`, `from`, `prune`, `apps`, `save`, `status`, and `prs` were not carried over. Tag branches with `h branch tag`, inspect worktrees with `h wtree`, and register an existing directory with `t TASK directory add PATH --primary`.
----
+`Hiiro::TaskManager` still holds the worktree creation code that `t TASK tree new` and the shared `Hiiro::CurrentTask` resolver use; `h service`, `h run`, and `h file` keep using it for the current task through `Environment#task`, which now also recognizes a task by its home, primary directory, or registered directories.

data/docs/h.md CHANGED Viewed

@@ -29,8 +29,7 @@ These subcommands are defined directly in `exe/h` or loaded from `lib/`:
 | [`h run`](h-run.md) | Run dev tools (linters, formatters, tests) against changed files | `lib/hiiro/runner_tool.rb` |
 | [`h service`](h-service.md) | Dev service management with Herdr, env files, and service groups | `lib/hiiro/service_manager.rb` |
 | `h setup` | Install plugins and bin scripts to `~/bin` | `exe/h` |
-| [`h subtask`](h-subtask.md) | Subtask management scoped to the current parent task | `lib/hiiro/tasks.rb` |
-| [`h task`](h-task.md) | Task management — worktree + Herdr workspace pairs, including external worktrees | `lib/hiiro/tasks.rb` |
+| [`h task`](h-task.md) | Symlink to `t`: task records, todos, worktrees, and Herdr workspaces | `lib/hiiro/task_cli.rb` |
 | `h version` | Print installed hiiro version (`-a` for all rbenv versions) | `exe/h` |
 ## External subcommands

data/docs/t.md CHANGED Viewed

@@ -1,10 +1,10 @@
 # t command reference
-Reference for the repository's `bin/t` executable and `bin/tt` todo shortcut.
+Reference for the `t` executable and `tt` todo shortcut.
-`t` manages task records, next actions, todos, waiting-on information, documents, resource references, and task-associated Herdr terminals. It does not create Git worktrees or configure sparse checkout. Those operations belong to the separate `h task` commands.
+`t` manages task records, next actions, todos, waiting-on information, documents, resource references, git worktrees, and task-associated Herdr terminals. `h task` is a symlink to the same executable.
-`bin/t` contains the command declarations and `TaskCommands` helpers. `~/bin/t` and `~/bin/tt` are symlinks to the repository launchers. Both resolve their real paths and put the repository library first on Ruby's load path. Installing the Hiiro gem does not install these launchers.
+`exe/t` and `exe/tt` are gem executables installed with Hiiro. Each is a `Hiiro.run` launcher that calls `Hiiro::TaskCli.setup` or `Hiiro::TaskCli.setup_todo`; the command declarations and `Hiiro::TaskCli::Commands` helpers live in `lib/hiiro/task_cli.rb`. `bin/t` and `bin/tt` are symlinks to the `exe/` files. Expected failures raise `Hiiro::Error` and print only `ERROR: message` on stderr with exit status 1.
 ## Syntax and task selection
@@ -18,7 +18,7 @@ tt TASK [COMMAND...]
 Uppercase words are values to supply. Square brackets indicate optional arguments, and `...` means multiple words or arguments.
-Bare `t` lists every task, including active, waiting, done, and archived records. It does not select from context. `t TASK` shows the selected task. Only exact root `t help` displays generic usage and native scoped help without task lookup. Other first words are task references, including `new`, `show`, `edit`, `pry`, and `he`. There are no root `add`, `rm`, `list`, `ls`, `new`, or `show` actions.
+Bare `t`, `t ls`, and `t list` list every task, including active, waiting, done, and archived records, in aligned columns: name with the open todo count in parentheses (omitted when zero), status, then any `next:` and `waiting:` text. Open todos are those not done or skipped. The listing does not select from context. `t TASK` shows the selected task. Only exact root `t help` displays generic usage and native scoped help without task lookup. Other first words are task references, including `new`, `show`, `edit`, `pry`, and `he`. Only `help`, `ls`, and `list` are reserved root words; a task named `ls` or `list` must be reached by a unique prefix such as `t lis`. There are no root `add`, `rm`, `new`, or `show` actions.
 Named references prefer an exact task name, then a unique case-sensitive prefix. Ambiguous prefixes fail. Unknown names fail except for `t NAME new` and `t NAME todo add TEXT...`. Explicit `new` creates exactly `NAME`, without resolving it as a prefix of another task. Help never creates a task.
@@ -115,13 +115,21 @@ Options are scoped to commands, not universally available. `TASK` may be a name,
 | Command | Behavior |
 |---|---|
-| `t` | Lists all tasks alphabetically, regardless of status or context |
+| `t`, `t ls`, or `t list` | Lists all tasks alphabetically with open todo counts, regardless of status or context |
 | `t TASK` or `t TASK show` | Shows status, home, next action, todos, waiting text, code directory, workspace label, resources, and home Markdown documents |
 | `t TASK current` | Prints the resolved name; named references also save the fallback without changing focus |
 | `t NAME new` | Creates an active task and notes home; an exact existing name preserves its record and ensures the home exists |
 | `t TASK next [TEXT...]` | Stores text, prints it with no text, or removes it with `--clear` |
 | `t TASK waiting [TEXT...]` | Stores blocking text and sets waiting status; prints with no text; clears with `--clear` |
 | `t TASK status [STATE]` | Prints status or sets `active`, `waiting`, `done`, or `archived` |
+| `t TASK path` | Prints the start directory: primary directory, worktree, or task home |
+| `t TASK branch` | Prints the worktree's git branch, or `(detached)` |
+| `t TASK sh [CMD...]` | Changes to the start directory and execs a shell or the command |
+| `t TASK cd` | Sends `cd` to the current Herdr pane (requires `HERDR_PANE_ID`) |
+| `t TASK tree` | Prints the worktree name and path; fails when the task has none |
+| `t NAME tree new [--app APP] [--sparse GROUP]` | Creates the task if needed, creates or reuses a worktree under `~/work/NAME/main` (or `~/work/parent/child` for a subtask), records it, and opens the workspace when Herdr is running |
+| `t TASK tree rm` | Detaches the worktree from the task and its subtasks, keeping the directory and registering it as a directory resource |
+| `t TASK tree resume [TREE]` | Attaches an unassigned worktree by name, or via fuzzyfind with no name |
 | `t TASK done` | Sets status to done |
 | `t TASK archive` | Sets status to archived |
@@ -415,9 +423,11 @@ Hiiro also initializes its database and records CLI invocations. Reading task da
 | Source | Responsibility |
 |---|---|
-| `bin/t` | Task-scoped commands, resources, documents, and Herdr actions; target of `~/bin/t` |
-| `bin/tt` | Delegates to the task todo scope |
+| `exe/t`, `exe/tt` | Gem executables; `Hiiro.run` launchers over `Hiiro::TaskCli` (`bin/t`, `bin/tt` are symlinks) |
+| `lib/hiiro/task_cli.rb` | `Hiiro::TaskCli.setup`/`setup_todo` and the `Commands` module: task-scoped commands, resources, documents, and Herdr actions |
+| `lib/hiiro/current_task.rb` | Shared current-task resolution (Herdr workspace, working directory, saved pin) used by `TaskScope` and `Environment#task` |
 | `lib/hiiro/task_scope.rb` | Named/current/orphan reference resolution and cached task context |
+| `lib/hiiro/tasks.rb` | `TaskManager#create_tree` worktree creation shared with `t TASK tree new` |
 | `lib/hiiro/task_sessions.rb` | Native AI launch/resume dispatch and running-pane focus |
 | `lib/hiiro/task_record.rb` | Shared records, states, home naming, and resource identity |
 | `lib/hiiro/todo.rb` | Shared `TodoItem` rows and full-task-name association |

data/docs/why-t.md CHANGED Viewed

@@ -73,7 +73,7 @@ That saves the explanation and changes the task's status to `waiting`. The next
 }
 ```
-Bare `t` lists every task and status, including done and archived work. Active and waiting rows show their next-action and blocker text, so you can review what needs attention without opening every terminal.
+Bare `t` (or `t ls` / `t list`) lists every task and status, including done and archived work. Each name carries its open todo count, such as `prez (3)`, and active and waiting rows show their next-action and blocker text, so you can review what needs attention without opening every terminal.
 When the answer arrives:
@@ -303,4 +303,4 @@ Start with task names and useful next actions. Add documents, links, and termina
 ## Read next
-[The complete t command reference](t.md) covers every subcommand, option, alias, state transition, storage location, and Herdr/worktree side effect. The canonical implementation is the repository's `bin/t`, with `~/bin/t` as its symlink. Gem installation does not install the launcher.
+[The complete t command reference](t.md) covers every subcommand, option, alias, state transition, storage location, and Herdr/worktree side effect. The implementation is `Hiiro::TaskCli` in `lib/hiiro/task_cli.rb`, launched by the `t` and `tt` gem executables in `exe/`.

data/exe/h CHANGED Viewed

@@ -97,6 +97,7 @@ Hiiro.run(*ARGV, cwd: Dir.pwd, tasks: true) do
       'github' => %w[pr],
       'claude' => %w[claude],
       'hiiro'  => %w[bin plugin],
+      'task'   => %w[task],
       'other'  => %w[app bg config link misc project todo],
     }