fsutil

type FileInfo struct {
	Path string // absolute file path
	Size int64  // size in bytes
}

type WalkOptions struct {
	RootDir            string   // root path to start scanning from
	ExcludedPaths      []string // relative paths to exclude (subdirs or globs)
	AllowedExtensions  []string // file extensions to include (e.g. .go)
	MaxFileSizeBytes   int64    // maximum allowed file size in bytes
	FollowSymlinks     bool     // whether to follow symbolic links
	IncludeHiddenFiles bool     // whether to include dotfiles
}