migrate to Poetry and add requirements.txt for Streamlit Cloud

.github/workflows/ci.yml

@@ -41,12 +41,15 @@ jobs:
         with:
           python-version: "3.11"
 
-      - name: Install dependencies
+      - name: Install Poetry
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install poetry
+
+      - name: Install dependencies
+        run: poetry install --with dev
 
       - name: Run unit tests (mocked, no API keys required)
         run: |
-          pytest tests/test_cache.py tests/test_unit.py tests/test_client_mock.py tests/test_persistence.py \
+          poetry run pytest tests/test_cache.py tests/test_unit.py tests/test_client_mock.py tests/test_persistence.py \
             -v --tb=short --ignore=tests/test_client.py --ignore=tests/test_revision.py --ignore=tests/test_steps.py

README.md

@@ -62,20 +62,48 @@ All interactions are traced to SQLite for debugging and replay.
 
 ## Installation
 
+### Using Poetry (recommended)
+
 ```bash
-git clone https://github.com/your-repo/traceflow-lite.git
+git clone https://github.com/khalilCodeX/traceflow-lite.git
+cd traceflow-lite
+poetry install
+```
+
+### Using pip
+
+```bash
+git clone https://github.com/khalilCodeX/traceflow-lite.git
 cd traceflow-lite
 python -m venv .venv
 source .venv/bin/activate
-pip install -e .
+pip install -r requirements.txt
+```
+
+### Development Setup
+
+```bash
+# Install with dev dependencies
+poetry install --with dev
+
+# Run tests
+poetry run pytest
+
+# Run linter
+poetry run ruff check .
 ```
 
-### Dependencies
+### Adding Dependencies
 
 ```bash
-pip install langgraph openai tiktoken tenacity pydantic python-dotenv opentelemetry-sdk
-# Optional for RAG:
-pip install chromadb langchain-text-splitters
+# Add a runtime dependency
+poetry add <package>
+
+# Add a dev dependency
+poetry add --group dev <package>
+
+# After adding, sync requirements.txt for Streamlit Cloud:
+poetry export --without-hashes -o requirements.txt
 ```
 
 ---