Work graph → visual workspace bridge

2 min readReferenceUpdated 2026-05-22

What you'll find here

The bridge that projects craik.work_graph_export records into portable visual workspace records — and the boundary that keeps the projection read-only.

Read-only projection.

The bridge does not mutate the work graph. It creates a read-only projection that a visual surface can render while preserving source node and edge ids.

Records

Record

Captures

Fields

WorkGraphVisualWorkspace

projection

Source graph id · task id · visual nodes · visual edges · policy envelope ids · evidence ids · receipt ids · redacted paths · redaction status.

VisualWorkspaceNode

node

Visual node id · source work-graph node id · type · label · deterministic layout coordinates · redacted metadata.

VisualWorkspaceEdge

edge

Visual edge id · source work-graph edge id · type · visual source node id · visual target node id · redacted metadata.

Boundary

Portable visual state.

The bridge uses deterministic layout hints instead of storing editor-specific canvas state. Consumers can apply their own layout while keeping the source links.

Redaction

Node labels and metadata pass through shared redaction. The visual workspace record preserves evidence, receipt, and policy references without copying raw private payloads.

What's next

ReferenceVisual workspace decisionWhether a surface may render or interact with the projection.ReferenceGraph exportThe source record this bridge projects.ReferenceMultimodal artifact referencesHow visual surfaces cite media without raw payloads.