steer

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

type ExtSet map[string]struct{}

type GlobClass struct {
	Kind GlobKind
	// Name is the literal last segment (GlobLiteral only).
	Name string
	// Stem is Name without its extension when the glob has a single literal
	// expansion; empty otherwise.
	Stem string
	// Hint is the longest identifier-like literal fragment of a wildcard
	// file name (GlobExplore only), e.g. "Service" for "*Service*.java".
	Hint string
}

type GlobKind int

type Index interface {
	query.Backend
	Freshen(ctx context.Context, budget time.Duration) (*index.Result, error)
}

type Options struct {
	// Open opens the index of a located repository. The default is
	// index.Open with the real resolver. Indexes implementing io.Closer are
	// closed by Engine.Close.
	Open func(ctx context.Context, loc *index.Location, cfg *config.Config) (Index, error)
	// StartBuild is the hook point for building a missing index in the
	// background (e.g. spawning a detached `graphmaster index --quiet`).
	// Decisions never build an index themselves. Nil does nothing.
	StartBuild func(root string)
	// LookupBudget bounds the graph lookup (default 25ms).
	LookupBudget time.Duration
	// Now is the session clock (default time.Now).
	Now func() time.Time
	// Logf receives internal errors; steering always fails open.
	Logf func(format string, args ...any)
}

type PatternClass struct {
	// SymbolLike is true when the pattern looks like a lookup of a code
	// symbol (identifier, qualified name, call, keyword-prefixed definition).
	SymbolLike bool
	// Idents are the unique identifier tokens in first-seen order, without
	// definition keywords or a leading '$'. Filled best-effort for
	// non-symbol patterns too.
	Idents []string
	// Queries are the symbol expressions worth looking up, one per
	// alternative / ".*" fragment, e.g. "pkg.Func" or "Foo::bar".
	Queries []string
	// Norm (pnorm) is the sorted unique Idents joined by a space, case kept.
	// Equal norms mean "the same search" for retry detection.
	Norm string
	// Reason explains a non-symbol verdict; empty when SymbolLike.
	Reason string
}

type SearchCall struct {
	// Tool is the canonical tool name: grep, egrep, fgrep, rg, ag, ack,
	// "git grep", find, fd, ls, tree or locate.
	Tool string
	// Patterns are the literal search patterns (content regexes, or file-name
	// patterns for NameSearch tools). Dynamic ($VAR) patterns are omitted.
	Patterns []string
	// Paths are the explicit or implied (".") targets. Nil when the input is
	// stdin or an unknown file list (xargs, find -exec).
	Paths []string
	// Globs are file filters: --include, -g, -t TYPE, -name, -e EXT, ...
	Globs []string
	// Recursive is true for tree-wide searches (not a single file / stdin).
	Recursive bool
	// ReadsStdin is true when the tool searches its standard input.
	ReadsStdin bool
	// Fixed is true for fixed-string matching (-F, -Q, fgrep).
	Fixed bool
	// NameSearch is true when file names, not contents, are searched.
	NameSearch bool
}

type ShellAnalysis struct {
	Searches []SearchCall
	// AllReadOnly is true when every command is a known side-effect-free
	// command (search tools, cat, head, sort, sed -n, ...) and no output is
	// redirected to a file.
	AllReadOnly bool
	// UnknownDir is true when a cd/pushd/popd or "git -C" moved a command to
	// a directory that cannot be resolved statically (no argument, ~, -,
	// $VAR). Search scopes are then unknown, so the line is never steered.
	UnknownDir bool
}

type TargetKind int