parser

type AuxEntity struct {
	Name         string
	EntityType   string
	Observations []string
}

type CodeOwner struct {
	// Raw is the original owner token as written in the file
	// (e.g. "@myorg/backend-team", "@alice", "alice@example.com").
	Raw string
	// EntityName is the normalized identifier used as the knowledge-graph node name
	// (e.g. "backend-team", "alice").
	EntityName string
	// EntityType is "team" for @org/team handles, "person" for @username or e-mail owners.
	EntityType string
}

type FileParser interface {
	// FileType returns the classifier key used by classifyFile() and the indexer.
	// Must be unique across the registry. Examples: "gomod", "catalog-info".
	FileType() string

	// Filenames returns the exact filenames (or suffix sentinels starting with ".")
	// this parser handles. The scanner looks for these at the repo root.
	// Examples: ["go.mod"], ["catalog-info.yaml"], [".proto"] (suffix match).
	Filenames() []string

	// Parse converts raw file bytes into a normalized graph-ready result.
	Parse(data []byte) (ParsedFile, error)
}

type MergeMode int

type ParsedCatalog struct {
	EntityName string

	EntityType string

	Observations []string

	Relations []ParsedRelation
}

type ParsedCodeowners struct {
	// UniqueOwners contains every distinct owner token found across all rules.
	UniqueOwners []CodeOwner
}

type ParsedFile struct {
	EntityName   string
	EntityType   string
	Observations []string
	Relations    []ParsedRelation
	MergeMode    MergeMode
	// AuxEntities are created/updated before Relations. Used when a single file
	// produces multiple graph entities (e.g. CODEOWNERS produces one per owner).
	AuxEntities []AuxEntity
}

type ParsedGoMod struct {
	ModulePath string

	EntityName string

	GoVersion string

	DirectDeps []string
}

type ParsedPackageJSON struct {
	Name string

	EntityName string

	Version string

	DirectDeps []string
}

type ParsedPom struct {
	GroupID string

	ArtifactID string

	EntityName string

	Version string

	DirectDeps []string
}

type ParsedRelation struct {
	From         string
	To           string
	RelationType string // e.g. "depends_on", "owns", "provides_api"
	// Confidence is the edge reliability level. Parsers set "authoritative" for explicit
	// contract files (AsyncAPI, OpenAPI, proto, go.mod, pom.xml, catalog, CODEOWNERS, package.json)
	// and "inferred" for heuristic sources (Spring Kafka, K8s env vars).
	// If empty, the indexer defaults to "authoritative".
	Confidence string
}

type ParserRegistry struct {
	// contains filtered or unexported fields
}