Files
claw3d/src/features/office/components/HQSidebar.tsx
T
Luke The Dev a997f13601 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

210 lines
7.4 KiB
TypeScript

"use client";
import type { ReactNode } from "react";
export type HQSidebarTab =
| "inbox"
| "history"
| "kanban"
| "playbooks"
| "analytics";
type HQSidebarProps = {
open: boolean;
activeTab: HQSidebarTab;
inboxCount: number;
onToggle: () => void;
onTabChange: (tab: HQSidebarTab) => void;
onOpenMarketplace: () => void;
onAddAgent?: () => void;
onOpenCompanyBuilder?: () => void;
inboxPanel: ReactNode;
historyPanel: ReactNode;
kanbanPanel: ReactNode;
playbooksPanel: ReactNode;
analyticsPanel: ReactNode;
};
const TAB_LABELS: Record<HQSidebarTab, string> = {
inbox: "Inbox",
history: "History",
kanban: "Kanban",
playbooks: "Playbooks",
analytics: "Analytics",
};
const PRIMARY_TABS: HQSidebarTab[] = ["inbox", "history", "kanban", "playbooks"];
export function HQSidebar({
open,
activeTab,
inboxCount,
onToggle,
onTabChange,
onOpenMarketplace,
onAddAgent,
onOpenCompanyBuilder,
inboxPanel,
historyPanel,
kanbanPanel,
playbooksPanel,
analyticsPanel,
}: HQSidebarProps) {
const analyticsOnly = activeTab === "analytics";
const railOnly = analyticsOnly;
const activePanel =
activeTab === "inbox"
? inboxPanel
: activeTab === "history"
? historyPanel
: activeTab === "kanban"
? kanbanPanel
: activeTab === "playbooks"
? playbooksPanel
: analyticsPanel;
const boardLikeWidth = activeTab === "kanban";
return (
<aside className="pointer-events-none fixed inset-y-0 right-0 z-20 flex justify-end">
<div className="pointer-events-auto mt-14 flex shrink-0 flex-col items-end gap-1.5">
<button
type="button"
onClick={onToggle}
className="rounded-l-md border border-r-0 border-cyan-500/30 bg-[#06090d]/90 px-1.5 py-2.5 font-mono text-[10px] font-semibold tracking-[0.2em] text-cyan-300 shadow-xl backdrop-blur transition-colors hover:border-cyan-400/50 hover:text-cyan-100"
aria-expanded={open}
aria-label={open ? "Collapse headquarters sidebar" : "Open headquarters sidebar"}
>
<span className="block leading-none [writing-mode:vertical-rl]">
{open ? "COLLAPSE HQ" : "OPEN HQ"}
</span>
</button>
<button
type="button"
onClick={() => {
onOpenMarketplace();
}}
className="rounded-l-md border border-r-0 border-fuchsia-500/25 bg-[#100611]/90 px-1.5 py-2.5 font-mono text-[10px] font-semibold tracking-[0.2em] text-fuchsia-300/80 shadow-xl backdrop-blur transition-colors hover:border-fuchsia-400/45 hover:text-fuchsia-100"
aria-label="Open marketplace"
>
<span className="block leading-none [writing-mode:vertical-rl]">
MARKETPLACE
</span>
</button>
<button
type="button"
onClick={() => {
onTabChange("analytics");
if (!open) {
onToggle();
}
}}
className={`rounded-l-md border border-r-0 px-1.5 py-2.5 font-mono text-[10px] font-semibold tracking-[0.2em] shadow-xl backdrop-blur transition-colors ${
analyticsOnly
? "border-amber-400/50 bg-[#1a1206]/95 text-amber-200"
: "border-amber-500/25 bg-[#120d06]/90 text-amber-300/80 hover:border-amber-400/45 hover:text-amber-100"
}`}
aria-pressed={analyticsOnly}
aria-label="Open analytics sidebar"
>
<span className="block leading-none [writing-mode:vertical-rl]">
ANALYTICS
</span>
</button>
</div>
{open ? (
<div
className={`pointer-events-auto flex h-full flex-col border-l border-cyan-500/20 bg-black/85 shadow-2xl backdrop-blur ${
boardLikeWidth ? "w-[min(94vw,1180px)]" : "w-56"
}`}
>
<div className="border-b border-cyan-500/15 px-4 py-3">
<div className="font-mono text-[10px] font-semibold tracking-[0.32em] text-cyan-300/80">
{analyticsOnly ? "ANALYTICS" : "HEADQUARTERS"}
</div>
<div className="mt-1 font-mono text-[11px] text-white/45">
{analyticsOnly
? "Cost, budgets, and performance intelligence."
: "Monitor outputs, runs, and schedules."}
</div>
{!railOnly && onAddAgent ? (
<button
type="button"
onClick={onAddAgent}
className="mt-3 rounded border border-cyan-500/20 bg-cyan-500/10 px-2 py-1 font-mono text-[10px] uppercase tracking-[0.16em] text-cyan-200 transition-colors hover:border-cyan-400/40 hover:text-cyan-100"
>
Add Agent
</button>
) : null}
{!railOnly && onOpenCompanyBuilder ? (
<button
type="button"
onClick={onOpenCompanyBuilder}
className="mt-2 rounded border border-emerald-500/20 bg-emerald-500/10 px-2 py-1 font-mono text-[10px] uppercase tracking-[0.16em] text-emerald-200 transition-colors hover:border-emerald-400/40 hover:text-emerald-100"
>
Build Company
</button>
) : null}
{railOnly ? (
<button
type="button"
onClick={() => onTabChange("inbox")}
className="mt-3 rounded border border-cyan-500/20 bg-cyan-500/10 px-2 py-1 font-mono text-[10px] uppercase tracking-[0.16em] text-cyan-200 transition-colors hover:border-cyan-400/40 hover:text-cyan-100"
>
Back To HQ
</button>
) : null}
</div>
{!railOnly ? (
<div
role="tablist"
aria-label="Headquarters panels"
className="grid grid-cols-4 border-b border-cyan-500/15"
>
{PRIMARY_TABS.map((tab) => {
const isActive = tab === activeTab;
const showBadge = tab === "inbox" && inboxCount > 0;
return (
<button
key={tab}
type="button"
role="tab"
aria-selected={isActive}
aria-controls={`hq-panel-${tab}`}
id={`hq-tab-${tab}`}
onClick={() => onTabChange(tab)}
className={`flex items-center justify-center gap-1 border-r border-cyan-500/10 px-2 py-2.5 font-mono text-[11px] uppercase tracking-[0.18em] transition-colors last:border-r-0 ${
isActive
? "bg-cyan-500/10 text-cyan-100"
: "text-white/45 hover:bg-white/5 hover:text-white/80"
}`}
>
<span>{TAB_LABELS[tab]}</span>
{showBadge ? (
<span className="rounded bg-cyan-500/15 px-1.5 py-0.5 text-[10px] text-cyan-300" aria-label={`${inboxCount} unread`}>
{inboxCount}
</span>
) : null}
</button>
);
})}
</div>
) : null}
<div
role="tabpanel"
id={`hq-panel-${activeTab}`}
aria-labelledby={`hq-tab-${activeTab}`}
className="min-h-0 flex-1 overflow-hidden"
>
{activePanel}
</div>
</div>
) : null}
</aside>
);
}