eventlog

type EventEmitter interface {
	// EmitScraperEvent records a scraper-related event.
	// source identifies the scraper (e.g., "r18dev", "dmm").
	// message is a human-readable description.
	// severity is one of SeverityDebug/Info/Warn/Error.
	// context is optional structured detail (movie_id, url, error detail, etc).
	EmitScraperEvent(source, message, severity string, context map[string]interface{}) error

	// EmitOrganizeEvent records an organize-related event.
	// source identifies the operation stage (e.g., "file_move", "nfo_gen", "image_download").
	EmitOrganizeEvent(source, message, severity string, context map[string]interface{}) error

	// EmitSystemEvent records a system lifecycle event.
	// source identifies the subsystem (e.g., "server", "config", "database").
	EmitSystemEvent(source, message, severity string, context map[string]interface{}) error
}