[WIP] feat: Tmux team visualization

[quangdang46]

Gap #28 — Medium

Tmux-based visualization for multi-agent team orchestration.

Source: oh-my-openagent

What's needed:

• Dedicated tmux panes per team member
• File-based mailbox for inter-agent communication (inbox/poll/send/ack)
• Task board with dependency tracking (pending/claimed/in_progress/completed)
• Rebalancing and stale session sweeping
• Runtime bounds: max 8 members, max 4 parallel

Reference: oh-my-openagent src/features/team-mode/

[quangdang46]

🎯 Master Plan: Tmux Team Visualization (Gap #28)

Sau khi research đầy đủ 9 reference repos (oh-my-openagent, opencode, claude-code, codex, codebuff, pi_agent_rust, oh-my-pi, oh-my-claudecode, oh-my-codex) và phân tích toàn bộ jcode infra hiện tại, đây là master plan.

Thiết kế tổng thể

Primary source: oh-my-openagent team-mode — implementation hoàn chỉnh bằng TypeScript gồm tmux layout, file-based mailbox, task board, lifecycle management, stale sweeping.

Kiến trúc: Port toàn bộ logic sang Rust, integrate vào jcode's existing SwarmState/SwarmMember/SwarmRuntime infrastructure.

7 Modules Rust mới

Module	crate	Chức năng	Reference TS
team_spec.rs	jcode-swarm-core	TeamSpec, Message, Task, RuntimeState types	types.ts (271 lines)
team_runtime.rs	jcode-swarm-core	Lifecycle: create/delete/shutdown/status	team-runtime/create.ts (284 lines)
team_layout.rs	jcode-swarm-core	Tmux pane create/rebalance/stale sweep	team-layout-tmux/layout.ts (236 lines)
team_mailbox.rs	jcode-swarm-core	File-based send/inbox/poll/ack/reservation	team-mailbox/*.ts (488 lines total)
team_tasklist.rs	jcode-swarm-core	Task CRUD with deps, high-watermark IDs	team-tasklist/*.ts (300 lines total)
team_state.rs	jcode-swarm-core	Atomic file locks, path resolution	team-state-store/locks.ts + paths.ts
team_eligibility.rs	jcode-swarm-core	Agent type registry (allowed/rejected)	types.ts AGENT_ELIGIBILITY_REGISTRY

TUI Widget mới

team_widget.rs trong jcode-tui — hiển thị member roster với status icons, task list với dependency graph, message counts. Wire vào WidgetKind::TeamView với priority 7 (dynamic bump).

Upgraded Tools (jcode-app-core)

• TeamCreateTool — lifecycle creation (upgraded from current basic CRUD)
• TeamDeleteTool — full cleanup (upgraded)
• TeamStatusTool — runtime state query
• TeamSendMessageTool — file-based messaging
• TeamTaskCreateTool / TeamTaskClaimTool / TeamTaskListTool
• TeamShutdownTool

Phát triển theo 5 phases

1. Foundation (team_spec, team_state) — types + file I/O
2. Tools + Lifecycle (team_runtime, upgraded tools)
3. Tmux Layout (team_layout)
4. Mailbox + Task Board (team_mailbox, team_tasklist)
5. TUI Widget (team_widget)

Tổng estimated: ~7-12 days.

Bounds (ported từ oh-my-openagent)

• Max 8 members, 4 parallel
• Max 10K messages, 120min wall clock, 500 turns/member
• Message body max 32KB
• Atomic file locks with stale PID detection

Full Plan

Chi tiết implementation plan tại: .claude/skills/feature-planning/plans/issue-390-tmux-team-viz.md