install

type Action string

type BinaryLocator struct {
	Executable   func() (string, error)
	LookPath     func(string) (string, error)
	EvalSymlinks func(string) (string, error)
	// TempDirs are roots whose binaries are considered ephemeral
	// (default: os.TempDir()).
	TempDirs []string
}

type BinaryPath struct {
	Path   string
	Reason string
}

type Block struct {
	// ID distinguishes several blocks in one file; "" is the default block.
	ID   string
	Body string
}

type CheckStatus string

type Component string

type Container struct {
	Agent   string `json:"agent"`
	Pointer string `json:"pointer"`
}

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

type Env struct {
	// LookupEnv defaults to os.LookupEnv.
	LookupEnv func(string) (string, bool)
	// Now defaults to time.Now; it names backup directories.
	Now func() time.Time
}

type FileChange struct {
	// Path is absolute.
	Path   string
	Format Format
	// Ops apply to FormatJSON (JSONSet, JSONAppend) and to FormatTOML /
	// FormatMarkdown (Block).
	Ops []Op
	// Content is the full file for FormatGenerated.
	Content []byte
	// Mode is used when FormatGenerated creates the file (default 0644).
	Mode fs.FileMode
}

type FileRecord struct {
	Path   string `json:"path"`
	Format Format `json:"format"`
	// Existed reports whether the file existed before the first install.
	Existed bool `json:"existed"`
	// PreHash is the sha256 of the file before the first install ("" if absent).
	PreHash string `json:"pre_hash,omitempty"`
	// PostHash is the sha256 after graphmaster's latest write.
	PostHash string `json:"post_hash"`
	// Backup holds the pre-install bytes ("" if the file did not exist).
	Backup string `json:"backup,omitempty"`
	// Restorable is false once the user edited the file between two
	// graphmaster writes: a backup restore would then lose their edit.
	Restorable bool        `json:"restorable"`
	Insertions []Insertion `json:"insertions"`
	Created    []Container `json:"created,omitempty"`
	// CreatedDirs are parent directories graphmaster created, innermost last.
	CreatedDirs []string `json:"created_dirs,omitempty"`
}

type FileResult struct {
	Path   string
	Agents []string
	Action Action
	// Diff is a unified diff of the change ("" when unchanged).
	Diff string
	Note string
}

type Format string

type Insertion struct {
	Agent   string          `json:"agent"`
	Kind    InsertionKind   `json:"kind"`
	Pointer string          `json:"pointer,omitempty"`
	Value   json.RawMessage `json:"value,omitempty"`
	// Prev is the member value graphmaster replaced; restored on removal.
	Prev json.RawMessage `json:"prev,omitempty"`
	// Marker is the block id ("" for the default block).
	Marker string `json:"marker,omitempty"`
	// Sep is the separator inserted before an appended marker block.
	Sep string `json:"sep,omitempty"`
}

type InsertionKind string

type JSONAppend struct {
	Pointer string
	Value   any
}

type JSONSet struct {
	Pointer string
	// Value is any JSON-marshalable value; json.RawMessage is used verbatim
	// (key order preserved).
	Value any
}

type Op interface {
	// contains filtered or unexported methods
}

type OpCheck struct {
	Path      string
	Format    Format
	Op        Op
	Component Component
	Status    CheckStatus
	// Found is graphmaster's current text in the file: the JSON member, the
	// array elements recognized as graphmaster's, the marker block or the
	// whole generated file.
	Found []string
	// Index is the array position of the matching (or stale) element for
	// JSONAppend; -1 otherwise.
	Index int
	// Binaries are the absolute graphmaster executable paths Found refers to.
	Binaries []string
	// Err explains CheckInvalid.
	Err error
}

type Options struct {
	// DryRun computes the report (with diffs) without writing anything.
	DryRun bool
}

type Plan struct {
	// Agent identifies the adapter ("claude", "codex", ...). Insertions are
	// recorded per agent so agents can be uninstalled independently.
	Agent string
	Files []FileChange
}

type Report struct {
	DryRun bool
	Files  []FileResult
}

type State struct {
	Version int                    `json:"version"`
	Files   map[string]*FileRecord `json:"files"`
}