stemtrace 0.1.0__tar.gz → 0.2.0__tar.gz

{stemtrace-0.1.0 → stemtrace-0.2.0}/.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.1.0"
+current_version = "0.2.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 commit = true

{stemtrace-0.1.0 → stemtrace-0.2.0}/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -39,7 +39,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -58,12 +58,12 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v6
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -76,7 +76,7 @@ jobs:
         run: uv sync --all-extras
 
       - name: Run tests
-        run: uv run pytest --cov=stemtrace --cov-report=xml --cov-fail-under=80
+        run: uv run pytest --cov=stemtrace --cov-branch --cov-report=xml --cov-fail-under=95
 
       - name: Upload coverage
         uses: codecov/codecov-action@v5
@@ -117,7 +117,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -144,7 +144,7 @@ jobs:
         run: uvx twine check dist/*
 
       - name: Upload dist artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: dist/

{stemtrace-0.1.0 → stemtrace-0.2.0}/.github/workflows/e2e.yml

@@ -33,7 +33,7 @@ jobs:
           echo "Services ready!"
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -80,7 +80,7 @@ jobs:
           echo "Services ready!"
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -126,10 +126,11 @@ jobs:
         working-directory: src/stemtrace/server/ui/frontend
         run: npm test
         env:
+          E2E_MODE: real
           PLAYWRIGHT_BASE_URL: http://localhost:8000
 
       - name: Upload Playwright report
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         if: always()
         with:
           name: playwright-report
@@ -137,7 +138,7 @@ jobs:
           retention-days: 7
 
       - name: Upload test results
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         if: failure()
         with:
           name: playwright-test-results

{stemtrace-0.1.0 → stemtrace-0.2.0}/.github/workflows/release.yml

@@ -22,7 +22,7 @@ jobs:
       version: ${{ steps.version.outputs.version }}
       tag: ${{ steps.version.outputs.tag }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Determine version
         id: version
@@ -49,12 +49,12 @@ jobs:
           echo "✅ Version $PYPROJECT_VERSION matches"
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: "20"
           cache: "npm"
@@ -74,7 +74,7 @@ jobs:
         run: twine check dist/*
 
       - name: Upload dist artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: dist/
@@ -87,7 +87,7 @@ jobs:
       id-token: write
     steps:
       - name: Download dist artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v7
         with:
           name: dist
           path: dist/
@@ -102,7 +102,7 @@ jobs:
       contents: read
       packages: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
@@ -139,10 +139,10 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Download dist artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v7
         with:
           name: dist
           path: dist/

{stemtrace-0.1.0 → stemtrace-0.2.0}/CHANGELOG.md

@@ -7,13 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-01-03
+
+### Added
+- Workers API endpoints: `GET /api/workers` and `GET /api/workers/{hostname}`
+- Worker lifecycle tracking via `worker_ready` / `worker_shutdown` events to maintain a live worker registry
+- Workers UI page for inspecting online/offline workers and their registered tasks
+- Task Registry now shows which workers registered each task (`registered_by`)
+
+## [0.1.1] - 2025-12-31
+
+### Added
+- Python 3.14 support in CI and project classifiers
+- Mock-based E2E testing mode (no Docker required for local dev)
+- Codecov integration for coverage reporting
+
+### Changed
+- Upgraded React and React-DOM to v19
+- Upgraded @tanstack/react-query to latest
+- Updated GitHub Actions to v6 (checkout, setup-python, setup-node, upload/download-artifact)
+- Improved README with clearer Quick Start and FastAPI embedding docs
+
 ## [0.1.0] - 2025-12-27
 
 ### Added
 - **Core domain models**: `TaskEvent`, `TaskState`, `TaskNode`, `TaskGraph`
 - **Protocol definitions**: `EventTransport`, `TaskRepository`, `AsyncEventConsumer`
 - **Event transports**: Redis Streams (`RedisTransport`), in-memory (`MemoryTransport`)
-- **Celery signal integration**: Automatic event capture via `stemtrace.init(app)`
+- **Celery signal integration**: Automatic event capture via `stemtrace.init_worker(app)`
 - **Server components**:
   - `GraphStore` — Thread-safe in-memory graph storage with LRU eviction
   - `EventConsumer` / `AsyncEventConsumer` — Background event processing
@@ -29,5 +50,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **E2E test suite**: Docker API tests + Playwright browser tests
 - **Comprehensive test suite**: 350+ Python tests, 90%+ coverage
 
-[unreleased]: https://github.com/iansokolskyi/stemtrace/compare/v0.1.0...HEAD
+[unreleased]: https://github.com/iansokolskyi/stemtrace/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/iansokolskyi/stemtrace/compare/v0.1.1...v0.2.0
+[0.1.1]: https://github.com/iansokolskyi/stemtrace/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/iansokolskyi/stemtrace/releases/tag/v0.1.0

{stemtrace-0.1.0 → stemtrace-0.2.0}/CONTRIBUTING.md

@@ -19,7 +19,7 @@ git clone https://github.com/iansokolskyi/stemtrace.git
 cd stemtrace
 
 # Install dependencies (creates venv automatically)
-uv sync --all-extras
+uv sync --extra dev
 
 # Install pre-commit hooks
 uv run pre-commit install
@@ -79,7 +79,7 @@ uv run pytest
 uv run pytest --cov=stemtrace --cov-report=term-missing
 ```
 
-**Coverage requirement:** 80% minimum
+**Coverage requirement:** 95% minimum
 
 ### Updating Dependencies
 
@@ -132,7 +132,7 @@ uv lock --upgrade
 ### Code Quality
 
 - Google-style docstrings on all public APIs
-- Immutable dataclasses with `frozen=True, slots=True`
+- Pydantic models: immutable with `model_config = ConfigDict(frozen=True)`, mutable with `validate_assignment=True`
 - Fire-and-forget pattern for publishers (never block)
 - Fakes over mocks in tests
 

{stemtrace-0.1.0 → stemtrace-0.2.0}/Makefile

@@ -36,7 +36,7 @@ format:
 	uv run ruff check --fix src/ tests/
 
 test:
-	uv run pytest --cov=stemtrace --cov-report=term-missing --cov-fail-under=80
+	uv run pytest --cov=stemtrace --cov-report=term-missing --cov-fail-under=95
 
 # Run tests without coverage (faster iteration)
 test-fast:
@@ -161,11 +161,16 @@ release:
 # E2E Testing
 # =============================================================================
 
-# Start E2E test environment
+# Run Playwright E2E tests in mock mode (no Docker required)
+# This is the default and recommended way to run E2E tests locally
+e2e-mock:
+	cd $(FRONTEND_DIR) && npm test
+
+# Start E2E test environment (Docker)
 e2e-up:
 	docker compose -f docker-compose.e2e.yml up -d --wait
 	@echo "Waiting for services..."
-	@timeout 60 bash -c 'until curl -sf http://localhost:8000/stemtrace/api/health -o /dev/null; do sleep 2; done' || true
+	@timeout 60 bash -c 'until curl -sf http://localhost:8000/stemtrace/api/health -o /dev/null; do sleep 2; done' || (echo "❌ Service failed to become healthy"; exit 1)
 	@echo "✅ E2E environment ready at http://localhost:8000"
 
 # Stop E2E test environment
@@ -176,14 +181,17 @@ e2e-down:
 e2e-api:
 	uv run pytest tests/e2e/ -m e2e -v
 
-# Run Playwright E2E tests (requires e2e-up first)
-e2e-playwright:
-	cd $(FRONTEND_DIR) && npm test
+# Run Playwright E2E tests against real Docker backend
+e2e-playwright-real:
+	cd $(FRONTEND_DIR) && E2E_MODE=real PLAYWRIGHT_BASE_URL=http://localhost:8000 npm test
 
-# Run all E2E tests (ensures cleanup on failure)
+# Run all E2E tests against Docker (full integration)
 e2e:
 	$(MAKE) e2e-up
-	$(MAKE) e2e-api && $(MAKE) e2e-playwright; \
+	$(MAKE) e2e-api && $(MAKE) e2e-playwright-real; \
 	status=$$?; \
 	$(MAKE) e2e-down; \
 	exit $$status
+
+# Quick E2E alias (mock mode, no Docker)
+e2e-quick: e2e-mock