llm

type AgentRunner interface {
	// Compare sends prompt to the underlying LLM CLI and returns a structured
	// Verdict with the semantic relation between two observations.
	// On error the returned Verdict is zero-value.
	Compare(ctx context.Context, prompt string) (Verdict, error)
}

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

type ObservationSnippet struct {
	// ID is the sync_id of the observation (e.g. "obs-a1b2c3d4...").
	ID string
	// Title is the observation title.
	Title string
	// Content is the observation body text.
	Content string
	// Type is the observation type label (e.g. "decision", "architecture").
	Type string
	// Project is the project the observation belongs to.
	Project string
}

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

type Verdict struct {
	// Relation is the semantic relation verb returned by the LLM.
	// Must be one of: conflicts_with | supersedes | scoped | related | compatible | not_conflict
	Relation string

	// Confidence is the LLM's self-reported confidence score in [0.0, 1.0].
	Confidence float64

	// Reasoning is the LLM's short explanation (≤200 chars).
	Reasoning string

	// Model is the model identifier captured from the CLI output
	// (e.g., "claude-haiku-4-5"). May be empty if the CLI does not report it.
	Model string

	// DurationMS is the wall-clock duration of the CLI call in milliseconds.
	DurationMS int64
}