relation-creation

## Prerequisites Before creating relations, ensure you are on the correct workspace and branch. Use `get_session_workspace_and_branch` to check the current session context. For development work, create a branch with `create_workspace_branch` (the session switches automatically). See the `workspace-branch` skill for the full workspace/branch tool reference. --- ## Overview A Honeydew **relation** defines how two entities join together. Relations are not standalone objects — they live inside the **source entity's YAML** as a `relations:` block. Every relation connects the "many" side to the "one" side: for example, `orders` (many) → `customers` (one). Relations enable: - Metrics on one entity to reference attributes from another - Cross-entity calculated attributes (Multi-Entity type) - Filter propagation between entities in BI queries > Relations are defined on the source entity. To add a relation, use `update_object` on the entity that holds the foreign key (the "many" side). --- ## Creation Methods ### Primary: update_object on the Source Entity There is no `create_relation` tool. Adding a relation means updating the source entity's YAML to include the `relations:` block. Call `update_object` with: - `yaml_text` — the full updated entity YAML with the `relations:` block - `object_key` — the entity's object key (find via `list_entities` or `get_entity`) Required permission: Editor or higher. ### After Creation/Update: Display the UI Link After a successful `up...