Skip to content

[codex] Board UX: priority sorting, epic cards, deferred filtering #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Helmi merged 4 commits into from
Mar 1, 2026
Merged

[codex] Board UX: priority sorting, epic cards, deferred filtering #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
eb62a13
feat(backend): priority-first sort and deferred filter for board view
Helmi Mar 1, 2026
b33898d
feat(ui): board UX overhaul — flat sort, epic badges, card redesign, …
Helmi Mar 1, 2026
b91667c
feat(ui): add task board button to session title bar (td-c6ca47)
Helmi Mar 1, 2026
1322d15
fix: address board ux rejection gaps
Helmi Mar 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions client/src/components/BoardUxRegression.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
import { readFileSync } from 'node:fs'
import { resolve } from 'node:path'
import { describe, expect, it } from 'vitest'

function readSource(path: string): string {
return readFileSync(resolve(process.cwd(), path), 'utf8')
}

describe('Board UX regression checks', () => {
it('keeps the task board button always visible in the session title bar', () => {
const source = readSource('client/src/components/TerminalSession.tsx')
expect(source).toContain('title="Task board"')
expect(source).not.toContain('{tdStatus?.projectState?.enabled && (')
})

it('uses plain "Show more" text for closed-column progressive reveal', () => {
const source = readSource('client/src/components/TaskBoard.tsx')
expect(source).toContain('Show more')
expect(source).not.toContain('Show {issues.length - visibleIssues.length} older')
})
})
182 changes: 101 additions & 81 deletions client/src/components/TaskBoard.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,10 @@ import {
PauseCircle,
AlertCircle,
Layers,
Tag,
FolderGit2,
ChevronDown,
ChevronRight,
RefreshCw,
XCircle,
ChevronRight,
} from 'lucide-react'

// Status column configuration
Expand All @@ -35,60 +33,58 @@ const STATUS_COLUMNS = [
{ key: 'closed', label: 'Closed', icon: CheckCircle2, color: 'text-green-500', bg: 'bg-green-500/10' },
]

const priorityColors: Record<string, string> = {
P0: 'border-l-red-500',
P1: 'border-l-orange-500',
P2: 'border-l-border',
P3: 'border-l-border/50',
}

type ViewMode = 'board' | 'list'

function normalizeBranchName(branch?: string): string {
if (!branch) return ''
return branch.replace(/^refs\/heads\//, '').trim()
}

function IssueCard({ issue, compact, indent, onSelect }: { issue: TdIssue; compact?: boolean; indent?: boolean; onSelect: (id: string) => void }) {
const labels = issue.labels ? issue.labels.split(',').filter(Boolean) : []
function priorityBadgeClass(priority: string): string {
if (priority === 'P0') return 'bg-red-500/15 text-red-400'
if (priority === 'P1') return 'bg-orange-500/15 text-orange-400'
if (priority === 'P2') return 'bg-muted text-muted-foreground'
return 'bg-muted/50 text-muted-foreground/50'
}

function IssueCard({ issue, compact, indent, onSelect, childCount }: { issue: TdIssue; compact?: boolean; indent?: boolean; onSelect: (id: string) => void; childCount?: number }) {
return (
<button
onClick={() => onSelect(issue.id)}
className={cn(
'w-full text-left rounded border border-border/50 bg-card p-2 transition-colors',
'hover:bg-accent/50 hover:border-border',
'border-l-2',
priorityColors[issue.priority] || 'border-l-border',
compact && 'p-1.5',
indent && 'ml-4',
)}
>
<div className="flex items-start gap-1.5">
<span className="text-[10px] font-mono text-muted-foreground shrink-0 mt-0.5">
{issue.id}
</span>
<div className="flex-1 min-w-0">
<p className={cn('text-xs leading-snug', compact ? 'line-clamp-1' : 'line-clamp-2')}>
{issue.title}
</p>
{!compact && labels.length > 0 && (
<div className="flex items-center gap-1 mt-1 flex-wrap">
{labels.slice(0, 3).map(label => (
<span
key={label}
className="inline-flex items-center gap-0.5 text-[9px] rounded-full px-1.5 py-0 bg-muted text-muted-foreground"
>
<Tag className="h-2 w-2" />
{label.trim()}
</span>
))}
</div>
)}
<div className="flex flex-col gap-1.5">
{/* Title — full width */}
<p className="text-xs leading-snug line-clamp-2">
{issue.title}
</p>
{/* Bottom row */}
<div className="flex items-center justify-between gap-1">
<div className="flex items-center gap-1">
{/* Priority badge */}
<span className={cn('text-[9px] font-medium px-1 py-0 rounded', priorityBadgeClass(issue.priority))}>
{issue.priority}
</span>
{/* Epic child count */}
{issue.type === 'epic' && (
<div className="flex items-center gap-0.5">
<Layers className="h-2.5 w-2.5 text-purple-400" />
{childCount != null && childCount > 0 && (
<span className="text-[9px] text-muted-foreground">{childCount}</span>
)}
</div>
)}
</div>
{/* Task ID */}
<span className="text-[9px] font-mono text-muted-foreground/60 shrink-0">
{issue.id}
</span>
</div>
{issue.type === 'epic' && (
<Layers className="h-3 w-3 text-purple-400 shrink-0" />
)}
</div>
</button>
)
Expand Down Expand Up @@ -126,70 +122,82 @@ function groupIssuesWithChildren(issues: TdIssue[]): Array<{ issue: TdIssue; chi
return result
}

function StatusColumn({ status, issues, onSelect }: {
function StatusColumn({ status, issues, onSelect, childCountByEpicId }: {
status: typeof STATUS_COLUMNS[0]
issues: TdIssue[]
onSelect: (id: string) => void
childCountByEpicId: Map<string, number>
}) {
const StatusIcon = status.icon
const grouped = useMemo(() => groupIssuesWithChildren(issues), [issues])
const [collapsedEpics, setCollapsedEpics] = useState<Set<string>>(new Set())

const toggleEpic = (epicId: string) => {
setCollapsedEpics(prev => {
const next = new Set(prev)
if (next.has(epicId)) next.delete(epicId)
else next.add(epicId)
return next
})
const [isCollapsed, setIsCollapsed] = useState(issues.length === 0)
const [showAllClosed, setShowAllClosed] = useState(false)

useEffect(() => {
if (issues.length === 0) setIsCollapsed(true)
}, [issues.length])

const threeDaysAgo = new Date(Date.now() - 3 * 86_400_000).toISOString()
Copy link

@gemini-code-assist gemini-code-assist bot Mar 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Using a magic number like 86_400_000 for milliseconds in a day makes the code less readable. It's better to either use the calculation directly or define a constant for it to improve clarity and maintainability.

Suggested change
const threeDaysAgo = new Date(Date.now() - 3 * 86_400_000).toISOString()
const threeDaysAgo = new Date(Date.now() - 3 * 24 * 60 * 60 * 1000).toISOString()

const visibleIssues = (status.key === 'closed' && !showAllClosed)
? issues.filter(i => (i.closed_at ?? '') >= threeDaysAgo)
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot Mar 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Compare closed timestamps as dates, not raw strings

The closed-column reveal logic is doing a lexical string comparison between closed_at and threeDaysAgo, but threeDaysAgo is ISO (...T...Z) while SQLite DATETIME values are typically space-separated (YYYY-MM-DD HH:MM:SS); this causes recent items on the cutoff date to be treated as older and hidden behind “Show more”. In practice, closed tasks within the last 3 days can disappear from the default view depending on timestamp format, so this should parse/normalize timestamps before comparing.

Useful? React with 👍 / 👎.

: issues

if (isCollapsed) {
return (
<div
className="flex flex-col items-center gap-2 py-2 px-1 rounded border border-border/30 bg-muted/10 cursor-pointer w-8 shrink-0"
onClick={() => setIsCollapsed(false)}
title={`${status.label} (${issues.length})`}
>
<StatusIcon className={cn('h-3 w-3', status.color)} />
<span
className="text-[9px] text-muted-foreground font-medium"
style={{ writingMode: 'vertical-rl', transform: 'rotate(180deg)' }}
>
{status.label}
</span>
<span className="text-[9px] text-muted-foreground/60">{issues.length}</span>
</div>
)
}

return (
<div className="flex flex-col min-w-[200px] max-w-[280px] flex-1">
<div className="flex flex-col flex-1">
<div className={cn('flex items-center gap-1.5 px-2 py-1.5 rounded-t', status.bg)}>
<StatusIcon className={cn('h-3 w-3', status.color)} />
<span className="text-xs font-medium">{status.label}</span>
<span className="text-[10px] text-muted-foreground ml-auto">{issues.length}</span>
<button
onClick={() => setIsCollapsed(true)}
className="ml-1 text-muted-foreground/40 hover:text-muted-foreground"
title="Collapse column"
>
<ChevronRight className="h-3 w-3" />
</button>
</div>
<ScrollArea className="flex-1 min-h-0">
<div className="space-y-1.5 p-1.5">
{issues.length === 0 ? (
{visibleIssues.length === 0 ? (
<p className="text-[10px] text-muted-foreground/50 text-center py-4">
No issues
</p>
) : (
grouped.map(({ issue, children }) => (
<div key={issue.id}>
{issue.type === 'epic' && children.length > 0 ? (
<div>
<button
onClick={() => toggleEpic(issue.id)}
className="flex items-center gap-1 w-full text-left mb-1"
>
{collapsedEpics.has(issue.id) ? (
<ChevronRight className="h-2.5 w-2.5 text-muted-foreground shrink-0" />
) : (
<ChevronDown className="h-2.5 w-2.5 text-muted-foreground shrink-0" />
)}
<Layers className="h-2.5 w-2.5 text-purple-400 shrink-0" />
<span className="text-[10px] font-medium text-muted-foreground truncate">
{issue.title}
</span>
<span className="text-[9px] text-muted-foreground/50 shrink-0">{children.length}</span>
</button>
<IssueCard issue={issue} onSelect={onSelect} />
{!collapsedEpics.has(issue.id) && children.map(child => (
<div key={child.id} className="mt-1.5">
<IssueCard issue={child} indent onSelect={onSelect} />
</div>
))}
</div>
) : (
<IssueCard issue={issue} onSelect={onSelect} />
)}
</div>
visibleIssues.map(issue => (
<IssueCard
key={issue.id}
issue={issue}
onSelect={onSelect}
childCount={issue.type === 'epic' ? childCountByEpicId.get(issue.id) : undefined}
/>
))
)}
{status.key === 'closed' && !showAllClosed && issues.length > visibleIssues.length && (
<button
onClick={() => setShowAllClosed(true)}
className="w-full text-[10px] text-muted-foreground/60 hover:text-muted-foreground py-1.5 text-center"
>
Show more
</button>
)}
</div>
</ScrollArea>
</div>
Expand All @@ -212,6 +220,16 @@ export function TaskBoard() {
const [searchQuery, setSearchQuery] = useState('')
const [selectedIssueId, setSelectedIssueId] = useState<string | null>(null)

const childCountByEpicId = useMemo(() => {
const counts = new Map<string, number>()
tdIssues.forEach(issue => {
if (issue.parent_id && issue.status !== 'closed') {
counts.set(issue.parent_id, (counts.get(issue.parent_id) ?? 0) + 1)
}
})
return counts
}, [tdIssues])

const projectWorktrees = useMemo(() => {
if (!currentProject) return []
const projectName = currentProject.path.split('/').pop() || ''
Expand Down Expand Up @@ -374,6 +392,7 @@ export function TaskBoard() {
status={status}
issues={(filteredBoard[status.key] || []).filter(i => !i.deleted_at)}
onSelect={setSelectedIssueId}
childCountByEpicId={childCountByEpicId}
/>
))}
</div>
Expand All @@ -393,6 +412,7 @@ export function TaskBoard() {
issue={issue}
compact
onSelect={setSelectedIssueId}
childCount={issue.type === 'epic' ? childCountByEpicId.get(issue.id) : undefined}
/>
{children.map(child => (
<div key={child.id} className="mt-1">
Expand Down
13 changes: 13 additions & 0 deletions client/src/components/TerminalSession.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ import {
ArrowDown,
Pencil,
RotateCcw,
LayoutGrid,
} from 'lucide-react';
import {cn} from '@/lib/utils';
import type {Session} from '@/lib/types';
Expand Down Expand Up @@ -130,6 +131,7 @@ export const TerminalSession = memo(function TerminalSession({
selectedSessions,
worktrees,
agents,
openTaskBoard,
} = useAppStore();
const isMobile = useIsMobile();
const hasMultipleSessions = selectedSessions.length > 1;
Expand Down Expand Up @@ -730,6 +732,17 @@ export const TerminalSession = memo(function TerminalSession({
</div>

<div className="flex items-center gap-0.5">
{/* Task board button */}
<Button
variant="ghost"
size="icon"
className="h-5 w-5 text-muted-foreground hover:text-foreground"
onClick={openTaskBoard}
title="Task board"
>
<LayoutGrid className="h-3 w-3" />
</Button>

{/* Info button */}
<Button
variant="ghost"
Expand Down
Loading