index

type Config struct {
	Index struct {
		// Generated indexes files carrying a "Code generated … DO NOT
		// EDIT." header. Default false: such files (protoc, stringer,
		// mockgen output) are boilerplate that inflates the graph and
		// pollutes most-called, and are not meant to be hand-navigated.
		Generated bool `yaml:"generated"`
		// Exclude is a list of gitignore-ish globs skipped on top of
		// .gitignore and the built-in skip dirs. Forms: a bare glob
		// (`*.pb.go`, `*_test.go`) matches any basename; a `**/`-prefixed
		// glob matches the basename in any directory; a trailing-slash
		// entry (`internal/gen/`) matches a directory prefix.
		Exclude []string `yaml:"exclude"`
	} `yaml:"index"`

	Reviews struct {
		// WindowDays bounds how old a mined review comment may be:
		// absent means the 730-day default, 0 means unlimited. The
		// newest 200 comments always survive the window, so a slow
		// repository keeps a working corpus with no tuning.
		WindowDays *int `yaml:"window_days"`
	} `yaml:"reviews"`
}

type Options struct {
	// Root is the workspace directory. When inside a git repository it is
	// widened to the repository toplevel so paths are repo-relative.
	Root string
	// DBPath overrides the index location (default: <root>/.seamark/index.db).
	DBPath string
	// History tunes the git mining pass.
	History history.Options
	// Force rebuilds even when the workspace fingerprint says the index
	// is already current.
	Force bool
	// Logf receives progress and warnings; nil discards them.
	Logf func(format string, args ...any)
	// Progress receives phase events for interactive surfaces: a phase
	// name with units done/total (0 total = indeterminate, reported
	// again as 1/1 when the phase ends). Nil discards — piped and agent
	// surfaces stay on Logf's plain lines.
	Progress func(phase string, done, total int)
}

type Summary struct {
	Root   string
	DBPath string
	// Skipped is true when the workspace fingerprint matched the index
	// and nothing was rebuilt.
	Skipped     bool
	FilesSeen   int // files listed in the workspace
	FilesParsed int // files a language extractor handled
	// FilesReparsed counts files actually run through tree-sitter this
	// pass; the rest were served from the parse cache. Equals FilesParsed
	// on a --force or first index.
	FilesReparsed int
	// FilesSkipped counts supported files dropped by config — generated
	// (default) or an exclude glob.
	FilesSkipped int
	ParseErrors  int
	HistoryMined bool
	// HistorySkipNote says why the history layer is absent when
	// HistoryMined is false: "not a git repository" and "mining failed"
	// are different situations and must not be conflated in output.
	HistorySkipNote string
	Stats           store.Stats
	Duration        time.Duration
}