platform

type ClaudePlatform struct{}

type HookStatus struct {
	Installed bool   `json:"installed"`
	UpToDate  bool   `json:"up_to_date"`
	Command   string `json:"command,omitempty"`
}

type Platform interface {
	// Name returns the canonical slug used to look this adapter up in
	// the registry and in user-facing config (e.g. "claude").
	Name() string

	// Sync writes prompt into the platform's managed section inside
	// projectRoot. Idempotent: if the managed section already matches
	// prompt, Sync makes no filesystem change. Content outside the
	// managed section is preserved byte-for-byte.
	Sync(ctx context.Context, prompt string, projectRoot string) error

	// InstallHooks registers brainjar-owned hook entries in the
	// platform's settings file under projectRoot. User-authored hooks
	// and unrelated settings are preserved. Re-invoking with the same
	// binary is a no-op; re-invoking after the binary path changes
	// upserts.
	InstallHooks(ctx context.Context, projectRoot string) error

	// RemoveHooks strips only brainjar-owned entries from the
	// platform's settings file. User hooks and other settings survive.
	RemoveHooks(ctx context.Context, projectRoot string) error

	// HooksStatus reports whether brainjar hooks are installed and
	// whether the installed command is current for this binary.
	HooksStatus(ctx context.Context, projectRoot string) (HookStatus, error)

	// MapModelPrefs translates a generic ModelPrefs into a params map
	// the platform's runtime understands (e.g. Claude model IDs).
	MapModelPrefs(prefs *models.ModelPrefs) map[string]any
}