ArtefactKino

A Livebook Kino widget for viewing Artefact knowledge graph fragments.

ArtefactKino is a viewer, not an editor. It renders three panels side by side:

• Graph (heartside) — an interactive vis-network graph. Nodes are colour-coded by label, with colours blended for multi-label nodes using circular hue averaging in linear RGB space. Layout strategies: Physics, Hierarchical, Radial.
• Inspector — tabbed Elixir view of the artefact struct, nodes table, and relationships table. Clicking a node or relationship in the graph navigates to and highlights the corresponding row.
• Export — CREATE Cypher, MERGE Cypher, and Arrows JSON. Click any panel to select all text for easy copying. The export panel is collapsible to give more space to the graph and inspector.

MERGE Cypher upserts nodes by uuid — safe to run repeatedly. CREATE always makes new nodes. See the CreateMerge artefact for a visual explanation of the difference.

Installation

def deps do
  [
    {:artefact_kino, "~> 0.1"}
  ]
end

Usage

ArtefactKino.new(artefact)
ArtefactKino.new(artefact, default: :merge)

See the livebook for interactive examples including building an artefact from a struct, loading from Arrows JSON, and viewing a harmonised artefact.

Acknowledgements

Artefactory is inspired by Indigenous Systems Thinking and the profound wisdom presented by Tyson Yunkaporta in Sand Talk, grounded in countless years of sustainable, harmonious living.

License

MIT — see LICENSES/MIT.txt.