feat: add lifecycle states for config-only resources (#2081)

* feat: add lifecycle status enums and deprecation RPCs to proto definitions

Add DataSourceStatus, ConnectionStatus, and RouteStatus enums with
ACTIVE/DEPRECATED states. Add DeprecateDataSource, DeprecateConnection,
and DeprecateRoute RPCs for config-only resource lifecycle management.

* feat: add database migrations for lifecycle status columns

Add status (VARCHAR DEFAULT 'ACTIVE') and deprecated_at columns to
data_source, provider_connections, and instruction_routes tables with
CHECK constraints and tenant-scoped indexes.

* feat: implement lifecycle states for market-information DataSource

Add ACTIVE/DEPRECATED status to DataSource domain model with Deprecate()
method, update persistence layer for status column, and add
DeprecateDataSource gRPC handler with idempotent deprecation semantics.

* feat: implement lifecycle states for operational-gateway resources

Add ACTIVE/DEPRECATED status to ProviderConnection and InstructionRoute
domain models with Deprecate() methods. Update persistence entities,
repositories, and gRPC handlers with DeprecateConnection and
DeprecateRoute endpoints. Update test DDL for new columns.

* chore: regenerate frontend TypeScript proto files

Update generated TypeScript protobuf files for new lifecycle status
enums and deprecation RPCs added to market-information and
operational-gateway protos.

* fix: add Deprecate method to mock SourceRepository in tests

The mock did not implement the new Deprecate interface method, causing
golangci-lint typecheck failures.

* fix: add DeprecateDataSource to event-router mock MDS client

The generated MarketInformationServiceClient interface gained the new
DeprecateDataSource RPC method, requiring mock implementations to match.

* fix: use domain constants in status parsers to satisfy goconst lint

Replace string literals with domain type constants in parseDataSetStatus
and parseDataSourceStatus to avoid repeated string occurrences.

* fix: add Deprecate to allowed repository method verbs

Lifecycle deprecation is a standard operation for config-only resources,
alongside Create/Find/Update/Delete.

* fix: add status and deprecated_at columns to test schema DDL

The market-information test helper schema.sql was missing the new
lifecycle columns, causing integration test failures.

* fix: add status columns to tenant-specific test schema DDL

The createSchemaDataSourceTable function for multi-tenant test schemas
was missing the new columns, causing column mismatch when copying data
sources from the public schema via SELECT *.

* fix: address review feedback - preserve lifecycle fields in builders

Critical fixes:
- Add deprecated_at to INSERT column list in Save (was missing, causing
  EXCLUDED.deprecated_at to always be NULL)
- Preserve status and deprecated_at in UpdateDataSource and
  DeactivateDataSource builders (zero-value status violated CHECK constraint)
- Add CHECK constraints to operational-gateway test DDL for parity
- Add idx_data_source_status to test schema to match production
- Update proto comment to document idempotent deprecation behavior

* fix: consolidate lifecycle field preservation in UpdateDataSource

Use WithDeprecatedAt directly in builder chain instead of conditional
block, reducing function size below 60-line threshold.

---------

Co-authored-by: Ben Coombs <bjcoombs@users.noreply.github.com>

Author: bjcoombs

api/proto/meridian/market_information/v1/market_information.pb.go

@@ -241,6 +241,16 @@ message MarketPriceObservation {
   repeated meridian.quantity.v1.AttributeEntry attributes = 14;
 }
 
+// DataSourceStatus defines the lifecycle state of a data source.
+enum DataSourceStatus {
+  // DATA_SOURCE_STATUS_UNSPECIFIED means the status is unknown.
+  DATA_SOURCE_STATUS_UNSPECIFIED = 0;
+  // DATA_SOURCE_STATUS_ACTIVE means the data source is available for use.
+  DATA_SOURCE_STATUS_ACTIVE = 1;
+  // DATA_SOURCE_STATUS_DEPRECATED means the data source is no longer recommended for new use.
+  DATA_SOURCE_STATUS_DEPRECATED = 2;
+}
+
 // DataSource represents a provider of market data.
 message DataSource {
   // id is the unique identifier for this data source (UUID).
@@ -270,13 +280,21 @@ message DataSource {
   }];
 
   // is_active indicates whether this source can provide new observations.
+  // Deprecated: Use status field instead. Kept for backward compatibility.
+  // Set to false when status is DEPRECATED.
   bool is_active = 6;
 
   // created_at is when this source was registered.
   google.protobuf.Timestamp created_at = 7 [(buf.validate.field).required = true];
 
   // updated_at is when this source was last updated.
   google.protobuf.Timestamp updated_at = 8;
+
+  // status is the lifecycle state of this data source.
+  DataSourceStatus status = 9 [(buf.validate.field).enum.defined_only = true];
+
+  // deprecated_at is when this data source was deprecated.
+  google.protobuf.Timestamp deprecated_at = 10;
 }
 
 // ========================================
@@ -436,6 +454,18 @@ service MarketInformationService {
     };
   }
 
+  // DeprecateDataSource transitions a data source from ACTIVE to DEPRECATED.
+  // Sets is_active to false for backward compatibility.
+  // Returns NOT_FOUND if data source doesn't exist.
+  // Idempotent: succeeds if the data source is already DEPRECATED.
+  // Returns FAILED_PRECONDITION only if the stored state is invalid.
+  rpc DeprecateDataSource(DeprecateDataSourceRequest) returns (DeprecateDataSourceResponse) {
+    option (google.api.http) = {
+      post: "/v1/market-information/sources/{code}/deprecate"
+      body: "*"
+    };
+  }
+
   // ListDataSources returns data sources matching the filter criteria.
   rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse) {
     option (google.api.http) = {
@@ -779,6 +809,22 @@ message DeactivateDataSourceResponse {
   DataSource source = 1;
 }
 
+// DeprecateDataSourceRequest transitions a data source from ACTIVE to DEPRECATED.
+message DeprecateDataSourceRequest {
+  // code identifies the data source to deprecate.
+  string code = 1 [(buf.validate.field).string = {
+    min_len: 1
+    max_len: 32
+    pattern: "^[A-Z][A-Z0-9_]*$"
+  }];
+}
+
+// DeprecateDataSourceResponse returns the deprecated data source.
+message DeprecateDataSourceResponse {
+  // source is the deprecated data source with status DEPRECATED.
+  DataSource source = 1;
+}
+
 // ListDataSourcesRequest specifies filtering for listing data sources.
 message ListDataSourcesRequest {
   // active_only returns only active data sources if true.