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.
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.