parse

type RefKind ¶

type RefKind string

RefKind classifies a reference site. Values mirror the MCP tool schema.

const (
	RefCall     RefKind = "call"
	RefImport   RefKind = "import"
	RefSubclass RefKind = "subclass"
)

type Reference ¶

type Reference struct {
	Name string
	Kind RefKind
	Line int
	Col  int
}

Reference is a single textual reference to a name at a source location.

Line and Col are 1-based to match what users see in editors. Col is the byte column at the start of the identifier. Name is the bare identifier as written at the call/import/subclass site (not resolved); v0.1 is textual, so a `Foo()` call and a `Foo()` constructor share the same name.

func ParsePythonRefs(src []byte) ([]Reference, error)

type Symbol ¶

type Symbol struct {
	Name      string
	Qualified string
	Kind      SymbolKind
	StartLine int
	EndLine   int
	Signature string
	Docstring string
}

Symbol is a single named definition extracted from a source file.

Line numbers are 1-based and inclusive, matching what users see in editors. Qualified is the dotted path within the file (e.g. "Greeter.greet"); the indexer prepends the module path at insert time. Signature is the def line up to but not including the body, with the trailing colon trimmed; empty for classes and assignments. Docstring is the first paragraph of the body's docstring if present, truncated to 500 characters.

func ParsePython(src []byte) ([]Symbol, error)

func ParsePythonTopLevel(src []byte) ([]Symbol, error)

type SymbolKind ¶

type SymbolKind string

SymbolKind classifies a parsed symbol. Values are stable strings because they are persisted to the on-disk index and surfaced through MCP tools.

const (
	KindFunction SymbolKind = "function"
	KindClass    SymbolKind = "class"
	KindMethod   SymbolKind = "method"
	KindVariable SymbolKind = "variable"
	KindConstant SymbolKind = "constant"
)