Luồng task an toàn hơn, ít thao tác tay hơn

Product stabilization bổ sung runtime truth, trajectory, recovery, helper policy, activity inspector và completion receipt fail-closed mà không phá workflow cũ.

v1.6.1 · Reliability patch

UI đúng trạng thái, review repo ngoài an toàn, helper ít tốn hơn

Bản vá này giữ nguyên model và thinking level, nhưng siết chặt lifecycle để response chỉ hiện khi task thật sự hoàn tất, đồng thời giới hạn helper và quyền đọc source ngoài theo đúng session.

Conversation truth

Draft, retry và completion còn pending ở trong Activity. Chat giữ đúng thứ tự user rồi assistant và không tiếp tục hiện processing sau terminal.

External review

URL GitHub, GitLab và Bitbucket chỉ bật source checkout tối thiểu; runtime cấp quyền đọc chính xác checkout đó và vẫn chặn cache, credential, symlink escape cùng mọi mutation.

Solo-first

Direct subagent có trần một helper read-only, không auto retry/fork/worker và có giới hạn call, turn, thời gian. Kết quả thiếu bằng chứng được ghi là failure thật.

Product stabilization

Sáu thay đổi người dùng sẽ thấy

Workflow cũ vẫn chạy. Update này đưa thêm bằng chứng runtime và các gate fail-closed vào phía sau, rồi mở những projection ngắn để người dùng kiểm tra khi cần.

Runtime truth

Model, provider, thinking, context window và provenance được đọc từ runtime hoặc authenticated catalog. Fact chưa có giữ là unknown, không đoán từ tên model.

Task trajectory

Task đi qua plan, execute, verify, review, handoff và terminal bằng state có replay. Event stale, sai identity hoặc corrupt sẽ fail closed.

Recovery và resume

Lỗi được phân loại trước khi retry hoặc repair. Environment, provider, permission, policy và scope failure không bao giờ cấp quyền sửa source.

Role-bound helpers

Scout, planner, reviewer và Oracle nhận scope/tool/budget có giới hạn. Parent model được giữ nguyên; automatic worker và multi-writer vẫn tắt.

Completion receipt

Receipt chỉ approved khi trace completed, acceptance satisfied và hard gate trên working tree hiện tại pass. Thiếu verifier hoặc work plan còn pending phải giữ remaining risk.

Product views

Preflight, live status, activity inspector, efficiency và orchestration policy có output deterministic; người dùng không cần nhờ model nhớ hoặc diễn giải state.

Daily flow

Luồng dùng hằng ngày không bị phá

Giao task như trước

Dùng prompt tự nhiên hoặc /workflow task <request>. Không cần gọi preflight thủ công.

Runtime tự ghi nhận truth

Task Contract, context, changed files, trajectory và checkpoint được cập nhật từ hook/tool result thay vì trí nhớ của model.

Verify đúng working tree

Chỉ exact command đã quan sát, exit thành công và khớp current-tree digest mới được tính là passing evidence.

Recovery hoặc handoff có giới hạn

Source repair và transient retry có ceiling. Trường hợp không an toàn chuyển sang handoff/operator thay vì tiếp tục đoán.

Completion fail closed

Trace completed không đủ. Work plan, acceptance, changed-file integrity và verifier hiện hành phải cùng pass trước khi receipt approved.

Inspect when needed

Năm command để nhìn xuyên suốt luồng

Đây là command quan sát và chẩn đoán, không phải bước bắt buộc trước mỗi task.

Preflight, activity, status, metrics và helper policy

/task-preflight --json Review current repository state
/piagent-inspector
/piagent-status
/usage efficiency
/piagent-orchestration

Xem Workflow thay đổi thế nào để biết chính xác từng command đọc gì, không làm gì và nên dùng ở thời điểm nào.

Automatic vs opt-in

Cái gì tự chạy, cái gì cần bật rõ ràng

Surface	Mặc định	Hành vi
Runtime snapshot + task evidence	Tự động	Ghi fact, journal, verifier, recovery và receipt có giới hạn.
Activity inspector	Panel bốn dòng tự động, menu tùy chọn	Hiện task diff, command, safety và context sát footer; không gọi model và không đổi workflow state.
Solver	shadow	Đánh giá route nhưng không đổi parent model hoặc tự chiếm quyền workflow.
Phase tools	shadow	Tính projection; dùng PIAGENT_PHASE_TOOLS=on để áp tool visibility theo phase.
Recovery	on	Tự retry/repair trong ceiling; dùng PIAGENT_AUTO_RECOVERY=off để quay về ordinary handoff.
Helpers	off	PIAGENT_HELPERS_MODE=on vẫn chỉ cho một helper read-only context fresh sau khi chứng minh hai lane độc lập và projected net saving từ 30%.
Parent routing + automatic worker	off	Không tự đổi parent model, không tự bật writer và không có multi-writer mặc định.

Compatibility

Không cần đổi thói quen hoặc migrate task cũ

Task Contract vẫn là v2.

Runtime snapshot, solver, trajectory, recovery và helper state là sidecar versioned/additive. Alias command cũ vẫn hoạt động; state cũ thiếu projection mới phải hiện unknown/unavailable thay vì được nâng cấp thành success.

Host không phải sandbox

Policy giảm lỗi trong tool surface được kiểm soát nhưng không cô lập code khỏi account của operator. External và destructive action vẫn cần confirmation.

Default giữ conservative

Solver/phase tools chưa được promote khỏi shadow, helpers chưa tự dispatch, parent routing và automatic worker vẫn off cho tới khi có rollout evidence riêng.

Try it

Test trực tiếp sau khi mở Pi session mới

Read-only product walkthrough

/task-preflight --json Review this repository without modifying files
/piagent-inspector
/piagent-status
/usage efficiency

Sau update package hoặc local checkout, mở Pi session mới để extension được reload. Dùng Command catalog cho toàn bộ command và alias.