tracker

type Ref struct {
	Host string `json:"host"`
	Key  string `json:"key"`
}

type Text struct {
	Title string
	Body  string
	URL   string
}

type Tracker interface {
	// Get reads the ticket: its structured facts, and its text for the agent.
	Get(ctx context.Context, key string) (facts.Ticket, Text, error)
	// Comment posts body unless a comment containing marker exists: side effects are
	// idempotent per step (ADR-005).
	Comment(ctx context.Context, key, marker, body string) error
	// Label adds and removes labels; adding one present or removing one absent is not an error.
	Label(ctx context.Context, key string, add, remove []string) error
}