ak orchestrate resume

Reconnect tới một run orchestrate có sẵn sau khi client hay coordinator crash, verify digest graph và reclassify job orphan mà không bao giờ relaunch process tree thứ hai.

Dùng ak orchestrate resume để reconnect tới một run có sẵn sau khi terminal này, shell của nó, hay process coordinating của nó bị interrupt trong khi run đang in flight. Resume không bao giờ relaunch job hay tạo process tree thứ hai; một worker live hoặc xác nhận nó vẫn đang giám sát run đã ghi, hoặc lệnh fallback về reclassification read-only của persisted state.

Resume là cách reconnect an toàn sau khi client hay coordinator crash. Khi chính worker crash giữa chừng, job đã adopt sẽ được để lại là orphaned để một con người (hoặc lệnh start mới) xử lý — resume không bao giờ âm thầm tiếp tục process tree không được giám sát.

Cách dùng

ak orchestrate resume <run-id> <job-graph.json>

Cung cấp đúng hai argument theo vị trí — run ID do ak orchestrate start in, và cùng file job graph đã dùng lúc dispatch. Digest của graph được so với digest gắn với run đã persist; mismatch bị từ chối với mã thoát 1.

Cờ của lệnh

Các cờ dùng chung (--json, --no-interactive, --quiet, --verbose, --yes) được mô tả trong quy ước CLI. --json trả về envelope kết quả một object.

Ngữ nghĩa reconnect

Trường hợp	Kết quả
Worker live, đã verify, tới được	Resume xác nhận digest graph vẫn khớp và báo state hiện tại. Không đụng vào process nào.
Chính worker đã crash	Reclassification read-only persisted record so với identity probe mới. Job có worker gốc chết giữa chừng được đánh dấu `orphaned`.
Digest graph không khớp record persisted	Từ chối với mã thoát `1`. Sửa file graph hoặc `start` một run mới.
Run ID không tìm thấy	Từ chối với mã thoát `1`.

Resume không bao giờ chạy lại công việc, không bao giờ redispatch process tree thứ hai, và không bao giờ adopt orphan vào supervisor mới mà không có bước con người rõ ràng.

Tác động filesystem

Read-only đối với worker live.
Persist một reclassification job orphan hay unknown khi chính worker đã crash.

File launch graph phải chính xác là file đã dùng ở start. So digest là byte-stable so với launch-graph.json đã persist, không phải diff ngữ nghĩa lỏng.

Đầu ra dành cho người dùng và JSON

--json trả về:

{
  "action": "resume",
  "run_id": "<opaque>",
  "worker_state": "live | crashed | unreachable",
  "graph_digest_matches": true,
  "jobs": [
    { "id": "<job-id>", "state": "running | completed | orphaned | ..." }
  ]
}

Kết quả và mã thoát

Mã thoát	Ý nghĩa	Bước tiếp theo an toàn
`0`	Đã reconnect hoặc reclassification được ghi.	Kiểm tra state từng job; hành động rõ ràng với bất kỳ job `orphaned` nào.
`1`	Digest không khớp, run không tìm thấy, hoặc state hỏng/không hỗ trợ.	Không force resume; điều tra record persisted hoặc `start` một run mới.
`2`	Parse cờ thất bại.	Sửa các cờ.
`3`	Bị interrupt.	Chạy lại resume với cùng argument.
`6`	Nền tảng không hỗ trợ.	Ngoài Darwin không có worker persisted để reconnect.