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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dialectical-framework
-Version: 1.2.1
+Version: 1.2.3
 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.1 → dialectical_framework-1.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dialectical-framework"
-version = "1.2.1"
+version = "1.2.3"
 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.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/analyst/skills/anchor_theses.py

@@ -135,6 +135,7 @@ class AnchorTheses(ReasonableConcern[Optional[Ideas]]):
         intent = ", ".join(self.statements)
         ideas = Ideas(intent=intent)
         ideas.save()
+        self._report.node_created(ideas)
 
         for input_node in self._get_inputs():
             ideas.inputs.connect(input_node)
@@ -145,7 +146,7 @@ class AnchorTheses(ReasonableConcern[Optional[Ideas]]):
             self._report.relationship_created(ideas.statements, ideas, comp)
 
         ideas.commit()
-        self._report.node_created(ideas)
+        self._report.node_committed(ideas)
 
         return ideas
 

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/analyst/skills/edit_perspective.py

@@ -129,10 +129,12 @@ class EditPerspective(ReasonableConcern[EditPerspectiveResult]):
         if self._was_committed:
             working_pp = pp.clone()
             working_pp.save()
+            self._report.node_created(working_pp)
         else:
             working_pp = pp
             if not working_pp._id:
                 working_pp.save()
+                self._report.node_created(working_pp)
         self._working_pp = working_pp
 
         # Route based on what's changing
@@ -396,12 +398,12 @@ class EditPerspective(ReasonableConcern[EditPerspectiveResult]):
                 ),
             )
             self._report.relationship_created(
-                manager, pp, aspect.component,
+                manager, aspect.component, pp,
                 meta={"position": aspect.position},
             )
 
         pp.commit()
-        self._report.node_created(pp)
+        self._report.node_committed(pp)
 
     # ─── Tetrad editing (aspect changes only → validate coherence) ───
 
@@ -469,7 +471,7 @@ class EditPerspective(ReasonableConcern[EditPerspectiveResult]):
             )
 
         self._working_pp.commit()
-        self._report.node_created(self._working_pp)
+        self._report.node_committed(self._working_pp)
 
         return EditPerspectiveResult(
             perspective=self._working_pp,

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/analyst/skills/expand_polarities.py

@@ -129,7 +129,7 @@ class ExpandPolarity(ReasonableConcern[list[Perspective]]):
                 continue
 
             pp.commit()
-            self._report.node_created(pp)
+            self._report.node_committed(pp)
             completed_pps.append(pp)
 
         # Return all PPs: existing complete + newly completed
@@ -193,8 +193,8 @@ class ExpandPolarity(ReasonableConcern[list[Perspective]]):
 
         self._report.relationship_created(
             manager,
-            pp,
             aspect.component,
+            pp,
             meta={
                 "position": aspect.position,
                 "hs": aspect.heuristic_similarity,

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/analyst/skills/find_polarities.py

@@ -503,6 +503,7 @@ class FindPolarities(ReasonableConcern[Optional[Ideas]]):
 
         ideas = Ideas(intent=intent)
         ideas.save()
+        self._report.node_created(ideas)
 
         # Connect to inputs
         input_repo = InputRepository()
@@ -531,7 +532,7 @@ class FindPolarities(ReasonableConcern[Optional[Ideas]]):
                     )
 
         ideas.commit()
-        self._report.node_created(ideas)
+        self._report.node_committed(ideas)
 
         # Add rationale
         total_theses = len(valid_results)

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/analyst/skills/surface_theses.py

@@ -387,6 +387,7 @@ Determine:
 
         ideas = Ideas(intent=self.intent)
         ideas.save()
+        self._report.node_created(ideas)
 
         # Connect to inputs (filtered or all)
         for input_node in self._get_inputs():
@@ -399,7 +400,7 @@ Determine:
             self._report.relationship_created(ideas.statements, ideas, comp)
 
         ideas.commit()
-        self._report.node_created(ideas)
+        self._report.node_committed(ideas)
 
         # Attach rationale explaining how intent was interpreted
         if parsed.reasoning:

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/execution_report.py

@@ -73,6 +73,7 @@ def _resolve_rel_type(rel_type: RelType) -> str:
 
 EffectType = Literal[
     "node_created",
+    "node_committed",
     "node_updated",
     "node_deleted",
     "relationship_created",
@@ -93,10 +94,15 @@ class NodeRef(BaseModel):
 
     label: str  # Node class name: "Statement", "Perspective", etc.
     hash: Optional[str] = None  # 7-char short hash (None if uncommitted/draft)
+    db_id: Optional[int] = None  # DB internal ID (available after save)
 
     @classmethod
     def from_node(cls, node: BaseNode) -> NodeRef:
-        return cls(label=node.__class__.__name__, hash=node.short_hash)
+        return cls(
+            label=node.__class__.__name__,
+            hash=node.short_hash,
+            db_id=node._id,
+        )
 
 
 class RelationshipRef(BaseModel):
@@ -269,6 +275,27 @@ class ExecutionReport(BaseModel):
         self._emit(effect)
         self._log(effect)
 
+    def node_committed(
+        self,
+        node: BaseNode,
+        patch: Optional[dict[str, Any]] = None,
+        meta: Optional[dict[str, Any]] = None,
+    ) -> None:
+        """Record that a draft node was committed (hash now available)."""
+        default_patch = {"text": getattr(node, "text", None)}
+        if patch:
+            default_patch.update(patch)
+        effect = Effect(
+            seq=self._next_seq(),
+            effect_type="node_committed",
+            node=NodeRef.from_node(node),
+            patch=default_patch,
+            meta=meta or {},
+        )
+        self.effects.append(effect)
+        self._emit(effect)
+        self._log(effect)
+
     def node_updated(
         self,
         node: BaseNode,

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/explorer/skills/explore_transformations.py

@@ -534,6 +534,7 @@ class ExploreTransformations(ReasonableConcern[ExploreTransformationsResult]):
         transformation.set_nexus(nexus)
         transformation.set_on_edge(ac_edge)
         transformation.save()
+        self._report.node_created(transformation)
 
         # === Ac-side (this edge's segments) ===
 
@@ -694,7 +695,7 @@ class ExploreTransformations(ReasonableConcern[ExploreTransformationsResult]):
 
         # Commit transformation
         transformation.commit()
-        self._report.node_created(transformation)
+        self._report.node_committed(transformation)
 
         return transformation
 

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/explorer/skills/generate_synthesis.py

@@ -109,6 +109,7 @@ class GenerateSynthesis(ReasonableConcern[GenerateSynthesisResult]):
         # Create Synthesis node and wire up
         synthesis = Synthesis()
         synthesis.save()
+        self._report.node_created(synthesis)
 
         synthesis.s_plus.connect(
             result.s_plus_statement,
@@ -126,7 +127,7 @@ class GenerateSynthesis(ReasonableConcern[GenerateSynthesisResult]):
         synthesis.commit()
 
         # Report
-        self._report.node_created(synthesis)
+        self._report.node_committed(synthesis)
         self._report.artifacts["wheel"] = wheel.short_hash
         self._report.artifacts["s_plus"] = result.s_plus_statement.text
         self._report.artifacts["s_minus"] = result.s_minus_statement.text

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/agents/explorer/system_prompts.py

@@ -12,11 +12,10 @@ You are working within Nexus [{nexus_hash}]: "{nexus_intent}".
 ## Context
 
 A Nexus groups Perspectives (thesis-antithesis pairs with aspects T+/T-/A+/A-)
-for structural combination. Your job is to:
-1. Build the structural combinations (Cycles + Wheels) if not yet done.
-2. Generate Action-Reflection transformations for each Wheel.
-3. Help the user navigate the wisdom: what Ac+ and Re+ mean practically,
-   how S+ emerges, what pathways are available.
+for structural combination. Your job is to guide the user through three phases:
+1. **Navigation** — Build and present causal structures (Cycles + Wheels), helping the user understand which causality paths exist and which are most plausible.
+2. **Insight** — Generate transformations for wheels the user selects, revealing Ac+ and Re+ wisdom.
+3. **Synthesis** — Generate S+/S- for wheels that have transformations.
 
 ## How to Work
 
@@ -24,21 +23,32 @@ On first message (or when resuming):
 - Call `present_exploration` to see what's been built in this Nexus.
 - If wheels don't exist yet, call `build_wheels` to create them.
 - If build_wheels yields no wheels (e.g., only one position), explain that exploration needs at least two positions interacting — suggest the user adds more via the analysis thread.
-- If transformations don't exist yet, call `explore_transformations` for each wheel.
-- After transformations exist, call `generate_synthesis` to derive S+/S- for each wheel.
+
+After wheels exist — present the causality landscape:
+- Show which wheels exist and their causality scores (higher = more plausible).
+- Let the user choose which wheel(s) to explore further.
+- Do NOT automatically generate transformations for all wheels.
+
+When the user selects a wheel for deeper exploration:
+- Call `explore_transformations` for that specific wheel.
+- Then present the Ac+ and Re+ pathways that emerged.
+
+When the user wants synthesis:
+- Call `generate_synthesis` for a wheel that has transformations.
+- Do NOT generate synthesis for all wheels automatically.
 
 When presenting transformations:
 - Focus on the Ac+ (constructive action: T- -> A+) and Re+ (constructive reflection: A- -> T+).
-- These are the circular causality paths -- the non-obvious synthetic wisdom.
+- These are the circular causality paths — the non-obvious synthetic wisdom.
 - Explain what they mean practically for the user's situation.
 - Use the haiku and headline to make it memorable.
 
 When the user asks "what should I do?":
-- Draw from Ac+ paths -- these are concrete actions.
+- Draw from Ac+ paths — these are concrete actions.
 - Frame them as transitions from an exaggerated position to a constructive opposite.
 
 When the user asks "what should I reflect on?":
-- Draw from Re+ paths -- these are reflective shifts.
+- Draw from Re+ paths — these are reflective shifts.
 - Frame them as moving from underdevelopment to constructive balance.
 
 When the user wants to go deeper on a specific transformation:
@@ -47,13 +57,14 @@ When the user wants to go deeper on a specific transformation:
 
 ## Tools
 
-- `build_wheels` -- Generate causal structures (Cycles + Wheels) from this Nexus. Use nexus_hash: "{nexus_hash}".
-- `explore_transformations` -- Generate Action-Reflection transformations for a Wheel.
-- `generate_synthesis` -- Generate S+/S- synthesis for a Wheel. Requires transformations first.
-- `present_exploration` -- Show current state of this Nexus: perspectives, wheels, transformations.
-- `inspect_node` -- Deep-dive any node by hash.
-- `query_graph` -- Raw Cypher for custom queries. Call `get_schema` first.
-- `get_schema` -- Load graph schema on demand.
+- `build_wheels` — Generate causal structures (Cycles + Wheels) from this Nexus. Use nexus_hash: "{nexus_hash}".
+- `explore_transformations` — Generate Action-Reflection transformations for a specific Wheel the user chose.
+- `generate_synthesis` — Generate S+/S- synthesis for a Wheel. Requires transformations first.
+- `expand_nexus` — Add more Perspectives to this Nexus.
+- `present_exploration` — Show current state of this Nexus: perspectives, wheels, transformations.
+- `inspect_node` — Deep-dive any node by hash.
+- `query_graph` — Raw Cypher for custom queries. Call `get_schema` first.
+- `get_schema` — Load graph schema on demand.
 
 ## Response Style
 
@@ -66,4 +77,5 @@ Adapt depth and presentation to the persona defined in the app preamble.
 - When referencing structural nodes (Polarity, Perspective, Nexus, Cycle, Wheel, Transformation, Transition, Synthesis), always include the short hash for disambiguation.
 - If the user wants to analyze new material, suggest they return to the analysis thread.
 - Skill reports may contain truncated text previews. When you need to present exact node text to the user, use `inspect_node` or `present_analysis` by hash — never reconstruct or guess full text from truncated previews.
+- Do NOT eagerly explore all wheels or generate all syntheses. Let the user navigate and choose.
 """

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/concerns/perspective_combination.py

@@ -387,6 +387,7 @@ class PerspectiveCombination(ReasonableConcern[CombinationResult]):
             # Create new wheel
             wheel = Wheel(intent=cycle.intent)
             wheel.save()
+            self._report.node_created(wheel)
 
             # Create transitions forming the circular causality sequence
             for i in range(len(components)):
@@ -407,7 +408,7 @@ class PerspectiveCombination(ReasonableConcern[CombinationResult]):
             cycle.wheels.connect(wheel)
 
             wheel.commit()
-            self._report.node_created(wheel)
+            self._report.node_committed(wheel)
             self._report.relationship_created(cycle.wheels, cycle, wheel)
 
             all_wheels.append(wheel)

{dialectical_framework-1.2.1 → dialectical_framework-1.2.3}/src/dialectical_framework/utils/use_brain.py

@@ -136,7 +136,7 @@ def use_brain(
 
             attempts = max(1, retry_max)
             parse_delay = 10.0
-            rate_delay = 30.0
+            rate_delay = 10.0
             last_error: Exception | None = None
 
             for attempt in range(attempts):
@@ -162,12 +162,12 @@ def use_brain(
                     if _is_rate_limit_error(e):
                         last_error = e
                         logging.getLogger(__name__).warning(
-                            "Rate limit hit (attempt %d/%d), backing off %.0fs",
-                            attempt + 1, attempts, rate_delay,
+                            "Rate limit hit (attempt %d/%d), backing off %.0fs: %s",
+                            attempt + 1, attempts, rate_delay, e,
                         )
                         if attempt < attempts - 1:
                             await asyncio.sleep(rate_delay)
-                            rate_delay = min(rate_delay * 2.0, 300.0)
+                            rate_delay = min(rate_delay * 2.0, 60.0)
                     else:
                         raise