parser

const (
	EdgeCalls      = "calls"
	EdgeImports    = "imports"
	EdgeInherits   = "inherits"
	EdgeImplements = "implements"
	EdgeContains   = "contains"
	EdgeReferences = "references"
)

Edge relation kinds. This vocabulary is the graph's contract: parsers emit these strings and every query filters on them.

const (
	ExtraAnnotation = "annotation"
	ExtraArgPrefix  = "arg."
)

ExtraAnnotation names the annotation a references edge records; its arguments ride along as ExtraArgPrefix+key ("arg.url"), an unnamed single argument under "arg.value". A string is stored unquoted, an array of strings joined by ",", anything else as written (CoreFeignConfiguration.class). Untagged, unlike the extractor that sets them: CGO-free readers of a snapshot (xray-memory services) read these edges too.

const (
	ExtraScriptImport = "scriptImport"
	ExtraBinding      = "binding"
	ExtraImported     = "imported"
	ExtraScriptCall   = "scriptCall"
	ExtraSelfCall     = "selfCall"
)

Hints on TypeScript and Python facts (parser/script_calls.go, resolved in graph/scriptlink.go). An imports edge with ExtraScriptImport binds ExtraBinding in the importing file to ExtraImported from the module in Target: a symbol name, "default", "*" (a namespace or wildcard) or "" (the module itself). A calls edge with ExtraScriptCall carries bare, recvType or recvVar, and ExtraSelfCall when the receiver is this/self.

const ExtraArgURLParam0 = "argUrlParam0"

ExtraArgURLParam0 marks a calls edge whose first argument is exactly the enclosing method's own first parameter, unresolved on its own. A hand-written HTTP client wrapper (RestTemplate, WebServiceTemplate) is usually an interface plus one impl that just forwards what it was given, the shape a declared client (@FeignClient and peers) does not need: there the address is written at the annotation itself. The service map (which carries no CGO parser and cannot re-walk the source) follows this marker back through the method's own callers instead, one call frame at a time, until it reaches a literal or an ExtraArgPrefix+"url" a caller resolved directly (a field's Spring @Value("${...}") placeholder, expanded through Config nodes exactly like a Feign url).

const ExtraJavaRecv = "javaRecv"

ExtraJavaRecv marks a calls edge whose recvType is a Java type name, to be resolved through the file's imports and package (graph/typelink.go) rather than as a Go package-local type.

const ExtraJavaSelf = "javaSelf"

ExtraJavaSelf marks a Java call with no receiver or this: foo(), this.foo(). Unlike x.foo(), a name the class does not declare can be a static import (when, assertEquals), so it does not fall back to the class.

const FactsVersion = 2

FactsVersion numbers what the extractors put in a graph. Bump it when an extractor starts emitting a fact an existing snapshot cannot hold — a new node kind, a new edge or hint — so a reader of an older snapshot can say so instead of answering with less: `services` on a snapshot built before Image and Config nodes silently found fewer services, and a server seeded from one kept serving the old facts until the next cold build.

0  before the number existed
1  Image, Config (application config) and Deployment nodes; Java
   annotations, declared types, imports and receiver-typed calls; methods
   of tags-extracted languages carry their class (ParentName)
2  TypeScript and Python import bindings and receiver-hinted calls;
   tsconfig/jsconfig as Config nodes (compilerOptions.paths)