search

Documentation

Index

• func CheckFZFInstalled() error
• func CompileCELFilter(expr string) (cel.Program, error)
• func EvaluateFilter(prg cel.Program, vars map[string]any) (bool, error)
• func GetCurrentUser() (string, error)
• func NewCELEnv() (*cel.Env, error)
• type Action
  • func RunActionMenu(item *Item) (Action, error)
• type Filters
• type Item
  • func DiscoverItems(prg cel.Program, username string, repo string) ([]Item, error)
  • func DiscoverLocalFiles(filters Filters) ([]Item, error)
  • func RunSelector(items []Item, query string, sortBy SortField) (*Item, error)
• type SortField

Functions

func CheckFZFInstalled

func CheckFZFInstalled() error

CheckFZFInstalled verifies that fzf is available in PATH.

func CompileCELFilter

func CompileCELFilter(expr string) (cel.Program, error)

CompileCELFilter compiles a CEL filter expression into a program.

func EvaluateFilter

func EvaluateFilter(prg cel.Program, vars map[string]any) (bool, error)

EvaluateFilter evaluates a compiled CEL program against a variable map.

func GetCurrentUser

func GetCurrentUser() (string, error)

GetCurrentUser returns the current GitHub username using gh CLI.

func NewCELEnv

func NewCELEnv() (*cel.Env, error)

NewCELEnv creates the CEL environment with search-specific variables.

Types

type Action

type Action string

Action represents an action to perform on a selected item.

const (
	ActionOpenEditor  Action = "editor"
	ActionPush        Action = "push"
	ActionViewBrowser Action = "browser"
	ActionCopyPath    Action = "copy"
	ActionPullFresh   Action = "pull"
	ActionCancel      Action = "cancel"
)

func RunActionMenu

func RunActionMenu(item *Item) (Action, error)

RunActionMenu shows a menu of actions for the selected item.

type Filters

type Filters struct {
	Repo        string // "owner/repo" format, empty = all repos
	Issues      bool
	PRs         bool
	Discussions bool
}

Filters specifies which items to include in search results.

type Item

type Item struct {
	FilePath string
	Owner    string
	Repo     string
	Number   int
	Type     string // "issue", "pr", "discussion"
	State    string // "open", "closed", "merged"
	Title    string
	URL      string
	Created  time.Time
	Updated  time.Time
}

Item represents a searchable item from local files.

func DiscoverItems

func DiscoverItems(prg cel.Program, username string, repo string) ([]Item, error)

DiscoverItems discovers all items matching the CEL filter. If repo is empty, searches all repos. If repo is "owner/repo", only searches that repo.

func DiscoverLocalFiles

func DiscoverLocalFiles(filters Filters) ([]Item, error)

DiscoverLocalFiles walks the gh-md root directory and returns all matching items.

func RunSelector

func RunSelector(items []Item, query string, sortBy SortField) (*Item, error)

RunSelector opens fzf with the given items and returns the selected item. Returns nil if the user cancels (Esc).

type SortField

type SortField string

SortField specifies how to sort items.

const (
	SortUpdated SortField = "updated" // Latest updated first
	SortCreated SortField = "created" // Latest created first
	SortNumber  SortField = "number"  // Highest number first
)