Workflow /update | PARA Workspace

Workflow /update cung cấp sự an toàn của AI agent-guided cho các hệ sinh thái PARA. Thay vì người dùng tự chạy ./para update và bối rối với các lỗi xung đột, trợ lý (Agent) sẽ trực tiếp kiểm tra tiền kỳ, chạy diễn tập Dry-run, và kích hoạt cả khả năng cứu hộ hệ thống (Error recovery).

Tổng Quan Về Lệnh

/update

Không cần tham số định danh — Trợ lý AI sẽ tự cập nhật thông số và trạng thái.

Luồng Cập Nhật (Update Flow)

Kiểm tra → Diễn tập → Xác nhận → Update Trực tiếp → Xác thực → In báo cáo

1. Pre-flight Checks (Kiểm định)

Agent phải làm 3 thao tác dò sau trước khi chạy:

Trạng thái	Làm gì?	Xử lý khi lõi mạng
Network	Gọi ra Github?	Đề xuất offline (`./para install`)
Git status	Có Dirty repo?	Hỏi Stash lại hay Skip bỏ qua rác
Version	Đã là mới nhất?	Hỏi tiếp tục cài đè lại không
Direction	Kernel > Repo VERSION?	Cảnh báo: workspace đi trước, gợi pull trước

2. Xem trước theo Dry-run

Chạy bằng lệnh ngầm ./para update --dry-run để bắt những điểm sẽ bị override (Thay phiên bản ghi đè, script migration,…). Yêu cầu người dùng xác nhận thao tác.

3. Live Update

Gọi thực thi ./para update. Nếu xuất hiện Error Crash, tiến hành chuẩn đoán tự động thay cho báo đỏ.

4. Error Recovery (Phân luồng Phục hồi rủi ro)

Xử lý nhanh chóng các rủi ro hệ điều hành theo logic:

Tên Lỗi	Nguyên nhân	Agent Phản Ứng
Mất Mạng	Rớt mạng liên kết	Đề cập làm offline sync
Git Xung Đột	Cây nhánh lỗi dòng chảy	Liệt kê cờ, gợi ý `--theirs`
Thiếu Quyền Hạn	Quên không chạy chmod `x`	Tự thay đổi lại Permissions
Kích Hoạt Rollback	Lỗi vỡ tệp CLI	Khuyên cài đè `--force`
Lỗi `semver_gte`	Library chưa được tải	Kiểm tra `cli/lib/validator.sh`, chạy install

Sau lần rà soát lỗi thử lại thứ nhất. Nều thất bại hoàn toàn, hủy chốt luồng và in thông báo Log.

5. Verify / Xác thực Hậu Cập Nhật

Lần vào hệ phân vùng file system để kiểm chứng:

Thuộc tính cấu hình kernel_version ở file .para-workspace.yml.
Ngày đồng bộ gần nhất qua file history history.log của .para/migrations/.
File audit gốc .para/audit.log.