checkpoint

type CommitOptions struct {
	// Message is the proposed commit message body. Validated
	// against Conventional Commits unless RequireConventional
	// is false.
	Message string
	// Cwd is the repo root. Defaults to current directory.
	Cwd string
	// Files lists paths to stage before committing. When empty,
	// the existing index is used (operator stages manually or
	// via AutoStageAll=true).
	Files []string
	// AutoStageAll runs `git add -A` before commit. Default
	// false to avoid accidentally committing the world.
	AutoStageAll bool
	// AllowEmpty maps onto `git commit --allow-empty`. Default
	// false — empty commits are usually a bug.
	AllowEmpty bool
	// AllowDirty bypasses the working-tree dirtiness guard.
	// Default false — dirty trees during a commit usually mean
	// "you forgot to stage something or autocommit raced you".
	AllowDirty bool
	// RequireConventional enforces the Conventional Commits
	// shape. Default true (operator's policy); flip to false
	// for prototype repos that don't bother.
	RequireConventional bool
	// ForbidCoauthor hard-blocks any `Co-Authored-By` trailer.
	// Default true (operator memory feedback — never attribute
	// to AI). The flag exists so other operators using
	// clawtool can opt out; Bahadır's profile keeps it on.
	ForbidCoauthor bool
	// Push runs `git push` after the commit. Default false —
	// auto-push is loud and should be opt-in per call.
	Push bool
	// Sign maps onto `git commit -S`. When true, fails fast
	// if `git config commit.gpgsign` isn't already configured —
	// no silent fall-through to unsigned commits.
	Sign bool
}

type CommitResult struct {
	Sha         string    `json:"sha"`
	ShortSha    string    `json:"short_sha"`
	Branch      string    `json:"branch,omitempty"`
	Subject     string    `json:"subject"`
	Files       []string  `json:"files,omitempty"`
	Pushed      bool      `json:"pushed"`
	CommittedAt time.Time `json:"committed_at"`
}