tree

type Container struct {
	Runner shell.Runner

	Lost *Lost
	// contains filtered or unexported fields
}

type Entry struct {
	Name  string
	IsDir bool
	Size  int64
}

type Host struct{ Dir string }

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

type Match struct {
	Path string
	Line int
	Text string
}

type SearchOpts struct {
	Re        *regexp.Regexp // nil for a filename-only search
	Glob      string         // "" matches every file
	Mode      string
	HeadLimit int
	// pattern and caseInsensitive are the model's own arguments, kept because a container tree cannot hand a compiled *regexp.Regexp to grep — it renders the pattern to POSIX ERE instead, and folding is a grep flag rather than part of the expression.
	Pattern         string
	CaseInsensitive bool
}

type SearchResult struct {
	Files        []string
	Matches      []Match
	Counts       []map[string]any
	Total        int
	FilesScanned int
	BudgetHit    bool
	// contains filtered or unexported fields
}

type Stat struct {
	Size  int64
	IsDir bool
}

type Tree interface {
	// Root is the directory paths resolve against, in this tree's own spelling. For a container on a worker that is the worker's path, which is also what the model is told its working directory is.
	Root() string
	// Resolve confines rel to root and answers the absolute path in this tree's spelling.
	Resolve(ctx context.Context, rel string) (string, error)
	// ResolveWrite is resolve for a path that need not exist yet: the closest existing ancestor is what gets checked against root, since a missing leaf has no link to follow. Missing parents are created by whichever caller goes on to write.
	ResolveWrite(ctx context.Context, rel string) (string, error)
	// Stat answers os.ErrNotExist for a missing path, like os.Stat.
	Stat(ctx context.Context, path string) (Stat, error)
	// ReadBytes is the first limit bytes of a file.
	ReadBytes(ctx context.Context, path string, limit int64) ([]byte, error)
	// OpenRange is a reader over the file's first through lines, or over the whole file when through is zero. Both implementations start at line one, so the caller's scanner counts the same lines either way.
	OpenRange(ctx context.Context, path string, through int) (io.ReadCloser, error)
	// WriteFile replaces path's contents, keeping the file's mode when it already exists.
	WriteFile(ctx context.Context, path string, data []byte, appendTo bool) error
	// ListDir is one directory's entries, unsorted, as the tool reports them.
	ListDir(ctx context.Context, path string) ([]Entry, error)
	// Search walks base under opts and returns what the model is shown.
	Search(ctx context.Context, base string, opts SearchOpts) (SearchResult, error)
}