matrx-graph 0.2.332__py3-none-any.whl → 0.2.334__py3-none-any.whl

matrx_graph/overview.py

@@ -19,7 +19,9 @@ The spec has no place for the real node ids (Archify's node schema is closed), s
 
 ``definition_structure_hash`` is the staleness key: sha256 over the nodes (id, type) and the edges
 (source, target, kind) only — never positions, labels, config or any other cosmetic field — so
-dragging a node does not invalidate an overview and adding a connection does.
+dragging a node does not invalidate an overview and adding a connection does. Because the collapse
+also reads labels, lanes and the title, ``definition_collapse_hash`` covers those inputs; a host
+re-collapses when EITHER hash differs.
 """
 
 from __future__ import annotations
@@ -132,6 +134,23 @@ def definition_structure_hash(definition: Definition) -> str:
     return hashlib.sha256(payload.encode("utf-8")).hexdigest()
 
 
+def definition_collapse_hash(
+    definition: Definition, *, title: str = "Workflow overview", categories: dict[str, str] | None = None
+) -> str:
+    """sha256 over everything ``collapse_definition_detailed`` READS, so a stored overview is re-collapsed
+    whenever its picture could differ. Derived from the collapse code: per node, in definition order (the
+    order breaks ties), the id, the spec type, the plain-words label (``_label_of``: label, else id, else
+    spec tail) and the lane (``node_family``: registry category, ``data.category``, spec name); per edge
+    (sorted) source, target and kind; and the workflow title. Positions, config and every field the
+    collapse never reads are ignored, so dragging a node leaves it unchanged while renaming a step changes
+    it. Complements ``definition_structure_hash`` (which means STRUCTURE only); bump ``COLLAPSE_VERSION``
+    when the collapse starts reading something new."""
+    nodes = [[n.id, n.spec_type, _label_of(n), node_family(n, categories)] for n in definition.nodes]
+    edges = sorted((e.source, e.target, e.kind.value) for e in definition.edges)
+    payload = json.dumps({"title": title, "nodes": nodes, "edges": edges}, sort_keys=True, separators=(",", ":"))
+    return hashlib.sha256(payload.encode("utf-8")).hexdigest()
+
+
 # --------------------------------------------------------------------------- labels
 
 _STOPWORDS = frozenset({"the", "and", "for", "from", "with", "your", "step", "agent", "source", "run", "make", "new"})
@@ -199,6 +218,8 @@ class CollapseResult:
     hidden: list[str]
     structure_hash: str
     collapse_version: int = COLLAPSE_VERSION
+    #: ``definition_collapse_hash`` of the inputs this picture was built from.
+    collapse_hash: str = ""
 
 
 def collapse_definition(
@@ -392,7 +413,10 @@ def collapse_definition_detailed(
     if cards:
         spec["cards"] = cards
     node_map = {ids[k]: list(items[k].members) for k in items}
-    return CollapseResult(spec=spec, node_map=node_map, hidden=hidden, structure_hash=structure_hash)
+    return CollapseResult(
+        spec=spec, node_map=node_map, hidden=hidden, structure_hash=structure_hash,
+        collapse_hash=definition_collapse_hash(definition, title=title, categories=categories),
+    )
 
 
 # --------------------------------------------------------------------------- folding

matrx_graph/workers/job_lease.py

@@ -48,7 +48,8 @@ class JobLease:
     #: the copy finished its work and is settling the job (``complete``): a renewal that lands after the settle
     #: commits answers "not ours", and that is not a loss (K1b, M1)
     settling: bool = False
-    #: per-copy fencing token for anything this copy holds (an import slot): a newer copy's is always greater
+    #: per-copy fencing token for anything this copy holds (an import slot): a newer copy's is always greater. The
+    #: runner sets the job's attempt (bumped by every claim); a lease made by hand defaults to its creation time
     generation: float = field(default_factory=time.time)
     visibility_timeout: int = 600
     lost: bool = False

{matrx_graph-0.2.332.dist-info → matrx_graph-0.2.334.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-graph
-Version: 0.2.332
+Version: 0.2.334
 Summary: Channel-based, super-step workflow orchestration engine for the Matrx ecosystem
 Project-URL: Homepage, https://github.com/AI-Matrix-Engine/aidream-current
 Project-URL: Repository, https://github.com/AI-Matrix-Engine/aidream-current
@@ -19,14 +19,14 @@ Requires-Python: >=3.13
 Requires-Dist: croniter>=2.0
 Requires-Dist: httpx>=0.27
 Requires-Dist: jsonschema>=4.20
-Requires-Dist: matrx-connect>=0.1.236
+Requires-Dist: matrx-connect>=0.1.237
 Requires-Dist: matrx-utils>=2.0.83
 Requires-Dist: pydantic>=2.12
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: otel
 Requires-Dist: opentelemetry-api>=1.25; extra == 'otel'
 Provides-Extra: postgres
-Requires-Dist: matrx-orm>=3.1.242; extra == 'postgres'
+Requires-Dist: matrx-orm>=3.1.243; extra == 'postgres'
 Description-Content-Type: text/markdown
 
 # matrx-graph

{matrx_graph-0.2.332.dist-info → matrx_graph-0.2.334.dist-info}/RECORD

@@ -17,7 +17,7 @@ matrx_graph/kind_fields.py,sha256=6F9jmJNz9-104FSAqIwx8xcy5HqeeYxedgyoyPJf0mk,21
 matrx_graph/kinds.py,sha256=Uh1KmVBL46EpC4ojKCq7eOom8SVleEROUmRYzz27BU4,37751
 matrx_graph/knobs.py,sha256=tZMlF7YV3GZw3liccEnFdOkYBbvOeFxgc25oetdEOGo,22463
 matrx_graph/mapping_sources.py,sha256=8VGTbPmib7uyh2L8ZnjsJa6h57lKgz0JOpJ9fmkcYxU,3910
-matrx_graph/overview.py,sha256=3_hxx3dFZQtZkVE-9TcdU8udK4GWndnHKKPNU__aTws,24406
+matrx_graph/overview.py,sha256=gFDOBmZXZMePTpmhuoaanUMk1jS1aEabzp-kcrGEJeE,26081
 matrx_graph/patch.py,sha256=DCd7MioacEfcaPxuvrDZS9uxfUE-3EKN7FBL4vLc9y0,10675
 matrx_graph/paths.py,sha256=n2taRh5w2FiRZgrwnDMoipJ7xD-E-DposJAspge0kbE,3802
 matrx_graph/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -251,10 +251,10 @@ matrx_graph/workers/__init__.py,sha256=G8e24ryKLafH_NggiiGIb9EZ7YparOJ5DaBOw0bbP
 matrx_graph/workers/capability.py,sha256=9kFjZCfuie5GkevLLTBJVJ3m9NeeS36RJhbjK0r86fw,11058
 matrx_graph/workers/cron_watcher.py,sha256=JVzUJ7Wmtz9PPwUtkxnSyqkheK3nEM-7lHUlecdazYY,3988
 matrx_graph/workers/event_watcher.py,sha256=DYk4RgapiJJDyKY8zirBpp3HAlqi7BWExf4rWW97FHY,6263
-matrx_graph/workers/job_lease.py,sha256=pYZidqPB4hgHa8KKZqSJDGetsW7Wm_aVwSXM0ycrrfY,7213
+matrx_graph/workers/job_lease.py,sha256=6f-02QMfRDuh39dPr8FdNqsoX3SP-5XsmthxuWfiKww,7331
 matrx_graph/workers/queue.py,sha256=GGzuJju1DvrZFPbfvGQEMuWay-2m18NzZPNlWligS4Q,32413
 matrx_graph/workers/runner.py,sha256=6ALoNst6LY9pK-8I7r0QPLjdKpSfyimp5JwFb1PFdmI,23946
 matrx_graph/workers/sleep_wake.py,sha256=1V-opM2zYtuN3n4ez85C4trYHoEapVwz8F7_MAex8HI,5970
-matrx_graph-0.2.332.dist-info/METADATA,sha256=Xtv8QD6KJcjVl9GHAwEdySTwocg45udFubgG2r2VWYk,5480
-matrx_graph-0.2.332.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-matrx_graph-0.2.332.dist-info/RECORD,,
+matrx_graph-0.2.334.dist-info/METADATA,sha256=jYjh5pzwYSkINtlCky_o2JZwVaT8_5wFKjdU1lojBtM,5480
+matrx_graph-0.2.334.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+matrx_graph-0.2.334.dist-info/RECORD,,