prune

type Request struct {
	// Branch identifies the branch whose ephemeral entities will be pruned.
	Branch string `json:"branch"`
	// DryRun reports whether to simulate pruning without writing commits or advancing branch refs.
	DryRun bool `json:"dryRun,omitempty"`
	// Force permits pruning on protected default branches.
	Force bool `json:"force,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 {
	// Branch identifies the pruned branch.
	Branch string `json:"branch"`
	// Commit identifies the newly created pruning commit, or the unchanged head commit when dry-run/no-op.
	Commit string `json:"commit,omitempty"`
	// DryRun indicates whether this result was produced by a preview simulation.
	DryRun bool `json:"dryRun,omitempty"`
	// PrunedNodesCount is the number of ephemeral nodes removed.
	PrunedNodesCount int `json:"prunedNodesCount"`
	// PrunedEdgesCount is the number of cascading incident edges removed.
	PrunedEdgesCount int `json:"prunedEdgesCount"`
	// PrunedNodeIDs lists the identifiers of all ephemeral nodes excised.
	PrunedNodeIDs []string `json:"prunedNodeIds"`
	// OrphanedDurableNodes lists the identifiers of durable nodes that lost all connected edges.
	OrphanedDurableNodes []string `json:"orphanedDurableNodes"`
}

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

type Store interface {
	// Prune performs ephemeral entity discovery, cascading edge excision, orphan detection, and commit generation.
	Prune(request Request) (Result, error)
}