lore

type Agent struct {
	Model   string `json:"model,omitempty"   yaml:"model,omitempty"`
	Via     string `json:"via,omitempty"     yaml:"via,omitempty"`
	Session string `json:"session,omitempty" yaml:"session,omitempty"`
}

type Anchor struct {
	Path    string `json:"path"               yaml:"path"`
	Line    int    `json:"line"               yaml:"line"`
	EndLine int    `json:"end_line,omitempty" yaml:"end_line,omitempty"`
	Commit  string `json:"commit"             yaml:"commit"`
	Symbol  string `json:"symbol,omitempty"   yaml:"symbol,omitempty"`
}

type CLIGit struct {
	Dir string
}

type CheckResult struct {
	Change  string   `json:"change"`
	Reasons []string `json:"reasons,omitempty"`
}

type Entry struct {
	ID         string    `json:"id"                   yaml:"-"`
	Kind       Kind      `json:"kind"                 yaml:"kind"`
	Change     string    `json:"change"               yaml:"change"`
	Human      string    `json:"human"                yaml:"human"`
	Agent      *Agent    `json:"agent,omitempty"      yaml:"agent,omitempty"`
	At         time.Time `json:"at"                   yaml:"at"`
	Anchors    []Anchor  `json:"anchors,omitempty"    yaml:"anchors,omitempty"`
	Supersedes string    `json:"supersedes,omitempty" yaml:"supersedes,omitempty"`

	Chosen   string     `json:"chosen,omitempty"   yaml:"chosen,omitempty"`
	Rejected []Rejected `json:"rejected,omitempty" yaml:"rejected,omitempty"`

	Severity   string `json:"severity,omitempty"   yaml:"severity,omitempty"`
	Status     string `json:"status,omitempty"     yaml:"status,omitempty"`
	Resolution string `json:"resolution,omitempty" yaml:"resolution,omitempty"`
	Source     string `json:"source,omitempty"     yaml:"source,omitempty"`

	Outcome string `json:"outcome,omitempty" yaml:"outcome,omitempty"`
	Gate    string `json:"gate,omitempty"    yaml:"gate,omitempty"`
	Commit  string `json:"commit,omitempty"  yaml:"commit,omitempty"`
	Judged  string `json:"judged,omitempty"  yaml:"judged,omitempty"`

	Retired bool `json:"retired,omitempty" yaml:"retired,omitempty"`

	Body string `json:"body" yaml:"-"`
	// contains filtered or unexported fields
}

type Git interface {
	// BlameLine is the commit that last touched the line, in the working
	// tree or, with rev, in the file as that revision has it; ErrNoRecord
	// when the line is not committed yet, or the path is absent at rev.
	BlameLine(ctx context.Context, path string, line int, rev string) (string, error)
	// Trailers is the commit message's trailers, keys as written except
	// Change and Task, which are normalised so a lookup ignores case.
	Trailers(ctx context.Context, commit string) (map[string][]string, error)
	// UserEmail is `git config user.email`; ErrNoRecord when unset.
	UserEmail(ctx context.Context) (string, error)
	// Head is HEAD's abbreviated sha; ErrNoRecord before the first commit.
	Head(ctx context.Context) (string, error)
	// IsAncestor reports whether ancestor is reachable from commit; a sha
	// this clone does not have is false, not an error.
	IsAncestor(ctx context.Context, ancestor, commit string) (bool, error)
}

type Kind string

type Problem struct {
	File    string `json:"file"`
	Message string `json:"message"`
}

type Record struct {
	Change  string  `json:"change"`
	Intent  *Entry  `json:"intent,omitempty"`
	Verdict *Entry  `json:"verdict,omitempty"`
	Entries []Entry `json:"entries"` // decisions, findings and lessons on the line
}

type Rejected struct {
	Option string `json:"option" yaml:"option"`
	Reason string `json:"reason" yaml:"reason"`
}

type Store struct {
	Root string
	Git  Git
	// Now and Entropy default to the clock and ulid's monotonic source; a
	// test sets them for stable ids.
	Now     func() time.Time
	Entropy io.Reader
}

type ValidationError struct {
	Problems []string
}

type WhyResult struct {
	Path    string   `json:"path"`
	Line    int      `json:"line"`
	Rev     string   `json:"rev,omitempty"` // the revision the line was read at; the working tree when empty
	Commit  string   `json:"commit"`
	Via     string   `json:"via"`
	Records []Record `json:"records"`
}