watcher

type BrainCrossProjectTracker interface {
	// DetectAndStoreBrain reads the file content, calls the brain LLM for
	// cross-project dependency detection, validates results against sibling
	// stores, and persists any new deps not already found by Tier 1.
	// Runs fire-and-forget — errors are logged, never propagated.
	DetectAndStoreBrain(ctx context.Context, filePath string, localStore *store.Store)
}

type ChangeEvent struct {
	Timestamp    time.Time `json:"at"`
	File         string    `json:"file"` // repo-relative when graph root is set
	NodesAdded   int       `json:"nodes_added"`
	NodesRemoved int       `json:"nodes_removed"`
	EdgesAdded   int       `json:"edges_added"`
}

type ConfigChangeHandler func(newCfg *config.Config)

type CrossProjectTracker interface {
	// DetectAndStore scans a file for cross-project imports, resolves entities
	// against sibling stores, and persists the results. Errors are logged and
	// skipped (fail-open). ctx controls cancellation and timeout.
	DetectAndStore(ctx context.Context, filePath string, localStore *store.Store)
}

type NameMatcherRunner interface {
	// RunAsync scans g for cross-domain name matches and persists MENTIONS edges
	// to st. changedFiles is the list of files in the triggering batch; pass nil
	// to indicate a full re-walk (all domains affected — always run).
	// Must respect ctx cancellation. Never blocks — errors are logged.
	RunAsync(ctx context.Context, g *graph.Graph, st *store.Store, changedFiles []string)
}

type PacketCacheInvalidator interface {
	InvalidatePacketCache()
	// InvalidatePacketCacheForFile is like InvalidatePacketCache but also triggers
	// MCP resource notifications and proactive brain cache warming for the given file.
	InvalidatePacketCacheForFile(changedFile string)
}

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