feat: add metadata catalog cleanup commands

2026-08-28 00:37:43 +02:00
parent 79c4c925b5
commit 58ee9cffe4
19 changed files with 942 additions and 66 deletions
@@ -1,3 +1,7 @@
+---
+status: superseded by ADR-0008
+---
+
 # Hard-delete catalog tables during synchronization

 An explicit Table Synchronization makes the Catalog Table membership exactly match a successful
@@ -0,0 +1,16 @@
+---
+status: accepted
+---
+
+# Allow explicit manual catalog metadata cleanup
+
+An administrator may explicitly clear structural projections from the Metadata Catalog without
+changing the Workspace Database, its binding, or its secrets. A database selection can remove all
+Catalog Tables, cascading their Catalog Columns and Catalog Relationships, or remove only its
+Catalog Relationships; a table selection can remove its Catalog Columns or every incoming and
+outgoing Catalog Relationship. Each selection is atomic, and a later Schema Synchronization can
+rebuild the removed projection from the external schema.
+
+This supersedes ADR-0005's broader invariant that physical membership cannot be edited manually.
+Synchronization remains authoritative when it runs, while manual cleanup intentionally permits an
+incomplete catalog between cleanup and the next successful synchronization.