hephaestus

type AIError struct {
	Provider string
	Message  string
	Err      error
}

type CodeModification struct {
	TargetFile   string `json:"file_path"`
	OriginalCode string `json:"original_code"`
	ModifiedCode string `json:"updated_code"`
	StartLine    int    `json:"line_start"`
	EndLine      int    `json:"line_end"`
}

type ConfigValidationError struct {
	Field   string
	Message string
}

type ConfigurationValidationError struct {
	FieldName    string
	ErrorMessage string
}

type FileMetadataInfo struct {
	TotalLines   int                `json:"line_count"`
	Dependencies []string           `json:"imports"` // list of imports/dependencies
	VersionInfo  VersionControlInfo `json:"version_info"`
}

type GitHubError struct {
	Operation string
	Message   string
	Err       error
}

type InitializationResponse struct {
	OperationalStatus string `json:"status"`
	StatusMessage     string `json:"message"`
	NodeIdentifier    string `json:"node_id"`
}

type LogEntryData struct {
	NodeIdentifier string            `json:"node_id"`
	LogLevel       string            `json:"level"`
	LogMessage     string            `json:"message"`
	LogTimestamp   time.Time         `json:"timestamp"`
	LogMetadata    map[string]string `json:"metadata"`
	ErrorTrace     string            `json:"stack_trace"`
}

type LogProcessingError struct {
	NodeID  string
	Message string
	Err     error
}

type LogProcessingService interface {
	// ProcessLogEntry processes a single log entry
	ProcessLogEntry(ctx context.Context, entry *LogEntryData) error

	// StreamLogEntries initiates streaming of logs for a specific node
	StreamLogEntries(ctx context.Context, nodeIdentifier string) (<-chan *LogEntryData, <-chan error)
}

type LoggingConfiguration struct {
	LogLevel     string `json:"level" yaml:"level"`
	OutputFormat string `json:"format" yaml:"format"`
}

type MetricsCollectionService interface {
	// RecordOperationMetrics records metrics for an operation
	RecordOperationMetrics(operationName string, duration time.Duration, successful bool)

	// RecordErrorMetrics records error-related metrics
	RecordErrorMetrics(componentName string, err error)

	// GetCurrentMetrics retrieves current system metrics
	GetCurrentMetrics() map[string]interface{}
}

type ModelServiceConfiguration struct {
	ServiceProvider string `json:"provider" yaml:"provider"`
	ServiceAPIKey   string `json:"api_key" yaml:"api_key"`
	ModelVersion    string `json:"model_version" yaml:"model_version"`
}

type ModelServiceProvider interface {
	// GenerateSolutionProposal generates a solution for a given log entry
	GenerateSolutionProposal(ctx context.Context, entry *LogEntryData, repo RepositoryManager) (*ProposedSolution, error)

	// ValidateSolutionProposal validates a generated solution
	ValidateSolutionProposal(ctx context.Context, solution *ProposedSolution) error
}

type NodeError struct {
	NodeID  string
	Message string
	Err     error
}

type NodeLifecycleManager interface {
	// CreateSystemNode initializes a new node with the provided configuration
	CreateSystemNode(ctx context.Context, config *SystemConfiguration) (*SystemNode, error)

	// GetSystemNode retrieves node information by identifier
	GetSystemNode(ctx context.Context, nodeIdentifier string) (*SystemNode, error)

	// DeleteSystemNode removes a node from the system
	DeleteSystemNode(ctx context.Context, nodeIdentifier string) error

	// UpdateNodeOperationalStatus updates the operational status of a node
	UpdateNodeOperationalStatus(ctx context.Context, nodeIdentifier string, status NodeOperationalStatus) error
}

type NodeOperationalStatus string

type ProposedSolution struct {
	SolutionID      string        `json:"id"`
	NodeIdentifier  string        `json:"node_id"`
	AssociatedLog   *LogEntryData `json:"log_entry"`
	ProposedChanges string        `json:"suggestion"`
	AffectedFiles   []string      `json:"files"`
	GenerationTime  time.Time     `json:"created_at"`
	ConfidenceScore float64       `json:"confidence"`
}

type RemoteRepositoryConfiguration struct {
	AuthToken       string `json:"token" yaml:"token"`
	RepositoryOwner string `json:"owner" yaml:"owner"`
	RepositoryName  string `json:"repository" yaml:"repository"`
	TargetBranch    string `json:"branch" yaml:"branch"`
}

type RemoteRepositoryService interface {
	// CreateChangeRequest creates a change request for a proposed solution
	CreateChangeRequest(ctx context.Context, solution *ProposedSolution) (string, error)

	// SynchronizeRepository ensures local and remote repositories are in sync
	SynchronizeRepository(ctx context.Context) error
}

type RepositoryConfiguration struct {
	RepositoryPath string `json:"path" yaml:"path"`
	FileLimit      int    `json:"max_files" yaml:"max_files"`
	FileSizeLimit  int64  `json:"max_file_size" yaml:"max_file_size"`
}

type RepositoryError struct {
	Path    string
	Message string
	Err     error
}

type RepositoryFileNode struct {
	FileIdentifier string           `json:"id"`
	FilePath       string           `json:"path"` // relative to repo root
	FileContents   string           `json:"content"`
	FileLanguage   string           `json:"language"` // programming language
	LastModified   time.Time        `json:"last_updated"`
	FileMetadata   FileMetadataInfo `json:"metadata"`
}

type RepositoryManager interface {
	// InitializeRepository sets up the repository environment
	InitializeRepository(ctx context.Context, config *RepositoryConfiguration) error

	// GetFileContents retrieves contents of a specific file
	GetFileContents(ctx context.Context, filePath string) ([]byte, error)

	// UpdateFileContents updates the contents of a specific file
	UpdateFileContents(ctx context.Context, filePath string, contents []byte) error

	// ListRepositoryFiles lists all files in the repository
	ListRepositoryFiles(ctx context.Context) ([]string, error)
}

type SystemConfiguration struct {
	RemoteSettings     RemoteRepositoryConfiguration `json:"remote" yaml:"remote"`
	ModelSettings      ModelServiceConfiguration     `json:"model" yaml:"model"`
	LoggingSettings    LoggingConfiguration          `json:"log" yaml:"log"`
	OperationalMode    string                        `json:"mode" yaml:"mode"`
	RepositorySettings RepositoryConfiguration       `json:"repository" yaml:"repository"`
}

type SystemNode struct {
	NodeIdentifier string
	CurrentStatus  NodeOperationalStatus
	NodeConfig     *SystemConfiguration
	CreationTime   time.Time
	LastUpdateTime time.Time
}

type ValidationError struct {
	Object  string
	Field   string
	Message string
}

type VersionControlInfo struct {
	LastCommitHash string    `json:"last_commit"`
	LastCommitter  string    `json:"last_author"`
	CommitTime     time.Time `json:"last_commit_date"`
}

type VirtualRepositorySystem struct {
	RepositoryID    string                         `json:"id"`
	RemoteReference string                         `json:"remote_repo"`
	TargetBranch    string                         `json:"branch"`
	FileCollection  map[string]*RepositoryFileNode `json:"files"`
	LastSyncTime    time.Time                      `json:"last_synced"`
	SystemConfig    *SystemConfiguration           `json:"configuration"`
}