treesitter

type Options struct {
	// Languages restricts the supported set (config tree_sitter.languages);
	// empty means every pinned language.
	Languages []string
	// MaxWorkers is one per CPU (config.ParserWorkers): the most parser subprocesses
	// alive at once.
	MaxWorkers int
	// MaxParseFileBytes is workspace.max_parse_file_bytes, the only size
	// policy on a file: a larger one is reported unavailable, never streamed.
	// Zero is unlimited. A file of any admitted size is streamed to the worker
	// in transport-unit frames (wire.ChunkBytes).
	MaxParseFileBytes config.Limit
	// MaxCalleeReferences is tree_sitter.max_callee_references: how many
	// distinct cross-file callee names one file may mint nodes for. Unlimited
	// by default; past a user-set bound the call is counted into the file's
	// dropped count and the file reports partial.
	MaxCalleeReferences config.Limit
	// MaxEvidencePerFact is the effective per-fact evidence clip: the operator's
	// index.max_evidence_per_fact, or the model's record ceiling when they set
	// none. Zero selects the ceiling. Occurrences past it are counted and
	// disclosed, never dropped in silence.
	MaxEvidencePerFact int
	// Rederive is handed the parser workers' residency, their part of the
	// product's own, just before each file's increment is reserved; the
	// ledger's re-derivation, which runs before every admission, adds the
	// last figure handed over back to the allocation it derives. It is
	// required.
	Rederive func(workerResidentBytes int64)
	// Admission is the process's one reservation ledger. Each worker holds
	// its base on it from before it is started until the runner has reaped
	// it, and each file holds its predicted increment from before it is
	// dispatched until its Done, so parser workers are admitted against the
	// same allocation, in the same queue, as every other heavy child. It is required: a pool with a running total of its own beside
	// the ledger is the oversubscription the ledger exists to prevent.
	Admission *admission.Ledger
	// Worker is the worker executable; Runner starts it; WorkDir is the
	// absolute private directory it runs in.
	Worker  WorkerCommand
	Runner  *process.Runner
	WorkDir string
}

type Overrun struct {
	Language          string `json:"language"`
	SizeClass         int    `json:"size_class"`
	Files             uint64 `json:"files"`
	LargestDriftBytes int64  `json:"largest_drift_bytes"`
	ReservedBytes     int64  `json:"reserved_bytes"`
	NeedBytes         int64  `json:"need_bytes"`
}

type Probe struct {
	Language     string
	Declarations int
	Imports      int
	References   int
	SyntaxErrors bool
	Truncated    bool
}

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

type Stats struct {
	// Processes is every worker process the runner has not yet reaped: busy,
	// idle and shutting down alike. It never exceeds Options.MaxWorkers.
	Processes int `json:"processes"`
	// IdleWorkers is the reusable subset of Processes, and BusyWorkers the
	// rest: parsing for a caller, or on their way out. The two are reported
	// separately because one number cannot say whether the pool is saturated
	// with work or merely holding warm processes.
	IdleWorkers    int    `json:"idle_workers"`
	BusyWorkers    int    `json:"busy_workers"`
	WorkersStarted uint64 `json:"workers_started"`
	WorkersExited  uint64 `json:"workers_exited"`
	Parses         uint64 `json:"parses"`
	Retries        uint64 `json:"retries"`
	// MaxParsesInFlight is the most files that held an increment at once.
	MaxParsesInFlight int `json:"max_parses_in_flight"`
	// StageWallMS is the wall time the parse stage was open, from its first
	// enter to its last leave, summed over every stage so far.
	StageWallMS int64 `json:"stage_wall_ms"`
	// WorkerCPUMS sums the processor time of every reaped worker, and is -1
	// when any of them was not measured.
	WorkerCPUMS int64 `json:"worker_cpu_ms"`
	// UnmeasuredFiles are the files whose worker reported no need, from which
	// nothing was learned, and NeedModelFailures the learned models that could
	// not be read or encoded, whose files were reserved at the prior or not
	// recorded.
	UnmeasuredFiles   uint64 `json:"unmeasured_files"`
	NeedModelFailures uint64 `json:"need_model_failures"`
	// Overruns are the classes in which a file needed more than its
	// increment, ordered by language and size class.
	Overruns []Overrun `json:"overruns,omitempty"`
	// PriorShortLanguages are the languages, in order, in which a file
	// reserved at the structural prior needed more than it, and FilesRunAlone
	// the later files of those languages that were reserved at the prior and
	// so ran alone among the parses.
	PriorShortLanguages []string `json:"prior_short_languages,omitempty"`
	FilesRunAlone       uint64   `json:"files_run_alone"`
	// WorkerRSSBytes sums the base each live worker last reported, and is -1
	// when any live worker has reported none.
	WorkerRSSBytes int64 `json:"worker_rss_bytes"`
	// ParentRSSBytes is this process's resident set.
	ParentRSSBytes int64 `json:"parent_rss_bytes"`
	// WorkerPIDs are the live workers, for an external check that they exit.
	WorkerPIDs []int `json:"worker_pids,omitempty"`
}

type WorkerCommand struct {
	Path string
	Args []string
}