ast

Documentation

Overview

Package ast provides a lightweight structural outline of source files for LLM consumption. It uses gotreesitter (pure Go, no CGo) to parse source files and extract symbols. This package is isolated so the gotreesitter dependency can be replaced without affecting the rest of the codebase.

Index

• type File
  • func Parse(filePath string) (*File, error)
• type Symbol

Types

type File

type File struct {
	Path     string
	Language string
	Symbols  []Symbol
}

File holds the parsed outline of a source file.

func Parse

func Parse(filePath string) (*File, error)

Parse reads filePath, detects its language, and returns a structural outline.

type Symbol

type Symbol struct {
	Kind      string `json:"kind"`
	Name      string `json:"name"`
	Signature string `json:"signature"`
	Line      int    `json:"line"` // 1-indexed
	Body      string `json:"-"`    // full source text of the definition span; not serialized
}

Symbol is a structural element extracted from a source file.