dialectical-framework 1.2.3__tar.gz → 1.2.5__tar.gz

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dialectical-framework
-Version: 1.2.3
+Version: 1.2.5
 Summary: A dialectical framework for augmented intelligence. AI reasoning powered with dialectics supports humans in: system optimization (psychology, engineering, business, politics, etc.); dispute resolution (mediation, conflicts, negotiations, etc.); decision-making (dilemmas, challenging situations, win-win, etc.).
 License: MIT
 Keywords: dialectics,dialectical-reasoning,synthesis,thesis-antithesis,ai,artificial-intelligence,llm,reasoning-framework,philosophy,logic,argumentation,conflict-resolution,decision-making,critical-thinking,semantic-graph,mirascope,pydantic,perspectives,polarity-reasoning

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dialectical-framework"
-version = "1.2.3"
+version = "1.2.5"
 description = "A dialectical framework for augmented intelligence. AI reasoning powered with dialectics supports humans in: system optimization (psychology, engineering, business, politics, etc.); dispute resolution (mediation, conflicts, negotiations, etc.); decision-making (dilemmas, challenging situations, win-win, etc.)."
 authors = ["Evaldas Taroza <evaldas@dialexity.com>"]
 readme = "README.md"

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/agents/explorer/skills/build_wheels.py

@@ -171,7 +171,7 @@ class BuildWheels(ReasonableConcern[BuildWheelsResult]):
         self._report.artifacts["cycle_intent"] = cycle_intent
 
         # 3. Resolve Perspectives
-        perspectives = self._resolve_perspectives()
+        perspectives = self._resolve_perspectives(nexus)
 
         if not perspectives:
             self._report.summary = (
@@ -358,18 +358,21 @@ class BuildWheels(ReasonableConcern[BuildWheelsResult]):
 
         return CausalityPreset.BALANCED
 
-    def _resolve_perspectives(self) -> list[Perspective]:
-        """Resolve Perspectives from hashes or prefixes."""
+    def _resolve_perspectives(self, nexus: Nexus) -> list[Perspective]:
+        """Resolve Perspectives from explicit hashes, falling back to Nexus members."""
         from dialectical_framework.graph.nodes.perspective import Perspective
 
-        repo = NodeRepository()
-        perspectives = []
-        for pp_hash in self.perspective_hashes:
-            node = repo.find_by_hash(pp_hash, node_type=Perspective)
-            if node is None:
-                raise ValueError(f"Perspective not found: {pp_hash}")
-            perspectives.append(node)
-        return perspectives
+        if self.perspective_hashes:
+            repo = NodeRepository()
+            perspectives = []
+            for pp_hash in self.perspective_hashes:
+                node = repo.find_by_hash(pp_hash, node_type=Perspective)
+                if node is None:
+                    raise ValueError(f"Perspective not found: {pp_hash}")
+                perspectives.append(node)
+            return perspectives
+
+        return [pp for pp, _ in nexus.perspectives.all() if not pp.discarded]
 
 
 @llm.tool

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/agents/orchestrator/tools/get_schema.py

@@ -36,6 +36,8 @@ GRAPH_SCHEMA = """## Graph Schema
 
 All nodes share: `hash` (content-addressable ID), `sid` (session scope), `committed_at`.
 
+**Important:** Only query committed nodes. Always add `WHERE n.hash IS NOT NULL` to filter out incomplete (in-progress or abandoned) nodes. Nodes with `hash IS NULL` are not yet finalized and must not be included in results.
+
 ### Relationship Edge Properties
 
 **Polarity positions** (T, A, T_PLUS, T_MINUS, A_PLUS, A_MINUS relationships) carry:

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/mixins/incremental_build_mixin.py

@@ -16,7 +16,7 @@ The pattern follows git's staging area concept:
 from __future__ import annotations
 
 import time
-from typing import TYPE_CHECKING, Any, Iterator, Union
+from typing import TYPE_CHECKING, Any, Iterator, Self, Union
 
 from dependency_injector.wiring import Provide, inject
 from gqlalchemy import Memgraph, Neo4j
@@ -37,9 +37,9 @@ class IncrementalBuildMixin(PersistableMixin):
 
     Lifecycle:
         1. Create node: cycle = Cycle(intent="...")
-        2. Save as HEAD: cycle.save()  # hash=None, committed_at=None, persisted
+        2. Save as HEAD: cycle.save()  # hash=None, saved_at=now, persisted
         3. Add children: cycle.set_perspectives([pp1, pp2])
-        4. Commit: cycle.commit()  # committed_at set, hash computed, immutable
+        4. Commit: cycle.commit()  # committed_at set, hash computed, saved_at cleared
 
     After commit(), the node behaves like any other committed node.
 
@@ -52,6 +52,26 @@ class IncrementalBuildMixin(PersistableMixin):
     _id: Any
     committed_at: float | None
 
+    # Tracks when save() persisted this node before commit.
+    # Non-null means the node is being built. Cleared on commit().
+    # Stale values (old timestamps with no commit) indicate abandoned garbage.
+    saved_at: float | None
+
+    @inject
+    def save(
+        self,
+        graph_db: Union[Memgraph, Neo4j] = Provide[DI.graph_db],
+    ) -> Self:
+        """
+        Persist this node as HEAD state, recording saved_at timestamp.
+
+        saved_at marks that this node is actively being built. It is cleared
+        on commit(). A stale saved_at with no commit indicates abandoned garbage.
+        """
+        if not self.is_committed:
+            self.saved_at = time.time()
+        return super().save(graph_db=graph_db)
+
     def _get_commit_dependents(self) -> Iterator[BaseNode]:
         """
         Get all committed children for hash computation.
@@ -111,6 +131,7 @@ class IncrementalBuildMixin(PersistableMixin):
 
         # Set committed_at BEFORE computing hash (it's part of the hash for structural nodes)
         self.committed_at = time.time()
+        self.saved_at = None
         self.hash = self.compute_hash()
 
         # No dedup for container nodes - they have relationships attached by commit time.

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/nodes/transformation.py

@@ -12,6 +12,7 @@ Transformation alternatives at different insight/proactiveness levels.
 from __future__ import annotations
 
 import re
+import time
 from typing import ClassVar, Optional, TYPE_CHECKING, Union, Self
 
 from dependency_injector.wiring import Provide, inject
@@ -344,6 +345,7 @@ class Transformation(IncrementalBuildMixin, IntentMixin, AssessableEntity, label
         """
         # Auto-save if not already saved (allows calling commit() directly)
         if self._id is None:
+            self.saved_at = time.time()
             result = graph_db.save_node(self)
             if result is not None and result._id is not None:
                 self._id = result._id

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/nodes/wheel.py

@@ -193,6 +193,11 @@ class Wheel(IncrementalBuildMixin, IntentMixin, AssessableEntity, label="Wheel")
         result: list[Perspective] = []
         pp_repo = PerspectiveRepository()
 
+        cycle_result = self.cycle.get()
+        allowed_hashes: set[str] | None = None
+        if cycle_result:
+            allowed_hashes = set(cycle_result[0].perspective_hashes)
+
         for edge in self.edges:
             source_result = edge.source.get()
             target_result = edge.target.get()
@@ -204,12 +209,14 @@ class Wheel(IncrementalBuildMixin, IntentMixin, AssessableEntity, label="Wheel")
                 components.append(target_result[0])
 
             for component in components:
-                # Find the PP this component belongs to
                 pp_tuples = pp_repo.find_by_statement(component)
                 for pp, _ in pp_tuples:
-                    if pp.hash not in seen_hashes:
-                        seen_hashes.add(pp.hash)
-                        result.append(pp)
+                    if pp.hash in seen_hashes:
+                        continue
+                    if allowed_hashes is not None and pp.hash not in allowed_hashes:
+                        continue
+                    seen_hashes.add(pp.hash)
+                    result.append(pp)
 
         return result
 

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/repositories/perspective_repository.py

@@ -43,7 +43,7 @@ class PerspectiveRepository:
 
         query = """
         MATCH (pp:Perspective {sid: $sid})
-        WHERE pp.discarded IS NULL
+        WHERE pp.discarded IS NULL AND pp.hash IS NOT NULL
         RETURN pp
         ORDER BY pp.committed_at
         """

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/repositories/polarity_repository.py

@@ -171,10 +171,10 @@ class PolarityRepository:
 
         query = """
         MATCH (pol:Polarity {sid: $sid})
-        WHERE pol.discarded IS NULL
+        WHERE pol.discarded IS NULL AND pol.hash IS NOT NULL
         AND NOT EXISTS {
             MATCH (pp:Perspective {sid: $sid})-[:HAS_POLARITY]->(pol)
-            WHERE pp.discarded IS NULL
+            WHERE pp.discarded IS NULL AND pp.hash IS NOT NULL
         }
         RETURN pol
         """

{dialectical_framework-1.2.3 → dialectical_framework-1.2.5}/src/dialectical_framework/graph/repositories/statement_repository.py

@@ -88,7 +88,7 @@ class StatementRepository:
 
         query = """
         MATCH (c:Statement)
-        WHERE c.sid = $sid
+        WHERE c.sid = $sid AND c.hash IS NOT NULL
         RETURN c
         """
         results = graph_db.execute_and_fetch(query, {"sid": sid})
@@ -184,7 +184,7 @@ class StatementRepository:
 
         query = """
         MATCH (s:Statement {sid: $sid})
-        WHERE s.discarded IS NULL
+        WHERE s.discarded IS NULL AND s.hash IS NOT NULL
         AND NOT (s)-[:T]->(:Polarity)
         AND NOT (s)-[:A]->(:Polarity)
         AND NOT (s)-[:T_PLUS]->(:Perspective)