cache

Documentation

Overview

Package cache manages the local caching of repositories and skills.

Index

• Constants
• func GetReposCacheDir() string
• type Cache
  • func New(cacheDir string, ttl time.Duration) (*Cache, error)
  • func (c *Cache) Clear() error
  • func (c *Cache) Get(key string, v interface{}) bool
  • func (c *Cache) Set(key string, v interface{}) error
• type Entry
• type RepoInfo
• type ReposCache
  • func NewReposCache() (*ReposCache, error)
  • func (c *ReposCache) CloneOrPull(ctx context.Context, repoURL, repoName string) error
  • func (c *ReposCache) GetCachedRepos() []string
  • func (c *ReposCache) HasRepo(repoName string) bool
  • func (c *ReposCache) IsStale(repoName string, ttl time.Duration) bool
  • func (c *ReposCache) ListSkills(repoName string) ([]SkillEntry, error)
  • func (c *ReposCache) LoadIndex() ([]RepoInfo, error)
  • func (c *ReposCache) SaveIndex() error
  • func (c *ReposCache) SaveIndexWithStars(starCounts map[string]int, urls map[string]string) error
  • func (c *ReposCache) SearchSkills(keyword string) ([]SkillEntry, error)
• type SkillEntry

Constants

const DefaultTTL = 5 * time.Minute

DefaultTTL is the default cache time-to-live

Functions

func GetReposCacheDir

func GetReposCacheDir() string

GetReposCacheDir returns the repos cache directory path

Types

type Cache

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

Cache provides file-based caching with TTL

func New

func New(cacheDir string, ttl time.Duration) (*Cache, error)

New creates a new cache instance

func (*Cache) Clear

func (c *Cache) Clear() error

Clear removes all cached entries

func (*Cache) Get

func (c *Cache) Get(key string, v interface{}) bool

Get retrieves a value from the cache if it exists and is not expired

func (*Cache) Set

func (c *Cache) Set(key string, v interface{}) error

Set stores a value in the cache

type Entry

type Entry struct {
	Data      json.RawMessage `json:"data"`
	CreatedAt time.Time       `json:"created_at"`
}

Entry represents a cached item with metadata

type RepoInfo

type RepoInfo struct {
	Name         string    `json:"name"`
	URL          string    `json:"url"`
	LocalPath    string    `json:"local_path"`
	UpdatedAt    time.Time `json:"updated_at"`
	LastSyncedAt time.Time `json:"last_synced_at"`
	Stars        int       `json:"stars"`
}

RepoInfo represents cached repository metadata

type ReposCache

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

ReposCache manages local git repository cache for skill discovery

func NewReposCache

func NewReposCache() (*ReposCache, error)

NewReposCache creates a new repos cache instance

func (*ReposCache) CloneOrPull

func (c *ReposCache) CloneOrPull(ctx context.Context, repoURL, repoName string) error

CloneOrPull clones a repo if not exists, or pulls if exists

func (*ReposCache) GetCachedRepos

func (c *ReposCache) GetCachedRepos() []string

GetCachedRepos returns list of cached repo names

func (*ReposCache) HasRepo

func (c *ReposCache) HasRepo(repoName string) bool

HasRepo checks if a repository is cached locally

func (*ReposCache) IsStale

func (c *ReposCache) IsStale(repoName string, ttl time.Duration) bool

IsStale checks if a repository's cache is older than the ttl

func (*ReposCache) ListSkills

func (c *ReposCache) ListSkills(repoName string) ([]SkillEntry, error)

ListSkills lists all skills in a cached repo

func (*ReposCache) LoadIndex

func (c *ReposCache) LoadIndex() ([]RepoInfo, error)

LoadIndex loads the repo index from disk

func (*ReposCache) SaveIndex

func (c *ReposCache) SaveIndex() error

SaveIndex saves the current repo index to disk (without stars)

func (*ReposCache) SaveIndexWithStars

func (c *ReposCache) SaveIndexWithStars(starCounts map[string]int, urls map[string]string) error

SaveIndexWithStars saves the current repo index to disk with star counts and URLs

func (*ReposCache) SearchSkills

func (c *ReposCache) SearchSkills(keyword string) ([]SkillEntry, error)

SearchSkills searches for skills matching keyword in all cached repos

type SkillEntry

type SkillEntry struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Path        string `json:"path"`
	RepoName    string `json:"repo_name"`
}

SkillEntry represents a skill found in local cache