integration

type BundlePatcher interface {
	// HasMarker reports whether the bundle currently contains both
	// marker delimiters.
	HasMarker(bundlePath string, marker Marker) (bool, error)
	// Inject writes payload into the bundle, replacing any existing marker
	// region in place. Atomic on success.
	Inject(bundlePath, payload string, marker Marker) error
	// Restore copies backupPath onto bundlePath atomically.
	Restore(bundlePath, backupPath string) error
	// Backup copies bundlePath into backupDir, returning the absolute path
	// of the new backup file. Existing backups are kept (timestamp suffix).
	Backup(bundlePath, backupDir string) (backupFile string, err error)
	// Checksum returns the lower-case hex SHA-256 of path.
	Checksum(path string) (string, error)
}

type FilePatcher struct{}

type IDEPaths struct {
	// AppRoot is the IDE installation root, e.g. /Applications/Windsurf.app
	// on macOS or C:\Users\<u>\AppData\Local\Programs\Windsurf on Windows.
	AppRoot string
	// BundleFile is the absolute path to the Electron bundle that receives
	// the injection (typically workbench.desktop.main.js).
	BundleFile string
	// ProductFile is the absolute path to product.json, used to bypass the
	// Electron resource checksum guard.
	ProductFile string
	// BackupDir is the installer-local directory where the original bundle
	// is preserved before injection. Restoring from this directory must
	// recover the IDE to its pre-injection state byte-for-byte.
	BackupDir string
}

type InjectStatus struct {
	// Injected is true when the live bundle currently contains the openPE
	// injection markers.
	Injected bool
	// InjectVersion is the version string recorded inside the marker meta,
	// empty when not injected.
	InjectVersion string
	// BackupExists is true when a usable backup file is present in the
	// installer-local backup directory.
	BackupExists bool
	// IDEVersion is the version reported by the IDE's product.json, or
	// empty when unavailable.
	IDEVersion string
	// LiveChecksum is the SHA-256 of the current on-disk bundle.
	LiveChecksum string
	// BackupChecksum is the SHA-256 of the most recent backup, or empty
	// when no backup exists.
	BackupChecksum string
}

type Injector interface {
	// Name returns the lower-case IDE identifier, e.g. "windsurf", "cursor".
	Name() string
	// ResolvePaths discovers the IDE's install paths on the current machine.
	// Honours opts.AppDirOverride when non-empty.
	ResolvePaths(ctx context.Context, opts InstallOptions) (*IDEPaths, error)
	// Status reports the current injection state without mutating anything.
	Status(ctx context.Context, opts InstallOptions) (*InjectStatus, error)
	// Install performs the injection. Must refuse unless
	// opts.DisclaimerAccepted is true.
	Install(ctx context.Context, opts InstallOptions) error
	// Uninstall restores the IDE to its pre-injection state from the backup.
	Uninstall(ctx context.Context, opts InstallOptions) error
}

type InstallOptions struct {
	// AppDirOverride lets the user point the installer at a non-default IDE
	// install location (e.g. portable installs or sandboxed test fixtures).
	AppDirOverride string
	// DryRun reports the actions that would be taken without touching disk.
	DryRun bool
	// DisclaimerAccepted MUST be set to true by the CLI front-end after the
	// user has explicitly acknowledged the experimental + EULA risk. Installers
	// must refuse to mutate state when this is false.
	DisclaimerAccepted bool
}

type LocalServerDescriptor struct {
	// BaseURL is the loopback HTTP endpoint, e.g. http://127.0.0.1:18980.
	BaseURL string `json:"base_url"`
	// Token is the bearer token clients must send as Authorization header.
	Token string `json:"token"`
	// PID is the openpe-server process identifier; installers can check
	// liveness with os.FindProcess + signal 0.
	PID int `json:"pid"`
	// StartedAt is the server start time in RFC3339 format.
	StartedAt string `json:"started_at"`
	// Version is the openpe-server build version string, empty when unset.
	Version string `json:"version,omitempty"`
}

type Marker struct {
	Begin string
	End   string
}