hiiro 0.1.213 → 0.1.214

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0057308e049772c9676b39678d2ca0bc970c4bfb63fde93bb8c3ad92545537f9'
-  data.tar.gz: 66bd247b6c02dafa378d2a081bd553b1b0d6b212f7737ee06cc71c568c334790
+  metadata.gz: 9de74ec0cfb202ffe27c661ee10cc51604adad8811263c88da91c4d34345cafc
+  data.tar.gz: 599316268a674b407da7bc2f9782a0f7157c26d08cf321a3fee449e984c7e4c7
 SHA512:
-  metadata.gz: 8b2adcb6d32b80c3486e0018dffa7704c4440753dcd6cb8394ed8392612446d24c548c527b136c58daeaafe06a1aad520e47922904fac8b65e5f8399e8c7ec20
-  data.tar.gz: cb8334fdb4f7951bfadae24ec5027a6219e6b1b27e3450fb887ab667344d8aeddec9e71eba566c8549a3098bc8787372e368760129cb9b9c4332d7ddb478e4e5
+  metadata.gz: a41c63d2b2f684c2a2cda55764b01010f15bad2b6eb642d529db3976f878c3748f0ffead82001d96dc42a9c4a4cd27026a0b9772b267de42a6b380fb7c047537
+  data.tar.gz: '019205a1b4fbffe74aff57973baa2ffbc76b7f43a0c8dc27f35fea280714b1b99d3df8113af61eb1bc3723af9517099853ce37ea4d1516b3aeb4cb412ae8052f'

data/examples/sparse_groups.yml

@@ -0,0 +1,97 @@
+# Example sparse_groups.yml
+# Place at ~/.config/hiiro/sparse_groups.yml
+#
+# Sparse checkout groups let you limit which directories are checked out in a
+# worktree. This keeps worktrees small and fast when you only need a subset of
+# a large monorepo.
+#
+# Each key is a group name. Each value is a list of directory paths (relative
+# to the repo root) that will be included in the sparse checkout.
+#
+# Usage with h task start:
+#   h task start my-task --sparse ruby
+#   h task start my-task --sparse ruby --sparse frontend
+#   h task start my-task -s ruby -s shared
+
+# =============================================================================
+# Single-service groups - check out only what one service needs
+# =============================================================================
+
+ruby:
+  - apps/api
+  - lib
+  - config
+  - db
+
+frontend:
+  - apps/web
+  - apps/mobile
+  - packages/design-system
+  - packages/shared-types
+
+graphql:
+  - services/graphql
+  - packages/shared-types
+
+workers:
+  - apps/api
+  - workers
+  - lib
+  - config
+
+# =============================================================================
+# Shared/common groups - infrastructure or tooling used by multiple services
+# =============================================================================
+
+shared:
+  - lib
+  - config
+  - scripts
+  - .github
+
+infra:
+  - terraform
+  - k8s
+  - scripts/deploy
+
+# =============================================================================
+# Compound groups - combine multiple service directories into one group.
+# Use with a single --sparse flag when you know you'll touch both sides.
+# =============================================================================
+
+# Full-stack: Ruby API + GraphQL + Web frontend (no mobile, no workers)
+fullstack:
+  - apps/api
+  - services/graphql
+  - apps/web
+  - packages/design-system
+  - packages/shared-types
+  - lib
+  - config
+  - db
+
+# Backend only: API + workers + shared lib
+backend:
+  - apps/api
+  - workers
+  - lib
+  - config
+  - db
+
+# =============================================================================
+# QUICK REFERENCE
+# =============================================================================
+#
+# Create a new task with a sparse checkout:
+#   h task start my-feature --sparse ruby
+#   h task start my-feature -s ruby -s shared
+#   h task start my-feature --sparse fullstack
+#
+# --sparse can be repeated to combine multiple groups:
+#   h task start my-feature --sparse ruby --sparse infra
+#   -> checks out: apps/api + lib + config + db + terraform + k8s + scripts/deploy
+#
+# Without --sparse, a full checkout is performed (default git behavior).
+#
+# Directories listed in a group are passed directly to git sparse-checkout.
+# All listed paths are relative to the repo root.

data/lib/hiiro/git.rb

@@ -143,6 +143,15 @@ class Hiiro
       run_system('worktree', 'repair')
     end
 
+    def sparse_checkout(path, dirs, cone: true)
+      if cone
+        run_system('-C', path, 'sparse-checkout', 'init', '--cone')
+      else
+        run_system('-C', path, 'sparse-checkout', 'init')
+      end
+      run_system('-C', path, 'sparse-checkout', 'set', *dirs)
+    end
+
     # Remote convenience methods
 
     def remotes

data/lib/hiiro/tasks.rb

@@ -75,7 +75,7 @@ class Hiiro
 
     # --- Actions ---
 
-    def start_task(name, app_name: nil)
+    def start_task(name, app_name: nil, sparse_groups: [])
       existing = task_by_name(name)
       if existing
         puts "Task '#{existing.name}' already exists. Switching..."
@@ -106,6 +106,8 @@ class Hiiro
         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)
@@ -508,6 +510,16 @@ class Hiiro
       end
     end
 
+    def apply_sparse_checkout(path, group_names)
+      dirs = SparseGroups.dirs_for_groups(group_names)
+      if dirs.empty?
+        puts "WARNING: No directories found for sparse groups: #{group_names.join(', ')}"
+        return
+      end
+      puts "Applying sparse checkout (groups: #{group_names.join(', ')})..."
+      Hiiro::Git.new(nil, path).sparse_checkout(path, dirs)
+    end
+
     def send_cd(path)
       pane = ENV['TMUX_PANE']
       if pane
@@ -607,14 +619,33 @@ class Hiiro
     end
   end
 
+  class SparseGroups
+    FILE = File.join(Dir.home, '.config', 'hiiro', 'sparse_groups.yml')
+
+    def self.load(file: FILE)
+      return {} unless File.exist?(file)
+      YAML.safe_load_file(file) || {}
+    end
+
+    def self.dirs_for_groups(group_names, file: FILE)
+      groups = load(file: file)
+      group_names.flat_map { |name| Array(groups[name]) }.uniq
+    end
+  end
+
   module Tasks
     def self.build_hiiro(parent_hiiro, tm)
       task_hiiro = parent_hiiro.make_child do |h|
         h.add_subcmd(:list) { tm.list }
         h.add_subcmd(:ls) { tm.list }
 
-        h.add_subcmd(:start) do |task_name, app_name=nil|
-          tm.start_task(task_name, app_name: app_name)
+        h.add_subcmd(:start) do |*raw_args|
+          opts = Hiiro::Options.parse(raw_args) do
+            option(:sparse, short: :s, desc: 'Sparse checkout group (may be repeated)', multi: true)
+          end
+          task_name = opts.args[0]
+          app_name  = opts.args[1]
+          tm.start_task(task_name, app_name: app_name, sparse_groups: opts.sparse)
         end
 
         h.add_subcmd(:switch) do |task_name=nil, app_name=nil|

data/lib/hiiro/version.rb

@@ -1,3 +1,3 @@
 class Hiiro
-  VERSION = "0.1.213"
+  VERSION = "0.1.214"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.213
+  version: 0.1.214
 platform: ruby
 authors:
 - Joshua Toyota
@@ -129,6 +129,7 @@ files:
 - editboth
 - examples/services.sleepers.yml
 - examples/services.yml
+- examples/sparse_groups.yml
 - exe/h
 - exe/hiiro
 - h-tmux-plugins.tmux