adapters

type Agent interface {
	// Name is the agent identifier used on the command line (--agent).
	Name() hookapi.Agent

	// Detect reports whether the agent appears installed for env's HOME.
	Detect(env install.Env) bool

	// ParseEvent converts a raw hook payload into the neutral event.
	// event is the event name graphmaster was invoked with; env is os.Environ().
	ParseEvent(event hookapi.Event, payload []byte, env []string) (hookapi.HookEvent, error)

	// RenderDecision converts a neutral decision into the agent's wire format.
	RenderDecision(ev hookapi.HookEvent, d hookapi.Decision) HookOutput

	// InstallPlan describes every config edit needed for MCP registration,
	// hooks and instructions at user level.
	InstallPlan(env install.Env, opts InstallOptions) (install.Plan, error)

	// Notes returns human-facing post-install reminders (e.g. Codex /hooks trust).
	Notes(env install.Env) []string
}

type HookOutput struct {
	Stdout   []byte
	Stderr   []byte
	ExitCode int
}

type InstallOptions struct {
	// Binary is the stable absolute path of the graphmaster executable.
	Binary string
	// Instructions is the agent-neutral steering text placed in the agent's
	// instruction file (CLAUDE.md, AGENTS.md, ...).
	Instructions string
}