release: bump all packages to 0.1.1, add PyPI metadata and CHANGELOG

- Add readme field to all three pyproject.toml files (populates PyPI description page)
- Bump versions to 0.1.1 and update behave-core pin in shell/text
- Update Install sections in root, BEHAVE-SHELL, and BEHAVE-TEXT READMEs to lead with pip install from PyPI
- Add CHANGELOG.md at project root (Keep-a-Changelog format)

BEHAVE-SHELL/README.md

@@ -14,8 +14,12 @@ aggregates, and cryptographic hashes — never raw keystrokes or command text.
 ## Install
 
 ```bash
-pip install -e ../core/ -e .
+pip install behave-shell
-# development (pytest + ruff):
+```
+
+For local development (pytest + ruff):
+
+```bash
 pip install -e ../core/ -e ".[dev]"
 ```
 

BEHAVE-SHELL/pyproject.toml

@@ -4,12 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "behave-shell"
-version = "0.1.0"
+version = "0.1.1"
 description = "BEHAVE-SHELL — shell-session behavioral observation registry, layered on behave-core"
+readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "GPL-3.0-or-later" }
 authors = [{ name = "ANTI" }]
-dependencies = ["pydantic>=2.6", "behave-core>=0.1.0"]
+dependencies = ["pydantic>=2.6", "behave-core>=0.1.1"]
 
 [project.optional-dependencies]
 dev = ["pytest>=8", "pytest-cov", "ruff"]

BEHAVE-TEXT/README.md

@@ -19,8 +19,12 @@ is deliberately neutral: BEHAVE-TEXT observes actors, not adversaries.
 ## Install
 
 ```bash
-pip install -e ../core/ -e .
+pip install behave-text
-# development:
+```
+
+For local development:
+
+```bash
 pip install -e ../core/ -e ".[dev]"
 ```
 

BEHAVE-TEXT/pyproject.toml

@@ -4,12 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "behave-text"
-version = "0.1.0"
+version = "0.1.1"
 description = "BEHAVE-TEXT — text/messaging-domain behavioral observation registry, layered on behave-core"
+readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "GPL-3.0-or-later" }
 authors = [{ name = "ANTI" }]
-dependencies = ["pydantic>=2.6", "behave-core>=0.1.0"]
+dependencies = ["pydantic>=2.6", "behave-core>=0.1.1"]
 
 [project.optional-dependencies]
 dev = ["pytest>=8", "pytest-cov", "ruff"]

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to BEHAVE packages are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.1.0] — 2026-05-17
+
+Initial public release of all three packages.
+
+### behave-core
+
+- Shared observation envelope and schema contract (`BehaveObservation`)
+- Pydantic v2 base models for domain-agnostic behavioral records
+
+### behave-shell
+
+- Shell-session behavioral observation registry
+- Primitive catalog covering command execution, session lifecycle, environment, and navigation events
+- Layered on `behave-core`
+
+### behave-text
+
+- Text/messaging-domain behavioral observation registry
+- Primitive catalog covering message composition, conversation, and metadata events
+- Layered on `behave-core`

README.md

@@ -13,15 +13,17 @@ BEHAVE defines a structured observation envelope (`core`) and two domain registr
 
 ## Install
 
-Each package is independently installable. Install `core` first as both registries depend on it.
+All packages are available on PyPI:
 
 ```bash
-pip install -e core/
+pip install behave-core
-pip install -e BEHAVE-SHELL/
+pip install behave-shell
-pip install -e BEHAVE-TEXT/
+pip install behave-text
 ```
 
-For development (includes pytest + ruff):
+`behave-core` is pulled in automatically as a dependency of the registries.
+
+For local development (includes pytest + ruff):
 
 ```bash
 pip install -e "core/[dev]"

core/pyproject.toml

@@ -4,8 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "behave-core"
-version = "0.1.0"
+version = "0.1.1"
 description = "BEHAVE shared observation envelope — schema contract used by BEHAVE-SHELL and BEHAVE-TEXT"
+readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "GPL-3.0-or-later" }
 authors = [{ name = "ANTI" }]