> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cielara.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# World Model

> An interactive topology graph of your services, dependencies, and infrastructure.

The World Model is a continuously updated graph of your services and how they connect. Click **World Model** in the sidebar to open the page.

The page renders a full-screen interactive canvas. Services appear as card-shaped nodes inside nested cluster and namespace containers, with animated flow dots traveling along edges to show call direction.

## What the Graph Shows

Nodes represent different entity types across your estate:

* Workloads (APIs, background workers, and other services)
* Data stores (databases, caches, queues)
* External services (third-party APIs, SaaS dependencies)
* Infrastructure (clusters, namespaces, deployments, pods, service accounts)
* Repositories linked to workloads
* PagerDuty services, Jira projects, and wiki documents

Edges show relationships: calls, depends-on, publishes-to, reads-from, deployed-in, owns.

Nodes are color-coded by ontology layer (Logic, Topology, Runtime, Intent, Policy, Persona, Auth). A legend in the corner explains the color mapping for layers, edges, and containers.

## Layout

The graph uses a grouped layout: workloads are nested inside cluster and namespace container boxes. Cross-container relationships show as bundled lines between container borders. Hover a bundle to see the count and type breakdown.

Cards inside a box sit on a grid by default. To change how they are arranged, use the **Layout** picker in the **View** section of the side panel. The choice is not saved, so the graph returns to Grid when you reload the page.

| Layout | How it arranges cards | Best for |
| - | - | - |
| **Grid** (default) | Rows and columns, ordered by layer, then kind, then name. Connections are ignored. | A predictable read of what is in a box. |
| **Layered** | Top-down hierarchy. Cards with nothing pointing at them go on the top row, and each row below is one hop further down. | Following the direction a dependency runs. |
| **Tree** | The same hierarchy turned to run left to right. | Long chains, which get too tall to read top-down. |
| **Force** | A spring simulation. Connected cards pull together, unconnected ones push apart. | Spotting tightly coupled clusters inside a box. |
| **Radial** | Rings around the most-connected card, with busier branches given a wider slice. | Seeing what surrounds one central card. |
| **Stress** | Spacing where on-screen distance approximates the number of hops between cards. | Dense boxes, where the hierarchy layouts tangle. |

## Interacting with Nodes

Click a node to select it and open the detail panel on the right. The panel shows the node's properties, layer, kind, health, connections (inbound and outbound with relationship types), and links to external systems (GitHub, cloud console, PagerDuty).

Right-click a node to open a context menu:

* **Ask Cielara about this**: opens Ask Cielara with a prompt already written, describing the node's kind, layer, repository, and its relationships on the graph.
* **Add to favorites** / **Remove from favorites**: stars or unstars the node.
* **Focus**: filters the graph to the node's neighborhood at the current depth.
* **Hide this node**: removes the node from the canvas.
* **Expand children**: brings the node's children and parents into view.
* **Collapse children**: hides the node's children again.
* **Collapse all**: collapses every expanded node on the canvas.

Right-clicking a workload in the sidebar that is not yet drawn shows a single **Add to canvas** option instead.

Focus hides everything outside the selected node's neighborhood. While a focus is active, a **Depth** slider appears at the top right of the canvas. It starts at 1 hop and goes up to the point where the whole connected neighborhood is covered, and the readout beside it shows how many nodes the current depth reaches. The context menu always focuses at whatever depth the slider is set to.

To return to the full graph, click **Reset view** in the toolbar. It appears whenever something is hidden or filtered, and it clears hidden nodes, layer filters, the favorites filter, and the active focus.

Favorite a node from the context menu or by clicking the star on its card. Favorites are stored per user on the server, so your starred nodes follow you across browsers and machines. Once you have at least one, a **Favorites** chip in the filter bar narrows the graph to your starred nodes and their direct neighbors. You can star up to 500 nodes.

Hover a node to highlight it and its connected edges, dimming everything else. Click the doc badge on a node (e.g., "3 docs") to see a popover listing linked wiki documents. Drag a node to reposition it within its container.

## Interacting with Edges

Hover an edge to highlight it and both endpoints. Click an edge to select it and open an edge detail panel showing the relationship type, source, target, and properties.

## Service Detail Page

Click **View full details** in a node's detail panel to open a dedicated page for that service. Overview shows the service's properties along with its linked documents, PagerDuty services, and Jira issues. Connections lists its outbound calls. History shows past Foresight reviews and any incidents involving the service. A fourth tab collects links out to GitHub and your cloud console, along with runtime details such as Kubernetes pods and GCP VMs.

## Ask Cielara Integration

Right-click any node and select **Ask Cielara** to open the AI assistant with a prompt already describing that node and its relationships, so you can go straight to your question.

Ask Cielara can also embed the World Model view inline in a chat conversation.

## Navigation

Use the search bar at the top of the canvas to find a service by name. The graph zooms to the matching node and highlights it.

Pan by dragging the background, and zoom with your mouse or trackpad. Zoom controls (in, out, fit-view) sit in the bottom-left corner. Fit-view frames the whole graph again. A minimap appears in the corner for orientation on large graphs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.