tools

type DriftAuditor ¶ added in v0.3.0

type DriftAuditor interface {
	GetDriftFindings(opts store.DriftAuditOpts) ([]store.DriftFinding, error)
}

DriftAuditor is the drift-audit surface the tools layer consumes from a store.

GetDriftFindings is the single exported drift entry point — the ~20 find*/conflicting* helpers are package-private to internal/store and hide behind it — so drift consumers depend on this narrow interface instead of the whole *store.Store. That keeps the dependency honest (drift rendering needs nothing else from a store) and lets the rendering be unit-tested against a mock. *store.Store satisfies it; in workspace mode each project's *Store does.

type EntityReader ¶ added in v0.3.0

type EntityReader interface {
	GetEntityByID(entityID string) (*store.Entity, error)
}

EntityReader resolves an entity UUID to its full record. appendEntitySection uses it to render human-readable canonical names + aliases instead of the bare entity UUIDs stored on mentions. Satisfied by the entity sub-store reached via store.Store.Entity (passed at the call sites in handleNode/handleContext); the sub-store type is unexported, so the satisfaction is enforced there rather than by a package-level var assertion.

type HistoryReader ¶ added in v0.3.0

type HistoryReader interface {
	GetFileHistory(path string) (*store.FileHistory, error)
}

HistoryReader is the git-history surface handleHistory consumes from a store. GetFileHistory is the only store call on the render path (node resolution stays in the handler), so the rendering is unit-testable against a mock. *store.Store satisfies it.

type RegisterOpts ¶ added in v0.2.2

type RegisterOpts struct {
	EnableEmbeddings bool
	EnableEnrichment bool
}

RegisterOpts configures which opt-in LLM callout tools are registered. Both default to false — tools are not registered unless explicitly enabled.