Lệnh CLI / zenify docs sync

zenify docs sync

Đồng bộ knowledge store với remote qua git và dựng lại view docs/ trong workspace.

Cú pháp

zenify docs sync [flags]

Khi nào dùng

Hook SessionStart và Stop gọi lệnh này thay bạn. Chạy tay khi bạn vừa tắt hook, hoặc muốn đẩy spec mới lên ngay.

Kết quả

Lệnh kiểm tra trạng thái store trước: sạch thì không chạm mạng. Có thay đổi thì commit, pull --rebase, rồi push. Gặp conflict lệnh hủy rebase và giữ commit cục bộ để lượt sau thử lại. Mọi lỗi mạng đều fail-open: lệnh in cảnh báo và thoát bình thường. Khi một bước git hỏng, cảnh báo in kèm nguyên văn lỗi của git, ví dụ commit error: exit status 128: Author identity unknown .... Sau đó lệnh dựng lại các symlink trong docs/ của workspace trỏ vào store.

Cờ

Cờ	Ý nghĩa
--dir	Đường dẫn store, khi không dùng ~/.zenify/knowledge.
--workspace	Thư mục workspace để dựng view docs/.

Ví dụ

zenify docs sync

Lưu ý

Máy chưa set user.email thì mọi commit vào store đều hỏng và store ngừng sync. zenify doctor báo mục git-identity khi thiếu. Không chạy git tay trong store. Xem Knowledge store và Gate fail-open.

Lệnh liên quan

• zenify docs: Nhóm lệnh cho docs layer: đồng bộ knowledge store và sinh trang tham chiếu.