Suy biến mềm Arkon
Trang này giải thích vì sao Board vẫn trả 200 OK khi Arkon vắng mặt thay vì báo 500, và cách phát hiện tính năng Wiki đang tắt lặng.
Khi Arkon vắng mặt, hệ thống chọn chạy tiếp không Wiki thay vì sập cả Board. Cái giá: tính năng Wiki tắt âm thầm — trang này dạy bạn phát hiện nó.
Vì sao không báo 500?
Mọi lời gọi sang Arkon đi qua lớp adapter (services/arkon/) và kiểm tra arkon_links trước:
Không throw → không 500 → Kanban, Planner (phần LLM), worktree, merge code chạy trơn tru.
Đúng khi Arkon bảo trì hoặc Space cố tình không nối Arkon — nhưng cũng che luôn lỗi cấu hình thật
(sai ARKON_API_URL, thiếu secret), nên UAT rất dễ sót.
Nói chính xác theo mã trạng thái: Arkon vắng mặt thì Board không 500 ở đâu cả — các route wiki trả 502 (upstream chết, đúng nghĩa mã đó), còn tạo task / chạy agent / mời thành viên vẫn 201. Toàn bộ 222 test e2e vẫn xanh khi tắt Arkon — đây là điều kiện cổng dừng, đã đo.
Retro sweep dedupe theo outcome — không spam
Nhịp quét lại retro (AGENTBOARD_AUTO_RETRO_SWEEP_MS) ghi lại đúng bản retro đã hỏng, và các nhịp
sau im lặng (dedupe theo outcome). Với Space chưa nối Arkon, 4 nhịp quét vẫn chỉ để lại đúng một
dòng activity — đây là lỗi đã xảy ra thật (4 dòng/2 phút) trước khi có dedupe.
4 dấu hiệu phát hiện
- Tab Wiki trống trong khi bạn biết Department có trang.
.board/wiki/INDEX.mdchứa "No wiki pages available for this space".- Activity của task có bản ghi
system_warning. - Log server có dòng
[preflight] ARKON_URL_*.
Kiểm tra nhanh từ server:
docker exec agentjira_server node -e "fetch('http://arkon_api:5055/health').then(r=>console.log(r.status)).catch(e=>console.log('DOWN',e.message))"
Xử lý và đọc thêm
- Checklist xử lý theo từng triệu chứng: Xử lý sự cố §4.
- Biến cấu hình liên quan: Biến môi trường.
- Chiều Wiki bơm vào task: Wiki hai chiều.
Đi tiếp: Xử lý sự cố · Wiki hai chiều · Biến môi trường