prcache

Documentation

Overview

Package prcache provides PR status caching stored in ~/.wt/prs.json. PRs are stored independently of worktree entries, keyed by repoPath:branch, allowing PR info to be cached before worktrees are created.

Index

• Constants
• func CacheKey(repoPath, branch string) string
• func Path() string
• type Cache
  • func Load() *Cache
  • func New() *Cache
  • func (c *Cache) Delete(key string)
  • func (c *Cache) Get(key string) *PRInfo
  • func (c *Cache) Reset()
  • func (c *Cache) Save() error
  • func (c *Cache) SaveIfDirty() error
  • func (c *Cache) Set(key string, pr *PRInfo)
• type PRInfo
  • func FromForge(pr *forge.PRInfo) *PRInfo
  • func (p *PRInfo) IsStale() bool

Constants

const CacheMaxAge = 24 * time.Hour

CacheMaxAge is the maximum age of cached PR info before it's considered stale

Functions

func CacheKey

func CacheKey(repoPath, branch string) string

CacheKey returns the cache key for a worktree, namespaced by repo path. Uses repoPath:branch since the PR is tied to the branch, not the folder.

func Path

func Path() string

Path returns the path to the PR cache file

Types

type Cache

type Cache struct {
	PRs map[string]*PRInfo `json:"prs"`
	// contains filtered or unexported fields
}

Cache stores PR info keyed by repoPath:branch

func Load

func Load() *Cache

Load loads the PR cache from disk. Returns an empty cache if the file is missing or corrupted.

func New

func New() *Cache

New returns an empty, initialized cache.

func (*Cache) Delete

func (c *Cache) Delete(key string)

Delete removes PR info for a cache key

func (*Cache) Get

func (c *Cache) Get(key string) *PRInfo

Get returns PR info for a cache key, or nil if not found

func (*Cache) Reset

func (c *Cache) Reset()

Reset clears all cached data

func (*Cache) Save

func (c *Cache) Save() error

Save saves the PR cache to disk atomically

func (*Cache) SaveIfDirty

func (c *Cache) SaveIfDirty() error

SaveIfDirty saves the cache to disk only if it has been modified. Resets the dirty flag after a successful save.

func (*Cache) Set

func (c *Cache) Set(key string, pr *PRInfo)

Set stores PR info for a cache key

type PRInfo

type PRInfo struct {
	Number       int       `json:"number"`
	State        string    `json:"state"`    // Normalized: OPEN, MERGED, CLOSED
	IsDraft      bool      `json:"is_draft"` // true if PR is a draft
	URL          string    `json:"url"`
	Author       string    `json:"author"`        // username/login
	CommentCount int       `json:"comment_count"` // number of comments
	HasReviews   bool      `json:"has_reviews"`   // any reviews submitted
	IsApproved   bool      `json:"is_approved"`   // approved status
	CachedAt     time.Time `json:"cached_at"`
	Fetched      bool      `json:"fetched"` // true = API was queried (distinguishes "not fetched" from "no PR")
}

PRInfo represents pull request information

func FromForge

func FromForge(pr *forge.PRInfo) *PRInfo

FromForge converts a forge.PRInfo to a prcache.PRInfo. Returns nil if pr is nil.

func (*PRInfo) IsStale

func (p *PRInfo) IsStale() bool

IsStale returns true if the cache entry is older than CacheMaxAge