docs: update readme + changelog + up version

Author: scream4ik

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2025-12-04
+
+### Changed
+- **DX Improvement:** Exposed main classes (`MemoryStore`, `Fact`, `Operation`, etc.) directly in the top-level package.
+  - Now you can use: `from memstate import MemoryStore` instead of importing from submodules.
+- **Internal:** Switched to dynamic versioning (single source of truth in `pyproject.toml`).
+
 ## [0.3.0] - 2025-12-03
 
 ### Added

README.md

@@ -85,9 +85,7 @@ pip install memstate[redis]
 ### 1. Basic Usage (Structured Memory)
 
 ```python
-from memstate.storage import MemoryStore, Constraint
-from memstate.schemas import Fact
-from memstate.backends.sqlite import SQLiteStorage
+from memstate import MemoryStore, Constraint, Fact, SQLiteStorage
 from pydantic import BaseModel
 
 # 1. Define schema
@@ -183,9 +181,10 @@ app = workflow.compile(checkpointer=checkpointer)
 
 Check the [examples/](https://github.com/scream4ik/MemState/tree/main/examples) folder:
 
-*   **[examples/rag_hook_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/rag_hook_demo.py)** - **See Chroma Sync in action.**
-*   **[examples/main_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/main_demo.py)** - Full tour of schemas and rollbacks.
-*   **[examples/langgraph_checkpoint_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/langgraph_checkpoint_demo.py)** - LangGraph persistence without API keys.
+*   **[examples/main_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/main_demo.py)** - Full tour: Schemas, Singletons, Hallucination Correction via Rollback.
+*   **[examples/rag_hook_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/rag_hook_demo.py)** - Shows how to use MemState as the "Master DB" that automatically syncs text to a mock Vector DB for RAG.
+*   **[examples/langgraph_checkpoint_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/langgraph_checkpoint_demo.py)** - Shows how to plug `MemStateCheckpointer` into a LangGraph workflow.
+*   **[examples/pizza_agent_demo.py](https://github.com/scream4ik/MemState/blob/main/examples/pizza_agent_demo.py)** - A "Pizza Ordering" agent that separates Chat History from Business State (the JSON order).
 
 ---
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "memstate"
-version = "0.3.0"
+version = "0.3.1"
 description = "ACID-like memory for Agents. Atomically syncs Pydantic models & Vector DBs with Git-style versioning."
 readme = "README.md"
 requires-python = ">=3.10"