dialectical-framework 1.5.0__tar.gz → 1.5.2__tar.gz

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/PKG-INFO

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dialectical-framework"
-version = "1.5.0"
+version = "1.5.2"
 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.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/agents/explorer/tools/create_nexus.py

@@ -27,11 +27,11 @@ async def create_nexus(
         ),
     ] = None,
     preset: Annotated[
-        str,
+        Optional[str],
         Field(
-            description="Estimation strategy: 'preset:auto', 'preset:balanced', 'preset:realistic', 'preset:desirable', 'preset:feasible'"
+            description="Estimation strategy: 'preset:auto', 'preset:balanced', 'preset:realistic', 'preset:desirable', 'preset:feasible'. Omit for settings default."
         ),
-    ] = "preset:auto",
+    ] = None,
 ) -> str:
     """Create a Nexus — an exploration container that groups Perspectives for structural combination into Cycles and Wheels. The intent describes what to explore or navigate."""
     concern = CreateNexus()

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/concerns/create_nexus.py

@@ -8,11 +8,11 @@ from dataclasses import dataclass
 from typing import Optional
 
 from dialectical_framework.agents.reasonable_concern import ReasonableConcern
-from dialectical_framework.enums.causality_preset import CausalityPreset
 from dialectical_framework.graph.nodes.nexus import Nexus
 from dialectical_framework.graph.nodes.perspective import Perspective
 from dialectical_framework.graph.repositories.node_repository import \
     NodeRepository
+from dialectical_framework.protocols.has_config import SettingsAware
 
 
 @dataclass
@@ -21,7 +21,7 @@ class CreateNexusResult:
     perspectives: list[Perspective]
 
 
-class CreateNexus(ReasonableConcern[CreateNexusResult]):
+class CreateNexus(SettingsAware, ReasonableConcern[CreateNexusResult]):
     """
     Creates an exploration container (Nexus) and connects Perspectives to it.
 
@@ -38,12 +38,14 @@ class CreateNexus(ReasonableConcern[CreateNexusResult]):
         self,
         intent: str,
         perspective_hashes: list[str],
-        preset: str = CausalityPreset.AUTO,
+        preset: Optional[str] = None,
         title: Optional[str] = None,
     ) -> CreateNexusResult:
         if not perspective_hashes:
             raise ValueError("At least one Perspective hash is required.")
 
+        effective_preset = preset if preset is not None else self.settings.cycle_preset
+
         repo = NodeRepository()
         perspectives: list[Perspective] = []
         for pp_hash in perspective_hashes:
@@ -52,7 +54,7 @@ class CreateNexus(ReasonableConcern[CreateNexusResult]):
                 raise ValueError(f"Perspective not found: {pp_hash}")
             perspectives.append(node)
 
-        nexus = Nexus(intent=intent, preset=preset)
+        nexus = Nexus(intent=intent, preset=effective_preset)
         nexus.commit()
 
         if title:
@@ -71,6 +73,6 @@ class CreateNexus(ReasonableConcern[CreateNexusResult]):
         )
         self._report.artifacts["nexus_hash"] = nexus.short_hash
         self._report.artifacts["perspective_count"] = len(perspectives)
-        self._report.artifacts["preset"] = preset
+        self._report.artifacts["preset"] = effective_preset
 
         return CreateNexusResult(nexus=nexus, perspectives=perspectives)

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/concerns/statement_classification.py

@@ -183,17 +183,17 @@ Your task is to classify statements and anchor them in taxonomy.
 ## Statement Classification
 
 **SIMPLE/BINARY** - is_simple = true
-- Can be directly true/false, yes/no, present/absent
-- Has literal, binary nature
-- Examples: "The sky is blue", "Water boils at 100C", "API is stateless"
+- Verifiable by direct observation or logical identity
+- No trade-offs, no systemic dynamics, no causal chains
+- Examples: "The sky is blue", "Water boils at 100C", "API is stateless", "The repository has 3 branches"
 
 **COMPLEX/SYSTEMIC** - is_simple = false
-- Involves relationships, processes, or functional roles
-- Concerns viability, health, or functioning of systems
-- Has trade-offs, tensions, or dynamic aspects
-- Examples: "Trust", "Data consistency", "Love", "User experience"
+- Involves causal dynamics, trade-offs, or systemic relationships
+- Describes how one thing affects another, or how a process shapes outcomes
+- Concerns viability, health, functioning, or governance of systems
+- Examples: "Trust", "Data consistency", "Open markets promote innovation", "Centralization enables coordination", "Distributed systems trade consistency for availability"
 
-Heuristic: If statement involves relationship, process, or functional role → Complex
+Heuristic: If the statement describes a causal relationship (X causes/enables/prevents Y), a trade-off, or a systemic dynamic → Complex. If it is a bare fact verifiable by inspection → Simple.
 
 ## Taxonomy for Complex Statements
 
@@ -534,8 +534,10 @@ Use this text to understand the intended meaning of the statement.
 Statement: "{self._statement}"
 {text_section}
 Using the classification criteria from the system prompt, classify as:
-- SIMPLE/BINARY (is_simple = true): literal, binary nature
-- COMPLEX/SYSTEMIC (is_simple = false): involves relationships, processes, functional roles
+- SIMPLE/BINARY (is_simple = true): verifiable by direct observation, no causal dynamics
+- COMPLEX/SYSTEMIC (is_simple = false): describes causal relationships, trade-offs, or systemic dynamics
+
+A statement like "X prevents/enables/eliminates Y" describes a causal dynamic and is COMPLEX, even if one could argue the causal claim is "either true or false." The test is whether the statement embeds a systemic relationship, not whether one can assign it a truth value.
 
 Provide your reasoning."""
 

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/concerns/thesis_extraction.py

@@ -43,17 +43,18 @@ SYSTEM_PROMPT = """You are a dialectical thesis extractor.
 Your task is to extract assertable content from source text and identify thesis candidates.
 
 Extract content that could be theses:
-- Claims/Assertions: "The system should...", "We use X because..."
+- Systemic claims: "Centralization enables X", "Openness promotes Y"
 - Values/Principles: "Security is paramount", "User experience first"
-- Goals/Objectives: Desired outcomes, success criteria
-- Constraints: "Must not exceed...", "Cannot allow..."
+- Causal dynamics: "X leads to Y", "Without X, Y collapses"
 - Design Decisions: Architecture choices, trade-offs made
-- Assumptions: Implicit or explicit premises
+- Structural tensions: Opposing forces, dilemmas, governance trade-offs
+
+Prefer theses that capture systemic dynamics (how things relate, what enables/prevents what) over isolated factual claims. A thesis about a causal relationship or trade-off is more dialectically productive than a bare assertion of fact.
 
 A valid thesis candidate must be:
 - ASSERTABLE: Can be evaluated as true/false, good/bad, present/absent
 - SUBSTANTIVE: Not trivial or tautological
-- ATOMIC: Single concept, not compound (if compound, decompose)
+- ATOMIC: Single concept or causal relationship (not multiple unrelated claims joined)
 
 Respond with structured output matching the requested format."""
 
@@ -245,9 +246,9 @@ Type: {content_type}
 Check if this is a valid thesis candidate:
 1. Is it ASSERTABLE? (Can be evaluated as true/false, good/bad, present/absent)
 2. Is it SUBSTANTIVE? (Not trivial or tautological)
-3. Is it ATOMIC? (Single concept, not compound)
+3. Is it ATOMIC? (Single concept or causal relationship, not multiple unrelated claims joined)
 
-If compound (multiple concepts joined), decompose into atomic theses.
+If compound (multiple unrelated claims joined), decompose. A single causal relationship ("X enables Y") is atomic — do not split it into "X exists" and "Y exists."
 Each atomic thesis should be 1-{max_words} words.
 
 Return:

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/graph/nodes/nexus.py

@@ -65,7 +65,7 @@ class Nexus(IntentMixin, BaseNode, label="Nexus"):
         nexus = Nexus(
             sid=case.sid,
             intent="I want to understand the deep meaning of love",
-            preset=CausalityPreset.BALANCED,
+            preset=CausalityPreset.AUTO,
         )
         nexus.commit()
 
@@ -74,7 +74,7 @@ class Nexus(IntentMixin, BaseNode, label="Nexus"):
     """
 
     # Prompt strategy for causality estimation (preset selector)
-    preset: str = CausalityPreset.BALANCED
+    preset: str = CausalityPreset.AUTO
 
     # Display title (not part of hash — purely metadata).
     # NOTE: Cannot use Optional[str] here due to GQLAlchemy metaclass + future annotations.

{dialectical_framework-1.5.0 → dialectical_framework-1.5.2}/src/dialectical_framework/settings.py

@@ -16,7 +16,7 @@ class Settings(BaseModel):
 
     ai_model: str = Field(..., description="AI model in 'provider/model' format (e.g., 'bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0').")
     component_length: int = Field(default=7, description="Approximate length in words of the statement.")
-    cycle_preset: str = Field(default=CausalityPreset.BALANCED, description="Default preset for causality estimation (e.g., preset:realistic, preset:desirable, preset:feasible, preset:balanced).")
+    cycle_preset: str = Field(default=CausalityPreset.AUTO, description="Default preset for causality estimation (e.g., preset:auto, preset:realistic, preset:desirable, preset:feasible, preset:balanced).")
 
     # Graph database configuration (Memgraph or Neo4j)
     graph_db_vendor: str = Field(default="memgraph", description="Graph database vendor: 'memgraph' or 'neo4j'")
@@ -84,7 +84,7 @@ class Settings(BaseModel):
         return cls(
             ai_model=model,
             component_length=int(os.getenv("DIALEXITY_DEFAULT_COMPONENT_LENGTH", 7)),
-            cycle_preset=os.getenv("DIALEXITY_DEFAULT_CYCLE_PRESET", CausalityPreset.BALANCED),
+            cycle_preset=CausalityPreset.AUTO,
             graph_db_vendor=os.getenv("DIALEXITY_GRAPH_DB_VENDOR", "memgraph"),
             graph_db_host=os.getenv("DIALEXITY_GRAPH_DB_HOST", "127.0.0.1"),
             graph_db_port=int(os.getenv("DIALEXITY_GRAPH_DB_PORT", 7687)),