adapter

type AIAdapter interface {
	// Complete sends a prompt and returns the completion.
	Complete(ctx context.Context, prompt string, system string) (string, error)
	// Embed returns a vector embedding for the given text.
	// Returns nil, ErrEmbeddingsNotSupported if the provider doesn't support embeddings.
	Embed(ctx context.Context, text string) ([]float32, error)
}

type AgentAdapter interface {
	// Invoke spawns the agent as a subprocess. The MCP server is already running.
	// contextFile is the fallback consolidated markdown for non-MCP agents.
	// Invoke blocks until the agent exits.
	Invoke(ctx context.Context, contextFile string, workDir string) error
	// SupportsMCP returns true if the agent natively connects to MCP servers.
	SupportsMCP() bool
}

type CommsAdapter interface {
	// Notify sends a structured message to the configured channel.
	Notify(ctx context.Context, msg Notification) error
	// PostStandup posts a formatted standup to the standup channel.
	PostStandup(ctx context.Context, standup StandupReport) error
	// FetchMentions returns recent mentions of spec IDs in configured channels.
	FetchMentions(ctx context.Context, since time.Time) ([]Mention, error)
}

type DeployAdapter interface {
	// Trigger initiates a deployment for the given repos to the target environment.
	Trigger(ctx context.Context, repos []string, env string) (*DeployRun, error)
	// Status polls the deployment run for current state.
	Status(ctx context.Context, run *DeployRun) (*DeployStatus, error)
}

type DeployRun struct {
	ID     string
	Repo   string
	Env    string
	Status string
	URL    string
}

type DeployStatus struct {
	RunID   string
	Status  string // "pending", "running", "success", "failure"
	URL     string
	Message string
}

type DocsAdapter interface {
	// FetchSections retrieves the current content of the spec from the docs provider,
	// keyed by section slug.
	FetchSections(ctx context.Context, specID string) (map[string]string, error)
	// PushFull publishes the complete spec to the docs provider.
	PushFull(ctx context.Context, specID string, content string) error
	// PageURL returns the URL of the spec's page in the docs provider.
	PageURL(ctx context.Context, specID string) (string, error)
}

type IntakeAdapter interface {
	// FetchItems returns new intake items from the external source.
	FetchItems(ctx context.Context) ([]IntakeItem, error)
}

type IntakeItem struct {
	Title     string
	Source    string
	SourceRef string
	Priority  string
	Body      string
}

type Mention struct {
	SpecID    string
	Channel   string
	Author    string
	Preview   string
	Timestamp time.Time
}

type Notification struct {
	SpecID  string
	Title   string
	Message string
	Channel string
	Mention string // e.g., "@alice"
}

type PMAdapter interface {
	// CreateEpic creates a new epic/issue linked to a spec.
	CreateEpic(ctx context.Context, spec SpecMeta) (epicKey string, err error)
	// UpdateStatus syncs the spec's pipeline status to the PM tool.
	UpdateStatus(ctx context.Context, epicKey string, status string) error
	// FetchUpdates returns status changes from the PM tool since last sync.
	FetchUpdates(ctx context.Context, epicKey string) (*PMUpdate, error)
}

type PMUpdate struct {
	Status    string
	Assignee  string
	UpdatedAt time.Time
}

type PRDetail struct {
	PullRequest
	ReviewComments    int
	UnresolvedThreads int
}

type PullRequest struct {
	Number    int
	Title     string
	Repo      string
	Branch    string
	Author    string
	URL       string
	Status    string // "open", "merged", "closed"
	Approved  bool
	CIStatus  string // "passing", "failing", "pending"
	CreatedAt time.Time
}

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

type RepoAdapter interface {
	// ListPRs returns open PRs matching a spec's branch pattern across its repos.
	ListPRs(ctx context.Context, repos []string, specID string) ([]PullRequest, error)
	// PRStatus returns the review/CI status of a specific PR.
	PRStatus(ctx context.Context, repo string, prNumber int) (*PRDetail, error)
	// SetPRDescription updates a PR's description.
	SetPRDescription(ctx context.Context, repo string, prNumber int, body string) error
	// RequestedReviews returns PRs where the current user is a requested reviewer.
	RequestedReviews(ctx context.Context, user string) ([]PullRequest, error)
}

type SpecMeta struct {
	ID      string
	Title   string
	Status  string
	EpicKey string
	Repos   []string
}

type StandupReport struct {
	UserName  string
	Date      string
	Yesterday []string
	Today     []string
	Blockers  []string
}