Chuyển tới nội dung chính
Phiên bản: 1.0

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

  1. Tab Wiki trống trong khi bạn biết Department có trang.
  2. .board/wiki/INDEX.md chứa "No wiki pages available for this space".
  3. Activity của task có bản ghi system_warning.
  4. 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