DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
feat: add a workspace-scoped task board
krxi2eb2f2de96a7
diff --git a/README.md b/README.mdindex 5693726e4..275d8487b 100644--- a/README.md+++ b/README.md@@ -232,6 +232,7 @@DeepTutor is an agent-native learning workspace that connects tutoring, problem solving, quiz generation, research, visualization, and mastery practice in one extensible system.- **One runtime for every mode** — Chat, Ask Questions, Quiz, Research, Visualize, Solve, Course Study, Mastery Path, Immersive Reading, and Immersive Watching share one capability runtime and session context while keeping purpose-built loops and pipelines.+- **Task Board** — Track study tasks in To do, In progress, and Done, with notes, drag-and-drop or keyboard-accessible move buttons, and an archive you can restore from. Cards stay in the current workspace and follow the existing appearance and language settings; no model configuration is required.- **Connected learning context** — Knowledge bases, books, Co-Writer drafts, notebooks, question banks, personas, and Memory can be reused across the workflows that support them, subject to account grants and learning policies.- **Immersive video learning** — paste a YouTube link for privacy-enhanced native playback, synchronized captions, timestamp-grounded tutoring, and resumable progress; administrators can switch playback to a self-hosted Invidious instance without rebuilding materials.- **Subagents and Partners** — from Chat, consult a live agent harness (Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo, Hermes, OpenClaw, or DeepSeek) or a Partner, import past conversations, and run persistent IM companions on the same brain.diff --git a/deeptutor/api/main.py b/deeptutor/api/main.pyindex ddfdd2975..ffdb27ffa 100644--- a/deeptutor/api/main.py+++ b/deeptutor/api/main.py@@ -558,6 +558,7 @@ from deeptutor.api.routers import (space_mcp,subagents,system,+ task_board,unified_ws,video_learning,visualizers,@@ -635,6 +636,9 @@ app.include_router()app.include_router(co_writer.router, prefix="/api", tags=["documents"], dependencies=_auth)app.include_router(notebook.router, prefix="/api", tags=["notebooks"], dependencies=_auth)+app.include_router(+ task_board.router, prefix="/api/task-board", tags=["task-board"], dependencies=_auth+)app.include_router(book.router, prefix="/api", tags=["books"], dependencies=_auth)app.include_router(book.ws_router, prefix="/ws", tags=["books"])app.include_router(reading.router, prefix="/api/reading", tags=["reading"], dependencies=_auth)diff --git a/deeptutor/api/routers/task_board.py b/deeptutor/api/routers/task_board.pynew file mode 100644index 000000000..9703748f9--- /dev/null+++ b/deeptutor/api/routers/task_board.py@@ -0,0 +1,28 @@+"""Authenticated task board endpoints using the current content workspace."""++from fastapi import APIRouter, HTTPException++from deeptutor.services.task_board import CreateCard, TaskBoard, UpdateCard, get_task_board_store++router = APIRouter()++[email protected]("", response_model=TaskBoard)+def get_board() -> TaskBoard:+ """Return active and archived cards in the current workspace."""+ return get_task_board_store().read()++[email protected]("/cards", response_model=TaskBoard, status_code=201)+def create_card(payload: CreateCard) -> TaskBoard:+ """Create a task in the To do column."""+ return get_task_board_store().create(payload)++[email protected]("/cards/{card_id}", response_model=TaskBoard)+def update_card(card_id: str, payload: UpdateCard) -> TaskBoard:+ """Edit, move, archive or restore an existing task."""+ try:+ return get_task_board_store().update(card_id, payload)+ except KeyError as exc:+ raise HTTPException(status_code=404, detail="Task card not found.") from excdiff --git a/deeptutor/services/task_board.py b/deeptutor/services/task_board.pynew file mode 100644index 000000000..c140ca16c--- /dev/null+++ b/deeptutor/services/task_board.py@@ -0,0 +1,139 @@+"""Workspace-local task cards with transactional, multi-worker-safe persistence."""++from __future__ import annotations++from contextlib import closing+from datetime import datetime, timezone+from pathlib import Path+import sqlite3+from typing import Annotated, Literal+from uuid import uuid4++from pydantic import BaseModel, ConfigDict, StringConstraints, field_validator++from deeptutor.services.path_service import get_path_service+from deeptutor.utils.secret_files import ensure_private_directory++TaskStatus = Literal["todo", "doing", "done"]+TaskTitle = Annotated[str, StringConstraints(strip_whitespace=True, min_length=1, max_length=160)]+TaskNote = Annotated[str, StringConstraints(max_length=2000)]+++class CreateCard(BaseModel):+ """A learner-authored task; identifiers and timestamps are server-owned."""++ model_config = ConfigDict(extra="forbid")+ title: TaskTitle+ note: TaskNote = ""+++class UpdateCard(BaseModel):+ """Only supplied fields change, preserving concurrent edits to other fields."""++ model_config = ConfigDict(extra="forbid")+ title: TaskTitle | None = None+ note: TaskNote | None = None+ status: TaskStatus | None = None+ archived: bool | None = None++ @field_validator("title", "note", "status", "archived", mode="before")+ @classmethod+ def reject_null(cls, value: object) -> object:+ """Omission is allowed; explicitly clearing a required field is not."""+ if value is None:+ raise ValueError("Card fields cannot be null.")+ return value+++class TaskCard(CreateCard):+ """Persisted card returned to the board, including archived cards."""++ id: str+ status: TaskStatus+ archived: bool+ created_at: str+ updated_at: str+++class TaskBoard(BaseModel):+ """A consistent snapshot of the current workspace's board."""++ cards: list[TaskCard]+++class TaskBoardStore:+ """Open short-lived SQLite connections; never cache a user's active scope."""++ def __init__(self, path: Path):+ self.path = path++ def _connect(self) -> sqlite3.Connection:+ ensure_private_directory(self.path.parent)+ connection = sqlite3.connect(self.path, timeout=10)+ connection.row_factory = sqlite3.Row+ connection.execute(+ """CREATE TABLE IF NOT EXISTS cards (+ id TEXT PRIMARY KEY,+ title TEXT NOT NULL,+ note TEXT NOT NULL DEFAULT '',+ status TEXT NOT NULL CHECK(status IN ('todo', 'doing', 'done')),+ archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),+ created_at TEXT NOT NULL,+ updated_at TEXT NOT NULL+ )"""+ )+ return connection++ @staticmethod+ def _snapshot(connection: sqlite3.Connection) -> TaskBoard:+ rows = connection.execute("SELECT * FROM cards ORDER BY created_at, id")+ return TaskBoard(cards=[TaskCard.model_validate(dict(row)) for row in rows])++ def read(self) -> TaskBoard:+ """Read cards without creating storage for an unused board."""+ if not self.path.exists():+ return TaskBoard(cards=[])+ with closing(self._connect()) as connection:+ return self._snapshot(connection)++ def create(self, payload: CreateCard) -> TaskBoard:+ """Add a task and return the snapshot committed by this transaction."""+ now = datetime.now(timezone.utc).isoformat()+ with closing(self._connect()) as connection, connection:+ connection.execute(+ "INSERT INTO cards VALUES (?, ?, ?, 'todo', 0, ?, ?)",+ (uuid4().hex, payload.title, payload.note, now, now),+ )+ return self._snapshot(connection)++ def update(self, card_id: str, payload: UpdateCard) -> TaskBoard:+ """Edit, move, archive or restore a card atomically; fail if absent."""+ if not self.path.exists():+ raise KeyError(card_id)+ changes = payload.model_dump(exclude_unset=True)+ with closing(self._connect()) as connection, connection:+ # Serialize the read/modify/write across processes as well as threads.+ connection.execute("BEGIN IMMEDIATE")+ row = connection.execute("SELECT * FROM cards WHERE id = ?", (card_id,)).fetchone()+ if row is None:+ raise KeyError(card_id)+ card = TaskCard.model_validate(dict(row))+ updated = TaskCard.model_validate({**card.model_dump(), **changes})+ connection.execute(+ """UPDATE cards SET title = ?, note = ?, status = ?, archived = ?,+ updated_at = ? WHERE id = ?""",+ (+ updated.title,+ updated.note,+ updated.status,+ updated.archived,+ datetime.now(timezone.utc).isoformat(),+ card_id,+ ),+ )+ return self._snapshot(connection)+++def get_task_board_store() -> TaskBoardStore:+ """Resolve storage after DeepTutor has installed the request's user/workspace."""+ return TaskBoardStore(get_path_service().get_workspace_dir() / "task-board" / "cards.sqlite")diff --git a/deeptutor/services/workspace/data_migration.py b/deeptutor/services/workspace/data_migration.pyindex 9ee10ab8e..baa11adc6 100644--- a/deeptutor/services/workspace/data_migration.py+++ b/deeptutor/services/workspace/data_migration.py@@ -32,6 +32,7 @@ FEATURES = {"reading": "Immersive Reading","timed_media": "Immersive Watching","notebook": "Notebooks",+ "task-board": "Task Board","co-writer": "Writing","courses": "Courses","files": "File library",diff --git a/tests/multi_user/test_task_board.py b/tests/multi_user/test_task_board.pynew file mode 100644index 000000000..be827e779--- /dev/null+++ b/tests/multi_user/test_task_board.py@@ -0,0 +1,191 @@+"""Task board persistence, validation and authenticated workspace isolation."""++from concurrent.futures import ThreadPoolExecutor++from fastapi import Depends, FastAPI+from fastapi.testclient import TestClient+import pytest++from deeptutor.api.routers import auth, task_board+from deeptutor.services.auth import TokenPayload+from deeptutor.services.task_board import (+ CreateCard,+ TaskBoardStore,+ UpdateCard,+ get_task_board_store,+)+from deeptutor.services.workspace import get_content_workspace_service+from deeptutor.services.workspace.activity import WorkspaceActivityMiddleware+from deeptutor.services.workspace.context import workspace_context+++def client(mu_isolated_root, monkeypatch):+ """Use real auth/scope dependencies, with fixture identities and isolated disk."""+ monkeypatch.setattr(auth, "AUTH_ENABLED", True)+ monkeypatch.setattr(+ auth,+ "decode_token",+ lambda token: (+ TokenPayload(username=token, role="user", user_id=token)+ if token in {"alice", "bob"}+ else None+ ),+ )+ app = FastAPI()+ app.add_middleware(WorkspaceActivityMiddleware)+ app.include_router(+ task_board.router,+ prefix="/api/task-board",+ dependencies=[Depends(auth.require_learning_surface)],+ )+ with TestClient(app) as result:+ yield result+++def headers(user="alice"):+ return {"Authorization": f"Bearer {user}"}+++def test_authentication_is_required_for_reads_and_writes(client):+ for authorization in ({}, headers("invalid")):+ assert client.get("/api/task-board", headers=authorization).status_code == 401+ assert (+ client.post("/api/task-board/cards", json={"title": "Review"}, headers=authorization)+ ).status_code == 401+ assert (+ client.patch("/api/task-board/cards/unknown", json={}, headers=authorization)+ ).status_code == 401+++def test_create_edit_move_archive_restore_and_reload(client):+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+ response = client.post(+ "/api/task-board/cards", json={"title": " Review derivatives "}, headers=headers()+ )+ assert response.status_code == 201+ card = response.json()["cards"][0]+ assert card["title"] == "Review derivatives"+ assert card["status"] == "todo"+ url = f"/api/task-board/cards/{card['id']}"+ for changes in (+ {"note": "Try three examples", "title": "Practice derivatives"},+ {"status": "doing"},+ {"status": "done"},+ {"archived": True},+ {"archived": False},+ ):+ response = client.patch(url, json=changes, headers=headers())+ assert response.status_code == 200+ assert all(response.json()["cards"][0][key] == value for key, value in changes.items())+ saved = client.get("/api/task-board", headers=headers()).json()["cards"][0]+ assert saved["title"] == "Practice derivatives"+ assert saved["note"] == "Try three examples"+ assert saved["status"] == "done"+ assert not saved["archived"]+ assert saved["created_at"] == card["created_at"]+ assert saved["updated_at"] >= card["updated_at"]+++ "payload",+ [{"title": " "}, {"title": "x" * 161}, {"title": "Valid", "note": "x" * 2001}, {"id": "x"}],+)+def test_rejects_invalid_new_cards(client, payload):+ assert client.post("/api/task-board/cards", json=payload, headers=headers()).status_code == 422+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+++ "payload",+ [{"status": "invalid"}, {"title": None}, {"note": None}, {"archived": None}, {"id": "x"}],+)+def test_invalid_changes_do_not_modify_existing_cards(client, payload):+ board = client.post("/api/task-board/cards", json={"title": "Review"}, headers=headers()).json()+ card_id = board["cards"][0]["id"]+ response = client.patch(f"/api/task-board/cards/{card_id}", json=payload, headers=headers())+ assert response.status_code == 422+ assert client.get("/api/task-board", headers=headers()).json() == board+++def test_other_accounts_cannot_read_or_modify_cards(client):+ card = client.post(+ "/api/task-board/cards", json={"title": "Private task"}, headers=headers()+ ).json()["cards"][0]+ assert client.get("/api/task-board", headers=headers("bob")).json() == {"cards": []}+ response = client.patch(+ f"/api/task-board/cards/{card['id']}", json={"archived": True}, headers=headers("bob")+ )+ assert response.status_code == 404+ assert client.get("/api/task-board", headers=headers()).json()["cards"] == [card]+++def test_workspace_selection_and_archived_workspace_guard(client, as_user):+ with as_user("alice"):+ service = get_content_workspace_service()+ first = service.create_workspace("First")+ second = service.create_workspace("Second")+ first_query = {"dt_workspace": first["workspace_id"]}+ second_query = {"dt_workspace": second["workspace_id"]}+ card = client.post(+ "/api/task-board/cards",+ json={"title": "Scoped task"},+ headers=headers(),+ params=first_query,+ ).json()["cards"][0]+ assert client.get("/api/task-board", headers=headers(), params=second_query).json() == {+ "cards": []+ }+ assert client.get("/api/task-board", headers=headers()).json() == {"cards": []}+ assert (+ client.patch(+ f"/api/task-board/cards/{card['id']}",+ json={"status": "done"},+ headers=headers(),+ params=second_query,+ ).status_code+ == 404+ )+ assert client.get(+ "/api/task-board", headers=headers("bob"), params=first_query+ ).status_code in {403, 404, 409}+ with as_user("alice"):+ with workspace_context(first["workspace_id"]):+ assert get_task_board_store().read().cards[0].id == card["id"]+ service.update_workspace(first["workspace_id"], archived=True)+ assert (+ client.patch(+ f"/api/task-board/cards/{card['id']}",+ json={"status": "done"},+ headers=headers(),+ params=first_query,+ ).status_code+ == 404+ )+++def test_concurrent_connections_preserve_cards_and_independent_fields(tmp_path):+ path = tmp_path / "task-board" / "cards.sqlite"+ assert TaskBoardStore(path).read().cards == []+ assert not path.exists()+ with ThreadPoolExecutor(max_workers=6) as pool:+ list(+ pool.map(+ lambda i: TaskBoardStore(path).create(CreateCard(title=f"Task {i}")), range(24)+ )+ )+ cards = TaskBoardStore(path).read().cards+ assert len(cards) == 24+ assert len({card.id for card in cards}) == 24+ with ThreadPoolExecutor(max_workers=2) as pool:+ futures = [+ pool.submit(+ TaskBoardStore(path).update, cards[0].id, UpdateCard(note="Keep this note")+ ),+ pool.submit(TaskBoardStore(path).update, cards[0].id, UpdateCard(status="done")),+ ]+ for future in futures:+ future.result()+ updated = TaskBoardStore(path).read().cards[0]+ assert updated.note == "Keep this note"+ assert updated.status == "done"diff --git a/tests/services/workspace/test_data_migration.py b/tests/services/workspace/test_data_migration.pyindex 59323aa00..7dd519ae1 100644--- a/tests/services/workspace/test_data_migration.py+++ b/tests/services/workspace/test_data_migration.py@@ -15,6 +15,27 @@ from deeptutor.services.workspace.models import WorkspaceErrorfrom tests.services.workspace.test_data_scope import account as account+def test_task_board_export_and_migration_preserve_archived_cards(account):+ from deeptutor.services.task_board import CreateCard, UpdateCard, get_task_board_store+ from deeptutor.services.workspace.data_migration import export_path++ target = account.create_workspace("Destination")["workspace_id"]+ with workspace_context():+ store = get_task_board_store()+ card = store.create(CreateCard(title="Review examples")).cards[0]+ expected = store.update(card.id, UpdateCard(status="done", archived=True))+ feature = next(row for row in discover()["features"] if row["feature"] == "task-board")+ assert not feature["error"]+ exported = export_data("", ["task-board"])+ with zipfile.ZipFile(export_path(exported["id"])) as archive:+ assert any(name.endswith("cards.sqlite") for name in archive.namelist())+ assert migrate_data("", target, ["task-board"])["status"] == "completed"+ with workspace_context(target):+ assert get_task_board_store().read() == expected+ with workspace_context():+ assert get_task_board_store().read().cards == []++@pytest.mark.asyncioasync def test_migration_keeps_messages_branches_questions_and_source_backup(account):target = account.create_workspace("Destination")["workspace_id"]diff --git a/web/app/(workspace)/kanban/page.tsx b/web/app/(workspace)/kanban/page.tsxnew file mode 100644index 000000000..14fc0718c--- /dev/null+++ b/web/app/(workspace)/kanban/page.tsx@@ -0,0 +1,338 @@+'use client'++import { useEffect, useRef, useState } from 'react'+import {+ Archive,+ ArrowLeft,+ ArrowRight,+ Check,+ ClipboardList,+ Plus,+ RotateCcw,+ X,+} from 'lucide-react'+import { useTranslation } from 'react-i18next'+import SpaceSectionHeader from '@/components/space/SpaceSectionHeader'++import {+ createTaskCard,+ getTaskBoard,+ updateTaskCard,+ type TaskBoard,+ type TaskCard,+ type TaskStatus,+} from '@/lib/task-board-api'++const columns: { id: TaskStatus; title: string; hint: string; tone: string }[] = [+ { id: 'todo', title: 'kanban.todo', hint: 'kanban.todoHint', tone: 'var(--info)' },+ { id: 'doing', title: 'kanban.doing', hint: 'kanban.doingHint', tone: 'var(--warning)' },+ { id: 'done', title: 'kanban.done', hint: 'kanban.doneHint', tone: 'var(--success)' },+]++export default function KanbanPage() {+ const { t } = useTranslation()+ const [board, setBoard] = useState<TaskBoard | null>(null)+ const [title, setTitle] = useState('')+ const [editing, setEditing] = useState<string | null>(null)+ const [draftTitle, setDraftTitle] = useState('')+ const [draftNote, setDraftNote] = useState('')+ const [busy, setBusy] = useState(false)+ const [error, setError] = useState('')+ const [dragged, setDragged] = useState<string | null>(null)++ const pending = useRef(false)+ const [showArchived, setShowArchived] = useState(false)+ const [reload, setReload] = useState(0)++ useEffect(() => {+ const controller = new AbortController()+ getTaskBoard(controller.signal)+ .then(result => {+ if (!controller.signal.aborted) setBoard(result)+ })+ .catch(() => {+ if (!controller.signal.aborted) setError('kanban.loadError')+ })+ return () => controller.abort()+ }, [reload])++ async function act(operation: () => Promise<TaskBoard>, onSuccess?: () => void) {+ if (pending.current || !board) return+ pending.current = true+ setBusy(true)+ setError('')+ try {+ setBoard(await operation())+ onSuccess?.()+ } catch {+ setError('kanban.saveError')+ } finally {+ pending.current = false+ setBusy(false)+ }+ }++ function startEdit(card: TaskCard) {+ setEditing(card.id)+ setDraftTitle(card.title)+ setDraftNote(card.note)+ }++ const active = board?.cards.filter(card => !card.archived) ?? []+ const visible = board?.cards.filter(card => card.archived === showArchived) ?? []+ const count = (status: TaskStatus) => visible.filter(card => card.status === status).length++ return (+ <div className="h-full overflow-y-auto bg-[var(--background)] [scrollbar-gutter:stable]">+ <main className="mx-auto max-w-5xl px-4 py-8 sm:px-8 pb-12 font-sans text-[var(--foreground)]">+ <SpaceSectionHeader+ icon={ClipboardList}+ title={t('Task Board')}+ description={t('kanban.intro')}+ action={+ <button+ type="button"+ aria-pressed={showArchived}+ disabled={busy}+ onClick={() => {+ setShowArchived(value => !value)+ setEditing(null)+ }}+ className="rounded-lg border border-[var(--border)] px-3 py-2 text-sm text-[var(--foreground)] hover:bg-[var(--accent)] disabled:opacity-40"+ >+ {t(showArchived ? 'kanban.showActive' : 'kanban.showArchived')}+ </button>+ }+ meta={+ <span className="rounded-full bg-[var(--muted)] px-2.5 py-1 font-sans text-xs font-medium text-[var(--muted-foreground)]">+ {active.filter(card => card.status === 'doing').length} {t('kanban.working')}+ </span>+ }+ />++ <form+ className="mb-7 flex gap-2 rounded-2xl bg-[var(--card)] p-2 shadow-sm ring-1 ring-[var(--border)]"+ onSubmit={event => {+ event.preventDefault()+ if (title.trim())+ void act(+ () => createTaskCard(title),+ () => {+ setTitle('')+ setShowArchived(false)+ }+ )+ }}+ >+ <input+ disabled={!board || busy}+ aria-label={t('kanban.newTask')}+ className="min-w-0 flex-1 bg-transparent px-3 py-2 outline-none placeholder:text-[var(--muted-foreground)]"+ placeholder={t('kanban.placeholder')}+ maxLength={160}+ value={title}+ onChange={event => setTitle(event.target.value)}+ />+ <button+ disabled={busy || !board || !title.trim()}+ className="flex items-center gap-2 rounded-xl bg-[var(--primary)] px-4 py-2 font-semibold text-[var(--primary-foreground)] transition hover:opacity-90 disabled:opacity-40"+ type="submit"+ >+ <Plus size={18} /> {t('kanban.add')}+ </button>+ </form>+ {!board && !error && (+ <p role="status" className="mb-5 text-sm text-[var(--muted-foreground)]">+ {t('kanban.loading')}+ </p>+ )}+ {error && (+ <p+ role="alert"+ className="mb-5 rounded-xl bg-[var(--secondary)] p-3 text-sm text-[var(--destructive)]"+ >+ {t(error)}+ {!board && (+ <button+ type="button"+ className="ml-3 underline"+ onClick={() => {+ setError('')+ setReload(value => value + 1)+ }}+ >+ {t('kanban.retry')}+ </button>+ )}+ </p>+ )}++ <div aria-busy={busy || !board} className="grid gap-5 lg:grid-cols-3">+ {columns.map((column, index) => (+ <section+ key={column.id}+ aria-label={t(column.title)}+ onDragOver={event => event.preventDefault()}+ onDrop={event => {+ event.preventDefault()+ if (dragged && !showArchived)+ void act(() => updateTaskCard(dragged, { status: column.id }))+ setDragged(null)+ }}+ className="min-h-[22rem] rounded-2xl border border-[var(--border)] bg-[var(--secondary)] p-4"+ >+ <div className="mb-4 flex items-center justify-between">+ <div className="flex items-center gap-3">+ <span+ className="h-2.5 w-2.5 rounded-full"+ style={{ backgroundColor: column.tone }}+ />+ <div>+ <h2 className="font-semibold">{t(column.title)}</h2>+ <p className="text-xs text-[var(--muted-foreground)]">{t(column.hint)}</p>+ </div>+ </div>+ <span className="rounded-full bg-[var(--card)] px-2.5 py-1 text-xs font-bold text-[var(--muted-foreground)]">+ {count(column.id)}+ </span>+ </div>+ <div className="space-y-3">+ {visible+ .filter(card => card.status === column.id)+ .map(card => (+ <article+ key={card.id}+ draggable={!busy && !showArchived && editing !== card.id}+ onDragStart={event => {+ event.dataTransfer.setData('text/plain', card.id)+ event.dataTransfer.effectAllowed = 'move'+ setDragged(card.id)+ }}+ onDragEnd={() => setDragged(null)}+ className="rounded-xl bg-[var(--card)] p-4 shadow-sm ring-1 ring-[var(--border)]"+ >+ {editing === card.id ? (+ <form+ onSubmit={event => {+ event.preventDefault()+ if (draftTitle.trim())+ void act(+ () =>+ updateTaskCard(card.id, { title: draftTitle, note: draftNote }),+ () => setEditing(null)+ )+ }}+ >+ <input+ aria-label={t('kanban.taskTitle')}+ className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 font-semibold text-[var(--foreground)]"+ maxLength={160}+ value={draftTitle}+ onChange={event => setDraftTitle(event.target.value)}+ />+ <textarea+ aria-label={t('kanban.taskNote')}+ className="mt-2 w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-2 py-1 text-sm text-[var(--foreground)]"+ placeholder={t('kanban.notePlaceholder')}+ rows={3}+ maxLength={2000}+ value={draftNote}+ onChange={event => setDraftNote(event.target.value)}+ />+ <div className="mt-2 flex gap-2">+ <button+ disabled={busy || !draftTitle.trim()}+ className="flex items-center gap-1 rounded-lg bg-[var(--primary)] px-3 py-1.5 text-xs font-semibold text-[var(--primary-foreground)] disabled:opacity-40"+ type="submit"+ >+ <Check size={14} /> {t('kanban.save')}+ </button>+ <button+ className="flex items-center gap-1 rounded-lg px-2 py-1.5 text-xs text-[var(--muted-foreground)]"+ type="button"+ onClick={() => setEditing(null)}+ >+ <X size={14} /> {t('kanban.cancel')}+ </button>+ </div>+ </form>+ ) : (+ <>+ <button+ type="button"+ disabled={busy}+ className="w-full text-left"+ onClick={() => startEdit(card)}+ >+ <strong className="break-words text-sm leading-6">{card.title}</strong>+ {card.note && (+ <p className="mt-1 whitespace-pre-wrap break-words text-xs leading-5 text-[var(--muted-foreground)]">+ {card.note}+ </p>+ )}+ </button>+ <div className="mt-4 flex items-center justify-between border-t border-[var(--border)] pt-3">+ <div className="flex gap-1">+ {!showArchived && index > 0 && (+ <button+ disabled={busy}+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index - 1].title)}`}+ title={t('kanban.back')}+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"+ onClick={() =>+ void act(() =>+ updateTaskCard(card.id, { status: columns[index - 1].id })+ )+ }+ >+ <ArrowLeft size={16} />+ </button>+ )}+ {!showArchived && index < 2 && (+ <button+ disabled={busy}+ aria-label={`${card.title}: ${t('kanban.moveTo')} ${t(columns[index + 1].title)}`}+ title={t('kanban.forward')}+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"+ onClick={() =>+ void act(() =>+ updateTaskCard(card.id, { status: columns[index + 1].id })+ )+ }+ >+ <ArrowRight size={16} />+ </button>+ )}+ </div>+ <button+ disabled={busy}+ aria-label={`${card.title}: ${t(card.archived ? 'kanban.restore' : 'kanban.archive')}`}+ title={t(card.archived ? 'kanban.restore' : 'kanban.archive')}+ className="rounded-lg p-1.5 text-[var(--muted-foreground)] hover:bg-[var(--accent)]"+ onClick={() =>+ void act(() =>+ updateTaskCard(card.id, { archived: !card.archived })+ )+ }+ >+ {card.archived ? <RotateCcw size={15} /> : <Archive size={15} />}+ </button>+ </div>+ </>+ )}+ </article>+ ))}+ {board && count(column.id) === 0 && (+ <p className="rounded-xl border border-dashed border-[var(--border)] px-4 py-10 text-center text-sm text-[var(--muted-foreground)]">+ {t(showArchived ? 'kanban.emptyArchive' : 'kanban.empty')}+ </p>+ )}+ </div>+ </section>+ ))}+ </div>+ <p className="mt-6 text-xs text-[var(--muted-foreground)]">{t('kanban.footer')}</p>+ </main>+ </div>+ )+}diff --git a/web/components/sidebar/nav-entries.ts b/web/components/sidebar/nav-entries.tsindex f35927edf..8e7863939 100644--- a/web/components/sidebar/nav-entries.ts+++ b/web/components/sidebar/nav-entries.ts@@ -5,6 +5,7 @@ import {HeartHandshake,House,LayoutGrid,+ ListTodo,PenLine,Settings,type LucideIcon,@@ -47,6 +48,7 @@ export const PRIMARY_NAV: NavEntry[] = [tooltipKey: 'One tutor, your own way to learn.',},{ href: '/space', label: 'Learning Space', icon: LayoutGrid, tooltipKey: 'Space tooltip' },+ { href: '/kanban', label: 'Task Board', icon: ListTodo, tooltipKey: 'kanban.intro' },{href: '/co-writer',label: 'Co-Writer',diff --git a/web/contracts/generated/api.ts b/web/contracts/generated/api.tsindex 9562048d5..f35feaef1 100644--- a/web/contracts/generated/api.ts+++ b/web/contracts/generated/api.ts@@ -9518,6 +9518,66 @@ export interface paths {readonly patch?: never;readonly trace?: never;};+ readonly "/api/task-board": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ /**+ * Get Board+ * @description Return active and archived cards in the current workspace.+ */+ readonly get: operations["get_board_api_task_board_get"];+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/task-board/cards": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ /**+ * Create Card+ * @description Create a task in the To do column.+ */+ readonly post: operations["create_card_api_task_board_cards_post"];+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ readonly patch?: never;+ readonly trace?: never;+ };+ readonly "/api/task-board/cards/{card_id}": {+ readonly parameters: {+ readonly query?: never;+ readonly header?: never;+ readonly path?: never;+ readonly cookie?: never;+ };+ readonly get?: never;+ readonly put?: never;+ readonly post?: never;+ readonly delete?: never;+ readonly options?: never;+ readonly head?: never;+ /**+ * Update Card+ * @description Edit, move, archive or restore an existing task.+ */+ readonly patch: operations["update_card_api_task_board_cards__card_id__patch"];+ readonly trace?: never;+ };readonly "/api/tools": {readonly parameters: {readonly query?: never;@@ -11272,6 +11332,19 @@ export interface components {*/readonly user_intent: string;};+ /**+ * CreateCard+ * @description A learner-authored task; identifiers and timestamps are server-owned.+ */+ readonly CreateCard: {+ /**+ * Note+ * @default+ */+ readonly note: string;+ /** Title */+ readonly title: string;+ };/** CreateCourseRequest */readonly CreateCourseRequest: {/**@@ -14649,6 +14722,40 @@ export interface components {/** Updated */readonly updated: number;};+ /**+ * TaskBoard+ * @description A consistent snapshot of the current workspace's board.+ */+ readonly TaskBoard: {+ /** Cards */+ readonly cards: readonly components["schemas"]["TaskCard"][];+ };+ /**+ * TaskCard+ * @description Persisted card returned to the board, including archived cards.+ */+ readonly TaskCard: {+ /** Archived */+ readonly archived: boolean;+ /** Created At */+ readonly created_at: string;+ /** Id */+ readonly id: string;+ /**+ * Note+ * @default+ */+ readonly note: string;+ /**+ * Status+ * @enum {string}+ */+ readonly status: "todo" | "doing" | "done";+ /** Title */+ readonly title: string;+ /** Updated At */+ readonly updated_at: string;+ };/** TestResponse */readonly TestResponse: {/** Error */@@ -15241,6 +15348,20 @@ export interface components {/** Title */readonly title?: string | null;};+ /**+ * UpdateCard+ * @description Only supplied fields change, preserving concurrent edits to other fields.+ */+ readonly UpdateCard: {+ /** Archived */+ readonly archived?: boolean | null;+ /** Note */+ readonly note?: string | null;+ /** Status */+ readonly status?: ("todo" | "doing" | "done") | null;+ /** Title */+ readonly title?: string | null;+ };/** UpdateCourseRequest */readonly UpdateCourseRequest: {/** Color */@@ -16023,6 +16144,7 @@ export type SchemaConnectWeKnoraRequest =components["schemas"]["ConnectWeKnoraRequest"];export type SchemaCreateBookRequest =components["schemas"]["CreateBookRequest"];+export type SchemaCreateCard = components["schemas"]["CreateCard"];export type SchemaCreateCourseRequest =components["schemas"]["CreateCourseRequest"];export type SchemaCreateDocumentRequest =@@ -16359,6 +16481,8 @@ export type SchemaSyncFolderResponse =export type SchemaSyncObjectIn = components["schemas"]["SyncObjectIn"];export type SchemaSyncRequest = components["schemas"]["SyncRequest"];export type SchemaSyncResponse = components["schemas"]["SyncResponse"];+export type SchemaTaskBoard = components["schemas"]["TaskBoard"];+export type SchemaTaskCard = components["schemas"]["TaskCard"];export type SchemaTestResponse = components["schemas"]["TestResponse"];export type SchemaTextPositionSelectorPayload =components["schemas"]["TextPositionSelectorPayload"];@@ -16389,6 +16513,7 @@ export type SchemaUiSettingsUpdate = components["schemas"]["UISettingsUpdate"];export type SchemaUnitText = components["schemas"]["UnitText"];export type SchemaUpdateBlockRequest =components["schemas"]["UpdateBlockRequest"];+export type SchemaUpdateCard = components["schemas"]["UpdateCard"];export type SchemaUpdateCourseRequest =components["schemas"]["UpdateCourseRequest"];export type SchemaUpdateDocumentRequest =@@ -37640,6 +37765,115 @@ export interface operations {};};};+ readonly get_board_api_task_board_get: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody?: never;+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly create_card_api_task_board_cards_post: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path?: never;+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["CreateCard"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 201: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };+ readonly update_card_api_task_board_cards__card_id__patch: {+ readonly parameters: {+ readonly query?: never;+ readonly header?: {+ readonly Authorization?: string | null;+ };+ readonly path: {+ readonly card_id: string;+ };+ readonly cookie?: {+ readonly dt_token?: string | null;+ };+ };+ readonly requestBody: {+ readonly content: {+ readonly "application/json": components["schemas"]["UpdateCard"];+ };+ };+ readonly responses: {+ /** @description Successful Response */+ readonly 200: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["TaskBoard"];+ };+ };+ /** @description Validation Error */+ readonly 422: {+ headers: {+ readonly [name: string]: unknown;+ };+ content: {+ readonly "application/json": components["schemas"]["HTTPValidationError"];+ };+ };+ };+ };readonly list_builtin_tools_api_tools_get: {readonly parameters: {readonly query?: never;diff --git a/web/contracts/schema/openapi.json b/web/contracts/schema/openapi.jsonindex 4b7e844a0..6fd146877 100644--- a/web/contracts/schema/openapi.json+++ b/web/contracts/schema/openapi.json@@ -2219,6 +2219,29 @@"title": "CreateBookRequest","type": "object"},+ "CreateCard": {+ "additionalProperties": false,+ "description": "A learner-authored task; identifiers and timestamps are server-owned.",+ "properties": {+ "note": {+ "default": "",+ "maxLength": 2000,+ "title": "Note",+ "type": "string"+ },+ "title": {+ "maxLength": 160,+ "minLength": 1,+ "title": "Title",+ "type": "string"+ }+ },+ "required": [+ "title"+ ],+ "title": "CreateCard",+ "type": "object"+ },"CreateCourseRequest": {"properties": {"color": {@@ -9562,6 +9585,76 @@"title": "TTSRequest","type": "object"},+ "TaskBoard": {+ "description": "A consistent snapshot of the current workspace's board.",+ "properties": {+ "cards": {+ "items": {+ "$ref": "#/components/schemas/TaskCard"+ },+ "title": "Cards",+ "type": "array"+ }+ },+ "required": [+ "cards"+ ],+ "title": "TaskBoard",+ "type": "object"+ },+ "TaskCard": {+ "additionalProperties": false,+ "description": "Persisted card returned to the board, including archived cards.",+ "properties": {+ "archived": {+ "title": "Archived",+ "type": "boolean"+ },+ "created_at": {+ "title": "Created At",+ "type": "string"+ },+ "id": {+ "title": "Id",+ "type": "string"+ },+ "note": {+ "default": "",+ "maxLength": 2000,+ "title": "Note",+ "type": "string"+ },+ "status": {+ "enum": [+ "todo",+ "doing",+ "done"+ ],+ "title": "Status",+ "type": "string"+ },+ "title": {+ "maxLength": 160,+ "minLength": 1,+ "title": "Title",+ "type": "string"+ },+ "updated_at": {+ "title": "Updated At",+ "type": "string"+ }+ },+ "required": [+ "title",+ "id",+ "status",+ "archived",+ "created_at",+ "updated_at"+ ],+ "title": "TaskCard",+ "type": "object"+ },"TestResponse": {"properties": {"error": {@@ -10776,6 +10869,66 @@"title": "UpdateBlockRequest","type": "object"},+ "UpdateCard": {+ "additionalProperties": false,+ "description": "Only supplied fields change, preserving concurrent edits to other fields.",+ "properties": {+ "archived": {+ "anyOf": [+ {+ "type": "boolean"+ },+ {+ "type": "null"+ }+ ],+ "title": "Archived"+ },+ "note": {+ "anyOf": [+ {+ "maxLength": 2000,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Note"+ },+ "status": {+ "anyOf": [+ {+ "enum": [+ "todo",+ "doing",+ "done"+ ],+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Status"+ },+ "title": {+ "anyOf": [+ {+ "maxLength": 160,+ "minLength": 1,+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Title"+ }+ },+ "title": "UpdateCard",+ "type": "object"+ },"UpdateCourseRequest": {"properties": {"color": {@@ -56608,6 +56761,233 @@]}},+ "/api/task-board": {+ "get": {+ "description": "Return active and archived cards in the current workspace.",+ "operationId": "get_board_api_task_board_get",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Get Board",+ "tags": [+ "task-board"+ ]+ }+ },+ "/api/task-board/cards": {+ "post": {+ "description": "Create a task in the To do column.",+ "operationId": "create_card_api_task_board_cards_post",+ "parameters": [+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateCard"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Create Card",+ "tags": [+ "task-board"+ ]+ }+ },+ "/api/task-board/cards/{card_id}": {+ "patch": {+ "description": "Edit, move, archive or restore an existing task.",+ "operationId": "update_card_api_task_board_cards__card_id__patch",+ "parameters": [+ {+ "in": "path",+ "name": "card_id",+ "required": true,+ "schema": {+ "title": "Card Id",+ "type": "string"+ }+ },+ {+ "in": "header",+ "name": "Authorization",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Authorization"+ }+ },+ {+ "in": "cookie",+ "name": "dt_token",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "title": "Dt Token"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateCard"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/TaskBoard"+ }+ }+ },+ "description": "Successful Response"+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ },+ "description": "Validation Error"+ }+ },+ "summary": "Update Card",+ "tags": [+ "task-board"+ ]+ }+ },"/api/tools": {"get": {"description": "Return all built-in tools the chat agent can invoke, plus any\ncoming-soon placeholders for the settings page.",diff --git a/web/lib/task-board-api.ts b/web/lib/task-board-api.tsnew file mode 100644index 000000000..4a1defa63--- /dev/null+++ b/web/lib/task-board-api.ts@@ -0,0 +1,48 @@+import { apiFetch, apiUrl } from '@/shared/api/client'++export type TaskStatus = 'todo' | 'doing' | 'done'++export interface TaskCard {+ id: string+ title: string+ note: string+ status: TaskStatus+ archived: boolean+ created_at: string+ updated_at: string+}++export interface TaskBoard {+ cards: TaskCard[]+}++const endpoint = '/api/task-board'++async function request(path: string, init?: RequestInit): Promise<TaskBoard> {+ const response = await apiFetch(apiUrl(path), init)+ if (!response.ok) throw new Error('Task board request failed')+ return response.json() as Promise<TaskBoard>+}++export function getTaskBoard(signal?: AbortSignal): Promise<TaskBoard> {+ return request(endpoint, { signal, cache: 'no-store' })+}++export function createTaskCard(title: string): Promise<TaskBoard> {+ return request(`${endpoint}/cards`, {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ title }),+ })+}++export function updateTaskCard(+ id: string,+ changes: Partial<Pick<TaskCard, 'title' | 'note' | 'status' | 'archived'>>+): Promise<TaskBoard> {+ return request(`${endpoint}/cards/${encodeURIComponent(id)}`, {+ method: 'PATCH',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify(changes),+ })+}diff --git a/web/locales/en/app.json b/web/locales/en/app.jsonindex 1b3332c44..6a94b818c 100644--- a/web/locales/en/app.json+++ b/web/locales/en/app.json@@ -5197,5 +5197,36 @@"Workspace {{name}}": "Workspace {{name}}","The collection's files and reading conversations are kept in this workspace.": "The collection's files and reading conversations are kept in this workspace.","{{count}} files_one": "{{count}} file",- "{{count}} files_other": "{{count}} files"+ "{{count}} files_other": "{{count}} files",+ "Task Board": "Task Board",+ "kanban.intro": "Keep work moving from idea to done.",+ "kanban.working": "in progress",+ "kanban.todo": "To do",+ "kanban.todoHint": "Next steps and ideas",+ "kanban.doing": "In progress",+ "kanban.doingHint": "What I am working on",+ "kanban.done": "Done",+ "kanban.doneHint": "Finished work",+ "kanban.newTask": "New task",+ "kanban.placeholder": "Add a task…",+ "kanban.add": "Add",+ "kanban.empty": "Drop a card here",+ "kanban.taskTitle": "Task title",+ "kanban.taskNote": "Task note",+ "kanban.notePlaceholder": "Short note (optional)",+ "kanban.save": "Save",+ "kanban.cancel": "Cancel",+ "kanban.back": "Move back",+ "kanban.forward": "Move forward",+ "kanban.moveTo": "Move to",+ "kanban.archive": "Archive",+ "kanban.footer": "Cards are saved in this workspace. Drag a card or use the arrow buttons to move it.",+ "kanban.loadError": "Could not open the board. Refresh the page.",+ "kanban.saveError": "Could not save the card.",+ "kanban.loading": "Loading task board…",+ "kanban.retry": "Retry",+ "kanban.showArchived": "Show archived",+ "kanban.showActive": "Show active",+ "kanban.restore": "Restore",+ "kanban.emptyArchive": "No archived tasks"}diff --git a/web/locales/fr/app.json b/web/locales/fr/app.jsonindex d07fd97f1..5856a367f 100644--- a/web/locales/fr/app.json+++ b/web/locales/fr/app.json@@ -4442,5 +4442,36 @@"The collection's files and reading conversations are kept in this workspace.": "Les fichiers de la collection et ses conversations de lecture sont conservés dans cet espace de travail.","{{count}} files_one": "{{count}} fichier","{{count}} files_other": "{{count}} fichiers",- "Save new content to": "Enregistrer le nouveau contenu dans"+ "Save new content to": "Enregistrer le nouveau contenu dans",+ "Task Board": "Tableau des tâches",+ "kanban.intro": "Faites avancer vos tâches de l'idée à la réalisation.",+ "kanban.working": "en cours",+ "kanban.todo": "À faire",+ "kanban.todoHint": "Prochaines étapes et idées",+ "kanban.doing": "En cours",+ "kanban.doingHint": "Ce sur quoi je travaille",+ "kanban.done": "Terminé",+ "kanban.doneHint": "Travail terminé",+ "kanban.newTask": "Nouvelle tâche",+ "kanban.placeholder": "Ajouter une tâche…",+ "kanban.add": "Ajouter",+ "kanban.empty": "Déposez une carte ici",+ "kanban.taskTitle": "Titre de la tâche",+ "kanban.taskNote": "Note de la tâche",+ "kanban.notePlaceholder": "Note courte (facultatif)",+ "kanban.save": "Enregistrer",+ "kanban.cancel": "Annuler",+ "kanban.back": "Reculer",+ "kanban.forward": "Avancer",+ "kanban.moveTo": "Déplacer vers",+ "kanban.archive": "Archiver",+ "kanban.footer": "Les cartes sont enregistrées dans cet espace de travail. Déplacez-les par glisser-déposer ou avec les boutons fléchés.",+ "kanban.loadError": "Impossible d'ouvrir le tableau. Actualisez la page.",+ "kanban.saveError": "Impossible d'enregistrer la carte.",+ "kanban.loading": "Chargement du tableau…",+ "kanban.retry": "Réessayer",+ "kanban.showArchived": "Afficher les archives",+ "kanban.showActive": "Afficher les tâches actives",+ "kanban.restore": "Restaurer",+ "kanban.emptyArchive": "Aucune tâche archivée"}diff --git a/web/locales/uk/app.json b/web/locales/uk/app.jsonindex d9991009c..ed2cb9e21 100644--- a/web/locales/uk/app.json+++ b/web/locales/uk/app.json@@ -5213,5 +5213,36 @@"{{count}} files_one": "{{count}} файл","{{count}} files_few": "{{count}} файли","{{count}} files_many": "{{count}} файлів",- "{{count}} files_other": "{{count}} файлу"+ "{{count}} files_other": "{{count}} файлу",+ "Task Board": "Дошка завдань",+ "kanban.intro": "Переміщуйте завдання від ідеї до завершення.",+ "kanban.working": "у роботі",+ "kanban.todo": "Зробити",+ "kanban.todoHint": "Наступні кроки та ідеї",+ "kanban.doing": "У роботі",+ "kanban.doingHint": "Над чим я працюю",+ "kanban.done": "Готово",+ "kanban.doneHint": "Завершена робота",+ "kanban.newTask": "Нове завдання",+ "kanban.placeholder": "Додати завдання…",+ "kanban.add": "Додати",+ "kanban.empty": "Перетягніть картку сюди",+ "kanban.taskTitle": "Назва завдання",+ "kanban.taskNote": "Нотатка до завдання",+ "kanban.notePlaceholder": "Коротка нотатка (необов'язково)",+ "kanban.save": "Зберегти",+ "kanban.cancel": "Скасувати",+ "kanban.back": "Назад",+ "kanban.forward": "Уперед",+ "kanban.moveTo": "Перемістити до",+ "kanban.archive": "Архівувати",+ "kanban.footer": "Картки зберігаються в цьому робочому просторі. Перетягніть картку або скористайтеся кнопками зі стрілками.",+ "kanban.loadError": "Не вдалося відкрити дошку. Оновіть сторінку.",+ "kanban.saveError": "Не вдалося зберегти картку.",+ "kanban.loading": "Завантаження дошки завдань…",+ "kanban.retry": "Повторити",+ "kanban.showArchived": "Показати архівні",+ "kanban.showActive": "Показати активні",+ "kanban.restore": "Відновити",+ "kanban.emptyArchive": "Немає архівних завдань"}diff --git a/web/locales/zh/app.json b/web/locales/zh/app.jsonindex 0f38bb2e4..985eb7bfe 100644--- a/web/locales/zh/app.json+++ b/web/locales/zh/app.json@@ -5197,5 +5197,36 @@"Workspace {{name}}": "工作区 {{name}}","The collection's files and reading conversations are kept in this workspace.": "资料组的原始文件和阅读对话都保存在这个工作区下。","{{count}} files_one": "{{count}} 个文件",- "{{count}} files_other": "{{count}} 个文件"+ "{{count}} files_other": "{{count}} 个文件",+ "Task Board": "任务看板",+ "kanban.intro": "让任务从想法逐步走向完成。",+ "kanban.working": "项进行中",+ "kanban.todo": "待办",+ "kanban.todoHint": "下一步与想法",+ "kanban.doing": "进行中",+ "kanban.doingHint": "正在处理的事",+ "kanban.done": "已完成",+ "kanban.doneHint": "完成的工作",+ "kanban.newTask": "新任务",+ "kanban.placeholder": "添加任务…",+ "kanban.add": "添加",+ "kanban.empty": "将卡片拖到这里",+ "kanban.taskTitle": "任务标题",+ "kanban.taskNote": "任务备注",+ "kanban.notePlaceholder": "简短备注(可选)",+ "kanban.save": "保存",+ "kanban.cancel": "取消",+ "kanban.back": "移回",+ "kanban.forward": "向前移动",+ "kanban.moveTo": "移至",+ "kanban.archive": "归档",+ "kanban.footer": "卡片保存在当前工作区中。拖动卡片或使用箭头按钮移动。",+ "kanban.loadError": "无法打开看板。请刷新页面。",+ "kanban.saveError": "无法保存卡片。",+ "kanban.loading": "正在加载任务看板…",+ "kanban.retry": "重试",+ "kanban.showArchived": "显示已归档",+ "kanban.showActive": "显示未归档",+ "kanban.restore": "恢复",+ "kanban.emptyArchive": "没有已归档任务"}diff --git a/web/tests/sidebar-defaults.spec.tsx b/web/tests/sidebar-defaults.spec.tsxindex d4911ac92..39f938a64 100644--- a/web/tests/sidebar-defaults.spec.tsx+++ b/web/tests/sidebar-defaults.spec.tsx@@ -12,7 +12,7 @@ import {beforeEach(() => localStorage.clear());-it("new profiles see four primary entries and two folded features", () => {+it("new profiles see five primary entries and two folded features", () => {expect(readNavLayout()).toBeNull();const resolved = resolveNavLayout(PRIMARY_NAV_HREFS,@@ -24,6 +24,7 @@ it("new profiles see four primary entries and two folded features", () => {"/partners","/learning","/space",+ "/kanban",]);expect(resolved.collapsed).toEqual(["/co-writer", "/agents"]);expect(resolved.customized).toBe(false);diff --git a/web/tests/task-board.spec.tsx b/web/tests/task-board.spec.tsxnew file mode 100644index 000000000..074f8d55e--- /dev/null+++ b/web/tests/task-board.spec.tsx@@ -0,0 +1,139 @@+import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react'+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'+import KanbanPage from '@/app/(workspace)/kanban/page'+import type { TaskBoard } from '@/lib/task-board-api'+import translations from '@/locales/en/app.json'++vi.mock('react-i18next', () => ({+ useTranslation: () => ({+ t: (key: string) => (translations as Record<string, string>)[key] ?? key,+ }),+}))++let board: TaskBoard+let failSave: boolean++beforeEach(() => {+ board = { cards: [] }+ failSave = false+ window.history.replaceState({}, '', '/kanban?dt_workspace=study')+ vi.stubGlobal(+ 'fetch',+ vi.fn(async (input: string, init?: RequestInit) => {+ const url = new URL(input, window.location.origin)+ expect(url.searchParams.get('dt_workspace')).toBe('study')+ expect(init?.credentials).toBe('include')+ if (init?.method === 'POST') {+ if (failSave) return Response.json({}, { status: 500 })+ const payload = JSON.parse(String(init.body))+ board.cards.push({+ id: 'task-1',+ title: payload.title,+ note: '',+ status: 'todo',+ archived: false,+ created_at: '2026-01-01',+ updated_at: '2026-01-01',+ })+ } else if (init?.method === 'PATCH') {+ if (failSave) return Response.json({}, { status: 500 })+ board.cards[0] = { ...board.cards[0], ...JSON.parse(String(init.body)) }+ }+ return Response.json(board)+ })+ )+})++afterEach(() => {+ vi.unstubAllGlobals()+ window.history.replaceState({}, '', '/')+})++async function addTask() {+ await waitFor(() => expect(screen.getByRole('textbox', { name: 'New task' })).toBeEnabled())+ fireEvent.change(screen.getByRole('textbox', { name: 'New task' }), {+ target: { value: 'Review derivatives' },+ })+ fireEvent.click(screen.getByRole('button', { name: 'Add' }))+ await screen.findByRole('button', { name: 'Review derivatives' })+}++describe('Task Board', () => {+ it('creates, edits, moves, archives and restores cards through the scoped API', async () => {+ render(<KanbanPage />)+ await addTask()+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))+ fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {+ target: { value: 'Three examples' },+ })+ fireEvent.click(screen.getByRole('button', { name: 'Save' }))+ await screen.findByText('Three examples')+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives: Move to In progress' }))+ await waitFor(() =>+ expect(+ within(screen.getByRole('region', { name: 'In progress' })).getByText('Review derivatives')+ ).toBeInTheDocument()+ )+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives: Archive' }))+ await waitFor(() => expect(screen.queryByText('Review derivatives')).not.toBeInTheDocument())+ fireEvent.click(screen.getByRole('button', { name: 'Show archived' }))+ fireEvent.click(await screen.findByRole('button', { name: 'Review derivatives: Restore' }))+ await waitFor(() => expect(screen.queryByText('Review derivatives')).not.toBeInTheDocument())+ fireEvent.click(screen.getByRole('button', { name: 'Show active' }))+ expect(+ within(screen.getByRole('region', { name: 'In progress' })).getByText('Review derivatives')+ ).toBeInTheDocument()+ expect(screen.getByText('Three examples')).toBeInTheDocument()+ })++ it('moves a dragged card and reads it again after remounting', async () => {+ const view = render(<KanbanPage />)+ await addTask()+ const dataTransfer = { setData: vi.fn(), effectAllowed: '' }+ fireEvent.dragStart(screen.getByRole('article'), { dataTransfer })+ fireEvent.drop(screen.getByRole('region', { name: 'Done' }), { dataTransfer })+ await waitFor(() =>+ expect(+ within(screen.getByRole('region', { name: 'Done' })).getByText('Review derivatives')+ ).toBeInTheDocument()+ )+ view.unmount()+ render(<KanbanPage />)+ await waitFor(() =>+ expect(+ within(screen.getByRole('region', { name: 'Done' })).getByText('Review derivatives')+ ).toBeInTheDocument()+ )+ })++ it('keeps the draft and existing card when saving fails', async () => {+ render(<KanbanPage />)+ await addTask()+ fireEvent.click(screen.getByRole('button', { name: 'Review derivatives' }))+ fireEvent.change(screen.getByRole('textbox', { name: 'Task note' }), {+ target: { value: 'Unsaved note' },+ })+ failSave = true+ fireEvent.click(screen.getByRole('button', { name: 'Save' }))+ expect(await screen.findByRole('alert')).toHaveTextContent('Could not save the card.')+ expect(screen.getByRole('textbox', { name: 'Task note' })).toHaveValue('Unsaved note')+ expect(board.cards[0].note).toBe('')+ })++ it('disables creation during loading and lets a failed load retry', async () => {+ let rejectLoad!: (error: Error) => void+ vi.mocked(fetch).mockImplementationOnce(+ () =>+ new Promise((_resolve, reject) => {+ rejectLoad = reject+ })+ )+ render(<KanbanPage />)+ expect(screen.getByRole('status')).toHaveTextContent('Loading task board')+ expect(screen.getByRole('button', { name: 'Add' })).toBeDisabled()+ await act(async () => rejectLoad(new Error('Offline')))+ fireEvent.click(await screen.findByRole('button', { name: 'Retry' }))+ await waitFor(() => expect(screen.getByRole('textbox', { name: 'New task' })).toBeEnabled())+ expect(screen.queryByRole('alert')).not.toBeInTheDocument()+ })+})