mifunedev
diff --git a/‎.claude/plans/.gitkeep‎ b/‎.claude/plans/.gitkeep‎
diff --git a/‎.claude/plans/feat-722-frontend-schedule-refactor/PLAN.md‎
Lines changed: 50 additions & 0 deletions b/‎.claude/plans/feat-722-frontend-schedule-refactor/PLAN.md‎
Lines changed: 50 additions & 0 deletions
diff --git a/‎.claude/plans/feat-722-frontend-schedule-refactor/images/01_navigate.png‎
89.2 KB b/‎.claude/plans/feat-722-frontend-schedule-refactor/images/01_navigate.png‎
89.2 KB
diff --git a/‎.claude/plans/feat-722-frontend-schedule-refactor/images/02_schedules-index-page.png‎
67.9 KB b/‎.claude/plans/feat-722-frontend-schedule-refactor/images/02_schedules-index-page.png‎
67.9 KB
diff --git a/‎.claude/plans/feat-722-frontend-schedule-refactor/images/03_select-agent-for-schedule.png‎
86 KB b/‎.claude/plans/feat-722-frontend-schedule-refactor/images/03_select-agent-for-schedule.png‎
86 KB
diff --git a/‎.claude/specs/feat-722-frontend-schedule-refactor/prd.json‎
Lines changed: 62 additions & 0 deletions b/‎.claude/specs/feat-722-frontend-schedule-refactor/prd.json‎
Lines changed: 62 additions & 0 deletions
diff --git a/‎.claude/specs/feat-722-frontend-schedule-refactor/progress.txt‎
Lines changed: 54 additions & 0 deletions b/‎.claude/specs/feat-722-frontend-schedule-refactor/progress.txt‎
Lines changed: 54 additions & 0 deletions
diff --git a/‎Changelog.md‎
Lines changed: 1 addition & 0 deletions b/‎Changelog.md‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎RALPH_TASK.md‎
Lines changed: 0 additions & 115 deletions b/‎RALPH_TASK.md‎
Lines changed: 0 additions & 115 deletions
@@ -0,0 +1,50 @@
+# Context: 
+
+### React Big Calendar should be used to display schedules 30 days in past AND 30 days in future from today.
+
+### Diff from Backend PR
+https://patch-diff.githubusercontent.com/raw/ruska-ai/orchestra/pull/721.diff
+
+### Libraries to Consider
+- [React Big Calendar](https://github.com/jquense/react-big-calendar?tab=readme-ov-file#react-big-calendar) | Would be nice to display schedules 30 days in past AND 30 days in future from today in the calendar. Blue would indicate "scheduled", Green "success", and Red indicate a run "failure". When clicking on the event in the calendar would open in new tab that thread from the schedule.
+- If schedule is recurring we can just show a single event and a list of the schedules past and coming up if we have the data. 
+
+### Workflow
+1. Study the screenshots in `.claude/plans/feat-722-frontend-schedule-refactor/images` folder.
+    - These will show how to create a scheduled agent from the interface with the `agent-browser` skill.
+    - Study the "Create New Schedule" modal.
+2. Our goal is to move the navigation from the `SettingsPopover` and have a spot in the app-sidebar like we do with Projects, Assistants, and Threads. We should in the drop down have the last 10 schedules that have occurred in the sidebar. The index page (Calendar) will be place for management. We need to think hard about this design. Use the `agent-browser` kill when necessary to validate changes.
+3. Calendar is the DEFAULT view. We should have a table descending as secondary view with ability to toggle between PAST and FUTURE schedules so we can get an idea of what HAS been executed and what WILL be executed in table view.
+
+# Goal:
+
+**TDD Refactor the Schedules feature from a settings-level action to a first-class navigation entity with a dedicated management interface.**
+
+## Deliverables:
+
+1. **Sidebar Integration**
+   - Add "Schedules" section to `app-sidebar` alongside Projects, Assistants, and Threads
+   - Display the 10 most recent schedule executions in the sidebar dropdown
+   - Each item should show schedule name, status indicator (🔵 scheduled / 🟢 success / 🔴 failure), and relative timestamp
+
+2. **Calendar View (Default)**
+   - Implement React Big Calendar as the primary `/schedules` index page
+   - Display events spanning 30 days past to 30 days future from today
+   - Color-code events: Blue (scheduled), Green (success), Red (failure)
+   - Clicking an event opens the associated thread in a new tab
+   - For recurring schedules, show a single consolidated event with expandable list of past/upcoming occurrences
+
+3. **Table View (Secondary)**
+   - Add toggle to switch between Calendar and Table views
+   - Table should support toggling between PAST and FUTURE schedules
+   - Sort descending by execution time
+   - Include columns: Schedule Name, Status, Agent/Skill, Last Run, Next Run, Actions
+
+4. **Navigation Cleanup**
+   - Remove schedule navigation/creation from `SettingsPopover`
+   - Ensure "Create New Schedule" modal remains accessible from the new Schedules section
+
+5. **Validation**
+   - Use `agent-browser` skill to validate UI changes match the reference screenshots
+   - Ensure the `agent-browser` skill scheduling flow works end-to-end with new navigation
+
@@ -0,0 +1,62 @@
+{
+  "title": "Frontend Schedule Refactor",
+  "description": "Elevate Schedules from Settings to first-class navigation with calendar and table views",
+  "branchName": "feat/722-frontend-schedule-refactor",
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "Install React Big Calendar and setup dependencies",
+      "passes": true
+    },
+    {
+      "id": "US-002",
+      "title": "Define ScheduleExecution and ScheduleEvent entity types",
+      "passes": true
+    },
+    {
+      "id": "US-003",
+      "title": "Add execution endpoints to schedule service",
+      "passes": true
+    },
+    {
+      "id": "US-004",
+      "title": "Add calendar utility functions",
+      "passes": true
+    },
+    {
+      "id": "US-005",
+      "title": "Create useScheduleExecutions hook",
+      "passes": true
+    },
+    {
+      "id": "US-006",
+      "title": "Sidebar Navigation for Schedules",
+      "description": "Add Schedules as a first-class navigation item in the app sidebar alongside Projects, Assistants, and Threads. Sidebar dropdown shows the 10 most recent schedule executions with name, status indicator, and relative timestamp. Clicking navigates to thread or schedule detail.",
+      "passes": true
+    },
+    {
+      "id": "US-007",
+      "title": "Calendar View (Default Schedule Index)",
+      "description": "React Big Calendar renders as the default view at /schedules with events spanning 30 days past to 30 days future, color-coded by status.",
+      "passes": false
+    },
+    {
+      "id": "US-008",
+      "title": "Table View (Secondary Toggle)",
+      "description": "Toggle between Calendar and Table views on the schedules page. Table supports PAST/FUTURE toggle, sorted descending by execution time.",
+      "passes": false
+    },
+    {
+      "id": "US-009",
+      "title": "Remove Schedule Navigation from SettingsPopover",
+      "description": "Remove schedule navigation from SettingsPopover, keep it accessible only from the new dedicated Schedules sidebar section.",
+      "passes": false
+    },
+    {
+      "id": "US-010",
+      "title": "End-to-End Validation with agent-browser",
+      "description": "Validate the scheduling flow end-to-end using agent-browser skill.",
+      "passes": false
+    }
+  ]
+}
@@ -0,0 +1,54 @@
+## Codebase Patterns
+- Schedule entities are in `/frontend/src/lib/entities/schedule.ts`
+- Schedule service is in `/frontend/src/lib/services/scheduleService.ts`
+- Hooks follow pattern: `/frontend/src/hooks/use*.ts`
+- Calendar utils in `/frontend/src/lib/utils/calendar.ts`
+- Schedule utils in `/frontend/src/lib/utils/schedule.ts`
+- Sidebar is in `/frontend/src/components/drawers/app-sidebar.tsx`
+- SettingsPopover has schedule link at `/frontend/src/components/popovers/SettingsPopover.tsx`
+- Use shadcn/ui components and Tailwind for styling
+- Collapsible sidebar sections use `Collapsible`, `CollapsibleTrigger`, `CollapsibleContent` from shadcn
+- Sign commits with `-s` flag
+- Files in `.claude/specs/` are gitignored; use `git add -f` to include them
+- Sidebar uses tab characters for indentation
+
+---
+
+## 2026-02-01 - US-001
+- Installed react-big-calendar and @types/react-big-calendar
+- Files changed: package.json, package-lock.json
+---
+
+## 2026-02-01 - US-002
+- Added ScheduleExecution, ScheduleEvent, ScheduleWithExecutions, ScheduleFormData interfaces
+- Files changed: frontend/src/lib/entities/schedule.ts
+---
+
+## 2026-02-01 - US-003
+- Added execution endpoints to schedule service (getRecentExecutions, getScheduleExecutions, getExecutionsByDateRange)
+- Files changed: frontend/src/lib/services/scheduleService.ts
+---
+
+## 2026-02-01 - US-004
+- Added calendar utility functions (mapExecutionsToEvents, getCalendarDateRange, getExecutionStatusColor, filterExecutionsByPeriod)
+- Files changed: frontend/src/lib/utils/calendar.ts
+---
+
+## 2026-02-01 - US-005
+- Created useScheduleExecutions hook with auto-refresh support
+- Files changed: frontend/src/hooks/useScheduleExecutions.ts
+---
+
+## 2026-02-01 - US-006
+- Added Schedules collapsible section to app-sidebar between Projects and Threads
+- Shows 10 most recent executions with status emoji (🔵/🟢/🔴), schedule name, and relative timestamp
+- "View All Schedules" button navigates to /schedules
+- Clicking execution with thread_id opens thread in new tab
+- Loading and empty states handled
+- Files changed: frontend/src/components/drawers/app-sidebar.tsx
+- **Learnings for future iterations:**
+  - The sidebar uses tab characters for indentation, not spaces
+  - Collapsible sections follow a consistent pattern with SidebarGroup, SidebarGroupLabel, CollapsibleTrigger
+  - useSchedules hook needs fetchSchedules() called manually on mount to populate schedule names
+  - Files in .claude/specs are gitignored; use `git add -f` to include them
+---
@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## v0.0.2-rc142
 
 ### Changed
+  - feat/722-frontend-schedule-refactor (2026-02-01)
   - feat/724-add-watcher-to-worker-reload (2026-02-01)
   - feat/715-ubuntu-execution-env (2026-01-31)
   - feat/442-able-to-edit-memorys (2026-01-31)