cowork-local/docs/architecture/co4e-refactor-run-report-chat-view.md

# Báo cáo refactor — Chat view / Composer (widget cuối) — làn N3 Co4E Studio

- **Ngày:** 2026-08-25
- **Người:** Lâm (hiephv3@fpt.com)
- **Nhánh:** `gamma/refactor`
- **Phạm vi:** trích xuất `_ChatInput`, `_skill_names`, `_agent_names`, `_directive_token`
  và phần dựng UI của `ChatPanel` (từ `_build_chat` cũ) trong `ui/co4e_tab.py` sang
  `presentation/co4e/co4e_chat_view.py`.

---

## 1. Số test thay đổi thế nào so với baseline

Lệnh đo (chạy lại đúng lệnh baseline ngay trước khi viết báo cáo này):

```
.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors
```

Kết quả vừa đo:

```
347 passed, 1 skipped in 8.10s
```

So với baseline được giao (Phase 0): `346 passed, 0 failed, 0 collection_errors, 1 skipped`.

| | Trước (Phase 0) | Sau (vừa đo lại) |
|---|---|---|
| passed | 346 | 347 |
| failed | 0 | 0 |
| collection_errors | 0 | 0 |
| skipped | 1 (giữ nguyên, lý do đã biết — thứ tự import `CONFIG_DIR` giữa các file test, không liên quan chat view) | 1 (cùng lý do) |

**+1 passed** đúng bằng đúng 1 test mới `tests/characterization/test_co4e_chat_view.py`
được thêm trong đợt này. Không có test fail mới, không có collection error mới →
**không hồi quy**.

- Lỗi MỐC CŨ có từ trước (nợ của làn khác): **không có** — 0 collection error, 0 failed
  ở cả trước và sau.
- Flaky đã biết (`tests/test_atomic_json.py::test_ghi_de_nhieu_lan_van_dung`,
  `PermissionError [WinError 5]` khi Windows giữ khoá file tạm): **không xuất hiện**
  trong lần đo cuối cùng này (347 passed, 0 failed). Trong lượt soát trước đó nó có
  xuất hiện đúng 1 lần trên 2 lần chạy (`1 failed, 346 passed, 1 skipped`), rồi lần
  chạy kế tiếp lại xanh (`347 passed, 1 skipped`) — đúng đặc điểm flaky đã biết, không
  quy cho đợt trích xuất này.

## 2. File đã tạo, file đã sửa

Theo `git status --porcelain` (đối chiếu với whitelist được cấp cho lượt chat-view):

**Tạo mới (thuộc lượt này):**
- `presentation/co4e/co4e_chat_view.py` — file production mới (258 dòng, ≤ 400 dòng,
  chỉ import PySide6.QtCore/QtWidgets, không đụng domain/application).
- `tests/characterization/test_co4e_chat_view.py` — test đặc trưng hoá hành vi cũ.
- `docs/architecture/co4e-split-map-chat-view.md`
- `docs/architecture/co4e-split-map-chat-view.json`
- `docs/architecture/co4e-refactor-run-report-chat-view.md` — chính file báo cáo này
  (trước lượt này file chưa tồn tại — đây là khoảng thiếu mà bước soát đã ghi nhận,
  nay bù lại).

**Sửa (thuộc lượt này):**
- `ui/co4e_tab.py` — dây lại để dùng `ChatPanel`/`_ChatInput` từ module mới thay vì
  định nghĩa tại chỗ.

**Các mục khác trong `git status` (canvas widget, node property, run control, agent
panel, run manager, v.v.) không thuộc lượt chat-view** — đó là dấu vết của các làn/
phiên khác đang chạy song song trên cùng thư mục làm việc (repo này có nhiều phiên
Claude chạy đồng thời). Không đụng, không sửa trong lượt này.

## 3. Cổng chặn (Phase 5)

**Kết quả: ĐỎ** (`"clean": false`).

Tuy nhiên toàn bộ vi phạm liệt kê **không thuộc phần lượt chat-view đã viết ra** — kiểm
tra riêng 5 đường dẫn thuộc whitelist của lượt này
(`presentation/co4e/co4e_chat_view.py`, `tests/characterization/test_co4e_chat_view.py`,
`docs/architecture/co4e-split-map-chat-view.md`, `.json`, `ui/co4e_tab.py`): **không có
đường dẫn nào trong 5 file này xuất hiện trong danh sách `violations`.**

Danh sách vi phạm thật (đỏ) đến từ file của các làn khác đang tồn tại chung trong working
tree (không do lượt chat-view tạo ra):

- `FORBIDDEN` (khớp `forbidden_paths` của N1): `presentation/co4e/canvas_interaction_mixin.py`,
  `canvas_items.py`, `co4e_canvas_widget.py`, `co4e_run_control_widget.py`,
  `node_property_actions_mixin.py`, `node_property_panel.py`, `step_config_section.py`,
  `ui/co4e_canvas.py`, `ui/co4e_config_panel.py`, cùng các `docs/architecture/co4e-split-map*.md/json`
  và `co4e-refactor-run-report*.md` khác của N1.
- `OUTSIDE_WHITELIST` (file mới không khớp `allowed_write_globs` của *lượt này*):
  `application/workflows/co4e_workflow_service.py`, `domain/workflows/run_record.py`,
  `presentation/co4e/agent_list_panel.py`, `canvas_geometry.py`,
  `presentation/co4e/co4e_tab.py` (khác `ui/co4e_tab.py` được phép), `skills_list_panel.py`,
  và các test/fakes tương ứng (`test_co4e_agent_panel.py`, `test_co4e_canvas_geometry.py`,
  `test_co4e_canvas_widget.py`, `test_co4e_run_manager_behavior.py`, `test_co4e_runs_page.py`,
  `test_co4e_skills_panel.py`, `test_node_property_panel.py`, `fake_co4e_workflow_service.py`,
  `test_build_co4e_tab.py`, `test_co4e_workflow_service.py`).

Kết luận: cổng chặn báo đỏ ở mức **toàn working tree**, không phải đỏ do lượt
chat-view — vì cổng chặn quét nguyên `git status` chung, còn nhiều làn/phiên khác đang
ghi đè cùng thư mục. Phần việc riêng của lượt chat-view (5 đường dẫn whitelist) **sạch**.

## 4. Bước soát output — 2 lượt

Không có phát hiện ở mức **CHAN** (chặn) trong bất kỳ lượt soát nào — cả hai lượt đều
có `verdict: "DAT"` (đạt).

**Lượt 1 — soát `tests/characterization/test_co4e_chat_view.py`:** verdict **DAT**.
Một phát hiện mức `SUA`:
- Dòng 193: `assert ci._popup.width() == max(280, ci.width())` — assertion rỗng nghĩa
  cho riêng claim "280" vì `ci.width()` mặc định (chưa show/setFixedWidth) là 640 trong
  môi trường test, luôn thắng trong `max()` bất kể 280 đổi thành gì < 640. Xác nhận bằng
  mutation thật (280→300 trong `ui/co4e_tab.py`): test vẫn xanh (`1 passed in 2.01s`).
  23 case còn lại trong file đều bắt được mutation tương ứng (11/12 hành vi bị làm hỏng
  → test đỏ đúng như kỳ vọng).

**Lượt 2 — soát `presentation/co4e/co4e_chat_view.py`:** verdict **DAT**. Hai phát hiện
mức `SUA`, một mức `GHI_NHAN`:
- `SUA`: `docs/architecture/co4e-refactor-run-report-chat-view.md` (đúng file này) chưa
  tồn tại tại thời điểm soát — thiếu deliverable bắt buộc của quy trình. **Đã bù lại
  bằng chính báo cáo này.**
- `SUA`: docstring module (dòng 6-7, 15-18) trích sai số dòng gốc trong `ui/co4e_tab.py`
  (lệch 3-35 dòng, ví dụ `_build_chat` ghi "1030-1093" nhưng thật là "1065-1128" theo
  `git show HEAD`). Không ảnh hưởng hành vi — thân hàm đã được đối chiếu bằng
  `ast.get_source_segment` + `difflib` và **IDENTICAL** 100% với bản gốc. Đây là lỗi
  trích dẫn tài liệu, chưa sửa trong lượt viết báo cáo này (ngoài phạm vi được giao cho
  lượt này — chỉ viết báo cáo, không sửa code sản xuất).
- `GHI_NHAN`: hai file `docs/architecture/co4e-refactor-run-report-node-property.md` và
  `co4e-refactor-run-report-run-control.md` (thuộc `forbidden_paths` của lượt chat-view)
  có thay đổi/tồn tại — nhưng nội dung xác nhận thuộc lane khác (node-property, run-control),
  không phải do lượt chat-view đụng vào. Không quy lỗi cho lượt này.

Ngoài ra, bước soát đã tự chạy lại bộ test 2 lần độc lập để loại trừ flaky trước khi kết
luận: lần 1 gặp `1 failed` (đúng flaky `test_atomic_json` đã biết), lần 2 `347 passed,
1 skipped, 0 failed` — nhất quán với con số ở mục 1.

## 5. Việc để lại cho lần chạy sau / cần báo người khác

**Để lại cho lần sau (trong phạm vi lượt chat-view, chưa làm ở lượt viết báo cáo này):**
- Sửa docstring module trong `presentation/co4e/co4e_chat_view.py` (dòng 6-7, 15-18) để
  khớp đúng số dòng thật trong `ui/co4e_tab.py` (HEAD): `_skill_names` 60-64,
  `_agent_names` 67-70, `_directive_token` 121-133, `_ChatInput` 136-225, `_build_chat`
  1065-1128 — hiện ghi sai (63-73, 124-228, 1030-1093).
- Làm chặt lại assertion popup-width-floor tại `tests/characterization/test_co4e_chat_view.py:193`
  (claim "280" hiện không được khoá thật vì `ci.width()` mặc định 640 luôn thắng trong
  `max()`) — cần set `ci` về chiều rộng nhỏ hơn 280 trước khi assert, hoặc mock riêng, để
  test thực sự khoá hằng số 280.
- `ui/co4e_tab.py` vẫn còn nhiều phần khác chưa tách (không thuộc phạm vi widget
  chat/composer) — các widget khác đã có báo cáo riêng của N1
  (`canvas-widget`, `node-property`, `run-control`).

**Cần báo người khác trong team:** không có phát hiện mới nào ngoài phạm vi làn này cần
escalate ở lượt này. Ghi nhận (không phải lỗi mới, chỉ là quan sát): repo đang có nhiều
phiên Claude/nhiều làn chạy song song trên cùng một working tree, khiến cổng chặn của
lượt chat-view báo đỏ ở mức toàn cục do file của các làn khác — điều này không phải do
lượt chat-view gây ra và không cần hành động thêm từ N3, nhưng đội điều phối nên biết để
không hiểu nhầm là lượt này làm vỡ ranh giới của N1.