fix: address verified review findings (repo-mutations-sync-1)

Signed-off-by: bircni <bircni@icloud.com>
This commit is contained in:
bircni committed 2026-10-18 17:38:53 +02:00
1 parent 0d47b3f149
commit 6e523d969d
11 files changed
+283 -30

No files matched your search

+52 -8
View File
@@ -7,6 +7,8 @@ import (
"context"
"errors"
"fmt"
"os"
"path/filepath"
"strings"
)
@@ -31,8 +33,8 @@ type SyncResult struct {
// when it is missing, and never changes which branch is checked out. The checked-out branch merges
// with --ff-only and needs a clean working tree; another branch moves with update-ref, which fails
// if the branch changed meanwhile. A branch that already contains the remote history is kept. A
// branch checked out in another linked worktree is refused, since moving it would leave that
// worktree's files behind its HEAD.
// branch checked out in another linked worktree, or being rebased in any worktree, is refused,
// since moving it would leave that worktree's files behind its HEAD or break the rebase.
func SyncBranch(ctx context.Context, runner Runner, opts SyncOptions) (SyncResult, error) {
run := func(args ...string) (string, error) { return runner.Output(ctx, opts.Directory, opts.Prompt, args...) }
if opts.Remote == "" || opts.Branch == "" {
@@ -58,6 +60,9 @@ func SyncBranch(ctx context.Context, runner Runner, opts SyncOptions) (SyncResul
if path := worktreeWithBranch(worktrees, ref); path != "" {
return SyncResult{}, fmt.Errorf("%s is checked out in the worktree %s; sync it from there", opts.Branch, path)
}
if path := rebasingWorktree(ctx, runner, worktrees, ref); path != "" {
return SyncResult{}, fmt.Errorf("%s is being rebased in %s; finish or abort the rebase first", opts.Branch, path)
}
}
if checkedOut {
status, err := run("status", "--porcelain=v1", "--untracked-files=normal")
@@ -91,27 +96,34 @@ func SyncBranch(ctx context.Context, runner Runner, opts SyncOptions) (SyncResul
return SyncResult{}, err
}
if _, err := run("merge-base", "--is-ancestor", commit, previous); err != nil {
return SyncResult{}, fmt.Errorf("%s and %s/%s have diverged; merge or rebase before syncing: %w", opts.Branch, opts.Remote, opts.Branch, err)
return SyncResult{}, fmt.Errorf("%s and %s/%s have diverged; merge or rebase before syncing", opts.Branch, opts.Remote, opts.Branch)
}
result.Commit = previous
return result, nil
}
}
track := func() error {
for _, setting := range [][2]string{{"remote", opts.Remote}, {"merge", ref}} {
if _, err := run("config", "branch."+opts.Branch+"."+setting[0], setting[1]); err != nil {
return fmt.Errorf("created %s, but could not set it to track %s: %w", opts.Branch, opts.Remote, err)
}
}
return nil
}
if !checkedOut {
// The old value makes update-ref fail if the branch moved, or appeared, while fetching.
if _, err := run("update-ref", "-m", "tea repo sync", ref, commit, previous); err != nil {
return SyncResult{}, fmt.Errorf("%s changed while fetching; retry sync: %w", opts.Branch, err)
}
if previous == "" {
for _, setting := range [][2]string{{"remote", opts.Remote}, {"merge", ref}} {
if _, err := run("config", "branch."+opts.Branch+"."+setting[0], setting[1]); err != nil {
return SyncResult{}, fmt.Errorf("created %s, but could not set it to track %s: %w", opts.Branch, opts.Remote, err)
}
if err := track(); err != nil {
return SyncResult{}, err
}
}
return result, nil
}
current, err := run("rev-parse", "--verify", "HEAD^{commit}")
// A checked-out branch without commits has no HEAD to compare; merge fast-forwards it.
current, err := optional(run("rev-parse", "--verify", "--quiet", "HEAD^{commit}"))
if err != nil {
return SyncResult{}, err
}
@@ -124,6 +136,11 @@ func SyncBranch(ctx context.Context, runner Runner, opts SyncOptions) (SyncResul
if actual, err := run("rev-parse", "--verify", "HEAD^{commit}"); err != nil || actual != commit {
return SyncResult{}, errors.New("HEAD changed during sync; inspect the working tree before retrying")
}
if previous == "" {
if err := track(); err != nil {
return SyncResult{}, err
}
}
return result, nil
}
@@ -142,6 +159,33 @@ func worktreeWithBranch(porcelain, ref string) string {
return ""
}
// rebasingWorktree returns the path of the worktree in worktree list --porcelain output whose
// detached HEAD is the result of rebasing ref, or "" when none is. Git records the branch being
// rebased in rebase-merge/head-name or rebase-apply/head-name of the worktree's Git directory.
func rebasingWorktree(ctx context.Context, runner Runner, porcelain, ref string) string {
path := ""
for line := range strings.Lines(porcelain) {
line = strings.TrimRight(line, "\r\n")
if value, ok := strings.CutPrefix(line, "worktree "); ok {
path = value
} else if line == "detached" {
for _, name := range []string{"rebase-merge/head-name", "rebase-apply/head-name"} {
file, err := runner.Output(ctx, path, false, "rev-parse", "--git-path", name)
if err != nil {
continue
}
if !filepath.IsAbs(file) {
file = filepath.Join(path, file)
}
if head, err := os.ReadFile(file); err == nil && strings.TrimSpace(string(head)) == ref {
return path
}
}
}
}
return ""
}
// optional returns "" without an error for a Git command that exits with status 1 to report
// that what it looked for does not exist, such as rev-parse --verify --quiet.
func optional(output string, err error) (string, error) {
+26
View File
@@ -125,6 +125,18 @@ func TestSyncBranchKeepsTheCheckedOutBranch(t *testing.T) {
}
}
func TestSyncBranchFastForwardsABranchWithoutCommits(t *testing.T) {
f := newSyncFixture(t)
empty := t.TempDir()
f.git(empty, "init", "-b", "main")
f.git(empty, "remote", "add", "origin", f.git(f.work, "remote", "get-url", "origin"))
result, err := SyncBranch(context.Background(), f.runner, SyncOptions{Directory: empty, Remote: "origin", Branch: "main"})
require.NoError(t, err)
require.Equal(t, SyncResult{"main", f.ahead, "", "origin"}, result)
require.Equal(t, f.ahead, f.git(empty, "rev-parse", "HEAD"))
require.Equal(t, "origin", f.git(empty, "config", "branch.main.remote"))
}
func TestSyncBranchRefusesWhatItCannotFastForward(t *testing.T) {
for _, tc := range []struct {
name, message string
@@ -149,6 +161,19 @@ func TestSyncBranchRefusesWhatItCannotFastForward(t *testing.T) {
name: "checked out in another worktree", message: "main is checked out in the worktree",
prepare: func(f syncFixture) { f.git(f.work, "worktree", "add", filepath.Join(t.TempDir(), "linked"), "main") },
},
{
name: "being rebased", message: "main is being rebased in",
prepare: func(f syncFixture) {
f.git(f.work, "switch", "main")
require.NoError(t, os.WriteFile(filepath.Join(f.work, "local.txt"), []byte("local"), 0o600))
f.git(f.work, "add", "local.txt")
f.git(f.work, "commit", "-m", "local")
f.git(f.work, "fetch", "origin")
// The failing exec step stops the rebase with main detached.
_, _ = f.runner.Output(context.Background(), f.work, false, "rebase", "--exec", "false", "origin/main")
require.Empty(t, f.git(f.work, "branch", "--show-current"))
},
},
} {
t.Run(tc.name, func(t *testing.T) {
f := newSyncFixture(t)
@@ -156,6 +181,7 @@ func TestSyncBranchRefusesWhatItCannotFastForward(t *testing.T) {
branch, before := f.git(f.work, "branch", "--show-current"), f.git(f.work, "rev-parse", "main")
_, err := f.sync("main")
require.ErrorContains(t, err, tc.message)
require.NotContains(t, err.Error(), "credentials")
require.Equal(t, branch, f.git(f.work, "branch", "--show-current"))
require.Equal(t, before, f.git(f.work, "rev-parse", "main"))
})