// Package refinery provides the merge queue processing agent. package refinery import ( "context" "encoding/json" "fmt" "os" "path/filepath" "time" "github.com/steveyegge/gastown/internal/beads" "github.com/steveyegge/gastown/internal/git" "github.com/steveyegge/gastown/internal/rig" ) // MergeQueueConfig holds configuration for the merge queue processor. type MergeQueueConfig struct { // Enabled controls whether the merge queue is active. Enabled bool `json:"enabled"` // TargetBranch is the default branch to merge to (e.g., "main"). TargetBranch string `json:"target_branch"` // IntegrationBranches enables per-epic integration branches. IntegrationBranches bool `json:"integration_branches"` // OnConflict is the strategy for handling conflicts: "assign_back" or "auto_rebase". OnConflict string `json:"on_conflict"` // RunTests controls whether to run tests before merging. RunTests bool `json:"run_tests"` // TestCommand is the command to run for testing. TestCommand string `json:"test_command"` // DeleteMergedBranches controls whether to delete branches after merge. DeleteMergedBranches bool `json:"delete_merged_branches"` // RetryFlakyTests is the number of times to retry flaky tests. RetryFlakyTests int `json:"retry_flaky_tests"` // PollInterval is how often to check for new MRs. PollInterval time.Duration `json:"poll_interval"` // MaxConcurrent is the maximum number of MRs to process concurrently. MaxConcurrent int `json:"max_concurrent"` } // DefaultMergeQueueConfig returns sensible defaults for merge queue configuration. func DefaultMergeQueueConfig() *MergeQueueConfig { return &MergeQueueConfig{ Enabled: true, TargetBranch: "main", IntegrationBranches: true, OnConflict: "assign_back", RunTests: true, TestCommand: "", DeleteMergedBranches: true, RetryFlakyTests: 1, PollInterval: 30 * time.Second, MaxConcurrent: 1, } } // Engineer is the merge queue processor that polls for ready merge-requests // and processes them according to the merge queue design. type Engineer struct { rig *rig.Rig beads *beads.Beads git *git.Git config *MergeQueueConfig workDir string // stopCh is used for graceful shutdown stopCh chan struct{} } // NewEngineer creates a new Engineer for the given rig. func NewEngineer(r *rig.Rig) *Engineer { return &Engineer{ rig: r, beads: beads.New(r.Path), git: git.NewGit(r.Path), config: DefaultMergeQueueConfig(), workDir: r.Path, stopCh: make(chan struct{}), } } // LoadConfig loads merge queue configuration from the rig's config.json. func (e *Engineer) LoadConfig() error { configPath := filepath.Join(e.rig.Path, "config.json") data, err := os.ReadFile(configPath) if err != nil { if os.IsNotExist(err) { // Use defaults if no config file return nil } return fmt.Errorf("reading config: %w", err) } // Parse config file to extract merge_queue section var rawConfig struct { MergeQueue json.RawMessage `json:"merge_queue"` } if err := json.Unmarshal(data, &rawConfig); err != nil { return fmt.Errorf("parsing config: %w", err) } if rawConfig.MergeQueue == nil { // No merge_queue section, use defaults return nil } // Parse merge_queue section into our config struct // We need special handling for poll_interval (string -> Duration) var mqRaw struct { Enabled *bool `json:"enabled"` TargetBranch *string `json:"target_branch"` IntegrationBranches *bool `json:"integration_branches"` OnConflict *string `json:"on_conflict"` RunTests *bool `json:"run_tests"` TestCommand *string `json:"test_command"` DeleteMergedBranches *bool `json:"delete_merged_branches"` RetryFlakyTests *int `json:"retry_flaky_tests"` PollInterval *string `json:"poll_interval"` MaxConcurrent *int `json:"max_concurrent"` } if err := json.Unmarshal(rawConfig.MergeQueue, &mqRaw); err != nil { return fmt.Errorf("parsing merge_queue config: %w", err) } // Apply non-nil values to config (preserving defaults for missing fields) if mqRaw.Enabled != nil { e.config.Enabled = *mqRaw.Enabled } if mqRaw.TargetBranch != nil { e.config.TargetBranch = *mqRaw.TargetBranch } if mqRaw.IntegrationBranches != nil { e.config.IntegrationBranches = *mqRaw.IntegrationBranches } if mqRaw.OnConflict != nil { e.config.OnConflict = *mqRaw.OnConflict } if mqRaw.RunTests != nil { e.config.RunTests = *mqRaw.RunTests } if mqRaw.TestCommand != nil { e.config.TestCommand = *mqRaw.TestCommand } if mqRaw.DeleteMergedBranches != nil { e.config.DeleteMergedBranches = *mqRaw.DeleteMergedBranches } if mqRaw.RetryFlakyTests != nil { e.config.RetryFlakyTests = *mqRaw.RetryFlakyTests } if mqRaw.MaxConcurrent != nil { e.config.MaxConcurrent = *mqRaw.MaxConcurrent } if mqRaw.PollInterval != nil { dur, err := time.ParseDuration(*mqRaw.PollInterval) if err != nil { return fmt.Errorf("invalid poll_interval %q: %w", *mqRaw.PollInterval, err) } e.config.PollInterval = dur } return nil } // Config returns the current merge queue configuration. func (e *Engineer) Config() *MergeQueueConfig { return e.config } // Run starts the Engineer main loop. It blocks until the context is cancelled // or Stop() is called. Returns nil on graceful shutdown. func (e *Engineer) Run(ctx context.Context) error { if err := e.LoadConfig(); err != nil { return fmt.Errorf("loading config: %w", err) } if !e.config.Enabled { return fmt.Errorf("merge queue is disabled in configuration") } fmt.Printf("[Engineer] Starting for rig %s (poll_interval=%s)\n", e.rig.Name, e.config.PollInterval) ticker := time.NewTicker(e.config.PollInterval) defer ticker.Stop() // Run one iteration immediately, then on ticker if err := e.processOnce(ctx); err != nil { fmt.Printf("[Engineer] Error: %v\n", err) } for { select { case <-ctx.Done(): fmt.Println("[Engineer] Shutting down (context cancelled)") return nil case <-e.stopCh: fmt.Println("[Engineer] Shutting down (stop signal)") return nil case <-ticker.C: if err := e.processOnce(ctx); err != nil { fmt.Printf("[Engineer] Error: %v\n", err) } } } } // Stop signals the Engineer to stop processing. This is a non-blocking call. func (e *Engineer) Stop() { close(e.stopCh) } // processOnce performs one iteration of the Engineer loop: // 1. Query for ready merge-requests // 2. If none, return (will try again on next tick) // 3. Process the highest priority, oldest MR func (e *Engineer) processOnce(ctx context.Context) error { // Check context before starting select { case <-ctx.Done(): return nil default: } // 1. Query: bd ready --type=merge-request (filtered client-side) readyMRs, err := e.beads.ReadyWithType("merge-request") if err != nil { return fmt.Errorf("querying ready merge-requests: %w", err) } // 2. If empty, return if len(readyMRs) == 0 { return nil } // 3. Select highest priority, oldest MR // bd ready already returns sorted by priority then age, so first is best mr := readyMRs[0] fmt.Printf("[Engineer] Processing: %s (%s)\n", mr.ID, mr.Title) // 4. Claim: bd update --status=in_progress inProgress := "in_progress" if err := e.beads.Update(mr.ID, beads.UpdateOptions{Status: &inProgress}); err != nil { return fmt.Errorf("claiming MR %s: %w", mr.ID, err) } // 5. Process (delegate to ProcessMR - implementation in separate issue gt-3x1.2) result := e.ProcessMR(ctx, mr) // 6. Handle result if result.Success { e.handleSuccess(mr, result) } else { // Failure handling (detailed implementation in gt-3x1.4) e.handleFailure(mr, result) } return nil } // ProcessResult contains the result of processing a merge request. type ProcessResult struct { Success bool MergeCommit string Error string Conflict bool TestsFailed bool } // ProcessMR processes a single merge request. // This is a placeholder that will be fully implemented in gt-3x1.2. func (e *Engineer) ProcessMR(ctx context.Context, mr *beads.Issue) ProcessResult { // Parse MR fields from description mrFields := beads.ParseMRFields(mr) if mrFields == nil { return ProcessResult{ Success: false, Error: "no MR fields found in description", } } // For now, just log what we would do // Full implementation in gt-3x1.2: Fetch and conflict check fmt.Printf("[Engineer] Would process:\n") fmt.Printf(" Branch: %s\n", mrFields.Branch) fmt.Printf(" Target: %s\n", mrFields.Target) fmt.Printf(" Worker: %s\n", mrFields.Worker) // Return failure for now - actual implementation in gt-3x1.2 return ProcessResult{ Success: false, Error: "ProcessMR not fully implemented (see gt-3x1.2)", } } // handleSuccess handles a successful merge completion. // Steps: // 1. Update MR with merge_commit SHA // 2. Close MR with reason 'merged' // 3. Close source issue with reference to MR // 4. Delete source branch if configured // 5. Log success func (e *Engineer) handleSuccess(mr *beads.Issue, result ProcessResult) { // Parse MR fields from description mrFields := beads.ParseMRFields(mr) if mrFields == nil { mrFields = &beads.MRFields{} } // 1. Update MR with merge_commit SHA mrFields.MergeCommit = result.MergeCommit mrFields.CloseReason = "merged" newDesc := beads.SetMRFields(mr, mrFields) if err := e.beads.Update(mr.ID, beads.UpdateOptions{Description: &newDesc}); err != nil { fmt.Printf("[Engineer] Warning: failed to update MR %s with merge commit: %v\n", mr.ID, err) } // 2. Close MR with reason 'merged' if err := e.beads.CloseWithReason("merged", mr.ID); err != nil { fmt.Printf("[Engineer] Warning: failed to close MR %s: %v\n", mr.ID, err) } // 3. Close source issue with reference to MR if mrFields.SourceIssue != "" { closeReason := fmt.Sprintf("Merged in %s", mr.ID) if err := e.beads.CloseWithReason(closeReason, mrFields.SourceIssue); err != nil { fmt.Printf("[Engineer] Warning: failed to close source issue %s: %v\n", mrFields.SourceIssue, err) } else { fmt.Printf("[Engineer] Closed source issue: %s\n", mrFields.SourceIssue) } } // 4. Delete source branch if configured if e.config.DeleteMergedBranches && mrFields.Branch != "" { if err := e.git.DeleteRemoteBranch("origin", mrFields.Branch); err != nil { fmt.Printf("[Engineer] Warning: failed to delete branch %s: %v\n", mrFields.Branch, err) } else { fmt.Printf("[Engineer] Deleted branch: %s\n", mrFields.Branch) } } // 5. Log success fmt.Printf("[Engineer] ✓ Merged: %s (commit: %s)\n", mr.ID, result.MergeCommit) } // handleFailure handles a failed merge request. // This is a placeholder that will be fully implemented in gt-3x1.4. func (e *Engineer) handleFailure(mr *beads.Issue, result ProcessResult) { // Reopen the MR (back to open status for rework) open := "open" if err := e.beads.Update(mr.ID, beads.UpdateOptions{Status: &open}); err != nil { fmt.Printf("[Engineer] Warning: failed to reopen MR %s: %v\n", mr.ID, err) } // Log the failure fmt.Printf("[Engineer] ✗ Failed: %s - %s\n", mr.ID, result.Error) // Full failure handling (assign back to worker, labels) in gt-3x1.4 }