Files
archie/internal/domain/sampling/staleness.go
T
sam 268283eb16 chore(curator): add embedding client and sampler interface prerequisites (#752)
* 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
2026-09-05 22:53:08 +10:00

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
}