benchutil

type BenchRepo struct {
	// Dir is the absolute path to the repository root.
	Dir string

	// Repo is the go-git repository handle.
	Repo *git.Repository

	// Store is the checkpoint GitStore for this repo.
	Store *checkpoint.GitStore

	// HeadHash is the current HEAD commit hash string.
	HeadHash string

	// WorktreeID is the worktree identifier (empty for main worktree).
	WorktreeID string

	// Strategy is the strategy name used in .entire/settings.json.
	Strategy string
}

type RepoOpts struct {
	// FileCount is the number of tracked files to create in the initial commit.
	// Each file is ~100 lines of Go code. Defaults to 10.
	FileCount int

	// FileSizeLines is the number of lines per file. Defaults to 100.
	FileSizeLines int

	// CommitCount is the number of commits to create. Defaults to 1.
	CommitCount int

	// Strategy is the strategy name for .entire/settings.json.
	// Defaults to "manual-commit".
	Strategy string

	// FeatureBranch, if non-empty, creates and checks out this branch
	// after the initial commits.
	FeatureBranch string
}

type SessionOpts struct {
	// SessionID is the session identifier. Auto-generated if empty.
	SessionID string

	// Phase is the session phase. Defaults to session.PhaseActive.
	Phase session.Phase

	// StepCount is the number of prior checkpoints. Defaults to 0.
	StepCount int

	// FilesTouched is the list of files tracked by this session.
	FilesTouched []string

	// TranscriptPath is the path to the live transcript file.
	TranscriptPath string

	// AgentType is the agent type. Defaults to agent.AgentTypeClaudeCode.
	AgentType types.AgentType
}

type TranscriptOpts struct {
	// MessageCount is the number of JSONL messages to generate.
	MessageCount int

	// AvgMessageBytes is the approximate size of each message's content field.
	// Defaults to 500.
	AvgMessageBytes int

	// IncludeToolUse adds realistic tool_use messages (file edits, bash commands).
	IncludeToolUse bool

	// FilesTouched is the list of files to reference in tool_use messages.
	// Only used when IncludeToolUse is true.
	FilesTouched []string
}