cli

Documentation

Overview

Package cli wires together the CLI commands.

Index

• Constants
• Variables
• func BuildGraph(absRoot string) (*graph.Graph, error)
• func PrintJSON(env Envelope) int
• func Run(args []string) int
• type Envelope

Constants

const SchemaVersion = "1"

SchemaVersion is the stable JSON output schema version. Bump when the envelope shape changes in a backwards-incompatible way.

Variables

var Version = "dev"

Version is set at build time via -ldflags; defaults to "dev" for local builds.

Functions

func BuildGraph

func BuildGraph(absRoot string) (*graph.Graph, error)

func PrintJSON

func PrintJSON(env Envelope) int

PrintJSON serialises env to stdout as indented JSON and always exits cleanly (exit 0) unless Status is "error", in which case it exits 1. This function never returns.

func Run

func Run(args []string) int

Run is the entrypoint called from main.

Types

type Envelope

type Envelope struct {
	SchemaVersion string `json:"schema_version"`
	Command       string `json:"command"`
	Query         string `json:"query,omitempty"`
	// Status is "ok" (results found), "empty" (no results, symbol/query valid),
	// or "error" (hard failure — graph missing, parse error, etc.).
	Status  string      `json:"status"`
	Count   int         `json:"count,omitempty"`
	Results interface{} `json:"results,omitempty"`
	Error   string      `json:"error,omitempty"`
}

Envelope is the top-level JSON wrapper for all --json output. schema_version lets agents pin to a known schema and detect changes.