pipeline

type Definition struct {
	Name         string
	Description  string
	Instructions string // Single-task kind's prompt preset (used when Steps is empty). Mirrors db.TaskType.Instructions.
	Steps        []Step
	Custom       bool // true for kinds loaded from YAML files (vs the built-ins)
}

type Group struct {
	Branch  string
	Members []*db.Task // in step (creation) order
}

type Options struct {
	Goal           string // The overall goal, threaded into every step's prompt.
	Project        string // Project the step tasks belong to (must already exist).
	Definition     string // Definition name; "" resolves to DefaultDefinition.
	PermissionMode string // Permission mode for every step ("" inherits project default).
	Execute        bool   // If true, queue the root step so the workflow starts now.
}

type ResolveFunc func(name string) (Definition, bool)

type Result struct {
	Definition Definition
	Branch     string     // The shared branch every step runs on.
	Tasks      []*db.Task // Step tasks, in definition order.
}

type Step struct {
	Name        string            // Unique label, e.g. "Plan", "Code", "Review A", "Collect".
	Kind        string            // Optional: another kind this step runs. Sets the task's Type (so that kind's instructions apply); if that kind has steps, it's a sub-workflow inlined at build (see flatten.go).
	Executor    string            // Executor slug (db.ExecutorClaude, db.ExecutorCodex, ...).
	Model       string            // Per-task model override ("" = the executor's default).
	ConfigDir   string            // Per-task CLAUDE_CONFIG_DIR override ("" = use the project's/default config dir). Routes this step's Claude through a different config (e.g. ollama) without changing the project.
	Env         map[string]string // Per-task env overrides injected as a process-env prefix on the claude command (e.g. ANTHROPIC_BASE_URL/AUTH_TOKEN to route through ollama). nil = no overrides. Kept distinct from ConfigDir: env injection keeps the default config dir (plugins, MCP, trusted worktrees) intact and process env wins over stored creds — the mechanism that actually reaches ollama.
	Instruction string            // Full body template (built-in / verbatim steps). Takes precedence over Prompt.
	Prompt      string            // Custom-workflow body: what the step does; the git handoff is composed from the DAG (see compose.go).
	Deps        []string          // Names of steps that must complete before this one runs.
	Gate        bool              // Human-in-the-loop: when this step finishes it parks 'blocked' for human review instead of advancing the DAG; a human releases it (and its dependents) with `ty close`. Persisted on the task as a "gate" tag token (see the Tags field in Create).
	Verify      string            // Opt-in evidence gate: a shell command run in the step's worktree when the agent calls taskyou_complete. Non-zero exit REJECTS the completion (the step stays running and the command output is handed back so the agent fixes it) instead of trusting the agent's say-so. "" = no gate (today's behavior). Persisted in the task-keyed pipeline_step_verify table (a command string can't ride a tag token like Gate does).
}