ArtefactKino

Copy Markdown View Source

Module Version Hex Docs License REUSE status Ask DeepWiki Run in Livebook

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, Arrows JSON, and Mermaid source. Click any panel to select all text for easy copying.

The Inspector and Export panels are both collapsible and start collapsed by default to give the graph room on bigger artefacts; selecting a node or relationship in the graph auto-expands the 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.