ak5 1.0.0__tar.gz

ak5-1.0.0/.gitignore

@@ -0,0 +1,64 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# Database
+*.db
+*.db-wal
+*.db-shm
+*.sqlite
+*.sqlite3
+
+# Node / Frontend
+node_modules/
+.next/
+out/
+build/
+dist/
+.npm
+*.tsbuildinfo
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS / IDE
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Session
+.ak5_session.json
+
+# Local agent / scratch
+.libragent/
+tmp/

ak5-1.0.0/Dockerfile

@@ -0,0 +1,14 @@
+FROM python:3.13-slim
+
+WORKDIR /app
+
+RUN pip install uv
+
+COPY pyproject.toml README.md ./
+COPY backend ./backend
+
+RUN uv pip install --system -e backend
+
+EXPOSE 8000
+
+CMD ["uvicorn", "ak5.main:app", "--host", "0.0.0.0", "--port", "8000"]

ak5-1.0.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.5
+Name: ak5
+Version: 1.0.0
+Summary: AK5: Agent-Orchestrated Kanban System Gateway, MCP Server & CLI
+Author: AK5 Team
+License: MIT
+Keywords: ai-agents,fastapi,kanban,mcp,multi-agent,orchestration
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic-settings>=2.4.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: pyjwt>=2.9.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: sqlalchemy>=2.0.30
+Requires-Dist: sse-starlette>=2.1.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Description-Content-Type: text/markdown
+
+# AK5 (Agent K5) — Agent-Orchestrated Kanban System
+
+AK5는 인간 사용자(PM, 개발자)와 자율 AI 에이전트(LLM Agents)가 단일 칸반(K5) 인터페이스 위에서 실시간으로 협업하고 작업을 위임(Delegation) 및 추적하는 **Agent-Orchestrated Kanban 시스템**입니다.
+
+---
+
+## 1. 주요 특징
+
+* **Actor 추상화 일원화 (Unified Actor Model):** 인간과 AI 에이전트를 동일한 `Actor` 인터페이스로 취급 (`user_pm`, `agent_image_worker` 등).
+* **역량 기반 발견 및 위임 (Capability-driven Discovery & Delegation):** 에이전트 역량 태그(`image-resize`, `code-review`, `security` 등) 및 자연어 검색 기반으로 작업 위임.
+* **듀얼 프로토콜 (REST + SSE + MCP):**
+  * **Web UI (Next.js 15):** 드래그 앤 드롭(`@dnd-kit`), SSE 실시간 보드 자동 동기화, 계층형 서브태스크 진행률 바 및 아코디언 토글, 에이전트 활동 펄스(Activity Glow).
+  * **AI Agents (MCP):** Model Context Protocol 표준 툴셋(`ak5_list_available_agents`, `ak5_delegate_subtask`, `ak5_get_ticket_context`, `ak5_update_ticket_status`, `ak5_report_block`).
+  * **CLI (`ak5`):** 터미널 환경에서 액터 로그인, 에이전트 검색, 서브태스크 위임, 실시간 터미널 칸반 뷰(`ak5 board --watch`), 협업 시뮬레이션 데모(`ak5 demo`).
+* **동시성 및 순서 정렬 보장:** Lexorank 알고리즘(Base36)을 통한 충돌 없는 임의 순서 삽입, SQLite WAL 모드 + Busy Timeout 설정.
+
+---
+
+## 2. 프로젝트 디렉토리 레이아웃
+
+```
+ak5/
+├── backend/                     # FastAPI + MCP Server
+│   ├── src/ak5/
+│   │   ├── main.py              # FastAPI 진입점 & Lifespan & MCP 마운트
+│   │   ├── config.py            # Pydantic Settings
+│   │   ├── database.py          # SQLite WAL 비동기 세션
+│   │   ├── models/              # SQLAlchemy 2.0 모델 (Actor, Board, Column, Ticket, Audit)
+│   │   ├── schemas/             # Pydantic v2 DTO 스키마
+│   │   ├── services/            # Lexorank, Discovery, EventBus (SSE)
+│   │   ├── routers/             # REST API (auth, actors, boards, tickets, events)
+│   │   └── mcp/                 # MCP Server (MCPServer, tools, client)
+│   └── tests/                   # Pytest 종합 단위/통합 테스트 (19개)
+│
+├── frontend/                    # Next.js 15 Web UI (React 18, Tailwind, @dnd-kit)
+│   ├── src/
+│   │   ├── app/                 # App Router (layout.tsx, page.tsx, globals.css)
+│   │   ├── components/
+│   │   │   ├── board/           # KanbanBoard, KanbanColumn, TicketCard
+│   │   │   └── actor/           # ActorBadge
+│   │   └── lib/                 # SSE 구독 및 API 클라이언트
+│   └── package.json
+│
+├── cli/                         # ak5 터미널 도구
+│   └── src/ak5_cli/
+│       ├── main.py              # Click CLI 엔트리포인트
+│       ├── config.py            # 세션 및 API URL 관리
+│       └── commands/            # login, agents, delegate, board, demo
+│
+├── docker-compose.yml           # 컨테이너 오케스트레이션
+└── pyproject.toml               # uv 기반 워크스페이스 설정
+```
+
+---
+
+## 3. 실행 방법
+
+### 3.1 사전 요구사항
+* Python 3.11+
+* [uv](https://github.com/astral-sh/uv)
+* Node.js 18+ 및 npm
+
+### 3.2 백엔드 (FastAPI & MCP Gateway) 실행
+```bash
+# 가상환경 생성 및 의존성 설치
+uv sync
+uv pip install -e backend -e cli
+
+# 백엔드 서버 기동 (기본 포트 8000)
+uv run uvicorn ak5.main:app --host 127.0.0.1 --port 8000 --reload
+```
+* **Swagger API 문서:** `http://127.0.0.1:8000/docs`
+* **MCP SSE 엔드포인트:** `http://127.0.0.1:8000/mcp/sse`
+
+### 3.3 프론트엔드 (Next.js 15 Web Dashboard) 실행
+```bash
+cd frontend
+npm install
+npm run dev
+```
+* **웹 대시보드:** `http://localhost:3000`
+
+### 3.4 CLI (`ak5`) 도구 사용법
+```bash
+# 1. 액터 등록 및 로그인
+uv run ak5 login --id "agent_code_reviewer" --role "Senior Reviewer" --caps "python,rust,security"
+
+# 2. 역량 기반 에이전트 검색
+uv run ak5 agents --cap "image-resize"
+
+# 3. 작업 위임 실행
+uv run ak5 delegate TK-001 \
+    --to agent_image_worker \
+    --title "WebP 썸네일 변환기 구현" \
+    --desc "150x150 WebP 포맷 변환 함수 작성"
+
+# 4. 실시간 터미널 칸반 뷰
+uv run ak5 board --watch
+
+# 5. 자율 멀티 에이전트 협업 데모 시뮬레이션 실행
+uv run ak5 demo
+```
+
+---
+
+## 4. MCP (Model Context Protocol) 툴셋
+
+외부 에이전트(Claude Desktop, Cursor, LibrAgent 등)에서 다음 5가지 표준 툴을 호출하여 AK5 칸반을 직접 조작할 수 있습니다:
+
+1. `ak5_list_available_agents(capability, search_query)`: 가용 에이전트 역량 검색
+2. `ak5_delegate_subtask(parent_ticket_id, target_agent_id, title, description, priority)`: 하위 티켓 발급 및 에이전트 위임
+3. `ak5_get_ticket_context(ticket_id)`: 티켓 세부사항, 서브태스크 진척도, 최근 코멘트, 실행 맥락 조회
+4. `ak5_update_ticket_status(ticket_id, column_name, status_note, execution_context)`: 티켓 상태 전이 및 산출물 기록
+5. `ak5_report_block(ticket_id, blocking_reason, required_actor_id)`: 티켓 블록 처리 및 PM/담당자 멘션
+
+---
+
+## 5. 테스트 검증
+
+```bash
+# 백엔드 및 CLI 전체 단위/통합 테스트 실행
+uv run pytest backend/tests
+```
+19개의 모든 테스트 케이스(Lexorank 보간/리밸런싱, Actor 식별 및 검색, 티켓 수명주기, 계층형 서브태스크 위임, SSE 이벤트 버스, MCP 툴셋, CLI 명령어)가 통과합니다.
+
+---
+
+## 6. 사용방법 매뉴얼 & Agent Skill 안내
+
+* **상세 사용자 및 운영 매뉴얼:** [MANUAL.md](../MANUAL.md) (또는 [docs/MANUAL.md](../docs/MANUAL.md))
+* **에이전트 하네스용 Skill 정의:** [skills/ak5/SKILL.md](../skills/ak5/SKILL.md)
+  * Antigravity, Claude, Cursor 등의 자율 에이전트 하네스에서 `ak5` CLI 및 MCP 툴을 직접 호출하여 자율 분업을 수행할 수 있도록 절차와 러너 스크립트([harness_setup.sh](../skills/ak5/scripts/harness_setup.sh))가 포함되어 있습니다.
+

ak5-1.0.0/README.md

@@ -0,0 +1,133 @@
+# AK5 (Agent K5) — Agent-Orchestrated Kanban System
+
+AK5는 인간 사용자(PM, 개발자)와 자율 AI 에이전트(LLM Agents)가 단일 칸반(K5) 인터페이스 위에서 실시간으로 협업하고 작업을 위임(Delegation) 및 추적하는 **Agent-Orchestrated Kanban 시스템**입니다.
+
+---
+
+## 1. 주요 특징
+
+* **Actor 추상화 일원화 (Unified Actor Model):** 인간과 AI 에이전트를 동일한 `Actor` 인터페이스로 취급 (`user_pm`, `agent_image_worker` 등).
+* **역량 기반 발견 및 위임 (Capability-driven Discovery & Delegation):** 에이전트 역량 태그(`image-resize`, `code-review`, `security` 등) 및 자연어 검색 기반으로 작업 위임.
+* **듀얼 프로토콜 (REST + SSE + MCP):**
+  * **Web UI (Next.js 15):** 드래그 앤 드롭(`@dnd-kit`), SSE 실시간 보드 자동 동기화, 계층형 서브태스크 진행률 바 및 아코디언 토글, 에이전트 활동 펄스(Activity Glow).
+  * **AI Agents (MCP):** Model Context Protocol 표준 툴셋(`ak5_list_available_agents`, `ak5_delegate_subtask`, `ak5_get_ticket_context`, `ak5_update_ticket_status`, `ak5_report_block`).
+  * **CLI (`ak5`):** 터미널 환경에서 액터 로그인, 에이전트 검색, 서브태스크 위임, 실시간 터미널 칸반 뷰(`ak5 board --watch`), 협업 시뮬레이션 데모(`ak5 demo`).
+* **동시성 및 순서 정렬 보장:** Lexorank 알고리즘(Base36)을 통한 충돌 없는 임의 순서 삽입, SQLite WAL 모드 + Busy Timeout 설정.
+
+---
+
+## 2. 프로젝트 디렉토리 레이아웃
+
+```
+ak5/
+├── backend/                     # FastAPI + MCP Server
+│   ├── src/ak5/
+│   │   ├── main.py              # FastAPI 진입점 & Lifespan & MCP 마운트
+│   │   ├── config.py            # Pydantic Settings
+│   │   ├── database.py          # SQLite WAL 비동기 세션
+│   │   ├── models/              # SQLAlchemy 2.0 모델 (Actor, Board, Column, Ticket, Audit)
+│   │   ├── schemas/             # Pydantic v2 DTO 스키마
+│   │   ├── services/            # Lexorank, Discovery, EventBus (SSE)
+│   │   ├── routers/             # REST API (auth, actors, boards, tickets, events)
+│   │   └── mcp/                 # MCP Server (MCPServer, tools, client)
+│   └── tests/                   # Pytest 종합 단위/통합 테스트 (19개)
+│
+├── frontend/                    # Next.js 15 Web UI (React 18, Tailwind, @dnd-kit)
+│   ├── src/
+│   │   ├── app/                 # App Router (layout.tsx, page.tsx, globals.css)
+│   │   ├── components/
+│   │   │   ├── board/           # KanbanBoard, KanbanColumn, TicketCard
+│   │   │   └── actor/           # ActorBadge
+│   │   └── lib/                 # SSE 구독 및 API 클라이언트
+│   └── package.json
+│
+├── cli/                         # ak5 터미널 도구
+│   └── src/ak5_cli/
+│       ├── main.py              # Click CLI 엔트리포인트
+│       ├── config.py            # 세션 및 API URL 관리
+│       └── commands/            # login, agents, delegate, board, demo
+│
+├── docker-compose.yml           # 컨테이너 오케스트레이션
+└── pyproject.toml               # uv 기반 워크스페이스 설정
+```
+
+---
+
+## 3. 실행 방법
+
+### 3.1 사전 요구사항
+* Python 3.11+
+* [uv](https://github.com/astral-sh/uv)
+* Node.js 18+ 및 npm
+
+### 3.2 백엔드 (FastAPI & MCP Gateway) 실행
+```bash
+# 가상환경 생성 및 의존성 설치
+uv sync
+uv pip install -e backend -e cli
+
+# 백엔드 서버 기동 (기본 포트 8000)
+uv run uvicorn ak5.main:app --host 127.0.0.1 --port 8000 --reload
+```
+* **Swagger API 문서:** `http://127.0.0.1:8000/docs`
+* **MCP SSE 엔드포인트:** `http://127.0.0.1:8000/mcp/sse`
+
+### 3.3 프론트엔드 (Next.js 15 Web Dashboard) 실행
+```bash
+cd frontend
+npm install
+npm run dev
+```
+* **웹 대시보드:** `http://localhost:3000`
+
+### 3.4 CLI (`ak5`) 도구 사용법
+```bash
+# 1. 액터 등록 및 로그인
+uv run ak5 login --id "agent_code_reviewer" --role "Senior Reviewer" --caps "python,rust,security"
+
+# 2. 역량 기반 에이전트 검색
+uv run ak5 agents --cap "image-resize"
+
+# 3. 작업 위임 실행
+uv run ak5 delegate TK-001 \
+    --to agent_image_worker \
+    --title "WebP 썸네일 변환기 구현" \
+    --desc "150x150 WebP 포맷 변환 함수 작성"
+
+# 4. 실시간 터미널 칸반 뷰
+uv run ak5 board --watch
+
+# 5. 자율 멀티 에이전트 협업 데모 시뮬레이션 실행
+uv run ak5 demo
+```
+
+---
+
+## 4. MCP (Model Context Protocol) 툴셋
+
+외부 에이전트(Claude Desktop, Cursor, LibrAgent 등)에서 다음 5가지 표준 툴을 호출하여 AK5 칸반을 직접 조작할 수 있습니다:
+
+1. `ak5_list_available_agents(capability, search_query)`: 가용 에이전트 역량 검색
+2. `ak5_delegate_subtask(parent_ticket_id, target_agent_id, title, description, priority)`: 하위 티켓 발급 및 에이전트 위임
+3. `ak5_get_ticket_context(ticket_id)`: 티켓 세부사항, 서브태스크 진척도, 최근 코멘트, 실행 맥락 조회
+4. `ak5_update_ticket_status(ticket_id, column_name, status_note, execution_context)`: 티켓 상태 전이 및 산출물 기록
+5. `ak5_report_block(ticket_id, blocking_reason, required_actor_id)`: 티켓 블록 처리 및 PM/담당자 멘션
+
+---
+
+## 5. 테스트 검증
+
+```bash
+# 백엔드 및 CLI 전체 단위/통합 테스트 실행
+uv run pytest backend/tests
+```
+19개의 모든 테스트 케이스(Lexorank 보간/리밸런싱, Actor 식별 및 검색, 티켓 수명주기, 계층형 서브태스크 위임, SSE 이벤트 버스, MCP 툴셋, CLI 명령어)가 통과합니다.
+
+---
+
+## 6. 사용방법 매뉴얼 & Agent Skill 안내
+
+* **상세 사용자 및 운영 매뉴얼:** [MANUAL.md](../MANUAL.md) (또는 [docs/MANUAL.md](../docs/MANUAL.md))
+* **에이전트 하네스용 Skill 정의:** [skills/ak5/SKILL.md](../skills/ak5/SKILL.md)
+  * Antigravity, Claude, Cursor 등의 자율 에이전트 하네스에서 `ak5` CLI 및 MCP 툴을 직접 호출하여 자율 분업을 수행할 수 있도록 절차와 러너 스크립트([harness_setup.sh](../skills/ak5/scripts/harness_setup.sh))가 포함되어 있습니다.
+

ak5-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "ak5"
+version = "1.0.0"
+description = "AK5: Agent-Orchestrated Kanban System Gateway, MCP Server & CLI"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "AK5 Team" }
+]
+keywords = ["kanban", "ai-agents", "mcp", "orchestration", "multi-agent", "fastapi"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.30.0",
+    "sqlalchemy>=2.0.30",
+    "aiosqlite>=0.20.0",
+    "pydantic>=2.8.0",
+    "pydantic-settings>=2.4.0",
+    "pyjwt>=2.9.0",
+    "httpx>=0.27.0",
+    "sse-starlette>=2.1.0",
+    "mcp>=1.0.0",
+    "click>=8.1.0",
+    "rich>=13.7.0",
+]
+
+[project.scripts]
+ak5 = "ak5.cli.main:cli"
+ak5-mcp = "ak5.mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ak5"]

ak5-1.0.0/src/ak5/__init__.py

@@ -0,0 +1,3 @@
+"""AK5 (Agent K5) - Agent-Orchestrated Kanban System."""
+
+__version__ = "1.0.0"

ak5-1.0.0/src/ak5/cli/__init__.py

@@ -0,0 +1,3 @@
+"""AK5 CLI - Terminal tool for Agent-Orchestrated Kanban."""
+
+__version__ = "0.1.0"

ak5-1.0.0/src/ak5/cli/commands/agents.py

@@ -0,0 +1,55 @@
+import click
+import httpx
+from ak5.cli.config import get_api_url
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+@click.command("agents")
+@click.option("--cap", default=None, help="Filter by capability tag (e.g. 'image-resize')")
+@click.option("--status", default=None, help="Filter by status ('idle', 'busy', 'offline')")
+@click.option("--query", default=None, help="Semantic search query")
+def agents_command(cap: str | None, status: str | None, query: str | None) -> None:
+    """Discover agents matching capability tags or search queries."""
+    api_url = get_api_url()
+    params = {}
+    if cap:
+        params["capability"] = cap
+    if status:
+        params["status"] = status
+    if query:
+        params["query"] = query
+
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            resp = client.get(f"{api_url}/actors/discovery", params=params)
+            resp.raise_for_status()
+            agents = resp.json()
+
+        if not agents:
+            console.print("[yellow]No matching agents found.[/yellow]")
+            return
+
+        table = Table(title="Available Autonomous AI Agents", show_lines=True)
+        table.add_column("Agent ID", style="cyan", no_wrap=True)
+        table.add_column("Role", style="magenta")
+        table.add_column("Status", style="green")
+        table.add_column("Capabilities", style="yellow")
+
+        for a in agents:
+            caps_str = ", ".join(a.get("capabilities", []))
+            status_color = "green" if a["status"] == "idle" else ("yellow" if a["status"] == "busy" else "red")
+            table.add_row(
+                f"@{a['actor_id']}",
+                a["role"],
+                f"[{status_color}]{a['status']}[/{status_color}]",
+                caps_str,
+            )
+
+        console.print(table)
+    except httpx.ConnectError:
+        console.print(f"[bold red]✗ Failed to connect to AK5 Gateway at {api_url}[/bold red]")
+    except Exception as e:
+        console.print(f"[bold red]✗ Error querying agents:[/bold red] {e}")

ak5-1.0.0/src/ak5/cli/commands/board.py

@@ -0,0 +1,122 @@
+import asyncio
+
+import click
+import httpx
+from ak5.cli.config import get_api_url
+from rich.console import Console
+from rich.live import Live
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+console = Console()
+
+
+def render_board_view(board_data: dict) -> Table:
+    """Render 4-column Kanban board as a Rich Table."""
+    main_table = Table(
+        title=f"📋 Kanban Board: {board_data['name']} ({board_data['board_id']})",
+        show_header=True,
+        header_style="bold cyan",
+        expand=True,
+    )
+
+    stage_colors = {
+        "open": "blue",
+        "in_progress": "yellow",
+        "review": "magenta",
+        "done": "green",
+    }
+
+    # Add column headers
+    for col in board_data.get("columns", []):
+        color = stage_colors.get(col.get("stage"), "white")
+        count = len(col.get("tickets", []))
+        wip_info = f" [WIP: {count}/{col['wip_limit']}]" if col.get("wip_limit", 0) > 0 else f" ({count})"
+        main_table.add_column(f"[{color}]{col['name']}{wip_info}[/{color}]")
+
+    # Find maximum number of rows among columns
+    max_tickets = max(len(col.get("tickets", [])) for col in board_data.get("columns", [])) if board_data.get("columns") else 0
+
+    if max_tickets == 0:
+        empty_row = [Panel("[dim](Empty)[/dim]", expand=True) for _ in board_data.get("columns", [])]
+        main_table.add_row(*empty_row)
+        return main_table
+
+    for row_idx in range(max_tickets):
+        row_cells = []
+        for col in board_data.get("columns", []):
+            tickets = col.get("tickets", [])
+            if row_idx < len(tickets):
+                t = tickets[row_idx]
+                p_color = "red" if t["priority"] in ("urgent", "high") else ("yellow" if t["priority"] == "medium" else "dim")
+                status_badge = f"[{p_color}][{t['priority'].upper()}][/{p_color}]"
+
+                assignee = f"@{t['assigned_to']}" if t.get("assigned_to") else "[dim]Unassigned[/dim]"
+
+                subtask_badge = ""
+                if t.get("subtask_count", 0) > 0:
+                    subtask_badge = f"\n[bold cyan]Subtasks: {t['subtask_done_count']}/{t['subtask_count']} Done[/bold cyan]"
+
+                content = (
+                    f"[bold white]{t['title']}[/bold white]\n"
+                    f"{status_badge} [dim]{t['ticket_id']}[/dim] | {assignee}"
+                    f"{subtask_badge}"
+                )
+
+                border_color = "yellow" if col.get("stage") == "in_progress" else "white"
+                row_cells.append(Panel(content, border_style=border_color, expand=True))
+            else:
+                row_cells.append(Text(""))
+        main_table.add_row(*row_cells)
+
+    return main_table
+
+
+def fetch_board(api_url: str, board_id: str) -> dict:
+    with httpx.Client(timeout=10.0) as client:
+        resp = client.get(f"{api_url}/boards/{board_id}")
+        resp.raise_for_status()
+        return resp.json()
+
+
+async def watch_board_live(api_url: str, board_id: str) -> None:
+    """Stream SSE events and re-render board on changes."""
+    console.print(f"[bold cyan]Connecting to real-time event stream for board '{board_id}'...[/bold cyan]")
+    board_data = fetch_board(api_url, board_id)
+
+    with Live(render_board_view(board_data), console=console, refresh_per_second=4) as live:
+        async with (
+            httpx.AsyncClient(timeout=None) as client,
+            client.stream("GET", f"{api_url}/events/stream") as stream,
+        ):
+            async for line in stream.aiter_lines():
+                if line.startswith("event:"):
+                    event_type = line.split(":", 1)[1].strip()
+                    if event_type in ("TICKET_CREATED", "TICKET_MOVED", "TICKET_DELEGATED", "TICKET_UPDATED", "COMMENT_ADDED"):
+                        # Refresh board
+                        try:
+                            board_data = fetch_board(api_url, board_id)
+                            live.update(render_board_view(board_data))
+                        except (httpx.HTTPError, OSError):
+                            pass
+
+
+@click.command("board")
+@click.option("--board-id", default="proj-core-engine", help="Target Board ID")
+@click.option("--watch", is_flag=True, help="Watch board with live real-time SSE updates")
+def board_command(board_id: str, watch: bool) -> None:
+    """View Kanban board in terminal."""
+    api_url = get_api_url()
+    try:
+        if watch:
+            asyncio.run(watch_board_live(api_url, board_id))
+        else:
+            board_data = fetch_board(api_url, board_id)
+            console.print(render_board_view(board_data))
+    except httpx.ConnectError:
+        console.print(f"[bold red]✗ Failed to connect to AK5 Gateway at {api_url}[/bold red]")
+    except httpx.HTTPStatusError as e:
+        console.print(f"[bold red]✗ Board query failed ({e.response.status_code}):[/bold red] {e.response.text}")
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Watch stopped.[/yellow]")

ak5-1.0.0/src/ak5/cli/commands/delegate.py

@@ -0,0 +1,66 @@
+import click
+import httpx
+from ak5.cli.config import get_api_url, get_token
+from rich.console import Console
+
+console = Console()
+
+
+@click.command("delegate")
+@click.argument("ticket_id")
+@click.option("--to", "target_actor_id", required=True, help="Target Agent ID to delegate task to")
+@click.option("--title", required=True, help="Subtask title")
+@click.option("--desc", "description", default="", help="Subtask detailed description")
+@click.option("--priority", type=click.Choice(["low", "medium", "high", "urgent"]), default="medium")
+def delegate_command(
+    ticket_id: str,
+    target_actor_id: str,
+    title: str,
+    description: str,
+    priority: str,
+) -> None:
+    """Delegate a subtask to an agent under an existing parent ticket."""
+    api_url = get_api_url()
+    token = get_token()
+
+    headers = {}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    else:
+        # Auto-login as orchestrator if not logged in
+        with httpx.Client(timeout=5.0) as client:
+            resp = client.post(
+                f"{api_url}/auth/identify",
+                json={"actor_id": "cli_user", "actor_type": "human", "name": "CLI User", "role": "PM"},
+            )
+            if resp.is_success:
+                headers["Authorization"] = f"Bearer {resp.json()['access_token']}"
+
+    payload = {
+        "target_actor_id": target_actor_id,
+        "subtask_title": title,
+        "subtask_description": description,
+        "priority": priority,
+        "labels": ["delegated", "cli"],
+    }
+
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            resp = client.post(
+                f"{api_url}/tickets/{ticket_id}/delegate",
+                json=payload,
+                headers=headers,
+            )
+            resp.raise_for_status()
+            subtask = resp.json()
+
+        console.print(
+            f"[bold green]✓[/bold green] Subtask [cyan]{subtask['ticket_id']}[/cyan] created and assigned to "
+            f"[magenta]@{target_actor_id}[/magenta] (Parent: [yellow]{ticket_id}[/yellow])"
+        )
+    except httpx.ConnectError:
+        console.print(f"[bold red]✗ Failed to connect to AK5 Gateway at {api_url}[/bold red]")
+    except httpx.HTTPStatusError as e:
+        console.print(f"[bold red]✗ Delegation failed ({e.response.status_code}):[/bold red] {e.response.text}")
+    except Exception as e:
+        console.print(f"[bold red]✗ Error:[/bold red] {e}")