dispatch

type Config struct {
	// Runner executes subprocesses (gh, git, open). Required.
	Runner *shell.Runner

	// Wrap applies the consumer's verb pipeline (argv validation, audit,
	// commit-scope resolution) to a verb.Spec the package builds. coily
	Wrap func(verb.Spec) cli.ActionFunc

	// AllowedOwner is the GitHub org dispatch will accept issue refs from.
	// This is the security claim, not a knob: dispatch refuses anything
	AllowedOwner string

	// ForgejoBaseURL enables Forgejo issue refs when set (scheme://host).
	// Requires FetchForgejoIssue.
	ForgejoBaseURL string

	// FetchForgejoIssue resolves a Forgejo issue. 404-shaped errors
	// (message contains "404") fall back to GitHub for shortform refs.
	FetchForgejoIssue func(ctx context.Context, owner, repo string, number int) (*Issue, error)

	// RepoPath resolves a repo name to its expected local checkout. The
	// consumer owns the workspace layout. Required.
	RepoPath func(repo string) (string, error)

	// WorktreeRoot is the parent directory under which each interactive
	// dispatch gets its own git worktree. Required.
	WorktreeRoot func() (string, error)

	// LogRoot is the parent directory for headless dispatch log files.
	// Required.
	LogRoot func() (string, error)

	// BinaryName is the host CLI's name, used only to format help text so
	// it reads correctly per consumer ("coily dispatch ..." vs
	BinaryName string

	// ClaudeConfigPath resolves the Claude Code config file holding
	// per-folder trust state. Optional; defaults to ~/.claude.json.
	ClaudeConfigPath func() (string, error)

	// Notify, when set, is called once per completed dispatch with a
	// summary Event. The consumer wires ntfy, a done banner, or any other
	Notify func(Event)

	// Seams below are pluggable so tests avoid spawning real processes or
	// shelling out to git. Production leaves them nil and New installs the
	SpawnDetached    func(repoPath, logPath, bin string, argv, env []string) (int, error)
	OpenLaunch       func(ctx context.Context, runner *shell.Runner, url string) error
	WorktreeAdd      func(ctx context.Context, runner *shell.Runner, repoPath, branch, worktreePath string) error
	WorktreeReapable func(ctx context.Context, runner *shell.Runner, repoPath, branch string) bool
	WorktreeRemove   func(ctx context.Context, runner *shell.Runner, repoPath, worktreePath, branch string) error
}

type Conflict struct {
	PID    int    `json:"pid"`
	Ref    string `json:"ref"`
	Claim  string `json:"claim"`
	Path   string `json:"path"`
	Reason string `json:"reason"`
}

type Dispatcher struct {
	// contains filtered or unexported fields
}

type Event struct {
	Mode  string // "headless" or "interactive"
	Ref   string // owner/repo#N
	Title string
	URL   string
	Cwd   string
	PID   int // headless only; 0 otherwise
}

type Issue struct {
	Number int    `json:"number"`
	Title  string `json:"title"`
	Body   string `json:"body"`
	State  string `json:"state"`
	URL    string `json:"html_url"`
}

type Platform string

type Posture string

type Registry struct {
	// contains filtered or unexported fields
}

type Sidequest struct {
	PID           int       `json:"pid"`
	Ref           string    `json:"ref"`
	URL           string    `json:"url,omitempty"`
	StartedAt     time.Time `json:"started_at"`
	ParentSession string    `json:"parent_session,omitempty"`
	PathsClaimed  []string  `json:"paths_claimed,omitempty"`
	LogPath       string    `json:"log_path"`
}