dialectical-framework 1.9.1__tar.gz → 2.0.0__tar.gz

{dialectical_framework-1.9.1 → dialectical_framework-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dialectical-framework
-Version: 1.9.1
+Version: 2.0.0
 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
@@ -81,6 +81,7 @@ Host Application (Chainlit, API, CLI)
 An **agent** is the entry point — a thin LLM orchestrator that manages a conversation with tools that read and write the graph. There are three (Analyst, Explorer, Advisor); each owns a tool set and a domain-neutral reasoning prompt. The host app controls persona (via the app preamble) and scope identity (`sid`); the framework handles reasoning and graph curation. See [docs/agents.md](docs/agents.md).
 
 ### Docs
+- [What you can build](docs/surfaces.md) — the four heads, the seven axes, the Advisor's six configurations, and recipes from app idea to construction (start here)
 - [Agents: Analyst, Explorer, Advisor](docs/agents.md) — the building blocks, their tools, and the UX to build around them
 - [Graph Data Model](docs/graph.md)
 - [Scoring & Metrics](docs/scoring.md)
@@ -129,9 +130,9 @@ Wherever the answer is a tension rather than a fact, this drops in as the reason
 
 - **Analyst** — turns raw material into structured tensions, up to grouping them into a Nexus (Case-scoped).
 - **Explorer** — takes one Nexus and works out its causal pathways and synthesis (Nexus-scoped).
-- **Advisor** — runs the whole machine silently and returns pure counsel, with no framework vocabulary exposed (Case-scoped).
+- **Advisor** — runs the whole machine silently and returns pure counsel, with no framework vocabulary exposed (Case-scoped). Its **sealed** configuration (`Advisor(build=BuildPolicy.NEVER)`) is the same head over a graph that already exists: it reads, records decisions, and never builds — the fast surface for a return visit.
 
-Analyst + Explorer are the structure-forward "graph navigator" experience; the Advisor is a chat-only product over the same graph. See [docs/agents.md](docs/agents.md) for full specs, tool lists, and the UX to build around each.
+Analyst + Explorer are the structure-forward "graph navigator" experience; the Advisor is a chat-only product over the same graph, and `Consultant` is the method alone with no graph at all. See [docs/surfaces.md](docs/surfaces.md) for the map of what can be built and [docs/agents.md](docs/agents.md) for full specs, tool lists, and the UX to build around each.
 
 ```python
 import asyncio
@@ -187,7 +188,7 @@ Runnable versions of the above:
 - **[notebooks/minds.ipynb](notebooks/minds.ipynb)** — plugging your own domain in
   with a single declarative `AppSpec`.
 - **[notebooks/seasons.ipynb](notebooks/seasons.ipynb)** — one `AppSpec` across every
-  agent head (Analyst, Explorer, Advisor, and the counsel toggle).
+  agent head (Analyst, Explorer, Advisor, and the advisory toggle).
 
 ## Setup
 

{dialectical_framework-1.9.1 → dialectical_framework-2.0.0}/README.md

@@ -40,6 +40,7 @@ Host Application (Chainlit, API, CLI)
 An **agent** is the entry point — a thin LLM orchestrator that manages a conversation with tools that read and write the graph. There are three (Analyst, Explorer, Advisor); each owns a tool set and a domain-neutral reasoning prompt. The host app controls persona (via the app preamble) and scope identity (`sid`); the framework handles reasoning and graph curation. See [docs/agents.md](docs/agents.md).
 
 ### Docs
+- [What you can build](docs/surfaces.md) — the four heads, the seven axes, the Advisor's six configurations, and recipes from app idea to construction (start here)
 - [Agents: Analyst, Explorer, Advisor](docs/agents.md) — the building blocks, their tools, and the UX to build around them
 - [Graph Data Model](docs/graph.md)
 - [Scoring & Metrics](docs/scoring.md)
@@ -88,9 +89,9 @@ Wherever the answer is a tension rather than a fact, this drops in as the reason
 
 - **Analyst** — turns raw material into structured tensions, up to grouping them into a Nexus (Case-scoped).
 - **Explorer** — takes one Nexus and works out its causal pathways and synthesis (Nexus-scoped).
-- **Advisor** — runs the whole machine silently and returns pure counsel, with no framework vocabulary exposed (Case-scoped).
+- **Advisor** — runs the whole machine silently and returns pure counsel, with no framework vocabulary exposed (Case-scoped). Its **sealed** configuration (`Advisor(build=BuildPolicy.NEVER)`) is the same head over a graph that already exists: it reads, records decisions, and never builds — the fast surface for a return visit.
 
-Analyst + Explorer are the structure-forward "graph navigator" experience; the Advisor is a chat-only product over the same graph. See [docs/agents.md](docs/agents.md) for full specs, tool lists, and the UX to build around each.
+Analyst + Explorer are the structure-forward "graph navigator" experience; the Advisor is a chat-only product over the same graph, and `Consultant` is the method alone with no graph at all. See [docs/surfaces.md](docs/surfaces.md) for the map of what can be built and [docs/agents.md](docs/agents.md) for full specs, tool lists, and the UX to build around each.
 
 ```python
 import asyncio
@@ -146,7 +147,7 @@ Runnable versions of the above:
 - **[notebooks/minds.ipynb](notebooks/minds.ipynb)** — plugging your own domain in
   with a single declarative `AppSpec`.
 - **[notebooks/seasons.ipynb](notebooks/seasons.ipynb)** — one `AppSpec` across every
-  agent head (Analyst, Explorer, Advisor, and the counsel toggle).
+  agent head (Analyst, Explorer, Advisor, and the advisory toggle).
 
 ## Setup
 

{dialectical_framework-1.9.1 → dialectical_framework-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dialectical-framework"
-version = "1.9.1"
+version = "2.0.0"
 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"