platform

type ClaudePlatform struct{}

type HookScope int

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 at the scope requested. 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. projectRoot is used when scope is HookScopeProject and
	// ignored when scope is HookScopeUser.
	InstallHooks(ctx context.Context, scope HookScope, projectRoot string) error

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

	// HooksStatus reports whether brainjar hooks are installed at the
	// requested scope and whether the installed command matches what
	// Install would write now.
	HooksStatus(ctx context.Context, scope HookScope, 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
}