[feat] Add progress indicators for long-running operations (#78)

* [feat] Add progress callback and capture output in deps package

Define ProgressFunc type and thread it through Install(),
InstallPreferSource(), and RunPostCreateHooks(). Replace
cmd.Stdout/Stderr = os.Stdout/Stderr with bytes.Buffer capture
to prevent spinner interference, surfacing output only in errors.

* [feat] Wire progress indicators into all commands

Update installDeps, installDepsPreferSource, and runHooks to accept
ProgressFunc. Add progress closures in add, restore, duplicate, and
deps install commands to show per-item [n/m] spinner updates.

* [test] Add tests for progress callbacks and output capture

Add TestInstallProgressCallback, TestInstallOutputCapture,
TestRunPostCreateHooksProgressCallback, and
TestRunPostCreateHooksOutputCapture. Update all existing calls
with nil progress argument.

Author: lugassawan

cmd/add.go

@@ -99,15 +99,19 @@ var addCmd = &cobra.Command{
 		var depsResults []deps.InstallResult
 		if !skipDeps {
 			s.Update("Installing dependencies...")
-			depsResults = installDeps(r, cfg, wtPath, wtEntries)
+			depsResults = installDeps(r, cfg, wtPath, wtEntries, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Installing dependencies... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		// Post-create hooks
 		skipHooks, _ := cmd.Flags().GetBool(flagSkipHooks)
 		var hookResults []deps.HookResult
 		if !skipHooks && len(cfg.PostCreate) > 0 {
 			s.Update("Running hooks...")
-			hookResults = runHooks(wtPath, cfg.PostCreate)
+			hookResults = runHooks(wtPath, cfg.PostCreate, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Running hooks... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		s.Stop()

cmd/deps.go

@@ -196,7 +196,9 @@ var depsInstallCmd = &cobra.Command{
 
 		s.Start("Installing dependencies...")
 		mgr := &deps.Manager{Runner: r}
-		results := mgr.Install(wt.Path, modules)
+		results := mgr.Install(wt.Path, modules, func(cur, total int, name string) {
+			s.Update(fmt.Sprintf("Installing dependencies... (%s) [%d/%d]", name, cur, total))
+		})
 		s.Stop()
 
 		out := cmd.OutOrStdout()

cmd/deps_helpers.go

@@ -12,7 +12,7 @@ import (
 
 // installDeps detects modules and installs dependencies, returning the results.
 // existingEntries should contain the current worktree list to avoid a redundant git call.
-func installDeps(r git.Runner, cfg *config.Config, wtPath string, existingEntries []git.WorktreeEntry) []deps.InstallResult {
+func installDeps(r git.Runner, cfg *config.Config, wtPath string, existingEntries []git.WorktreeEntry, onProgress deps.ProgressFunc) []deps.InstallResult {
 	var configModules []config.ModuleConfig
 	if cfg.Deps != nil {
 		configModules = cfg.Deps.Modules
@@ -26,12 +26,12 @@ func installDeps(r git.Runner, cfg *config.Config, wtPath string, existingEntrie
 	}
 
 	mgr := &deps.Manager{Runner: r}
-	return mgr.Install(wtPath, modules)
+	return mgr.Install(wtPath, modules, onProgress)
 }
 
 // installDepsPreferSource is like installDeps but prefers cloning from sourceWT.
 // existingEntries should contain the current worktree list to avoid a redundant git call.
-func installDepsPreferSource(r git.Runner, cfg *config.Config, wtPath, sourceWT string, existingEntries []git.WorktreeEntry) []deps.InstallResult {
+func installDepsPreferSource(r git.Runner, cfg *config.Config, wtPath, sourceWT string, existingEntries []git.WorktreeEntry, onProgress deps.ProgressFunc) []deps.InstallResult {
 	var configModules []config.ModuleConfig
 	if cfg.Deps != nil {
 		configModules = cfg.Deps.Modules
@@ -45,7 +45,7 @@ func installDepsPreferSource(r git.Runner, cfg *config.Config, wtPath, sourceWT
 	}
 
 	mgr := &deps.Manager{Runner: r}
-	return mgr.InstallPreferSource(wtPath, sourceWT, modules)
+	return mgr.InstallPreferSource(wtPath, sourceWT, modules, onProgress)
 }
 
 // worktreePathsExcluding returns paths from entries, excluding the given path.
@@ -78,8 +78,8 @@ func printInstallResults(out io.Writer, results []deps.InstallResult) {
 }
 
 // runHooks executes post-create hooks and returns the results.
-func runHooks(wtPath string, hooks []string) []deps.HookResult {
-	return deps.RunPostCreateHooks(wtPath, hooks)
+func runHooks(wtPath string, hooks []string, onProgress deps.ProgressFunc) []deps.HookResult {
+	return deps.RunPostCreateHooks(wtPath, hooks, onProgress)
 }
 
 // printHookResultsList prints pre-computed hook results.

cmd/deps_helpers_test.go

@@ -151,7 +151,7 @@ func TestInstallDeps(t *testing.T) {
 		{Path: newWT, Branch: "feature/test"},
 	}
 
-	results := installDeps(r, cfg, newWT, entries)
+	results := installDeps(r, cfg, newWT, entries, nil)
 	if len(results) == 0 {
 		t.Fatal("expected at least 1 result from installDeps")
 	}
@@ -179,7 +179,7 @@ func TestInstallDepsNoLockfiles(t *testing.T) {
 		Deps: &config.DepsConfig{AutoDetect: boolPtr(true)},
 	}
 
-	results := installDeps(r, cfg, newWT, nil)
+	results := installDeps(r, cfg, newWT, nil, nil)
 	if results != nil {
 		t.Errorf("expected nil results for no lockfiles, got %v", results)
 	}
@@ -219,7 +219,7 @@ func TestInstallDepsPreferSource(t *testing.T) {
 		{Path: newWT, Branch: "feature/copy"},
 	}
 
-	results := installDepsPreferSource(r, cfg, newWT, sourceWT, entries)
+	results := installDepsPreferSource(r, cfg, newWT, sourceWT, entries, nil)
 	if len(results) == 0 {
 		t.Fatal("expected at least 1 result")
 	}
@@ -244,7 +244,7 @@ func TestInstallDepsPreferSourceNoLockfiles(t *testing.T) {
 		Deps: &config.DepsConfig{AutoDetect: boolPtr(true)},
 	}
 
-	results := installDepsPreferSource(r, cfg, newWT, sourceWT, nil)
+	results := installDepsPreferSource(r, cfg, newWT, sourceWT, nil, nil)
 	if results != nil {
 		t.Errorf("expected nil results for no lockfiles, got %v", results)
 	}
@@ -260,7 +260,7 @@ func TestInstallDepsNilDepsConfig(t *testing.T) {
 
 	cfg := &config.Config{} // Deps is nil
 
-	results := installDeps(r, cfg, newWT, nil)
+	results := installDeps(r, cfg, newWT, nil, nil)
 	if results != nil {
 		t.Errorf("expected nil results for nil Deps config, got %v", results)
 	}
@@ -277,7 +277,7 @@ func TestInstallDepsPreferSourceNilDepsConfig(t *testing.T) {
 
 	cfg := &config.Config{} // Deps is nil
 
-	results := installDepsPreferSource(r, cfg, newWT, sourceWT, nil)
+	results := installDepsPreferSource(r, cfg, newWT, sourceWT, nil, nil)
 	if results != nil {
 		t.Errorf("expected nil results for nil Deps config, got %v", results)
 	}
@@ -286,7 +286,7 @@ func TestInstallDepsPreferSourceNilDepsConfig(t *testing.T) {
 func TestRunHooks(t *testing.T) {
 	dir := t.TempDir()
 
-	results := runHooks(dir, []string{"touch marker.txt"})
+	results := runHooks(dir, []string{"touch marker.txt"}, nil)
 	if len(results) != 1 {
 		t.Fatalf("expected 1 result, got %d", len(results))
 	}
@@ -302,7 +302,7 @@ func TestRunHooks(t *testing.T) {
 func TestRunHooksFailure(t *testing.T) {
 	dir := t.TempDir()
 
-	results := runHooks(dir, []string{"false"})
+	results := runHooks(dir, []string{"false"}, nil)
 	if len(results) != 1 {
 		t.Fatalf("expected 1 result, got %d", len(results))
 	}

cmd/duplicate.go

@@ -128,15 +128,19 @@ var duplicateCmd = &cobra.Command{
 		var depsResults []deps.InstallResult
 		if !skipDeps {
 			s.Update("Installing dependencies...")
-			depsResults = installDepsPreferSource(r, cfg, wtPath, wt.Path, wtEntries)
+			depsResults = installDepsPreferSource(r, cfg, wtPath, wt.Path, wtEntries, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Installing dependencies... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		// Post-create hooks
 		skipHooks, _ := cmd.Flags().GetBool(flagSkipHooks)
 		var hookResults []deps.HookResult
 		if !skipHooks && len(cfg.PostCreate) > 0 {
 			s.Update("Running hooks...")
-			hookResults = runHooks(wtPath, cfg.PostCreate)
+			hookResults = runHooks(wtPath, cfg.PostCreate, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Running hooks... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		s.Stop()

cmd/restore.go

@@ -78,15 +78,19 @@ var restoreCmd = &cobra.Command{
 		var depsResults []deps.InstallResult
 		if !skipDeps {
 			s.Update("Installing dependencies...")
-			depsResults = installDeps(r, cfg, wtPath, wtEntries)
+			depsResults = installDeps(r, cfg, wtPath, wtEntries, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Installing dependencies... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		// Post-create hooks
 		skipHooks, _ := cmd.Flags().GetBool(flagSkipHooks)
 		var hookResults []deps.HookResult
 		if !skipHooks && len(cfg.PostCreate) > 0 {
 			s.Update("Running hooks...")
-			hookResults = runHooks(wtPath, cfg.PostCreate)
+			hookResults = runHooks(wtPath, cfg.PostCreate, func(cur, total int, name string) {
+				s.Update(fmt.Sprintf("Running hooks... (%s) [%d/%d]", name, cur, total))
+			})
 		}
 
 		s.Stop()

internal/deps/hooks.go

@@ -1,9 +1,10 @@
 package deps
 
 import (
+	"bytes"
 	"fmt"
-	"os"
 	"os/exec"
+	"strings"
 )
 
 // HookResult holds the outcome of a post-create hook execution.
@@ -14,17 +15,23 @@ type HookResult struct {
 
 // RunPostCreateHooks executes shell commands in the worktree directory.
 // It collects errors but does not stop on failure — all hooks run regardless.
-func RunPostCreateHooks(worktreeDir string, hooks []string) []HookResult {
+func RunPostCreateHooks(worktreeDir string, hooks []string, onProgress ProgressFunc) []HookResult {
 	results := make([]HookResult, 0, len(hooks))
-	for _, hook := range hooks {
-		cmd := exec.Command("sh", "-c", hook)
+	for i, hook := range hooks {
+		if onProgress != nil {
+			onProgress(i+1, len(hooks), hook)
+		}
+
+		cmd := exec.Command("sh", "-c", hook) //nolint:gosec // hook commands come from user config
 		cmd.Dir = worktreeDir
-		cmd.Stdout = os.Stdout
-		cmd.Stderr = os.Stderr
+
+		var buf bytes.Buffer
+		cmd.Stdout = &buf
+		cmd.Stderr = &buf
 
 		err := cmd.Run()
 		if err != nil {
-			err = fmt.Errorf("hook %q: %w", hook, err)
+			err = fmt.Errorf("hook %q: %w\n%s", hook, err, strings.TrimSpace(buf.String()))
 		}
 		results = append(results, HookResult{Command: hook, Error: err})
 	}

internal/deps/hooks_test.go

@@ -3,13 +3,14 @@ package deps
 import (
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 )
 
 func TestRunPostCreateHooksSuccess(t *testing.T) {
 	dir := t.TempDir()
 
-	results := RunPostCreateHooks(dir, []string{"touch marker.txt"})
+	results := RunPostCreateHooks(dir, []string{"touch marker.txt"}, nil)
 
 	if len(results) != 1 {
 		t.Fatalf(fmtExpectedOneResult, len(results))
@@ -31,7 +32,7 @@ func TestRunPostCreateHooksPartialFailure(t *testing.T) {
 		"touch good.txt",
 		"false", // always fails
 		"touch also-good.txt",
-	})
+	}, nil)
 
 	if len(results) != 3 {
 		t.Fatalf("expected 3 results, got %d", len(results))
@@ -59,7 +60,7 @@ func TestRunPostCreateHooksPartialFailure(t *testing.T) {
 func TestRunPostCreateHooksEmpty(t *testing.T) {
 	dir := t.TempDir()
 
-	results := RunPostCreateHooks(dir, nil)
+	results := RunPostCreateHooks(dir, nil, nil)
 
 	if len(results) != 0 {
 		t.Errorf("expected 0 results, got %d", len(results))
@@ -72,7 +73,7 @@ func TestRunPostCreateHooksShellFeatures(t *testing.T) {
 	// Test shell features: pipes and quoting
 	results := RunPostCreateHooks(dir, []string{
 		"echo 'hello world' > output.txt",
-	})
+	}, nil)
 
 	if results[0].Error != nil {
 		t.Fatalf(fmtExpectedNoError, results[0].Error)
@@ -86,3 +87,43 @@ func TestRunPostCreateHooksShellFeatures(t *testing.T) {
 		t.Errorf("expected 'hello world\\n', got %q", string(data))
 	}
 }
+
+func TestRunPostCreateHooksProgressCallback(t *testing.T) {
+	dir := t.TempDir()
+
+	var calls []progressCall
+	onProgress := func(current, total int, name string) {
+		calls = append(calls, progressCall{current, total, name})
+	}
+
+	hooks := []string{"touch a.txt", "touch b.txt"}
+	RunPostCreateHooks(dir, hooks, onProgress)
+
+	if len(calls) != 2 {
+		t.Fatalf("expected 2 progress calls, got %d", len(calls))
+	}
+	if calls[0].current != 1 || calls[0].total != 2 || calls[0].name != "touch a.txt" {
+		t.Errorf("calls[0] = %+v, want {1 2 touch a.txt}", calls[0])
+	}
+	if calls[1].current != 2 || calls[1].total != 2 || calls[1].name != "touch b.txt" {
+		t.Errorf("calls[1] = %+v, want {2 2 touch b.txt}", calls[1])
+	}
+}
+
+func TestRunPostCreateHooksOutputCapture(t *testing.T) {
+	dir := t.TempDir()
+
+	results := RunPostCreateHooks(dir, []string{
+		"echo hook-output-captured && exit 1",
+	}, nil)
+
+	if len(results) != 1 {
+		t.Fatalf(fmtExpectedOneResult, len(results))
+	}
+	if results[0].Error == nil {
+		t.Fatal("expected error from failing hook")
+	}
+	if !strings.Contains(results[0].Error.Error(), "hook-output-captured") {
+		t.Errorf("error should contain captured output, got %q", results[0].Error.Error())
+	}
+}