From 6ccffd4c5200d590422e1d2e83bdd7cf4bb1240d Mon Sep 17 00:00:00 2001
From: Robert Lippmann <robert.lippmann.development@gmail.com>
Date: Sat, 27 Jun 2026 23:27:54 -0400
Subject: [PATCH 1/2] fix: package core runtime only

---
 README.md          | 5 +++--
 demos/README.md    | 6 +++++-
 examples/README.md | 6 +++---
 pyproject.toml     | 7 -------
 4 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 678affe..a54f1eb 100644
--- a/README.md
+++ b/README.md
@@ -200,8 +200,9 @@ pip install context-compiler
 
 Packaging notes:
 - Base install includes the core authority-layer engine and CLI.
-- Install example files with `pip install "context-compiler[examples]"`.
-- Install demo files and demo dependencies with `pip install "context-compiler[demos]"`.
+- Example and demo source files are available in the repository and source distribution.
+- To run the demos from this repository, clone the repo and install `context-compiler[demos]`.
+- The `[demos]` extra installs optional dependencies such as LiteLLM. It does not install demo source files into site-packages.
 
 ### Development
 
diff --git a/demos/README.md b/demos/README.md
index 00d4574..cab1b2c 100644
--- a/demos/README.md
+++ b/demos/README.md
@@ -35,12 +35,16 @@ patterns still appear in real applications.
 
 ## Requirements
 
-Install demo dependencies:
+To run the demos from this repository, clone the repo and install the demo dependency extra:
 
 ```bash
+git clone https://github.com/rlippmann/context-compiler.git
+cd context-compiler
 pip install "context-compiler[demos]"
 ```
 
+The `[demos]` extra installs optional dependencies such as LiteLLM. It does not install demo source files into site-packages.
+
 Environment variables (strict provider mode contract):
 
 - `PROVIDER` (optional): `openai` (default), `ollama`, `openai_compatible`
diff --git a/examples/README.md b/examples/README.md
index c4f8da4..816666e 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -2,13 +2,13 @@
 
 This directory contains small authority-layer examples showing typical app-side usage of Context Compiler.
 
-Install examples with:
+Install the core package with:
 
 ```bash
-pip install "context-compiler[examples]"
+pip install context-compiler
 ```
 
-Non-integration example files in this directory are standalone scripts and can be run directly.
+Example files in this directory are included in the repository and source distribution, and can be run directly.
 
 ## 01_persistent_guardrails.py
 
diff --git a/pyproject.toml b/pyproject.toml
index f88d218..411deeb 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,12 +40,6 @@ context-compiler = "context_compiler.repl:main"
 [tool.hatch.build.targets.wheel]
 packages = ["src/context_compiler"]
 
-[tool.hatch.build.targets.wheel.force-include]
-"demos" = "demos"
-"examples" = "examples"
-"host_support" = "host_support"
-"src/context_compiler/py.typed" = "context_compiler/py.typed"
-
 [tool.hatch.build.targets.sdist]
 include = [
   "/README.md",
@@ -57,7 +51,6 @@ include = [
 ]
 
 [project.optional-dependencies]
-examples = []
 demos = [
   "litellm>=1.0.0",
 ]

From 8ffd6b0052abf4a40ffa85251345cac49fc4913c Mon Sep 17 00:00:00 2001
From: Robert Lippmann <robert.lippmann.development@gmail.com>
Date: Sat, 27 Jun 2026 23:32:02 -0400
Subject: [PATCH 2/2] chore: bump version to 0.8.1

---
 pyproject.toml | 2 +-
 uv.lock        | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 411deeb..d15756b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "context-compiler"
-version = "0.8.0"
+version = "0.8.1"
 description = "Deterministic conversational state engine for LLM applications."
 readme = "README.md"
 requires-python = ">=3.11"
diff --git a/uv.lock b/uv.lock
index 0fac767..7044a0d 100644
--- a/uv.lock
+++ b/uv.lock
@@ -296,7 +296,7 @@ wheels = [
 
 [[package]]
 name = "context-compiler"
-version = "0.8.0"
+version = "0.8.1"
 source = { editable = "." }
 
 [package.optional-dependencies]
@@ -324,7 +324,7 @@ requires-dist = [
     { name = "pytest-cov", marker = "extra == 'dev'" },
     { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.12,<1.0" },
 ]
-provides-extras = ["examples", "demos", "dev"]
+provides-extras = ["demos", "dev"]
 
 [[package]]
 name = "coverage"