foxhunt/tli/proto/config.proto

syntax = "proto3";

package foxhunt.config;

// Configuration Service - SQLite-Based Configuration Management
service ConfigurationService {
  // Configuration CRUD operations
  rpc GetConfiguration(ConfigRequest) returns (ConfigResponse);
  rpc UpdateConfiguration(UpdateConfigRequest) returns (UpdateResponse);
  rpc DeleteConfiguration(DeleteConfigRequest) returns (DeleteResponse);
  rpc ListCategories(Empty) returns (CategoriesResponse);

  // Real-time configuration updates
  rpc StreamConfigChanges(Empty) returns (stream ConfigChangeResponse);

  // Configuration management
  rpc ValidateConfiguration(ValidateRequest) returns (ValidationResponse);
  rpc GetConfigurationHistory(HistoryRequest) returns (HistoryResponse);
  rpc RollbackConfiguration(RollbackRequest) returns (RollbackResponse);
  rpc ExportConfiguration(ExportRequest) returns (ExportResponse);
  rpc ImportConfiguration(ImportRequest) returns (ImportResponse);

  // Schema management
  rpc GetConfigSchema(SchemaRequest) returns (SchemaResponse);
  rpc UpdateConfigSchema(UpdateSchemaRequest) returns (UpdateSchemaResponse);

  // Environment management
  rpc GetActiveEnvironment(Empty) returns (EnvironmentResponse);
  rpc SwitchEnvironment(SwitchEnvironmentRequest) returns (SwitchEnvironmentResponse);
  rpc ListEnvironments(Empty) returns (EnvironmentsResponse);

  // Backup and restore
  rpc BackupConfiguration(BackupRequest) returns (BackupResponse);
  rpc RestoreConfiguration(RestoreRequest) returns (RestoreResponse);
}

// Configuration requests and responses
message ConfigRequest {
  repeated string keys = 1; // Empty to get all config
  optional string category = 2; // Filter by category
  optional string environment = 3; // Specific environment, default is active
  bool include_sensitive = 4; // Include encrypted/sensitive values
}

message ConfigResponse {
  repeated ConfigSetting settings = 1;
  string environment = 2;
  int64 version = 3;
  int64 last_updated_unix_nanos = 4;
}

message ConfigSetting {
  int64 id = 1;
  string category = 2;
  string key = 3;
  string value = 4;
  ConfigDataType data_type = 5;
  bool hot_reload = 6;
  string validation_rule = 7;
  string description = 8;
  string default_value = 9;
  bool required = 10;
  bool sensitive = 11;
  string environment_override = 12;
  optional double min_value = 13;
  optional double max_value = 14;
  repeated string enum_values = 15;
  repeated int64 depends_on = 16;
  repeated string tags = 17;
  int32 display_order = 18;
  int64 created_at_unix_nanos = 19;
  int64 modified_at_unix_nanos = 20;
}

message UpdateConfigRequest {
  repeated ConfigUpdate updates = 1;
  string changed_by = 2;
  string reason = 3;
  bool validate_before_update = 4;
}

message ConfigUpdate {
  string key = 1;
  string value = 2;
  optional string category = 3;
}

message UpdateResponse {
  bool success = 1;
  string message = 2;
  repeated string updated_keys = 3;
  repeated ValidationError validation_errors = 4;
  int64 new_version = 5;
}

message DeleteConfigRequest {
  repeated string keys = 1;
  string reason = 2;
  string deleted_by = 3;
}

message DeleteResponse {
  bool success = 1;
  string message = 2;
  repeated string deleted_keys = 3;
  repeated string failed_keys = 4;
}

message CategoriesResponse {
  repeated ConfigCategory categories = 1;
}

message ConfigCategory {
  int64 id = 1;
  string name = 2;
  string description = 3;
  optional int64 parent_id = 4;
  int32 display_order = 5;
  string icon = 6;
  int64 created_at_unix_nanos = 7;
  repeated ConfigCategory children = 8;
  int32 setting_count = 9;
}

// Real-time configuration streaming
message ConfigChangeResponse {
  ConfigChangeType change_type = 1;
  ConfigSetting setting = 2;
  string old_value = 3;
  string new_value = 4;
  string changed_by = 5;
  string reason = 6;
  int64 timestamp_unix_nanos = 7;
  bool hot_reload_applied = 8;
}

// Configuration validation
message ValidateRequest {
  repeated ConfigValidation validations = 1;
  bool check_dependencies = 2;
}

message ConfigValidation {
  string key = 1;
  string value = 2;
  optional string category = 3;
}

message ValidationResponse {
  bool valid = 1;
  repeated ValidationError errors = 2;
  repeated ValidationWarning warnings = 3;
}

message ValidationError {
  string key = 1;
  string message = 2;
  ValidationErrorType error_type = 3;
  string expected_format = 4;
}

message ValidationWarning {
  string key = 1;
  string message = 2;
  ValidationWarningType warning_type = 3;
}

// Configuration history
message HistoryRequest {
  optional string key = 1; // Specific key or all
  optional int64 start_time_unix_nanos = 2;
  optional int64 end_time_unix_nanos = 3;
  optional string changed_by = 4;
  uint32 limit = 5; // Default: 100
  uint32 offset = 6;
}

message HistoryResponse {
  repeated ConfigHistoryEntry entries = 1;
  uint32 total_count = 2;
}

message ConfigHistoryEntry {
  int64 id = 1;
  int64 setting_id = 2;
  string key = 3;
  string old_value = 4;
  string new_value = 5;
  string change_reason = 6;
  string changed_by = 7;
  int64 changed_at_unix_nanos = 8;
  string change_source = 9;
  string validation_result = 10;
  optional int64 rollback_id = 11;
}

// Configuration rollback
message RollbackRequest {
  oneof target {
    int64 history_entry_id = 1; // Rollback to specific change
    int64 timestamp_unix_nanos = 2; // Rollback to point in time
    int64 version = 3; // Rollback to version
  }
  string reason = 4;
  string rolled_back_by = 5;
  bool validate_before_rollback = 6;
}

message RollbackResponse {
  bool success = 1;
  string message = 2;
  repeated string rolled_back_keys = 3;
  int64 rollback_id = 4;
  int64 new_version = 5;
}

// Configuration export/import
message ExportRequest {
  repeated string categories = 1; // Empty for all
  repeated string keys = 2; // Specific keys
  string environment = 3; // Default: active
  ExportFormat format = 4;
  bool include_sensitive = 5;
  bool include_metadata = 6;
}

message ExportResponse {
  bytes data = 1;
  ExportFormat format = 2;
  string filename = 3;
  int32 setting_count = 4;
  int64 exported_at_unix_nanos = 5;
}

message ImportRequest {
  bytes data = 1;
  ExportFormat format = 2;
  ImportStrategy strategy = 3;
  string imported_by = 4;
  bool validate_before_import = 5;
  bool dry_run = 6;
}

message ImportResponse {
  bool success = 1;
  string message = 2;
  ImportSummary summary = 3;
  repeated ValidationError validation_errors = 4;
}

message ImportSummary {
  int32 total_settings = 1;
  int32 created_settings = 2;
  int32 updated_settings = 3;
  int32 skipped_settings = 4;
  int32 failed_settings = 5;
  repeated string created_keys = 6;
  repeated string updated_keys = 7;
  repeated string failed_keys = 8;
}

// Schema management
message SchemaRequest {
  optional string category = 1; // Specific category schema
}

message SchemaResponse {
  repeated ConfigSchema schemas = 1;
}

message ConfigSchema {
  string name = 1;
  string schema_definition = 2; // JSON schema
  string description = 3;
  int64 created_at_unix_nanos = 4;
}

message UpdateSchemaRequest {
  string name = 1;
  string schema_definition = 2;
  string description = 3;
}

message UpdateSchemaResponse {
  bool success = 1;
  string message = 2;
}

// Environment management
message EnvironmentResponse {
  ConfigEnvironment environment = 1;
}

message ConfigEnvironment {
  int64 id = 1;
  string name = 2;
  string description = 3;
  bool is_active = 4;
  int64 created_at_unix_nanos = 5;
  int32 override_count = 6;
}

message SwitchEnvironmentRequest {
  string environment_name = 1;
  string reason = 2;
  string switched_by = 3;
}

message SwitchEnvironmentResponse {
  bool success = 1;
  string message = 2;
  string old_environment = 3;
  string new_environment = 4;
  int32 settings_affected = 5;
}

message EnvironmentsResponse {
  repeated ConfigEnvironment environments = 1;
}

// Backup and restore
message BackupRequest {
  string backup_name = 1;
  string description = 2;
  repeated string categories = 3; // Empty for all
  bool include_history = 4;
  bool compress = 5;
}

message BackupResponse {
  bool success = 1;
  string message = 2;
  string backup_id = 3;
  string backup_path = 4;
  int64 backup_size_bytes = 5;
  int64 created_at_unix_nanos = 6;
}

message RestoreRequest {
  string backup_id = 1;
  RestoreStrategy strategy = 2;
  string restored_by = 3;
  bool validate_before_restore = 4;
}

message RestoreResponse {
  bool success = 1;
  string message = 2;
  RestoreSummary summary = 3;
}

message RestoreSummary {
  int32 total_settings = 1;
  int32 restored_settings = 2;
  int32 skipped_settings = 3;
  int32 failed_settings = 4;
  string backup_version = 5;
  int64 backup_created_at_unix_nanos = 6;
}

// Empty message for parameterless requests
message Empty {}

// Enums
enum ConfigDataType {
  CONFIG_DATA_TYPE_UNSPECIFIED = 0;
  CONFIG_DATA_TYPE_STRING = 1;
  CONFIG_DATA_TYPE_NUMBER = 2;
  CONFIG_DATA_TYPE_BOOLEAN = 3;
  CONFIG_DATA_TYPE_JSON = 4;
  CONFIG_DATA_TYPE_ENCRYPTED = 5;
}

enum ConfigChangeType {
  CONFIG_CHANGE_TYPE_UNSPECIFIED = 0;
  CONFIG_CHANGE_TYPE_CREATED = 1;
  CONFIG_CHANGE_TYPE_UPDATED = 2;
  CONFIG_CHANGE_TYPE_DELETED = 3;
  CONFIG_CHANGE_TYPE_ROLLBACK = 4;
}

enum ValidationErrorType {
  VALIDATION_ERROR_TYPE_UNSPECIFIED = 0;
  VALIDATION_ERROR_TYPE_REQUIRED = 1;
  VALIDATION_ERROR_TYPE_FORMAT = 2;
  VALIDATION_ERROR_TYPE_RANGE = 3;
  VALIDATION_ERROR_TYPE_ENUM = 4;
  VALIDATION_ERROR_TYPE_DEPENDENCY = 5;
  VALIDATION_ERROR_TYPE_CUSTOM = 6;
}

enum ValidationWarningType {
  VALIDATION_WARNING_TYPE_UNSPECIFIED = 0;
  VALIDATION_WARNING_TYPE_DEPRECATED = 1;
  VALIDATION_WARNING_TYPE_PERFORMANCE = 2;
  VALIDATION_WARNING_TYPE_SECURITY = 3;
  VALIDATION_WARNING_TYPE_COMPATIBILITY = 4;
}

enum ExportFormat {
  EXPORT_FORMAT_UNSPECIFIED = 0;
  EXPORT_FORMAT_JSON = 1;
  EXPORT_FORMAT_YAML = 2;
  EXPORT_FORMAT_TOML = 3;
  EXPORT_FORMAT_CSV = 4;
  EXPORT_FORMAT_SQL = 5;
}

enum ImportStrategy {
  IMPORT_STRATEGY_UNSPECIFIED = 0;
  IMPORT_STRATEGY_MERGE = 1;
  IMPORT_STRATEGY_REPLACE = 2;
  IMPORT_STRATEGY_UPDATE_ONLY = 3;
  IMPORT_STRATEGY_CREATE_ONLY = 4;
}

enum RestoreStrategy {
  RESTORE_STRATEGY_UNSPECIFIED = 0;
  RESTORE_STRATEGY_FULL_REPLACE = 1;
  RESTORE_STRATEGY_MERGE = 2;
  RESTORE_STRATEGY_SELECTIVE = 3;
}