* feat(curator): add embedding client and sampler wave-1 prerequisites Bead archie-core-1786637500752-415-434e5bb9 (GitHub #436) was closed with no linked PR/commits, and the surprisal-sampling bead archie-core-1786637500776-416-600a66e5 (GitHub #437) found none of its stated prerequisites -- an embedding client, a Sampler interface, or the four wave-1 cheap sampling strategies -- actually exist. This builds them: - internal/domain/embedding + internal/infrastructure/embedding: a narrow typed embedding client, config-driven via a providers table + a role in [models], mirroring the existing chat model role convention. Degrades to capability-unavailable (never fails startup or a call) for a missing role, unknown provider, unsupported class, or unresolved credential. Wired as an optional capability in bootstrap.go's setupEmbeddings. - internal/domain/sampling: the Sampler interface plus recency, random, all, and staleness-proxy strategies, per docs/prds/curator-sampler-wave1.md. Deterministic given fixed inputs, matching GitHub #437's stated acceptance criterion for the embedding-backed strategy it will add behind this same interface (not part of this change). Table-driven tests throughout; httptest for the embedding client, no live service. No curator wiring yet -- nothing consumes either capability in this change. * no-mistakes(document): docs(architecture): mark curator sampling prereqs as landed
21 lines
804 B
Go
21 lines
804 B
Go
package sampling
|
|
|
|
import "context"
|
|
|
|
// stalenessSampler is the "staleness proxy" strategy: prefers content that
|
|
// hasn't been touched/reviewed in the longest time, i.e. the smallest
|
|
// Candidate.At first. It is a cheap proxy only -- callers decide what
|
|
// timestamp At holds (created, updated, or last-reviewed); this is never
|
|
// the embedding-based surprisal calculation (see GitHub #437).
|
|
type stalenessSampler struct{}
|
|
|
|
// NewStaleness builds the "staleness" strategy.
|
|
func NewStaleness() Sampler { return stalenessSampler{} }
|
|
|
|
func (stalenessSampler) Name() string { return "staleness" }
|
|
|
|
func (stalenessSampler) Sample(_ context.Context, candidates []Candidate, req Request) ([]Candidate, error) {
|
|
sorted := sortByTime(candidates, false)
|
|
return sorted[:effectiveCap(req.Cap, len(sorted))], nil
|
|
}
|