Powered by AppSignal & Oban Pro
Notesclub
Sign in with GitHub
created by hec & contributors
terms privacy

ArtefactKino

artefact_kino/artefact_kino.livemd

avatar
diffo.dev
avatar
avatar
Share to X
Share to Bluesky
More notebooks

ArtefactKino

Mix.install([
  {:artefact_kino, "~> 0.1.1"},
  {:req, "~> 0.5"}
])

Overview

This livebook is about both Artefact and ArtefactKino.

Artefacts (note Australian spelling) are made objects, and in our universe (an Artefactory) these represent a fragment of knowledge, typically: abstract, insightful, contextual.

Artefacts may also be stored/manipulated in an Artefactory. While Artefacts may be generated and exchanged, our interpretation of them is our own.

As we yarn we naturally exchange and create Artefacts.

ArtefactKino is a Livebook Kino for viewing an Artefact. It isn’t an editor.

Us Two

Us Two is the fundamental concept in Agent Society. Matt and Claude yarned about Us Two and memorialized our shared understanding in a the us_two Artefact.

In the cell below us_two is an Artefact struct, you can edit it and change how it renders in the livebook.

I’ve drawn it, so from my perspective (Matt - Me) I’ve got an US_TWO relationship with (claude: You).

Try highlighting nodes and relationships in the graph. Explore the Artefact struct, and have examine the create and merge cypher.

require Artefact

us_two = Artefact.new(
  title: "UsTwo",
  base_label: "UsTwo",
  nodes: [
    matt:   [labels: ["Agent", "Me"],  properties: %{"name" => "Matt"},
             uuid: "019da897-f2de-77ca-b5a4-40f0c3730943"],
    claude: [labels: ["Agent", "You"], properties: %{"name" => "Claude"},
             uuid: "019da897-f2de-768c-94e2-3005f2431f37"]
  ],
  relationships: [
    [from: :matt, type: "US_TWO", to: :claude]
  ]
)

ArtefactKino.new(us_two)

Harmonising Artefacts

The Harmonising Artefact memorialises concepts involved in combining knowledge. As this one is a bit more complicated we’ve just loaded Arrows.App JSON.

artefact =
  Req.get!("https://raw.githubusercontent.com/diffo-dev/artefactory/dev/artefact/test/data/artefact_harmonise/arrows.json", decode_body: false).body
  |> Artefact.Arrows.from_json!()

ArtefactKino.new(artefact)

Harmonizing Artefacts with Bindings

require Artefact

base_url = "https://raw.githubusercontent.com/diffo-dev/artefactory/dev/artefact/test/data"

artefact =
  Req.get!("#{base_url}/artefact/arrows.json", decode_body: false).body
  |> Artefact.Arrows.from_json!()

create_merge =
  Req.get!("#{base_url}/create_merge/arrows.json", decode_body: false).body
  |> Artefact.Arrows.from_json!()

{:ok, bindings} = Artefact.Binding.find(artefact, create_merge)
harmonised = Artefact.harmonise(artefact, create_merge, bindings)

ArtefactKino.new(harmonised)

In this Kino we produce a new Artefact from two which share a common node.

Binding.find() finds bindings. Artefact.harmonise() creates the new combined Artefact.

Harmonise merges labels and properties of bound nodes, and properties of bound relationships. The left side (heart-side) is the knowledge we hold most dear. Properties with the same key and different value have the value have heart side precedence.

The knowledge we have harmonized here is ArtefactCreateMerge, a combination of Artefact and the CreateMerge Artefacts.

What Next?

Artefacts are knowledge graph fragments. We like to store knowledge in graphical databases, so explore exporting cypher to a graph database with creat and merge. Review the CreateMerge Artifact to understand what create and merge are best for.

Artefacts are Elixir structs so can be peristed as using ETS or similar, and manipulated with code. Write some functions on Artefacts which abstract knowledge or even wisdom. Tell stories.

Experiment memorializing with Artefacts, particularly when yarning or creating with other intelligences, human or otherwise.

Yarn with us about what you’d want in Artefactory DSL, what an Artefactable Elixir Protocol should do, or anything else if you are strangely attracted.

Acknowledgements

Artefactory is new, but the ideas are not. At diffo-dev we are on a journey inspired by Indigenous Systems Thinking and offer our respect and gratitude for the profound wisdom presented by Tyson Yunkaporta in Sand Talk, grounded in countless years of sustainable, harmonious living.

Other notebooks:

Back