From 214ce509415435c3dea5f41af3c6bbf58a9e834f Mon Sep 17 00:00:00 2001
From: anti <samuel@securejump.cl>
Date: Sun, 17 May 2026 20:26:43 -0400
Subject: [PATCH] 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      |  8 ++++++--
 BEHAVE-SHELL/pyproject.toml |  5 +++--
 BEHAVE-TEXT/README.md       |  8 ++++++--
 BEHAVE-TEXT/pyproject.toml  |  5 +++--
 CHANGELOG.md                | 28 ++++++++++++++++++++++++++++
 README.md                   | 12 +++++++-----
 core/pyproject.toml         |  3 ++-
 7 files changed, 55 insertions(+), 14 deletions(-)
 create mode 100644 CHANGELOG.md

diff --git a/BEHAVE-SHELL/README.md b/BEHAVE-SHELL/README.md
index 47e5737..0334edc 100644
--- a/BEHAVE-SHELL/README.md
+++ b/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 .
-# development (pytest + ruff):
+pip install behave-shell
+```
+
+For local development (pytest + ruff):
+
+```bash
 pip install -e ../core/ -e ".[dev]"
 ```
 
diff --git a/BEHAVE-SHELL/pyproject.toml b/BEHAVE-SHELL/pyproject.toml
index 7762d86..136f36b 100644
--- a/BEHAVE-SHELL/pyproject.toml
+++ b/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"]
diff --git a/BEHAVE-TEXT/README.md b/BEHAVE-TEXT/README.md
index 0b4dd5a..7ff928f 100644
--- a/BEHAVE-TEXT/README.md
+++ b/BEHAVE-TEXT/README.md
@@ -19,8 +19,12 @@ is deliberately neutral: BEHAVE-TEXT observes actors, not adversaries.
 ## Install
 
 ```bash
-pip install -e ../core/ -e .
-# development:
+pip install behave-text
+```
+
+For local development:
+
+```bash
 pip install -e ../core/ -e ".[dev]"
 ```
 
diff --git a/BEHAVE-TEXT/pyproject.toml b/BEHAVE-TEXT/pyproject.toml
index c636b93..214adf0 100644
--- a/BEHAVE-TEXT/pyproject.toml
+++ b/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"]
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..5b3fbb0
--- /dev/null
+++ b/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`
diff --git a/README.md b/README.md
index 303f57f..448dc01 100644
--- a/README.md
+++ b/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 -e BEHAVE-SHELL/
-pip install -e BEHAVE-TEXT/
+pip install behave-core
+pip install behave-shell
+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]"
diff --git a/core/pyproject.toml b/core/pyproject.toml
index d359b66..3330a88 100644
--- a/core/pyproject.toml
+++ b/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" }]