records

type Input struct {
	Groups        []routes.Group
	StubResults   []stubs.Result              // from Phase 3; matched to groups by method+path
	Boundaries    map[string][]boundaries.Hit // handlerRef → hits; used for summary boundary count
	ProvenanceDir string                      // directory to write records into (e.g. "provenance")
	SpecsDir      string                      // root-relative path to specs (e.g. "specs")
	Author        string                      // author field for generated records; defaults to "linespec-discover"
}

type Result struct {
	GroupName  string
	RecordID   string
	FilePath   string
	Title      string
	RouteCount int
}

type Summary struct {
	RouteCount     int
	BoundaryCount  int
	RecordsCreated int
	Unclassified   []string // source files not matched to any route group
}