1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
//! Schema API surface.
//!
//! This module is organized into three layers:
//! - `query_contracts`: stable request/query DTO facade for schema endpoints
//! - `query_contracts::schema`: query DTOs for `/schema`
//! - `query_contracts::columns`: query DTOs for `/schema/columns`
//! - `query_contracts::constraints`: query DTOs for `/schema/constraints`
//! - `response_contracts`: stable response DTO facade for schema endpoints
//! - `response_contracts::clients`: client-list response DTO contracts
//! - `response_contracts::tables`: relation-table response DTO contracts
//! - `response_contracts::columns`: column response DTO contracts
//! - `response_contracts::constraints`: unique-constraint response DTO contracts
//! - `response_contracts::overview`: nested schema-overview response DTO contracts
//! - `routes`: route-group composition/registration
//! - `client_routes`: clients-list route registration
//! - `client_route_handlers`: clients-list HTTP handlers
//! - `client_response`: clients-list auth and response orchestration
//! - `catalog_routes`: schema-catalog route registration
//! - `catalog_route_handlers`: stable schema-catalog handler facade
//! - `catalog_route_handlers::overview`: `/schema` HTTP handler
//! - `catalog_route_handlers::tables`: `/schema/tables` HTTP handler
//! - `catalog_route_handlers::migrations`: `/schema/migrations` HTTP handler
//! - `catalog_route_handlers_query`: stable query-driven schema-catalog handler facade
//! - `catalog_route_handlers_query::columns`: `/schema/columns` HTTP handler
//! - `catalog_route_handlers_query::constraints`: `/schema/constraints` HTTP handler
//! - `catalog_route_context`: shared schema-catalog request context helpers
//! - `catalog_service_loader`: stable non-query schema-catalog loader facade
//! - `catalog_service_loader::overview`: `/schema` loader orchestration
//! - `catalog_service_loader::tables`: `/schema/tables` loader orchestration
//! - `catalog_service_loader_query`: stable query-driven schema-catalog loader facade
//! - `catalog_service_loader_query::columns`: `/schema/columns` loader orchestration
//! - `catalog_service_loader_query::constraints`: `/schema/constraints` loader orchestration
//! - `catalog_responses`: stable non-query schema-catalog response facade
//! - `catalog_responses::overview`: `/schema` response orchestration
//! - `catalog_responses::tables`: `/schema/tables` response orchestration
//! - `catalog_responses_query`: stable query-driven schema-catalog response facade
//! - `catalog_responses_query::columns`: `/schema/columns` response orchestration
//! - `catalog_responses_query::constraints`: `/schema/constraints` response orchestration
//! - `catalog_migration_error_mapper`: stable facade over `/schema/migrations` compatibility error mapping modules
//! - `catalog_migration_error_mapper::sqlstate`: SQLSTATE extraction/classification for migration compatibility policy
//! - `catalog_migration_error_mapper::compatibility_response`: compatibility response shaping for missing migration tracking
//! - `catalog_migration_loader`: `/schema/migrations` loader orchestration
//! - `catalog_migration_response`: `/schema/migrations` response orchestration
//! - `context_auth`: stable facade over shared auth/rate-limit context helpers
//! - `context_auth::gateway_read`: gateway/admin read-right authorization policy
//! - `context_auth::inbound_rate_limit`: optional inbound schema-route throttling policy
//! - `context_pool_resolver`: stable facade over request/logging client-pool resolver helpers
//! - `context_pool_resolver::request_client`: request-scoped authenticated schema client/pool resolution
//! - `context_pool_resolver::logging_client`: configured logging client/pool resolution for debug services
//! - `schema_backend`: backend resolution facade for schema routes
//! - `schema_d1`: D1 schema-introspection helpers and SQLite metadata mapping
//! - `identifier_validation`: schema/table identifier query validation helpers
//! - `service`: stable schema-query fetch facade
//! - `service_catalog_fetch_relations`: stable facade over catalog relation fetch-execution modules
//! - `service_catalog_fetch_relations::schema_filters`: schema-scoped catalog relation fetch execution
//! - `service_catalog_fetch_relations::catalog_filters`: unscoped catalog relation fetch execution
//! - `service_catalog_fetch_columns`: stable facade over catalog column fetch-execution modules
//! - `service_catalog_fetch_columns::schema_filters`: schema-scoped catalog column fetch execution
//! - `service_catalog_fetch_columns::table_filters`: table-scoped catalog column fetch execution
//! - `service_catalog_fetch_columns::catalog_filters`: unscoped catalog column fetch execution
//! - `service_catalog_fetch_constraints`: unique-constraint fetch execution for schema catalog introspection
//! - `service_catalog_fetch`: stable catalog-fetch facade for relations/columns/constraints
//! - `service_migration_fetch`: migration-table fetch execution
//! - `service_contracts_catalog`: stable facade over catalog row-contract modules
//! - `service_contracts_catalog::relations`: relation row-contract structs shared across schema modules
//! - `service_contracts_catalog::columns`: column row-contract structs shared across schema modules
//! - `service_contracts_catalog::constraints`: unique-constraint row-contract structs shared across schema modules
//! - `service_contracts_migration`: migration row-contract structs shared across schema modules
//! - `service_contracts`: stable row-contract facade across schema modules
//! - `service_queries_catalog_relations`: stable facade over catalog relation query-selector modules
//! - `service_queries_catalog_relations::schema_filters`: schema-scoped raw SQL for catalog relation queries
//! - `service_queries_catalog_relations::catalog_filters`: unscoped catalog-scan raw SQL for relation queries
//! - `service_queries_catalog_columns`: stable facade over catalog column query-selector modules
//! - `service_queries_catalog_columns::schema_filters`: schema-scoped raw SQL for catalog column queries
//! - `service_queries_catalog_columns::table_filters`: table-scoped raw SQL for catalog column queries
//! - `service_queries_catalog_columns::catalog_filters`: unscoped catalog-scan raw SQL for column queries
//! - `service_queries_catalog_constraints`: raw SQL for catalog unique-constraint queries
//! - `service_queries_catalog`: stable facade over catalog query-selector modules
//! - `service_queries_migration`: raw SQL definitions for migration-table queries
//! - `service_queries`: stable query-selector facade for schema service queries
//! - `service_row_mapper_catalog`: stable facade over catalog row-mapper modules
//! - `service_row_mapper_catalog::relations`: relation SQLx row-to-contract mapping
//! - `service_row_mapper_catalog::columns`: column SQLx row-to-contract mapping
//! - `service_row_mapper_catalog::constraints`: unique-constraint SQLx row-to-contract mapping
//! - `service_row_mapper_migration`: migration SQLx row-to-contract mapping
//! - `service_row_mapper`: stable row-mapper facade for schema service queries
//! - `catalog_errors`: schema-catalog error/response mapping helpers
//! - `debug_snapshot`: logging-schema catalog snapshot fetch orchestration
//! - `debug_snapshot_contracts`: shared snapshot row/result contracts
//! - `debug_snapshot_error`: snapshot fetch error contracts reused across debug modules
//! - `debug_snapshot_output_assembly`: final snapshot payload assembly from raw relation/column rows
//! - `debug_snapshot_result_assembly`: snapshot-row result to snapshot payload result assembly
//! - `debug_snapshot_stage_contracts`: staged snapshot payload contracts from snapshot-row fetch results
//! - `debug_snapshot_stage_input_assembly`: typed stage-input payload assembly from snapshot-row fetch results
//! - `debug_snapshot_stage_input_contracts`: typed stage-input contracts for snapshot staged payload assembly
//! - `debug_snapshot_stage_output_assembly`: staged snapshot payload assembly from snapshot-row fetch results
//! - `debug_snapshot_from_stage_output_assembly`: stable final handoff facade from staged snapshot payloads
//! - `debug_snapshot_stage_output_handoff_assembly`: final staged snapshot handoff assembly into snapshot-result mapping
//! - `debug_snapshot_stage_output_rows_result_handoff_assembly`: staged snapshot rows-result handoff assembly into snapshot-result mapping
//! - `debug_snapshot_stage_output_contract_handoff_assembly`: staged snapshot contract handoff assembly from staged payload parts into snapshot-result mapping
//! - `debug_snapshot_stage_handoff_test_helpers`: shared staged snapshot handoff fixtures and assertions for `/debug/schema` snapshot stage tests
//! - `debug_snapshot_stage_output_assertion_test_helpers`: shared stage-output assertions for `/debug/schema` snapshot stage-output module tests
//! - `debug_snapshot_query_relations`: relation-row fetch helpers for debug snapshots
//! - `debug_snapshot_query_columns`: column-row fetch helpers for debug snapshots
//! - `debug_snapshot_query_error_mapper`: snapshot-query SQL-error to snapshot-contract mapping
//! - `debug_snapshot_queries_output_assembly`: snapshot row-contract assembly from fetched relation/column rows
//! - `debug_snapshot_queries_output_input_contracts`: typed input contracts for snapshot-query row output assembly
//! - `debug_snapshot_queries_result_assembly`: relation/column query result to snapshot-row result assembly
//! - `debug_snapshot_queries_result_assembly_input_contracts`: typed input contracts for snapshot-query result assembly
//! - `debug_snapshot_queries_result_output_handoff_assembly`: snapshot-query successful relation/column rows handoff assembly into snapshot-row contract output
//! - `debug_snapshot_queries_result_output_handoff_input_contracts`: typed input contracts for snapshot-query result-output handoff assembly
//! - `debug_snapshot_queries_stage_contracts`: staged snapshot-query payload contracts from relation/column query results
//! - `debug_snapshot_queries_stage_input_contracts`: typed stage-input contracts for snapshot-query staging
//! - `debug_snapshot_queries_stage_input_assembly`: typed stage-input payload assembly from relation/column query results
//! - `debug_snapshot_queries_stage_output_assembly`: staged snapshot-query payload assembly from relation/column query results
//! - `debug_snapshot_queries_from_stage_output_assembly`: stable final handoff facade from staged snapshot-query payloads
//! - `debug_snapshot_queries_stage_output_handoff_assembly`: final staged snapshot-query handoff assembly into snapshot-row result mapping
//! - `debug_snapshot_queries_stage_output_query_results_handoff_assembly`: staged snapshot-query relation/column results handoff assembly into snapshot-row result mapping
//! - `debug_snapshot_queries_stage_output_contract_handoff_assembly`: staged snapshot-query contract handoff assembly from staged payload parts into snapshot-row result mapping
//! - `debug_snapshot_error_test_fixtures`: shared snapshot-error fixtures for `/debug/schema` test modules
//! - `debug_snapshot_error_assertions_test_helpers`: shared `FetchRelations`/`FetchColumns` snapshot-error variant assertions for test modules
//! - `debug_snapshot_queries_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` snapshot-query module tests
//! - `debug_snapshot_queries_test_helpers`: shared relation/column row fixtures and assertions for `/debug/schema` snapshot-query tests
//! - `debug_snapshot_queries`: snapshot query-orchestration facade
//! - `debug_contracts`: `/debug/schema` response contract structs
//! - `debug_service`: `/debug/schema` report-loading service orchestration
//! - `debug_service_error`: `/debug/schema` report-loading service error contracts
//! - `debug_service_error_mapper`: `/debug/schema` service-layer error mapping helpers
//! - `debug_service_resolver`: logging-client/pool resolution for debug services
//! - `debug_service_loader`: per-client debug report loading from resolved pools
//! - `debug_service_loader_input_contracts`: typed input contracts for per-client debug report loading orchestration
//! - `debug_service_loader_stage_input_assembly`: typed stage-input payload assembly from client identity and snapshot results
//! - `debug_service_loader_stage_input_contracts`: typed stage-input contracts for service-loader staging
//! - `debug_service_loader_stage_contracts`: staged service-loader payload contracts from client identity and snapshot results
//! - `debug_service_loader_stage_output_assembly`: staged service-loader payload assembly from client identity and snapshot results
//! - `debug_service_loader_from_stage_output_assembly`: stable final handoff facade from staged service-loader payloads
//! - `debug_service_loader_stage_output_handoff_assembly`: final staged service-loader handoff assembly into report-result mapping
//! - `debug_service_loader_stage_output_result_handoff_assembly`: staged service-loader report-result handoff assembly from client name/snapshot result
//! - `debug_service_loader_stage_output_contract_handoff_assembly`: staged service-loader contract handoff assembly from staged payload parts into report-result mapping
//! - `debug_service_loader_result_assembly`: per-client snapshot-result to report-result assembly
//! - `debug_service_loader_result_assembly_input_contracts`: typed input contracts for per-client snapshot-result to report-result assembly
//! - `debug_service_loader_output_assembly`: final debug report payload assembly from fetched snapshots
//! - `debug_service_loader_output_input_contracts`: typed input contracts for final debug report payload assembly from fetched snapshots
//! - `debug_service_loader_output_report_input_assembly`: typed top-level report-builder input assembly from service-loader output payloads
//! - `debug_service_loader_test_helpers`: shared staged fixture and error-assertion helpers for `/debug/schema` service-loader tests
//! - `debug_service_loader_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` service-loader module tests
//! - `debug_service_result_assembly`: per-client report result to service-layer report result assembly
//! - `debug_service_result_stage_contracts`: staged service-result payload contracts from per-client report-loader results
//! - `debug_service_result_stage_input_assembly`: typed stage-input payload assembly from per-client report-loader results
//! - `debug_service_result_stage_input_contracts`: typed stage-input contracts for service-result staged payload assembly
//! - `debug_service_result_stage_output_assembly`: staged service-result payload assembly from per-client report-loader results
//! - `debug_service_result_from_stage_output_assembly`: stable final handoff facade from staged service-result payloads
//! - `debug_service_result_stage_output_error_handoff_assembly`: staged service-result fetch-error handoff assembly into service-layer report errors
//! - `debug_service_result_stage_output_handoff_assembly`: final staged service-result handoff assembly into service-layer report-result mapping
//! - `debug_service_result_stage_output_contract_handoff_assembly`: staged service-result contract handoff assembly from staged payload parts into service-layer report-result mapping
//! - `debug_service_result_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` service-result module tests
//! - `debug_service_result_test_helpers`: shared success/error-variant assertions for `/debug/schema` service-result tests
//! - `debug_service_result_stage_test_helpers`: shared staged report-result fixtures for `/debug/schema` service-result stage tests
//! - `debug_service_stage_test_helpers`: shared staged-pool fixtures for `/debug/schema` service-stage tests
//! - `debug_service_stage_output_assertion_test_helpers`: shared stage-output assertions for `/debug/schema` service-loader, service-result, and service-stage output module tests
//! - `debug_service_stage_contracts`: staged service payload contracts from resolver output
//! - `debug_service_stage_input_contracts`: typed stage-input contracts for service-layer staged payload assembly
//! - `debug_service_stage_input_assembly`: typed stage-input payload assembly from resolver output tuples
//! - `debug_service_stage_output_assembly`: staged service payload assembly from resolved logging-client/pool data
//! - `debug_service_from_stage_output_assembly`: stable final handoff facade from staged service payloads
//! - `debug_service_stage_output_loader_result_handoff_assembly`: staged service loader-result handoff assembly from client name/pool into service-layer report results
//! - `debug_service_stage_output_loader_result_handoff_input_contracts`: typed input contracts for staged service loader-result handoff assembly
//! - `debug_service_stage_output_handoff_assembly`: final staged service handoff assembly into per-client loading and service-result mapping
//! - `debug_service_stage_output_contract_handoff_assembly`: staged service contract handoff assembly from staged payload parts into service-layer report results
//! - `debug_service_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` service-stage module tests
//! - `debug_response_mapper`: `/debug/schema` service-error to HTTP response mapper
//! - `debug_response_mapper_service_error_variants`: service-error variant response mapping helpers
//! - `debug_response_output_assembly`: `/debug/schema` success-response payload assembly
//! - `debug_response_result_assembly`: `/debug/schema` report-result to HTTP response assembly
//! - `debug_response_result_error_handoff_assembly`: `/debug/schema` report-result error handoff assembly into route-ready error responses
//! - `debug_response_test_helpers`: shared response-body parsing and error-envelope assertions for `/debug/schema` tests
//! - `debug_response_stage_test_helpers`: shared staged response/service-error fixtures for `/debug/schema` response tests
//! - `debug_response_stage_handoff_test_helpers`: shared staged response handoff assertions for `/debug/schema` response-stage tests
//! - `debug_response_stage_contracts`: staged response payload contracts from report-loading service results
//! - `debug_response_stage_input_assembly`: typed stage-input payload assembly from report-loading service results
//! - `debug_response_stage_input_contracts`: typed stage-input contracts for staged response payload assembly
//! - `debug_response_stage_output_assembly`: staged response payload assembly from report-loading service results
//! - `debug_response_stage_output_result_handoff_assembly`: staged response report-result handoff assembly into route-ready responses
//! - `debug_response_from_stage_output_assembly`: stable final handoff facade from staged response payloads
//! - `debug_response_stage_output_handoff_assembly`: final staged response handoff assembly into route-ready HTTP responses
//! - `debug_response_stage_output_contract_handoff_assembly`: staged response contract handoff assembly from staged payload parts into route-ready HTTP responses
//! - `debug_response`: `/debug/schema` response orchestration
//! - `debug_errors`: `/debug/schema` snapshot-error mapping helpers
//! - `debug_errors_snapshot_fetch_variants`: snapshot-fetch variant error mapping helpers
//! - `debug_snapshot_fetch_error_response_test_helpers`: shared snapshot-fetch error response assertions for `/debug/schema` error-mapper tests
//! - `logging_expectation_contracts`: expected logging-table/column contract type
//! - `logging_expectation_tables_gateway`: gateway-domain expected logging-table/column catalog
//! - `logging_expectation_tables_gateway_request`: stable facade over gateway request-telemetry expected logging-table/column modules
//! - `logging_expectation_tables_gateway_request::request_log`: expected request-level telemetry sink contract
//! - `logging_expectation_tables_gateway_request::operation_log`: expected operation-level telemetry sink contract
//! - `logging_expectation_tables_gateway_request::route_request_log`: expected optional route-level telemetry sink contract
//! - `logging_expectation_tables_gateway_runtime`: stable facade over gateway runtime-control expected logging-table/column modules
//! - `logging_expectation_tables_gateway_runtime::connection_registry`: expected realtime connection-registry table contract
//! - `logging_expectation_tables_gateway_runtime::deferred_queue`: expected deferred request-queue table contract
//! - `logging_expectation_tables_gateway_runtime::admission_events`: expected admission-event table contract
//! - `logging_expectation_tables_gateway_routing`: stable facade over gateway routing expected logging-table/column modules
//! - `logging_expectation_tables_gateway_routing::api_registry`: expected API registry table contract
//! - `logging_expectation_tables_gateway_routing::public_routes`: expected public gateway-route registry table contract
//! - `logging_expectation_tables_client`: stable facade over client-domain expected logging-table/column catalog modules
//! - `logging_expectation_tables_client::statistics`: expected client/table statistics table contracts
//! - `logging_expectation_tables_client::catalog`: expected client registry/config table contracts
//! - `logging_expectation_tables_network`: stable facade over network-domain expected logging-table/column modules
//! - `logging_expectation_tables_network::ip_catalog`: expected normalized IP catalog table contract
//! - `logging_expectation_tables_network::ip_statistics`: expected per-IP request statistics table contract
//! - `logging_expectation_tables`: expected logging-table/column catalog
//! - `debug_route`: `/debug/schema` route registration
//! - `debug_route_handler_auth_gate`: `/debug/schema` handler request authorization policy
//! - `debug_route_handler_output_handoff_assembly`: `/debug/schema` handler response-handoff assembly after auth
//! - `debug_route_handler`: `/debug/schema` HTTP handler flow orchestration
//! - `debug_observed_table_contracts`: observed-table diagnostics payload/map contracts
//! - `debug_observed_table_relation_key`: relation-key generation policy for observed tables
//! - `debug_observed_table_relation_type_normalization`: relation-type normalization policy for observed tables
//! - `debug_observed_table_keys`: stable observed-table key helper facade
//! - `debug_observed_relations`: observed relation-row seeding and normalization policy
//! - `debug_observed_table_builder_input_assembly`: typed observed-table builder input assembly from snapshot relation and column rows
//! - `debug_observed_table_builder_input_contracts`: typed input contracts for observed-table map builder orchestration
//! - `debug_observed_table_builder`: observed relation/column map builder for debug report input
//! - `debug_observed_columns`: observed-column map attachment/dedup/sort helpers
//! - `debug_observed_tables`: stable observed-table diagnostics facade
//! - `debug_table_comparison_contracts`: expected-vs-observed table comparison contracts
//! - `debug_table_comparison_relation`: relation-type comparison policy for expected-vs-observed tables
//! - `debug_table_comparison_column_delta_contracts`: column-delta contracts for expected-vs-observed tables
//! - `debug_table_comparison_columns_builder`: column-delta comparison policy for expected-vs-observed tables
//! - `debug_table_comparison_missing_columns_builder`: missing-column delta policy for expected-vs-observed tables
//! - `debug_table_comparison_unexpected_columns_builder`: unexpected-column delta policy for expected-vs-observed tables
//! - `debug_table_comparison_columns`: stable column-delta comparison facade
//! - `debug_table_comparison_output_assembly`: final table-comparison payload assembly
//! - `debug_table_comparison`: expected-vs-observed relation/column delta helpers
//! - `debug_evaluation_contracts`: expected-table status and counter contracts
//! - `debug_evaluation_present_counters`: present-table comparison counter mutation policy
//! - `debug_evaluation_present`: present-table mutation policy for expected-table evaluation
//! - `debug_evaluation_missing_counters`: missing-table counter mutation policy
//! - `debug_evaluation_missing`: missing-table mutation policy for expected-table evaluation
//! - `debug_evaluation_status_present_builder`: status-row assembly for discovered expected tables
//! - `debug_evaluation_status_missing_builder`: status-row assembly for missing expected tables
//! - `debug_evaluation_status_builder`: stable expected-table status-row builder facade
//! - `debug_evaluation_accumulator`: expected-table counter/payload mutation helpers
//! - `debug_evaluation`: shared expected-table evaluation import surface
//! - `debug_expected_tables_row_stage`: one expected-table row evaluation stage from observed-table diagnostics input
//! - `debug_expected_tables_iteration_stage`: expected-table contract iteration stage for evaluation output
//! - `debug_expected_tables`: expected-vs-observed table/column evaluation helpers
//! - `debug_health`: overall debug-health classification from evaluation counters
//! - `debug_health_threshold_policy`: required-missing threshold policy for unhealthy escalation
//! - `debug_health_assessment_contracts`: composed health-assessment contract for summary assembly
//! - `debug_health_assessment_output_assembly`: final health-assessment payload assembly from health label and reasons
//! - `debug_health_assessment_stage_contracts`: staged health-assessment payload contracts from health/reason derivation
//! - `debug_health_assessment_stage_input_assembly`: typed stage-input payload assembly from summary diagnostics metrics
//! - `debug_health_assessment_stage_input_contracts`: typed stage-input contracts for health-assessment staged payload assembly
//! - `debug_health_assessment_stage_output_assembly`: staged health-assessment payload assembly from summary metrics
//! - `debug_health_assessment_from_stage_output_assembly`: stable final handoff facade from staged health-assessment payloads
//! - `debug_health_assessment_stage_output_handoff_assembly`: final staged health-assessment handoff assembly into assessment output
//! - `debug_health_assessment_stage_output_contract_handoff_assembly`: staged health-assessment contract handoff assembly from staged payload parts into assessment output
//! - `debug_health_assessment_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` health-assessment module tests
//! - `debug_health_assessment_builder`: health-assessment orchestration from summary metrics
//! - `debug_health_assessment`: stable health-assessment facade
//! - `debug_health_reasons_specs`: deterministic health-reason specification catalog
//! - `debug_health_reasons_metric_reader`: summary-metrics count selection for health reasons
//! - `debug_health_reasons_entry_builder`: reason-row shaping from specs and counts
//! - `debug_health_reasons_stage_contracts`: staged health-reasons payload contracts from nonzero reason collection
//! - `debug_health_reasons_stage_input_assembly`: typed stage-input payload assembly from summary diagnostics metrics
//! - `debug_health_reasons_stage_input_contracts`: typed stage-input contracts for health-reasons staged payload assembly
//! - `debug_health_reasons_stage_output_assembly`: staged health-reasons payload assembly from summary metrics
//! - `debug_health_reasons_from_stage_output_assembly`: stable final handoff facade from staged health-reasons payloads
//! - `debug_health_reasons_stage_output_handoff_assembly`: final staged health-reasons handoff assembly into output reasons
//! - `debug_health_reasons_stage_output_contract_handoff_assembly`: staged health-reasons contract handoff assembly from staged payload parts into output reasons
//! - `debug_health_reasons_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` health-reasons module tests
//! - `debug_health_reasons_builder`: health-reason orchestration from specs and metrics
//! - `debug_health_reasons`: stable health-reason facade
//! - `debug_health_stage_test_fixtures`: shared health-stage test fixtures for summary metrics, reason rows, and staged payloads
//! - `debug_summary_contracts`: `/debug/schema` aggregate summary payload contracts
//! - `debug_summary_metrics_contracts`: aggregate summary-metrics contracts
//! - `debug_summary_test_fixtures`: shared expected-table status fixtures for summary-layer tests
//! - `debug_summary_metrics_found_table_count_builder`: found-table count extraction from expected-table evaluation rows
//! - `debug_summary_metrics_still_needed_counts_builder`: canonical still-needed count extraction for summary metrics
//! - `debug_summary_metrics_builder_stage_contracts`: staged summary-metrics payload contracts from found-table and still-needed count derivation
//! - `debug_summary_metrics_builder_stage_input_assembly`: typed stage-input payload assembly from expected-table evaluation and still-needed aggregates
//! - `debug_summary_metrics_builder_stage_input_contracts`: typed stage-input contracts for summary-metrics staged payload assembly
//! - `debug_summary_metrics_builder_stage_output_assembly`: staged summary-metrics payload assembly from expected-table evaluation and still-needed aggregates
//! - `debug_summary_metrics_builder_stage_output_handoff_assembly`: final staged summary-metrics handoff assembly into metrics contracts
//! - `debug_summary_metrics_builder_stage_output_contract_handoff_assembly`: staged summary-metrics contract handoff assembly from staged payload parts into metrics contracts
//! - `debug_summary_metrics_from_builder_stage_output_assembly`: stable final handoff facade from staged summary-metrics payloads
//! - `debug_summary_metrics_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` summary-metrics module tests
//! - `debug_summary_metrics_builder`: aggregate count extraction policy for debug summary assembly
//! - `debug_summary_metrics`: stable summary-metrics facade
//! - `debug_summary_stage_output_assertion_test_helpers`: shared stage-output assertions for `/debug/schema` summary-builder and summary-metrics stage-output module tests
//! - `debug_summary_builder_stage_contracts`: staged summary-builder payload contracts
//! - `debug_summary_builder_stage_input_assembly`: typed stage-input payload assembly from expected-table counts, summary metrics, and health assessment
//! - `debug_summary_builder_stage_input_contracts`: typed stage-input contracts for summary-builder staged payload assembly
//! - `debug_summary_builder_stage_output_assembly`: staged summary-builder payload assembly from metrics and health assessment
//! - `debug_summary_builder_stage_output_handoff_assembly`: final staged summary-builder handoff assembly into summary output mapping
//! - `debug_summary_builder_stage_output_contract_handoff_assembly`: staged summary-builder contract handoff assembly from staged payload parts into summary output mapping
//! - `debug_summary_from_builder_stage_output_assembly`: stable final handoff facade from staged summary-builder payloads
//! - `debug_summary_builder_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` summary-builder module tests
//! - `debug_summary_output_assembly`: final summary payload assembly from metrics and health assessment
//! - `debug_summary_builder`: summary orchestration for debug report payloads
//! - `debug_summary`: stable summary facade for debug report payloads
//! - `debug_still_needed_contracts`: `/debug/schema` unresolved-requirement payload contracts
//! - `debug_still_needed`: unresolved expected-vs-observed requirement aggregation helpers
//! - `debug_still_needed_output_assembly`: final still-needed payload assembly from normalized unresolved lists
//! - `debug_still_needed_sorted_keys`: deterministic key sorting/dedup for still-needed output
//! - `debug_still_needed_missing_tables`: missing-table key aggregation for still-needed output
//! - `debug_still_needed_missing_columns`: missing-column key aggregation for still-needed output
//! - `debug_still_needed_relation_mismatches`: relation-type mismatch key aggregation for still-needed output
//! - `debug_legacy_missing_tables_contracts`: compatibility payload contracts for legacy top-level missing-table fields
//! - `debug_legacy_missing_tables_builder`: compatibility adapter from canonical still-needed tables to legacy top-level missing-table fields
//! - `debug_legacy_missing_tables`: stable legacy missing-table adapter facade
//! - `debug_report_components`: intermediate diagnostics pipeline staging for debug report assembly
//! - `debug_report_components_contracts`: staged diagnostics component contracts
//! - `debug_report_components_builder`: staged diagnostics assembly from observed rows
//! - `debug_report_components_builder_input_assembly`: typed report-components builder input assembly from relation/column rows
//! - `debug_report_components_builder_input_contracts`: typed input contracts for report-components builder orchestration
//! - `debug_report_components_builder_stage_input_assembly`: typed builder-stage input payload assembly for report-components builder orchestration
//! - `debug_report_components_builder_stage_input_contracts`: typed stage-input contracts for report-components builder staging
//! - `debug_report_components_builder_stage_contracts`: staged report-components builder payload contracts from observed/evaluated diagnostics
//! - `debug_report_components_builder_stage_output_assembly`: staged report-components builder payload assembly from observed/evaluated diagnostics
//! - `debug_report_components_builder_stage_output_handoff_assembly`: final staged report-components builder handoff assembly into intermediate component output
//! - `debug_report_components_builder_stage_output_contract_handoff_assembly`: staged report-components builder contract handoff assembly from staged payload parts into intermediate component output
//! - `debug_report_components_from_builder_stage_output_assembly`: stable final handoff facade from staged builder payloads into intermediate component output
//! - `debug_report_components_builder_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` report-components builder module tests
//! - `debug_report_components_observed_stage`: staged observed-table map composition from relation/column inputs
//! - `debug_report_components_observed_stage_input_assembly`: typed observed-stage input payload assembly from relation/column rows
//! - `debug_report_components_observed_stage_input_contracts`: typed stage-input contracts for observed-map stage composition
//! - `debug_report_components_evaluation_stage`: staged expected-table evaluation and still-needed aggregation
//! - `debug_report_components_evaluation_stage_contracts`: staged expected-table evaluation contract payload
//! - `debug_report_components_evaluation_stage_input_assembly`: typed stage-input payload assembly from expected-table evaluation and still-needed aggregation
//! - `debug_report_components_evaluation_stage_input_contracts`: typed stage-input contracts for staged expected-table evaluation assembly
//! - `debug_report_components_evaluation_stage_output_assembly`: staged expected-table evaluation payload assembly
//! - `debug_report_components_evaluation_from_stage_output_assembly`: stable final handoff facade from staged expected-table evaluation payloads
//! - `debug_report_components_evaluation_stage_output_handoff_assembly`: final staged expected-table evaluation handoff assembly
//! - `debug_report_components_evaluation_stage_output_contract_handoff_assembly`: staged expected-table evaluation contract handoff assembly from staged payload parts into final evaluation-stage output
//! - `debug_report_components_evaluation_stage_handoff_test_helpers`: shared stage-output handoff assertions for `/debug/schema` report-components evaluation module tests
//! - `debug_report_components_stage_output_assertion_test_helpers`: shared stage-output assertions for `/debug/schema` report-components builder/evaluation stage-output module tests
//! - `debug_report_components_evaluation_stage_test_fixtures`: shared staged-evaluation fixtures for report-component stage output and handoff tests
//! - `debug_report_components_expected_evaluation_stage`: staged expected-table evaluation composition from observed-table diagnostics input
//! - `debug_report_components_still_needed_stage`: staged still-needed aggregation from expected-table evaluation output
//! - `debug_report_components_expected_table_count_stage`: staged expected-table-count sourcing from logging expectation catalog
//! - `debug_report_components_summary`: staged diagnostics summary composition from evaluation and still-needed data
//! - `debug_report_components_output_handoff_assembly`: final staged-component payload handoff assembly
//! - `debug_report_components_output_handoff_input_contracts`: typed handoff input contracts for staged-component payload output handoff
//! - `debug_report_components_from_staged_parts_output_assembly`: stable final staged-component payload assembly facade from staged diagnostics parts
//! - `debug_report_components_from_staged_parts_output_input_contracts`: typed staged-parts input contracts for the stable staged-component output facade
//! - `debug_report_components_output_handoff_test_helpers`: shared output-handoff assertions for `/debug/schema` report-components output module tests
//! - `debug_report_components_output_test_fixtures`: shared staged-component output fixtures for output handoff and builder-stage handoff tests
//! - `debug_report_output_sort_expected_policy`: deterministic expected-table sorting policy for final debug report output
//! - `debug_report_output_sort_observed_policy`: deterministic observed-table sorting policy for final debug report output
//! - `debug_report_output_sort`: stable sorting-policy facade for final debug report output
//! - `debug_report_output_evaluation_sort_stage`: expected-table sort-stage composition before final report output
//! - `debug_report_output_evaluation_sort_stage_contracts`: staged expected-table sort payload contracts
//! - `debug_report_output_evaluation_sort_stage_input_assembly`: typed stage-input payload assembly from sorted expected-table evaluation rows for expected-sort staging
//! - `debug_report_output_evaluation_sort_stage_input_contracts`: typed stage-input contracts for expected-table sort staging
//! - `debug_report_output_evaluation_sort_stage_output_assembly`: staged expected-table sort payload assembly
//! - `debug_report_output_evaluation_sort_from_stage_output_assembly`: stable final handoff facade from staged expected-table sort payloads
//! - `debug_report_output_evaluation_sort_stage_output_handoff_assembly`: final expected-sort stage handoff assembly from staged payloads
//! - `debug_report_output_evaluation_sort_stage_output_contract_handoff_assembly`: staged expected-sort contract handoff assembly from staged payload parts into final evaluation contracts
//! - `debug_report_output_observed_sort_stage`: observed-table sort-stage composition before final report output
//! - `debug_report_output_observed_sort_stage_contracts`: staged observed-table sort payload contracts
//! - `debug_report_output_observed_sort_stage_input_assembly`: typed stage-input payload assembly from sorted observed-table rows for observed-sort staging
//! - `debug_report_output_observed_sort_stage_input_contracts`: typed stage-input contracts for observed-sort staged payload assembly
//! - `debug_report_output_observed_sort_stage_output_assembly`: staged observed-table sort payload assembly
//! - `debug_report_output_observed_sort_from_stage_output_assembly`: stable final handoff facade from staged observed-table sort payloads
//! - `debug_report_output_observed_sort_stage_output_handoff_assembly`: final observed-sort stage handoff assembly from staged payloads
//! - `debug_report_output_observed_sort_stage_output_contract_handoff_assembly`: staged observed-sort contract handoff assembly from staged payload parts into final observed-table contracts
//! - `debug_report_output_sort_stage_test_fixtures`: shared expected/observed sort-stage fixtures for sort-stage assembly and handoff tests
//! - `debug_report_output_generated_at_stage`: generated-at timestamp stage for final report metadata
//! - `debug_report_output_assembly`: final debug report payload assembly policy
//! - `debug_report_output_input_contracts`: typed input contracts for final report-output facade and assembly policy
//! - `debug_report_output_input_assembly`: typed final report-output input assembly from projected diagnostics parts
//! - `debug_report_output_assembly_stage_input_assembly`: typed stage-input payload assembly for final report-output stage assembly
//! - `debug_report_output_assembly_stage_input_contracts`: typed stage-input contracts for report assembly staging
//! - `debug_report_output_assembly_stage_contracts`: staged final-output contracts for report assembly
//! - `debug_report_output_assembly_expected_tables_projection`: expected-table projection policy from evaluation payloads for final output staging
//! - `debug_report_output_assembly_stage_output_assembly`: staged final-output payload assembly from diagnostics parts and metadata
//! - `debug_report_output_assembly_stage_output_handoff_assembly`: final staged output handoff assembly from staged output payload into report contracts
//! - `debug_report_output_assembly_stage_output_contract_handoff_assembly`: staged final-output contract handoff assembly from staged output parts into final report contracts
//! - `debug_report_output_assembly_from_stage_output_assembly`: stable final output handoff facade from staged output payloads
//! - `debug_report_output_assembly_stage_test_fixtures`: shared summary/metadata/stage fixtures for report-output assembly stage tests
//! - `debug_report_output_entry_stage_input_assembly`: typed entry-stage input assembly for sorted report-output diagnostics parts
//! - `debug_report_output_entry_stage_input_contracts`: typed stage-input contracts for report-output entry staging
//! - `debug_report_output_metadata_contracts`: metadata and legacy compatibility-field contracts for final report output
//! - `debug_report_output_metadata_stage_input_assembly`: typed stage-input payload assembly from still-needed diagnostics and observed rows for metadata staging
//! - `debug_report_output_metadata_stage_input_contracts`: typed stage-input contracts for metadata staging
//! - `debug_report_output_metadata_stage_contracts`: staged metadata payload contracts for final report output assembly
//! - `debug_report_output_metadata_stage_output_assembly`: staged metadata payload assembly from still-needed diagnostics and observed rows
//! - `debug_report_output_metadata_stage_output_handoff_assembly`: final staged metadata handoff assembly from staged metadata payloads
//! - `debug_report_output_metadata_stage_output_contract_handoff_assembly`: staged metadata contract handoff assembly from staged metadata parts into final metadata contracts
//! - `debug_report_output_metadata_from_stage_output_assembly`: stable metadata handoff facade from staged metadata payloads
//! - `debug_report_output_metadata_assembly`: stable report metadata and legacy compatibility field assembly facade
//! - `debug_report_output_metadata_test_fixtures`: shared staged metadata fixtures for metadata assembly and handoff tests
//! - `debug_report_output_from_components`: staged-components projection into final report output assembly
//! - `debug_report_output_from_components_input_contracts`: typed input contracts for final output projection from diagnostics components
//! - `debug_report_output_from_components_stage_contracts`: staged projection contracts from diagnostics components
//! - `debug_report_output_from_components_stage_input_assembly`: typed stage-input payload assembly from logging client and diagnostics components for component-projection staging
//! - `debug_report_output_from_components_stage_input_contracts`: typed stage-input contracts for component-projection staging
//! - `debug_report_output_from_components_stage_projection_parts`: field-level projection policy from component diagnostics into staged output payload parts
//! - `debug_report_output_from_components_stage_output_assembly`: staged projection payload assembly from component diagnostics
//! - `debug_report_output_from_components_stage_output_handoff_assembly`: final staged component projection handoff assembly into report output
//! - `debug_report_output_from_components_stage_output_contract_handoff_assembly`: staged component projection contract handoff assembly from staged payload parts into report output
//! - `debug_report_output_from_components_output_projection_parts`: field-level projection policy from staged component payloads into final output handoff parts
//! - `debug_report_output_from_components_from_stage_output_assembly`: stable final output handoff facade from staged component projections
//! - `debug_report_output_from_components_stage_test_fixtures`: shared summary/still-needed/stage fixtures for component-projection stage tests
//! - `debug_report_output_common_test_fixtures`: shared baseline summary/still-needed/observed fixtures reused across report-output fixture modules
//! - `debug_report_output_projection_test_fixtures`: shared expected-table/summary/still-needed/observed fixtures for report-output projection policy tests
//! - `debug_report_output_entry_stage_contracts`: staged entry payload contracts for the stable report-output facade
//! - `debug_report_output_entry_stage_output_assembly`: staged entry payload assembly for the stable report-output facade
//! - `debug_report_output_entry_stage_output_handoff_assembly`: final report-output handoff assembly from staged entry payloads
//! - `debug_report_output_entry_stage_output_contract_handoff_assembly`: staged entry contract handoff assembly from staged payload parts into final report contracts
//! - `debug_report_output_entry_stage_output_report_handoff_assembly`: report-output entry-stage report-call handoff assembly from staged entry fields
//! - `debug_report_output_entry_stage_test_fixtures`: shared staged entry fixtures for report-output entry-stage assembly and handoff tests
//! - `debug_report_output_from_entry_stage_output_assembly`: stable final output handoff facade from staged entry payloads
//! - `debug_report_output`: final `/debug/schema` payload sorting and assembly
//! - `debug_report_stage_contracts`: staged payload contracts for the stable top-level debug-report facade
//! - `debug_report_stage_input_assembly`: typed stage-input payload assembly for top-level debug-report staging
//! - `debug_report_stage_input_contracts`: typed stage-input contracts for top-level debug-report staging
//! - `debug_report_stage_output_assembly`: staged top-level debug-report payload assembly from relation/column rows
//! - `debug_report_stage_output_handoff_assembly`: final debug-report handoff assembly from staged payload data
//! - `debug_report_stage_output_contract_handoff_assembly`: staged top-level report contract handoff assembly from staged payload parts into final report contracts
//! - `debug_report_from_stage_output_assembly`: stable final-handoff facade over staged top-level report handoff
//! - `debug_report_stage_test_fixtures`: shared staged input fixtures for top-level report-stage assembly and handoff tests
//! - `debug_report_test_fixtures`: shared typed report fixture builders for `/debug/schema` module tests
//! - `debug_report_input_contracts`: typed input contracts for top-level debug-report building
//! - `debug_report`: stable top-level expected-vs-observed health report facade
//! - `presentation`: stable mapping facade from service records to response DTOs
//! - `presentation::overview`: `/schema` payload mapping helpers
//! - `presentation::tables`: `/schema/tables` payload mapping helpers
//! - `presentation::columns`: `/schema/columns` payload mapping helpers
//! - `presentation::constraints`: `/schema/constraints` payload mapping helpers
//! - `presentation_constraint_grouping`: grouping policy for constraint payload rows
//! - `presentation_overview_tables`: nesting policy for `/schema` overview tables
//! - `request_param_contracts`: stable normalized request-parameter contract facade
//! - `request_param_contracts::columns`: normalized request contracts for `/schema/columns`
//! - `request_param_contracts::constraints`: normalized request contracts for `/schema/constraints`
//! - `request_params_schema`: query normalization/validation helpers for `/schema`
//! - `request_params_columns`: query normalization/validation helpers for `/schema/columns`
//! - `request_params_constraints`: query normalization/validation helpers for `/schema/constraints`
//! - `request_params`: stable query-normalization facade
/// Registers all schema-related HTTP services.