@littlebigbrain/mcp

lbb_configure

Destructive

Configure graph schema metadata by defining and evolving ontologies, applying starter schemas, publishing SHACL, and filing ontology changes for review.

Instructions

Manage native schema metadata. Actions: define_ontology (friendly spec with super_types), evolve_ontology (ordered edits including add_super_types), list_starters (the base ontologies crm, documents and work, each with its status on the graph: absent, partial or applied, what applying adds, and conflicts), apply_starter (add what the graph lacks of a starter in one ontology version; a relation the graph has is widened; refused with starter_conflict when the graph holds a term differently; dry_run previews), publish_schema (SHACL activation), suggest_ontology_change (file a change for a person to review instead of applying it; prefer it when the graph's owner reviews ontology changes, and list the result with lbb_inspect action=ontology_suggestions; facts files graph facts for review, which accepting commits after the change, and change may be empty when facts is set), get_rewrite_profile and set_rewrite_profile (the graph's notes and up to 20 worked question-to-SPARQL examples that lbb_query mode=question reads for every question; pass the version you read as expected_version). define, evolve, publish and set_rewrite_profile support dry_run previews. Definition/import here extracts native metadata; it does NOT store the complete RDF/OWL document as queryable graph facts. Use lbb_rdf import for full OWL and lbb_rdf update for additive INSERT DATA revisions; RDF deletions are unsupported. Publish_schema accepts unchanged ontology plus shapes; use define/evolve for native ontology changes. Publication enqueues durable conformance; a preview does not validate the whole graph. An evolve_ontology that removes (remove_entity_type, remove_relation, or narrow_relation with remove_domain or remove_range) and a publish_schema with desired_mode=reject ask the person to approve first; a dry_run does not ask. The server asks the person to approve it through the client (MCP form elicitation) and sends nothing when they decline (approval_declined). A client that cannot show the question gets approval_required and nothing is sent, unless the MCP server's environment sets LBB_MCP_DESTRUCTIVE=allow.

Input Schema

Name	Required	Description
`key`	No	Idempotency key ([A-Za-z0-9-_.:/]); filing again with the same key revises the suggestion
`ops`	No	Ontology changes to apply in order (additive, in-place edits, or subtractive)
`agent`	No	Your name as the producer, shown to reviewers
`facts`	No	Graph facts a person confirms: accepting commits them after the change (at most 200 triplets and property rows together). Records graphs only
`graph`	No	Graph to create or redefine
`notes`	No	What the data means for questions: which property holds the current state, what 'me' or 'my' means, which records to leave out. At most 8,000 characters
`title`	No	Short imperative text, e.g. 'Add class Contractor'
`action`	Yes	Selects the variant (one of: define_ontology, publish_schema, evolve_ontology, list_starters, apply_starter, suggest_ontology_change, get_rewrite_profile, set_rewrite_profile).
`anchor`	No	The class, property or relation the change is about
`change`	No	The ontology operations a person applies by accepting, in order (same shapes as evolve_ontology ops). Up to 128; may be empty or absent when facts is set
`format`	No
`shapes`	No
`source`	No
`dry_run`	No	Preview the exact definition without creating a graph or writing metadata.
`starter`	No	Starter id: crm, documents or work (list_starters names them)
`evidence`	No	What you saw: record count, fields, up to 20 sample records
`examples`	No	Up to 20 worked examples: a question and the query that answers it on this graph
`ontology`	No
`rationale`	No	Why the ontology needs the change; cite what you saw
`relations`	No
`desired_mode`	No
`entity_types`	No
`merge_default`	No
`expected_version`	No	The version get_rewrite_profile returned (0 for none): another stored version answers 409 conflict and stores nothing
`confirm_restrictive`	No
`allow_data_conflicts`	No	Deprecated compatibility flag; does not bypass conflicts. Preview subtractive changes with dry_run=true, repair the reported conflicts, then apply.
`expected_ontology_version`	No	Refuse when the graph's ontology version differs

Schema Changelog

Changes observed during successful MCP inspections.

Changed40 schema fields changedv0.16.0Oct 29, 2026

changedInput schema / additionalProperties
```
Previous value: -trueNew value: +{}
```
removedInput schema / properties / change / items / $ref
```
Removed value: -"#/properties/ops/items"
```

addedInput schema / properties / change / items / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "entity_type": {
+        "type": "string"
+      },
+      "op": {
+        "const": "add_super_types",
+        "type": "string"
+      },
+      "super_types": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "entity_type",
+      "super_types"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "add_domain": {
+        "description": "Entity-type names to add to the relation's domain (source types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "add_range": {
+        "description": "Entity-type names to add to the relation's range (target types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "widen_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to widen, by name (case-insensitive)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Display name of the new entity type (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "description": "Defaults to many_to_many",
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "domain": {
+        "description": "Entity-type names allowed as the source (domain); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "inverse_name": {
+        "description": "Optional inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "name": {
+        "description": "Display name of the new relation, e.g. HAS_PHASE",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_relation",
+        "type": "string"
+      },
+      "range": {
+        "description": "Entity-type names allowed as the target (range); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "reducer": {
+        "description": "State-reducer token, e.g. append_only (default), latest_wins",
+        "type": "string"
+      },
+      "symmetric": {
+        "type": "boolean"
+      },
+      "temporal_semantics": {
+        "description": "Defaults to bitemporal",
+        "enum": [
+          "atemporal",
+          "valid_time",
+          "commit_time",
+          "bitemporal"
+        ],
+        "type": "string"
+      },
+      "transitive": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "allowed_values": {
+        "description": "Enforced allowed values (sh:in): a commit with another value for the field is refused. For keyword, text, i64 and bool fields only",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "name": {
+        "description": "Display name of the new scalar property field, e.g. status (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_property",
+        "type": "string"
+      },
+      "required": {
+        "description": "Advisory required flag (not enforced on commit)",
+        "type": "boolean"
+      },
+      "unit": {
+        "description": "Unit of an i64 or f64 field, e.g. mm, cm, kg, m2 or h. Writers that read text, such as values.extract, convert numbers to it",
+        "type": "string"
+      },
+      "value_type": {
+        "description": "Scalar type; defaults to text. Lets a later lbb_commit set entity_properties[].field",
+        "enum": [
+          "bool",
+          "i64",
+          "f64",
+          "date_time",
+          "keyword",
+          "text",
+          "bytes"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_property_unit",
+        "type": "string"
+      },
+      "property": {
+        "description": "An existing i64 or f64 field, by name",
+        "type": "string"
+      },
+      "unit": {
+        "description": "The unit's symbol, as add_property takes it; omit it to clear the unit. Stored values are not converted",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "property"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "allowed_values": {
+        "description": "The allowed values that later commits are checked against; empty or absent clears the constraint. Stored values are not checked again",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "set_property_constraint",
+        "type": "string"
+      },
+      "property": {
+        "description": "An existing field, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "property"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current entity-type name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_entity_type",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; records keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current relation name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_relation",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; edges keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "inverse_name": {
+        "description": "Inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_inverse",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to set the inverse on, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "inverse_name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_cardinality",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to change, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "cardinality"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "narrow_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to narrow, by name",
+        "type": "string"
+      },
+      "remove_domain": {
+        "description": "Entity-type names to remove from the relation's domain (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "remove_range": {
+        "description": "Entity-type names to remove from the relation's range (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Entity type to tombstone — kept readable for old records, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Relation to tombstone — old edges stay readable, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_relation",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / entity_types / items / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": {},
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]

addedInput schema / properties / evidence / properties / records / maximum
```
Added value: +9007199254740991
```
removedInput schema / properties / evidence / properties / samples / items / $ref
```
Removed value: -"#/properties/entity_types/items/anyOf/1"
```
addedInput schema / properties / evidence / properties / samples / items / additionalProperties
```
Added value: +{}
```
addedInput schema / properties / evidence / properties / samples / items / propertyNames
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / evidence / properties / samples / items / type
```
Added value: +"object"
```
addedInput schema / properties / expected_ontology_version / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / expected_version / maximum
```
Added value: +9007199254740991
```
removedInput schema / properties / facts / properties / entity_properties / items / $ref
```
Removed value: -"#/properties/entity_types/items/anyOf/1"
```
addedInput schema / properties / facts / properties / entity_properties / items / additionalProperties
```
Added value: +{}
```
addedInput schema / properties / facts / properties / entity_properties / items / propertyNames
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / facts / properties / entity_properties / items / type
```
Added value: +"object"
```
removedInput schema / properties / facts / properties / replace_owned / properties / retract_entities / items / $ref
```
Removed value: -"#/properties/facts/properties/triplets/items/properties/source"
```
addedInput schema / properties / facts / properties / replace_owned / properties / retract_entities / items / additionalProperties
```
Added value: +{}
```

addedInput schema / properties / facts / properties / replace_owned / properties / retract_entities / items / properties

Added value: +{
+  "key": {
+    "description": "The record's external key, when it has one",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / facts / properties / replace_owned / properties / retract_entities / items / required
```
Added value: +[
+  "type",
+  "name"
+]
```
addedInput schema / properties / facts / properties / replace_owned / properties / retract_entities / items / type
```
Added value: +"object"
```
removedInput schema / properties / facts / properties / replace_owned / properties / subjects / items / $ref
```
Removed value: -"#/properties/facts/properties/triplets/items/properties/source"
```
addedInput schema / properties / facts / properties / replace_owned / properties / subjects / items / additionalProperties
```
Added value: +{}
```

addedInput schema / properties / facts / properties / replace_owned / properties / subjects / items / properties

Added value: +{
+  "key": {
+    "description": "The record's external key, when it has one",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / facts / properties / replace_owned / properties / subjects / items / required
```
Added value: +[
+  "type",
+  "name"
+]
```
addedInput schema / properties / facts / properties / replace_owned / properties / subjects / items / type
```
Added value: +"object"
```
changedInput schema / properties / facts / properties / triplets / items / additionalProperties
```
Previous value: -trueNew value: +{}
```

addedInput schema / properties / facts / properties / triplets / items / properties / evidence / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "additionalProperties": {},
+        "properties": {
+          "observation_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "region": {
+            "anyOf": [
+              {
+                "additionalProperties": {},
+                "properties": {
+                  "confidence": {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "page": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "x0": {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "x1": {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "y0": {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "y1": {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "page",
+                  "x0",
+                  "y0",
+                  "x1",
+                  "y1",
+                  "confidence"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "text": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / facts / properties / triplets / items / properties / source / additionalProperties
```
Previous value: -falseNew value: +{}
```
changedInput schema / properties / facts / properties / triplets / items / properties / source / properties / key / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
removedInput schema / properties / facts / properties / triplets / items / properties / target / $ref
```
Removed value: -"#/properties/facts/properties/triplets/items/properties/source"
```
addedInput schema / properties / facts / properties / triplets / items / properties / target / additionalProperties
```
Added value: +{}
```

addedInput schema / properties / facts / properties / triplets / items / properties / target / properties

Added value: +{
+  "key": {
+    "description": "The record's external key, when it has one",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / facts / properties / triplets / items / properties / target / required
```
Added value: +[
+  "type",
+  "name"
+]
```
addedInput schema / properties / facts / properties / triplets / items / properties / target / type
```
Added value: +"object"
```
removedInput schema / properties / ontology / properties / format / $ref
```
Removed value: -"#/properties/format"
```

addedInput schema / properties / ontology / properties / format / enum

Added value: +[
+  "auto",
+  "turtle",
+  "json_ld",
+  "rdf_xml",
+  "csv",
+  "tsv",
+  "lbb_json",
+  "spec"
+]

addedInput schema / properties / ontology / properties / format / type
```
Added value: +"string"
```

removedInput schema / properties / ops / items / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "entity_type": {
-        "type": "string"
-      },
-      "op": {
-        "const": "add_super_types",
-        "type": "string"
-      },
-      "super_types": {
-        "items": {
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "entity_type",
-      "super_types"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "add_domain": {
-        "description": "Entity-type names to add to the relation's domain (source types)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "add_range": {
-        "description": "Entity-type names to add to the relation's range (target types)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "op": {
-        "const": "widen_relation",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to widen, by name (case-insensitive)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Display name of the new entity type (idempotent if it exists)",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_entity_type",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cardinality": {
-        "description": "Defaults to many_to_many",
-        "enum": [
-          "one_to_one",
-          "one_to_many",
-          "many_to_one",
-          "many_to_many"
-        ],
-        "type": "string"
-      },
-      "domain": {
-        "description": "Entity-type names allowed as the source (domain); must already exist",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "inverse_name": {
-        "description": "Optional inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
-        "type": "string"
-      },
-      "name": {
-        "description": "Display name of the new relation, e.g. HAS_PHASE",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_relation",
-        "type": "string"
-      },
-      "range": {
-        "description": "Entity-type names allowed as the target (range); must already exist",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "reducer": {
-        "description": "State-reducer token, e.g. append_only (default), latest_wins",
-        "type": "string"
-      },
-      "symmetric": {
-        "type": "boolean"
-      },
-      "temporal_semantics": {
-        "description": "Defaults to bitemporal",
-        "enum": [
-          "atemporal",
-          "valid_time",
-          "commit_time",
-          "bitemporal"
-        ],
-        "type": "string"
-      },
-      "transitive": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Display name of the new scalar property field, e.g. status (idempotent if it exists)",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_property",
-        "type": "string"
-      },
-      "required": {
-        "description": "Advisory required flag (not enforced on commit)",
-        "type": "boolean"
-      },
-      "value_type": {
-        "description": "Scalar type; defaults to text. Lets a later lbb_commit set entity_properties[].field",
-        "enum": [
-          "bool",
-          "i64",
-          "f64",
-          "date_time",
-          "keyword",
-          "text",
-          "bytes"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "description": "Current entity-type name",
-        "type": "string"
-      },
-      "op": {
-        "const": "rename_entity_type",
-        "type": "string"
-      },
-      "to": {
-        "description": "New display name (stable id stays frozen; records keep resolving)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "description": "Current relation name",
-        "type": "string"
-      },
-      "op": {
-        "const": "rename_relation",
-        "type": "string"
-      },
-      "to": {
-        "description": "New display name (stable id stays frozen; edges keep resolving)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "inverse_name": {
-        "description": "Inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
-        "type": "string"
-      },
-      "op": {
-        "const": "set_relation_inverse",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to set the inverse on, by name",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation",
-      "inverse_name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cardinality": {
-        "enum": [
-          "one_to_one",
-          "one_to_many",
-          "many_to_one",
-          "many_to_many"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_relation_cardinality",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to change, by name",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation",
-      "cardinality"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "narrow_relation",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to narrow, by name",
-        "type": "string"
-      },
-      "remove_domain": {
-        "description": "Entity-type names to remove from the relation's domain (subtractive)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "remove_range": {
-        "description": "Entity-type names to remove from the relation's range (subtractive)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "relation"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Entity type to tombstone — kept readable for old records, rejected for new commits",
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_entity_type",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Relation to tombstone — old edges stay readable, rejected for new commits",
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_relation",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / ops / items / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "entity_type": {
+        "type": "string"
+      },
+      "op": {
+        "const": "add_super_types",
+        "type": "string"
+      },
+      "super_types": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "entity_type",
+      "super_types"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "add_domain": {
+        "description": "Entity-type names to add to the relation's domain (source types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "add_range": {
+        "description": "Entity-type names to add to the relation's range (target types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "widen_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to widen, by name (case-insensitive)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Display name of the new entity type (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "description": "Defaults to many_to_many",
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "domain": {
+        "description": "Entity-type names allowed as the source (domain); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "inverse_name": {
+        "description": "Optional inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "name": {
+        "description": "Display name of the new relation, e.g. HAS_PHASE",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_relation",
+        "type": "string"
+      },
+      "range": {
+        "description": "Entity-type names allowed as the target (range); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "reducer": {
+        "description": "State-reducer token, e.g. append_only (default), latest_wins",
+        "type": "string"
+      },
+      "symmetric": {
+        "type": "boolean"
+      },
+      "temporal_semantics": {
+        "description": "Defaults to bitemporal",
+        "enum": [
+          "atemporal",
+          "valid_time",
+          "commit_time",
+          "bitemporal"
+        ],
+        "type": "string"
+      },
+      "transitive": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "allowed_values": {
+        "description": "Enforced allowed values (sh:in): a commit with another value for the field is refused. For keyword, text, i64 and bool fields only",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "name": {
+        "description": "Display name of the new scalar property field, e.g. status (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_property",
+        "type": "string"
+      },
+      "required": {
+        "description": "Advisory required flag (not enforced on commit)",
+        "type": "boolean"
+      },
+      "unit": {
+        "description": "Unit of an i64 or f64 field, e.g. mm, cm, kg, m2 or h. Writers that read text, such as values.extract, convert numbers to it",
+        "type": "string"
+      },
+      "value_type": {
+        "description": "Scalar type; defaults to text. Lets a later lbb_commit set entity_properties[].field",
+        "enum": [
+          "bool",
+          "i64",
+          "f64",
+          "date_time",
+          "keyword",
+          "text",
+          "bytes"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_property_unit",
+        "type": "string"
+      },
+      "property": {
+        "description": "An existing i64 or f64 field, by name",
+        "type": "string"
+      },
+      "unit": {
+        "description": "The unit's symbol, as add_property takes it; omit it to clear the unit. Stored values are not converted",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "property"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "allowed_values": {
+        "description": "The allowed values that later commits are checked against; empty or absent clears the constraint. Stored values are not checked again",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "set_property_constraint",
+        "type": "string"
+      },
+      "property": {
+        "description": "An existing field, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "property"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current entity-type name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_entity_type",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; records keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current relation name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_relation",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; edges keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "inverse_name": {
+        "description": "Inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_inverse",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to set the inverse on, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "inverse_name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_cardinality",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to change, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "cardinality"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "narrow_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to narrow, by name",
+        "type": "string"
+      },
+      "remove_domain": {
+        "description": "Entity-type names to remove from the relation's domain (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "remove_range": {
+        "description": "Entity-type names to remove from the relation's range (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Entity type to tombstone — kept readable for old records, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Relation to tombstone — old edges stay readable, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_relation",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / relations / items / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "$ref": "#/properties/entity_types/items/anyOf/1"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]

Changed3 schema fields changedv0.14.0Oct 14, 2026

changedInput schema / properties / change / description

Previous value: -"The ontology operations a person applies by accepting, in order (same shapes as evolve_ontology ops)"New value: +"The ontology operations a person applies by accepting, in order (same shapes as evolve_ontology ops). Up to 128; may be empty or absent when facts is set"

removedInput schema / properties / change / minItems
```
Removed value: -1
```

addedInput schema / properties / facts

Added value: +{
+  "additionalProperties": false,
+  "description": "Graph facts a person confirms: accepting commits them after the change (at most 200 triplets and property rows together). Records graphs only",
+  "properties": {
+    "entity_properties": {
+      "description": "Fields to commit, each { type, name, properties: { field: value } } as lbb_commit takes them",
+      "items": {
+        "$ref": "#/properties/entity_types/items/anyOf/1"
+      },
+      "maxItems": 200,
+      "type": "array"
+    },
+    "replace_owned": {
+      "additionalProperties": false,
+      "description": "Replace the producer's owned edges and fields on its subjects in the same commit",
+      "properties": {
+        "properties": {
+          "description": "Owned fields: the ones the facts do not set on a subject are removed",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 64,
+          "type": "array"
+        },
+        "relations": {
+          "description": "Owned relations: their current out-edges of the subjects that the facts do not write again are removed",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 64,
+          "type": "array"
+        },
+        "retract_entities": {
+          "description": "Records the producer made and no longer makes",
+          "items": {
+            "$ref": "#/properties/facts/properties/triplets/items/properties/source"
+          },
+          "maxItems": 1000,
+          "type": "array"
+        },
+        "subjects": {
+          "description": "The records this write is for",
+          "items": {
+            "$ref": "#/properties/facts/properties/triplets/items/properties/source"
+          },
+          "maxItems": 1000,
+          "type": "array"
+        }
+      },
+      "required": [
+        "subjects"
+      ],
+      "type": "object"
+    },
+    "summary": {
+      "description": "One line about the facts for the reviewer",
+      "maxLength": 500,
+      "type": "string"
+    },
+    "triplets": {
+      "description": "Links to commit, as lbb_commit takes triplets",
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "confidence": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          "evidence": {
+            "description": "Why the link holds: a string, or { text, source_id } as lbb_commit takes it"
+          },
+          "relation": {
+            "type": "string"
+          },
+          "source": {
+            "additionalProperties": false,
+            "properties": {
+              "key": {
+                "description": "The record's external key, when it has one",
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "name"
+            ],
+            "type": "object"
+          },
+          "target": {
+            "$ref": "#/properties/facts/properties/triplets/items/properties/source"
+          }
+        },
+        "required": [
+          "source",
+          "relation",
+          "target"
+        ],
+        "type": "object"
+      },
+      "maxItems": 200,
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Changed5 schema fields changedv0.9.0Oct 5, 2026

changedInput schema / properties / action / description

Previous value: -"Selects the variant (one of: define_ontology, publish_schema, evolve_ontology, list_starters, apply_starter, suggest_ontology_change)."New value: +"Selects the variant (one of: define_ontology, publish_schema, evolve_ontology, list_starters, apply_starter, suggest_ontology_change, get_rewrite_profile, set_rewrite_profile)."

changedInput schema / properties / action / enum

Previous value: -[
-  "define_ontology",
-  "publish_schema",
-  "evolve_ontology",
-  "list_starters",
-  "apply_starter",
-  "suggest_ontology_change"
-]New value: +[
+  "define_ontology",
+  "publish_schema",
+  "evolve_ontology",
+  "list_starters",
+  "apply_starter",
+  "suggest_ontology_change",
+  "get_rewrite_profile",
+  "set_rewrite_profile"
+]

addedInput schema / properties / examples

Added value: +{
+  "description": "Up to 20 worked examples: a question and the query that answers it on this graph",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "note": {
+        "maxLength": 1000,
+        "type": "string"
+      },
+      "question": {
+        "maxLength": 1000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "sparql": {
+        "description": "A SELECT or ASK query with its PREFIX lines; the server parses it",
+        "maxLength": 4000,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "question",
+      "sparql"
+    ],
+    "type": "object"
+  },
+  "maxItems": 20,
+  "type": "array"
+}

addedInput schema / properties / expected_version

Added value: +{
+  "description": "The version get_rewrite_profile returned (0 for none): another stored version answers 409 conflict and stores nothing",
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / notes

Added value: +{
+  "description": "What the data means for questions: which property holds the current state, what 'me' or 'my' means, which records to leave out. At most 8,000 characters",
+  "maxLength": 8000,
+  "type": "string"
+}

Changed11 schema fields changedv0.8.1Oct 3, 2026

changedInput schema / properties / action / description

Previous value: -"Selects the variant (one of: define_ontology, publish_schema, evolve_ontology)."New value: +"Selects the variant (one of: define_ontology, publish_schema, evolve_ontology, list_starters, apply_starter, suggest_ontology_change)."

changedInput schema / properties / action / enum

Previous value: -[
-  "define_ontology",
-  "publish_schema",
-  "evolve_ontology"
-]New value: +[
+  "define_ontology",
+  "publish_schema",
+  "evolve_ontology",
+  "list_starters",
+  "apply_starter",
+  "suggest_ontology_change"
+]

addedInput schema / properties / agent

Added value: +{
+  "description": "Your name as the producer, shown to reviewers",
+  "maxLength": 200,
+  "type": "string"
+}

addedInput schema / properties / anchor

Added value: +{
+  "additionalProperties": false,
+  "description": "The class, property or relation the change is about",
+  "properties": {
+    "kind": {
+      "enum": [
+        "ontology",
+        "class",
+        "property",
+        "relation"
+      ],
+      "type": "string"
+    },
+    "name": {
+      "maxLength": 200,
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind"
+  ],
+  "type": "object"
+}

addedInput schema / properties / change

Added value: +{
+  "description": "The ontology operations a person applies by accepting, in order (same shapes as evolve_ontology ops)",
+  "items": {
+    "$ref": "#/properties/ops/items"
+  },
+  "maxItems": 128,
+  "minItems": 1,
+  "type": "array"
+}

addedInput schema / properties / evidence

Added value: +{
+  "additionalProperties": false,
+  "description": "What you saw: record count, fields, up to 20 sample records",
+  "properties": {
+    "records": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "samples": {
+      "items": {
+        "$ref": "#/properties/entity_types/items/anyOf/1"
+      },
+      "maxItems": 20,
+      "type": "array"
+    },
+    "source_fields": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 200,
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / expected_ontology_version

Added value: +{
+  "description": "Refuse when the graph's ontology version differs",
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / key

Added value: +{
+  "description": "Idempotency key ([A-Za-z0-9-_.:/]); filing again with the same key revises the suggestion",
+  "maxLength": 255,
+  "type": "string"
+}

addedInput schema / properties / rationale

Added value: +{
+  "description": "Why the ontology needs the change; cite what you saw",
+  "maxLength": 4000,
+  "type": "string"
+}

addedInput schema / properties / starter

Added value: +{
+  "description": "Starter id: crm, documents or work (list_starters names them)",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / title

Added value: +{
+  "description": "Short imperative text, e.g. 'Add class Contractor'",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedv0.5.2Sep 24, 2026

removedInput schema / properties / branch

Removed value: -{
-  "description": "Branch to target; defaults to the connection's branch",
-  "type": "string"
-}

Changed9 schema fields changedv0.5.1Sep 19, 2026

changedInput schema / properties / allow_data_conflicts / description

Previous value: -"Apply subtractive ops (narrow/remove) even when current data conflicts; affected records are kept and begin to warn. Default false rejects a conflicting subtractive request and reports the conflicts."New value: +"Deprecated compatibility flag; does not bypass conflicts. Preview subtractive changes with dry_run=true, repair the reported conflicts, then apply."

addedInput schema / properties / dry_run

Added value: +{
+  "description": "Preview the exact definition without creating a graph or writing metadata.",
+  "type": "boolean"
+}

removedInput schema / properties / entity_types / items / additionalProperties
```
Removed value: -{}
```

addedInput schema / properties / entity_types / items / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": {},
+    "type": "object"
+  }
+]

removedInput schema / properties / entity_types / items / type
```
Removed value: -"object"
```

changedInput schema / properties / ops / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "add_domain": {
-        "description": "Entity-type names to add to the relation's domain (source types)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "add_range": {
-        "description": "Entity-type names to add to the relation's range (target types)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "op": {
-        "const": "widen_relation",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to widen, by name (case-insensitive)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Display name of the new entity type (idempotent if it exists)",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_entity_type",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cardinality": {
-        "description": "Defaults to many_to_many",
-        "enum": [
-          "one_to_one",
-          "one_to_many",
-          "many_to_one",
-          "many_to_many"
-        ],
-        "type": "string"
-      },
-      "domain": {
-        "description": "Entity-type names allowed as the source (domain); must already exist",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "inverse_name": {
-        "description": "Optional inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
-        "type": "string"
-      },
-      "name": {
-        "description": "Display name of the new relation, e.g. HAS_PHASE",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_relation",
-        "type": "string"
-      },
-      "range": {
-        "description": "Entity-type names allowed as the target (range); must already exist",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "reducer": {
-        "description": "State-reducer token, e.g. append_only (default), latest_wins",
-        "type": "string"
-      },
-      "symmetric": {
-        "type": "boolean"
-      },
-      "temporal_semantics": {
-        "description": "Defaults to bitemporal",
-        "enum": [
-          "atemporal",
-          "valid_time",
-          "commit_time",
-          "bitemporal"
-        ],
-        "type": "string"
-      },
-      "transitive": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Display name of the new scalar property field, e.g. status (idempotent if it exists)",
-        "type": "string"
-      },
-      "op": {
-        "const": "add_property",
-        "type": "string"
-      },
-      "required": {
-        "description": "Advisory required flag (not enforced on commit)",
-        "type": "boolean"
-      },
-      "value_type": {
-        "description": "Scalar type; defaults to text. Lets a later lbb_commit set entity_properties[].field",
-        "enum": [
-          "bool",
-          "i64",
-          "f64",
-          "date_time",
-          "keyword",
-          "text",
-          "bytes"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "description": "Current entity-type name",
-        "type": "string"
-      },
-      "op": {
-        "const": "rename_entity_type",
-        "type": "string"
-      },
-      "to": {
-        "description": "New display name (stable id stays frozen; records keep resolving)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "description": "Current relation name",
-        "type": "string"
-      },
-      "op": {
-        "const": "rename_relation",
-        "type": "string"
-      },
-      "to": {
-        "description": "New display name (stable id stays frozen; edges keep resolving)",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "inverse_name": {
-        "description": "Inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
-        "type": "string"
-      },
-      "op": {
-        "const": "set_relation_inverse",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to set the inverse on, by name",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation",
-      "inverse_name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cardinality": {
-        "enum": [
-          "one_to_one",
-          "one_to_many",
-          "many_to_one",
-          "many_to_many"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_relation_cardinality",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to change, by name",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "relation",
-      "cardinality"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "narrow_relation",
-        "type": "string"
-      },
-      "relation": {
-        "description": "Relation to narrow, by name",
-        "type": "string"
-      },
-      "remove_domain": {
-        "description": "Entity-type names to remove from the relation's domain (subtractive)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "remove_range": {
-        "description": "Entity-type names to remove from the relation's range (subtractive)",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "relation"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Entity type to tombstone — kept readable for old records, rejected for new commits",
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_entity_type",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "description": "Relation to tombstone — old edges stay readable, rejected for new commits",
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_relation",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "entity_type": {
+        "type": "string"
+      },
+      "op": {
+        "const": "add_super_types",
+        "type": "string"
+      },
+      "super_types": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "entity_type",
+      "super_types"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "add_domain": {
+        "description": "Entity-type names to add to the relation's domain (source types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "add_range": {
+        "description": "Entity-type names to add to the relation's range (target types)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "widen_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to widen, by name (case-insensitive)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Display name of the new entity type (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "description": "Defaults to many_to_many",
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "domain": {
+        "description": "Entity-type names allowed as the source (domain); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "inverse_name": {
+        "description": "Optional inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "name": {
+        "description": "Display name of the new relation, e.g. HAS_PHASE",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_relation",
+        "type": "string"
+      },
+      "range": {
+        "description": "Entity-type names allowed as the target (range); must already exist",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "reducer": {
+        "description": "State-reducer token, e.g. append_only (default), latest_wins",
+        "type": "string"
+      },
+      "symmetric": {
+        "type": "boolean"
+      },
+      "temporal_semantics": {
+        "description": "Defaults to bitemporal",
+        "enum": [
+          "atemporal",
+          "valid_time",
+          "commit_time",
+          "bitemporal"
+        ],
+        "type": "string"
+      },
+      "transitive": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Display name of the new scalar property field, e.g. status (idempotent if it exists)",
+        "type": "string"
+      },
+      "op": {
+        "const": "add_property",
+        "type": "string"
+      },
+      "required": {
+        "description": "Advisory required flag (not enforced on commit)",
+        "type": "boolean"
+      },
+      "value_type": {
+        "description": "Scalar type; defaults to text. Lets a later lbb_commit set entity_properties[].field",
+        "enum": [
+          "bool",
+          "i64",
+          "f64",
+          "date_time",
+          "keyword",
+          "text",
+          "bytes"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current entity-type name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_entity_type",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; records keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "Current relation name",
+        "type": "string"
+      },
+      "op": {
+        "const": "rename_relation",
+        "type": "string"
+      },
+      "to": {
+        "description": "New display name (stable id stays frozen; edges keep resolving)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "inverse_name": {
+        "description": "Inverse-relation display name, e.g. PHASE_OF (enables one-hop reverse traversal)",
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_inverse",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to set the inverse on, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "inverse_name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "enum": [
+          "one_to_one",
+          "one_to_many",
+          "many_to_one",
+          "many_to_many"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_relation_cardinality",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to change, by name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "relation",
+      "cardinality"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "narrow_relation",
+        "type": "string"
+      },
+      "relation": {
+        "description": "Relation to narrow, by name",
+        "type": "string"
+      },
+      "remove_domain": {
+        "description": "Entity-type names to remove from the relation's domain (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "remove_range": {
+        "description": "Entity-type names to remove from the relation's range (subtractive)",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "relation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Entity type to tombstone — kept readable for old records, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_entity_type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Relation to tombstone — old edges stay readable, rejected for new commits",
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_relation",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / relations / $ref
```
Removed value: -"#/properties/entity_types"
```

addedInput schema / properties / relations / items

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "$ref": "#/properties/entity_types/items/anyOf/1"
+    }
+  ]
+}

addedInput schema / properties / relations / type
```
Added value: +"array"
```

Changed6 schema fields changedv0.2.7Jul 30, 2026

changedInput schema / properties / action / description

Previous value: -"Selects the variant (one of: define_ontology, define_rules, publish_schema, evolve_ontology)."New value: +"Selects the variant (one of: define_ontology, publish_schema, evolve_ontology)."

changedInput schema / properties / action / enum

Previous value: -[
-  "define_ontology",
-  "define_rules",
-  "publish_schema",
-  "evolve_ontology"
-]New value: +[
+  "define_ontology",
+  "publish_schema",
+  "evolve_ontology"
+]

removedInput schema / properties / confirm_empty
```
Removed value: -{
-  "type": "boolean"
-}
```

changedInput schema / properties / desired_mode / enum

Previous value: -[
-  "warn",
-  "reject"
-]New value: +[
+  "off",
+  "warn",
+  "reject"
+]

removedInput schema / properties / preview_digest
```
Removed value: -{
-  "type": "string"
-}
```

removedInput schema / properties / rules

Removed value: -{
-  "items": {
-    "additionalProperties": true,
-    "properties": {
-      "body": {
-        "description": "The condition: a basic graph pattern over current edges (asserted + already-derived), joined on shared variables. Terms may be variables or fixed entities.",
-        "items": {
-          "additionalProperties": true,
-          "properties": {
-            "object": {
-              "$ref": "#/properties/rules/items/properties/body/items/properties/subject",
-              "description": "A rule term: { \"var\": \"x\" } (a variable) or { \"entity\": { \"entity_type\": \"DeliveryStatus\", \"name\": \"Complete\" } } (a fixed entity used as a constant in the body or head)"
-            },
-            "predicate": {
-              "description": "Relation name. In a rule body, the reserved \"rdf:type\" makes a type-membership constraint: the object names a class ({ entity: { entity_type: \"Contact\" } }, no name) and matches every entity of that class and its subtypes (rdfs:subClassOf closure), so one rule keyed on a supertype fires for all subtypes. Not allowed in a head or an exists/not_exists filter.",
-              "type": "string"
-            },
-            "subject": {
-              "anyOf": [
-                {
-                  "additionalProperties": true,
-                  "properties": {
-                    "var": {
-                      "description": "A variable, joined across patterns by name",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "var"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": true,
-                  "properties": {
-                    "entity": {
-                      "additionalProperties": true,
-                      "properties": {
-                        "entity_id": {
-                          "description": "Entity id (hex), as an alternative to type+name",
-                          "type": "string"
-                        },
-                        "entity_type": {
-                          "description": "Entity type name (with `name`, names a fixed entity)",
-                          "type": "string"
-                        },
-                        "name": {
-                          "description": "Entity name (paired with `entity_type`)",
-                          "type": "string"
-                        }
-                      },
-                      "type": "object"
-                    }
-                  },
-                  "required": [
-                    "entity"
-                  ],
-                  "type": "object"
-                }
-              ],
-              "description": "A rule term: { \"var\": \"x\" } (a variable) or { \"entity\": { \"entity_type\": \"DeliveryStatus\", \"name\": \"Complete\" } } (a fixed entity used as a constant in the body or head)"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "combinators": {
-        "description": "exists/not_exists filters folded over the body. not_exists is stratified negation — it lets a rule express a universal condition, e.g. derive \"phase complete\" only when not_exists an incomplete deliverable. A negation cycle is rejected.",
-        "items": {
-          "anyOf": [
-            {
-              "additionalProperties": true,
-              "properties": {
-                "exists": {
-                  "items": {
-                    "$ref": "#/properties/rules/items/properties/body/items"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "exists"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": true,
-              "properties": {
-                "not_exists": {
-                  "items": {
-                    "$ref": "#/properties/rules/items/properties/body/items"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "not_exists"
-              ],
-              "type": "object"
-            }
-          ],
-          "description": "An existence filter over the body solutions: { exists: [...] } (semijoin — keep rows with a compatible match) or { not_exists: [...] } (negation/antijoin — keep rows with none)"
-        },
-        "type": "array"
-      },
-      "head": {
-        "$ref": "#/properties/rules/items/properties/body/items",
-        "description": "The triple derived once per body solution. Every head variable must be bound by the body; a fixed-entity object derives a constant (e.g. set the rolled-up status to the Complete entity)."
-      },
-      "name": {
-        "type": "string"
-      },
-      "order": {
-        "description": "Run order, low to high (a determinism hint)",
-        "type": "integer"
-      }
-    },
-    "required": [
-      "name"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

First observedv0.2.1Jul 11, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the destructiveHint annotation: it discloses that removal ops and desired_mode=reject trigger MCP form elicitation, that nothing is sent on decline (approval_declined) or when the client cannot render the question (approval_required), and the LBB_MCP_DESTRUCTIVE=allow escape hatch. It also notes that publication enqueues durable conformance and that a preview does not validate the whole graph. It stops short of saying what happens to existing data on tombstoning, which the schema covers.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence front-loads the purpose, but the body is a single run-on block of parenthetical clauses chained with semicolons, making the eight actions hard to scan. Content largely earns its place, but the lack of any list or paragraph break hurts retrievability for an agent.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 27-parameter, eight-variant, destructive, no-output-schema tool, the description covers the highest-risk hidden behaviors: approval gating, dry_run semantics, starter conflicts, and the RDF-vs-native boundary. It leaves several less-risky parameters undiscussed, but those are described in the schema at 67% coverage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 27 parameters and 67% schema coverage, the description adds real meaning for the tricky ones: expected_version must be the version get_rewrite_profile returned, facts are committed only after acceptance and change may be empty when facts is set, starter ids are crm/documents/work, and ops are applied in order including add_super_types. Many parameters (anchor, graph, shapes, format, ontology.source, entity_types, relations, merge_default, confirm_restrictive) get no mention, so it does not fully compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific framing ('Manage native schema metadata') and then defines each of the eight actions in concrete verb+resource terms (define_ontology, apply_starter, publish_schema, suggest_ontology_change, get/set_rewrite_profile). It actively separates itself from siblings: 'Use lbb_rdf import for full OWL and lbb_rdf update for additive INSERT DATA revisions' and 'use define/evolve for native ontology changes' rather than publish_schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit routing is given for the ambiguous cases: prefer suggest_ontology_change 'when the graph's owner reviews ontology changes' and list the result via lbb_inspect action=ontology_suggestions; use lbb_rdf import for full OWL; use define/evolve instead of publish_schema for native changes. It also states when apply_starter is refused (starter_conflict) and that dry_run is available on define, evolve, publish and set_rewrite_profile.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

lbb_configure

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools