dtoro
64f7d54011
Problem: the hexagon's Phase 2 (plans/2026-08-15-hexagonal-architecture.md) must give the use-cases-to-be their contract surface: driven-port interfaces, test fakes, the secrets interface moved into core, and the postgres package inside the adapters tree — before the first vertical slice (Phase 3) can wire a composition root. Change: - internal/core/ports: full driven-port catalog per plan §3.3 — repositories as transaction-scoped aggregates whose inputs carry derived checks, audit, and events (§3.6), plus CommandExecutor, TargetResolver, Checker, Secrets, EventPublisher, Provisioner. Port-local payload types (Event, AuditEntry, CheckDef, KnowledgeEntry, ExecResult) keep signatures off infrastructure; TypeTree aliases internal/ontology (pure over domain) until checkdefaults is absorbed. ReadModels intentionally not declared yet — it materializes with the Phase 3 slice and grows as report handlers rewire. - secrets.Backend is now an alias of ports.Secrets; implementations (Infisical, SOPS, Manager) unchanged. mcp's local secretBackend subset is deleted; tool constructors take ports.Secrets. - internal/db → internal/adapters/postgres (mechanical import rewrite; package identifier stays db until the Phase 3 repository split). sqlc.yaml, Makefile, golangci exclusions, and docs follow the move; make generate-check verified. - internal/adapters/ssh: Executor implements ports.CommandExecutor over the actuator dial pool + RunStreaming (10-min default timeout carried over from the httpapi path). - internal/adapters/remote: Resolver implements ports.TargetResolver delegating to internal/remote (still pool-based; drops onto ports.EntityRepository when repositories land in Phase 3 — documented transitional import). - internal/core/ports/portstest: importable fakes — in-memory EntityRepo (with check-then-act SetState, side-effect recording), RecordingExecutor, FakeChecker, SpyPublisher; port-satisfaction guards; tests. Risk: ports are declared ahead of implementations — signatures firm up per phase as slices land (documented in the package doc); the remote→postgres transitional import is explicit and dissolves in Phase 3. Verification: go vet, make test (race, 19 packages), generate-check, golangci on core+adapters — 0 issues; full-repo baseline down 365→344.
68 lines
1.5 KiB
Go
68 lines
1.5 KiB
Go
package db
|
|
|
|
import (
|
|
"sync"
|
|
"time"
|
|
)
|
|
|
|
type entityCacheEntry struct {
|
|
slug string
|
|
id string
|
|
attrs string
|
|
exp time.Time
|
|
}
|
|
|
|
// EntityCache is a TTL cache mapping entity IDs to slugs and back,
|
|
// keyed for the hot resolution paths.
|
|
type EntityCache struct {
|
|
mu sync.RWMutex
|
|
m map[string]entityCacheEntry
|
|
ttl time.Duration
|
|
}
|
|
|
|
// NewEntityCache builds a cache with the given TTL.
|
|
func NewEntityCache(ttl time.Duration) *EntityCache {
|
|
return &EntityCache{
|
|
m: make(map[string]entityCacheEntry),
|
|
ttl: ttl,
|
|
}
|
|
}
|
|
|
|
// GetSlug resolves an entity ID to its slug.
|
|
func (c *EntityCache) GetSlug(id string) (string, bool) {
|
|
c.mu.RLock()
|
|
e, ok := c.m[id]
|
|
c.mu.RUnlock()
|
|
if !ok || time.Now().After(e.exp) {
|
|
return "", false
|
|
}
|
|
return e.slug, true
|
|
}
|
|
|
|
// GetID resolves a slug to its entity ID.
|
|
func (c *EntityCache) GetID(slug string) (string, bool) {
|
|
c.mu.RLock()
|
|
e, ok := c.m[slug]
|
|
c.mu.RUnlock()
|
|
if !ok || time.Now().After(e.exp) {
|
|
return "", false
|
|
}
|
|
return e.id, true
|
|
}
|
|
|
|
// Set records the slug/id pair and serialized attributes.
|
|
func (c *EntityCache) Set(slug, id, attrs string) {
|
|
exp := time.Now().Add(c.ttl)
|
|
c.mu.Lock()
|
|
c.m[slug] = entityCacheEntry{slug: slug, id: id, attrs: attrs, exp: exp}
|
|
c.m[id] = entityCacheEntry{slug: slug, id: id, attrs: attrs, exp: exp}
|
|
c.mu.Unlock()
|
|
}
|
|
|
|
// Invalidate drops the cached entries for one slug/id pair.
|
|
func (c *EntityCache) Invalidate(slug, id string) {
|
|
c.mu.Lock()
|
|
delete(c.m, slug)
|
|
delete(c.m, id)
|
|
c.mu.Unlock()
|
|
} |