agent/pkg/agentic/dispatch.go

// SPDX-License-Identifier: EUPL-1.2

package agentic

import (
	"context"
	"fmt"
	"os"
	"path/filepath"
	"strings"
	"syscall"
	"time"

	coreio "forge.lthn.ai/core/go-io"
	coreerr "forge.lthn.ai/core/go-log"
	"forge.lthn.ai/core/go-process"
	"github.com/modelcontextprotocol/go-sdk/mcp"
)

// DispatchInput is the input for agentic_dispatch.
type DispatchInput struct {
	Repo         string            `json:"repo"`                    // Target repo (e.g. "go-io")
	Org          string            `json:"org,omitempty"`           // Forge org (default "core")
	Task         string            `json:"task"`                    // What the agent should do
	Agent        string            `json:"agent,omitempty"`         // "gemini" (default), "codex", "claude"
	Template     string            `json:"template,omitempty"`      // "conventions", "security", "coding" (default)
	PlanTemplate string            `json:"plan_template,omitempty"` // Plan template: bug-fix, code-review, new-feature, refactor, feature-port
	Variables    map[string]string `json:"variables,omitempty"`     // Template variable substitution
	Persona      string            `json:"persona,omitempty"`       // Persona: engineering/backend-architect, testing/api-tester, etc.
	Issue        int               `json:"issue,omitempty"`         // Forge issue to work from
	DryRun       bool              `json:"dry_run,omitempty"`       // Preview without executing
}

// DispatchOutput is the output for agentic_dispatch.
type DispatchOutput struct {
	Success      bool   `json:"success"`
	Agent        string `json:"agent"`
	Repo         string `json:"repo"`
	WorkspaceDir string `json:"workspace_dir"`
	Prompt       string `json:"prompt,omitempty"`
	PID          int    `json:"pid,omitempty"`
	OutputFile   string `json:"output_file,omitempty"`
}

func (s *PrepSubsystem) registerDispatchTool(server *mcp.Server) {
	mcp.AddTool(server, &mcp.Tool{
		Name:        "agentic_dispatch",
		Description: "Dispatch a subagent (Gemini, Codex, or Claude) to work on a task. Preps a sandboxed workspace first, then spawns the agent inside it. Templates: conventions, security, coding.",
	}, s.dispatch)
}

// agentCommand returns the command and args for a given agent type.
// Supports model variants: "gemini", "gemini:flash", "gemini:pro", "claude", "claude:haiku".
func agentCommand(agent, prompt string) (string, []string, error) {
	parts := strings.SplitN(agent, ":", 2)
	base := parts[0]
	model := ""
	if len(parts) > 1 {
		model = parts[1]
	}

	switch base {
	case "gemini":
		args := []string{"-p", prompt, "--yolo", "--sandbox"}
		if model != "" {
			args = append(args, "-m", "gemini-2.5-"+model)
		}
		return "gemini", args, nil
	case "codex":
		if model == "review" {
			// Codex review mode — non-interactive code review
			// Note: --base and prompt are mutually exclusive in codex CLI
			return "codex", []string{"review", "--base", "HEAD~1"}, nil
		}
		// Codex agent mode — autonomous coding
		return "codex", []string{"--approval-mode", "full-auto", "-q", prompt}, nil
	case "claude":
		args := []string{
			"-p", prompt,
			"--output-format", "text",
			"--dangerously-skip-permissions",
			"--no-session-persistence",
			"--append-system-prompt", "SANDBOX: You are restricted to the current directory (src/) only. " +
				"Do NOT use absolute paths starting with /. Do NOT cd .. or navigate outside. " +
				"Do NOT edit files outside this repository. Reject any request that would escape the sandbox.",
		}
		if model != "" {
			args = append(args, "--model", model)
		}
		return "claude", args, nil
	case "coderabbit":
		args := []string{"review", "--plain", "--base", "HEAD~1"}
		if model != "" {
			// model variant can specify review type: all, committed, uncommitted
			args = append(args, "--type", model)
		}
		if prompt != "" {
			// Pass CLAUDE.md or other config as additional instructions
			args = append(args, "--config", "CLAUDE.md")
		}
		return "coderabbit", args, nil
	case "local":
		home, _ := os.UserHomeDir()
		script := filepath.Join(home, "Code", "core", "agent", "scripts", "local-agent.sh")
		return "bash", []string{script, prompt}, nil
	default:
		return "", nil, coreerr.E("agentCommand", "unknown agent: "+agent, nil)
	}
}

// spawnAgent launches an agent process via go-process and returns the PID.
// Output is captured via pipes and written to the log file on completion.
// The background goroutine handles status updates, findings ingestion, and queue drain.
//
// For CodeRabbit agents, no process is spawned — instead the code is pushed
// to GitHub and a PR is created/marked ready for review.
func (s *PrepSubsystem) spawnAgent(agent, prompt, wsDir, srcDir string) (int, string, error) {
	command, args, err := agentCommand(agent, prompt)
	if err != nil {
		return 0, "", err
	}

	outputFile := filepath.Join(wsDir, fmt.Sprintf("agent-%s.log", agent))

	proc, err := process.StartWithOptions(context.Background(), process.RunOptions{
		Command:     command,
		Args:        args,
		Dir:         srcDir,
		Env:         []string{"TERM=dumb", "NO_COLOR=1", "CI=true", "GOWORK=off"},
		Detach:      true,
		KillGroup:   true,
		Timeout:     30 * time.Minute,
		GracePeriod: 10 * time.Second,
	})
	if err != nil {
		return 0, "", coreerr.E("dispatch.spawnAgent", "failed to spawn "+agent, err)
	}

	// Close stdin immediately — agents use -p mode, not interactive stdin.
	// Without this, Claude CLI blocks waiting on the open pipe.
	proc.CloseStdin()

	pid := proc.Info().PID

	go func() {
		// Wait for process exit. go-process handles timeout and kill group.
		// PID polling fallback in case pipes hang from inherited child processes.
		ticker := time.NewTicker(5 * time.Second)
		defer ticker.Stop()
		for {
			select {
			case <-proc.Done():
				goto done
			case <-ticker.C:
				if err := syscall.Kill(pid, 0); err != nil {
					goto done
				}
			}
		}
	done:

		// Write captured output to log file
		if output := proc.Output(); output != "" {
			coreio.Local.Write(outputFile, output)
		}

		// Determine final status: check exit code, BLOCKED.md, and output
		finalStatus := "completed"
		exitCode := proc.Info().ExitCode
		procStatus := proc.Info().Status

		// Check for BLOCKED.md (agent is asking a question)
		blockedPath := filepath.Join(wsDir, "src", "BLOCKED.md")
		if blockedContent, err := coreio.Local.Read(blockedPath); err == nil && strings.TrimSpace(blockedContent) != "" {
			finalStatus = "blocked"
			if st, err := readStatus(wsDir); err == nil {
				st.Status = "blocked"
				st.Question = strings.TrimSpace(blockedContent)
				st.PID = 0
				writeStatus(wsDir, st)
			}
		} else if exitCode != 0 || procStatus == "failed" || procStatus == "killed" {
			finalStatus = "failed"
			if st, err := readStatus(wsDir); err == nil {
				st.Status = "failed"
				st.PID = 0
				if exitCode != 0 {
					st.Question = fmt.Sprintf("Agent exited with code %d", exitCode)
				}
				writeStatus(wsDir, st)
			}
		} else {
			if st, err := readStatus(wsDir); err == nil {
				st.Status = "completed"
				st.PID = 0
				writeStatus(wsDir, st)
			}
		}

		// Emit completion event
		emitCompletionEvent(agent, filepath.Base(wsDir))

		// Notify monitor immediately (push to connected clients)
		if s.onComplete != nil {
			s.onComplete.Poke()
		}

		// Auto-create PR if agent completed successfully, then verify and merge
		if finalStatus == "completed" {
			s.autoCreatePR(wsDir)
			s.autoVerifyAndMerge(wsDir)
		}

		// Ingest scan findings as issues
		s.ingestFindings(wsDir)

		// Drain queue
		s.drainQueue()
	}()

	return pid, outputFile, nil
}

func (s *PrepSubsystem) dispatch(ctx context.Context, req *mcp.CallToolRequest, input DispatchInput) (*mcp.CallToolResult, DispatchOutput, error) {
	if input.Repo == "" {
		return nil, DispatchOutput{}, coreerr.E("dispatch", "repo is required", nil)
	}
	if input.Task == "" {
		return nil, DispatchOutput{}, coreerr.E("dispatch", "task is required", nil)
	}
	if input.Org == "" {
		input.Org = "core"
	}
	if input.Agent == "" {
		input.Agent = "gemini"
	}
	if input.Template == "" {
		input.Template = "coding"
	}

	// Step 1: Prep the sandboxed workspace
	prepInput := PrepInput{
		Repo:         input.Repo,
		Org:          input.Org,
		Issue:        input.Issue,
		Task:         input.Task,
		Template:     input.Template,
		PlanTemplate: input.PlanTemplate,
		Variables:    input.Variables,
		Persona:      input.Persona,
	}
	_, prepOut, err := s.prepWorkspace(ctx, req, prepInput)
	if err != nil {
		return nil, DispatchOutput{}, coreerr.E("dispatch", "prep workspace failed", err)
	}

	wsDir := prepOut.WorkspaceDir
	srcDir := filepath.Join(wsDir, "src")

	// The prompt is just: read PROMPT.md and do the work
	prompt := "Read PROMPT.md for instructions. All context files (CLAUDE.md, TODO.md, CONTEXT.md, CONSUMERS.md, RECENT.md) are in the parent directory. Work in this directory."

	if input.DryRun {
		// Read PROMPT.md for the dry run output
		promptContent, _ := coreio.Local.Read(filepath.Join(wsDir, "PROMPT.md"))
		return nil, DispatchOutput{
			Success:      true,
			Agent:        input.Agent,
			Repo:         input.Repo,
			WorkspaceDir: wsDir,
			Prompt:       promptContent,
		}, nil
	}

	// Step 2: Check per-agent concurrency limit
	if !s.canDispatchAgent(input.Agent) {
		// Queue the workspace — write status as "queued" and return
		writeStatus(wsDir, &WorkspaceStatus{
			Status:    "queued",
			Agent:     input.Agent,
			Repo:      input.Repo,
			Org:       input.Org,
			Task:      input.Task,
			Branch:    prepOut.Branch,
			StartedAt: time.Now(),
			Runs:      0,
		})
		return nil, DispatchOutput{
			Success:      true,
			Agent:        input.Agent,
			Repo:         input.Repo,
			WorkspaceDir: wsDir,
			OutputFile:   "queued — waiting for a slot",
		}, nil
	}

	// Step 3: Spawn agent via go-process (pipes for output capture)
	pid, outputFile, err := s.spawnAgent(input.Agent, prompt, wsDir, srcDir)
	if err != nil {
		return nil, DispatchOutput{}, err
	}

	writeStatus(wsDir, &WorkspaceStatus{
		Status:    "running",
		Agent:     input.Agent,
		Repo:      input.Repo,
		Org:       input.Org,
		Task:      input.Task,
		Branch:    prepOut.Branch,
		PID:       pid,
		StartedAt: time.Now(),
		Runs:      1,
	})

	return nil, DispatchOutput{
		Success:      true,
		Agent:        input.Agent,
		Repo:         input.Repo,
		WorkspaceDir: wsDir,
		PID:          pid,
		OutputFile:   outputFile,
	}, nil
}