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 is the package name declared in package.json (e.g. "my-service").
	Name string
	// EntityName is the name sanitized for use as a knowledge graph node.
	// Scoped packages like "@myorg/my-service" are normalized to "my-service".
	EntityName string
	// Version is the declared package version (e.g. "1.2.3").
	Version string
	// DirectDeps are the package names listed under "dependencies" (not devDependencies).
	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"
}

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