cowork-local/agent/examples/bad_fix.md

Ví dụ KHÔNG ĐẠT — các kiểu "sửa" phải bị FAIL

⚠️ Kịch bản minh hoạ. Mỗi mục là một anti-pattern có thật hay gặp khi vá bug UI, được dựng lại trên cùng defect với good_fix.md (UI-20260907-03: đổi sang tiếng Nhật trước khi mở màn Monitoring thì nhãn vẫn tiếng Việt).

---

❌ 1. Tin thẳng chẩn đoán của người dùng

Người dùng: "chắc thiếu bản dịch" → agent đi thêm entry vào i18n/monitoring_overview.py.

Vì sao sai: bản dịch đã có đủ. Bug nằm ở vòng đời widget. Sau bản vá, key bị trùng, và người dùng vẫn thấy tiếng Việt.

Vi phạm: guardrail.md G1 (không tự bịa), Triage bước 2 (tách triệu chứng khỏi chẩn đoán).

Dấu hiệu nhận ra ngay: defect_record phần "Người dùng suy đoán" bị dùng làm phần "Nguyên nhân gốc".

---

❌ 2. Vá riêng một màn thay vì sửa chỗ chung

+    def showEvent(self, e):
+        self._retranslate()
+        super().showEvent(e)

(thêm vào ui/monitoring_tab.py)

Vì sao sai: Dashboard và Schedule cũng dựng lười, cũng hỏng y hệt. Bug sẽ được báo lại sau hai tuần với màn khác. Ngoài ra showEvent chạy mỗi lần hiện màn, không chỉ lần đầu — thêm một lần _retranslate() thừa cho mọi lần chuyển tab.

Vi phạm: Reviewer bước 2 — "sửa ở widget con thay vì chỗ phát sinh".

---

❌ 3. Hardcode màu để "cho nhanh"

-        self.badge.setObjectName("statusBadge")
+        self.badge.setStyleSheet("background: #1f6fb2; color: #ffffff;")

Vì sao sai: ba lỗi trong hai dòng — hex ngoài theme/; setStyleSheet cục bộ đè QSS ứng dụng; và màu này chỉ đúng ở theme dark, sang light là chữ trắng trên nền sáng.

Vi phạm: guardrail.md G4, theme_tokens.md §1, ui_review.md mục B.

Đúng ra phải làm: giữ objectName, style trong theme/qss.py, dùng accent_solid cho chữ trên nền đặc.

---

❌ 4. setFixedWidth để "cho khỏi tràn"

-        self.tab_label.setMinimumWidth(120)
+        self.tab_label.setFixedWidth(180)   # đủ cho tiếng Nhật

Vì sao sai: ghim một kích thước cho một ngôn ngữ ở một mức DPI. Tiếng Việt dài hơn sẽ tràn; ở scale 150% sẽ tràn; ở cửa sổ hẹp sẽ chiếm chỗ vô lý.

Vi phạm: P02, ui_review.md mục C.

---

❌ 5. QTimer.singleShot để "đợi cho nó xong"

+        QTimer.singleShot(200, self._retranslate)

Vì sao sai: race condition vẫn nguyên, chỉ khó tái hiện hơn — nên lần sau nó sẽ được báo là "thỉnh thoảng bị". Máy chậm hơn thì 200ms không đủ. Đây là làm cho bug khó sửa hơn.

Vi phạm: Reviewer bước 2 — che triệu chứng.

---

❌ 6. Test viết cho có

def test_monitoring_tab_builds(qtbot, ctx):
    tab = MonitoringTab(ctx)
    assert tab is not None

Vì sao sai: test này xanh cả trước lẫn sau bản vá. Nó không bắt được gì.

Cách reviewer phát hiện: revert code, giữ test, chạy lại — vẫn xanh → FAIL (Reviewer bước 4).

---

❌ 7. Ghi khống kết quả kiểm chứng

themes_verified: [dark, light]
languages_verified: [vi, ja, en]
visual_check: done

...trong khi môi trường không chạy được GUI.

Vì sao sai: đây là lỗi nặng nhất trong cả danh sách. Reviewer và Cowork Team ra quyết định dựa trên các trường này. Ghi khống làm hỏng toàn bộ giá trị của pipeline.

Vi phạm: guardrail.md G10, handoff_contract.md luật 6.

Đúng ra phải ghi:

themes_verified: []
visual_check: not-done   # môi trường CI headless, không dựng được cửa sổ thật

---

❌ 8. Tiện tay dọn dẹp

 12 files changed, 486 insertions(+), 391 deletions(-)

Trong đó: 4 dòng sửa bug, phần còn lại là đổi f-string, sắp lại import, đổi tên biến "cho dễ đọc".

Vì sao sai: reviewer không còn nhìn ra 4 dòng thật sự quan trọng. Nếu PR gây regression, không bisect được. Vi phạm "một PR một thay đổi logic".

Vi phạm: guardrail.md G8, definition-of-done.md.

---

❌ 9. Bỏ qua ràng buộc thiết kế có chủ ý

Người dùng: "menu bên trái tối quá, làm sáng lên bằng phần còn lại đi" → agent đổi token nền nav rail.

Vì sao sai: nav rail tối hơn vùng nội dung là silhouette VS Code có chủ ý, ghi rõ trong docstring theme/__init__.py. Đây là phản hồi thiết kế, không phải bug.

Đúng ra phải làm: next_agent: RETURN_TO_REPORTER, giải thích kèm dẫn chứng, và nếu thấy phản hồi có lý thì chuyển thành đề xuất thiết kế cho Cowork Team — họ sở hữu UI/UX (docs/governance/ownership.md).

---

❌ 10. Tự merge

Agent chạy git push rồi merge PR vì "gate đã xanh hết".

Vì sao sai: quyết định merge thuộc Cowork Team. Với thay đổi chạm permission/credential/ routing, CI xanh không đủ để merge (docs/governance/review-policy.md).

Vi phạm: guardrail.md G9.

---

❌ 11. Thay bằng API "an toàn hơn" mà không kiểm miền đầu vào

⚠️ Đây là ca CÓ THẬT, không phải giả định. Xảy ra ở SEC-20260907-01, ngày 2026-09-07, và lọt qua vòng review đầu tiên.

Bản vá đổi phép so mật khẩu sang phiên bản timing-safe:

-        if pw == self._sandbox_pw:
+        if secrets.compare_digest(pw, self._sandbox_pw):

Trông đúng. Timing-safe thật. Nhưng:

>>> secrets.compare_digest("mật khẩu", "mật khẩu")
TypeError: comparing strings with non-ASCII characters is not supported

Vì sao sai: compare_digest an toàn hơn == về timing, nhưng miền đầu vào hẹp hơn — chỉ nhận ASCII-str hoặc bytes. Cowork Local mặc định tiếng Việt và phục vụ khách Nhật. Người dùng gõ một chữ có dấu vào ô mật khẩu là exception thoát ra khỏi Qt slot.

Vì sao nó lọt review: mọi test đều dùng mật khẩu ASCII (K7MNP2QRSTVW). Test xanh hết. Chỉ khi reviewer tự đọc diff và nghi ngờ mới lộ ra — không checklist nào bắt được.

Đúng ra phải làm:

return secrets.compare_digest(entered.encode("utf-8"), stored.encode("utf-8"))

Bài học đã đưa vào thư viện: knowledge/secrets_and_config.md §9.3 và roles/6_regression_reviewer.md Bước 2.1 — bốn câu bắt buộc hỏi trước mọi lần thay một phép toán bằng "phiên bản chuẩn hơn".

---

❌ 12. Test rỗng ruột — xanh vì chẳng kiểm gì

Cũng từ SEC-20260907-01. Test quét toàn repo tìm credential hardcode:

_SCANNED_DIRS = ("ui", "presentation", "core")

def test_khong_con_fallback_credential_trong_ma_nguon():
    offenders = [...]
    assert not offenders

Ba lỗi trong một bài test:

1. Quét thiếu. Sai sót gốc của commit 3827552 là sửa config.py mà quên ui/ — lỗi đi xuyên thư mục. Vậy mà phép quét lại bỏ config.py, infrastructure/, application/.
2. Xanh khi quét rỗng. Đổi tên thư mục là duyệt được 0 file, offenders rỗng, test xanh mãi mãi. Cần lưới an toàn: assert seen > 200.
3. Regex quá rộng. Bản đầu bắt cả it.get("key", "?") của Jira — mã issue, không phải credential. False positive làm người ta bỏ qua test.

Kiểu thứ hai còn có biến thể nuốt side-effect:

monkeypatch.setattr(QMessageBox, "warning", lambda *a, **k: None)   # ❌ nuốt

Nuốt đi thì hai nhánh "chưa cấu hình mật khẩu" và "sai mật khẩu" gộp về một vẫn xanh. Phải ghi lại lời gọi rồi assert nội dung.

Bài học đã đưa vào thư viện: roles/6_regression_reviewer.md Bước 4.1.

---

Bảng tra nhanh cho Reviewer

Thấy cái này trong diff	Phản ứng
Hex màu ngoài theme/	FAIL
setStyleSheet cục bộ mới	FAIL
setFixedWidth / setFixedSize mới	FAIL trừ khi có lý do được nêu rõ
QTimer.singleShot để đợi	FAIL
try/except bao quanh chỗ crash	FAIL
Test xanh cả trước lẫn sau	FAIL
visual_check: done mà không có bằng chứng	FAIL
Diff > phạm vi plan	FAIL, tách PR
Sửa ở widget con thay vì chỗ chung	FAIL
compare_digest trên str không .encode()	FAIL — vỡ với mật khẩu có dấu
Thay bằng API "an toàn hơn" mà không kiểm miền đầu vào	FAIL cho tới khi trả lời 4 câu ở Bước 2.1
Test quét thư mục mà không có lưới assert seen > N	FAIL — xanh giả khi quét rỗng
Fixture nuốt side-effect thay vì ghi lại	FAIL — không phân biệt được hai nhánh
File .py mới chưa git add	Không phải lỗi bản vá — bảo tác giả stage lại