issueflow

func ApplyTrackerStatus ¶

func ApplyTrackerStatus(
	ctx context.Context,
	t tracker.Tracker,
	errW io.Writer,
	issueID, trackerType string,
	pick func(ctx context.Context, issueID, trackerType string, statuses []string) (string, error),
)

ApplyTrackerStatus fetches tracker statuses, prompts the user to pick one, and applies it. All errors are non-fatal warnings. A nil tracker is a no-op.

func CloseCandidates ¶ added in v0.14.0

func CloseCandidates(ctx context.Context, s CandidateStore, c CandidateClient) ([]store.BranchRow, error)

CloseCandidates returns the branches a close picker should offer: every in-progress branch from the store, unioned with every refs/zf/branches/* entry (merged=false) that has no store row and whose feature branch resolves locally or via origin. Ref-derived rows carry IssueID == 0 as the "not yet tracked in this store" marker; the close flow promotes them via MaterializeBranch (before the merge) and TrackCandidate (after it commits).

Reads local refs only — callers should FetchBranchRefs first (getPickedBranch does so via ReconcileMergedFromRefs). Mirrors the cross-machine ref fallback in ResolveParentBranch. A ListBranchRefs failure degrades to store-only candidates (never fatal to close).

func IssueSlugForBranch ¶ added in v0.13.1

func IssueSlugForBranch(ctx context.Context, s *store.Store, branchName string) (string, error)

IssueSlugForBranch returns the issue slug owning branchName in the store, or "" when the branch is not tracked.

func MarkMergedFromRef ¶ added in v0.12.0

func MarkMergedFromRef(ctx context.Context, s *store.Store, client *git.Client, b store.BranchRow, now time.Time)

MarkMergedFromRef reads branch b's refs/zf/branches/<slug> ref and, when it carries Merged=true, marks the branch and its issue merged in the local store. now is shared across a reconcile pass so a batch of reconciled branches share one timestamp. Errors are non-fatal (best-effort cache sync).

func MaterializeBranch ¶ added in v0.14.0

func MaterializeBranch(
	ctx context.Context, c CandidateClient, picked store.BranchRow,
) (created bool, err error)

MaterializeBranch creates the local feature branch for a ref-derived close candidate when it is absent, starting from the ref the candidate resolved against (local or origin). Returns created=true when this call created the branch, so the close flow can roll it back if the close aborts before the merge commit lands. No store writes happen here — tracking is deferred to TrackCandidate so an aborted close leaves no spurious in-progress rows.

func ReconcileMergedFromRefs ¶ added in v0.12.0

func ReconcileMergedFromRefs(ctx context.Context, s *store.Store, client *git.Client)

ReconcileMergedFromRefs fetches refs/zf/branches/* (best-effort) and marks any in-progress branch whose ref has Merged=true as merged in the local store.

The branch ref is the cross-machine source of truth: the clone that closes a branch stamps Merged=true on its ref and pushes it (see the close flow's updateClosedStatus). Other clones' local stores lag until reconciled, so any picker that lists in-progress branches straight from the store (close, review sync, review request) would otherwise offer a branch that was already closed elsewhere. Call this before listing in-progress branches for such a picker.

All errors are non-fatal: the fetch is best-effort (offline ⇒ local refs only) and a failed status update just leaves the branch in the list, which is the pre-reconcile behaviour.

func ResolveParentBranch ¶ added in v0.12.0

func ResolveParentBranch(ctx context.Context, s ParentStore, c ParentClient, issueSlug, cfgBase string) (string, error)

ResolveParentBranch computes the merge target for an issue: the configured base (cfgBase, or DefaultBaseBranch when empty), redirected to the parent integration branch when issueSlug has a parent.

The store is checked first for the parent relation; on a cross-machine clone where the store has no record, the refs/zf/branches/<slug> git ref is the fallback (FetchBranchRefs runs best-effort first so a later read sees fresh refs). The parent's branch *name* is resolved from the store, then from the parent's own branch ref. Extracted verbatim from cmd/issue/close.go's resolveDefaultBase so close and commit share one implementation.

func RunIssueStart ¶

func RunIssueStart(ctx context.Context, deps StartDeps, prompter StartPrompter) error

RunIssueStart is the prompter-driven core of the issue-start flow. Called from cmd/issue's startRunE (production, via a HuhStartPrompter) and from cmd/branch's newRunE (also production). Tests call it directly with a scriptedStartPrompter. TrackerFirst is carried inside deps.Flags.

Returns nil on two non-error exits: (1) pickIssue returns (nil, nil) — only possible when a test prompter does so; production prompters always return a non-nil issue or an error — and (2) prompter.ResolveBranchConflict returns (nil, nil) to signal the operator aborted or checked out an existing branch.

func TrackCandidate ¶ added in v0.14.0

func TrackCandidate(
	ctx context.Context, s CandidateStore, c CandidateClient, picked store.BranchRow,
) (store.BranchRow, error)

TrackCandidate promotes a ref-derived close candidate (IssueID == 0) into a tracked branch: it inserts the issue + branch rows and returns the now-tracked BranchRow (with a real IssueID) for post-merge bookkeeping. A candidate that is already tracked (IssueID != 0) is returned unchanged.

runClose calls this only after the merge commit lands, so a close that aborts on conflict or cancel never inserts rows — preserving the documented "aborts without touching anything" invariant for reviewer-initiated closes.

The inserted issue's TrackerType is read from the branch ref so `git zf issue list` classifies it correctly; the tracker-update gate in the close flow reads TrackerType from the ref + config, not this row, so an empty value here does not change tracker behavior.