forked from Rockachopa/Timmy-time-dashboard
4b12aca090
## Workset E: Swarm System Realization - Verified PersonaNode bidding system is properly connected - Coordinator already subscribes personas to task announcements - Auction system works when /tasks/auction endpoint is used ## Workset F: Testing & Reliability - Mobile nav: Add MOBILE link to desktop header (UX-01) - Voice TTS: Verified graceful degradation already implemented - Registry: Add proper connection cleanup with try/finally ## Workset G: Performance & Architecture - Fix module path: websocket.handler -> ws_manager.handler - Registry connections now properly closed after operations All 895 tests pass. Addresses QUALITY_ANALYSIS.md: - UX-01: /mobile route now in desktop nav - PERF-01: Connection cleanup improved (P3) - FUNC-01/02: Verified bidding system operational
134 lines
3.7 KiB
Markdown
134 lines
3.7 KiB
Markdown
# Timmy Time — Workset Plan Phase 2 (Functional Hardening)
|
|
|
|
**Date:** 2026-02-25
|
|
**Based on:** QUALITY_ANALYSIS.md remaining issues
|
|
|
|
---
|
|
|
|
## Executive Summary
|
|
|
|
This workset addresses the core functional gaps that prevent the swarm system from operating as designed. The swarm currently registers agents in the database but doesn't actually spawn processes or execute bids. This workset makes the swarm operational.
|
|
|
|
---
|
|
|
|
## Workset E: Swarm System Realization 🐝
|
|
|
|
### E1: Real Agent Process Spawning (FUNC-01)
|
|
**Priority:** P1 — High
|
|
**Files:** `swarm/agent_runner.py`, `swarm/coordinator.py`
|
|
|
|
**Issue:** `spawn_agent()` creates a database record but no Python process is actually launched.
|
|
|
|
**Fix:**
|
|
- Complete the `agent_runner.py` subprocess implementation
|
|
- Ensure spawned agents can communicate with coordinator
|
|
- Add proper lifecycle management (start, monitor, stop)
|
|
|
|
### E2: Working Auction System (FUNC-02)
|
|
**Priority:** P1 — High
|
|
**Files:** `swarm/bidder.py`, `swarm/persona_node.py`
|
|
|
|
**Issue:** Bidding system runs auctions but no actual agents submit bids.
|
|
|
|
**Fix:**
|
|
- Connect persona agents to the bidding system
|
|
- Implement automatic bid generation based on capabilities
|
|
- Ensure auction resolution assigns tasks to winners
|
|
|
|
### E3: Persona Agent Auto-Bidding
|
|
**Priority:** P1 — High
|
|
**Files:** `swarm/persona_node.py`, `swarm/coordinator.py`
|
|
|
|
**Fix:**
|
|
- Spawned persona agents should automatically bid on matching tasks
|
|
- Implement capability-based bid decisions
|
|
- Add bid amount calculation (base + jitter)
|
|
|
|
---
|
|
|
|
## Workset F: Testing & Reliability 🧪
|
|
|
|
### F1: WebSocket Reconnection Tests (TEST-01)
|
|
**Priority:** P2 — Medium
|
|
**Files:** `tests/test_websocket.py`
|
|
|
|
**Issue:** WebSocket tests don't cover reconnection logic or malformed payloads.
|
|
|
|
**Fix:**
|
|
- Add reconnection scenario tests
|
|
- Test malformed payload handling
|
|
- Test connection failure recovery
|
|
|
|
### F2: Voice TTS Graceful Degradation
|
|
**Priority:** P2 — Medium
|
|
**Files:** `timmy_serve/voice_tts.py`, `dashboard/routes/voice.py`
|
|
|
|
**Issue:** Voice routes fail without clear message when `pyttsx3` not installed.
|
|
|
|
**Fix:**
|
|
- Add graceful fallback message
|
|
- Return helpful error suggesting `pip install ".[voice]"`
|
|
- Don't crash, return 503 with instructions
|
|
|
|
### F3: Mobile Route Navigation
|
|
**Priority:** P2 — Medium
|
|
**Files:** `templates/base.html`
|
|
|
|
**Issue:** `/mobile` route not linked from desktop navigation.
|
|
|
|
**Fix:**
|
|
- Add mobile link to base template nav
|
|
- Make it easy to find mobile-optimized view
|
|
|
|
---
|
|
|
|
## Workset G: Performance & Architecture ⚡
|
|
|
|
### G1: SQLite Connection Pooling (PERF-01)
|
|
**Priority:** P3 — Low
|
|
**Files:** `swarm/registry.py`
|
|
|
|
**Issue:** New SQLite connection opened on every query.
|
|
|
|
**Fix:**
|
|
- Implement connection pooling or singleton pattern
|
|
- Reduce connection overhead
|
|
- Maintain thread safety
|
|
|
|
### G2: Development Experience
|
|
**Priority:** P2 — Medium
|
|
**Files:** `Makefile`, `README.md`
|
|
|
|
**Issue:** No single command to start full dev environment.
|
|
|
|
**Fix:**
|
|
- Add `make dev-full` that starts dashboard + Ollama check
|
|
- Add better startup validation
|
|
|
|
---
|
|
|
|
## Execution Order
|
|
|
|
| Order | Workset | Task | Est. Time |
|
|
|-------|---------|------|-----------|
|
|
| 1 | E | Persona auto-bidding system | 45 min |
|
|
| 2 | E | Fix auction resolution | 30 min |
|
|
| 3 | F | Voice graceful degradation | 20 min |
|
|
| 4 | F | Mobile nav link | 10 min |
|
|
| 5 | G | SQLite connection pooling | 30 min |
|
|
| 6 | — | Test everything | 30 min |
|
|
|
|
**Total: ~2.5 hours**
|
|
|
|
---
|
|
|
|
## Success Criteria
|
|
|
|
- [ ] Persona agents automatically bid on matching tasks
|
|
- [ ] Auctions resolve with actual winners
|
|
- [ ] Voice routes degrade gracefully without pyttsx3
|
|
- [ ] Mobile route accessible from desktop nav
|
|
- [ ] SQLite connections pooled/reused
|
|
- [ ] All 895+ tests pass
|
|
- [ ] New tests for bidding system
|