kanban-dashboard

Kanban Dashboard Skill

Kanban Dashboard — Flask Server (Primary)

Flask server가 kanban board를 렌더링. SSE 실시간 업데이트 + 드래그드롭 + 모바일 대응.

URL: http://macmini:8765/kanban

레이아웃

• 보드 탭: All / default / content / integrations — 탭 클릭으로 보드 필터
• 컬럼: To Do | Ready | In Progress | Blocked | Completed — 상태별 한 줄
• 카드 표시 (3줄):
  • Title: 제목 (60자 truncation, hover 시 전체 표시)
  • Summary: body에서 ## Topic 첫 문단 추출한 1줄 요약 (.card-summary, 2줄 clamp)
  • Meta row 1: Priority badge + Category badge (컬러 + 이모지: draft-trend=📈#5bc0eb, draft-conversation=💬#aa66ff, draft-seo=🔍#00c853 등) + Board + Worker + Created + Assignee
  • Meta row 3 (if draft path exists): Draft file link (📄, 보라색 obsidian://open 링크) — _extract_draft_path()로 body ## Draft 파일 위치 파싱, _obsidian_url()로 URL 변환
• 카드 상세 모달: 카드 클릭 시 모달 오픈. 5개 탭:
  • Description (기본): task body (내용/설명) 표시 + 📄 Open in Obsidian 버튼 (body에 ## Draft 파일 위치 경로가 있으면 렌더링) + ✏️ Edit 버튼
  • Events: 생성, 완료, 블록, 클레임 등 이벤트 히스토리
  • Result: task result 필드 (작업 결과물)
  • Info: 모든 메타 필드 (trigger_source, tenant, claim_lock, worker_pid, heartbeat 등)
  • Escape 키 또는 overlay 클릭으로 닫기
  • 데이터 출처: GET /kanban/api/task/<id>
• Body 에디터: Description 탭에서 Edit 버튼 → title input + body textarea + Save/Cancel 버튼으로 전환. 저장 시 POST /kanban/api/edit 호출. 저장 후 SSE 브로드캐스트로 보드 새로고침.
• 실시간: SSE 스트림 연결 → 카드 액션 시 즉시 화면 반영 (초록 점으로 연결 상태 표시)
• 드래그드롭: 카드를 다른 컬럼으로 드래그하면 상태 자동 변경
• 모바일: 터치 스크롤, 작은 화면에서 컬럼 너비 축소

LaunchAgent (Self-Healing, Auto-Restart)

~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.kanban-dashboard.plist

• KeepAlive: SuccessfulExit=false → 프로세스 죽으면 자동 재시작
• MacMini 재부팅해도 자동 실행
• 로그: ~/.{{AGENT_NAME_LOWER}}/P6-prefrontal/logs/kanban-server.log

관리 명령

# 상태 확인
launchctl list | grep kanban

# 수동 시작/정지
launchctl start ai.{{AGENT_NAME_LOWER}}.kanban-dashboard
launchctl stop ai.{{AGENT_NAME_LOWER}}.kanban-dashboard

# 로그 확인
tail -f ~/.{{AGENT_NAME_LOWER}}/P6-prefrontal/logs/kanban-server.log