adapters

type Adapter interface {
	ID() string
	Version() string
	Ingest(repoPath string) ([]fact.Fact, []Warning)
}

type Options struct {
	// Registries maps a resolved repo path to the extra registry file paths
	// (repo-relative) configured via the per-repo `registries:` entry form
	// in studio.yaml (workspace.Workspace.ResolveRegistries).
	Registries map[string][]string
}

type RepoSummary struct {
	// Path is the repo path as passed to Run.
	Path string
	// Slug is the stable repository ID minted for the path. Remoted repos use
	// normalized forge coordinates; local-only repos use a path-derived ID.
	Slug string
	// Facts is the number of facts ingested from the repo.
	Facts int
	// Warnings is the number of warnings collected for the repo.
	Warnings int
}

type Result struct {
	// Facts are the fully stamped facts, in repo-then-adapter emission order.
	Facts []fact.Fact
	// Warnings are the collected non-fatal problems, stamped with the repo
	// slug and adapter id they came from. Repo-level warnings (a repo path
	// that is not an existing directory) carry an empty Adapter.
	Warnings []Warning
	// FactsByAdapter counts the facts each adapter emitted, keyed by adapter
	// id; every adapter that ran has an entry (zero included).
	FactsByAdapter map[string]int
	// FactsByRepo groups the stamped facts by the slug of the repo whose
	// adapter run produced them — the provenance the INGR export needs to
	// attribute global-coordinate facts (e.g. registry domains) to a repo
	// (REQ: ingr-export). Skipped repos have no entry (zero facts).
	FactsByRepo map[string][]fact.Fact
	// Repos are the per-repo run summaries, in input repo order; skipped
	// repos are included (zero facts, one repo-level warning).
	Repos []RepoSummary
}

type Warning = fact.Warning