research

type CompatibilityReport struct {
	Compatible      bool
	Issues          []string
	Recommendations []string
}

type CreateResearchUserOptions struct {
	FullName       string // Full name for the user (auto-generated from username if empty)
	Email          string // Email address for the user (auto-generated if empty)
	GenerateSSHKey bool   // Automatically generate SSH key pair
	ImportSSHKey   string // Import existing public key
	SSHKeyComment  string // Comment for imported SSH key
}

type DefaultKeyGenerator struct{}

type DualUserIntegration struct {
	Strategy          IntegrationStrategy `json:"strategy" yaml:"strategy"`
	PrimaryUser       string              `json:"primary_user" yaml:"primary_user"` // "research" or system user name
	SharedDirectories []string            `json:"shared_directories" yaml:"shared_directories"`
	ServiceOwnership  map[string]string   `json:"service_ownership" yaml:"service_ownership"` // service -> user mapping
}

type DualUserSystem struct {
	// System users (from template)
	SystemUsers []SystemUser `json:"system_users" yaml:"system_users"`

	// Research user (persistent across instances)
	ResearchUser *ResearchUserConfig `json:"research_user" yaml:"research_user"`

	// Integration settings
	PrimaryUser         string            `json:"primary_user" yaml:"primary_user"`                 // Which user gets primary access
	SharedDirectories   []string          `json:"shared_directories" yaml:"shared_directories"`     // Dirs shared between users
	EnvironmentHandling EnvironmentPolicy `json:"environment_handling" yaml:"environment_handling"` // How to merge environments
}

type EnvironmentPolicy string

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

type InstanceCompatibilityInfo struct {
	MinAvailableUID int
	MaxAvailableUID int
	SupportsEFS     bool
	HasSSHAccess    bool
	OSType          string
	KernelVersion   string
}

type IntegrationStrategy string

type KeyGenerator interface {
	GenerateKeyPair(keyType string, keySize int) (privateKey, publicKey []byte, err error)
	GetFingerprint(publicKey []byte) (string, error)
	ValidatePublicKey(publicKey []byte) error
}

type KeyStore interface {
	StorePublicKey(profileID, username, keyID string, publicKey []byte) error
	GetPublicKeys(profileID, username string) (map[string][]byte, error)
	DeletePublicKey(profileID, username, keyID string) error
	ListKeyFingerprints(profileID, username string) ([]string, error)
}

type ProfileManager interface {
	GetCurrentProfile() (string, error)
	GetProfileConfig(profileID string) (interface{}, error)
	UpdateProfileConfig(profileID string, config interface{}) error
}

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

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

type ProvisionInstanceRequest struct {
	// Instance information
	InstanceID   string
	InstanceName string
	PublicIP     string

	// Template information
	TemplateName string
	SystemUsers  []SystemUser

	// Research user
	Username string

	// EFS integration
	EFSVolumeID   string
	EFSMountPoint string

	// SSH connection
	SSHKeyPath string
	SSHUser    string
}

type ProvisioningJob struct {
	ID        string                    `json:"id"`
	Status    ProvisioningJobStatus     `json:"status"`
	StartTime time.Time                 `json:"start_time"`
	EndTime   *time.Time                `json:"end_time,omitempty"`
	Request   *UserProvisioningRequest  `json:"request"`
	Response  *UserProvisioningResponse `json:"response,omitempty"`
	Error     string                    `json:"error,omitempty"`
	Progress  float64                   `json:"progress"` // 0.0 to 1.0
}

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

type ProvisioningJobStatus string

type ResearchUserConfig struct {
	// Basic user information
	Username string `json:"username" yaml:"username"`
	UID      int    `json:"uid" yaml:"uid"` // Consistent across instances
	GID      int    `json:"gid" yaml:"gid"` // Primary group ID
	FullName string `json:"full_name" yaml:"full_name"`
	Email    string `json:"email" yaml:"email"`

	// Home directory configuration
	HomeDirectory string `json:"home_directory" yaml:"home_directory"`   // Path on EFS volume
	EFSVolumeID   string `json:"efs_volume_id" yaml:"efs_volume_id"`     // EFS volume for home dir
	EFSMountPoint string `json:"efs_mount_point" yaml:"efs_mount_point"` // Where EFS is mounted
	Shell         string `json:"shell" yaml:"shell"`                     // Default shell
	CreateHomeDir bool   `json:"create_home_dir" yaml:"create_home_dir"` // Auto-create home directory

	// SSH key management
	SSHPublicKeys     []string `json:"ssh_public_keys" yaml:"ssh_public_keys"`         // Authorized public keys
	SSHKeyFingerprint string   `json:"ssh_key_fingerprint" yaml:"ssh_key_fingerprint"` // Primary key fingerprint

	// Groups and permissions
	SecondaryGroups []string `json:"secondary_groups" yaml:"secondary_groups"` // Additional groups
	SudoAccess      bool     `json:"sudo_access" yaml:"sudo_access"`           // Sudo permissions
	DockerAccess    bool     `json:"docker_access" yaml:"docker_access"`       // Docker group access

	// Research environment preferences
	DefaultEnvironment map[string]string `json:"default_environment" yaml:"default_environment"` // Environment variables
	DotfileRepo        string            `json:"dotfile_repo" yaml:"dotfile_repo"`               // Git repo for dotfiles

	// Metadata
	CreatedAt    time.Time  `json:"created_at" yaml:"created_at"`
	LastUsed     *time.Time `json:"last_used" yaml:"last_used"`
	ProfileOwner string     `json:"profile_owner" yaml:"profile_owner"` // Profile that owns this user
}

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

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

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

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

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

type ResearchUserServiceConfig struct {
	ConfigDir  string         // Base configuration directory
	ProfileMgr ProfileManager // Profile manager interface
}

type ResearchUserStatus struct {
	Username          string     `json:"username"`
	InstanceID        string     `json:"instance_id"`
	InstanceName      string     `json:"instance_name"`
	HomeDirectoryPath string     `json:"home_directory_path"`
	EFSMounted        bool       `json:"efs_mounted"`
	SSHAccessible     bool       `json:"ssh_accessible"`
	LastLogin         *time.Time `json:"last_login"`
	ActiveProcesses   int        `json:"active_processes"`
	DiskUsage         int64      `json:"disk_usage"` // Bytes
}

type ResearchUserTemplate struct {
	// Auto-create research user if not exists
	AutoCreate bool `json:"auto_create" yaml:"auto_create"`

	// Research user defaults for this template
	DefaultShell       string            `json:"default_shell" yaml:"default_shell"`
	DefaultGroups      []string          `json:"default_groups" yaml:"default_groups"`
	DefaultEnvironment map[string]string `json:"default_environment" yaml:"default_environment"`

	// EFS integration
	RequireEFS          bool   `json:"require_efs" yaml:"require_efs"`
	EFSMountPoint       string `json:"efs_mount_point" yaml:"efs_mount_point"`
	EFSHomeSubdirectory string `json:"efs_home_subdirectory" yaml:"efs_home_subdirectory"`

	// SSH configuration
	InstallSSHKeys bool `json:"install_ssh_keys" yaml:"install_ssh_keys"`

	// Integration with system users
	UserIntegration DualUserIntegration `json:"user_integration" yaml:"user_integration"`
}

type SSHKeyConfig struct {
	KeyID         string     `json:"key_id"`
	ProfileID     string     `json:"profile_id"` // Which profile owns this key
	Username      string     `json:"username"`   // Username this key belongs to
	KeyType       SSHKeyType `json:"key_type"`   // Type of SSH key (rsa, ed25519)
	Fingerprint   string     `json:"fingerprint"`
	PublicKey     string     `json:"public_key"`
	Comment       string     `json:"comment"`
	CreatedAt     time.Time  `json:"created_at"`
	LastUsed      *time.Time `json:"last_used"`
	FromProfile   string     `json:"from_profile"`   // Which profile added this key
	AutoGenerated bool       `json:"auto_generated"` // Was this key auto-generated
}

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

type SSHKeyType string

type ScriptGenerationOptions struct {
	InstanceID      string
	InstanceName    string
	EFSVolumeID     string
	EFSMountPoint   string
	GenerateSSHKeys bool
}

type SystemUser struct {
	Name            string            `json:"name" yaml:"name"`
	UID             int               `json:"uid" yaml:"uid"` // May vary by instance
	GID             int               `json:"gid" yaml:"gid"`
	Groups          []string          `json:"groups" yaml:"groups"`
	Shell           string            `json:"shell" yaml:"shell"`
	HomeDirectory   string            `json:"home_directory" yaml:"home_directory"`
	Environment     map[string]string `json:"environment" yaml:"environment"`
	Purpose         string            `json:"purpose" yaml:"purpose"`                   // e.g., "jupyter", "system", "application"
	TemplateCreated bool              `json:"template_created" yaml:"template_created"` // Created by template vs system
}

type UIDGIDAllocation struct {
	ProfileID     string   `json:"profile_id"`
	Username      string   `json:"username"`
	UID           int      `json:"uid"`
	GID           int      `json:"gid"`
	AllocatedAt   int64    `json:"allocated_at"`
	LastUsed      int64    `json:"last_used"`
	InstancesUsed []string `json:"instances_used,omitempty"`
}

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

type UserIntegrationConfig struct {
	Strategy         UserIntegrationStrategy `json:"strategy"`
	PreserveExisting bool                    `json:"preserve_existing"`
	EnableSudo       bool                    `json:"enable_sudo"`
}

type UserIntegrationStrategy string

type UserProvisioningRequest struct {
	// Instance information
	InstanceID   string `json:"instance_id"`
	InstanceName string `json:"instance_name"`
	PublicIP     string `json:"public_ip"`

	// Template information
	TemplateName string       `json:"template_name"`
	SystemUsers  []SystemUser `json:"system_users"`

	// Research user to provision
	ResearchUser *ResearchUserConfig `json:"research_user"`

	// EFS integration
	EFSVolumeID   string `json:"efs_volume_id"`
	EFSMountPoint string `json:"efs_mount_point"`

	// SSH connection info
	SSHKeyPath string `json:"ssh_key_path"`
	SSHUser    string `json:"ssh_user"` // Initial user for connection (e.g., ubuntu)
}

type UserProvisioningResponse struct {
	Success          bool     `json:"success"`
	Message          string   `json:"message"`
	CreatedUsers     []string `json:"created_users"`
	ConfiguredEFS    bool     `json:"configured_efs"`
	SSHKeysInstalled bool     `json:"ssh_keys_installed"`
	ErrorDetails     string   `json:"error_details,omitempty"`
}