engine

type Options struct {
	Repo      string            // repository the role works on
	RolesDir  string            // folder holding the roles
	Role      string            // role name
	Event     string            // event the role runs on
	AI        string            // agent spec, see agent.Parse; empty = the project's setting
	DefaultAI string            // used when neither AI nor the project says (the user's own default)
	Inputs    map[string]string // name -> value, written to in/input/<name>
	Targets   map[string]string // name -> file an intention writes back to (e.g. the hook's message file)

	Forge  string        // forge spec, see forge.Open; empty = the project's `forge` setting
	Target *forge.Target // the issue or merge request comments and labels go on
	Scope  []string      // paths the task is about; a patch outside is refused
	// NoApply stops after judging: the proposals and what apply needs are kept
	// in the run folder, for `workline apply` in another job holding the token.
	NoApply bool
	// OpenMergeRequest puts what the patches wrote on a branch of the role's,
	// and opens a merge request for it, or updates the one open (ADR-0006).
	OpenMergeRequest bool
	// PushToMergeRequest commits what the patches wrote to the branch of the
	// merge request the run targets; from a fork, the diff goes in a comment.
	PushToMergeRequest bool

	// TamperBeforeApply changes the prepared input between propose and apply.
	// It exists only for the conformance test that proves apply notices.
	TamperBeforeApply bool
}

type Result struct {
	Status       string            `json:"status"`
	Summary      string            `json:"summary,omitempty"`
	Findings     []verdict.Finding `json:"findings,omitempty"`
	AgentCalls   int               `json:"agent-calls"`
	Calls        []agent.Call      `json:"calls,omitempty"` // each call: what was asked, what answered
	Applied      []string          `json:"applied"`
	Refused      []string          `json:"refused"`
	Handoffs     []any             `json:"handoffs,omitempty"` // next roles asked for; routing runs them
	Notes        []string          `json:"notes,omitempty"`    // what the agent left for a person: a round's notes each
	RunDir       string            `json:"run-dir"`
	ToApply      bool              `json:"to-apply,omitempty"`      // judged with NoApply: `workline apply` still has work
	MergeRequest int               `json:"merge-request,omitempty"` // the merge request the patches went to
	// contains filtered or unexported fields
}