store

type FileStore ¶

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

FileStore is a file-backed implementation of Store.

Layout under root:

{root}/{kind}/{fileHash[:2]}/{fileHash[2:]}-{ruleSetHash}.bin

Two-level sharding on the file-content hash keeps no single directory larger than 256 children even in large repos. The ruleSetHash suffix allows the same source file to have independent entries for different rule configurations.

func New(dir string) *FileStore

func (s *FileStore) Get(key Key) ([]byte, bool)

func (s *FileStore) Invalidate(ruleIDs ...string) error

func (s *FileStore) Put(key Key, value []byte) error

func (s *FileStore) Stats() (Stats, error)

type Key ¶

type Key struct {
	FileHash    [32]byte
	RuleSetHash [16]byte
	Kind        Kind
}

Key uniquely identifies one entry in the store.

FileHash is the full SHA-256 of the source file's bytes. RuleSetHash encodes the active rule IDs and their configuration (16 bytes). Kind scopes the entry to its owning subsystem so KindIncremental and KindOracle entries for the same file never collide.

type Kind ¶

type Kind uint8

Kind distinguishes the logical cache domain inside a unified store.

const (
	KindIncremental Kind = iota // incremental analysis findings
	KindOracle                  // JVM type-analysis results
	KindMatrix                  // experiment matrix baseline counts
	KindBaseline                // baseline suppression membership
)

type KindStats ¶

type KindStats struct {
	EntryCount int
	TotalBytes int64
}

KindStats holds entry count and byte size for one Kind.

type Stats ¶

type Stats struct {
	EntryCount int
	TotalBytes int64
	HitRate    float64            // populated by callers that track hits/misses
	ByKind     map[Kind]KindStats // per-kind breakdown
}

Stats summarises utilisation for krit cache stats.

type Store ¶

type Store interface {
	// Get retrieves a cached value by key. Returns (nil, false) on miss.
	Get(key Key) ([]byte, bool)

	// Put stores a value, overwriting any existing entry for the key.
	Put(key Key, value []byte) error

	// Invalidate removes all entries whose on-disk path encodes one of
	// the given rule IDs in their RuleSetHash prefix directory. This is
	// a best-effort scan; it never returns an error for individual
	// missing entries.
	Invalidate(ruleIDs ...string) error

	// Stats returns a point-in-time summary of cache utilisation.
	Stats() (Stats, error)
}

Store is a content-hash-keyed byte store. Each subsystem encodes its own payload into []byte; the store owns only persistence and invalidation.