feat(tasks): per-project task lists with deadlines + a cross-project task board

The user runs 50+ projects and had only one free-text note per project (rolled up by the "Next"
view) — no checklist, no done state, no deadline. Now each project has a structured task list, and
the "Next" view becomes a cross-project task board grouped by due date.

- New pure src/shared/tasks.ts (TDD, 17 tests): Todo type, classifyDue (local-calendar-day
  overdue/today/week/later/none — DST-safe), groupTasksByDue (incomplete-only, fixed order,
  intra-group sort), taskCounts (card badge), immutable add/toggle/edit/setDue/remove reducers,
  sanitizeTodos (drops junk, caps text + list length).
- StoreEntry.todos (default []), sanitized on read + write; getTodos/setTodos mirror setNote.
  ProjectViewModel.todos flows through buildProjectList so listProjects() carries todos. New
  project:setTodos IPC (sanitizes) + preload + global.d.ts.
- Next view = task board: add (project picker + text + optional date), check off, inline text edit,
  a due chip that opens a date picker, delete, and open. Grouped 지연/오늘/이번 주/나중/날짜 없음
  with a header count + overdue total. Supersedes the note/cue rollup (nextItems.ts removed; the
  resume cue still shows on each card).
- Deck card / list row: a compact read-only badge "done/total · overdue" (hidden when no tasks, red
  when overdue) → click jumps to the board. Todos are in projectSignature so the badge updates on
  the in-place refresh.
- Locale keys x4 (157/locale); date-only deadlines (no clock time).

Scope: brainstorm chose "planning + deadlines" of three directions (a scheduling calendar and
per-project info management deferred to their own specs). QA: 358 tests (+16 net); a compiled
store->group end-to-end check green; Playwright harness 0 console/page errors across all views x4
locales incl. the new task board. Deferred: drag-reorder, priority, recurring, reminders, calendar
view, subtasks, tags.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: writingdeveloper

README.md

@@ -11,7 +11,7 @@ See every repo's state at a glance — git status, how long it's been neglected,
 ![License](https://img.shields.io/badge/license-MIT-blue)
 ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-0078D6)
 ![Built with Electron](https://img.shields.io/badge/Electron-31-47848F)
-![Tests](https://img.shields.io/badge/tests-342%20passing-3fb950)
+![Tests](https://img.shields.io/badge/tests-358%20passing-3fb950)
 ![CI](https://github.com/writingdeveloper/devdeck/actions/workflows/ci.yml/badge.svg)
 
 <img src="docs/demo/demo.gif" width="820" alt="DevDeck demo" />

package.json

@@ -1,6 +1,6 @@
 {
   "name": "devdeck",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Project command deck — at-a-glance state + claude -c resume",
   "main": "dist/main/main.js",
   "type": "commonjs",

qa/screenshot.mjs

@@ -114,6 +114,14 @@ await win.waitForTimeout(400);
 await shot('titlebar-maximized');
 await win.evaluate(() => window.devdeck.windowControls.toggleMaximize());
 
+// Next task board: navigate + capture (empty-state render path — add form + no open tasks in the
+// isolated QA profile). Guards the tasks.ts wiring renders without console/page errors.
+await showView('next');
+await win.waitForSelector('#view-next .tk-add, #view-next .empty', { timeout: 5000 }).catch(() => {});
+await shot('next-tasks');
+const nextAdd = await win.evaluate(() => !!document.querySelector('#view-next .tk-add'));
+console.log('next task-board add form present:', nextAdd);
+
 // Cockpit view: navigate and capture the empty state (no PTY spawned in the harness)
 await showView('cockpit');
 await win.waitForSelector('#ck-empty', { timeout: 5000 }).catch(() => {});

src/main/ipc.ts

@@ -22,6 +22,7 @@ import type { WtTab } from '../shared/wtArgs';
 import { scanUsage } from './usageScan';
 import { listClaudeProjectDirs } from './usageProjectsScan';
 import { classifyUsageProjects } from '../shared/usageProjects';
+import { sanitizeTodos } from '../shared/tasks';
 import { getUsageWindows, readClaudeCredentials, fetchUsageApi, type CacheEntry } from './claudeUsage';
 import type { PersistedSession } from '../shared/cockpitPersist';
 import { readClaudeSessionMeta } from './sessionMeta';
@@ -86,6 +87,10 @@ export function registerIpc(cfg: IpcConfig): void {
   ipcMain.handle('project:setNote', (_e, path: string, note: string) => {
     cfg.store.setNote(path, String(note).slice(0, 10000));
   });
+  ipcMain.handle('project:setTodos', (_e, path: string, todos: unknown) => {
+    // store.setTodos sanitizes (drops junk, caps text + list length), so an untrusted array is safe.
+    cfg.store.setTodos(path, sanitizeTodos(todos));
+  });
   ipcMain.handle('project:setPinned', (_e, path: string, pinned: boolean) => {
     cfg.store.setPinned(path, pinned);
   });

src/main/projects.test.ts

@@ -24,7 +24,7 @@ function deps(over: Partial<BuildDeps>): BuildDeps {
     }),
     sessions: () => [],
     resumeCue: () => null,
-    getEntry: () => ({ note: '', pinned: false, hidden: false, lastOpened: null }),
+    getEntry: () => ({ note: '', pinned: false, hidden: false, lastOpened: null, todos: [] }),
     ...over,
   };
 }
@@ -40,7 +40,7 @@ describe('buildProjectList', () => {
   it('includes hidden projects in output (renderer filters them)', async () => {
     const list = await buildProjectList(deps({
       getEntry: (path) => ({
-        note: '', pinned: false, hidden: path.endsWith('old'), lastOpened: null,
+        note: '', pinned: false, hidden: path.endsWith('old'), lastOpened: null, todos: [],
       }),
     }));
     expect(list.map((p) => p.name)).toEqual(['fresh', 'old']);
@@ -51,7 +51,7 @@ describe('buildProjectList', () => {
   it('floats pinned projects to the top regardless of activity', async () => {
     const list = await buildProjectList(deps({
       getEntry: (path) => ({
-        note: '', pinned: path.endsWith('old'), hidden: false, lastOpened: null,
+        note: '', pinned: path.endsWith('old'), hidden: false, lastOpened: null, todos: [],
       }),
     }));
     expect(list[0].name).toBe('old');

src/main/projects.ts

@@ -47,6 +47,7 @@ export async function buildProjectList(deps: BuildDeps): Promise<ProjectViewMode
         lastOpened: entry.lastOpened,
         resumeCue: cueText ? ({ kind: 'lastMessage', text: cueText } satisfies ResumeCue) : null,
         repoUrl: git.repoUrl,
+        todos: entry.todos,
       };
     }),
   );

src/main/store.test.ts

@@ -17,10 +17,19 @@ describe('Store', () => {
   it('returns a default entry for an unknown project', () => {
     const s = new Store(file);
     expect(s.get('C:\\g\\x')).toEqual({
-      note: '', pinned: false, hidden: false, lastOpened: null,
+      note: '', pinned: false, hidden: false, lastOpened: null, todos: [],
     });
   });
 
+  it('persists todos across instances and sanitizes junk on read', () => {
+    const s1 = new Store(file);
+    const good = { id: 'a', text: 'ship v2', done: false, due: '2026-07-04', createdAt: '2026-07-01T00:00:00Z' };
+    s1.setTodos('C:\\g\\x', [good, { id: '', text: 'bad' } as never]); // bad entry dropped on write
+    const s2 = new Store(file);
+    expect(s2.getTodos('C:\\g\\x')).toEqual([good]);
+    expect(s2.get('C:\\g\\x').todos).toEqual([good]); // also exposed on the full entry
+  });
+
   it('persists a note across instances', () => {
     const s1 = new Store(file);
     s1.setNote('C:\\g\\x', '다음: Task1');

src/main/store.ts

@@ -2,14 +2,15 @@ import { readFileSync, writeFileSync, existsSync, renameSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { StoreEntry, Folder } from '../shared/types';
 import { sanitizePersistedList, type PersistedSession } from '../shared/cockpitPersist';
+import { sanitizeTodos, type Todo } from '../shared/tasks';
 
 interface StateFile {
   projects: Record<string, StoreEntry>;
   settings?: { language?: string; baseDir?: string; folders?: Folder[]; thresholds?: { freshDays: number; warnDays: number; neglectedDays: number }; agent?: string; openAtLogin?: boolean; viewMode?: 'cards' | 'list'; cockpitSessions?: PersistedSession[]; trayAlert?: 'off' | 'attention' | 'all' };
 }
 
 const EMPTY: StoreEntry = {
-  note: '', pinned: false, hidden: false, lastOpened: null,
+  note: '', pinned: false, hidden: false, lastOpened: null, todos: [],
 };
 
 export class Store {
@@ -40,7 +41,8 @@ export class Store {
   }
 
   get(path: string): StoreEntry {
-    return { ...EMPTY, ...this.state.projects[path] };
+    const e = { ...EMPTY, ...this.state.projects[path] };
+    return { ...e, todos: sanitizeTodos(e.todos) }; // never hand out unvalidated on-disk todos
   }
 
   private mutate(path: string, patch: Partial<StoreEntry>): void {
@@ -99,6 +101,8 @@ export class Store {
 
 
   setNote(path: string, note: string): void { this.mutate(path, { note }); }
+  getTodos(path: string): Todo[] { return this.get(path).todos; }
+  setTodos(path: string, todos: Todo[]): void { this.mutate(path, { todos: sanitizeTodos(todos) }); }
   setPinned(path: string, pinned: boolean): void { this.mutate(path, { pinned }); }
   setHidden(path: string, hidden: boolean): void { this.mutate(path, { hidden }); }
   setLastOpened(path: string, iso: string): void { this.mutate(path, { lastOpened: iso }); }

src/preload/preload.ts

@@ -3,6 +3,7 @@ import { contextBridge, ipcRenderer } from 'electron';
 contextBridge.exposeInMainWorld('devdeck', {
   listProjects: () => ipcRenderer.invoke('projects:list'),
   setNote: (path: string, note: string) => ipcRenderer.invoke('project:setNote', path, note),
+  setTodos: (path: string, todos: unknown) => ipcRenderer.invoke('project:setTodos', path, todos),
   setPinned: (path: string, pinned: boolean) => ipcRenderer.invoke('project:setPinned', path, pinned),
   setHidden: (path: string, hidden: boolean) => ipcRenderer.invoke('project:setHidden', path, hidden),
   open: (items: { path: string; sessionId: string | null }[]) => ipcRenderer.invoke('projects:open', items),

src/renderer/global.d.ts

@@ -5,6 +5,7 @@ declare global {
     devdeck: {
       listProjects(): Promise<ProjectViewModel[]>;
       setNote(path: string, note: string): Promise<void>;
+      setTodos(path: string, todos: import('../shared/tasks').Todo[]): Promise<void>;
       setPinned(path: string, pinned: boolean): Promise<void>;
       setHidden(path: string, hidden: boolean): Promise<void>;
       open(items: { path: string; sessionId: string | null }[]): Promise<void>;