cherrypick

type Change struct {
	Entity string `json:"entity"`
	ID     string `json:"id"`
	Change string `json:"change"`
}

type Conflict struct {
	ConflictID string   `json:"conflictId"`
	Category   string   `json:"category"`
	Entity     string   `json:"entity"`
	ID         string   `json:"id,omitempty"`
	Field      string   `json:"field,omitempty"`
	Paths      []string `json:"paths"`
}

type Request struct {
	// Commit identifies the source commit hash whose delta will be transplanted.
	Commit string `json:"commit"`
	// TargetBranch identifies the branch onto which the commit delta will be applied.
	TargetBranch string `json:"targetBranch"`
	// DryRun reports whether to simulate cherry-picking without writing commits or advancing branch refs.
	DryRun bool `json:"dryRun,omitempty"`
	// Author optionally overrides the commit author for non-dry-run executions.
	Author string `json:"author,omitempty"`
	// Message optionally overrides the commit message for non-dry-run executions.
	Message string `json:"message,omitempty"`
}

type Result struct {
	// TargetBranch identifies the branch targeted by the cherry-pick.
	TargetBranch string `json:"targetBranch"`
	// SourceCommit identifies the source commit that was transplanted.
	SourceCommit string `json:"sourceCommit"`
	// Commit identifies the newly created commit, or the unchanged target head when dry-run or no-op.
	Commit string `json:"commit,omitempty"`
	// DryRun indicates whether this result was produced by a preview simulation.
	DryRun bool `json:"dryRun,omitempty"`
	// Changes contains the entities added, modified, or removed relative to the target branch head.
	Changes []Change `json:"changes"`
	// Conflicts lists any structural or property collisions detected against the target branch.
	Conflicts []Conflict `json:"conflicts,omitempty"`
	// Violations lists any schema rule violations detected on the candidate target snapshot.
	Violations []SchemaViolation `json:"violations,omitempty"`
}

type SchemaViolation struct {
	Code     string `json:"code"`
	Entity   string `json:"entity"`
	EntityID string `json:"entityID"`
	Rule     string `json:"rule,omitempty"`
	Field    string `json:"field,omitempty"`
	Expected string `json:"expected,omitempty"`
	Actual   string `json:"actual,omitempty"`
}

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

type Store interface {
	// CherryPick performs commit diff delta computation, 3-way property merging,
	// referential preflight verification, and atomic commit generation.
	CherryPick(request Request) (Result, error)
}