House keeping and chore refactoring to merge chore due date and chore schedule into a single table. This will allow for more flexibility in scheduling chores and tracking their completion. The following changes were made:

Author: jherforth

.gitignore

@@ -16,6 +16,15 @@ coverage/
 # sounds live in server/assets/ and ARE tracked; seeded copies land here.
 server/uploads/
 
+# Local SQLite database (runtime data, initialized by migrations)
+server/data/*.db
+server/data/*.db-journal
+server/data/*.db-wal
+server/data/*.db-shm
+
+# Generated encryption key (secret, do not commit)
+server/data/.encryption-key
+
 package-lock.json
 
 .vscode/

client/src/components/ChoreSchedulesTab.jsx

@@ -126,6 +126,7 @@ const defaultScheduleForm = {
   sleepCount: '',
   sleepUnit: 'd',
   visible: true,
+  due_date: '',
   due_time: '',
   sound_enabled: false,
   sound: '',
@@ -241,6 +242,7 @@ export default function ChoreSchedulesTab({ saveMessage, setSaveMessage }) {
       sleepCount: schedule.interval ? (schedule.interval.match(/^(\d+)/)?.[1] || '') : '',
       sleepUnit: schedule.interval ? (schedule.interval.match(/[dwmy]$/i)?.[0].toLowerCase() || 'd') : 'd',
       visible: !!schedule.visible,
+      due_date: schedule.due_date || '',
       due_time: schedule.due_time || '',
       sound_enabled: !!schedule.sound_enabled,
       sound: schedule.sound || '',
@@ -273,6 +275,7 @@ export default function ChoreSchedulesTab({ saveMessage, setSaveMessage }) {
         duration: !scheduleForm.isOneTime ? scheduleForm.duration : 'day-of',
         interval: normalizedInterval,
         visible: scheduleForm.visible ? 1 : 0,
+        due_date: scheduleForm.due_date || null,
         due_time: scheduleForm.due_time || null,
         sound_enabled: scheduleForm.sound_enabled ? 1 : 0,
         sound: scheduleForm.sound_enabled ? (scheduleForm.sound || null) : null,
@@ -928,6 +931,17 @@ export default function ChoreSchedulesTab({ saveMessage, setSaveMessage }) {
 
             <Divider />
 
+            <TextField
+              label="Due date (optional)"
+              type="date"
+              size="small"
+              value={scheduleForm.due_date}
+              onChange={(e) => updateScheduleForm({ due_date: e.target.value })}
+              InputLabelProps={{ shrink: true }}
+              helperText="Calendar deadline (best for one-time tasks). The chore turns yellow when due, red when overdue."
+              sx={{ maxWidth: 260 }}
+            />
+
             <TextField
               label="Due time (optional)"
               type="time"

client/src/components/ChoreWidget.jsx

@@ -20,13 +20,15 @@ import {
   DialogContent,
   DialogActions,
   Backdrop,
-  CircularProgress
+  CircularProgress,
+  Menu,
+  ListItemText
 } from '@mui/material';
-import { Edit, Save, Cancel, Add, Delete, Check, Undo } from '@mui/icons-material';
+import { Edit, Save, Cancel, Add, Delete, Check, Undo, SwapHoriz } from '@mui/icons-material';
 import axios from 'axios';
 import { API_BASE_URL } from '../utils/apiConfig.js';
 import { getDeviceApiBase } from '../utils/deviceName.js';
-import { shouldShowChoreToday, getTodayDateString, convertDaysToCrontab } from '../utils/choreHelpers.js';
+import { shouldShowChoreToday, getTodayDateString, convertDaysToCrontab, getDueDateStatus, formatDueDate } from '../utils/choreHelpers.js';
 
 const USERS_UPDATED_EVENT = 'homeglow:users-updated';
 
@@ -65,6 +67,8 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
   const [deviceSettingsLoaded, setDeviceSettingsLoaded] = useState(false);
   const [isLoading, setIsLoading] = useState(false);
   const [dailyClamReward, setDailyClamReward] = useState(2);
+  const [reassignAnchor, setReassignAnchor] = useState(null);
+  const [reassignSchedule, setReassignSchedule] = useState(null);
 
   const daysOfWeek = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
 
@@ -282,6 +286,46 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
     }
   };
 
+  const reassignChore = async (scheduleId, newUserId) => {
+    const schedule = schedules.find(s => s.id === scheduleId);
+    if (!schedule || schedule.user_id === newUserId) {
+      return;
+    }
+
+    try {
+      setIsLoading(true);
+      await axios.patch(`${API_BASE_URL}/api/chore-schedules/${scheduleId}`, {
+        user_id: newUserId,
+        visible: 1
+      });
+      await fetchData();
+    } catch (error) {
+      console.error('Error reassigning chore:', error);
+      alert(error.response?.data?.error || 'Failed to reassign chore');
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const openReassignMenu = (event, schedule) => {
+    event.stopPropagation();
+    setReassignAnchor(event.currentTarget);
+    setReassignSchedule(schedule);
+  };
+
+  const closeReassignMenu = () => {
+    setReassignAnchor(null);
+    setReassignSchedule(null);
+  };
+
+  const handleReassignSelect = (newUserId) => {
+    const scheduleId = reassignSchedule?.id;
+    closeReassignMenu();
+    if (scheduleId) {
+      reassignChore(scheduleId, newUserId);
+    }
+  };
+
   const saveChore = async () => {
     try {
       setIsLoading(true);
@@ -433,6 +477,15 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
   };
 
   const renderChoreItem = (schedule) => {
+    const dueStatus = getDueDateStatus(schedule.due_date, getTodayDateString(), schedule.completed);
+    const rowBgColor = schedule.completed
+      ? 'rgba(0, 255, 0, 0.1)'
+      : dueStatus === 'overdue'
+        ? 'rgba(244, 67, 54, 0.16)'
+        : dueStatus === 'due'
+          ? 'rgba(255, 193, 7, 0.20)'
+          : 'transparent';
+
     return (
       <Box
         key={schedule.id}
@@ -441,7 +494,7 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
           border: '1px solid var(--card-border)',
           borderRadius: 2,
           mb: 1,
-          bgcolor: schedule.completed ? 'rgba(0, 255, 0, 0.1)' : 'transparent',
+          bgcolor: rowBgColor,
           display: 'flex',
           justifyContent: 'space-between',
           alignItems: 'center'
@@ -465,14 +518,23 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
                 sx={{ ml: 1, fontSize: '0.7rem' }}
               />
             )}
+            {schedule.due_date && (
+              <Chip
+                label={`${dueStatus === 'overdue' ? '⚠️ Overdue' : `Due ${formatDueDate(schedule.due_date)}`}`}
+                size="small"
+                color={dueStatus === 'overdue' ? 'error' : dueStatus === 'due' ? 'warning' : 'default'}
+                variant={dueStatus === 'upcoming' || dueStatus === 'none' ? 'outlined' : 'filled'}
+                sx={{ ml: 1, fontSize: '0.7rem' }}
+              />
+            )}
           </Typography>
           {schedule.description && (
             <Typography variant="caption" color="text.secondary" sx={{ fontSize: '0.75rem' }}>
               {schedule.description}
             </Typography>
           )}
         </Box>
-        <Box sx={{ display: 'flex', gap: 1 }}>
+        <Box sx={{ display: 'flex', gap: 0.5 }}>
           <IconButton
             color={schedule.completed ? "secondary" : "primary"}
             onClick={() => toggleChoreCompletion(schedule, schedule.completed)}
@@ -491,6 +553,25 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
           >
             {schedule.completed ? <Undo fontSize="small" /> : <Check fontSize="small" />}
           </IconButton>
+          {users.length > 1 && (
+            <IconButton
+              onClick={(e) => openReassignMenu(e, schedule)}
+              size="small"
+              title="Reassign to another person"
+              sx={{
+                minWidth: 'auto',
+                width: 32,
+                height: 32,
+                color: 'var(--accent)',
+                border: '1px solid var(--card-border)',
+                '&:hover': {
+                  bgcolor: 'rgba(var(--accent-rgb), 0.1)'
+                }
+              }}
+            >
+              <SwapHoriz fontSize="small" />
+            </IconButton>
+          )}
         </Box>
       </Box>
     );
@@ -861,6 +942,25 @@ const ChoreWidget = ({ transparentBackground, refreshInterval = 0 }) => {
             </Button>
           </DialogActions>
         </Dialog>
+
+        <Menu
+          anchorEl={reassignAnchor}
+          open={Boolean(reassignAnchor)}
+          onClose={closeReassignMenu}
+          anchorOrigin={{ vertical: 'bottom', horizontal: 'right' }}
+          transformOrigin={{ vertical: 'top', horizontal: 'right' }}
+        >
+          <MenuItem disabled sx={{ opacity: 0.7, fontSize: '0.8rem' }}>
+            Reassign to…
+          </MenuItem>
+          {users
+            .filter(user => user.id !== reassignSchedule?.user_id)
+            .map(user => (
+              <MenuItem key={user.id} onClick={() => handleReassignSelect(user.id)}>
+                <ListItemText primary={user.username} />
+              </MenuItem>
+            ))}
+        </Menu>
       </Box>
 
       <Backdrop

client/src/utils/choreHelpers.js

@@ -64,3 +64,28 @@ export function convertDaysToCrontab(daysArray) {
   const dayNumbers = daysArray.map(day => dayMap[day.toLowerCase()]).sort();
   return `0 0 * * ${dayNumbers.join(',')}`;
 }
+
+// Urgency status for a chore's calendar due date (issue #97).
+// Compares 'YYYY-MM-DD' strings lexicographically (valid for ISO dates).
+// Returns: 'none' (no date / already completed), 'upcoming' (before due day),
+// 'due' (due today), or 'overdue' (past due).
+export function getDueDateStatus(dueDate, todayStr = getTodayDateString(), completed = false) {
+  if (!dueDate || completed) {
+    return 'none';
+  }
+  if (dueDate === todayStr) {
+    return 'due';
+  }
+  return dueDate < todayStr ? 'overdue' : 'upcoming';
+}
+
+// Formats a 'YYYY-MM-DD' string as a short, locale-friendly label (e.g. 'Jul 3').
+export function formatDueDate(dueDate) {
+  if (typeof dueDate !== 'string') return '';
+  const parts = dueDate.split('-').map(Number);
+  if (parts.length !== 3 || parts.some(Number.isNaN)) return dueDate;
+  const [year, month, day] = parts;
+  const date = new Date(year, month - 1, day);
+  if (Number.isNaN(date.getTime())) return dueDate;
+  return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric' });
+}

client/src/utils/choreHelpers.test.js

@@ -4,7 +4,7 @@ vi.mock('./timezone.js', () => ({
     getServerTimezoneSync: () => 'UTC',
 }));
 
-import { shouldShowChoreToday, convertDaysToCrontab } from './choreHelpers.js';
+import { shouldShowChoreToday, convertDaysToCrontab, getDueDateStatus, formatDueDate } from './choreHelpers.js';
 
 describe('choreHelpers utilities', () => {
     let consoleErrorSpy;
@@ -55,4 +55,40 @@ describe('choreHelpers utilities', () => {
     it('convertDaysToCrontab maps and sorts day values', () => {
         expect(convertDaysToCrontab(['friday', 'monday', 'sunday'])).toBe('0 0 * * 0,1,5');
     });
+
+    describe('getDueDateStatus', () => {
+        const today = '2026-05-01';
+
+        it('returns none when there is no due date', () => {
+            expect(getDueDateStatus(null, today, false)).toBe('none');
+            expect(getDueDateStatus('', today, false)).toBe('none');
+        });
+
+        it('returns none when the chore is already completed', () => {
+            expect(getDueDateStatus('2026-05-01', today, true)).toBe('none');
+        });
+
+        it('returns due when the due date is today', () => {
+            expect(getDueDateStatus('2026-05-01', today, false)).toBe('due');
+        });
+
+        it('returns overdue when the due date is in the past', () => {
+            expect(getDueDateStatus('2026-04-30', today, false)).toBe('overdue');
+        });
+
+        it('returns upcoming when the due date is in the future', () => {
+            expect(getDueDateStatus('2026-05-09', today, false)).toBe('upcoming');
+        });
+    });
+
+    describe('formatDueDate', () => {
+        it('formats a valid date as a short label', () => {
+            expect(formatDueDate('2026-07-03')).toBe('Jul 3');
+        });
+
+        it('passes through malformed input', () => {
+            expect(formatDueDate('not-a-date')).toBe('not-a-date');
+            expect(formatDueDate(null)).toBe('');
+        });
+    });
 });

docs/README.md

@@ -23,6 +23,7 @@ stays relevant.
 - [Database & Migrations](architecture/database.md) — SQLite schema, tables, and the migration system.
 - [Backend Reference](reference/backend-api.md) — server structure, services, and the full REST API surface.
 - [Frontend Reference](reference/frontend.md) — React component map, state, and data flow.
+- [Chores Refactor History](architecture/chores-refactor-history.md) — the (implemented) original design spec for the three-table chore system.
 
 ### Feature deep-dives
 - [Features & Domains](reference/features.md) — chores/clams, calendar sync, photos, screensaver, theming, tabs & layout.

docs/architecture/chores-refactor-history.md

@@ -1,3 +1,16 @@
+# Chores Refactor — Historical Design Spec
+
+> **Status: implemented.** This is the original design spec for the migration from the
+> old single-table chores model to the current three-table system
+> (`chores` / `chore_schedules` / `chore_history`). It is kept for history and to explain
+> *why* the schema looks the way it does. For the current schema and endpoints see
+> [database.md](database.md) and [../reference/backend-api.md](../reference/backend-api.md).
+> Later additions on top of this design: `duration`/`interval`/`parent_schedule_id`
+> (sticky/recurring scheduling), `due_time`/`sound*` (due-time notification sounds, #108),
+> and `due_date` (calendar deadlines with urgency coloring, #97).
+
+---
+
 Current State Analysis
 The existing system stores all chore information in a single chores table with fields: id, user_id, title, description, time_period, assigned_day_of_week, repeat_type, completed, clam_value, expiration_date. Clam totals are maintained in users.clam_total, and there's a pruneAndResetChores() function that runs on server startup to manage chore lifecycle.
 

docs/architecture/database.md

@@ -45,6 +45,7 @@ run in ascending order. The registry lives in `schemaMigrations` in
 | 13 | `schema13-tabsByDefaultBackfill.js` | Backfills default tabs. |
 | 14 | `schema14-deviceAndTabJsonStorage.js` | Moves widget layout into `tabs.config_json` and device settings into `devices.device_settings_json`; **drops** `widget_tab_assignments`. |
 | 15 | `schema15-choreDueTimeSound.js` | Adds `due_time`, `sound`, `sound_enabled`, `reminder_interval_minutes` to `chore_schedules` (chore due-time notification sounds). |
+| 16 | `schema16-choreDueDate.js` | Adds `due_date` to `chore_schedules` (calendar deadline with urgency coloring, issue #97). |
 
 Each versioned migration runs inside a transaction, reads its context from
 `globalThis.__HOMEGLOW_SCHEMA_MIGRATION_CONTEXT`, and writes the new
@@ -78,6 +79,7 @@ due_time,                     -- 'HH:MM' 24h local time the chore is due (nullab
 sound_enabled,                -- 0/1: play a notification sound at due_time
 sound,                        -- chosen sound filename; null = use global default
 reminder_interval_minutes,    -- null/0 = ring once; N = repeat every N min until completed
+due_date,                     -- 'YYYY-MM-DD' calendar deadline (nullable; drives yellow/red urgency, #97)
 visible, created_at
 ```
 

docs/reference/backend-api.md

@@ -125,7 +125,7 @@ static route.
 | --- | --- | --- |
 | GET/POST | `/api/chores` | List / create chore definitions. |
 | PATCH/DELETE | `/api/chores/:id` | Update / delete a chore. |
-| GET/POST | `/api/chore-schedules` | List (filter by `user_id`, `visible`, `usage`, `chore_id`) / create. Accepts `due_time` (`HH:MM`), `sound`, `sound_enabled`, `reminder_interval_minutes` for due-time sounds. |
+| GET/POST | `/api/chore-schedules` | List (filter by `user_id`, `visible`, `usage`, `chore_id`) / create. Accepts `due_time` (`HH:MM`), `sound`, `sound_enabled`, `reminder_interval_minutes` for due-time sounds, and `due_date` (`YYYY-MM-DD`) for calendar deadlines. PATCH `user_id` reassigns a chore and re-checks the daily bonus for both owners. |
 | GET/PATCH/DELETE | `/api/chore-schedules/:id` | Single schedule CRUD. |
 | POST | `/api/chore-schedules/bulk` | Bulk create schedules. |
 | GET/POST | `/api/chore-history` | Query / add history entries. |

docs/reference/features.md

@@ -78,6 +78,29 @@ optional follow-up **reminder interval** that repeats until the chore is complet
 `components/SoundPicker.jsx`; the sound fields on `chore_schedules`; `/api/sounds*` +
 seeding in `server/index.js`; defaults generated by `server/scripts/generateDefaultSounds.js`.
 
+### Chore due-dates (issue #97)
+
+A schedule can carry a **calendar due date** (`due_date`, `YYYY-MM-DD`) — a deadline,
+distinct from the due-*time* chime above. It's aimed at **one-off chores** (which already
+persist on the list until completed), e.g. "prep the guest sheets by Friday." The chore row
+colors by urgency: **yellow** when due today, **red** (with an "⚠️ Overdue" chip) once past
+due, and a plain "Due <date>" chip while upcoming. Completing the chore clears the
+coloring. Purely visual — `due_date` does not change which chores appear.
+
+**Code:** `getDueDateStatus`/`formatDueDate` in `utils/choreHelpers.js`; row coloring + chip
+in `ChoreWidget.jsx`; the `due_date` field in `ChoreSchedulesTab.jsx`; `due_date` column and
+validation in `server/index.js`.
+
+### Reassigning a chore (from the dashboard)
+
+Each chore row has a **swap-arrow** button (when more than one user exists) that opens a
+dropdown to move the chore to another person without opening settings. The backend
+reassignment (a `PATCH` of the schedule's `user_id`) re-checks the daily "all regular chores
+done" bonus for **both** the previous and new owner and never removes points.
+
+**Code:** reassign UI in `ChoreWidget.jsx`; `PATCH /api/chore-schedules/:id` +
+`awardDailyRegularBonusIfDue` in `server/index.js`.
+
 ## Calendar
 
 - Supports multiple sources simultaneously: **public ICS** links, **CalDAV**