From cde2893e3edf916c03c834eef7af9023258a34fb Mon Sep 17 00:00:00 2001
From: Marcos Magueta <maguetamarcos@gmail.com>
Date: Sat, 7 Mar 2026 12:45:46 -0300
Subject: catalog

---
 lib/prelude/catalog.ml | 120 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)
 create mode 100644 lib/prelude/catalog.ml

(limited to 'lib/prelude')

diff --git a/lib/prelude/catalog.ml b/lib/prelude/catalog.ml
new file mode 100644
index 0000000..ae43c4d
--- /dev/null
+++ b/lib/prelude/catalog.ml
@@ -0,0 +1,120 @@
+(** System catalog helpers.
+
+    Pure definitions — no storage access, no manipulation dependency.
+    Consumed by {!Manipulation.Make} to bootstrap and maintain the six
+    catalog relations that make the database self-describing. *)
+
+let catalog_prefix = "sakura:"
+
+(* 
+   Catalog relation names
+    *)
+
+let relation_rel_name   = catalog_prefix ^ "relation"
+let domain_rel_name     = catalog_prefix ^ "domain"
+let attribute_rel_name  = catalog_prefix ^ "attribute"
+let constraint_rel_name = catalog_prefix ^ "constraint"
+let on_rel_name         = catalog_prefix ^ "on"
+let timing_rel_name     = catalog_prefix ^ "timing"
+
+let catalog_relation_names =
+  [ relation_rel_name
+  ; domain_rel_name
+  ; attribute_rel_name
+  ; constraint_rel_name
+  ; on_rel_name
+  ; timing_rel_name
+  ]
+
+let is_catalog_relation name =
+  List.mem name catalog_relation_names
+
+(* 
+   Schema definitions
+    *)
+
+let relation_schema : Schema.t =
+  Schema.empty |> Schema.add "name" "string"
+
+let domain_schema : Schema.t =
+  Schema.empty |> Schema.add "name" "string"
+
+let attribute_schema : Schema.t =
+  Schema.empty
+  |> Schema.add "relation_name" "string"
+  |> Schema.add "attr_name" "string"
+  |> Schema.add "domain_name" "string"
+
+let constraint_schema : Schema.t =
+  Schema.empty
+  |> Schema.add "name" "string"
+  |> Schema.add "relation_name" "string"
+
+let on_schema : Schema.t =
+  Schema.empty |> Schema.add "event" "string"
+
+let timing_schema : Schema.t =
+  Schema.empty |> Schema.add "timing" "string"
+
+(** All (name, schema) pairs for the 6 catalog relations, in bootstrap order. *)
+let catalog_definitions =
+  [ (relation_rel_name,   relation_schema)
+  ; (domain_rel_name,     domain_schema)
+  ; (attribute_rel_name,  attribute_schema)
+  ; (constraint_rel_name, constraint_schema)
+  ; (on_rel_name,         on_schema)
+  ; (timing_rel_name,     timing_schema)
+  ]
+
+(* 
+   Tuple builders
+    *)
+
+let build_relation_tuple rel_name : Tuple.materialized =
+  { Tuple.relation = relation_rel_name
+  ; attributes =
+      Tuple.AttributeMap.singleton "name"
+        { Attribute.value = Obj.magic rel_name }
+  }
+
+let build_domain_tuple dom_name : Tuple.materialized =
+  { Tuple.relation = domain_rel_name
+  ; attributes =
+      Tuple.AttributeMap.singleton "name"
+        { Attribute.value = Obj.magic dom_name }
+  }
+
+let build_attribute_tuples ~relation_name (schema : Schema.t) : Tuple.materialized list =
+  List.map (fun (attr_n, dom_n) ->
+    { Tuple.relation = attribute_rel_name
+    ; attributes =
+        Tuple.AttributeMap.of_list
+          [ ("relation_name", { Attribute.value = Obj.magic relation_name })
+          ; ("attr_name",     { Attribute.value = Obj.magic attr_n })
+          ; ("domain_name",   { Attribute.value = Obj.magic dom_n })
+          ]
+    }
+  ) schema
+
+let build_constraint_tuple cname rel_name : Tuple.materialized =
+  { Tuple.relation = constraint_rel_name
+  ; attributes =
+      Tuple.AttributeMap.of_list
+        [ ("name",          { Attribute.value = Obj.magic cname })
+        ; ("relation_name", { Attribute.value = Obj.magic rel_name })
+        ]
+  }
+
+let build_on_tuple event : Tuple.materialized =
+  { Tuple.relation = on_rel_name
+  ; attributes =
+      Tuple.AttributeMap.singleton "event"
+        { Attribute.value = Obj.magic event }
+  }
+
+let build_timing_tuple timing : Tuple.materialized =
+  { Tuple.relation = timing_rel_name
+  ; attributes =
+      Tuple.AttributeMap.singleton "timing"
+        { Attribute.value = Obj.magic timing }
+  }
-- 
cgit v1.2.3