goldensuite

type Config struct {
	GenManifest string      `json:"gen_manifest"`
	Repos       []RepoEntry `json:"repos"`
	// SelfN is how many self-retrieval cases to sample per repo.
	SelfN int `json:"self_n"`
	// SkipIntent turns the intent ranker off for the whole run (A/B knob).
	SkipIntent bool `json:"skip_intent,omitempty"`
}

type GenResult struct {
	N     int     `json:"n"`
	Hit1  float64 `json:"hit1"`
	Hit3  float64 `json:"hit3"`
	R5    float64 `json:"r5"`
	R10   float64 `json:"r10"`
	AvgMs int64   `json:"avg_ms"`
}

type NegResult struct {
	N              int     `json:"n"`
	Dropped        int     `json:"dropped_as_present"`
	FalseConfident int     `json:"false_confident"`
	Rate           float64 `json:"rate"`
}

type RepoEntry struct {
	Name  string `json:"name"`
	Index string `json:"index"`
}

type RepoResult struct {
	Self *SelfResult `json:"self,omitempty"`
	Neg  *NegResult  `json:"neg,omitempty"`
}

type Report struct {
	Generated time.Time             `json:"generated"`
	Gen       *GenResult            `json:"gen,omitempty"`
	Repos     map[string]RepoResult `json:"repos"`
}

type SelfResult struct {
	N     int     `json:"n"`
	Hit1  float64 `json:"hit1"`
	Hit5  float64 `json:"hit5"`
	Hit10 float64 `json:"hit10"`
	Miss  float64 `json:"miss"`
	// Hit5ByName accepts any symbol with the same short name as the target.
	// DECISION(2026-07): interface/impl pairs make exact-symbol scoring
	// unfair — the docstring lives on the trait declaration while the code
	// lives in the implementing class, and returning the impl IS the answer
	// an agent needs. os-lib read 0.23 "never retrieved" purely because
	// BasePathImpl.baseName was scored as a miss for BasePath.baseName.
	// Strict stays primary (it is the honest lower bound); this is the
	// upper bound, and a wide gap means decl/impl duplication, not failure.
	Hit5ByName float64 `json:"hit5_by_name"`
	SeedGap    float64 `json:"seed_loss_rate"`
	AvgMs      int64   `json:"avg_ms"`
}