toki/iop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
iop/agent-ui/definition/views/execution-logs/index.md
toki bebd95f909 docs(agent-ui): legacy 상태값을 보정한다 
validate-agent-ui 규칙이 요구하는 상태값 스키마에 맞춰 기존 code-first agent-ui 문서의 legacy 상태 표기를 정규화한다.
2026-06-25 10:54:05 +09:00

3.1 KiB
Raw Permalink Blame History

ui_doc_type view_id status frame source_evidence regions
view execution-logs 구현됨 null
type path notes
code apps/client/lib/widgets/execution_logs_panel.dart ExecutionLogsPanel renders edge filter, refresh action, and lifecycle event list.
type path notes
code apps/client/lib/client_home_page.dart ClientHomePage injects ExecutionLogsPanel into the shell executionLogs section.
type path notes
docs README.md Edge aggregates execution history and lifecycle events for operational visibility.
type path notes
user null Initial scaffold requested by user.
execution-logs.header
execution-logs.edge-selector
execution-logs.event-list
execution-logs.event-entry

Execution Logs

View ID: execution-logs

Frame:

  • 없음

Status: 구현됨

Source Evidence

Type Path Notes
code apps/client/lib/widgets/execution_logs_panel.dart ExecutionLogsPanel이 Edge filter, loading/error/empty state, event list를 렌더링한다.
code apps/client/lib/client_home_page.dart shell execution logs section에 ExecutionLogsPanel을 주입한다.
docs README.md Edge는 execution history aggregation과 event aggregation을 담당한다.
user 없음 초기 agent-ui 생성을 요청했다.

Purpose

선택 Edge의 lifecycle event와 execution log timeline을 시간순으로 확인한다.

Primary Users

  • IOP operator
  • lifecycle event를 추적하는 engineer

Primary Tasks

  • Edge별 event filtering
  • event type, reason, node/source, timestamp 확인
  • event list refresh

Information Priority

  1. event type과 severity color
  2. event reason
  3. node/source와 timestamp

Regions

Region ID Purpose Component Priority Notes
execution-logs.header title, filter Edge selector, refresh 표시 edge-selector high Lifecycle Events & Logs heading을 포함한다.
execution-logs.edge-selector event filter Edge 선택 edge-selector high 선택 Edge의 events를 대상으로 한다.
execution-logs.event-list event timeline 목록 표시 event-log-entry high ListView로 event entry를 반복한다.
execution-logs.event-entry 단일 event의 type, reason, source 표시 event-log-entry high severity별 color/icon 기준을 사용한다.

Actions

Action ID Trigger Result Guard
execution-logs.select-edge Filter Edge dropdown change 선택 Edge events로 전환한다. Edge 목록이 있어야 한다.
execution-logs.refresh Refresh icon button 선택 Edge events를 다시 fetch한다. 선택 Edge가 있어야 한다.

States

  • loading: event fetch 중 spinner를 표시한다.
  • empty: event가 없으면 No Events Captured 메시지를 표시한다.
  • error: event fetch 실패 메시지를 표시한다.
  • permission-denied: 현재 구현 근거 없음

Open Questions

  • 없음

Decision History

  • 2026-06-25: ExecutionLogsPanel 구현을 기준으로 execution-logs view를 정의했다.