feat(kanban): Interactive Kanban board with real-time task tracking (#83)

* feat(kanban): add Kanban board with task-manager skill, modal UI, and desk clutter Implement a full Kanban board system for tracking agent tasks: - Add task-manager skill with shared JSON task store for persistence - Render board as a floating modal over the live 3D office (not immersive) - Auto-create tasks from actionable user messages with heuristic filtering - Sync task status through OpenClaw agent lifecycle events - Collapse task details panel by default, expand on card click - Add dynamic desk clutter (papers, folders, etc.) reflecting active task count - Exclude done tasks from desk clutter count - Extract KANBAN_CLUTTER_OFFSET for easy positioning adjustment - Add install flow with progress bar for the task-manager skill - Include unit and e2e test coverage Made-with: Cursor * feat(kanban): production-harden task board with AI-free classification, resilient persistence, and modal UX - Harden shared task store with atomic writes, payload size limits, and server-side enum validation - Add client resilience: request timeouts (AbortController), exponential backoff retries, poll deduplication - Implement optimistic UI with rollback on all card mutations (update, move, archive) - Add modal accessibility: focus trap, Escape to close, aria-modal, keyboard card navigation - Trust OpenClaw agent lifecycle phase=start as task classification signal instead of regex heuristics - Keep regex heuristic only as lightweight filter for direct chat events (conversational noise) - Expand verb recognition with typo tolerance and broader action vocabulary - Create tasks from agent runs even when no chat event is received (external channel support) - Merge dual header bars into single bar; reposition close button outside modal corner - Exclude done tasks from desk clutter count; make clutter position configurable via KANBAN_CLUTTER_OFFSET - Update default furniture layout to match user configuration - Ensure kanban_board furniture persists in local storage across sessions - Add comprehensive test coverage for store, API route, and controller logic Made-with: Cursor --------- Co-authored-by: iamlukethedev <lucas.guilherme@smartwayslfl.com>
2026-03-30 22:58:18 -05:00
parent 464a49bb6d
commit a997f13601
46 changed files with 5950 additions and 143 deletions
@@ -191,4 +191,113 @@ describe("studio settings normalization", () => {
      }),
    );
  });
+
+  it("normalizes task board cards per gateway", () => {
+    const normalized = normalizeStudioSettings({
+      taskBoard: {
+        " ws://localhost:18789 ": {
+          cards: [
+            {
+              id: " task-1 ",
+              title: "  Review kanban interaction  ",
+              status: "review",
+              source: "openclaw_event",
+              assignedAgentId: " agent-1 ",
+              createdAt: "2026-03-29T10:00:00.000Z",
+              updatedAt: "2026-03-29T10:05:00.000Z",
+              notes: [" note one ", " ", "note two"],
+            },
+          ],
+          selectedCardId: " task-1 ",
+        },
+      },
+    });
+
+    expect(normalized.taskBoard?.["ws://localhost:18789"]).toEqual(
+      expect.objectContaining({
+        selectedCardId: "task-1",
+        cards: [
+          expect.objectContaining({
+            id: "task-1",
+            title: "Review kanban interaction",
+            assignedAgentId: "agent-1",
+            notes: ["note one", "note two"],
+          }),
+        ],
+      }),
+    );
+  });
+
+  it("merges task board patches", () => {
+    const current = normalizeStudioSettings({
+      taskBoard: {
+        "ws://localhost:18789": {
+          cards: [
+            {
+              id: "task-1",
+              title: "Initial task",
+              description: "",
+              status: "todo",
+              source: "claw3d_manual",
+              sourceEventId: null,
+              assignedAgentId: null,
+              createdAt: "2026-03-29T10:00:00.000Z",
+              updatedAt: "2026-03-29T10:00:00.000Z",
+              playbookJobId: null,
+              runId: null,
+              channel: null,
+              externalThreadId: null,
+              lastActivityAt: null,
+              notes: [],
+              isArchived: false,
+              isInferred: false,
+            },
+          ],
+          selectedCardId: "task-1",
+        },
+      },
+    });
+
+    const merged = mergeStudioSettings(current, {
+      taskBoard: {
+        "ws://localhost:18789": {
+          cards: [
+            {
+              id: "task-2",
+              title: "Replacement task",
+              description: "",
+              status: "in_progress",
+              source: "claw3d_manual",
+              sourceEventId: null,
+              assignedAgentId: null,
+              createdAt: "2026-03-29T10:10:00.000Z",
+              updatedAt: "2026-03-29T10:10:00.000Z",
+              playbookJobId: null,
+              runId: null,
+              channel: null,
+              externalThreadId: null,
+              lastActivityAt: null,
+              notes: [],
+              isArchived: false,
+              isInferred: false,
+            },
+          ],
+          selectedCardId: "task-2",
+        },
+      },
+    });
+
+    expect(merged.taskBoard?.["ws://localhost:18789"]).toEqual(
+      expect.objectContaining({
+        selectedCardId: "task-2",
+        cards: [
+          expect.objectContaining({
+            id: "task-2",
+            title: "Replacement task",
+            status: "in_progress",
+          }),
+        ],
+      }),
+    );
+  });
 });