Merge pull request #119 from diffo-dev/dev

dev

Author: matt-beanland

.formatter.exs

@@ -3,33 +3,46 @@
 # SPDX-License-Identifier: MIT
 
 # Used by "mix format"
-locals_without_parens = [
-  id: 1,
+spark_locals_without_parens = [
+  calculate: 1,
   category: 1,
-  is_enabled?: 1,
   characteristic: 2,
-  pick: 1,
-  rename: 1,
-  field: 3,
-  expect: 1,
-  relate: 1,
-  guard: 1,
-  customize: 1,
-  order: 1,
-  initial_states: 1,
-  default_initial_state: 1,
-  state_attribute: 1,
-  transition: 1,
-  compact: 1,
-  label: 1
+  characteristic: 3,
+  constraints: 1,
+  create: 1,
+  create: 2,
+  description: 1,
+  feature: 1,
+  feature: 2,
+  id: 1,
+  is_enabled?: 1,
+  major_version: 1,
+  minor_version: 1,
+  name: 1,
+  parties: 2,
+  parties: 3,
+  party: 2,
+  party: 3,
+  patch_version: 1,
+  place: 2,
+  place: 3,
+  places: 2,
+  places: 3,
+  reference: 1,
+  role: 2,
+  role: 3,
+  tmf_version: 1,
+  type: 1,
+  update: 1,
+  update: 2
 ]
 
 [
   plugins: [Spark.Formatter],
   inputs: ["{mix,.formatter}.exs", "{config,lib,test}/**/*.{ex,exs}"],
-  import_deps: [:ash],
-  locals_without_parens: locals_without_parens,
+  import_deps: [:ash, :ash_jason, :ash_neo4j, :ash_outstanding, :ash_state_machine],
+  locals_without_parens: spark_locals_without_parens,
   export: [
-    locals_without_parens: locals_without_parens
+    locals_without_parens: spark_locals_without_parens
   ]
 ]

.gitignore

@@ -27,4 +27,5 @@ diffo-*.tar
 .DS_Store
 
 # Agent related
-.claude/*
+.claude/*
+CLAUDE.md

CHANGELOG.md

@@ -11,6 +11,20 @@ See [Conventional Commits](Https://conventionalcommits.org) for commit guideline
 
 <!-- changelog -->
 
+## [v0.2.2](https://github.com/diffo-dev/diffo/compare/v0.2.1...v0.2.2) (2026-05-08)
+
+## Notable Changes
+* Updated to ash_neo4j 0.5.0 with async test support
+* Igniter installer — `mix igniter.install diffo` now sets up Neo4j config, custom expressions, and Spark DSL formatter
+* Spark DSL formatter configured for all provider extensions; `mix format` enforced across the codebase
+* `usage-rules.md` added for AI coding assistant guidance when working with Diffo
+
+## What's Changed
+* async tests by @matt-beanland in https://github.com/diffo-dev/diffo/pull/114
+* igniter by @matt-beanlanda in https://github.com/diffo-dev/diffo/pull/116
+* spark formatter by @matt-beanlanda in https://github.com/diffo-dev/diffo/pull/117
+* usage_rules by @matt-beanlanda in https://github.com/diffo-dev/diffo/pull/118
+
 ## [v0.2.1](https://github.com/diffo-dev/diffo/compare/v0.2.0...v0.2.1) (2026-05-06)
 
 ## Notable Changes

README.md

@@ -34,18 +34,25 @@ Diffo is especially suited for use in organisations with loosely coupled 'entity
 
 ## Installation
 
-If [available in Hex](https://hex.pm/docs/publish), the package can be installed
-by adding `diffo` to your list of dependencies in `mix.exs`:
+The recommended way to install Diffo is with [Igniter](https://hexdocs.pm/igniter):
+
+```bash
+mix igniter.install diffo
+```
+
+This will add the dependency, configure Neo4j (via `ash_neo4j`), register the custom expression, and set up the Spark formatter.
+
+Alternatively, add `diffo` to your list of dependencies in `mix.exs` manually:
 
 ```elixir
 def deps do
   [
-    {:diffo, "~> 0.1.6"}
+    {:diffo, "~> 0.2.1"}
   ]
 end
 ```
 
-You should need [Neo4j](https://github.com/neo4j/neo4j) available. We recommend the Neo4j Community 5 latest, available at [Neo4j Deploymnent Centre](https://neo4j.com/deployment-center/) which can be installed locally. You can also configure connection to a cloud based database service such as [Neo4j AuraDB](https://neo4j.com/product/auradb/).
+You will need [Neo4j](https://github.com/neo4j/neo4j) available. We recommend the Neo4j Community 5 latest, available at [Neo4j Deploymnent Centre](https://neo4j.com/deployment-center/) which can be installed locally. You can also configure connection to a cloud based database service such as [Neo4j AuraDB](https://neo4j.com/product/auradb/).
 
 ## Tutorial
 

diffo.livemd

@@ -9,7 +9,7 @@ SPDX-License-Identifier: MIT
 ```elixir
 Mix.install(
   [
-    {:diffo, "~> 0.2.1"}
+    {:diffo, "~> 0.2.2"}
   ],
   consolidate_protocols: false
 )

lib/diffo/provider/assigner/assignment.ex

@@ -42,5 +42,4 @@ defmodule Diffo.Provider.Assignment do
       inspect(struct)
     end
   end
-
 end

lib/diffo/provider/components/entity.ex

@@ -140,5 +140,4 @@ defmodule Diffo.Provider.Entity do
   preparations do
     prepare build(sort: [id: :asc])
   end
-
 end

lib/diffo/provider/components/entity_ref.ex

@@ -121,5 +121,4 @@ defmodule Diffo.Provider.EntityRef do
   preparations do
     prepare build(load: [:entity], sort: [created_at: :desc])
   end
-
 end

lib/diffo/provider/components/event.ex

@@ -153,5 +153,4 @@ defmodule Diffo.Provider.Event do
       Diffo.Util.to_iso8601(record.created_at)
     )
   end
-
 end

lib/diffo/provider/components/external_identifier.ex

@@ -144,5 +144,4 @@ defmodule Diffo.Provider.ExternalIdentifier do
   preparations do
     prepare build(load: [:owner], sort: [created_at: :desc])
   end
-
 end