update steering docs and hooks for current project state

.kiro/steering/development-process.md

@@ -3,44 +3,49 @@
 ## Local Environment
 - Python 3.12 via NixOS, virtualenv at `.venv/`
 - Always use `.venv/bin/python` or activate with `source .venv/bin/activate` before running Python commands
-- When running `pytest`, `ruff`, or any Python tool, use the `.venv` — e.g. `python -m pytest` (not bare `pytest` which may resolve to system Python)
-- Node.js 24 available for frontend work; `frontend/` has its own `node_modules/`
+- For tools not available in `.venv/` (ruff, gh, etc.), use `nix-shell -p <pkg> --run "<cmd>"`
+- Node.js 24 for frontend; `frontend/` has its own `node_modules/`
+- Frontend tests: `cd frontend && npx vitest --run`
+- Python tests: `nix-shell -p ruff --run "ruff check services/"` then `python -m pytest tests/ -x --tb=short -q`
 
 ## Workflow
 1. Write or update tests for the target behavior
 2. Implement the minimal code to pass
 3. Debug failures, fix, re-run
-4. Commit and push after each phase completes
-5. GitHub Actions CI automatically builds container images and pushes to GHCR
-6. Deploy to cluster via Helm or `kubectl apply`
+4. Commit and push — CI builds images automatically
+5. Deploy: `helm upgrade --install stonks-oracle infra/helm/stonks-oracle -n stonks-oracle`
+6. Restart changed services: `kubectl rollout restart deployment/<name> -n stonks-oracle`
 
 ## Testing
-- Use `pytest` with `pytest-asyncio` for async code
-- Tests live in the top-level `tests/` directory
-- Run tests with `python -m pytest tests/ -x --tb=short -q`
-- Focus on core logic, not mocking infrastructure
+- Python: `pytest` with `pytest-asyncio` for async code, tests in `tests/`
+- Frontend: Vitest + MSW (Mock Service Worker) for deterministic API mocking, tests in `frontend/src/test/`
+- Run Python tests: `python -m pytest tests/ -x --tb=short -q`
+- Run frontend tests: `cd frontend && npx vitest --run`
+- Lint Python: `nix-shell -p ruff --run "ruff check services/"`
 
 ## CI/CD — GitHub Actions
-- Workflow file: `.github/workflows/build.yml`
+- Workflow: `.github/workflows/build.yml`
 - Triggers on push to `main` and PRs
 - Jobs:
-  - `lint-and-test`: runs ruff lint + pytest on ubuntu with Python 3.12
-  - `build-services`: matrix build of all Python services via `docker/Dockerfile`, pushes to GHCR with `:<sha>` and `:latest` tags
-  - `build-dashboard`: builds `frontend/Dockerfile` separately, pushes `dashboard` image to GHCR
-- CI handles image building and pushing — do NOT manually `docker push` unless CI is broken or you need to bypass it
-- After pushing to `main`, wait for CI to complete before deploying (check GitHub Actions status)
-- If you need to build locally for testing: `make build` or `docker build` directly, but let CI do the GHCR push
+  - `lint-and-test`: ruff lint + pytest + frontend vitest (Node 24)
+  - `build-services`: matrix build of all Python services → GHCR
+  - `build-dashboard`: frontend/Dockerfile → GHCR
+  - `build-superset`: docker/Dockerfile.superset → GHCR
+- CI handles all image builds and pushes — do NOT manually docker push
+- Check CI: `nix-shell -p gh --run "gh run list -L 3"`
+- Re-run failed: `nix-shell -p gh --run "gh run rerun <id> --failed"`
 
 ## Deploy
-- Helm chart at `infra/helm/stonks-oracle/`
-- Deploy: `helm upgrade --install stonks-oracle infra/helm/stonks-oracle -n stonks-oracle`
-- Alternative raw manifests: `kubectl apply -f infra/k8s/`
-- To restart a deployment after CI pushes new images: `kubectl rollout restart deployment/<name> -n stonks-oracle`
+- Full deploy/redeploy: `~/sources/kube/stonks-oracle/runmefirst.sh`
+- Full teardown: `~/sources/kube/stonks-oracle/runmelast.sh`
+- Quick Helm upgrade: `helm upgrade --install stonks-oracle infra/helm/stonks-oracle -n stonks-oracle`
+- Restart single service: `kubectl rollout restart deployment/<name> -n stonks-oracle`
+- Check pods: `kubectl get pods -n stonks-oracle`
 
 ## Git Conventions
 - Commit after each completed phase task
 - Commit message format: `phase N: short description`
-- Push to `main` branch triggers CI
+- Push to `main` triggers CI
 
 ## Code Style
 - Python 3.12, type hints everywhere
@@ -49,9 +54,9 @@
 - asyncio + asyncpg/aioredis for async I/O
 - Minimal dependencies, prefer stdlib where possible
 - Frontend: React 19, TypeScript strict mode, Tailwind CSS, TanStack Router/Query
+- UUID fields from asyncpg must be converted to str via `_row_dict()` helpers
 
 ## Documentation
 - Do NOT create large summary/success markdown files after each step
 - Keep notes short, concise, and organized under `docs/notes/`
-- Name note files to match the task they relate to (e.g. `docs/notes/phase0-k8s-manifests.md`)
 - If a note isn't useful for future reference, don't write it