scan

type Breakdown struct {
	Total  int                       `json:"total"`
	Counts map[probe.Verdict]int     `json:"counts"`
	Rates  map[probe.Verdict]float64 `json:"rates"`
}

type NameIssue struct {
	Count  int      `json:"count"`
	Sample []string `json:"sample,omitempty"`
}

type NameIssues struct {
	// BadCharset counts names containing a character outside
	// nameCharsetRe (for example an uppercase letter or a space).
	BadCharset NameIssue `json:"badCharset"`
	// BadShape counts names that are not exactly one "/" splitting a
	// non-empty namespace segment (containing at least one ".") from a
	// non-empty local segment, with neither segment starting with ".".
	BadShape NameIssue `json:"badShape"`
	// CaseCollisions counts names that are distinct but identical to
	// another name in this run once lowercased, which would collide as
	// the same file. An exact (case-sensitive) repeat of the same name is
	// not a collision by itself; registry.Drain already dedupes those
	// before validateNames ever sees the list.
	CaseCollisions NameIssue `json:"caseCollisions"`
}

type Options struct {
	// Out is the output directory. Required. RecordsFile and SummaryFile are
	// written inside it.
	Out string
	// Limit caps how many servers are drained from the registry. 0 means the
	// whole registry.
	Limit int
	// Concurrency is the worker pool size. <= 0 falls back to
	// DefaultConcurrency.
	Concurrency int
	// Timeout bounds one server's full probe set. <= 0 falls back to
	// DefaultTimeout.
	Timeout time.Duration
	// Progress receives one line per completed server ("1234/13886 name
	// verdict"), plus a startup line noting how many were already recorded.
	// A nil Progress disables progress reporting.
	Progress io.Writer
}

type Summary struct {
	RegistryBaseURL string `json:"registryBaseUrl"`
	AkashiVersion   string `json:"akashiVersion"`
	Concurrency     int    `json:"concurrency"`
	Limit           int    `json:"limit"` // 0 means the whole registry
	StartedAt       string `json:"startedAt"`
	FinishedAt      string `json:"finishedAt"`

	// Overall is the verdict census across every server this run targeted.
	Overall Breakdown `json:"overall"`
	// Segments key the same kind of census by a defining trait. "remote"
	// (servers that declare at least one hosted remote endpoint) is the
	// headline: a reachable, conformant remote is the strongest keyless
	// liveness proof a census can gather, since its domain is verified simply
	// by being probed live over HTTPS.
	Segments map[string]Breakdown `json:"segments"`
	// NameIssues flags registry names that would not survive the planned
	// <namespace>/<name> per-server page routing (see validateNames). It is
	// a heads-up for the index build, not a scan failure: every server is
	// still probed and recorded regardless of what this reports.
	NameIssues NameIssues `json:"nameIssues"`
}