hiiro 0.1.365 → 0.1.367

data/lib/hiiro/task_scope.rb

@@ -0,0 +1,51 @@
+class Hiiro
+  class TaskScope
+    class Error < Hiiro::Error; end
+
+    attr_reader :reference
+
+    def initialize(reference, herdr:)
+      @reference = reference.to_s
+      raise Error, 'Task reference cannot be empty' if @reference.empty?
+
+      @herdr = herdr
+    end
+
+    def explicit?
+      !%w[. -].include?(reference)
+    end
+
+    def orphan?
+      reference == '-'
+    end
+
+    def task
+      return @task if defined?(@task)
+
+      @task = if orphan?
+        nil
+      elsif explicit?
+        result = Matcher.new(TaskRecord.all_as_list, :name).by_prefix(reference)
+        match = result.resolved
+        if !match && result.ambiguous?
+          raise Error, "Ambiguous task #{reference}: #{result.matches.map { |item| item.item.name }.join(', ')}"
+        end
+        match&.item
+      else
+        current_task
+      end
+    end
+
+    def task!
+      raise Error, "Use t - todo for orphan todos; '-' does not select a task" if orphan?
+
+      task || raise(Error, "Task not found: #{reference}")
+    end
+
+    private
+
+    def current_task
+      CurrentTask.new(herdr: @herdr, pin: true).resolve!
+    end
+  end
+end

data/lib/hiiro/task_sessions.rb

@@ -0,0 +1,51 @@
+require 'shellwords'
+
+class Hiiro
+  class TaskSessions
+    class Error < Hiiro::Error; end
+
+    def initialize(client, workspace:, directory:)
+      @client = client
+      @workspace = workspace
+      @directory = directory
+    end
+
+    def run(tool, argv)
+      raise Error, "Unknown AI tool: #{tool}" unless %w[omp codex claude].include?(tool)
+
+      first = argv.first
+      resume = first && !first.empty? && 'resume'.start_with?(first)
+      args = resume ? argv.drop(1) : argv
+      if resume && args.empty?
+        panes = @client.panes(workspace: @workspace).select { |pane| pane.agent == tool }
+        if panes.length > 1
+          raise Error, "Multiple running #{tool} panes: #{panes.map(&:id).join(', ')}; choose a pane or pass native resume arguments"
+        end
+        if (pane = panes.first)
+          raise Error, "Could not focus pane #{pane.id}" unless @client.focus_pane(pane.id)
+
+          return pane.id
+        end
+      end
+
+      command = [tool]
+      command << (tool == 'codex' ? 'resume' : '--resume') if resume
+      command.concat(args)
+      result = @client.new_tab(
+        name: tool,
+        workspace: @workspace,
+        start_directory: @directory,
+        focus: true,
+      )
+      tab_id = result.is_a?(Hash) && result.dig('tab', 'tab_id')
+      raise Error, "Could not create #{tool} tab" unless tab_id.is_a?(String) && !tab_id.empty?
+      pane_id = result.dig('root_pane', 'pane_id')
+      raise Error, "Created #{tool} tab has no root pane" unless pane_id.is_a?(String) && !pane_id.empty?
+      unless @client.run_in_pane(pane_id, Shellwords.join(command))
+        raise Error, "Could not start #{tool} in pane #{pane_id}"
+      end
+
+      tab_id
+    end
+  end
+end

data/lib/hiiro/tasks.rb

@@ -175,6 +175,28 @@ class Hiiro
       task_name = scope == :subtask ? "#{current_parent_task.name}/#{name}" : name
       subtree_name = scope == :subtask ? "#{current_parent_task.name}/#{name}" : "#{name}/main"
 
+      target_path = create_tree(subtree_name, sparse_groups: sparse_groups)
+      return unless target_path
+
+      session_name = task_name
+      task = Task.new(name: task_name, tree: subtree_name, session: session_name)
+      config.save_task(task)
+
+      base_dir = target_path
+      if app_name
+        app = environment.find_app(app_name)
+        base_dir = app.resolve(target_path) if app
+      end
+
+      Dir.chdir(base_dir)
+      hiiro.start_herdr_workspace(session_name, start_directory: Dir.pwd)
+
+      puts "Started task '#{task_name}' in worktree '#{subtree_name}'"
+    end
+
+    # Create (or reuse an unassigned) worktree under WORK_DIR and return its path,
+    # or nil on failure. Shared by `h task start` and `t TASK tree new`.
+    def create_tree(subtree_name, sparse_groups: [])
       target_path = File.join(Hiiro::WORK_DIR, subtree_name)
 
       git = Hiiro::Git.new(nil, Hiiro::REPO_PATH)
@@ -184,33 +206,19 @@ class Hiiro
         FileUtils.mkdir_p(File.dirname(target_path))
         unless git.move_worktree(available.path, target_path, repo_path: Hiiro::REPO_PATH)
           puts "ERROR: Failed to rename worktree"
-          return
+          return nil
         end
       else
         puts "Creating new worktree '#{subtree_name}'..."
         FileUtils.mkdir_p(File.dirname(target_path))
         unless git.add_worktree_detached(target_path, repo_path: Hiiro::REPO_PATH)
           puts "ERROR: Failed to create worktree"
-          return
+          return nil
         end
       end
 
       apply_sparse_checkout(target_path, sparse_groups) if sparse_groups.any?
-
-      session_name = task_name
-      task = Task.new(name: task_name, tree: subtree_name, session: session_name)
-      config.save_task(task)
-
-      base_dir = target_path
-      if app_name
-        app = environment.find_app(app_name)
-        base_dir = app.resolve(target_path) if app
-      end
-
-      Dir.chdir(base_dir)
-      hiiro.start_herdr_workspace(session_name, start_directory: Dir.pwd)
-
-      puts "Started task '#{task_name}' in worktree '#{subtree_name}'"
+      target_path
     end
 
     def switch_to_task(task, app_name: nil, force: false)
@@ -1463,10 +1471,11 @@ class Hiiro
     end
 
     def name
-      @name ||= if path.start_with?(Hiiro::WORK_DIR + '/')
-        path.sub(Hiiro::WORK_DIR + '/', '')
-      else
-        File.basename(path)
+      @name ||= begin
+        roots = [Hiiro::WORK_DIR]
+        roots << File.realpath(Hiiro::WORK_DIR) if Dir.exist?(Hiiro::WORK_DIR)
+        root = roots.uniq.find { |dir| path.start_with?(dir + '/') }
+        root ? path.delete_prefix(root + '/') : File.basename(path)
       end
     end
 
@@ -1683,13 +1692,17 @@ class Hiiro
     end
 
     def task
+      return @task if defined?(@task)
+
+      s = session
+      t = tree
+      @task = all_tasks.find { |task|
+        (s && task.session_name == s.name) ||
+          (t && (task.tree_name == t.name || task.tree_name == t.path))
+      }
       @task ||= begin
-        s = session
-        t = tree
-        all_tasks.find { |task|
-          (s && task.session_name == s.name) ||
-            (t && (task.tree_name == t.name || task.tree_name == t.path))
-        }
+        record = CurrentTask.new(herdr: -> { Hiiro::Herdr.client }, cwd: path, pin: false).resolve
+        record && all_tasks.find { |task| task.name == record.name }
       end
     end
 

data/lib/hiiro/version.rb

@@ -1,4 +1,4 @@
 class Hiiro
-  VERSION = "0.1.365"
+  VERSION = "0.1.367"
   SUPPORTED_RUBY_VERSION = ">= 3.2.0"
 end

data/lib/hiiro.rb

@@ -6,6 +6,7 @@ require "ostruct"
 require 'awesome_print'
 
 require_relative "hiiro/version"
+require_relative "hiiro/error"
 require_relative "hiiro/config"
 require_relative "hiiro/effects"
 require_relative "hiiro/db"
@@ -46,6 +47,10 @@ require_relative "hiiro/pane_home"
 require_relative "hiiro/pin_record"
 require_relative "hiiro/reminder"
 require_relative 'hiiro/registry'
+require_relative 'hiiro/current_task'
+require_relative 'hiiro/task_scope'
+require_relative 'hiiro/task_sessions'
+require_relative 'hiiro/task_cli'
 require_relative 'hiiro/tui'
 
 class String
@@ -65,7 +70,7 @@ class Hiiro
   WORK_DIR = File.join(Dir.home, 'work')
   REPO_PATH = File.join(WORK_DIR, '.git')
 
-  def self.init(*oargs, plugins: [], logging: false, tasks: false, task_scope: nil, **values, &block)
+  def self.init(*oargs, plugins: [], logging: false, tasks: false, task_scope: nil, builtin_commands: true, **values, &block)
     load_env
     Hiiro::DB.setup!
 
@@ -98,24 +103,14 @@ class Hiiro
     new(h_bin, *h_args, logging: logging, tasks: tasks, task_scope: task_scope, **values).tap do |hiiro|
       hiiro.load_plugins(plugins)
 
-      hiiro.add_subcommand(:pry) { |*args|
-        binding.pry
-      }
-
-      hiiro.add_subcmd(:edit, **values) { |*args|
-        hiiro.edit_files(hiiro.bin)
-      }
-
-      if hiiro.tasks_enabled?
-        hiiro.add_subcmd(:task) do |*args|
-          tm = TaskManager.new(hiiro, scope: :task)
-          Tasks.build_hiiro(hiiro, tm).run
-        end
+      if builtin_commands
+        hiiro.add_subcommand(:pry) { |*args|
+          binding.pry
+        }
 
-        hiiro.add_subcmd(:subtask) do |*args|
-          tm = TaskManager.new(hiiro, scope: :subtask)
-          Tasks.build_hiiro(hiiro, tm).run
-        end
+        hiiro.add_subcmd(:edit, **values) { |*args|
+          hiiro.edit_files(hiiro.bin)
+        }
       end
 
       if block
@@ -132,8 +127,8 @@ class Hiiro
     Options.setup(&block)
   end
 
-  def self.run(*args, plugins: [], logging: false, tasks: false, task_scope: nil, **values, &block)
-    hiiro = init(*args, plugins:, logging:, tasks:, task_scope:, **values, &block)
+  def self.run(*args, plugins: [], logging: false, tasks: false, task_scope: nil, builtin_commands: true, **values, &block)
+    hiiro = init(*args, plugins:, logging:, tasks:, task_scope:, builtin_commands:, **values, &block)
 
     hiiro.run
   end
@@ -227,6 +222,12 @@ class Hiiro
     Hiiro::Config.open(file, dir: dir)
   end
 
+  # Open a file, directory, or URL with the OS default handler.
+  def open_default(target)
+    executable = RUBY_PLATFORM.include?('darwin') ? 'open' : 'xdg-open'
+    system(executable, target)
+  end
+
   def herdr_client
     @herdr_client ||= Herdr.client!(self)
   end
@@ -276,6 +277,8 @@ class Hiiro
     handle_result(result)
 
     exit 1
+  rescue Hiiro::Error => e
+    abort "ERROR: #{e.message}"
   rescue => e
     puts "ERROR: #{e.message}"
     puts e.backtrace

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.365
+  version: 0.1.367
 platform: ruby
 authors:
 - Joshua Toyota
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-13 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -129,6 +129,8 @@ email:
 executables:
 - h
 - hiiro
+- t
+- tt
 extensions: []
 extra_rdoc_files: []
 files:
@@ -170,11 +172,14 @@ files:
 - bin/h-sha
 - bin/h-sparse
 - bin/h-tags
+- bin/h-task
 - bin/h-time
 - bin/h-title
 - bin/h-todo
 - bin/h-window
 - bin/h-wtree
+- bin/t
+- bin/tt
 - bkup..ruby-version
 - demo.sh
 - demo.typescript
@@ -325,6 +330,8 @@ files:
 - docs/h-window.md
 - docs/h-wtree.md
 - docs/h.md
+- docs/t.md
+- docs/why-t.md
 - editboth
 - examples/bin-with-proposed-options
 - examples/services.sleepers.yml
@@ -332,6 +339,8 @@ files:
 - examples/sparse_groups.yml
 - exe/h
 - exe/hiiro
+- exe/t
+- exe/tt
 - h-tmux-plugins.tmux
 - hiiro.gemspec
 - lib/hiiro.rb
@@ -345,8 +354,10 @@ files:
 - lib/hiiro/capture.rb
 - lib/hiiro/check_run.rb
 - lib/hiiro/config.rb
+- lib/hiiro/current_task.rb
 - lib/hiiro/db.rb
 - lib/hiiro/effects.rb
+- lib/hiiro/error.rb
 - lib/hiiro/fuzzyfind.rb
 - lib/hiiro/git.rb
 - lib/hiiro/git/branch.rb
@@ -379,7 +390,10 @@ files:
 - lib/hiiro/service_manager.rb
 - lib/hiiro/shell.rb
 - lib/hiiro/tags.rb
+- lib/hiiro/task_cli.rb
 - lib/hiiro/task_record.rb
+- lib/hiiro/task_scope.rb
+- lib/hiiro/task_sessions.rb
 - lib/hiiro/tasks.rb
 - lib/hiiro/todo.rb
 - lib/hiiro/tui.rb