diffo-dev · matt-beanland · May 7, 2026 · May 7, 2026 · May 7, 2026 · May 7, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,25 +11,14 @@ See [Conventional Commits](Https://conventionalcommits.org) for commit guideline
 
 <!-- changelog -->
 
-## [v0.0.1](https://github.com/diffo-dev/diffo/compare/v0.0.1..v0.0.1) (2025-10-20)
-
-### Features:
-* initial version
-
-## [v0.0.2](https://github.com/diffo-dev/diffo/compare/v0.0.1..v0.0.2) (2025-12-01)
+## [v0.2.1](https://github.com/diffo-dev/diffo/compare/v0.2.0..v0.2.1) (2026-05-07)
 
 ### Maintenance:
-* updated to diffo 0.1.3
+* updated to diffo 0.2.1
 
-## [v0.0.3](https://github.com/diffo-dev/diffo/compare/v0.0.2..v0.0.3) (2026-03-13)
-
-### Maintenance:
-* updated to diffo 0.1.4, using ash_neo4j 0.2.13 using fork bolty 0.0.7 rather than boltx 0.0.6
-
-## [v0.0.4](https://github.com/diffo-dev/diffo/compare/v0.0.3..v0.0.4) (2026-03-19)
-
-### Fixes:
-* fixed relationship enrichment inconsistent across neo4j versions
+### Features:
+* using transactions and test sandbox
+* using improved provider DSL
 
 ## [v0.2.0](https://github.com/diffo-dev/diffo/compare/v0.0.4..v0.2.0) (2026-04-26)
 
@@ -43,4 +32,25 @@ See [Conventional Commits](Https://conventionalcommits.org) for commit guideline
 * RSP multi-tenancy: SetRspId change, OwnedByActor and NoActor policy checks, RspOwnership macro shared across RSP-owned resources
 * NTD and UNI modelled as NBN-owned infrastructure — readable by any RSP, mutable only by internal calls
 * Interactive NBN livebook with Kino RSP selector and actor-scoped provisioning flow
-* NBN domain documentation including Perentie ecosystem narrative
+* NBN domain documentation including Perentie ecosystem narrative
+
+## [v0.0.4](https://github.com/diffo-dev/diffo/compare/v0.0.3..v0.0.4) (2026-03-19)
+
+### Fixes:
+* fixed relationship enrichment inconsistent across neo4j versions
+
+## [v0.0.3](https://github.com/diffo-dev/diffo/compare/v0.0.2..v0.0.3) (2026-03-13)
+
+### Maintenance:
+* updated to diffo 0.1.4, using ash_neo4j 0.2.13 using fork bolty 0.0.7 rather than boltx 0.0.6
+
+## [v0.0.2](https://github.com/diffo-dev/diffo/compare/v0.0.1..v0.0.2) (2025-12-01)
+
+### Maintenance:
+* updated to diffo 0.1.3
+
+## [v0.0.1](https://github.com/diffo-dev/diffo/compare/v0.0.1..v0.0.1) (2025-10-20)
+
+### Features:
+* initial version
+
diff --git a/documentation/domains/diffo_example_nbn.livemd b/documentation/domains/diffo_example_nbn.livemd
@@ -9,9 +9,8 @@ SPDX-License-Identifier: MIT
 ```elixir
 Mix.install(
   [
-    # {:diffo_example, "~> 0.3.0"},
-    {:diffo_example, github: "diffo-dev/diffo_example", branch: "dev"},
-    {:diffo, github: "diffo-dev/diffo", branch: "dev", override: true},
+    {:diffo_example, "~> 0.2.1"},
+    {:diffo, "~> 0.4.1"},
     {:kino, "~> 0.14"},
     {:req, "~> 0.5"}
   ],

diff --git a/lib/diffo_example/application.ex b/lib/diffo_example/application.ex
@@ -10,12 +10,14 @@ defmodule DiffoExample.Application do
   @impl true
   def start(_type, _args) do
     children =
-      [
-        {Task, &DiffoExample.Nbn.Initializer.init/0}
-      ] ++
-        if Mix.env() == :test,
-          do: [],
-          else: [{Plug.Cowboy, scheme: :http, plug: DiffoExample.Nbn.Router, options: [port: 4000]}]
+      if Mix.env() == :test do
+        []
+      else
+        [
+          {Task, &DiffoExample.Nbn.Initializer.init/0},
+          {Plug.Cowboy, scheme: :http, plug: DiffoExample.Nbn.Router, options: [port: 4000]}
+        ]
+      end
 
     Supervisor.start_link(children, strategy: :one_for_one, name: DiffoExample.Supervisor)
   end

diff --git a/lib/nbn/initializer.ex b/lib/nbn/initializer.ex
@@ -19,7 +19,7 @@ defmodule DiffoExample.Nbn.Initializer do
     %{name: "Taipan Group",       short_name: :taipan,    id: "0004"},
     %{name: "Echidna Networks",   short_name: :echidna,   id: "0005"},
     %{name: "Dugong Digital",     short_name: :dugong,    id: "0006"},
-    %{name: "Lyrebird",           short_name: :lyrebird,  id: "0007"}
+    #%{name: "Lyrebird",           short_name: :lyrebird,  id: "0007"}
   ]
 
   def init do

diff --git a/lib/nbn/resources/rsp.ex b/lib/nbn/resources/rsp.ex
@@ -65,10 +65,11 @@ defmodule DiffoExample.Nbn.Rsp do
 
   instances do
     role :owner, DiffoExample.Nbn.Avc
-    role :owner, DiffoExample.Nbn.Cvc
-    role :owner, DiffoExample.Nbn.Nni
-    role :owner, DiffoExample.Nbn.NniGroup
-    role :owner, DiffoExample.Nbn.NbnEthernet
+    # pending resolution of /diffo-dev/diffo#101
+    #role :owner, DiffoExample.Nbn.Cvc
+    #role :owner, DiffoExample.Nbn.Nni
+    #role :owner, DiffoExample.Nbn.NniGroup
+    #role :owner, DiffoExample.Nbn.NbnEthernet
   end
 
   actions do

diff --git a/mix.exs b/mix.exs
@@ -6,7 +6,7 @@ defmodule DiffoExample.MixProject do
   @moduledoc false
   use Mix.Project
 
-  @version "0.2.0"
+  @version "0.2.1"
   @name "DiffoExample"
   @description "Examples for Diffo TMF Service and Resource Manager"
   @github_url "https://github.com/diffo-dev/diffo-example"
@@ -86,7 +86,7 @@ defmodule DiffoExample.MixProject do
   # Run "mix help deps" to learn about dependencies.
   defp deps do
     [
-      {:diffo, diffo_version([path: "../diffo"])},
+      {:diffo, diffo_version("~> 0.2.1")},
       {:ash_json_api, "~> 1.6"},
       {:plug_cowboy, "~> 2.7"},
       {:req, "~> 0.5", only: [:dev, :test]},

diff --git a/mix.lock b/mix.lock
diff --git a/test/access/cable_test.exs b/test/access/cable_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExample.Access.CableTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Characteristic
   alias Diffo.Provider.Assignment
@@ -13,14 +13,9 @@ defmodule DiffoExample.Access.CableTest do
   alias DiffoExample.Access.IntegerUnit
   alias DiffoExample.Test.Characteristics
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "build cable" do

diff --git a/test/access/card_test.exs b/test/access/card_test.exs
@@ -4,22 +4,17 @@
 
 defmodule DiffoExample.Access.CardTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Characteristic
   alias Diffo.Provider.Assignment
   alias DiffoExample.Access
   alias DiffoExample.Access.Card
   alias DiffoExample.Test.Characteristics
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "build card" do

diff --git a/test/access/characteristic_value_test.exs b/test/access/characteristic_value_test.exs
@@ -4,22 +4,17 @@
 
 defmodule DiffoExample.Access.CharacteristicValueTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias DiffoExample.Access.AggregateInterface
   alias DiffoExample.Access.Circuit
   alias DiffoExample.Access.Dslam
   alias DiffoExample.Access.Line
   alias DiffoExample.Access.BandwidthProfile
   alias Diffo.Type.Value
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   @dslam "QDONC0001"

diff --git a/test/access/dsl_access_test.exs b/test/access/dsl_access_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExample.Access.DslAccessTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Feature
@@ -16,14 +16,9 @@ defmodule DiffoExample.Access.DslAccessTest do
   alias DiffoExample.Test.Parties
   alias DiffoExample.Test.Places
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "service qualification" do

diff --git a/test/access/path_test.exs b/test/access/path_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExample.Access.PathTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Characteristic
@@ -17,14 +17,9 @@ defmodule DiffoExample.Access.PathTest do
   alias DiffoExample.Test.Parties
   alias DiffoExample.Test.Places
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "build path" do

diff --git a/test/access/shelf_test.exs b/test/access/shelf_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExample.Access.ShelfTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Characteristic
@@ -18,14 +18,9 @@ defmodule DiffoExample.Access.ShelfTest do
   alias DiffoExample.Test.Parties
   alias DiffoExample.Test.Places
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "build shelf" do

diff --git a/test/diffo_example_test.exs b/test/diffo_example_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExampleTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   doctest DiffoExample.Access.Util
   doctest DiffoExample.Nbn.Util
   doctest DiffoExample.Nbn.Speeds

diff --git a/test/nbn/nbn_ethernet_test.exs b/test/nbn/nbn_ethernet_test.exs
@@ -4,7 +4,7 @@
 
 defmodule DiffoExample.Nbn.NbnEthernetTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true
   alias Diffo.Provider.Specification
   alias Diffo.Provider.Characteristic
   alias DiffoExample.Nbn
@@ -19,14 +19,9 @@ defmodule DiffoExample.Nbn.NbnEthernetTest do
   alias Diffo.Provider.Assignment
   alias Diffo.Provider.Instance.Relationship
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   describe "build nbn_ethernet" do

diff --git a/test/nbn/rsp_test.exs b/test/nbn/rsp_test.exs
@@ -4,18 +4,13 @@
 
 defmodule DiffoExample.Nbn.RspTest do
   @moduledoc false
-  use ExUnit.Case
+  use ExUnit.Case, async: true, async: true
   alias DiffoExample.Nbn
   alias DiffoExample.Nbn.Rsp
 
-  setup_all do
-    AshNeo4j.BoltyHelper.start()
-  end
-
   setup do
-    on_exit(fn ->
-      AshNeo4j.Neo4jHelper.delete_all()
-    end)
+    AshNeo4j.Sandbox.checkout()
+    on_exit(&AshNeo4j.Sandbox.rollback/0)
   end
 
   defp create_rsp(attrs) do

diff --git a/test/test_helper.exs b/test/test_helper.exs
@@ -3,7 +3,8 @@
 # SPDX-License-Identifier: MIT
 
 Mix.Task.run("app.start")
-ExUnit.start()
 level = Application.get_env(:logger, :console) |> Keyword.get(:level)
 Logger.put_application_level(:diffo, level)
 Logger.put_application_level(:ash_neo4j, :error)
+AshNeo4j.Neo4jHelper.delete_all()
+ExUnit.start()