Suy biến mềm Arkon — giải thích
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.