docs(agent-ui): legacy 상태값을 보정한다

validate-agent-ui 규칙이 요구하는 상태값 스키마에 맞춰 기존 code-first agent-ui 문서의 legacy 상태 표기를 정규화한다.
2026-06-25 10:54:05 +09:00 · 2026-06-25 10:54:05 +09:00 · bebd95f909
commit bebd95f909
parent 29a00f5634
23 changed files with 59 additions and 82 deletions
--- a/agent-ui/README.md
+++ b/agent-ui/README.md
@ -27,5 +27,4 @@ surface_type: ops-dev
 - visual wireframe은 visual source가 있을 때만 `frame/views/**`에 둔다.
 - `.excalidraw` 파일만으로 UI 기준을 확정하지 않는다.
 - `definition/archive/**`와 `archive/user-review/**`는 과거 기록이며 일반 작업에서 읽지 않는다.
- 구현 코드 근거가 있는 항목만 `implemented`로 표시한다.
-
+- 구현 코드 근거가 있는 항목만 `구현됨`으로 표시한다.
--- a/agent-ui/definition/components/agent-panel/index.md
+++ b/agent-ui/definition/components/agent-panel/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: agent-panel
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: packages/flutter/iop_console/lib/src/iop_agent_panel.dart
@ -21,7 +21,7 @@ source_evidence:

 Component ID: `agent-panel`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -68,4 +68,3 @@ IOP operation capability를 대화형 agent shell 안에 보여주고 operator i
 ## Decision History

 - 2026-06-25: `IopAgentPanel` 구현을 기준으로 component를 정의했다.
-
--- a/agent-ui/definition/components/command-action-bar/index.md
+++ b/agent-ui/definition/components/command-action-bar/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: command-action-bar
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/runtime_panel.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `command-action-bar`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -65,4 +65,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `RuntimePanel`의 operation command 버튼과 dialogs를 component로 정의했다.
-
--- a/agent-ui/definition/components/console-shell/index.md
+++ b/agent-ui/definition/components/console-shell/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: console-shell
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: packages/flutter/iop_console/lib/src/iop_console_shell.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `console-shell`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -67,4 +67,3 @@ IOP console view들을 좌측 rail navigation과 section content slot으로 묶
 ## Decision History

 - 2026-06-25: `IopConsoleShell` 구현을 기준으로 component를 정의했다.
-
--- a/agent-ui/definition/components/domain-agent-card/index.md
+++ b/agent-ui/definition/components/domain-agent-card/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: domain-agent-card
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/runtime_panel.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `domain-agent-card`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -66,4 +66,3 @@ Edge에 보고된 domain agent의 availability, lifecycle state, active command
 ## Decision History

 - 2026-06-25: `RuntimePanel`의 domain agent grid를 component로 정의했다.
-
--- a/agent-ui/definition/components/edge-detail-list/index.md
+++ b/agent-ui/definition/components/edge-detail-list/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: edge-detail-list
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/edges_panel.dart
@ -15,7 +15,7 @@ source_evidence:

 Component ID: `edge-detail-list`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -60,4 +60,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `EdgesPanel`의 선택 Edge 상세 영역을 component로 정의했다.
-
--- a/agent-ui/definition/components/edge-list/index.md
+++ b/agent-ui/definition/components/edge-list/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: edge-list
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/edges_panel.dart
@ -15,7 +15,7 @@ source_evidence:

 Component ID: `edge-list`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -61,4 +61,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `EdgesPanel`의 Edge 목록 영역을 component로 정의했다.
-
--- a/agent-ui/definition/components/edge-selector/index.md
+++ b/agent-ui/definition/components/edge-selector/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: edge-selector
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/nodes_panel.dart
@ -21,7 +21,7 @@ source_evidence:

 Component ID: `edge-selector`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -69,4 +69,3 @@ Edge-scoped view에서 대상 Edge를 선택하고 현재 view 데이터를 갱
 ## Decision History

 - 2026-06-25: 세 개 panel에 반복되는 Edge dropdown pattern을 component로 정의했다.
-
--- a/agent-ui/definition/components/endpoint-card/index.md
+++ b/agent-ui/definition/components/endpoint-card/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: endpoint-card
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: packages/flutter/iop_console/lib/src/iop_console_overview.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `endpoint-card`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -64,4 +64,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: overview endpoint card helper를 component로 정의했다.
-
--- a/agent-ui/definition/components/event-log-entry/index.md
+++ b/agent-ui/definition/components/event-log-entry/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: event-log-entry
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/execution_logs_panel.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `event-log-entry`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -68,4 +68,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `ExecutionLogsPanel`의 event entry pattern을 component로 정의했다.
-
--- a/agent-ui/definition/components/index.md
+++ b/agent-ui/definition/components/index.md
@ -22,23 +22,22 @@ components:

 | Component ID | Status | Evidence | Description |
 |--------------|--------|----------|-------------|
-| `console-shell` | implemented | `packages/flutter/iop_console/lib/src/iop_console_shell.dart` | 좌측 rail과 section slot을 제공하는 console shell이다. |
-| `status-badge` | implemented | `apps/client/lib/widgets/*.dart`, `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | connection, node, command, lifecycle 상태를 색상 badge/chip으로 표시한다. |
-| `endpoint-card` | implemented | `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | endpoint 또는 token reference 값을 label과 icon으로 표시한다. |
-| `edge-selector` | implemented | `apps/client/lib/widgets/nodes_panel.dart`, `apps/client/lib/widgets/runtime_panel.dart`, `apps/client/lib/widgets/execution_logs_panel.dart` | active/filter Edge dropdown과 refresh control이다. |
-| `edge-list` | implemented | `apps/client/lib/widgets/edges_panel.dart` | Edge 목록과 선택 상태를 표시한다. |
-| `edge-detail-list` | implemented | `apps/client/lib/widgets/edges_panel.dart` | 선택 Edge 상세 metadata와 capability chip을 표시한다. |
-| `node-card` | implemented | `apps/client/lib/widgets/nodes_panel.dart` | Node alias/id, connection state, config, adapter 상태를 표시한다. |
-| `provider-snapshot-card` | implemented | `apps/client/lib/widgets/nodes_panel.dart` | provider health, load, queue, served model, lifecycle capability를 표시한다. |
-| `command-action-bar` | implemented | `apps/client/lib/widgets/runtime_panel.dart` | health check, agent status, agent command action을 제공한다. |
-| `domain-agent-card` | implemented | `apps/client/lib/widgets/runtime_panel.dart` | domain agent lifecycle state와 summary를 grid card로 표시한다. |
-| `operation-history-list` | implemented | `apps/client/lib/widgets/runtime_panel.dart` | Edge operation execution history를 status와 함께 표시한다. |
-| `event-log-entry` | implemented | `apps/client/lib/widgets/execution_logs_panel.dart` | lifecycle event 항목을 severity icon/color와 함께 표시한다. |
-| `agent-panel` | implemented | `packages/flutter/iop_console/lib/src/iop_agent_panel.dart` | IOP capability intro message와 prompt를 포함한 agent shell이다. |
+| `console-shell` | 구현됨 | `packages/flutter/iop_console/lib/src/iop_console_shell.dart` | 좌측 rail과 section slot을 제공하는 console shell이다. |
+| `status-badge` | 구현됨 | `apps/client/lib/widgets/*.dart`, `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | connection, node, command, lifecycle 상태를 색상 badge/chip으로 표시한다. |
+| `endpoint-card` | 구현됨 | `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | endpoint 또는 token reference 값을 label과 icon으로 표시한다. |
+| `edge-selector` | 구현됨 | `apps/client/lib/widgets/nodes_panel.dart`, `apps/client/lib/widgets/runtime_panel.dart`, `apps/client/lib/widgets/execution_logs_panel.dart` | active/filter Edge dropdown과 refresh control이다. |
+| `edge-list` | 구현됨 | `apps/client/lib/widgets/edges_panel.dart` | Edge 목록과 선택 상태를 표시한다. |
+| `edge-detail-list` | 구현됨 | `apps/client/lib/widgets/edges_panel.dart` | 선택 Edge 상세 metadata와 capability chip을 표시한다. |
+| `node-card` | 구현됨 | `apps/client/lib/widgets/nodes_panel.dart` | Node alias/id, connection state, config, adapter 상태를 표시한다. |
+| `provider-snapshot-card` | 구현됨 | `apps/client/lib/widgets/nodes_panel.dart` | provider health, load, queue, served model, lifecycle capability를 표시한다. |
+| `command-action-bar` | 구현됨 | `apps/client/lib/widgets/runtime_panel.dart` | health check, agent status, agent command action을 제공한다. |
+| `domain-agent-card` | 구현됨 | `apps/client/lib/widgets/runtime_panel.dart` | domain agent lifecycle state와 summary를 grid card로 표시한다. |
+| `operation-history-list` | 구현됨 | `apps/client/lib/widgets/runtime_panel.dart` | Edge operation execution history를 status와 함께 표시한다. |
+| `event-log-entry` | 구현됨 | `apps/client/lib/widgets/execution_logs_panel.dart` | lifecycle event 항목을 severity icon/color와 함께 표시한다. |
+| `agent-panel` | 구현됨 | `packages/flutter/iop_console/lib/src/iop_agent_panel.dart` | IOP capability intro message와 prompt를 포함한 agent shell이다. |

 ## Rules

 - component 정의는 구현 API가 아니라 UI 사용 규칙을 다룬다.
 - view별 변형이 필요하면 `<component-id>/<variant>.md` 또는 하위 디렉터리를 사용한다.
 - 실제 구현체 이름과 다를 수 있지만, view 정의서에서 참조하는 component id는 이 목록에 있어야 한다.
-
--- a/agent-ui/definition/components/node-card/index.md
+++ b/agent-ui/definition/components/node-card/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: node-card
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/nodes_panel.dart
@ -18,7 +18,7 @@ source_evidence:

 Component ID: `node-card`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -68,4 +68,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `NodesPanel`의 Node card pattern을 component로 정의했다.
-
--- a/agent-ui/definition/components/operation-history-list/index.md
+++ b/agent-ui/definition/components/operation-history-list/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: operation-history-list
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/runtime_panel.dart
@ -15,7 +15,7 @@ source_evidence:

 Component ID: `operation-history-list`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -65,4 +65,3 @@ Edge command execution history를 scan 가능한 list로 보여준다.
 ## Decision History

 - 2026-06-25: `RuntimePanel`의 operations history 영역을 component로 정의했다.
-
--- a/agent-ui/definition/components/provider-snapshot-card/index.md
+++ b/agent-ui/definition/components/provider-snapshot-card/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: provider-snapshot-card
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: apps/client/lib/widgets/nodes_panel.dart
@ -15,7 +15,7 @@ source_evidence:

 Component ID: `provider-snapshot-card`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -64,4 +64,3 @@ Node에 연결된 provider runtime의 health와 capacity를 compact하게 보여
 ## Decision History

 - 2026-06-25: `NodesPanel`의 provider snapshot helper를 component로 정의했다.
-
--- a/agent-ui/definition/components/status-badge/index.md
+++ b/agent-ui/definition/components/status-badge/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: component
 component_id: status-badge
-status: implemented
+status: 구현됨
 source_evidence:
  - type: code
    path: packages/flutter/iop_console/lib/src/iop_console_overview.dart
@ -24,7 +24,7 @@ source_evidence:

 Component ID: `status-badge`

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -77,4 +77,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: 여러 panel 구현에서 반복되는 status chip 패턴을 component로 추출했다.
-
--- a/agent-ui/definition/index.md
+++ b/agent-ui/definition/index.md
@ -57,9 +57,8 @@ source_evidence:
 - frame-view가 있으면 view region id와 frame region id는 동일해야 한다.
 - view에서 참조한 component id는 `components/` 아래에 정의되어야 한다.
 - frame은 definition을 대체하지 않는다.
- `implemented`, `planned`, `assumed`, `unknown` 상태를 섞어 쓰지 않는다.
+- `구현됨`, `계획`, `가정`, `불명확` 상태를 섞어 쓰지 않는다.

 ## Decision History

 - 2026-06-25: 기존 Flutter client와 `iop_console` 구현을 근거로 code-first agent-ui scaffold를 생성했다.
-
--- a/agent-ui/definition/views/agent/index.md
+++ b/agent-ui/definition/views/agent/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: agent
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -29,7 +29,7 @@ View ID: `agent`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -88,4 +88,3 @@ IOP operation capability를 대화형 agent shell로 노출하는 surface다.
 ## Decision History

 - 2026-06-25: `IopAgentPanel` 구현을 기준으로 agent view를 정의했다.
-
--- a/agent-ui/definition/views/edges/index.md
+++ b/agent-ui/definition/views/edges/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: edges
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -31,7 +31,7 @@ View ID: `edges`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -95,4 +95,3 @@ Control Plane에 등록된 Edge fleet를 탐색하고, 선택 Edge의 연결 상
 ## Decision History

 - 2026-06-25: `EdgesPanel` 구현을 기준으로 edges view를 정의했다.
-
--- a/agent-ui/definition/views/execution-logs/index.md
+++ b/agent-ui/definition/views/execution-logs/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: execution-logs
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -30,7 +30,7 @@ View ID: `execution-logs`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -92,4 +92,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `ExecutionLogsPanel` 구현을 기준으로 execution-logs view를 정의했다.
-
--- a/agent-ui/definition/views/index.md
+++ b/agent-ui/definition/views/index.md
@ -15,12 +15,12 @@ views:

 | View ID | Status | Evidence | Description |
 |---------|--------|----------|-------------|
-| `overview` | implemented | `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | Control Plane endpoint, wire connection, auth reference, health summary를 보여준다. |
-| `edges` | implemented | `apps/client/lib/widgets/edges_panel.dart` | Control Plane에 등록된 Edge 목록과 선택 Edge 상세를 보여준다. |
-| `nodes` | implemented | `apps/client/lib/widgets/nodes_panel.dart` | 선택 Edge의 Node inventory, adapter config, provider catalog를 보여준다. |
-| `runtime` | implemented | `apps/client/lib/widgets/runtime_panel.dart` | Edge operation command, domain agent status, operation history를 다룬다. |
-| `execution-logs` | implemented | `apps/client/lib/widgets/execution_logs_panel.dart` | 선택 Edge의 lifecycle event와 execution log timeline을 보여준다. |
-| `agent` | implemented | `packages/flutter/iop_console/lib/src/iop_agent_panel.dart` | IOP operation capability를 담은 agent shell surface다. |
+| `overview` | 구현됨 | `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | Control Plane endpoint, wire connection, auth reference, health summary를 보여준다. |
+| `edges` | 구현됨 | `apps/client/lib/widgets/edges_panel.dart` | Control Plane에 등록된 Edge 목록과 선택 Edge 상세를 보여준다. |
+| `nodes` | 구현됨 | `apps/client/lib/widgets/nodes_panel.dart` | 선택 Edge의 Node inventory, adapter config, provider catalog를 보여준다. |
+| `runtime` | 구현됨 | `apps/client/lib/widgets/runtime_panel.dart` | Edge operation command, domain agent status, operation history를 다룬다. |
+| `execution-logs` | 구현됨 | `apps/client/lib/widgets/execution_logs_panel.dart` | 선택 Edge의 lifecycle event와 execution log timeline을 보여준다. |
+| `agent` | 구현됨 | `packages/flutter/iop_console/lib/src/iop_agent_panel.dart` | IOP operation capability를 담은 agent shell surface다. |

 ## Navigation

@ -45,4 +45,3 @@ views:
 ## Open Questions

 - 없음
-
--- a/agent-ui/definition/views/nodes/index.md
+++ b/agent-ui/definition/views/nodes/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: nodes
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -32,7 +32,7 @@ View ID: `nodes`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -97,4 +97,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `NodesPanel` 구현을 기준으로 nodes view를 정의했다.
-
--- a/agent-ui/definition/views/overview/index.md
+++ b/agent-ui/definition/views/overview/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: overview
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -32,7 +32,7 @@ View ID: `overview`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -96,4 +96,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `IopConsoleOverview` 구현을 기준으로 overview view를 정의했다.
-
--- a/agent-ui/definition/views/runtime/index.md
+++ b/agent-ui/definition/views/runtime/index.md
@ -1,7 +1,7 @@
 ---
 ui_doc_type: view
 view_id: runtime
-status: implemented
+status: 구현됨
 frame: null
 source_evidence:
  - type: code
@ -32,7 +32,7 @@ View ID: `runtime`
 Frame:
 - 없음

-Status: `implemented`
+Status: `구현됨`

 ## Source Evidence

@ -103,4 +103,3 @@ Status: `implemented`
 ## Decision History

 - 2026-06-25: `RuntimePanel` 구현을 기준으로 runtime view를 정의했다.
-