Commit Graph

35 Commits

Author SHA1 Message Date
saravanakumardb1
c80c1e4462 feat(ai-context): Phase A.4 — context-aware AI messages with LLM fallback
Add AI-enriched context message generation:

- backend/src/lib/ai-context.ts: LLM-powered context generator with keyword fallback
  - Calls extraction-service timer-context task when EXTRACTION_SERVICE_URL is set
  - Falls back to keyword rules, then generic message
  - Gated behind isFeatureEnabled('ai_context_messages.enabled')
- backend/src/lib/config.ts: Add EXTRACTION_SERVICE_URL env var
- backend/src/server.ts: POST /api/context-message route
- web/src/lib/context-messages.ts: fetchEnrichedMessage() with graceful degradation
- Updated AGENTIC_AI_ROADMAP.md checkboxes for Phase A.1 + A.2

All 219 backend tests + 394 web tests pass. No breaking changes.
2026-03-31 23:46:00 -07:00
saravanakumardb1
686f5fb33e feat(mcp): Phase A.1 — reschedule, availability, and start-routine endpoints
Add 3 new backend REST endpoints for MCP tool support:

- POST /timers/:id/reschedule — shift timer by delta seconds or set new target time
- GET /timers/availability — find free time slots in a window (interval merge algorithm)
- POST /routines/:id/start — transition routine from ready/template → active

All endpoints gated behind isFeatureEnabled('mcp.enabled') flag (default false).
Zod schemas: RescheduleTimerSchema (XOR validation), AvailabilityQuerySchema, FreeSlot type.

All 182 backend tests pass. No breaking changes to existing APIs.
2026-03-31 23:31:04 -07:00
saravanakumardb1
f3e14e28dd feat(ecosystem): Phase 0 — kill-switch, feedback, accessibility, feature flags, telemetry events
Phase 0 of the Agentic AI Roadmap: ecosystem gap fixes.

- Add @bytelyst/kill-switch-client integration (web/src/lib/kill-switch.ts)
- Wire kill switch check into providers.tsx on app init
- Add @bytelyst/feedback-client integration (web/src/lib/feedback.ts)
- Add @bytelyst/accessibility to web dependencies
- Add 7 agentic feature flags to backend (all default false)
- Define 16 telemetry event constants (backend + web)
- Add AGENTIC_AI_ROADMAP.md with full Phase 0-E plan + audit findings

All 182 backend tests pass. All 394 web tests pass.
No breaking changes to existing functionality.
2026-03-31 23:26:37 -07:00
saravanakumardb1
233fde8f99 docs(roadmap): mark completed items from web polish session
- Zod form validation (02ac682)
- 3-step onboarding walkthrough + tooltip hints (4e1a22f)
- Ambient background sounds in focus mode (4e1a22f)
- Custom pre-warning messages per timer (d3b55a2)
- Routine preview timeline in editor (c5c8000)
- Chain badge on TimerCard (existing)
2026-02-28 13:46:15 -08:00
saravanakumardb1
3ac658a89e docs(roadmap): mark iOS Swift ports, routine models, routine views, and Android RoutineScreen as complete 2026-02-28 01:51:46 -08:00
saravanakumardb1
8b6f44ac9a docs(roadmap): mark all 4 backend modules complete (timers, routines, households, shared-timers) 2026-02-28 00:05:39 -08:00
saravanakumardb1
f92193139b docs(roadmap): mark cross-platform cloud sync complete — timers module in platform-service (42 tests, 759 total) 2026-02-27 23:55:58 -08:00
saravanakumardb1
831fcfadd0 docs(roadmap): mark Google Calendar integration complete for Android 2026-02-27 23:18:05 -08:00
saravanakumardb1
0848c9a041 docs(roadmap): mark Advanced NL parsing task as complete — timer-parse in extraction-service 2026-02-27 23:16:54 -08:00
saravanakumardb1
f6e78a454d docs(roadmap): mark Room database and foreground service as complete in Phase 5 2026-02-27 23:15:07 -08:00
saravanakumardb1
91b0bb6d63 chore(android): add .gitignore, gradle.properties, wrapper config; update roadmap with Quick Settings + foreground service 2026-02-27 23:13:02 -08:00
saravanakumardb1
449b2dc514 docs(roadmap): update Phase 5 Weeks 15-19 — Android app, Wear OS, timer engine Kotlin port, 30 JUnit5 tests 2026-02-27 23:10:58 -08:00
saravanakumardb1
400b1e038c docs(roadmap): mark Phase 4 exit criteria — 9/12 complete, remaining are non-code growth metrics 2026-02-27 23:00:53 -08:00
saravanakumardb1
0311980bfe docs(roadmap): update Phase 4 Weeks 10-14 — macOS, calendar, location, sleep, mood, GDPR, sharing, referrals 2026-02-27 22:59:55 -08:00
saravanakumardb1
639d606233 feat(web): add Playwright E2E tests, service worker, package updates 2026-02-27 22:37:04 -08:00
saravanakumardb1
d909830fcd feat(web): snooze suggestion card on Dashboard, event countdown large display
- Dashboard: adaptive snooze suggestion cards (dismissable, max 2 shown, pattern-based)
- TimerCard: event countdown type gets large days display with milestone progress bar
  - Progress bar color-codes: accent → warning (70%) → danger (90%)
  - Shows days + hours remaining with target date
- Updated roadmap: marked snooze suggestion card and event visual as completed
- 373 tests across 16 files, tsc clean
2026-02-27 22:31:20 -08:00
saravanakumardb1
f61483e7a5 feat(web): calendar import preview, repeat timer, CSV export, compact mode
- Calendar import preview: parse .ics → show events with conflict indicators → confirm/cancel before importing
- History page: repeat timer button (recreates alarm at same time-of-day, countdown with same duration)
- History page: CSV export (Label, Type, State, Urgency, Category, Created, Completed, Duration)
- Settings: compact mode toggle (persisted to localStorage, sets data-compact attribute)
- Updated roadmap Week 5 items
- 373 tests across 16 files, tsc clean
2026-02-27 22:28:36 -08:00
saravanakumardb1
9fcd256364 docs(roadmap): update Week 9 — iCloud sync, crash reporting, feedback form complete 2026-02-27 22:24:06 -08:00
saravanakumardb1
5a9a855ec9 docs(roadmap): update Phase 3 exit criteria — 9/11 checkmarks complete 2026-02-27 22:21:13 -08:00
saravanakumardb1
2c224c5c4f test(week9): add urgency tests (14) + accessibility tests (14) + update roadmap Week 9 2026-02-27 22:20:29 -08:00
saravanakumardb1
4b579750a2 test(week8): add reschedule engine tests (14) + gamification engine tests (15) + update roadmap 2026-02-27 22:14:01 -08:00
saravanakumardb1
fc05ea12ba feat(web): routine editor/runner UI, linked timers, routines page
- RoutineEditor component: add/remove/reorder steps, transition types, notes, save-as-template toggle, total duration display
- RoutineRunner component: countdown ring, step dots, progress bar, next step preview, pause/resume/skip/done/cancel, completion celebration
- Routine store (lib/routine-store.ts): Zustand + localStorage persistence, template management, auto-advance via tickRoutines()
- Routines page (app/routines/): template browser, active runner, ready queue, past routines
- Linked timers engine (lib/linked-timers.ts): chain building/append/remove with relinking, 3 presets (Pasta, Laundry, Meeting Prep), downstream queries
- Linked timers tests (27 tests)
- Dashboard: added Routines + nav link
- Updated roadmap.md Week 3 items
- 329 tests passing (14 test files), tsc clean
2026-02-27 22:07:16 -08:00
saravanakumardb1
0b798bf9ff test(shared): add SharedTimerData tests + update roadmap Week 7 checkmarks 2026-02-27 22:01:57 -08:00
saravanakumardb1
e6b97fcbf0 feat(deploy): Phase 1 polish — analytics, install prompt, a11y, PWA icons 2026-02-27 21:57:43 -08:00
saravanakumardb1
1235a2b218 docs: update roadmap Phase 2 with completed items
Routine engine (45 tests), NL parser (37 tests), context messages (23 tests),
focus mode, and CreateTimerModal NL integration all marked complete.
Total: 276 tests passing, tsc clean.
2026-02-27 21:46:24 -08:00
saravanakumardb1
885a2685ad docs(ios): update roadmap Phase 3 Week 6 with iOS app foundation progress
- Xcode project setup:  (XcodeGen, iOS 17+, zero third-party deps)
- Timer engine Swift port:  (TimerEngine, Cascade, Urgency, Format, TimeBlindness)
- Data models:  partial (CMTimer Codable struct, UserDefaults persistence)
- iOS screens:  (Timeline, CreateTimer, Pomodoro, History, Settings, AlarmOverlay)
- Notification scheduling:  (UNUserNotificationCenter, cascade warnings, actions)
- Haptic engine:  (urgency-mapped feedback patterns)
- XCTest: 58 tests passing (TimerEngine, Cascade, Format)
- Remaining: Recurrence, NLParser, ContextMessages (Phase 2 web deps), SwiftData migration
2026-02-27 21:27:02 -08:00
saravanakumardb1
445e25bee1 docs: final roadmap update with Serwist SW, toast fallback, Pomodoro celebration commits 2026-02-27 21:24:36 -08:00
saravanakumardb1
815e1cd7fe docs: comprehensive roadmap update with all Phase 1 checkmarks and commit links 2026-02-27 21:11:39 -08:00
saravanakumardb1
a3ebb9fd6d docs: update roadmap.md with Phase 1 progress checkmarks and commit links 2026-02-27 21:03:27 -08:00
saravanakumardb1
1b148757af docs: apply V2 review fixes to roadmap.md — comprehensive update
P0 Critical:
- Sync API: TBD → platform-service (Fastify, port 4003)
- Cascade presets: aligned with PRD (Aggressive/Standard/Light/Minimal/None/Custom)
- Deprecated APIs: NSUserNotificationCenter → UNUserNotificationCenter, ClockKit removed
- Cloud sync: iCloud Phase 3-4, platform-service REST Phase 5 (no contradiction)
- productId: chronomind registered in header + sync modules
- Open-source: closed-source app, open timer engine lib
- Design tokens: ChronoMind product section, own urgency colors

P1 High:
- Added pre-work (domain, wireframes, design tokens)
- Added CI/CD (GitHub Actions + Vercel auto-deploy)
- Added analytics (platform-service telemetry)
- Added onboarding (3-step walkthrough)
- Added privacy policy + terms of service
- Added web accessibility (WCAG 2.1 AA)
- Added timer accuracy tests + offline resilience strategy
- Added feedback mechanism
- Timer engine: clarified rAF (UI) + setInterval (SW) dual architecture
- Neurodivergent mode: default UX, not toggle (Compact mode for power users)
- Phase 3: macOS deferred to Phase 4, iPad layout added

P2 Medium:
- Calendar sync: two-way → one-way (read-only)
- Event countdown timer added to Phase 2
- Timer export/import added to Phase 2
- iOS waitlist added to Phase 2
- Data export/deletion added to Phase 4
- NL extraction upgrade path added to Phase 4
- Body doubling deferred to v3

New appendices: Cost Estimation, Common Platform Reusability, Key Decisions
Updated: success metrics (aligned with PRD), risk register (+4 new risks)
V2 review doc marked as APPLIED (audit trail)
2026-02-27 20:32:25 -08:00
saravanakumardb1
c20bdc9b20 docs: add 12 PRD cross-reference gaps + platform dependency blockers to V2 review
New findings from systematic PRD ↔ roadmap comparison:
- X-01: Windows/Tauri in PRD but missing from roadmap entirely
- X-02: Event countdown timer type never scheduled in any phase
- X-03: Cascade preset names don't match (PRD vs roadmap)
- X-04: Phase 3 timeline differs (PRD 3wks vs roadmap 4wks)
- X-05: Success metrics contradict between documents
- X-06: Open-source stated in PRD, never discussed in roadmap
- X-07: AI suggestions feature in PRD, absent from roadmap
- X-08: Neurodivergent mode toggle vs default contradicts PRD decision
- X-09: ChronoMind design tokens (--cm-*) conflict with ByteLyst
- X-10: Typography differs (Inter/JetBrains vs DM Sans/IBM Plex)
- X-11: Timer engine architecture unclear (SW vs requestAnimationFrame)
- X-12: Extraction service unused for NL parsing upgrade path

Platform dependency blockers identified from PLATFORM_COMPONENTS_ROADMAP:
- Email/Push Delivery, Password Reset, Event Bus, Scheduled Jobs
- Mitigation: Phase 1-3 unblocked, Phase 4+ has fallbacks

Added @bytelyst/extraction to reusable packages table
Added 4 new decisions to Appendix B (open-source, Windows, AKV, fonts)
Total findings: 7 bugs + 7 arch gaps + 10 missing features + 12 PRD gaps + 5 blockers
2026-02-27 20:18:33 -08:00
saravanakumardb1
c6bef6a717 docs: add roadmap V2 review — gaps, common-plat reuse, bugs identified
- Audit 13 @bytelyst/* packages for ChronoMind reusability
- Audit 17 platform-service modules reusable as-is
- Identify 7 bugs (deprecated APIs, sync contradictions, TBD backend)
- Identify 7 architectural gaps (no productId, no onboarding, no offline strategy)
- Identify 10 missing features (no CI/CD, no analytics, no privacy policy)
- Timeline realism check (Phase 3 too compressed)
- Security, testing, design system, DevOps gap analysis
- Recommend platform-service as backend (not Cloudflare Workers)
- 10 key decisions pending user sign-off before implementation
2026-02-27 17:33:46 -08:00
saravanakumardb1
c02d8cf08c docs: add comprehensive product roadmap (5 phases, Option D strategy)
- Phase 1: Web MVP (Next.js 16 PWA) — timer engine, cascade, visual timeline
- Phase 2: Intelligence — routines, NL input, focus mode, neurodivergent mode
- Phase 3: Apple Native — iOS + Apple Watch + macOS (SwiftUI, not KMP)
- Phase 4: Context & Growth — calendar sync, location, sleep, viral mechanics
- Phase 5: Android + Scale — Jetpack Compose, Wear OS, shared timers, monetization
- Includes: viral playbook, success metrics, risk register, tech stack summary
- Checklists for every phase with exit criteria
2026-02-27 17:27:05 -08:00
saravanakumardb1
a9dc99ec23 docs: add industry research and update PRD v0.2 with competitive analysis
- Add INDUSTRY_RESEARCH.md: market sizing, 9 competitors, 24 feature demands, trends
- Update PRD to v0.2: Next.js 16 + React 19 + TailwindCSS v4 stack
- Add visual timeline, Pomodoro, neurodivergent mode, AI reschedule features
- Promote iOS + Apple Watch to v1.0, add new v1.1 context phase
- Expand competitive analysis (Tiimo, Structured, Alarmy, TickTick, Forest, etc.)
- Add risk assessment section, revised monetization (Family tier)
- Update development phases to realistic 11-week roadmap
2026-02-27 16:57:47 -08:00
saravanakumardb1
67e17609ca docs: expand AI Clock raw idea into comprehensive PRD (ChronoMind) 2026-02-27 16:40:26 -08:00